Teste a integração do SDK móvel com o aplicativo – AppsFlyer Support

Visão geral: teste a integração do seu aplicativo Android/iOS com a AppsFlyer.

Teste e depuração da integração do SDK

Teste a integração do SDK antes de enviar um aplicativo para a loja de aplicativos. Neste artigo, o SDK refere-se aos SDKs da AppsFlyer do iOS e Android.

Casos especiais de testes e depuração

Smart TV: o SDK é compatível com Smart TVs baseadas em Android e Apple TV (tvOS). Teste aplicativos da Smart TV usando as instruções deste guia.
Aplicativos tvOS não publicados: consulte Testando a integração do tvOS antes de publicar.
Amazon Fire TV: consulte Teste de lojas Android alternativas.

Por que devo depurar e testar?

A integração cuidadosamente testada garante uma coleta de dados precisa e abrangente. Ao testar a integração do SDK, você garante que as instalações e os eventos in-app sejam registrados e atribuídos corretamente.

Como testar e depurar a integração do SDK

Use um dos métodos a seguir para testar e depurar a integração do SDK

Testes básicos:
- Testando a integração usando links de atribuição
- O modelo de atribuição da AppsFlyer usa links de atribuição. É recomendado realizar testes usando links de atribuição.
- Ao testar a integração do SDK usando links de atribuição, você obtém uma visão detalhada do modelo de atribuição da AppsFlyer. Isso lhe dá a oportunidade de otimizar sua operação de marketing e análise.
Testes avançados:
- Depuração diretamente do ambiente de desenvolvimento.
- A seção de teste de integração SDK testa apenas um conjunto limitado de recursos. Teste o seguinte no ambiente de desenvolvimento usando o log de depuração:
  - Validação da compra
  - Dados de conversão
  - Erros na configuração do SDK. Você pode testá-los no ambiente de desenvolvimento com a ajuda do registro de depuração.

Leitura relacionada sobre ad networks: testes de integração de ad networks.

Usando a página Testes de Integração do SDK, para localizar problemas de integração no seu projeto. Use-a para testar instalações, eventos in-app e links diretos.

Testando a integração do SDK

Para testar a integração do SDK:

Prepare um dispositivo (iOS ou Android) que não tenha o aplicativo instalado. Se necessário, desinstale (exclua) o aplicativo do dispositivo.
Registre o dispositivo como um dispositivo de teste. Atenção! iOS: se você usar o TestFlight para instalar o aplicativo, não há necessidade de registrar o dispositivo.
Na AppsFlyer, selecione o aplicativo.
Acesse Integração > Testes de integração SDK.
A página de testes de integração do SDK é aberta.
Selecione uma opção de teste:
- instalações não orgânicas
- Eventos in-app
- Deep Linking
Use o procedimento de teste a seguir de acordo com o tipo de teste selecionado.

Como testar instalações orgânicas

Instale o aplicativo em um dispositivo de teste registrado.
Inicie o aplicativo.
O painel do aplicativo exibe uma nova instalação orgânica.

Testando instalações não orgânicas

Selecione Instalação não-orgânica.
Selecione um dispositivo listado.
Selecione a fonte do aplicativo:
- Android:
  - Google Play
  - Outros (fora da loja)
- iOS:
  - Loja de aplicativos
  - XCode
  - TestFlight
Digitalize o código QR com o dispositivo de teste registrado e siga as instruções no dispositivo.
Aguarde a instalação não orgânica ser registrada na página SDK Integration Test (Teste de integração do SDK), indicando que teste foi realizado com sucesso. Isso pode levar até 2 minutos.

Se o aplicativo não registrar uma instalação não orgânica até esse momento, consulte a seção de identificação e solução de problemas que aparece na página Testes de Integração do SDK .

Para testar as instalações LAT:

Ative o modo LAT no seu dispositivo.
Execute um teste de instalação não orgânico.

Para testar instalações com nenhuma autorização ATT (sem IDFA):

Na caixa de diálogo de consentimento da ATT, clique em Pedir ao aplicativo para não acompanhar.
Execute um teste de instalação não orgânico.

Teste de eventos in-app

Clique em Executar teste em Eventos in-app.
Selecione um dispositivo de teste registrado no menu suspenso, clique em Avançar.
Inicialize seu aplicativo e comece a gerar eventos in-app.
Você verá um registro desses eventos conforme eles são registrados em tempo real.

