> 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/es/red/sdk/sdk-de-android.md).

# SDK de Android

### **Comenzar**

Para comenzar a hacer seguimiento usando el SDK de Android de Offer18, deberás integrar el SDK en tu aplicación como una dependencia.

Para **Gradle** en **Kotlin,** Añade las dependencias en el `build.gradle.kts` archivo

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

Para **Gradle** en **Groovy,**  Añade las dependencias en el `build.gradle` archivo

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

{% hint style="warning" %}
Debes reemplazar `{VERSION}` con la última versión estable del SDK de Android de Offer18
{% endhint %}

Descubre la última versión estable del SDK de Android

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

***

### Permisos

Asegúrate de que tu aplicación tenga los permisos que se indican a continuación

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

***

### Inicialización del SDK

Importa `Offer18` Clase de `com.offer18.sdk` paquete

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

Para inicializar el Kit de Desarrollo de Software (SDK), inserta el fragmento de código proporcionado en el código de tu aplicación.

{% code fullWidth="false" %}

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

{% endcode %}

{% hint style="info" %}

* Reemplaza `{DOMAIN}` con tu dominio de seguimiento.&#x20;
* Reemplaza `{ACCOUNT_ID}` con tu ID de cuenta.
* Reemplaza **tid\_key\_in\_referrer\_url** Con tu propia clave de parámetro para tid
  {% endhint %}

***

### Seguimiento de conversiones

Importa `Offer18` Clase de `com.offer18.sdk` paquete

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

Para activar el seguimiento de conversiones con el SDK de Android de Offer18, deberás insertar un fragmento de código específico en la página de éxito del pedido (página de agradecimiento) de tu aplicación.

```java
Map<String, String> args = new HashMap<>();  
args.put("o", ""); // 0000000 (ID de oferta)
args.put("tid", "");  // x-xxxx-xxxxxx-xxxxxx (ID de clic)
args.put("event", ""); // instalación
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);
```

***

### Seguimiento de conversión (automático)

Importa `Offer18` Clase de `com.offer18.sdk` paquete

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

Si prefieres no obtener los detalles del referente para conseguir el ID de clic, puedes utilizar la clave de ID de clic de Offer18 en la configuración.

#### Inicializar el SDK&#x20;

Para inicializar el Kit de Desarrollo de Software (SDK), inserta el fragmento de código proporcionado en el código de tu aplicación.&#x20;

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

#### Completar conversión

```java
Map<String, String> args = new HashMap<>();  
args.put("o", ""); // ID de oferta  
args.put("tid", "{REFERRER_TID}"); // Autocompletar TID
args.put("event", ""); // instalación
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" %}
El "**{REFERRER\_TID}**" recuperará automáticamente el ID de clic de la URL del referente y lo incluirá en trackConversion.

* El TID se detectará automáticamente según el valor de la clave proporcionado durante la inicialización del SDK
* El reemplazo se realizará cuando la macro **{REFERRER\_TID}** se detecte
* **trackConversion** fallará si
  * Sin manual **tid** proporcionado,&#x20;
  * No **tid** detectado usando la URL de referencia&#x20;
  * **tid** detectado pero no se proporcionó ninguna macro&#x20;
  * Macro proporcionada pero no **tid** o vacío **tid** detectado desde la URL de referencia
    {% endhint %}