Como testar a integração do seu SDK no Tenjin #
Ao enviar eventos para o Tenjin, é útil utilizar a Ferramenta de Depuração em Tempo Real do Tenjin para verificar se os eventos estão a ser disparados conforme o esperado. Quaisquer eventos enviados através de um dispositivo de teste (para a ferramenta de Depuração em Tempo Real) não serão registados nos relatórios do painel de controlo.
A ferramenta "Live Event" pode ser encontrada aqui:
Como utilizar a Ferramenta de Eventos ao Vivo #
Para começar a utilizar a ferramenta para depurar e monitorizar eventos em tempo real a partir da sua aplicação:
- Passe o cursor sobre “Diagnosticar”, no canto superior esquerdo do seu painel de controlo. Clique em Testar dispositivos para adicionar o seu dispositivo de teste.

- Clique em + Novo dispositivo de teste para adicionar um dispositivo que o Tenjin possa detetar quando enviar eventos para o sistema Tenjin.

- Selecione a sua aplicação e introduza o ID de publicidade do seu dispositivo de teste. Utilizamos o IDFA ou o IDFV para o iOS e o GAID (Google Advertising ID) para o Android; por favor, pesquise online para encontrar o ID de publicidade do seu dispositivo de teste.

- Volte à ferramenta Live Event e abra a sua aplicação com o SDK da Tenjin instalado no dispositivo de teste para o qual enviou o seu ID de publicidade. Se os seus eventos estiverem a ser disparados corretamente, deverá ver algo semelhante ao evento abaixo. Se tiver registado o dispositivo de teste há pouco, aguarde até 3 horas antes de disparar o evento.

Verifique a integração da sua aplicação no painel de controlo #
O painel do Tenjin permite-lhe verificar, em tempo real, se o SDK do Tenjin está devidamente integrado em cada aplicação. Se selecionar a aplicação que está a integrar no separador «Aplicações», poderá ver todos os eventos relevantes para se certificar de que o SDK do Tenjin está corretamente configurado à medida que define a integração.

Pode ver a versão da aplicação, as sessões, as instalações do Apple Search Ads, as impressões de mediação publicitária (ILRD), as compras dentro da aplicação com recibos e quaisquer eventos personalizados que estejam a ser disparados corretamente.
Lista de verificação para a integração do SDK #
É muito importante seguir a lista de verificação utilizando a ferramenta de depuração antes de enviar a aplicação.
Se estiver a utilizar a aplicação TestFlight, não verá o evento na ferramenta SDK Live Event, mesmo que registe o seu advertising_id. Isto acontece porque o TestFlight utiliza um novo advertising_id sempre que os utilizadores abrem a aplicação, de acordo com a política da Apple.
- Evento de lançamento da aplicação
Certifique-se de que vê o evento de abertura na altura prevista. A abertura da aplicação ocorre automaticamente quando o SDK é inicializado, dependendo do ciclo de vida da atividade da aplicação que tiver escolhido.
- Instalações através da Apple Search (iOS)
O Tenjin obtém automaticamente os dados de atribuição do Apple Ads através do nosso SDK. Não é necessário efetuar configurações adicionais na campanha (link de rastreamento, callback, etc.). Instruções de integração: SDK Tenjin iOS
- Instalação do Referrer Android
O referenciador Android é utilizado para efeitos de rastreio quando o identificador de publicidade não está disponível. Verifique o seguinte:
- Certifique-se de que adicionou a biblioteca «Install Referrer» do Google.
dependencies {
implementation 'com.google.android.gms:play-services-ads-identifier:{version}'
implementation 'com.android.installreferrer:installreferrer:{version}'
}- Compra no IAP
Existem 6 estados de compra (purchase_states) no Tenjin. As compras IAP efetuadas a partir de uma conta sandbox terão um purchase_state = 4. Apenas o «purchase_state» 3 será apresentado no painel de relatórios, pelo que é muito importante testar utilizando a SDK Live Tool (o único local onde poderá ver as IAP da sandbox). O valor da compra IAP será considerado em decimais, por exemplo: 1,99.
Nas compras, certifique-se de que os códigos de moeda, os preços, os product_ids e as quantidades são enviados corretamente, utilizando várias combinações de parâmetros de compra. Por exemplo, tente efetuar compras em ienes, dólares americanos ou dólares canadianos.
The different purchase states in Tenjin are:
0 = UNKNOWABLE (there was no receipt and there is no way for tenjin to validate with the app store)
1 = UNVERIFIED (there was a receipt but there was an error with the app store validation)
2 = FRAUDULENT (the purchase was fraudulent)
3 = VERIFIED (the receipt was successfully validated with the app store)
4 = SANDBOX (this was a test purchase)
5 = DUPLICATE (there are duplicate purchases sent for the same transaction_id)
6 = STALE (the purchase event happened 3 days ago and not in real time)- Receitas de assinaturas (se existirem)
- Eventos personalizados
Certifica-te de que todos os eventos personalizados que implementaste apresentam o valor e o nome corretos.
- Impressões de mediação publicitária
O Tenjin suporta a integração com a funcionalidade «Impression Level Ad Revenue» (ILRD) das seguintes plataformas:
- AppLovin MAX
- Nível de jogo do Unity
- AdMob
- TopOn
- CAS
- Tradplus
Esta funcionalidade permite-lhe receber eventos que correspondem às suas receitas publicitárias afetadas por cada anúncio apresentado a um utilizador.