Guia de Privacidade Avançada e macros de postback para ad networks

Em muitos casos, dependendo do consentimento do usuário à ATT, o IDFA não estará disponível no aplicativo do editor, no aplicativo do anunciante ou em nenhum dos dois. Nesses casos, a AppsFlyer pode realizar a atribuição usando a Privacidade Avançada Agregada e a modelagem probabilística.

[Prática recomendada] Para maximizar suas atribuições, envie todos os parâmetros listados.

1. Anexe os seguintes parâmetros para URLs de clique:

   Identificador	Parâmetro de clique	Exemplo
   Campanha	c	US_20_30
   ID da campanha	af_c_id	12345
   Conjunto de anúncios	af_adset	ADSET_1
   ID do conjunto de anúncios	af_adset_id	56789
   Ad	af_ad	creative_name
   ID do anúncio	af_ad_id	34567
   ID do site	af_siteid	abcdefgh12345678
   ID do subsite	af_sub_siteid	abcdefgh12345678
   Canal	af_channel	channel_name
   Tipo de anúncio	af_ad_type	Vídeo
   Modelo do dispositivo iOS*	af_model	O modelo do dispositivo. Valores permitidos: iphone (tudo em letra minúscula) ipad (tudo em letra minúscula)
   Sistema operacional*	af_os	A versão do sistema operacional
   * Algumas informações também podem ser fornecidas por meio do agente do usuário. Nesse caso, o valor enviado usando o identificador específico prevalece.

   
   Anexar detalhes da campanha à URL de cliques

   O exemplo a seguir mostra como adicionar os detalhes da campanha à URL de clique:

   https://app.appsflyer.com/id123456789?pid=YOUR_NETWORK_ID&c={CampaignName}&af_c_id={CampaignID}&af_adset={adset name}&af_adset_id={adset ID}&af_ad={ad name}&af_ad_id={ad ID}&af_ad_type={Ad type}&af_siteid={PublisherId}

2. Adicione os seguintes parâmetros obrigatórios para clicar em URLs*:
   
   

    Atenção

   Se a sua URL de clique não passar nos parâmetros obrigatórios, você não será creditado pela maioria das instalações impulsionadas por você.

   • IP 
   • Agente de usuário 

   * Nenhuma ação é necessária ao enviar um clique usando um referenciador HTTP simples que redireciona para a AppsFlyer. 

   Use o método de extração descrito para anexar os parâmetros à URL de clique ao usar um dos seguintes métodos: 

   • Redirecionar via in-app 
   • Cliques de servidor para servidor (também conhecido como S2S) 

   Parâmetros para atribuição de privacidade avançada

   Parâmetro	Obrigatório	Método de extração
   Idioma e localização do dispositivo af_lang	Não	NSString *language = [[NSLocale preferredLanguages] objectAtIndex:0]; [Recomendado] Forneça o idioma e a localização; por exemplo, en-US.
   Agente de usuário  af_ua	Sim	Extraia o user-agent (agente do usuário) com o formato: Mozilla%2F5.0+%28iPhone%3B+CPU+iPhone+OS+13_3_1 +like+Mac+OS+X%29 AppleWebKit%2F605.1.15+%28KHTML%2C +like+Gecko%29+Mobile%2F15E148 Não extraia o  user-agent do CFNetwork, extraia o outro. O user-agent deve ser codificado por URL
   Endereço de IP do dispositivo af_ip	Sim	Melhor opção: se disponível, forneça o IP do dispositivo sob o parâmetro af_ip. Próxima opção: se disponível, a AppsFlyer usará o IP no X-Forwarded-For.

   
   Anexar parâmetros à URL de clique

   Para passar esses parâmetros obrigatórios no link de atribuição de cliques, use essa referência:

   https://app.appsflyer.com/id123456789?pid=YOUR_NETWORK_ID&c={CampaignName}&af_c_id={CampaignID}&af_adset={adset name}&af_adset_id={adset ID}&af_ad={ad name}&af_ad_id={ad ID}&af_ad_type={Ad-type}&af_siteid={PublisherId}&af_ua={USER-AGENT}&af_lang={LANGUAGE}&af_ip={IP}

   Exemplo

   GET https://app.appsflyer.com/id123456789?pid=YOUR_NETWORK_ID&c={CampaignName}&af_c_id={CampaignID}&af_adset={adset name}&af_adset_id={adset ID}&af_ad={ad name}&af_ad_id={ad ID} &af_ad_type={Ad type}&af_siteid={PublisherId} &af_ua=Mozilla%2F5.0%20%28iPhone%3B%20CPU%20iPhone%20OS%2012_1_4%20 like%20Mac%20OS%20X%29%20AppleWebKit% 2F605.1.15%20%28KHTML%2C%20like%20Gecko%29%20Mobile%2F16D57&af_lang=en-US&af_ip=11.11.1.11

   * Os parâmetros de consulta devem ser codificados por URL.

   Transferir dados em cabeçalhos de URL de cliques

   Para transferir os campos no cabeçalho da URL de clique, use esta referência:

   GET https://app.appsflyer.com/id123456789?pid=YOUR_NETWORK_ID&c={CampaignName}&af_c_id={CampaignID}&af_adset={adset name}&af_adset_id={adset ID}&af_ad={ad name}&af_ad_id={ad ID}&af_ad_type={Ad type}&af_siteid={PublisherId} accept-language: en-US,en;q=0. User-agent: Mozilla/5.0 (iPhone; CPU iPhone OS 13_5_1 como Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148 X-Forwarded-For: 11.11.1.11, 222.222.2.222