Testando links diretos

O OneLink deve ser definido em seu aplicativo para testar links diretos. Consulte nosso guia de OneLink aqui. É importante observar que a implementação de links diretos do SDK é altamente recomendada, conforme descrito no guia de integração de links diretos.
Verifique se a chave seletora retargeting está ativada.
Clique em Run test (Executar teste) em Deeplinking (Links diretos)
Selecione um dispositivo de teste registrado no menu suspenso e clique em Avançar.
Selecione Tipo de teste:
- OneLink - selecione o OneLink que você deseja testar no menu suspenso Selecione um OneLink.
- Esquema URI - especifique o esquema URI que você deseja testar. Por exemplo, greatapps://cars.
Escaneie o QR code com seu dispositivo de teste registrado e siga as instruções no seu dispositivo.
Após a conclusão desses dois testes, o teste de links diretos é registrado com sucesso.

Testando a integração do SDK usando aplicativos de depuração

Ao realizar testes usando links de atribuição, os dados são gravados no painel do aplicativo. Não é possível deletar os dados após eles terem sido gravados. Se você não quiser que os dados de teste sejam gravados como parte dos dados do aplicativo real, é possível testar a integração do SDK usando aplicativos de depuração.

Se você não precisa de um aplicativo de teste ou se não se importa em misturar os dados de testes com os dados reais, pule esta sessão.

Aplicativos de depuração são cópias fiéis de aplicativos publicados nas lojas de aplicativo. Ao executar testes de integração do SDK em aplicativos de depuração, você não mistura os dados reais com os dados de teste.

Aplicativos de depuração são diferentes dos aplicativos de produção, pois eles:

Possuem um ID do aplicativo diferente
Possuem seu próprio painel
Não são publicados nas lojas de aplicativo

Criação de um aplicativo de teste Android

Duplicação do seu aplicativo Android

Faça uma cópia da pasta do projeto Android e renomeie-o
Abra o projeto recém-copiado no Android Studio
No Android Studio, amplie as pastas até encontrar o pacote
Clique com o botão direito no nome do pacote, escolha Refatorar e, em seguida, Renomear
Renomeie o pacote
No nível de aplicativo build.grade, modifique o applicationId para o novo nome do pacote

Adicione o aplicativo de teste Android à AppsFlyer

Siga as instruções para adicionar um novo aplicativo em seu painel do AppsFlyer. Certifique-se de que o nome do pacote seja igual ao nome do pacote do aplicativo de teste recém-criado, e não igual ao nome original do pacote do aplicativo. Certifique-se também de configurar o status do aplicativo para Aprovação pendente ou não publicada.

Agora você pode executar testes no novo aplicativo de teste.

Criação de um aplicativo de teste iOS

Duplicação do seu aplicativo iOS

Abra a pasta do projeto no buscador
Duplique a pasta
Abra o projeto duplicado no XCode
Na classe AppDelegate, dentro do método didFinishLaunchingWithOptions, configure uma nova ID do aplicativo:
Objective C

Swift

Observação

A ID do aplicativo é a ID atribuída ao aplicativo após ser publicado na loja de aplicativos. Contudo, por se tratar de um aplicativo de teste, é possível atribuir a ID que você quiser contanto que ela não seja usada por outro aplicativo. O formato deve ser 11111 ****. Por exemplo, 111117538.

Certifique-se de que a ID tenha 9 dígitos . Inicie a id com cinco 1s. Os dígitos restantes devem ser aleatórios. Confira um exemplo de ID acima.

Adição do aplicativo de teste iOS ao seu painel do AppsFlyer

Siga as instruções para adicionar um novo aplicativo em seu painel do AppsFlyer. Certifique-se de que a ID do aplicativo seja igual à ID do aplicativo de teste recém-criado. Certifique-se também de configurar o status do aplicativo para Aprovação pendente ou não publicada.

Agora você pode executar testes no novo aplicativo de teste.

Testes usando links de atribuição

Esta seção demostra como testar a integração com a ajuda de links de atribuição.

Antes de começar:

Dispositivos registrados que você usa para testes
Ao testar reatribuições, certifique-se de remover o dispositivo registrado da lista de permissões.
Se você estiver testando a atribuição de aplicativos disponíveis em lojas de aplicativos Android de terceiros, é necessário definir o parâmetro af_r no link de atribuição para referenciar a loja de aplicativos específica.

