Android SDK

Начать

Чтобы начать отслеживание с помощью 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} на ваш идентификатор аккаунта.

• Замените 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 (ID оффера)
args.put("tid", "");  // x-xxxx-xxxxxx-xxxxxx (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 для получения 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}"); // Автозаполнение 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}" автоматически получит ID клика из URL реферера и включит его в trackConversion.

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

• Замена произойдёт, когда микрос {REFERRER_TID} обнаружен

• trackConversion не сработает, если

  • Нет ручного tid предоставлено,

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

  • tid обнаружено, но макрос не предоставлен

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