How can we help?

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

  • Atualizado
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 o AP está ativado, os dados que os clientes podem disponibilizar por meio de postbacks ou outros métodos de relatório são agregados apenas. Os dados em nível de usuário, incluindo relatórios relacionados à fraude do Protect360, não são incluídos.

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. Vá para Configuração > Integrações ativas > selecione sua ad network > aba Integração. A configuração padrão está ativada. 

APforPartners2.png

Tipos de templates para envio de postbacks

  • Template comum: seu template de integração existente com a AppsFlyer com identificador de usuário e macros de dados de atribuição. Este template é usado para enviar postbacks contendo dados de atribuição no nível do usuário. 
  • Template de privacidade avançada: um template sem macros de identificador de usuário. Este template é usado para enviar postbacks contendo dados de atribuição agregados. 
    Observação: se um postback AP for necessário e você não tiver concluído a integração AP, nenhum postback será enviado. Você pode configurar a integração de AP usando nossa ferramenta autônoma de Gerenciamento de postbacks.

 Observaçã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.
  • Exceção: para instalações atribuídas a Apple Search Ads (ASA), o ASA envia postbacks de instalação para a ad network mesmo quando a Privacidade avançada está ativada para o anunciante nas seguintes condições:
    • o usuário não deu consentimento
    • postback de instalação na ad network foi definido como Todas as fontes de mídia, incluindo orgânica 
    • a ad network não oferece suporte à Privacidade Avançada

Tipo de postback usado 

A tabela a seguir descreve os tipos de postback com base na disponibilidade do ID do Anunciante e no status da Privacidade Avançada.

Tipo de postback para iOS 14.5+

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 Disponível. Não autorizado Modelo AP (dados agregados) Sem postback Nenhum
Ativado Não autorizado Disponível. Modelo AP (dados agregados) Sem postback

Autorizado

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

Ativado Disponível. Disponível. 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 comum incluindo IDs disponíveis. Os campos de atribuição não estão disponíveis.*
Ativado Não autorizado Não autorizado Modelo AP (dados agregados) Sem postback Nenhum
Desligado Não considerado Não considerado Template comum Template comum

Template comum.

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

(*) 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.

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

Status da ATT Tipo de postback para parceiro atribuído* Tipo de postback para parceiro não atribuído*
Aplicativo do publisher Aplicativo de 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.

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
    As 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_canal 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}

    Parâmetro

    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

  • 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

 Importante!

  • Para distinguir entre postbacks de eventos legítimos e postbacks rejeitados, é necessário configurar os postbacks das macros rejeitadas.

  • Para habilitar a rejeição de parcelas/postbacks de eventos, entre em contato conosco usando o widget partner assistant.

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

Tipo de postback
Instalação
in-app

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

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    
ativado - Sim    
ativado - Sim    
attributed_touch_hour

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

Formato, veja nota (1)

Sim    
tipo_de_toque_atribuído 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_canal Nome do canal Sim    
código_país 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    
nome_do_evento 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  
ativado

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    
Receita associada ao SKU na moeda fornecida no campo event_revenue_currency. Nome/ID do evento correspondente na plataforma da ad network   Sim  
platforma 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

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. Entre em contato conosco usando o widget partner assistant 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.

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

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 ativado: o tipo de postback depende da fonte do usuário e da disponibilidade do ID do Anunciante, conforme detalhado na tabela a seguir.

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

Fonte do usuário Status da ATT Tipo de postback para parceiro de análise
Aplicativo do publisher  Aplicativo do anunciante

Não orgânicas 


 

 


 

 

Disponível. Disponível. Regular
Não autorizado Disponível. Nenhum
Qualquer valor Não autorizado Nenhum
Orgânico ou web N/D Disponível. Regular
Orgânico ou web N/D Não autorizado Nenhum

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. 

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: