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

Para:
Profissionais de marketing
Última atualização:

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.

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, em Configuração, vá para Marketplace de parceiros. 
  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.
  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 > Integrações ativas.
  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.

Postback de evento in-app

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

    1. Ative Postbacks de eventos in-app.
    2. Clique em Adicionar evento para adicionar um SDK ou evento de servidor para servidor à lista. A tabela a seguir descreve os campos a serem preenchidos:
      Nome do parâmetro Descrição
      Evento AppsFlyer

      O nome do evento, conforme recebido pela AppsFlyer do SDK integrado no aplicativo ou de eventos de servidor para servidor.
      Dica: não encontrou o evento que está procurando?

      • Certifique-se de ativar o evento em um dispositivo com uma instalação não orgânica e verifique novamente.
      • Digite-o em Evento AppsFlyer, depois clique em Criar personalizado. Leia mais sobre o mapeamento de eventos personalizados.
      mapeado para evento parceiro

      O nome exclusivo ou ID de cada evento, conforme definido pelo parceiro. As configurações de mapeamento possíveis são:

      • Campo de texto: obtenha o ID de evento correspondente do parceiro.
      • Caixa drop-down: selecione o evento AppsFlyer pré-definido mais adequado
      • Como está: envie os eventos como eles estiverem, sem mapeamento de nomes.

      Configure o evento usando os parâmetros do Floodlight no seguinte formato (veja a imagem abaixo da tabela):
      token=123XXX456XXX&type=XXXXXXXX&cat=XXXXX123456&src=58XXX35
      para usuários de

      Selecione a opção de envio para o evento:

      • Somente este parceiro: envie postbacks somente quando este evento for atribuído a este parceiro.
      • Todas as fontes de mídia, incluindo orgânicas: envie postbacks para eventos atribuídos a qualquer parceiro, bem como eventos orgânicos.
      incluindo
      • Nenhum dados (padrão): envia apenas o evento em si sem nenhum valor de evento.
      • Valores e receita: envia todos os parâmetros do evento, incluindo o valor da receita (se existir no evento).
      • Valores sem receita: envia todos os parâmetros excluindo o valor da receita.
    3. [Opcional] Clique na condição Adicionaradd_condition.png ícone para definir condições para um evento.
    4. Clique em Salvar integração.
Google_Marketing_Platform_in_app_event_postbacks_all_media_sources.JPG

 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.