Visão geral: como integrar a AppsFlyer com o Google Marketing Platform (GMP).

Google Marketing Platform
O Google Marketing Platform consiste em:
- Campaign Manager 360 (CM360) um sistema de gerenciamento e mensuração de anúncios para anunciantes e agências. Ele permite que os profissionais de marketing mobile planejem, executem e mensurem suas campanhas de exibição em sites e mobile.
- Display & Video 360 (DV360): é uma plataforma de demanda (DSP) do Google que oferece aos departamentos de compra e venda, às agências e aos anunciantes maior transparência e performancepara compras de mídias de exibição global em trocas de anúncios.
- Search Ads 360 (SA360) não está no escopo da integração da AppsFlyer.
Como funciona? —Floodlights
O Google Marketing Platform permite que você crie Floodlights, que são tags associadas a eventos de conversãoespecíficos. Floodlights são criados para eventos de instalação ou pós-instalação (como assinatura ou compra), a fim de integrar o GMP e a AppsFlyer para a mensuração de conversão. A integração do GMP se baseia em eventos mobile, dependendo dos IDs dos dispositivos. Ela não foi projetada para relatórios de conversões da web ou para inventário.
integração | Tipo de integração | Requisitos |
---|---|---|
DV360 | Integrar DV360 com a AppsFlyer |
|
CM360+ DV | Compra de tráfego DV360 através do CM360 |
|
CM360 + fonte de mídia terceira que não seja DV360 (1) |
Comprar tráfego de fontes de mídia de terceiros e medir conversões de aplicativos móveis originadas desse tráfego em CM360. |
|
(1) SRNs não estão incluídos nesse tipo de integração. (2) Esse cenário de integração requer tags CM360 padrão, conforme descrito aqui . Outros tipos de tags não são compatíveis. (3) De acordo com a política de não redirecionamento do Google, os links de terceiros, como o OneLink, não são suportados. Os links diretos requerem a implementação de métodos de plataforma correspondentes para iOS e Android. |
Dados enviados ao GMP
Com base nos requisitos de integração do GMP, a AppsFlyer envia apenas postbacks ao GMP sobre conversões e eventos in-app. Postbacks de clique e impressão não são enviados.
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:
- Na AppsFlyer, acesse Configuração > Parceiros integrados.
- Selecione Google Marketing Platform.
- Na aba de Integração, habilite Ativar parceiro.
- 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
- Na AppsFlyer, acesse Configuração > Parceiros integrados.
- 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:
- Ative a Atribuição de reengajamento.
Se você não tiver nenhuma campanha de reengajamento do GMP ativa, desative a atribuição de reengajamento. -
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):
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.
- Defina Postbacks de eventos in-app como ATIVADO
- 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 - Clique em Add Event (Adicionar Evento) para adicionar um evento do SDK à lista
- Selecione o Nome do evento de SDK
- 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
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
eaf_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= |
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 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 configurar a Receita de anúncios:
- Na AppsFlyer, acesse Configuração > Parceiros integrados.
- Selecione Google Marketing Platform.
- Na aba Receita publicitária, faça as seguintes configurações.
- Ative Obter dados de receita de anúncios.
- Selecione o evento in-app que será usado para registrar a receita de anúncios.
- Se você estiver usando o GMP para mediação e quiser mensurar a receita de anúncios das plataformas de monetização mediadas por meio da integração do GMP, selecione Incluir receita de mediação.
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.
- Clique em Google Marketing Platform.
A janela de login do Google será exibida. - Selecione a conta do GMP que você deseja associar ao aplicativo.
- Conclua este procedimento seguindo as instruções na interface do usuário.
Guia Permissões
Nessa aba, você pode selecionar as permissões concedidas ao GMP.
- Antes de configurar o gerenciamento de campanhas usando CM360 e um parceiro integrado da AppsFlyer, siga o Guia de Integração GMP e oGuia de Integração do parceiro antes de continuar com as instruções nesta seção.
- Se você estiver gerenciando uma campanha DV360 por meio do CM360, ignore as instruções nesta seção. Volte para a guia de integração e siga as instruções lá.
-
A AppsFlyer NÃO recomenda o uso do cenário de origem de mídia CM360+ para reportar o tráfego SRN, caso a integração de parceiros SRN relevante também esteja ativada. Isso é para evitar conflitos ao relatar conversões do mesmo parceiro por meio de duas integrações diferentes. Por exemplo, se a integração do SRN do Facebook estiver habilitada na AppsFlyer, mas o CM360 também for utilizado para relatar o tráfego do Facebook (facebook_int ) usando o método descrito paralelamente neste artigo, as conversões podem ser reportadas pelo Facebook e CM360, com CM360 capturando algumas das conversões que teriam sido reivindicadas pela principal integração com o Facebook.
Configuração de um link de atribuição para o GMP Campaign Manager
Para executar e medir campanhas no CM360, você precisa de um link de atribuição da AppsFlyer. Para que os dados sejam postados de volta ao GMP e conectados corretamente à AppsFlyer, esses dados precisam ser anexados no link AppsFlyer e não no link CM360.
-
Crie um link CM360.
Certifique-se de que você possui um placeholder para o ID do dispositivo, o parâmetro dc_rdid, porque a AppsFlyer só recebe declarações de conversão de aplicativos mobile da integração GMP com base na presença desse parâmetro. -
Crie um link de atribuição.
- O link de atribuição deve conter a fonte de mídia sobre a qual você pretende reportar, que deve ser uma fonte de mídia de terceiros, e não do GMP. Por exemplo, se a fonte de mídia de terceiros for Rocketfuel, use pid=rocketfuel_int e não pid=doubleclick_int.
- Para campanhas de retargeting, verifique se o seu link de rede contém is_retargeting=true. Saiba mais
Exemplo de link de atribuição:
https://app.appsflyer.com/com.example?pid=rocketfuel_int&c=campaign_name &advertising_id=13******-****-****-****-54**********
https://app.appsflyer.com/com.example?pid=rocketfuel_int&c=campaign_name &idfa=13******-****-****-****-54**********
- Anexe o link de atribuição AppsFlyer ao link CM360:
https://ad.doubleclick.net/ddm/trackclk/N736113.127733/B202683.204586115; dc_trk_aid=404426918;dc_trk_cid=92566356;dc_lat=;dc_rdid=13******-****-****-****-54********** ?https://app.appsflyer.com/com.example?pid=rocketfuel_int &c=campaign_name&advertising_id=13******-****-****-****-54**********
https://ad.doubleclick.net/ddm/trackclk/N736113.127733/B202683.204586115; dc_trk_aid=404426918;dc_trk_cid=92566356;dc_lat=;dc_rdid=13******-****-****-****-54********** ?https://app.appsflyer.com/com.example?pid=rocketfuel_int &c=campaign_name&idfa=13******-****-****-****-54**********
Uso do link de atribuição
Quando você tiver o link de atribuição, certifique-se de que ele é usado durante a execução de anúncios na fonte de mídia pretendida. Quando uma instalação ocorrer, a AppsFlyer atribui a instalação à fonte de mídia selecionada. Em seguida, a AppsFlyer informa CM360 sobre a instalação através do mecanismo de postback, usando os parâmetros do floodlight utilizados ao configurar a integração.
O resultado final é uma instalação atribuída à fonte de mídia e uma instalação registrada no DCM360.
Parâmetro de token CM360
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 GMP 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 Servidor para servidor, habilite registro de 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 CM360 (DCM360) gera valores para o novo token.
- Use esse token ao integrar a plataforma de marketing do Google com a AppsFlyer.
Limitações
De acordo com a política de não redirecionamento do Google, soluções de terceiros, como o OneLink, não podem ser usadas no cenário CM360 + fonte de mídia.
Siga o Guia de integração antes de continuar com as instruções nesta seção.
GMP bid manager (DV360)
O sistema funciona como uma SRN. Portanto, ele não faz uso de links de atribuição como o DCM360 faz. Para mensurar instalações e outras conversões, a AppsFlyer usa a API S2S do GMP.
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.
Para campanhas de configuração em DV360 a AppsFlyer recebe principalmente a ID de Posicionamento CM360 do Google.
Para encontrar a ID criativa de DV correspondente, faça um relatório personalizado do Google, que contém a ID de Posicionamento CM360 e a ID criativa de DV.
Métrica de conversões com o DV360
Para mensurar 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.
Parâmetro de token DV360
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 Recursos >> Floodlight para uma campanha
- Sob a aba Detalhes básicos, acesse Integrações >> Atribuição de aplicativo de terceiro e habilite registrar 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 tem compatibilidade com várias chamadas para o GMP 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 GMP.
Adicionar uma nova configuração de agência ao GMP do Google.
Para configurar o GMP 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.
- Para CM360 (DCM360): 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). Para que a agência o faça, o anunciante deve ativar o DV360 em sua própria conta . O anunciante deve ativar apenas a integração. Não é necessário que ele configure nenhum parâmetro do Floodlight.
Suporte para retargeting e reengajamento
Para habilitar o suporte para retargeting e reengajamento, o anunciante precisa habilitar o retargeting quando ativar o GMP em sua conta. O anunciante precisa apenas habilitar o redirecionamento. Não é necessário que ele configure nenhum parâmetro de floodlight.
Mapeamento de eventos in-app
As agências podem ter seu próprio mapeamento de eventos in-app com o GMP, mesmo que o cliente do anunciante também tenha o seu próprio mapeamento. Mais detalhes aqui.
Quantas agências podem trabalhar no GMP por aplicativo?
A AppsFlyer é compatível com 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 GMP.
Se você optar por executar campanhas separadamente da agência, leve em consideração o seguinte:
Parâmetros distintos do Floodlight
Os parâmetros de floodlight não devem ser compartilhados entre agências e anunciantes. Se o anunciante e a agência configurarem a integração com o GMP usando os mesmos parâmetros de floodlight, o anunciante não poderá visualizar nenhum dado em seu dashboard.
É crucial que cada um use diferentes parâmetros do Floodlight.
Motivos para discrepância
Veja o seguinte para aprender sobre discrepâncias e como minimizá-las.
Diferenças em modelos de atribuição
Causa | Descrição | Dica da AppsFlyer |
---|---|---|
Janela de atribuição de exibição |
A exibição na janela de atribuição do DV360/CM360 é de 14 dias. Já a janela padrão da AppsFlyer é de 1 dia. |
Defina a janela de exibição na AppsFlyer para corresponder à exibição definida na janela de definição do DV360/CM360. |
Parâmetros incorretos do Floodlight |
Trabalhar com parâmetros incorretos do Floodlight pode causar problemas na atribuição. |
Certifique-se de que os parâmetros do Floodlight estejam sempre corretos ao definir a integração com o DV360/CM360. |
Atribuição de origem multi-canal |
Na AppsFlyer, a última fonte de mídia da qual vem um clique é atribuída. Um clique pode vir do DV360/CM360, seguido de um clique de outra fonte de mídia. Nesses casos, o GMP auto-reporta uma instalação, mas, na AppsFlyer, a instalação vai para a outra fonte de mídia. |
Nesses casos, a preferência de atribuição da AppsFlyer é a que você deve seguir. |