> For the complete documentation index, see [llms.txt](https://knowledgebase.offer18.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://knowledgebase.offer18.com/ru/set/sdk/sdk-dlya-android.md).

# SDK для Android

### **Начать**

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

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

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

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

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

{% hint style="warning" %}
Вы должны заменить `{VERSION}` на последнюю стабильную версию Android SDK Offer18
{% endhint %}

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

{% embed url="<https://central.sonatype.com/artifact/com.offer18/android-sdk>" %}

***

### Разрешения

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

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

***

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

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

```java
import com.offer18.sdk.Offer18;
```

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

{% code fullWidth="false" %}

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

{% endcode %}

{% hint style="info" %}

* Замените `{DOMAIN}` на ваш домен отслеживания.&#x20;
* Замените `{ACCOUNT_ID}` на ваш ID аккаунта.
* Замените **tid\_key\_in\_referrer\_url** С вашим собственным ключом параметра для tid
  {% endhint %}

***

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

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

```java
import com.offer18.sdk.Offer18;
```

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

```java
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` пакета

```java
import com.offer18.sdk.Offer18;
```

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

#### Инициализировать SDK&#x20;

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

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

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

```java
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);
```

{% hint style="info" %}
Значение "**{REFERRER\_TID}**" автоматически получит click ID из URL реферера и добавит его в trackConversion.

* TID будет автоматически определяться на основе значения ключа, указанного при инициализации SDK
* Замена будет выполнена, когда макрос **{REFERRER\_TID}** обнаружен
* **trackConversion** завершится ошибкой, если
  * Без ручного **tid** указан,&#x20;
  * Нет **tid** обнаружен с помощью URL реферала&#x20;
  * **tid** обнаружен, но макрос не указан&#x20;
  * Макрос указан, но нет **tid** или пустой **tid** обнаружен в URL реферала
    {% endhint %}