SDK для Android

Начать

Чтобы начать отслеживание с помощью Android SDK Offer18, вам нужно подключить SDK к вашему приложению как зависимость.

Для Gradle в Kotlin, Добавьте зависимости в build.gradle.kts файл

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

Для Gradle в Groovy, Добавьте зависимости в build.gradle файл

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

Вы должны заменить {VERSION} на последнюю стабильную версию Android SDK Offer18

Узнайте последнюю стабильную версию Android SDK

Maven Central: com.offer18:android-sdkMaven Central

---

Разрешения

Убедитесь, что ваше приложение имеет указанные ниже разрешения

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

---

Инициализация SDK

Импорт Offer18 класс из com.offer18.sdk пакета

import com.offer18.sdk.Offer18;

Чтобы инициализировать набор средств разработки (SDK), вставьте предоставленный фрагмент кода в код вашего приложения.

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

• Замените {DOMAIN} на ваш домен отслеживания.

• Замените {ACCOUNT_ID} на ваш ID аккаунта.

• Замените tid_key_in_referrer_url С вашим собственным ключом параметра для tid

---

Отслеживание конверсий

Импорт Offer18 класс из com.offer18.sdk пакета

import com.offer18.sdk.Offer18;

Чтобы активировать отслеживание конверсий с помощью Android SDK Offer18, вам нужно вставить определённый фрагмент кода на страницу успешного оформления заказа (страницу благодарности) вашего приложения.

Map<String, String> args = new HashMap<>();  
args.put("o", ""); // 0000000 (Offer ID)
args.put("tid", "");  // x-xxxx-xxxxxx-xxxxxx (Click ID)
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);

---

Отслеживание конверсии (автоматически)

Импорт Offer18 класс из com.offer18.sdk пакета

import com.offer18.sdk.Offer18;

Если вы предпочитаете не получать данные Referrer для получения click ID, вы можете использовать ключ Click ID Offer18 в конфигурации.

Инициализировать SDK

Чтобы инициализировать набор средств разработки (SDK), вставьте предоставленный фрагмент кода в код вашего приложения.

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

Завершить конверсию

Map<String, String> args = new HashMap<>();  
args.put("o", ""); // Offer ID  
args.put("tid", "{REFERRER_TID}"); // Auto fill 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);

Значение "{REFERRER_TID}" автоматически получит click ID из URL реферера и добавит его в trackConversion.

• TID будет автоматически определяться на основе значения ключа, указанного при инициализации SDK

• Замена будет выполнена, когда макрос {REFERRER_TID} обнаружен

• trackConversion завершится ошибкой, если

  • Без ручного tid указан,

  • Нет tid обнаружен с помощью URL реферала

  • tid обнаружен, но макрос не указан

  • Макрос указан, но нет tid или пустой tid обнаружен в URL реферала