Introdução
O propósito deste artigo é explicar como integrar a AppsFlyer com o Google Marketing Platform.
A Google Marketing Platform (DoubleClick) é composta do CM (DoubleClick Campaign Manager) e do DV360 (DoubleClick Bid Manager).
O que é o CM?
CM significa Campaign Manager. Este é um serviço de servidor de anúncios de terceiros do Google. Ele permite que os profissionais de marketing mobile planejem, executem e meçam suas campanhas de exibição por meio do DoubleClick. É onde anunciantes e agências fazem posicionamentos de anúncios, criam tags do Floodlight para impulsionar para o Google Tag Manager (GTM) e concluir tarefas de tráfego. Portanto, é necessário usar links de atribuição com CM (DCM).
O que é o DV360?
DV360 significa Display and Video 360. É uma plataforma de demanda (em inglês, demand-side-platform, DSP) do Google que fornece aos departamentos de compra e venda, às agências e aos anunciantes maior transparência e desempenho para compras de mídias de exibição global em trocas de anúncios.
Como ela funciona?
A Google Marketing Platform permite que você crie algo chamado Floodlights/Conversões. Floodlight é apenas outro nome para conversão. Você cria um Floodlight para instalações ou eventos pós-instalação (por exemplo, assinatura ou compra) a fim de integrar a Google Marketing Platform e a AppsFlyer para medir conversões.
Configuração do DoubleClick na AppsFlyer
Observação
As informações nesta seção são relevantes para as campanhas CM (DCM) e DV360 (DBM).
Recuperação de parâmetros do Floodlight
Antes de configurar o DoubleClick, é necessário criar um Floodlight de instalação (first_open) e recuperar seus parâmetros. Para obter mais informações, consulte aqui. Os parâmetros que devem se recuperados são:
- 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.
Esses parâmetros são necessários para a integração com a AppsFlyer.
Importante!
Um quarto parâmetro chamado token também é necessário. Um token é uma string alfanumérica específica do anunciante que deve ser passada junto com cada solicitação do servidor ao DoubleClick Digital Marketing (DDM). Para recuperar esse token, você precisa ativar a gravação de conversão in-app para dispositivos mobile de terceiros no nível do anunciante (configuração do Floodlight):
- Acesse a guia de configuração do Floodlight
- Na seção Server to server (Servidor para servidor), habilite In-app attribution tracking (Rastreamento da atribuição in-app)
- Clique em New Token para gerar um token e insira um nome (ou seja, App Install - AppsFlyer)
- Clique em Save (Salvar)
- O CM (DCM) gera valores para o novo token
Integração com o DoubleClick
Acesse o painel de seu aplicativo e clique em Integrated Partners (Parceiros integrados) no menu à esquerda.
Digite "DoubleClick" no campo de busca e clique no logo para abrir a janela de configurações do DoubleClick.
A janela de configuração do DoubleClick inclui três guias ativas: Integration (Integração), Ad Revenue (Receita publicitária) e Permissions (Permissões). Clique nos itens abaixo para ler sobre a configuração de guias.
Além da atribuição móvel baseada em cliques, o DoubleClick oferece atribuições de visualização e redirecionamento, que você pode gravar com a AppsFlyer.
Para obter uma descrição detalhada do Cabeçalho da janela de configuração de parceiros, clique aqui.
Guia Integração
Configuração dos parâmetros do Floodlight
Na guia de integração, configure os parâmetros de Floodlight em seus respectivos campos.
Campanhas de retargeting
Para medir a execução de campanhas de redirecionamento no DoubleClick:
- Alterne DoubleClick Retargeting (Retargeting do DoubleClick) para LIGADO.
Se você não tiver nenhuma campanha de retargeting do DoubleClick ativa, é recomendado DESLIGAR esse botão. -
Crie um novo Floodlight para campanhas de retargeting (por exemplo, app_opens). Depois, no painel da AppsFlyer, insira os parâmetros cat, src, token e type específicos das suas campanhas de retargeting.
Observação
O parâmetro token é o mesmo parâmetro de token recebido ao habilitar a conversão no aplicativo móvel de terceiros.
-
Defina o período após o reengajamento, onde 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 vitalício.
Observação
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.
Atribuição de cliques
Essa barra deslizante permite que você defina o tempo máximo do clique até a instalação. Somente as instalações (primeiras inicializações) que acontecerem dentro da janela de retrospectiva podem ser atribuídas ao DoubleClick.
A janela de lookback por clique padrão do DoubleClick é de 30 dias. Para minimizar as discrepâncias, recomendamos se ajustar ao período de tempo do DoubleClick.
Para obter mais detalhes sobre a janela de lookback clique aqui.
Atribuição por visualização
Essa barra deslizante permite que você defina o tempo máximo da impressão até a 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.
Alterne isso para LIGADO se desejar atribuir instalações de exibição do DoubleClick.
Você pode personalizar esse valor para 1 a 23 horas ou 1 a 7 dias.
A janela de lookback de exibição padrão é de 7 dias. Para minimizar as discrepâncias, recomendamos se ajustar ao período de tempo do DoubleClick.
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.
- Alterne os postbacks de evento in-app para LIGADO
- Selecione a Sending Option (Opção de envio) para todos os eventos definidos por SDK
- Only events attributed to this partner (Somente eventos atribuídos a este parceiro) para eventos provenientes somente de usuários atribuídos ao DoubleClick
- Events attributed to any partner or organic (Eventos atribuídos a qualquer parceiro ou orgânicos) para que toda a base de dados esteja disponível para relato ao DoubleClick - Clique em Add Event (Adicionar evento) para adicionar um evento do SDK à lista
- Selecione o SDK Event Name (Nome do evento de SDK)
- Em Partner Event Identifier (Identificador do evento de parceiro), configure o evento usando os parâmetros do Floodlight:
O formato deve ser definido como abaixo:
token=123XXX456XXX&type=XXXXXXXX&cat=XXXXX123456&src=58XXX35
Observação
- 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 DoubleClick:
Order_IDeaf_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 este mapeamento ao configurar parâmetros personalizados do Floodlight no DoubleClick.
- 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.
Como eles são pré-mapeados, nenhum parâmetro U personalizado adicional pode ser configurado.
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= |
CIDADE |
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= |
moeda |
EUR |
*Nesses casos, a AppsFlyer não recebe o nome como resposta da Google Marketing Platform (confira a observação importante abaixo) para preencher o campo com a ID correspondente (por exemplo, o nome do conjunto de anúncios se torna a ID do conjunto de anúncios).
Importante!
Quando a AppsFlyer consulta a Google Marketing Platform, a Google Marketing Platform retorna apenas quatro parâmetros na resposta. Confira os parâmetros abaixo e como eles são mapeados para os parâmetros da AppsFlyer que aparecem no painel e nos relatórios de dados brutos.
- Site ID = (site_id)
- Placement ID = (af_c_id)
- Ad ID = (af_adset_id)
- Creative ID = (af_ad_id)
Guia link de atribuição
a guia do link de atribuição não é funcional para DoubleClick, porque é uma SRN e, portanto, não usa links de atribuição externa para atribuição.
No entanto, os links de atribuição desempenham um papel na integração com o DoubleClick:
Links de atribuição para CM (DCM)
Para executar campanhas em CM (DCM), são necessários links de atribuição. Consulte a definição dos links de atribuição para CM.
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ê quiser ser capaz de medir o número de cliques de DVM360 na AppsFlyer, você deve adicionar um URL de atribuição da AppsFlyer no seu painel DVM360. Ao fazer isso, certifique-se de que o nome da campanha no URL de atribuição seja idêntico ao nome da campanha no DoubleClick para que a AppsFlyer possa recuperar e anexar os dados de cliques nas campanhas corretas.
Importante!
O uso de links de atribuição para o DoubleClick 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=${CAMPAIGN_ID}&af_c_id=${CAMPAIGN_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=${CAMPAIGN_ID}&af_c_id=${CAMPAIGN_ID}Guia Cost (Custo)
Os dados de custo não estão disponíveis para o DoubleClick.
Guia Ad Revenue (Receita publicitária)
Siga as instruções abaixo para configurar a Receita publicitária:
- Na janela de integração do DoubleClick, acesse a guia Ad Revenue (Receita publicitária).
- Selecione o evento in-app que será usado para a gravação de receita de anúncios
- Se você estiver usando o DoubleClick para mediação e quiser medir a receita de anúncios das plataformas de monetização mediadas por meio da integração do DoubleClick, selecione Include Mediation Revenue (Incluir receita de mediação).
Importante!
Se você relatar todas as receitas por meio da plataforma de mediação do DFP, não integre a gravação de outra receita de anúncios de redes mediadas também na tela Integrated Partners (Parceiros integrados). Isso provocará a duplicação de relatórios de receita.
- Faça login com o Google para autenticar a Integração da receita publicitária.
Guia Permissões
Nessa aba, selecione as permissões a serem concedidas ao DoubleClick. Observe que mesmo se a atribuição estiver desativada para o DoubleClick, a aba de permissões estará ativa e você pode conceder controle ao DoubleClick.
Permissões da rede de anúncios
Use essas chaves seletoras a fim de conceder permissões à rede de anúncios para gerenciar sua própria configuração do aplicativo:
- Permitir a configuração da integração – permite que o parceiro configure a aba de integração (exceto postbacks de evento in-app)
- Permitir a configuração de postbacks de evento in-app – permite que o parceiro configure o mapeamento de postbacks de evento in-app para si mesmo na guia de integração
- Permitir o acesso ao relatório de retenção – somente aos próprios dados de retenção do parceiro
- Permitir acesso aos dados agregados de usuários fiéis - apenas aos dados de usuários fieis do próprio parceiro
- Permitir acesso aos dados agregados de eventos in-app - apenas aos dados de eventos in-app do próprio parceiro
- Permitir acesso aos dados agregados de receita - apenas aos dados da receita atribuídos ao parceiro
- Permitir o acesso ao painel Protect360 – somente aos próprios dados do Protect360 do parceiro e desde que o recurso esteja ativado para o anunciante
Saiba mais sobre a concessão de permissões da rede de anúncios.
Importante!
Siga o Guia de integração antes de continuar com as instruções nesta seção.
Se você estiver gerenciando uma campanha DV360 por meio do CM, ignore as instruções nesta seção. Volte para a guia de integração e siga as instruções lá.
Configurar um link de atribuição para o DoubleClick Campaign Manager
Para executar e medir campanhas no CM, você precisa de um link de atribuição da AppsFlyer.
- Primeiro, crie um link de atribuição. O link de atribuição deve conter a fonte de mídia real usada, e não DoubleClick. Por exemplo, se você estiver executando por meio de Rocketfuel, use pid=rocketfuel_int e não pid=doubleclick_int.
o link de atribuição deve ser algo parecido com o seguinte:
https://app.appsflyer.com/com.example?pid=rocketfuel_int&c=campaign_name - Depois, acrescente o link de atribuição da AppsFlyer ao URL de rastreamento de DoubleClick:
https://ad.doubleclick.net/ddm/trackclk/N736113.127733/B202683.204586115; dc_trk_aid=404426918;dc_trk_cid=92566356;dc_lat=;dc_rdid=? https://app.appsflyer.com/com.example?pid=rocketfuel_int&c=campaign_name
Observações
- Certifique-se de ter um placeholder para a ID do dispositivo — o parâmetro
dc_rdid. - Para campanhas de retargeting, verifique se o seu link de rede contém
&is_retargeting=true. Para obter mais detalhes, clique aqui.
Uso do link de atribuição
Depois de ter o link de atribuição, dê à fonte de mídia. Quando ocorrer uma instalação, a AppsFlyer atribuirá a instalação à fonte de mídia. A AppsFlyer então permite que o DCM saiba sobre a instalação usando os parâmetros do Floodlight usados ao configurar a integração.
O resultado final é uma instalação atribuída à fonte de mídia e uma instalação registrada no DCM.
Importante!
Siga o Guia de integração antes de continuar com as instruções nesta seção.
DoubleClick Bid Manager (DV360)
O sistema funciona como uma SRN. Portanto, ele não faz uso de links de atribuição como o DCM faz. Para medir instalações e outras conversões, a AppsFlyer usa a API do DoubleClick S2S.
No entanto, você pode usar os links de atribuição da AppsFlyer em campanhas DV360 (DBM) para medir cliques e impressões. Consulte o uso de links de atribuição com o DV360.
Métrica de conversões com o DV360
Para medir conversões com o DV360, você precisa criar Floodlights para cada tipo de conversão:
- não relacionada
- Redirecionamento
- Eventos in-app
Ao configurar Floodlights, o DV360 fornece os parâmetros necessários para a integração com a AppsFlyer.
Importante!
Há um quarto parâmetro, chamado token, que também é necessário. Para recuperar esse parâmetro, você deve habilitar a gravação de conversão no aplicativo móvel de terceiros no nível do anunciante (configuração do Floodlight):
- Acesse Resources >> Floodlight para uma campanha
- Na guia Basic Details (Detalhes básicos), navegue até a seção Integrations (Integrações) >> Third-Party App Attribution (Atribuição de aplicativos de terceiros) e habilite a gravação de atribuição in-app
- Clique em New Token para gerar um token e insira um nome
- Clique em Save (Salvar)
O Bid Manager gera valores para os novos tokens.
Configuração da agência
Como parte da integração avançada da AppsFlyer com o Google, a AppsFlyer oferece suporte a várias chamadas para o DoubleClick do Google. Isso permite que as agências promovam o mesmo aplicativo em nome de um anunciante usando seus próprios parâmetros de integração do DoubleClick.
Adição de uma nova configuração de agência no DoubleClick do Google
Para configurar o DoubleClick pela conta da agência, faça login no aplicativo do cliente usando a conta da agência e siga o guia de configuração.
Importante!
Para CM (DCM): para que a AppsFlyer atribua uma instalação a uma agência, a AppsFlyer deve saber o nome da agência. O nome da agência deve ser passado para a AppsFlyer com o parâmetro af_prt encontrado no link de atribuição ou por meio do referenciador como parte do URL.
Para DV360 (DBM): a agência deve configurar seus próprios Floodlights (src, cat, type, token).
Mapeamento de eventos in-app
As agências podem ter seu próprio mapeamento de eventos in-app com o DoubleClick, mesmo que o cliente do anunciante também tenha o seu próprio mapeamento. Mais detalhes aqui.
Quantas agências podem trabalhar no DoubleClick por aplicativo?
A AppsFlyer oferece suporte para até dez configurações diferentes por aplicativo, incluindo a configuração do anunciante (ou seja, a configuração do anunciante e nove configurações adicionais da agência).
Assim que o número máximo de configurações for atingido, será necessário excluir uma configuração existente antes de adicionar uma nova configuração.
Configuração da agência versus configuração do anunciante
Agências e anunciantes podem promover os mesmos aplicativos usando o DoubleClick.
Se você optar por executar campanhas separadamente da agência, leve em consideração o seguinte:
Parâmetros distintos do Floodlight
Os parâmetros do Floodlight não devem ser compartilhados entre agências e anunciantes. Se o anunciante e a agência configurarem a integração com o DoubleClick usando os mesmos parâmetros do Floodlight, o anunciante não poderá visualizar nenhum dado em seu painel.
É crucial que cada um use diferentes parâmetros do Floodlight.
Motivos para discrepância
Confira abaixo alguns problemas que podem mostrar discrepâncias entre o DoubleClick e a AppsFlyer.
Autorrelatório do DoubleClick
O DoubleClick autorrelata enquanto a AppsFlyer vincula eventos in-app à fonte de atribuição na AppsFlyer, que nem sempre pode ser o DoubleClick.
Como resultado, alguns eventos de conversão são descartados do sistema do DoubleClick como atividade inválida/spam após a publicação de suas respostas de atribuição na AppsFlyer. Nesses casos, a AppsFlyer pode relatar esses eventos, mas o DoubleClick não.
Se você vir um grande número de conversões relatadas na AppsFlyer e que estão ausentes no DoubleClick, recomendamos executar um relatório do DoubleClick sobre atividades inválidas para saber se há um problema com o seu inventário.
Janela de atribuição de exibição
A janela de atribuição de exibição do DoubleClick é de 14 dias, enquanto a janela padrão da AppsFlyer é de 1 dia. Para minimizar o risco de discrepâncias, configure a janela de exibição na AppsFlyer para se ajustar à exibição configurada na janela de configuração do DoubleClick.