Para receber postbacks de Privacidade Avançada, você deve configurar uma integração de Privacidade Avançada além da integração normal de postback. Você mesmo pode configurar o postback de Privacidade Avançada no dashboard da AppsFlyer.

Diferenças entre o template comum e o template da Privacidade Avançada

• Os postbacks são enviados em lotes por hora.
  • Os lotes incluem todos os tipos de eventos.
  • Os lotes incluem postbacks de atribuição e de rejeição.
  • 0,001% dos postbacks podem ser enviados em lotes posteriores, com possíveis atrasos de até 24 horas.
• O tempo do postback não está relacionado aos tempos reais do evento.
• Macros de carimbo de data/hora:
  • Para instalações e eventos in-app, os carimbos de data/hora são arredondados e se aproximam da hora em que ocorreram. Por exemplo, 22:55:30 é reportado como 22:00:00.
  • São reportados usando o fuso horário UTC. Exemplo de carimbo de data/hora: (2020-07-20 20:00:00)
• Os seguintes parâmetros não estão disponíveis nos postbacks de Privacidade Avançada: Click ID, Customer User ID, AppsFlyer ID, IDFA, IDFV, modelo do dispositivo, versão do sistema operacional e operadora.

Ação exigida pela ad network para a integração:

1. Configure seu postback de Privacidade Avançada no dashboard da AppsFlyer. 
2. Teste a integração da Privacidade Avançada

Endpoint do postback de Privacidade avançada [complete conforme necessário]

Macros de atribuição de Privacidade Avançada disponíveis

Configure seu postback de AP usando a opção de gerenciamento de postback no dashboard da AppsFlyer.

Pré-requisitos:

• Você deve ter uma integração ativa com a AppsFlyer para gerenciar seu postback de Privacidade Avançada. Entre em contato conosco usando o widget partner assistant para criar uma integração.
• O gerenciamento de postback é realizado pelo administrador da conta; os membros da equipe não têm acesso.

Para configurar o postback:

1. Clique no menu suspenso superior direito > Gerenciamento de postback.
2. Selecione o tipo de postback: Privacidade Avançada. 
3. Ative o criador.
   

   

4. Insira o endereço do endpoint: a URL do endpoint para a qual a AppsFlyer envia postbacks. Insira as URLs relevantes para instalações e/ou eventos in-app.
5. Insira os parâmetros a serem incluídos nos postbacks:
   • Nome do parâmetro: nome da tela do parâmetro da AppsFlyer
   • Seu parâmetro de recebimento: o respectivo parâmetro de recebimento do seu lado
   • Valor do parâmetro (disponível para alguns parâmetros): escolha o formato do valor. Por exemplo, para valores booleanos, escolha se deseja recebê-los como "true"/"false" ou 1/0.
   • Instalação: marque a caixa para incluir o parâmetro no postback de instalação.
   • Evento in-app: marque a caixa para incluir o parâmetro no postback do evento in-app.

   

   Lista completa de macros de postback de Privacidade Avançada.

6. [Opcional] Adicione parâmetros personalizados que não são fornecidos pela AppsFlyer:

   

7. Verifique a visualização final do template de postback para ter certeza de que tudo está correto.

   

8. Clique em Salvar. Observe que, quando você salva o postback, as alterações entram em vigor imediatamente.

No caso de problemas, entre em contato conosco usando o widget partner assistant.

Os postbacks são enviados aos parceiros de análise da seguinte forma:

• AP desativada: postback a nível do usuário sem restrição.
• AP ativada: de acordo com a fonte do usuário e o status da ATT conforme detalhado nesta tabela; 

Tipo de postback do parceiro de análise de acordo com o status da ATT e fonte do usuário

SKAdNetwork é uma tecnologia de atribuição fornecida pela Apple para dispositivos iOS. A Privacidade Avançada faz parte da estrutura de Privacidade Avançada Agregada (AAP) da AppsFlyer e está relacionada à atribuição realizada pela AppsFlyer. A AAP oferece aos anunciantes a capacidade de controlar a disponibilidade de dados de atribuição a nível do usuário por meio da plataforma da AppsFlyer. Normalmente, as ad networks têm compatibilidade para a integração entre AP e SKAdNetwork.