# 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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://knowledgebase.offer18.com/pt/rede/sdk/sdk-android.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.