Você pode testar a integração do SDK mesmo se o aplicativo ainda estiver pendente (ou seja, não listado no Google Play ou na Apple Store)

Tópicos abordados nesta seção:

Teste da atribuição de instalações
Teste de eventos in-app
Teste de redirecionamento (reatribuição e reengajamento)

Teste da atribuição de instalações

Testar instalações possibilita saber que o SDK do AppsFlyer é capaz de atribuir instalações a várias fontes de mídia corretamente.

Passo 1:

Copie o link abaixo:

https://app.appsflyer.com/<app_id>?pid=Test&c=Test&advertising_id=<GAID>

https://app.appsflyer.com/<app_id>?pid=Test&c=Test&idfa=<IDFA>

Altere o parâmetro app_id para a id do aplicativo (incluindo o prefixo id. Por exemplo: id0123456789).

O parâmetro c especifica o nome da campanha.
O parâmetro pid especifica o nome da fonte de mídia à qual a instalação foi atribuída.
Se você estiver testando um aplicativo disponível em uma loja Android de terceiros: adicione o parâmetro af_r ao link de atribuição.

Se estiver testando o clique em um computador, adicione o GAID para Android (ID de publicidade do Google) ou IDFA para iOS.

Passo 2:

Copie o link, envie-o ao dispositivo de teste e acesse o link usando o navegador.

Observação

No iOS, use o iMessage ou o e-mail para enviar o link para o dispositivo. Não cole o link no aplicativo iOS Notes e clique nele, pois pode quebrar o link.

Se o aplicativo for em tempo real, realize a instalação.
Se o aplicativo estiver pendente, instale-o a partir de seu ambiente de desenvolvimento:
-- Para Android - instale a partir do Android Studio ou do ADB Shell
-- Para iOS - instale a partir do XCode

Passo 3:

Aguarde até dois minutos para que a instalação apareça no painel do aplicativo. Você verá uma instalação que foi atribuída à fonte de mídia Teste no Teste de campanha.

Para uma verificação mais elaborada, faça o download do relatório de dados brutos de instalação.

Na AppsFlyer, acesse Relatórios> Exportar Dados.
Na sessão de Relatórios de Dados Brutos faça o download do relatório de dados brutos de Instalação.

Consulte nosso artigo sobre relatório de dados brutos de instalações para obter mais informações.

Teste de eventos in-app

Você pode testar eventos in-app para ver se eles mostram a receita associada a eles, e se eles estão atribuídos à fonte de mídia que gera a instalação.

Após instalar o aplicativo usando o link de atribuição, dispare alguns eventos in-app. Aguarde até dois minutos para que os eventos apareçam no painel. Abra o painel do aplicativo e clique em Eventos no menu do lado esquerdo.

Você verá os eventos, a receita (se a receita estiver associada a eles) e a fonte de mídia à qual eles estão associados.

Para uma verificação mais elaborada, é possível baixar o relatório de dados brutos de eventos in-app.

No painel do aplicativo, clique em Export Data (Exportar dados) em Reports (Relatórios). Na seção Relatórios de dados brutos , baixe o relatório de dados brutos do Evento in-app.

Consulte nosso artigo sobre relatório de dados brutos de eventos in-app para obter mais informações.

Teste do OneLink

O OneLink™ permite que você defina um único link de atribuição para iOS e Android. O OneLink reconhece o dispositivo do usuário e o redireciona para a loja de aplicativos relevante.

Além do mais, o OneLink habilita os links diretos. Os links diretos permitem que você abra o aplicativo em uma atividade específica do aplicativo enquanto fornece conte´udos personalizados.

Para obter mais informações, consulte nosso guia em teste de URLs do OneLink.

Teste de redirecionamento

Pré-requisitos para testar o redirecionamento

Modelo do OneLink - consulte Configuração do modelo do OneLink
Habilitar o redirecionamento nas configurações do aplicativo
No painel do aplicativo, clique em Configurações do aplicativo e alterne Habilitar a métrica de campanhas de redirecionamento para ligado.

Android iOS
Um dispositivo não registrado

Testar o redirecionamento é simples. Crie um link de atribuição personalizado fora de um modelo do OneLink. Certifique-se de ativar Re-Targeting Campaign (Campanha de redirecionamento).

