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

Visão geral: compartilhamento de dados com parceiros quando a Privacidade Avançada está habilitada. Instruções para ad networks sobre a configuração de postbacks de Privacidade Avançada. Atenção! Este artigo não está relacionado aos postbacks de SKAdNetwork nem se destina a anunciantes. 

Novidades da Privacidade Avançada para ad networks

O mecanismo de postback de Privacidade Avançada descrito neste artigo funciona quando todos os itens a seguir são verdadeiros:

  • O dispositivo do usuário está executando o iOS 14.5+
  • A Privacidade Avançada está ativada

AdvancedPrivacy.png

Este artigo discute: 

Princípios de compartilhamento de dados de Privacidade Avançada da ad network

A partir do iOS 14.5+, a AAP (framework de Privacidade Avançada Agregada - Aggregated Advanced Privacy) da AppsFlyer oferece aos anunciantes a capacidade de controlar a disponibilidade dos dados de atribuição a nível do usuário fornecidos pela plataforma da AppsFlyer. 

No contexto das ad networks, o framework de AAP é implementada usando a Privacidade Avançada (AP). Para facilitar a compreensão, os termos Privacidade Avançada e AP são usados de forma intercambiável neste artigo. 

A AP (Privacidade Avançada) não afeta a disponibilidade de dados agregados disponíveis para parceiros ou ad networks.

Quais dados são afetados pela AP

Quando a AP está ativada, os dados a nível do usuário para usuários que não deram o consentimento e executam o iOS 14.5+ não estão disponíveis por meio de postbacks ou outros métodos de relatório, incluindo relatórios de fraudes do Protect360.

No contexto de postbacks, isso significa que diferentes tipos de postbacks são usados, dependendo do status de consentimento à ATT do usuário e de outros fatores. 

Você pode visualizar a configuração atual da AP, por aplicativo, no dashboard da AppsFlyer. Acesse Configuração > Parceiros Integrados > selecione sua ad network > aba Integração. A configuração padrão está ativada. 

APforPartners2.png

Os tipos de postback necessários para a integração da Privacidade Avançada são:

  • Comum: seu template de integração já utilizado com a AppsFlyer. Contém macros de dados de atribuição e de identificação do usuário.
  • Privacidade Avançada: template sem macros de identificação do usuário. Se um postback de AP for necessário e você não tiver concluído a integração de AP, nenhum postback será enviado. Você pode configurar a integração de AP usando nossa ferramenta autônoma de gerenciamento de postbacks.

Atenção! Se um usuário der o consentimento da ATT nos aplicativos do anunciante e do editor ("consentimento duplo"), postbacks regulares serão enviados para as ad networks atribuídas e não atribuídas.  

Tipo de postback usado 

A tabela a seguir é aplicável aos dados de usuários que executam o iOS 14.5+.

Atenção! Se a versão do iOS for 14.4 ou anterior, a tabela a seguir não será aplicável. Isso significa que os postbacks que usam o template normal são enviados para a ad network atribuída e não atribuída. 

Status da AP

Status da ATT Tipo de template de postbacks para parceiro atribuído*, que é compatível com a AP  Tipo de template de postback para o parceiro atribuído* não compatível com a AP   Parceiro de postback não atribuído*

Aplicativo do publisher

Aplicativo do anunciante

ativado

Autorizado

Não autorizado

Template da AP

Sem postback

Nenhum

ativado

Não autorizado

Autorizado

Template da AP

Sem postback

Template comum. Os campos de atribuição não estão disponíveis.*

ativado

Autorizado

Autorizado

Template comum. Isso inclui IDs disponíveis como: IDFA, IDFV, CUID, ID de clique e campos de atribuição.

Template comum. Isso inclui IDs disponíveis como: IDFA, IDFV, CUID, ID de clique e campos de atribuição. Template regular, incluindo IDs disponíveis. Os campos de atribuição não estão disponíveis.*

ativado

Não autorizado

Não autorizado

Template da AP

Sem postback

Nenhum

Desligado

Não considerado

Não considerado

Regular

Regular

Template comum. Os campos de atribuição não estão disponíveis.*

Tipo de postback para iOS 14.5+

(*) Princípios para compartilhamento de dados com parceiros

Para qualquer evento, vários parceiros da ad network podem ter direito a um postback. Os postbacks enviados são os seguintes:

  • Parceiro atribuído: ad network creditada pelo evento
  • Parceiro não atribuído: parceiro integrado não creditado pelo evento, quando a opção Envio de postback de eventos in-app está definida como Todas as fontes de mídia, incluindo orgânicas. Se o aplicativo do anunciante tiver o consentimento à ATT, o postback conterá IDs de usuário sem dados atribuídos. (Essa opção não é compatível com todas as ad networks.)

    InAppEventAll.png

Campanhas na web

A AP se comporta de maneira diferente quando a ad network exibe um anúncio na web.

Para indicar se um clique veio da web ou de um aplicativo, você deve enviar o parâmetro af_media_type=web ou af_media_type=app na URL de clique.

Se você não enviar af_media_type, o padrão é app.

Status da ATT Tipo de postback para parceiro atribuído* Tipo de postback para parceiro não atribuído*

Aplicativo do publisher

Aplicativo do anunciante

N/D

Não autorizado

Privacidade avançada

Nenhum

N/D

Autorizado

Comum. Nível do usuário com os seguintes IDs: IDFA, IDFV, CUID, Click ID.

Comum. Somente IDs a nível do usuário.

Tipo de postback usado para iOS 14.5+ quando a AP está ativada

integração

Atualize suas URLs de cliques e conclua a integração com a Privacidade Avançada.

Requisitos da URL de clique

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â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.

    Parâmetros para atribuição de Privacidade Avançada


    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

Especificação do postback de Privacidade Avançada

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: ID de clique, ID de usuário do cliente, ID da AppsFlyer, IDFA, IDFV, modelo do dispositivo, versão do sistema operacional, 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
Tipo de postback
Instalação
in-app
Endpoint do postback de Privacidade Avançada [complete conforme necessário]

Macro do postback (nome)

Observações Parâmetros básicos para todos os postbacks Parâmetros opcionais para eventos in-app  Parâmetros opcionais para atribuição rejeitada
af_ad Nome do criativo Sim    
af_ad_id 34567 Sim    
af_ad_type Como: banner, footer, vídeo Sim    
af_adset ADSET_1 Sim    
af_adset_id 56789 Sim    
app_id - Sim    
app_name - Sim    
attributed_touch_hour

Arredondado para baixo, para a hora mais próxima. 

Formato, veja nota (1)

Sim    
attributed_touch_type Como: clique, impressão Sim    
blocked_reason Relaciona-se a regras de validação/Protect360     Sim
blocked_reason_value Relaciona-se a regras de validação/Protect360     Sim
blocked_sub_reason Relaciona-se a regras de validação/Protect360     Sim
bundle_id Conforme definido pelo anunciante Sim    
c Nome da campanha, como US_20_30 Sim    
af_c_id ID da campanha, como 12345 Sim    
af_channel Nome do canal Sim    
country_code Código ISO do país registrado na conversão Sim    
event_hour

Arredondado para baixo, para a hora mais próxima. 

Formato, veja nota (1)

Sim    
event_name Conforme reportado pelo aplicativo   Sim  
event_revenue Valor da receita na moeda do evento   Sim  
event_revenue_
currency
Código da moeda da receita   Sim  
event_revenue_usd Receita convertida em USD   Sim  
install_hour

Arredondado para baixo, para a hora mais próxima. 

Formato: veja nota (1)

Sim    
is_first Verdadeiro se esta for a primeira vez que esse evento in-app foi acionado por um usuário final específico   Sim  
is_primary

Use para desduplicar

Booleano: 0, 1

  Sim  
is_retargeting

Use para desduplicar 

Formato: veja a nota (2)

Sim    
is_reengagement

Formato: veja a nota (2)

  Sim  
is_reattribution

Use para desduplicar 

Formato: veja a nota (2)

Sim    
match_type Como: id_matching, probabilístico Sim    
event_id Nome/ID do evento correspondente na plataforma da ad network   Sim  
platform Como: iOS, Android Sim    
postback_id ID de postback exclusivo Sim    
retargeting_
conversion_type
Tais como: reengajamento, reatribuição Sim    
af_siteid abcdefgh12345678 Sim    
af_sub_siteid abcdefgh12345678 Sim    

Observações:

(1) Formatos de carimbo de data/hora disponíveis:

  • [Padrão] String: AAAA-MM-DD HH:MM:SS
  • Marca temporal: carimbo de data/hora Unix de 10 dígitos 

(2) Formato booleano disponível

  • [Padrão] Numérico: 0, 1 
  • String: false, true
Macros de atribuição de Privacidade Avançada disponíveis

Configurando seu postback de Privacidade Avançada

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. Envie um e-mail para integrations@appsflyer.com para criar uma integração.
  • AppsFlyerAdmin_us-en.png 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.

    postback-management-enter-endpoint_en-us.png

  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.

    postback-management-parameters_en-us.png

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

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

    postback-management-custom-parameters_en-us.png

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

    postback-management-template_en-us.png

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

Em caso de problemas, mande um e-mail para integrations@appsflyer.com.

Informações adicionais

AP para parceiros de análise

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; 

Fonte do usuário

Status da ATT Tipo de postback para parceiro de análise

Aplicativo do publisher

 Aplicativo de anunciante

Não orgânicas 


 


 

Autorizado

Autorizado

Regular

Não autorizado

Autorizado

Nenhum

Qualquer valor

Não autorizado

Nenhum

Orgânico ou web

N/D

Autorizado

Regular

Orgânico ou web

N/D

Não autorizado

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

AP vs. SKAdNetwork

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.

Este artigo foi útil?