# SDK de Android

### **Comenzar**

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

Para **Gradle** en **Kotlin,** Agrega dependencias en el `build.gradle.kts` archivo

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

Para **Gradle** en **Groovy,**  Agrega dependencias en el `build.gradle` archivo

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

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

Descubre la versión estable más reciente del SDK de Android

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

***

### Permisos

Asegúrate de que tu app tenga los permisos indicados a continuación

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

***

### Inicialización del SDK

Importar `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 %}

***

### Rastrear conversiones

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

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

Para activar el rastreo de conversiones con el SDK de Android de Offer18, necesitarás insertar un fragmento de código específico en la página de éxito de pedido (Página de Gracias) de tu app.

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

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

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

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

#### Inicializar 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 la oferta  
args.put("tid", "{REFERRER_TID}"); // Relleno automático 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" %}
El "**{REFERRER\_TID}**" recuperará automáticamente el ID de clic desde la URL de Referrer e lo incluirá en el trackConversion.

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