Configuração da integração GMP DV360/CM (DoubleClick)

Visão geral: integre a AppsFlyer ao Google Marketing Platform DV360/CM (DoubleClick). Observe que o nome interno da AppsFlyer para essa integração é doubleclick_int.

 Leitura relacionada

Para uma visão completa sobre como trabalhar com o Google Marketing Platform (GMP) na AppsFlyer, confira estes artigos:

Configuração do GMP na AppsFlyer

As informações nesta seção se aplicam a:

  • CM360 + fonte de mídia
  • Campanhas DV360

Ativar o Google Marketing Platform

Para ativar o Google Marketing Platform:

  1. Na AppsFlyer, acesse o Marketplace: a partir do menu superior de qualquer página da AppsFlyer, clique em Marketplace
  2. Pesquise por Google Marketing Platform - DV360/CM (DoubleClick) e selecione.
  3. Clique em Configurar a integração. Você é direcionado para a página de configuração de integração. Verifique se a URL mostra doubleclick_int.
  4. Na aba Integração, habilite Ativar parceiro.
    Observação: a alavanca deve permanecer habilitada (ativada) enquanto você trabalhar com o parceiro. Saiba mais sobre a ativação de parceiros.
  5. Clique em Salvar integração

Recuperação de parâmetros do Floodlight

Antes de configurar o GMP, você deve criar um floodlight de instalação (first_open) e recuperar seus parâmetros. Para mais informações, consulte aqui. É necessário obter os seguintes parâmetros: 

  • cat —a string de tag de atividade, usada pelos servidores do Floodlight para identificar o grupo de atividades ao qual a atividade pertence.
  • src — o ID do anunciante que é a fonte da atividade do Floodlight. Este é o parâmetro src= na tag do floodlight que você exporta da tela de configuração "Pixel", não o ID do anunciante do DBM.
  • type — a string de tag do grupo, que identifica o grupo de atividades ao qual a atividade do Floodlight está associada.
  • Token - veja instruções para recuperar o token:

Esses parâmetros são necessários para a integração com a AppsFlyer.

 Nota

Os parâmetros do Floodlight são exclusivos para cada aplicativo. Você deve ter dois conjuntos de parâmetros do Floodlight, um para cada aplicativo.

Integração com o Google Marketing Platform 

  1. Na AppsFlyer, vá para Configuração > Parceiros integrados ativos.
  2. Selecione Google Marketing Platform.
    As abas de configuração disponíveis são: Integração, Receita de anúncios e Permissões. Conclua a configuração conforme necessário. 

Além da atribuição mobile baseada em cliques, o GMP oferece atribuições de exibição e reengajamento, que você pode registrar com a AppsFlyer.

Para obter uma descrição detalhada do Cabeçalho da janela de configuração de parceiros, clique aqui.

Guia Integração

Quando a AppsFlyer consulta o GMP, ele retorna os parâmetros mencionados na resposta. Eles são mapeados para os parâmetros e dados brutos da AppsFlyer conforme mostra a tabela a seguir. 

Parâmetro do GMP Nome do parâmetro da AppsFlyer Parâmetro da URL 
ID de posicionamento Nome da campanha C
ID de posicionamento ID da campanha af_c_id
ID do site ID do site af_siteid
ID do anúncio ID do conjunto de anúncios af_adset_id
ID criativa ID do anúncio af_ad_id

Configuração dos parâmetros do Floodlight

Na guia de integração, configure os parâmetros de Floodlight em seus respectivos campos.

Atribuição de instalação 

Instalar janela lookback de clique

  • Defina o tempo máximo do clique à instalação. Somente as instalações (primeiras inicializações) que acontecerem dentro da janela de lookback podem ser atribuídas ao GMP.
  • A janela de lookback por clique padrão do GMP é de 30 dias. Para minimizar as discrepâncias, recomendamos o alinhamento com a configuração do GMP.
  • Sobre a janela de lookback de clique.

Instalar janela de lookback de exibição

  • Defina o tempo máximo da impressão à instalação. Somente instalações (primeiras inicializações) que acontecerem durante essa janela de lookback, após uma impressão de anúncio, serão atribuídas ao parceiro, desde que não haja outros clique em anúncio relevante.
  • Ative a atribuição de instalações de exibição do GMP. Você pode personalizar esse valor para que seja de 1 a 23 horas ou 1 a 7 dias.
  • A janela de lookback por clique padrão do GMP é de 7 dias. Para minimizar as discrepâncias, recomendamos o alinhamento com o valor do período de tempo do GMP.

Atribuição de reengajamento

Para mensurar campanhas de retargeting:

  1. Ative a Atribuição de reengajamento.
    Se você não tiver nenhuma campanha de reengajamento do GMP ativa, desative a atribuição de reengajamento. 
  2. Crie um novo Floodlight para campanhas de retargeting (por exemplo, app_opens). Depois, no dashboard da AppsFlyer, insira os parâmetros cat, src, token, e type específicos das suas campanhas de retargeting.

     Nota

    O parâmetro token é o mesmo parâmetro de token recebido ao habilitar a conversão no aplicativo móvel de terceiros.

Janela de lookback de reengajamento por clique

Defina a duração da Janela de lookback de reengajamento por clique (o período máximo após o clique em um anúncio, durante o qual um usuário redirecionado pode ser atribuído ao anúncio). Você pode definir o valor em horas (até 23) ou dias (1-30):

reengagement-activate.png

Janela de lookback de reengajamento por exibição

Para começar a atribuir impressões de anúncios de retargeting, ative a Atribuição de reengajamento por exibição.

Em seguida, defina a duração da Janela de lookback de reengajamento por exibição (o período máximo depois de um anúncio ser visualizado, durante o qual um usuário redirecionado pode ser atribuído ao anúncio). Você pode definir o valor em horas (até 23) ou dias (1-7):

Janela de reengajamento

Defina a duração da Janela de reengajamento (o período em que os eventos in-app do usuário são atribuídos à fonte de mídia de retargeting). Você pode definir os valores em dias (1 a 90), horas (até 23) ou até mesmo a vida útil:

 Nota

As contas de agência podem configurar o Retargeting de forma independente e ter uma janela de reengajamento separada. Por exemplo, um anunciante pode usar uma janela de 30 dias para suas próprias campanhas de retargeting, enquanto uma agência que executa outras campanhas para o mesmo aplicativo pode configurar uma janela de reengajamento de 45 dias.

Configurações de eventos in-app

Primeiro, crie um Floodlight para uma atividade específica, como uma compra ou assinatura.
Depois, recupere os parâmetros do Floodlight.

  1. Defina Postbacks de eventos in-app como ATIVADO
  2. Selecione a opção de envio para todos os eventos definidos pelo SDK
    - Somente eventos atribuídos a este parceiro para eventos provenientes apenas de usuários atribuídos ao GMP
    - Eventos atribuídos a qualquer parceiro ou orgânico para que toda a sua base de usuários esteja disponível e seja relatada ao GMP
  3. Clique em Add Event (Adicionar Evento) para adicionar um evento do SDK à lista
  4. Selecione o Nome do evento de SDK
  5. Em Identificador de evento de parceiro, configure o evento usando os parâmetros do floodlight:
    o formato deve ser definido como mostramos abaixo:
    token=123XXX456XXX&type=XXXXXXXX&cat=XXXXX123456&src=58XXX35

doubleclick_in_app_events.png

 Nota

  • Os parâmetros do Floodlight são exclusivos por evento. Para cada evento in-app que você configurar no postback, é necessário fornecer parâmetros exclusivos do Floodlight.
  • Os parâmetros do Floodlight são exclusivos para cada aplicativo. 
  • Os detalhes dos parâmetros devem sem preenchidos com base no que foi inserido nos campos cat, src, token e type acima.
  • Os dois parâmetros adicionais a seguir são transferidos automaticamente para o GMP: Order_ID e af_revenue.

A AppsFlyer oferece suporte apenas ao envio de parâmetros adicionais do Floodlight (parâmetros U) até U26. Os parâmetros U são pré-mapeados e corrigidos pela AppsFlyer, portanto, leve em conta o seguinte:

  • Como eles são pré-mapeados, nenhum parâmetro U personalizado adicional pode ser configurado.
  • Siga esse mapeamento ao configurar parâmetros personalizados de floodlight no GMP.
  • Se a AppsFlyer não puder enviar um parâmetro U específico, a AppsFlyer não o enviará. Por exemplo, se os dados da operadora estiverem ausentes, a AppsFlyer não enviará o u5.

