How can we help?

teste de integração do iOS para ad networks

  • Atualizado

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:

  1. No dashboard da AppsFlyer, defina Habilitar privacidade avançada como desativado.
  2. No dispositivo:
    1. Verifique se o aplicativo de teste não está instalado. Exclua-o se necessário.
    2. Nas configurações de Privacidade, verifique se Permitir que Aplicativos Solicitem para Rastrear está ativado.

      PartnerIntegrationAllow.png

  3. Envie o link de atribuição para o dispositivo de teste.
  4. Abra o link de atribuição no navegador do dispositivo.
    Você será redirecionado para a App Store.
  5. Faça o download e abra o aplicativo.
    A caixa de diálogo de consentimento do ATT é exibida.

    AppDialogue_us-en.png

  6. Toque em Permitir.
    A página Dados de instalação é exibida.

    PartnerIntegrationInstallData.png

  7. Toque em ATT Status.
    O status Authorized é exibido.
  8. Valide a atribuição usando os seguintes parâmetros. Se a validação falhar, consulte Solução de problemas.

    1. install_time: próximo ao horário atual. O horário está em UTC. 
    2. af_status: não orgânico Se não for o caso, a instalação não foi atribuída. 
    3. media_source: sua ad network 
  9. Toque em Testes de eventos in-app.

    CompraNoAplicativo.png

  10. Toque em Evento de compra.
    A confirmação do evento de compra é exibida. 
  11. Verifique se:
    1. Você recebeu os postbacks de instalação e compra.
    2. O nome do evento está mapeado corretamente (se você mapeou eventos in-app).
    3. 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:

  1. No dashboard da AppsFlyer, defina Enable Advanced Privacy como ativado.
  2. No dispositivo:
    1. Verifique se o aplicativo de teste não está instalado. Exclua-o, se necessário.
    2. Nas configurações de Privacidade, verifique se a opção Permitir que aplicativos solicitem rastreamento está ativada.

      PartnerIntegrationAllow.png

  3. Envie o link de atribuição para o dispositivo de teste.
  4. Abra o link de atribuição no navegador do dispositivo.
    Você é redirecionado para a App Store.
  5. Faça o download e abra o aplicativo.
    A caixa de diálogo de consentimento do ATT é exibida.

    AppDialogue_us-en.png

  6. Toque em Solicitar ao aplicativo que não rastreie.
    A página Dados de instalação é exibida.

    PartnerIntegrationInstallData.png

  7. Toque em Status do ATT.
    O status Negado é exibido.
  8. Valide a atribuição usando os parâmetros listados. Se a validação falhar, consulte Solução de problemas

    1. install_time: próximo ao horário atual. O horário está em UTC. 
    2. af_status: Non-organic Se esse não for o caso, a instalação não foi atribuída. 
    3. media_source: sua ad network 
  9. Toque em Testes de Eventos in-app.

    AppPurchase.png

  10. Toque em Evento de compra.
  11. Verifique se:
    1. Você recebeu postbacks de instalação e compra.
    2. O nome do evento está mapeado corretamente (se você mapeou eventos in-app).
    3. 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.

PartnerIntegrationInstallData.png

As seguintes funções estão disponíveis:

  • Testes de evento in-app
    Envia eventos in-app purchase, login e registration. 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:

  1. Na AppsFlyer, acesse My Apps.
  2. Selecione id1543229303.
  3. No menu lateral, selecione Collaborate > Active Integrations > selecione sua ad network > a aba Attribution link.
  4. 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
  5. 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

AdvancedPrivacyOff.png

Para alterar a configuração Ativar Privacidade avançada: 

  1. Na AppsFlyer, acesse My Apps.
  2. Selecione o aplicativo id1543229303.
  3. No menu lateral, selecione Collaborate Active Integrations > selecione sua ad network > a aba Integration .
  4. Defina Enable Advanced Privacy para a configuração apropriada para cada cenário de teste. 
  5. Clique em Salvar Integração.

Aplicativo de teste integrado à sua conta

Para verificar se o aplicativo de teste está disponível na sua conta: 

  1. Na AppsFlyer, acesse My Apps.
  2. 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.


Share article: