> 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/pt/rede/sdk/sdk-android.md).

# SDK Android

### **Começar**

Para começar a rastrear usando o SDK Android da Offer18, você precisará integrar o SDK ao seu aplicativo como 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 Android SDK

{% 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

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

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

Para inicializar o Kit de Desenvolvimento de Software (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** Com sua própria chave de parâmetro para tid
  {% endhint %}

***

### Rastrear conversões

Importe `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 agradecimento) do seu app.

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

***

### Rastreamento de conversão (automático)

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

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

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

#### Inicializar SDK&#x20;

Para inicializar o Kit de Desenvolvimento de Software (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");
```

#### Concluir conversão

```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" %}
O "**{REFERRER\_TID}**" recuperará automaticamente o click ID da URL do Referrer e o incluirá no trackConversion.

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