Saiba como configurar e usar a nova integração de atribuição da Google Marketing Platform, que permite que a Singular rastreie atribuições para o Campaign Manager 360 (CM360) e Display & Video 360 (DV360).
Se estiver a utilizar a integração mais antiga (legada) com o GMP, consulte o guiaAttribution-Integration" GMP (DoubleClick) Legacy Integration.
Sobre a integração da GMP
A Google Marketing Platform (GMP) é um conjunto de ferramentas de marketing para profissionais de marketing de sites e aplicações, que inclui, entre outros produtos:
- Campaign Manager 360 (anteriormente Double Click Campaign Manager) - um servidor de anúncios e uma plataforma de gestão de anúncios que permite aos anunciantes gerir as suas campanhas de anúncios digitais em sítios Web e dispositivos móveis. Facilita a apresentação de anúncios e o tráfico de criativos para várias plataformas, incluindo plataformas do lado da procura (DSP) e editores onde o inventário de anúncios pode ser adquirido.
- Display & Video 360 (anteriormente DoubleClick Bid Manager) - uma plataforma do lado da procura (DSP) para a compra programática de anúncios que utiliza licitações em tempo real para comprar inventário de anúncios em ecrã, vídeo, etc.
Quer utilize o Campaign Manager 360 e o Display & Video 360 em conjunto, ou com produtos de terceiros, a atribuição da Singular para a campanha relevante baseia-se na comunicação de actividades de floodlight através da integração de atribuição GMP. As atividades de floodlight são eventos relacionados à conversão, como instalações de aplicativos, sessões e eventos de usuário in-app.
Depois de configurar a integração, a Singular envia instalações e eventos do aplicativo para as atividades de floodlight do GMP. Dessa forma, o Singular pode medir instalações e reengajamentos (tanto por meio de cliques quanto por meio de visualizações) atribuídos ao Campaign Manager 360 ou ao Display & Video 360.
Se você estiver usando esses dois produtos do Google e quiser que o Singular relate os custos de publicidade e mostre o ROAS da campanha, será necessário adicionar o conetor de dados do Campaign Manager 360 E o conetor de dados do Display & Video 360.
Resumo da integração
(Consulte o Glossário de integrações de parceiros)
| Partner | Google Marketing Platform (GMP) |
| Partner Type | Self-attributing Ad Network |
| Creatives | Supported (DCM creative ID) |
| Publisher | Supported (DCM site ID) |
| View-Through | Supported |
| Re-engagement | Supported |
| S2S | N/A |
| Click Tag | No (Self-attributing) |
| Receiving All Installs | Recommended (Self-attributing) |
| Receiving All Events | Recommended (Self-attributing) |
Etapas de configuração
| 1 |
Integrar o Singular SDK/S2S em seu aplicativoConsulte nossa documentação do SDK e do S2S para obter ajuda. |
| 2 |
Gerar IDs de link para o seu aplicativoNa Google Marketing Platform, gere uma ID de link para seu aplicativo:
Não gere uma ID de link no Display & Video 360 se você tiver o Campaign Manager! |
| 3 |
Configurar a Google Marketing Platform como um parceiro no Singular
|
| 4 |
[Opcional] Configurar postbacksde eventoPor padrão, o Singular relata todas as instalações e sessões para a Google Marketing Platform para permitir a atribuição de instalação e reengajamento. No entanto, você pode optar por enviar eventos in-app opcionalmente para dar suporte à otimização e aos relatórios no Google. Se você optar por enviar postbacks de eventos para o Google, deverá mapeá-los para um dos tipos de evento de aplicativo do Google compatíveis no menu suspenso: Observe que a Google Marketing Platform pode suportar até 10 eventos personalizados por meio de "custom" e "custom_[0-9]". |
| 5 |
Executar relatórios no Display & Video 360 e/ou no Campaign ManagerNos relatórios Singular, as instalações e outros eventos atribuídos ao Display & Video 360 são relatados com Source = Google Marketing Platform (DV360). |
Mapeamento de dados
As tabelas a seguir refletem os dados que o rastreador Singular obtém do GMP. A disponibilidade de determinados campos depende do facto de estar a utilizar apenas o DV360, apenas o CM360 ou ambos os produtos Google.
Ao usar o DV360 e um servidor de anúncios de terceiros
| Nome da dimensão nos relatórios Singular | Parâmetro do link de rastreamento | Nome do campo no GMP |
| Tracker Source Name | an | Google Marketing Platform (DV360) |
| Campaign ID | pcid | ad_events.insertion_order_id |
| Sub Campaign Name | pscn | ad_events.line_item_name |
| Sub Campaign ID | pscid | ad_events.line_item_id |
| Creative Name | pcrn | ad_events.creative |
| Creative ID | pcrid | ad_events.creative_id |
| Account ID | paccountid | ad_events.external_customer_id |
| Partner Sub AdNetwork | pnetworkn | DV360 |
Ao usar o CM360 e um DSP de terceiros
| Nome da dimensão em relatórios únicos | Parâmetro de link de rastreamento | Nome do campo no GMP |
| Tracker Source Name | an | Google Marketing Platform (CM360) |
| Sub Campaign Name | pscn | ad_events.placement_name |
| Sub Campaign ID | pscid | ad_events.placement_id |
| Creative ID | pcrid | ad_events.creative_id |
| Publisher Site ID | psid | ad_events.site_id |
| Account ID | paccountid | ad_events.external_customer_id |
| Partner Sub AdNetwork | pnetworkn | CM360 |
Ao usar o DV360 e o CM360
| Nome da dimensão em relatórios individuais | Parâmetro de ligação de rastreamento | Nome do campo no GMP |
| Tracker Source Name | an | Google Marketing Platform (DV360) |
| Campaign ID | pcid | ad_events[DBM].insertion_order_id |
| Sub Campaign Name | pscn | ad_events[DBM].line_item_name |
| Sub Campaign ID | pscid | ad_events[DBM].line_item_id |
| Creative ID | pcrid | ad_events[DBM].creative_id |
| Publisher Site ID | psid | ad_events[DCM].site_id |
| Account ID | paccountid | ad_events[DBM].external_customer_id |
Apêndice: Geração de um ID de link no Google
Você só precisa de uma ID de link por aplicativo:
- Se estiver usando o Campaign Manager e o Display & Video 360, gere a ID do link no Campaign Manager
- Se estiver usando apenas o Display & Video 360, gere sua ID de link no Display & Video 360.
Geração de uma ID de link no Campaign Manager
| 1 | No Campaign Manager, vá para Anunciante > Floodlight > Configuração de Floodlight. |
| 2 | Clique em Link app analytics developer e selecione o aplicativo que você está configurando. |
| 3 | Selecione Singular e guarde. |
| 4 | Selecione o aplicativo que você deseja medir e copie o ID de link. |
Gerando um ID de link em Display & Video 360
| 1 |
Em Display e Vídeo 360, aceda a Anunciante > Recursos > Floodlight > Detalhes básicos > Análise de aplicações de terceiros > Editar. |
| 2 |
Selecione Criar novo link. |
| 3 | Selecione se a sua aplicação é iOS ou Android e, em seguida, selecione a aplicação. Selecione Singular como o parceiro de análise de aplicativos de terceiros e clique em Adicionar. Na janela seguinte, clique em Concluído. Clique em Enviar na parte inferior da página do Floodlight. |
| 4 |
Copie o ID do link para o aplicativo desejado. Consulte a documentação do Google Display & Video 360 para obter mais informações. |
Perguntas frequentes e solução de problemas
Em geral, "first_open" é o evento padrão. A Singular usa-o para relatar apenas as primeiras sessões de cada dispositivo ao GMP. Em seguida, o GMP determina se essas primeiras sessões serão reivindicadas como suas para fins de atribuição de instalação.
O evento "session_start" é configurado manualmente, que pode ser mapeado para qualquer evento no Singular, como "__SESSION__".
Neste exemplo, esse evento rastreia todas as sessões relatadas e as envia para a Google Marketing Platform em "session_start".
Tanto para o CM360 como para o DV360, não recebemos dados de Campaign Name da integração de atribuição. Isto significa que, para preencher corretamente o nome da campanha, utilizamos dados da rede. No entanto, quando as campanhas começam, isso pode levar um ou dois dias para ocorrer.
Poderá haver discrepâncias de dados pelos seguintes motivos:
- O GMP auto-atribui substancialmente mais pontos de contacto baseados em impressões do que em cliques. Portanto, outros parceiros podem receber a instalação se geraram algum clique em qualquer momento dentro das janelas de atribuição relevantes. Veja como a Singular prioriza os pontos de contato.
- As impressões reivindicadas pelo GMP podem estar fora da janela de visualização padrão de 24 horas do Singular, fazendo com que seus números de instalação relatados sejam maiores. Como resultado, sua contagem de eventos também será maior. Entenda as janelas de lookback de atribuição.
- Usamos a atribuição de último toque com o GMP. Se existirem outros parceiros com pontos de contacto mais próximos, eles ganharão a atribuição, mesmo que o GMP a reivindique como sua, à semelhança de outras SANs.
- A GMP pode ter reivindicado determinados utilizadores no passado, enquanto a Singular os atribuiu a outros parceiros ou à Organic. Nesses casos, a GMP continuará a contar os seus eventos como seus. Na Singular, esses utilizadores continuarão a ser monitorizados pelos parceiros que lhes foram atribuídos originalmente, a menos que tenha ocorrido uma atribuição de reengajamento.
Políticas de dados do parceiro
Tratamento do consentimento do utilizador do EEE
A partir de março de 2024, a Google Marketing Platform exige que os anunciantes passem sinais de consentimento para os utilizadores do EEE, como parte das suas actualizações para apoiar o regulamento da Digital Markets Act da UE. Os utilizadores do EEE que optarem por não receber estes sinais de consentimento do utilizador não serão atribuíveis nem os seus dados serão utilizados no Google para fins publicitários.
A Singular fornece as seguintes opções para ajudar os anunciantes a cumprirem o regulamento:
- Se a sua empresa determinar que os regulamentos de privacidade da UE para utilizadores do EEE se aplicam à sua aplicação, transmita sinais de consentimento do utilizador à Singular com base nos avisos de consentimento que a sua aplicação apresenta a estes utilizadores. Consulte"Como posso passar sinais de consentimento do usuário para a Singular?"
- Se a sua empresa determinar que os regulamentos de privacidade da UE não se aplicam ao seu aplicativo, você pode optar por não receber sinais de consentimento do usuário do EEE no Singular. marque a opção "Opt-out do EEE" na seção "Privacidade do usuário" na configuração do parceiro. Consulte"Como faço para desativar os requisitos de dados do EEE?"
FAQ sobre o tratamento do consentimento do utilizador do EEE
Quando e como recolher sinais de consentimento do utilizador para utilizadores do EEE deve respeitar os requisitos da sua empresa e das suas aplicações em matéria de privacidade do utilizador. Consulte o consultor jurídico da sua empresa para compreender como a sua aplicação tem de cumprir as políticas de privacidade internas e os regulamentos de privacidade, como o RGPD, a Diretiva Privacidade Eletrónica e a Lei dos Mercados Digitais.
Se decidir recolher sinais de consentimento do utilizador, é geralmente recomendado que:
- Os sinais de consentimento do utilizador sejam definidos apenas quando o utilizador tiver optado explicitamente por aceitar ou recusar. Recomenda-se que os LDS não sejam definidos se o utilizador não tiver feito uma escolha. A ausência de um sinal do utilizador pode ser importante.
- Os sinais de consentimento do utilizador são normalmente recolhidos em "Opções de privacidade" ou "Definições de privacidade" durante a experiência da aplicação.
- Quando possível, e dependendo do design e da estratégia do prompt de consentimento do seu aplicativo, exiba os prompts de privacidade no início dos fluxos do aplicativo para garantir que o Singular e outros SDKs possam coletar o sinal de consentimento do usuário o mais cedo possível
- Usando o SDK iOS da Singular:
Método limitDataSharing Descrição Notifica a Singular sobre o consentimento do usuário (opt-in) para compartilhar dados privados.
- Use limitDataSharing:NO para indicar que o usuário consentiu (opted in) em compartilhar suas informações.
- Utilize limitDataSharing:YES se o utilizador não tiver dado o seu consentimento.
Assinatura (void)limitDataSharing:(BOOL)shouldLimitDataSharing; Exemplo de utilização // User has opted into sharing data Singular.limitDataSharing(false)// User has opted into sharing data [Singular limitDataSharing:NO]; - Utilizando o Singular Android SDK:
Método Singular.limitDataSharing Assinatura Singular.limitDataSharing(booleanshouldLimitDataSharing)
- Use Singular.limitDataSharing(false) para indicar que o usuário consentiu (opted in) em compartilhar suas informações.
- Utilizar Singular.limitDataSharing(true) se o utilizador não tiver dado o seu consentimento
Descrição Notifica a Singular do consentimento do utilizador (opt-in) para a partilha de dados privados. Exemplo de uso // User has opted into sharing data Singular.limitDataSharing(false);
- Consulte os artigos da documentação técnica da API do iOS, Android e Server-to-Server sobre "Limitar compartilhamento de dados"
- Recomenda-se que o LDS seja definido antes da inicialização do SDK da Singular, permitindo assim que o Google capture os sinais de consentimento do utilizador no momento da instalação da aplicação para maximizar a medição e os conhecimentos de publicidade
- O Singular LDS será mapeado para os sinais de consentimento do utilizador "ad_user_data" e "npa" da Google Marketing Platform para utilizadores do EEE, conforme abaixo:
- LDS=true mapeia para ad_user_data=0 e npa=1
- LDS=falso mapeia para ad_user_data=1 e npa=0
- LDS não definido mapeia para ad_user_data/npa não definido
- (Em breve, após março de 2024) O Singular SDK/S2S suportará um modo opcional para ingerir automaticamente sinais de consentimento do utilizador de plataformas de gestão de consentimento (CMP) certificadas. Até lá, pode extrair os sinais de consentimento do utilizador da sua CMP e passá-los através do LDS
- A implementação do LDS para utilizadores do EEE não é necessária se esta opção for utilizada
- Esta opção pode ser activada antes da entrada em vigor das actualizações de março da Google
O Limite de compartilhamento de dados (LDS) da Singular é um recurso que permite que os desenvolvedores de aplicativos passem os sinais de consentimento do usuário de cada usuário para a Singular. O LDS é definido por usuário e pode ser definido antes ou depois da inicialização do SDK. O LDS é usado em Postbacks de privacidade do usuário Singular e passado para determinados parceiros, como o Google, que o usam para cumprir suas próprias práticas de dados.
Consulte"Suporte às opções de privacidade do utilizador com a FAQ Limitar partilha de dados"
A Google lista as plataformas de gestão de consentimento (CMP) que suportam os sinais de consentimento do utilizador necessários. Se utilizar uma destas CMPs, pode extrair os sinais de consentimento do utilizador e passá-los através da funcionalidade LimitDataSharing do Singular.
(Em breve) O Singular SDK/S2S suportará um modo opcional para ingerir automaticamente sinais de consentimento do utilizador a partir destas CMP certificadas (através da norma TCF 2.2).
A partir de março de 2024
Para os utilizadores do EEE que optam por recusar o consentimento do utilizador:
- A atribuição ao nível do utilizador às campanhas da Google Marketing Platform não estará disponível no Singular. O Google não poderá relatar essas atribuições aos MMPs
- A Google Marketing Platform não poderá utilizar os dados destes utilizadores para fins publicitários
Para utilizadores do EEE que optem pelo consentimento do utilizador:
- É possível a atribuição ao nível do utilizador às campanhas da Google Marketing Platform
- A Google Marketing Platform utilizará estes dados para fins publicitários
Recomendamos aos anunciantes que contactem o seu representante da Google para obterem informações mais detalhadas sobre as suas campanhas e configurações específicas.