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

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 Android SDK

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

Importe Offer18 Classe de com.offer18.sdk pacote

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.

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 Com sua própria chave de parâmetro para tid

---

Rastrear conversões

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

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

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

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

Concluir conversão

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

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,

  • Nenhum tid detectado usando a URL de referência

  • tid detectado, mas nenhuma macro fornecida

  • Macro fornecida, mas nenhum tid ou vazio tid detectado na URL do referrer