# SDK Android

### **Começar**

Para começar a rastrear usando o SDK Android da Offer18, você precisará integrar o SDK ao seu aplicativo como uma dependência.

Para **Gradle** em **Kotlin,** Adicione dependências no `build.gradle.kts` arquivo

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

Para **Gradle** em **Groovy,**  Adicione dependências no `build.gradle` arquivo

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

{% hint style="warning" %}
Você deve substituir `{VERSION}` pela versão estável mais recente do SDK Android da Offer18
{% endhint %}

Descubra a versão estável mais recente do SDK Android

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

***

### Permissões

Certifique-se de que seu app tenha as permissões abaixo

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

***

### Inicialização do SDK

Importar `Offer18` Classe de `com.offer18.sdk` pacote

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

Para inicializar o Software Development Kit (SDK) insira o trecho de código fornecido no código do seu aplicativo.

{% code fullWidth="false" %}

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

{% endcode %}

{% hint style="info" %}

* Substitua `{DOMAIN}` pelo seu domínio de rastreamento.&#x20;
* Substitua `{ACCOUNT_ID}` pelo seu ID de Conta.
* Substitua **tid\_key\_in\_referrer\_url** Pelo seu próprio chave de parâmetro para tid
  {% endhint %}

***

### Rastrear Conversões

Importar `Offer18` Classe de `com.offer18.sdk` pacote

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

Para ativar o rastreamento de conversões com o SDK Android da Offer18, você precisará inserir um trecho de código específico na página de sucesso do pedido (Página de Obrigado) do seu aplicativo.

```java
Map<String, String> args = new HashMap<>();  
args.put("o", ""); // 0000000 (ID da Offer)
args.put("tid", "");  // x-xxxx-xxxxxx-xxxxxx (ID do Clique)
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 Conversão (Automático)

Importar `Offer18` Classe de `com.offer18.sdk` pacote

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

Se você preferir não buscar detalhes do Referrer para obter o ID do clique, você pode utilizar a chave Click ID da Offer18 na configuração.

#### Inicializar SDK&#x20;

Para inicializar o Software Development Kit (SDK) insira o trecho de código fornecido no código do seu aplicativo.&#x20;

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

#### Completar Conversão

```java
Map<String, String> args = new HashMap<>();  
args.put("o", ""); // ID da Offer  
args.put("tid", "{REFERRER_TID}"); // Preenchimento automático do 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" %}
O "**{REFERRER\_TID}**" irá automaticamente recuperar o ID do clique da URL do Referrer e incluí-lo no trackConversion.

* O TID será detectado automaticamente com base no valor da chave fornecida durante a inicialização do SDK
* A substituição ocorrerá quando o micro **{REFERRER\_TID}** for detectado
* **trackConversion** falhará se
  * Nenhum manual **tid** for fornecido,&#x20;
  * Nenhum **tid** detectado usando a url de referrer&#x20;
  * **tid** detectado mas nenhuma macro fornecida&#x20;
  * Macro fornecida mas nenhum **tid** ou vazio **tid** detectado a partir da url de referrer
    {% endhint %}