Mapeamento de parâmetros

Para cada evento in-app, a AppsFlyer envia os seguintes Floodlights:

  Descrição Exemplo

u1=

id do dispositivo af

1540995037437-2811776739500410055

u2=

id de usuário cliente

eaf8a5f2.1836.4686

u3=

Android:
ID de publicidade
iOS: idfa

9d9d03ab-f211-4e17-994e-d0afdf23ac01

u4=

WiFi

verdadeiro

u5=

carrier

Jio%204G

u6=

código do país

IN

u7=

Região

HR

u8=

city

Gurgaon

u9=

tipo do dispositivo

motorola::Moto G (4)

u10=

versão do so

7

u11=

versão do sdk

v4.8.18

u12=

versão do aplicativo

3.31.1

u13=

carimbo de data/hora da instalação

1540995041

u14=

hora do clique

1546441586

u15=

hora da impressão

1546441586

u16=

nome da campanha*

Appinstall_campaign

u17=

ID da campanha

12345ABC

u18=

nome do conjunto de anúncios*

Appinstall_adset

u19=

ID do conjunto de anúncios

12345ABC

u20=

ad name*

Appinstall_ad

u21=

ID do anúncio

12345ABC

u22=

site id

site_id_123456

u23=

event time

2019-01-04 12:56:35.707

u24=

Nome do evento

af_purchase

u25=

Valor do evento

{"af_price":459,"af_content_id":"77147","af_revenue":4.59,"af_currency":"EUR"}

u26=

currency

EUR

*Nesses casos, a AppsFlyer não recebe o nome como resposta da plataforma do Google Marketing,  então preenche o campo com a ID correspondente (ex.: o nome do conjunto de anúncios se torna a ID do conjunto de anúncios).

Guia link de atribuição

A aba do link de atribuição não é funcional para o GMP, porque é uma SRN e, portanto, não usa links de atribuição externos para atribuição.

No entanto, os links de atribuição desempenham um papel na integração com o GMP:

Links de atribuição para CM360 + fonte de mídia

Para executar campanhas com o CM360 e fonte de mídia, são necessários dois links de atribuição:

  • Um link de mensuração CM360.
  • O link de atribuição da AppsFlyer para uma fonte de mídia específica (parceiro integrado ou fonte de mídia personalizada).

Veja como configurar links de atribuição para CM360.

Links de atribuição para DV360 (DBM)

É possível usar os links de atribuição da AppsFlyer com o DV360 somente para gravação de impressões e cliques. Esses links não são usados para atribuição e qualquer informação adicional contida neles não é analisada ou usada para qualquer finalidade.

Se você deseja medir o número de cliques de DV360 na AppsFlyer, deve adicionar uma URL de atribuição da AppsFlyer no seu painel DV360. Ao fazer isso, certifique-se de que o nome da campanha na URL de atribuição é idêntico à ID de posicionamento no GMP (se possível) para que a AppsFlyer possa recuperar e anexar os dados de cliques nas campanhas corretas.

 

O uso de links de atribuição para o GMP DV360 (DBM) não é obrigatório.


Se você quiser contar os cliques na AppsFlyer, use este link:

https://app.appsflyer.com/ADD-APP-ID?pid=doubleclick_int&af_siteid=${UNIVERSAL_SITE_ID}
&af_ad_id=${CREATIVE_ID}&c=${PLACEMENT_ID}&af_c_id=${PLACEMENT_ID}

Se você quiser contar as impressões na AppsFlyer, use este link:

https://impression.appsflyer.com/ADD-APP-ID?pid=doubleclick_int&af_siteid=%24{UNIVERSAL_SITE_ID}
&af_ad_id=${CREATIVE_ID}&c=${PLACEMENT_ID}&af_c_id=${PLACEMENT_ID}

Guia Cost (Custo)

Os dados de custo não estão disponíveis para o GMP.

Guia Ad Revenue (Receita publicitária)

  • Você pode conectar várias contas do GMP ao mesmo aplicativo.
  • Se você tiver mais de uma conta GMP, repita o seguinte procedimento para cada conta. Atenção! Não há nenhum indício de que você conectou mais de uma conta na interface do usuário. 

Para ativar a API de receita de anúncios:

Guia Permissões

Nessa aba, você pode selecionar as permissões concedidas ao GMP.