Em resumo: Teste sua integração do iOS com a AppsFlyer usando o aplicativo AppsFlyer Partner Integrations para acionar postbacks regulares e de Privacidade Avançada.
teste de integração do iOS
O teste consiste nos seguintes elementos:
- Use a versão para iOS do aplicativo AppsFlyer Partner Integrations para gerar eventos in-app de instalação e compra de teste. Esses testes, por sua vez, acionam postbacks enviados aos seus endpoints. Você também tem a opção de testar eventos in-app de login e registro.
- Ao receber os postbacks, verifique se você consegue ingerí-los.
Escopo do teste
Os anunciantes controlam os dados compartilhados com ad networks pela configuração de Privacidade Avançada. Essa configuração, em conjunto com a configuração de ATT do usuário do aplicativo, afeta o tipo de postback e os dados compartilhados com ad networks, conforme descrito no guia de postback de Privacidade Avançada. A tabela a seguir lista os cenários de teste de acordo com as combinações de configuração disponíveis.
Para cada cenário, você pode testar instalações e eventos in-app. Em relação aos eventos in-app, você pode usar o mapeamento de eventos in-app para mapear eventos do anunciante para os seus eventos.
Combinações de cenários de teste
|
Cenário |
Configuração de Privacidade Avançada | Configuração de ATT no aplicativo | Tipo de postback enviado |
|---|---|---|---|
| E | Desligado | Permitir | Regular |
| B | Ativado | Pedir ao aplicativo para não rastrear | Agregada da AppsFlyer |
Testes
Conclua os pré-requisitos e, em seguida, execute os procedimentos de teste nas seções a seguir. As seções de teste contêm, cada uma, uma tabela que você pode usar para registrar os resultados dos testes.
Pré-requisitos
Conclua os pré-requisitos antes de começar a executar o procedimento de teste.
| Pré-requisitos |
|---|
| Conclua a integração padrão com a AppsFlyer. Se necessário, entre em contato com a AppsFlyer usando o widget do assistente de parceiros. |
| Conclua a integração de Privacidade Avançada com a AppsFlyer. Se necessário, entre em contato com a AppsFlyer usando o widget do assistente do parceiro. |
| Integre o aplicativo de teste do iOS à sua conta. |
| Verifique se o aplicativo de teste está integrado à sua conta |
Mapeie os eventos in-app para os nomes dos seus eventos. Nomes de eventos a serem mapeados: purchase, login, registration
|
| Preparar link de atribuição |
| Teste usando um dispositivo com iOS 14.5+ |
Teste — Privacidade avançada desativada
Para acionar postbacks:
- No dashboard da AppsFlyer, defina Habilitar privacidade avançada como desativado.
- No dispositivo:
- Verifique se o aplicativo de teste não está instalado. Exclua-o se necessário.
- Nas configurações de Privacidade, verifique se Permitir que Aplicativos Solicitem para Rastrear está ativado.
- Envie o link de atribuição para o dispositivo de teste.
- Abra o link de atribuição no navegador do dispositivo.
Você será redirecionado para a App Store. - Faça o download e abra o aplicativo.
A caixa de diálogo de consentimento do ATT é exibida. - Toque em Permitir.
A página Dados de instalação é exibida. - Toque em ATT Status.
O status Authorized é exibido. -
Valide a atribuição usando os seguintes parâmetros. Se a validação falhar, consulte Solução de problemas.
-
install_time: próximo ao horário atual. O horário está em UTC. -
af_status: não orgânicoSe não for o caso, a instalação não foi atribuída. -
media_source: sua ad network
-
- Toque em Testes de eventos in-app.
- Toque em Evento de compra.
A confirmação do evento de compra é exibida. - Verifique se:
- Você recebeu os postbacks de instalação e compra.
- O nome do evento está mapeado corretamente (se você mapeou eventos in-app).
- Você consegue receber o postback.
Privacidade avançada desativada — Resultados do teste
|
Postback |
Horário em que você acionou o evento |
Tipo de postback esperado | Postback efetivamente recebido (aprovado/reprovado) | Validação do postback (aprovado/reprovado) |
|---|---|---|---|---|
| não relacionada | Regular | |||
| Evento in-app: Compra | Regular |
Teste — Privacidade avançada ativada
Para acionar postbacks:
- No dashboard da AppsFlyer, defina Enable Advanced Privacy como ativado.
- No dispositivo:
- Verifique se o aplicativo de teste não está instalado. Exclua-o, se necessário.
- Nas configurações de Privacidade, verifique se a opção Permitir que aplicativos solicitem rastreamento
está ativada.
- Envie o link de atribuição para o dispositivo de teste.
- Abra o link de atribuição no navegador do dispositivo.
Você é redirecionado para a App Store. - Faça o download e abra o aplicativo.
A caixa de diálogo de consentimento do ATT é exibida. - Toque em Solicitar ao aplicativo que não rastreie.
A página Dados de instalação é exibida. - Toque em Status do ATT.
O status Negado é exibido. -
Valide a atribuição usando os parâmetros listados. Se a validação falhar, consulte Solução de problemas.
-
install_time: próximo ao horário atual. O horário está em UTC. -
af_status: Non-organicSe esse não for o caso, a instalação não foi atribuída. -
media_source: sua ad network
-
- Toque em Testes de Eventos in-app.
- Toque em Evento de compra.
- Verifique se:
- Você recebeu postbacks de instalação e compra.
- O nome do evento está mapeado corretamente (se você mapeou eventos in-app).
- Você consegue ingerir o postback.
Privacidade avançada ativada — Resultados do teste
|
Postback |
Horário em que você acionou o evento |
Tipo de postback esperado | Postback real recebido (aprovado/reprovado) | Validação do postback (aprovado/reprovado) |
|---|---|---|---|---|
| não relacionada | Agregada da AppsFlyer | |||
| Evento in-app: Compra | Agregada da AppsFlyer |
Informações e procedimentos complementares
Sobre o aplicativo de teste de integrações de parceiros
O aplicativo Partner Integrations está disponível na loja de aplicativos. O aplicativo envia eventos de instalação e in-app para a plataforma AppsFlyer.
Quando o aplicativo é aberto pela primeira vez, a caixa de diálogo do iOS Solicitar rastreamento é exibida, seguida pela página Dados de instalação, que mostra os dados de conversão registrados na plataforma AppsFlyer. Os eventos in-app de teste são acionados na interface do usuário.
As seguintes funções estão disponíveis:
-
Testes de evento in-app
Envia eventos in-apppurchase,logineregistration. Ao mapear os nomes dos eventos in-app do aplicativo para os nomes dos seus eventos, os postbacks são preenchidos usando os nomes dos seus eventos. -
Status de ATT
Retorna o status atual de ATT reportado pelo iOS como Authorized ou Denied. O status de ATT depende do consentimento do usuário para rastrear na caixa de diálogo de consentimento de ATT e da configuração do dispositivo Permitir que aplicativos solicitem para rastrear.
Link de atribuição
Prepare um link de atribuição no dashboard da AppsFlyer usando um dos seguintes métodos:
- Gere o link no dashboard da AppsFlyer.
- Edite o link de exemplo a seguir.
Para gerar um link no dashboard:
- Na AppsFlyer, acesse My Apps.
- Selecione id1543229303.
- No menu lateral, selecione Collaborate > Active Integrations > selecione sua ad network > a aba Attribution link.
- Na aba Link de atribuição, defina os parâmetros listados. Você pode adicionar parâmetros adicionais, se necessário.
Parâmetro Valor de exemplo Comentário Campaign c-test-2020-12-20 Defina um valor que seja identificável em seus postbacks - Copie o link resultante para usar depois.
Exemplo de link de atribuição:
https://app.appsflyer.com/id1543229303?pid=pitestap_int&c=c-test-2020-12-20
Definir Privacidade avançada
Para alterar a configuração Ativar Privacidade avançada:
- Na AppsFlyer, acesse My Apps.
- Selecione o aplicativo id1543229303.
- No menu lateral, selecione Collaborate > Active Integrations > selecione sua ad network > a aba Integration .
- Defina Enable Advanced Privacy para a configuração apropriada para cada cenário de teste.
- Clique em Salvar Integração.
Aplicativo de teste integrado à sua conta
Para verificar se o aplicativo de teste está disponível na sua conta:
- Na AppsFlyer, acesse My Apps.
- Verifique se o aplicativo Partner Integrations id1543229303 é exibido em Apps disponíveis. Se esse não for o caso, entre em contato com seu Gerente de Desenvolvimento de Parceiros.
Resolução de problemas
| Problema | Causa/ação corretiva |
|---|---|
| O horário da instalação não é o horário atual |
O aplicativo não foi excluído antes da instalação. Exclua o aplicativo e repita o procedimento. |
| O canal de mídia não é o seu canal de mídia | Verifique se você definiu o valor correto de pid no link de atribuição. Verifique se você está usando o link de atribuição correto |
| af_status é orgânico |
Verifique se a versão do iOS do dispositivo está de acordo com a indicada nos pré-requisitos. Verifique o formato do link de atribuição, especialmente o valor de pid. |
This article was translated using AI and may contain errors. For the most accurate information, please refer to the English version using the language selector.