Web SDK

Comenzar

Para comenzar a rastrear con el SDK web de Offer18, es necesario añadir una etiqueta script en el sitio web.

Ubicación : Encabezado (Todas las páginas)

<script src="https://web-resources.offer18.net/sdk/web/WebSDK.js"></script>

---

Rastrear clics

Para rastrear clics usando el SDK, agregue el siguiente código a su script.

Ubicación : Encabezado (Todas las páginas)

<script>
    window.Offer18WebSDK.trackClick({
        trackingURL: '<YOUR-TRACKING-LINK>',
        keymapping: ['<OFFER18-PARAMETER>:<YOUR-PARAMETER>', '<OFFER18-PARAMETER>:<YOUR-PARAMETER>',...]
    });
</script>

Configuración del objeto - window.Offer18WebSDK.trackclick()

1. trackingURL (Obligatorio) : URL de seguimiento que puede extraerse del panel de Offer18.

2. keymapping : es un arreglo de parámetros de Offer18 y parámetros nativos en un formato de <OFFER18-PARAMETER>:<YOUR-PARAMETER>. El usuario puede reemplazar <OFFER18-PARAMETER> con parámetros de Offer18 como aff_sub1, aff_sub2 y <YOUR-PARAMETER> con sus parámetros en los cuales el usuario está obteniendo valores de su red.

Código de ejemplo

<script>
    window.Offer18WebSDK.trackClick({
        trackingURL: 'https://example.o18.click/c?o=0000000&m=0000',
        keymapping: ['a:<YOUR-PARAMETER>']
    });
</script>

En el ejemplo anterior a es ID de Afiliado en el mapeo de claves

---

Rastrear impresiones

Para rastrear impresiones usando el SDK, agregue el siguiente código a su script

Ubicación : Encabezado (Todas las páginas)

<script>
    window.Offer18WebSDK.trackImpression({
        impressionURL: '<YOUR-IMPRESSION-URL>',
        keymapping: ['<OFFER18-PARAMETER>:<YOUR-PARAMETER>', '<OFFER18-PARAMETER>:<YOUR-PARAMETER>',...]
    });
</script>

Configuración del objeto - window.Offer18WebSDK.trackImpression()

1. impressionURL (Obligatorio) : URL de impresión que puede extraerse del panel de Offer18.

2. keymapping : es un arreglo de parámetros de Offer18 y parámetros nativos en un formato de <OFFER18-PARAMETER>:<YOUR-PARAMETER>. El usuario puede reemplazar <OFFER18-PARAMETER> con parámetros de Offer18 como aff_sub1, aff_sub2 y <YOUR-PARAMETER> con sus parámetros en los cuales el usuario está obteniendo valores de su red.

Código de ejemplo

<script>
    window.Offer18WebSDK.trackImpression({
        impressionURL: 'https://example.o18.click/i?o=0000000&m=0000',
        keymapping: ['a:<YOUR-PARAMETER>']
    });
</script>

En el ejemplo anterior a es ID de Afiliado en el mapeo de claves

---

Rastrear conversiones

Los usuarios deben añadir el siguiente fragmento de código en todas las páginas de destino excepto la página de confirmación de pedido / página de éxito del pedido (Gracias).

Ubicación : Encabezado (Todas las páginas)

<script>
    window.Offer18WebSDK.initializeConversion('<YOUR-CLICK-ID-PARAMETER>');
</script>

Después de añadir el script, es necesario agregar el siguiente script en la página de agradecimiento/confirmación de pedido

Ubicación : Página de agradecimiento/Página de éxito del pedido (Una página)

<script>
    window.Offer18WebSDK.trackConversion({
        domain: '',
        accountId: '',
        offerId: '',
        coupon:'',
        postbackType: '', // 'iframe' o 'pixel'
        isGlobalPixel: false, // true o false
        allowMultiConversion: false, // true o false
        conversionData: {
            event: '', // Nombre del evento (Por favor especifique el evento)
            payout: '', // Monto de la comisión (Por favor especifique el monto de la comisión)
            sale: '', // Monto de la venta (Por favor especifique el monto de la venta)
            currency: '',
            adv_sub1: '',
            adv_sub2: '',
            adv_sub3: '',
            adv_sub4: '',
            adv_sub5: '',
        }
    })
</script>

Configuración del objeto - window.Offer18WebSDK.trackConversion()

1. domain (Obligatorio) : Dominio de postback del usuario.

2. accountId (Obligatorio) : Id de cuenta de Offer18 del usuario.

3. offerId (Obligatorio) : Id de la campaña.

4. coupon : Aquí se puede usar el código de cupón

5. postbackType : Puede ser cualquiera 'iframe' o 'pixel', el valor predeterminado es 'iframe'.

6. isGlobalPixel : El usuario puede configurar el píxel global estableciendo esto true , el valor predeterminado es false.

7. allowMultiConversion : El usuario puede permitir MultiConversion estableciendo esto true , el valor predeterminado es false.

8. conversionData : Este objeto contiene los parámetros que pueden usarse para obtener valores de la red.

Código de ejemplo

<script>
    window.Offer18WebSDK.trackConversion({
        domain: 'example.o18.link',
        accountId: '0000',
        offerId: '00000000',
    });
</script>

---

Modo de depuración

Para habilitar el modo de depuración en un SDK, se puede añadir el siguiente código dentro de su script:

<script>
    window.Offer18WebSDK.activateDebugMode();
</script>

Habilitar el modo de depuración permite al usuario obtener información más detallada sobre el funcionamiento del SDK, incluidos errores o mensajes de depuración.