Depois que o link de atribuição personalizado estiver pronto, a seguinte tela aparecerá onde você pode recuperar a versão de URL longo:

Outra forma de recuperar a versão longa da URL é através da página Gerenciamento de links.

Na página Gerenciamento de links, localize o link de atribuição.
No lado direito, clique nos três pontos em Ações
Clique em Exibir detalhes do link
Copie o link longo.

Importante!

Ao testar o redirecionamento (reatribuição e reengajamento), a ID de publicidade deve ser especificada na URL do link de atribuição.
As reinstalações de redirecionamento (AKA reatribuição) não podem ser testadas usando dispositivos de teste registrados. Ou seja, dispositivos de usuário que estão listados na lista de dispositivos de teste. Você pode usar qualquer outro dispositivo para esse fim.
Para visualizar o GAID ou IDFA, siga as instruções no artigo Como registrar um dispositivo de teste. Atenção!

O OneLink final é o seguinte:

https://go.onelink.me/2rAD?pid=Test&c=Test&is_retargeting=true&advertising_id=<GAID>

https://go.onelink.me/2rAD?pid=Test&c=Test&is_retargeting=true&idfa=<IDFA>

Teste de reatribuição

É possível testar a reatribuição para verificar se você pode registrar instalações do seu aplicativo por usuários que reinstalam o aplicativo após a desinstalação do mesmo em algum momento do passado.

Certifique-se de que seu dispositivo de teste NÃO está registrado
Se o aplicativo acabou de ser instalado, aguarde alguns minutos
Desinstale o aplicativo do dispositivo
Repita os mesmos passos para testar a atribuição de instalações - use o formato do OneLink acima
Aguarde até dois minutos para que a instalação redirecionada apareça no painel
Abra o painel do aplicativo e clique em Re-Targeting (Redirecionamento) no menu do lado esquerdo
Você verá a instalação reatribuída atribuída ao Test (Teste) de fonte de mídia com o nome de campanha Test (Teste)

Para uma verificação mais elaborada, é possível baixar o relatório de dados brutos de conversões.

No painel do aplicativo, clique em Export Data (Exportar dados) em Reports (Relatórios). Na seção Re-Targeting Reports (Relatórios de redirecionamento) , baixe o relatório de dados brutos de Conversions (Conversões).

Teste de reengajamento

O reengajamento acontece quando um usuário que tem o aplicativo instalado se engaja com a campanha de redirecionamento e inicializa o aplicativo.

Teste de reengajamento através da abertura de aplicativos

No reengajamento através da abertura de aplicativos, o usuário é redirecionado para a loja de aplicativos, onde é exibido um botão para abrir o aplicativo. Se o usuário clicar no botão e inicializar o aplicativo, um reengajamento é registrado.

Para testar reengajamentos, siga os passos abaixo:

Certifique-se de que o aplicativo esteja instalado em seu dispositivo de teste e tenha sido inicializado várias vezes
Se o aplicativo acabou de ser instalado, aguarde alguns minutos
Use o mesmo OneLink usado para testar a reatribuição
Adicione a ID do dispositivo ao link e envie-o ao seu dispositivo móvel
Acesse o link usando um navegador
Abra manualmente o aplicativo através do botão Open (Abrir) na loja ou do ponto de partida do dispositivo

Você verá um reengajamento atribuído ao Test (Teste) de fonte de mídia com o nome de campanha Test (Teste).

Teste de reengajamento através de links diretos

O reengajamento por meio de deep linking permite que você inicialize o aplicativo imediatamente após o usuário clicar no link de atribuição. Os benefícios de usar o reengajamento com deep linking:

Melhor experiência para o usuário - o usuário não é redirecionado para a loja e o aplicativo inicializa automaticamente
Melhores campanhas - você pode ter uma atividade específica relacionada à campanha aberta, o que maximiza os resultados da campanha de redirecionamento

Você pode testar a atribuição de reengajamento usando links diretos. O procedimento é igual ao teste de reengajamento com um link de atribuição. A única diferença é que o link de atribuição contém um parâmetro af_dp que redireciona o usuário para uma atividade específica no aplicativo.

Para testar reengajamentos usando links diretos, siga os passos abaixo:

