SDK para Android

Comenzar

Para comenzar a rastrear usando el SDK de Android de Offer18, necesitarás integrar el SDK en tu aplicación como una dependencia.

Para Gradle en Kotlin, Agrega dependencias en el build.gradle.kts archivo

implementation("com.offer18:android-sdk:{VERSION}")

Para Gradle en Groovy, Agrega dependencias en el build.gradle archivo

implementation 'com.offer18:android-sdk:{VERSION}'

Debes reemplazar {VERSION} con la versión estable más reciente del SDK de Android de Offer18

Descubre la versión estable más reciente del SDK de Android

Maven Central: com.offer18:android-sdkMaven Central

---

Permisos

Asegúrate de que tu app tenga los permisos indicados a continuación

<uses-permission android:name="android.permission.INTERNET"/>

---

Inicialización del SDK

Importar Offer18 Clase de com.offer18.sdk paquete

import com.offer18.sdk.Offer18;

Para inicializar el Kit de Desarrollo de Software (SDK) inserta el fragmento de código proporcionado en el código de tu aplicación.

Offer18.init(getApplicationBaseContext(), "{DOMAIN}", "{ACCOUNT_ID}","tid_key_in_referrer_url");

• Reemplaza {DOMAIN} con tu dominio de seguimiento.

• Reemplaza {ACCOUNT_ID} con tu ID de cuenta.

• Reemplaza tid_key_in_referrer_url Con tu propia clave de parámetro para tid

---

Rastrear conversiones

Importar Offer18 Clase de com.offer18.sdk paquete

import com.offer18.sdk.Offer18;

Para activar el rastreo de conversiones con el SDK de Android de Offer18, necesitarás insertar un fragmento de código específico en la página de éxito de pedido (Página de Gracias) de tu app.

Map<String, String> args = new HashMap<>();  
args.put("o", ""); // 0000000 (ID de la oferta)
args.put("tid", "");  // x-xxxx-xxxxxx-xxxxxx (ID de clic)
args.put("event", ""); // install
args.put("adv_sub1", ""); 
args.put("adv_sub2", "");
args.put("adv_sub3", "");
args.put("adv_sub4", "");
args.put("adv_sub5", "");
args.put("coupon", "");
args.put("sale", "");
args.put("payout", "");
Offer18.trackConversion(args);

---

Rastrear conversión (Automático)

Importar Offer18 Clase de com.offer18.sdk paquete

import com.offer18.sdk.Offer18;

Si prefieres no obtener detalles del Referrer para obtener el ID de clic, puedes utilizar la clave de ID de clic de Offer18 en la configuración.

Inicializar SDK

Para inicializar el Kit de Desarrollo de Software (SDK) inserta el fragmento de código proporcionado en el código de tu aplicación.

Offer18.init(getApplicationBaseContext(), "{DOMAIN}", "{ACCOUNT_ID}","tid_key_in_referrer_url");

Completar conversión

Map<String, String> args = new HashMap<>();  
args.put("o", ""); // ID de la oferta  
args.put("tid", "{REFERRER_TID}"); // Relleno automático TID
args.put("event", ""); // install
args.put("adv_sub1", "");
args.put("adv_sub2", "");
args.put("adv_sub3", "");
args.put("adv_sub4", "");
args.put("adv_sub5", "");
args.put("coupon", "");
args.put("sale", "");
args.put("payout", "");
Offer18.trackConversion(args);

El "{REFERRER_TID}" recuperará automáticamente el ID de clic desde la URL de Referrer e lo incluirá en el trackConversion.

• El TID se detectará automáticamente según el valor de la clave proporcionada durante la inicialización del SDK

• La sustitución ocurrirá cuando se detecte micro {REFERRER_TID} está detectado

• trackConversion fallará si

  • No manual tid proporcionado,

  • No tid detectado usando la URL de referencia

  • tid detectado pero no se proporcionó macro

  • Macro proporcionada pero no tid o vacío tid detectado desde la URL de referrer