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
- Android:
- 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 deep linking. Veja nosso guia OneLink aqui. É importante observar que a implementação de deep linking do SDK é altamente recomendada, conforme descrito no guia de integração de links diretos.
- Verifique se o retargeting está ativado.
- Clique em Executar teste abaixo de Deep linking
- 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étododidFinishLaunchingWithOptions
, 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 app stores Android de terceiros, é necessário definir o parâmetro af_r no link de atribuição para referenciar a app store 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.
Veja nosso artigo sobre o relatório de dados brutos da instalação para 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.
Veja nosso artigo sobre o relatório de dados brutos de eventos in-app para 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.
- Um dispositivo não registrado
Testar o retargeting é simples. Crie um link de atribuição personalizado fora de um modelo do OneLink. Certifique-se de ativar a Campanha de Retargeting.
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
Reengajamento via abertura de aplicativo significa que o usuário é redirecionado para a loja de aplicativos onde é apresentado um botão de abrir 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. Veja o 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
einit
foram chamados na classeAFApplication
. - 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 do cliente hello@appsflyer.com se você 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 uma ID de aplicativo no formato incorreto, as instalações e os eventos não serão registrados. Ao definir a 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
emapplicationDidBecomeActive
:
- (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
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
- 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
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.
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 a ID do aplicativo está incorreta. Ver Instalações e Eventos não são gravados.
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. Ver Instalações e Eventos não são gravados.
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 do cliente hello@appsflyer.com se você tiver dúvidas sobre nossos pacotes.
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:
Observação
Quando terminar de testar e depurar a integração do SDK, desative os logs do SDK.