Certifique-se de configurar seu aplicativo para links diretos
Certifique-se de que o aplicativo esteja instalado em seu dispositivo de teste e tenha sido inicializado várias vezes
Se o aplicativo acabou de ser instalado, aguarde alguns minutos
Gere um link de redirecionamento com a ID do dispositivo
Adicione o parâmetro af_dp e adicione a ele o esquema que você configurou no passo 1
Acesse o link usando um navegador
Se o aplicativo estiver instalado, o link inicializa o aplicativo na atividade especificada no link

Você verá um reengajamento atribuído ao Test (Teste) de fonte de mídia com o nome de campanha Test (Teste).

Para mais informações, siga nosso guia em Teste de links diretos.

Outras maneiras de testar a integração do SDK

Há outras duas maneiras de testar a integração do SDK:

Esta seção faz uma demonstração de como depurar o SDK. Consulte esta seção para realizar testes avançados e para identificar e solucionar problemas com a integração do SDK.

Depuração no Android

A depuração do SDK oferece uma perspectiva aprofundada de como ele se integra ao seu aplicativo. A depuração ajuda a resolver problemas com a gravação de eventos in-app, dados de conversão e validação de compra.

Ativação do modo de depuração no SDK do Android

Para começar a depurar o SDK do Android, adicione a seguinte linha à classe AFApplication:

AppsFlyerLib.getInstance().setDebugLog(true);

Aviso!

A depuração deve ser restrita apenas à fase de desenvolvimento. Não distribua o aplicativo a lojas de aplicativos com a depuração ativada. Isso apresenta riscos à segurança e à privacidade.

Visualização do resultado da depuração

Para visualizar o resultado da depuração, abra o terminal do LogCat no Android Studio. Escolha o nome do pacote de aplicativos de acordo com o processo depurável, defina o nível do registro para Depuração e filtre por "AppsFlyer_".

Identificação e solução de problemas comuns com o SDK do Android

Instalação sempre atribuída a orgânica

Cenário

Você está testando a atribuição usando links de atribuição. Você implementou o ouvinte de conversão do SDK, mas o registro sempre mostra que a instalação é orgânica. Além disso, nenhuma instalação não orgânica é registrada no painel.

Possíveis causas

A chave do desenvolvedor está incorreta - se você especificar uma chave do desenvolvedor incorreta, a instalação não pode ser atribuída.
O link de atribuição que você está usando está incorreto. Consulte nosso guia sobre links de atribuição.
Certifique-se de que o dispositivo no qual você está testando está registrado.
Um canal incorreto foi definido no manifesto.

Instalação não detectada ou atribuída

Cenário

Você está testando a atribuição de instalações, mas o registro não mostra nenhum dado sobre a instalação, por exemplo, tipo, primeira inicialização, etc.

Possíveis causas

Certifique-se de que os métodos startTracking e init foram chamados na classe AFApplication.
Certifique-se de que o dispositivo no qual você está testando está registrado.

Estou recebendo um 404 em Gravação de instalações ou eventos

Cenário

Você está testando eventos in-app para ver se foram atribuídos à fonte de mídia correta. No entanto, o registro exibe a resposta 404 para instalações e para envio de eventos in-app. Nem as instalações nem os eventos in-app aparecem no painel.

Possíveis causas

A resposta 404 indica que a ID do aplicativo está incorreta. Certifique-se de que a ID do aplicativo no parâmetro applicationId no arquivo build.gradle seja igual à ID que está em seu painel.

A receita não é registrada corretamente

Cenário

Você está testando eventos in-app com receita. Os eventos aparecem no painel, mas a receita não foi registrada.

Possíveis causas

O parâmetro da receita não foi formatado corretamente. NÃO formate o valor de receita de forma alguma. Ele não deve conter separadores de vírgula, símbolo de moeda ou texto. Um evento de receita deve ser semelhante a 1234,56, por exemplo.

O registro mostra "O SDK do AppsFlyer não consegue enviar eventos sem a DevKey" quando testo eventos in-app

Cenário

Você está tentando ver eventos in-app no registro. Ao acionar eventos, o registro mostra somente "O SDK do AppsFlyer não consegue enviar eventos sem a DevKey".

Possíveis causas

Você chama o método startTracking sem passar a chave do desenvolvedor como um parâmetro. Passe a chave do desenvolvedor para o método.

