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

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

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

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

Você deve substituir {VERSION} pela versão estável mais recente do SDK Android da Offer18

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

Maven Central: com.offer18:android-sdkMaven Central

---

Permissões

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

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

---

Inicialização do SDK

Importar Offer18 Classe de com.offer18.sdk pacote

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.

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

• Substitua {DOMAIN} pelo seu domínio de rastreamento.

• Substitua {ACCOUNT_ID} pelo seu ID de Conta.

• Substitua tid_key_in_referrer_url Pelo seu próprio chave de parâmetro para tid

---

Rastrear Conversões

Importar Offer18 Classe de com.offer18.sdk pacote

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.

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

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

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

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

Completar Conversão

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

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,

  • Nenhum tid detectado usando a url de referrer

  • tid detectado mas nenhuma macro fornecida

  • Macro fornecida mas nenhum tid ou vazio tid detectado a partir da url de referrer