# Pasos Clave

#### 2.1 Paso 1: Configuración del Postback en la Red de Afiliados

1. Iniciar sesión en la red de afiliados: [MyAffiliates Login](https://login.affiliateskto.com/).
2. Navegar al módulo postback de la cuenta de KTO Affiliates.
3. Hacer clic en "Manage Postbacks URLs".
4. Configurar los eventos de postback (Conversion signup, Conversion FTD).
5. Ingresar la URL donde se procesarán los postbacks, utilizando los placeholders proporcionados por la red.

<figure><img src="/files/rZ0wusgPAmpwzlGkIQnp" alt=""><figcaption><p>Manage postback url's</p></figcaption></figure>

#### 2.2 Paso 2: Configuración del Postback en Nuestro Sistema

1. Identificar la campaña a configurar (ejemplo: KTO BR).
2. Crear el postback en la base de datos si no se dispone de un módulo administrativo.

   * **Tabla**: `campaign_postback`
   * **Propiedades**:
     * **id**: Identificador único del postback.
     * **name**: Nombre reconocible del postback.
     * **description**: Descripción del postback.
     * **postbackKey**: Clave única para el enlace del postback.
     * **paramKeys**: Sin uso en la configuración actual.
     * **preVars**: Variables identificadoras del clic al redireccionar al jugador a la casa de apuestas.

       * Ejemplo: {"click\_id": "payload"} -> <https://go.inlaze.com/kto\\_br/1?click\\_id=123> -> <https://record.affiliateskto.com/_3-ySP10BB1yZM7hnoUx_dWNd7ZgqdRLk/1/?payload=123>

       <figure><img src="/files/HdZDAqQHe4xs7v8Aq7Jl" alt=""><figcaption><p>Postback clickId redirection</p></figcaption></figure>
     * **bookmakerVars**: Variables mapeadas desde la casa de apuestas. (están en la documentación)

       * Ejemplo: {"click\_id": "{payload}", "prom\_code": "{campaign.id}", "brand\_name": "{brand.name}", "media\_name": "{media.name}", "customer\_id": "{customer.id}", "campaing\_name": "{campaign.name}"}

       <div data-full-width="true"><figure><img src="/files/Oe3AoOb6hoAoC4XlXiVg" alt=""><figcaption><p>MyAffiliates postback documentation</p></figcaption></figure></div>
     * **eventValues**: Tipos de eventos, donde 0 es Registration, 1 es First Deposit, y 2 es CPA.
       * Ejemplo: {"0": "0", "1": "1", "2": "2"}
     * **ipWhitelist**: Lista de IPs permitidas para realizar peticiones de postback.
       * Ejemplo: \['18.202.13.94', '3.224.46.32', '181.48.164.250']
     * **isTestMode**: Modo de prueba, si está activo no realiza ninguna acción y hace un log en la aplicación para conocer todo lo de la **request**.
   * Ejemplo de configuración

   <table><thead><tr><th width="518">id</th><th width="83">name</th><th width="292">description</th><th width="226">postback_key</th><th width="83">param_keys</th><th width="163">pre_vars</th><th width="219">bookmaker_vars</th><th width="205">event_values</th><th width="84">postback_secret_param_key</th><th width="126">request_url</th><th width="144">request_vars</th><th width="210">response_mapping_vars</th><th width="167">postback_secret</th><th width="113">ip_whitelist</th><th width="83">is_test_mode</th></tr></thead><tbody><tr><td>9</td><td>Kto</td><td>Postback de casa de apuestas KTO</td><td>IMnMRxw15NUxKBi1TJDf</td><td>{}</td><td>{"click_id": "payload"}</td><td>{"click_id": "{payload}", "prom_code": "{campaign.id}", "brand_name": "{brand.name}", "media_name": "{media.name}", "customer_id": "{customer.id}", "campaing_name": "{campaign.name}"}</td><td>{"0": "0", "1": "1", "2": "2"}</td><td></td><td>{}</td><td>{}</td><td></td><td>['18.202.13.94', '3.224.46.32', '181.48.164.250']</td><td>FALSO</td><td>FALSO</td></tr></tbody></table>
3. Asociar el postback a una campaña en la tabla `campaign`.
   * **Valor**: `postback_id`
4. Verificar las URLs generadas en el sitio administrativo: [Admin Campaigns Postback](https://adviser.inlaze.com/admin/campaigns/postback).

<figure><img src="/files/91ydyET3w87rVmFkNm1n" alt=""><figcaption><p>Postback url admin</p></figcaption></figure>

#### 2.3 Paso 3: Asociación del Postback a Afiliados

1. Configurar URL de postback global en la tabla affiliate.
   * **Propiedades**: `postback_url`, `is_global_postback_enabled`.
2. Configurar URL de postback por campaña en la tabla `affiliate_link_consolidated`.
   * **Propiedad**: `postback_url`.

#### 2.4 Mejoras de UI-UX en la Plataforma Administrativa

1. Simplificar la interfaz de configuración de postbacks.
   * Evitar la dependencia de desarrolladores para configuraciones.
2. Incluir logs de postbacks en la interfaz. Ejemplo:

   <figure><img src="/files/hnWSyblSXTiMAWyHTJoV" alt=""><figcaption><p>Ejemplo interfaz logs</p></figcaption></figure>
3. Implementar una herramienta en el módulo para probar postbacks.
4. Mejorar la validación de campos para permitir configuraciones completas.

#### 2.5 Mejoras de UI-UX en la Plataforma de Afiliados

1. Crear una interfaz sencilla y atractiva para configurar postbacks.
2. Implementar logs de notificaciones de postbacks.

**2.6 Mejoras de funcionalidades**

1. Monitoreo de los postbacks para ver viabilidad
2. Permitir urls por evento en las configuraciones para los afiliados


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs-affiliates.inlaze.com/campanas/postback/pasos-clave.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