O registro mostra "O envio de dados ainda não foi realizado. Aguardando chave do desenvolvedor" no registro quando testo eventos in-app

Cenário

Você está tentando testar eventos in-app no registro. Ao acionar eventos, o registro mostra somente "O envio de dados ainda não foi realizado. Aguardando chave do desenvolvedor".

Possíveis causas

Você chama o init e passa a chave do desenvolvedor como uma sequência vazia. Passe a chave do desenvolvedor para o método.

Obtenho a resposta 400 quando testo eventos in-app

Cenário

Você está tentando testar eventos in-app no registro. Ao acionar eventos, você vê a resposta 400 nos registros.

Possíveis causas

Isso pode indicar um problema com a chave do desenvolvedor. Verifique se a chave do desenvolvedor é a correta. Além do mais, certifique-se de que a chave do desenvolvedor contenha somente caracteres alfanuméricos.

O registro mostra "AVISO: o Google Play Services está ausente"

Cenário

O LogCat mostra a mensagem de aviso "AVISO: o Google Play Services está ausente".

Possíveis causas

As dependências do Google Play Services estão ausentes no aplicativo. Isso pode impedir que o SDK colete o GAID, o que pode causar problemas com a atribuição.

Adicione as seguintes linhas

implementação 'com.google.android.gms:play-services-base:15.0.1'
implementation 'com.google.android.gms:play-services-ads:15.0.1'

No arquivo build.gradle de nível de módulo (aplicativo).

Recebo resposta 403 em Gravação de instalações ou eventos

Cenário

Você está tentando testar instalações e outros eventos de conversão no log. Ao disparar esses eventos, você verá a resposta 403 (proibido) nos logs.

Possíveis causas

Isso pode acontecer porque você tem o pacote Zero, que não inclui dados de atribuição, somente dados sobre cliques e impressões. Para começar a receber dados de atribuição, saiba mais sobre os diferentes pacotes da AppsFlyer e atualize conforme necessário .Você também pode entrar em contato com nossa equipe de engajamento com o cliente através do e-mail hello@appsflyer.com se tiver dúvidas sobre nossos pacotes.

Depuração no iOS

Ativação do modo de depuração no SDK do iOS

Para começar a depuração do SDK do iOS, adicione a seguinte linha ao método didFinishLaunchingWithOptions:

Adicione a seguinte linha no AppDelegate.m:

[AppsFlyerLib shared].isDebug = true;

Adicione a seguinte linha no AppDelegate.swift:

AppsFlyerLib.shared().isDebug = true

Aviso!

A depuração deve ser restrita apenas à fase de desenvolvimento. Não distribua o aplicativo às lojas de aplicativos com a depuração ativada. Isso apresenta riscos à segurança e à privacidade.

Visualização do resultado da depuração

Para visualizar o resultado da depuração, abra o terminal de depuração no XCode e filtre por "AppsFlyer".

Identificação e solução de problemas comuns com o SDK do iOS

Instalações e eventos não são registrados

Pode haver várias razões pelas quais instalações e eventos não são registrados:

Se você especificar um ID de aplicativo no formato incorreto, as instalações e os eventos não serão registrados. Ao definir o ID do aplicativo no arquivo delegado, certifique-se de que ele compreenda apenas números.

Você pode encontrar sua chave do desenvolvedor no painel do AppsFlyer em Configurações do aplicativo:

Correto:

[AppsFlyerTracker sharedTracker].appleAppID = @"340954503";

Incorreto:

[AppsFlyerTracker sharedTracker].appleAppID = @"id340954503";

Incorreto:

[AppsFlyerTracker sharedTracker].appleAppID = @"com.appslyer.sampleapp";

Caso a ID do aplicativo esteja no formato incorreto, o registro exibe o seguinte erro:

[ERROR] AppsFlyer: -[AppsFlyerTracker validateAppID] 
AppsFlyer Error: appleAppID should be a number!

Se você especificar um ID do aplicativo que não existe na sua conta, as instalações e eventos não são registrados. O registro mostra o seguinte erro:

AppsFlyer: -[AppsFlyerHTTPClient sendRequestEventToServer:isRequestFromCache:appID:isDebug:
completionHandler:]_block_invoke sent information to server, status = 404

O erro 404 indica que o SDK não consegue encontrar o aplicativo na sua conta.

Se você especificar um ID da chave do desenvolvedor incorreto, as instalações e eventos não serão registrados. O registro mostra o seguinte erro:

AppsFlyer: -[AppsFlyerHTTPClient sendRequestEventToServer:isRequestFromCache:appID:isDebug:completionHandler:]
_block_invoke sent information to server, status = 400

O erro 400 indica que o SDK não consegue autenticar a solicitação para registrar instalações e eventos. Verifique se a chave do desenvolvedor é a correta. Além disso, certifique-se de que a chave do desenvolvedor contém apenas caracteres alfanuméricos.

A ID do aplicativo e a chave do desenvolvedor estão corretas, mas a instalação não é registrada

Cenário

O aplicativo possui a ID do aplicativo e a chave do desenvolvedor corretas, mas as instalações não são registradas.

Possíveis causas

O SDK não foi iniciado corretamente. Certifique-se de chamar o método trackAppLaunch em applicationDidBecomeActive:

- (void)applicationDidBecomeActive:(UIApplication *)application { 
	[[AppsFlyerTracker sharedTracker] trackAppLaunch]; 
}

func applicationDidBecomeActive(application: UIApplication) { 
	AppsFlyerTracker.shared().trackAppLaunch() 
}

O registro mostra "A chave do desenvolvedor da AppsFlyer está faltando ou está vazia. Suspendendo"

Cenário

Você está tentando ver as instalações e os eventos in-app no registro. O registro mostra "A chave do desenvolvedor do AppsFlyer está faltando ou está vazia. Suspendendo".

Possíveis causas

A chave do desenvolvedor não foi configurada. Certifique-se de configurá-la no appDelegate no método didFinishLaunchingWithOptions:

[AppsFlyerTracker sharedTracker].appsFlyerDevKey = @"YOUR_DEV_KEY";

AppsFlyerTracker.shared().appsFlyerDevKey = "YOUR_DEV_KEY"

Instalação sempre atribuída a orgânica

Cenário

Possíveis causas

O link de atribuição que você está usando está incorreto. Consulte nosso guia sobre links de atribuição.
Certifique-se de que o dispositivo no qual você está testando está registrado.

A receita não é registrada corretamente

Cenário

Você está testando eventos in-app com receita. Os eventos aparecem no painel, mas a receita não foi registrada.

Possíveis causas

Estou recebendo um 404 em Gravação de instalações ou eventos

Cenário

Você está testando instalações e eventos in-app para ver se eles foram atribuídos à fonte de mídia correta. No entanto, a resposta 404 aparece tanto para instalações quanto para eventos in-app. Nem as instalações nem os eventos in-app aparecem no painel.

Possíveis causas

A resposta 404 indica que o ID do aplicativo está incorreto. Consulte Instalações e eventos não registrados.

Recebo resposta 400 em Gravação de instalações ou eventos

Cenário

Você está tentando testar eventos in-app no registro. Ao acionar eventos, você vê a resposta 400 nos registros.

Possíveis causas

Isso pode indicar um problema com a chave do desenvolvedor. Verifique se a chave do desenvolvedor é a correta. Além do mais, certifique-se de que a chave do desenvolvedor contém somente caracteres alfanuméricos. Consulte Instalações e eventos não registrados.

Recebo resposta 403 em Gravação de instalações ou eventos

Cenário

Você está tentando testar instalações e outros eventos de conversão no log. Ao disparar esses eventos, você verá a resposta 403 (proibido) nos logs.

Possíveis causas

Depuração no Unity

Ativação do modo de depuração no Unity

Para começar a depuração do SDK do Unity, adicione a seguinte linha ao método start no AF GameObject

AppsFlyer.setIsDebug (true);

Aviso!

A depuração deve ser restrita apenas à fase de desenvolvimento. Não distribua o aplicativo a lojas de aplicativos com a depuração ativada. Isso apresenta riscos à segurança e à privacidade.

Visualização do resultado da depuração

É possível ver o resultado da depuração através do Android Studio ou do XCode.

Identificação e solução de problemas comuns com o SDK do Unity

O Unity só desenvolve aplicativos Android e iOS. Consulte os problemas comuns de cada plataforma:

Problemas comuns com o SDK do Android
Problemas comuns com o SDK do iOS

Observação

Quando terminar de testar e depurar a integração do SDK, desative os logs do SDK.