Resumo da integração
(Consulte o Glossário de integrações de parceiros)
|
|
Introdução ao Google Ads
As campanhas do Google App (FKA Universal App campaigns) ajudam-no a promover a sua aplicação móvel nas várias redes do Google.
Ao adicionar uma configuração de parceiro para o Google Ads, pode permitir que a Singular acompanhe o desempenho das suas campanhas na Pesquisa Google, no YouTube e em mais de três milhões de sites e aplicações.
Nota: É possível monitorizar campanhas de cliques e de visualizações. As atribuições de visualização do Google Ads são baseadas na definição de visibilidade do MRC e estão disponíveis apenas para as redes do YouTube e de Display.
| Rede | Descrição |
| Pesquisa Google |
Anúncios de texto na Pesquisa Google, na aplicação Pesquisa Google e no Google Play. Nota: as campanhas de pesquisa do iOS para Instalações não são atribuídas pelo Google Ads e, por isso, não são apresentadas nos relatórios ao nível do utilizador. Isto também afecta as Instalações do Default Tracker nos relatórios agregados. |
| Apresentação do Google | Anúncios de imagem em aplicações móveis e navegadores que podem ser ligados ao Web site móvel, à aplicação móvel ou à loja de aplicações. |
| Anúncios do Google para vídeo (Youtube) | Anúncios de vídeo ou de texto que aparecem nas aplicações Google YouTube para iOS ou Android. |
| Tipo de campanha | Descrição | Acompanhamento individual |
| Campanhas de aplicações | As Campanhas de aplicações são um balcão único para promover a sua aplicação móvel em todas as redes disponíveis. Estes anúncios são gerados automaticamente com base no texto criativo introduzido. Disponível para aplicações iOS e Android. | Instalações |
| Campanhas de aplicativos para engajamento | As Campanhas de App para Envolvimento ajudam os utilizadores actuais da sua aplicação a realizar acções in-app específicas para melhorar a retenção de utilizadores e as receitas a longo prazo. | Reengajamentos |
A Singular rastreia campanhas do Google Ads através de uma integração servidor-a-servidor de auto-atribuição com a API de Conversão de Aplicativos do Google Ads, que inclui:
- Rastreamento de todas as instalações e reengajamentos impulsionados por qualquer uma das suas campanhas do Google Ads
- Atribuição de cliques e visualizações
A integração usa um ID de link, que é gerado no Google Ads e exclusivo para cada aplicativo. Uma vez que seu Link ID tenha sido configurado no Singular, o Singular começará a enviar todas as instalações, sessões e eventos de conversão in-app configurados para o Google.
Usando as informações de clique atribuídas retornadas pelo Google, a Singular pode realizar a atribuição de último toque (Veja o processo de atribuição da Singular) e oferecer relatórios sobre o desempenho de suas campanhas usando as mesmas informações granulares de campanha que você recebe no painel do Google Ads.
Para começar a acompanhar as conversões e os eventos relacionados com as campanhas do Google Ads, primeiro tem de aceder à sua conta do Google Ads para configurar as suas acções de conversão - também conhecidas como eventos de importação.
Consulte Integração de atribuição do Google Ads: Como importar eventos para obter instruções detalhadas.
Nota: Os eventos são exibidos no Google Ads após a ocorrência de pelo menos um evento de conversão desde a definição da configuração no Singular (não apenas eventos atribuídos ao Google Ads).
Para aplicações activas com milhares de utilizadores activos, isto acontece normalmente em poucos minutos, mas se estiver a testar uma nova aplicação sem quaisquer utilizadores activos, terá de ser você a ativar os eventos. Em seguida, certifique-se de que a conversão está activada - isto poderá ter de ser feito através da conta MCC se estiver a utilizar conversões entre contas.
Em seguida, pode configurar e iniciar as suas campanhas do Google Ads. Siga as instruções da Google para saber mais sobre as suas opções e como as configurar.
Como definir sua configuração de parceiro
Pré-requisitos: Integre o SDK do Singular (consulte as instruções). Se o seu aplicativo for compatível com links diretos, certifique-se de implementar o suporte a links diretos no iOS e no Android.
- Na sua conta do Google Ads, gere um ID de link.Importante: Para garantir uma integração bem-sucedida e o acompanhamento das instalações com o Google Ads, é obrigatório concluir o processo de importação do evento first_open na sua conta do Google Ads. A não conclusão dessas etapas resultará em uma integração incompleta entre o Google Ads e a Singular, e as instalações não serão rastreadas.Se você tiver várias contas do Google Ad anunciando para o aplicativo, certifique-se de ativar o "acompanhamento de conversões entre contas" ou compartilhar IDs de link com outra conta do Google Ads. Consulte "Como partilhar um link com outras contas do Google Ads" neste tutorial em vídeo ou siga as instruções da Google.
Ao atualizar para um ID de ligação ativado para o acompanhamento de conversões entre contas, certifique-se de que repete o processo de importação de eventos (consulte o Passo 9 abaixo). - Vá para Singular > Atribuição > Configuração de parceiros.
- Clique em "Adicionar um parceiro", digite e escolha Adwords (Google Ads).
- Na caixa de diálogo, escolha o aplicativo e o site do aplicativo (plataforma) para configurar.
- Em ID do link do Adwords, cole o ID que gerou.
- Especifique as definições de atribuição:
- Atribuição de visualização - dar maior prioridade às visualizações de anúncios
- Reengajamento - utilizar janelas de inatividade. Isto é obrigatório
- Janela de lookback de atribuição de cliques - especifique durante quanto tempo um anúncio pode ser creditado com uma instalação.
- Observação: alterar as configurações padrão pode causar discrepâncias entre os números de instalação que você vê nos painéis do Singular e do Adwords.
- Enviar postbacks de evento: Para melhorar a otimização da campanha, permita que o Singular envie postbacks do Google Ads sobre eventos in-app. Mapeie seus eventos para o evento equivalente do Google ou deixe o evento como "personalizado".
- Clique em Salvar.
-
(Importante) Importar eventos: configure suas ações de conversão na sua conta do Google Ads. Consulte Como importar eventos.
- Não verá os eventos do Singular imediatamente. Os eventos aparecem no Google Ads apenas depois de ocorrer pelo menos um evento de conversão após a definição da configuração no Singular.
Perguntas frequentes gerais
Uma vez que uma atribuição é rastreada, suas campanhas do Google Ads aparecerão na sua interface de relatórios do Singular.
A Singular suporta relatórios de atribuição de dados de campanhas de aplicativos do Google Ads para instalações e reengajamentos de cliques e visualizações. Atualmente, os dados disponíveis incluem o ID da campanha do Google, o nome da campanha e o ID do grupo de anúncios, juntamente com o canal do Google (Youtube, Display, Pesquisa). Estes dados são mapeados para o Singular como "Campaign ID", "Campaign Name", "Sub Campaign ID" e "Sub Ad Network", respetivamente.
Observe que "conversões" no Google Ads se referem a instalações e reengajamentos no Singular.
Além disso, existem discrepâncias inerentes entre o Google Ads e todos os terceiros, conforme descrito na documentação do Google Ads.
Verifique se a implementação do SDK do Singular inclui suporte para links diretos e links diretos adiados.
Uma vez implementada, a sua integração Singular com o Google ativa automaticamente o deferred deep linking para as campanhas do Google que utilizam feeds.
As conversões de aplicativos relatadas pelo Google Ads podem conter uma combinação de fontes determinísticas e modeladas. Consulte a documentação do Google para compreender como as conversões modeladas podem afetar as suas campanhas.
Uma vez que as conversões modeladas não estão associadas a uma única interação de anúncio específica, a Google não pode fornecer uma resposta determinística correspondente à Singular ou a qualquer um dos Parceiros de atribuição de aplicações da Google. Isso pode causar discrepâncias de conversão relatadas no Google e nos 3Ps.
A atividade da aplicação do utilizador com opt-out é comunicada à Google com os IDs de publicidade eliminados, pelo que a Google não recebe quaisquer informações de identificação individual.
Quando a Google apresenta um anúncio, também anexa "IDs" quando a marcação automática está activada:
- Gbraid (iOS): Um identificador anexado aos cliques no iOS 14.5+
- Gclid (Android, iOS): Um ID de clique do Google
Nos casos em que esses anúncios são ativados por deep link, as IDs são capturadas pela integração Singular SDK/S2S quando o usuário faz o deep link no aplicativo. O Singular encaminha quaisquer IDs disponíveis para o Google, que são auto-atribuídos e relatados no Singular como reengajamentos. No caso do "gbraid", estas atribuições de reativação têm uma granularidade reduzida. As atribuições de reengajamento baseadas em "Gbraid" têm:
- ID da campanha
- Nome da campanha
Importante: para enviar Gbraid e Gclid para o Google, a integração do SDK do Singular deve ser configurada para oferecer suporte a deep links que não sejam do Singular. Consulte o guia do SDK do iOS e o guia do SDK do Android.
Uma visualização envolvida é uma impressão do utilizador de um anúncio de vídeo que durou mais de 10 segundos. As visualizações envolvidas são contabilizadas como atribuições de cliquesnos relatórios do Google e da Singular.
Nos registos ao nível do utilizador da Singular, as conversões de visualizações envolvidas são comunicadas em "interaction_type" = "engagement" no campo "passthrough" para dados de conversões/eventos atribuídos ao Google.
Nos relatórios agregados, as conversões de visualizações envolvidas são registadas em "conversion type" = "click-through".
(Beta) Perguntas frequentes sobre a Medição de conversão integrada do Google Ads
A Medição de conversão integrada do Google fornece uma atribuição mais abrangente, precisa e em tempo real para as suas campanhas de aplicativos do Google nas interfaces de parceiros de atribuição de aplicativos de terceiros. Incorpora tecnologias inovadoras, como a medição de conversões no dispositivo utilizando dados de eventos, para melhorar a precisão da medição, tudo isto sem comprometer a privacidade do utilizador. O resultado é um conhecimento ao nível do evento, mesmo quando faltam identificadores ao nível do utilizador.
Abrange:
- Utilizadores iOS 14.5+ que recusaram a App Tracking Transparency (ATT)
- Utilizadores de Android no Espaço Económico Europeu (EEE)
A Medição de conversão integrada do Google Ads é compatível apenas com a medição de instalações por clique.
As atribuições da Medição de conversão integrada são relatadas no Singular como- Cliques
- Instalações
- Atribuídas como probabilísticas (desagregação disponível apenas nos relatórios Singular ao nível do utilizador)
| Android | iOS |
|
|
Importante:
- O SDK iOS nativo da Singular e a API S2S são compatíveis com a Medição de conversão integrada do iOS
- Os plug-ins do SDK da Singular oferecem suporte à Medição de conversão integrada do iOS. Os plug-ins do SDK foram lançados.
A Medição de conversão integrada do iOS usa a Medição no dispositivo usando dados de eventos e requer a integração do SDK ODM do Google, bem como atualizações do SDK Singular (ou API S2S).
-
Integre a medição no dispositivo do Google usando dados de eventos (ODM SDK) usando qualquer uma dessas três opções:
Consulte o Guia do Google- No Xcode, navegue até Arquivo > Adicionar pacotes.
- No prompt que aparece, introduza o repositório GoogleAdsOnDeviceConversion do GitHub: https://github.com/googleads/google-ads-on-device-conversion-ios-sdk
- Depois de terminar, o Xcode começará a resolver as dependências do pacote e a baixá-las em segundo plano.
- No seu Podfile, adicione o pod GoogleAdsOnDeviceConversion.
pod 'GoogleAdsOnDeviceConversion' - Executar
pod install --repo-update
-
Atualizar a implementação do SDK Singular ou da API S2S
- Versão mínima do SDK nativo 12.8.1
- Certifique-se de que adiciona "-ObjC" a "Other Linker Flags" ao destino da aplicação
- Habilite o Singular para coletar informações do ODM adicionando a opção de configuração enableOdmWithTimeoutInterval ao SingularConfig ao inicializar o SDK do Singular.
enableOdmWithTimeoutInterval é definido com um valor de tempo limite em segundos. Recomenda-se usar um valor de timeout de 5 segundos. O valor de tempo limite define a quantidade máxima de tempo que o SDK do Singular atrasará a inicialização para aguardar as informações do ODM do SDK do ODM, na primeira inicialização após a instalação.
Importante:O processo de espera pelas informações do ODM do SDK do ODM atrasa os retornos de chamada do SDK do Singular, como o manipulador de retorno de chamada do link profundo do Singular. Portanto, os links diretos podem ser atrasados
Swift:
Objective C:config.enableOdmWithTimeoutInterval = 5
config.enableOdmWithTimeoutInterval = 5;
- SDK do Unity versão mínima v5.5.0
- Habilite o Singular para coletar informações de ODM adicionando a opção de configuração Habilitar ODM com intervalo de tempo limite no seu SingularSDKObject.
A opção Habilitar ODM com Intervalo de Tempo Limite é definida com um valor de tempo limite em segundos. Recomenda-se a utilização de um valor de tempo limite de 5 segundos. O valor de tempo limite define a quantidade máxima de tempo que o SDK do SIngular atrasará a inicialização para aguardar informações de ODM do SDK do ODM, na primeira inicialização após a instalação.
Importante:O processo de espera pelas informações do ODM do SDK do ODM atrasa os retornos de chamada do SDK do Singular, como o manipulador de retorno de chamada do link profundo do Singular. Portanto, os links diretos podem ser atrasados
- Versão mínima do SDK do Flutter v1.8.0
- React-Native SDK versão mínima v3.9.0
- Versão mínima do SDK do Cordova v1.8.0
- Certifique-se de que adiciona "-ObjC" a "Other Linker Flags" ao destino da aplicação
- Habilite o Singular para coletar informações do ODM adicionando a opção de configuração enableOdmWithTimeoutInterval ao SingularConfig ao inicializar o SDK do Singular.
enableOdmWithTimeoutInterval é definido com um valor de tempo limite em segundos. Recomenda-se usar um valor de timeout de 5 segundos. O valor de tempo limite define a quantidade máxima de tempo que o SDK do Singular atrasará a inicialização para aguardar as informações do ODM do SDK do ODM, na primeira inicialização após a instalação.
Importante:O processo de espera pelas informações do ODM do SDK do ODM atrasa os retornos de chamada do SDK do Singular, como o manipulador de retorno de chamada do link profundo do Singular. Portanto, os links diretos podem ser atrasados
config.enableOdmWithTimeoutInterval = 5
- Buscar informações no dispositivo logo após a primeira inicialização do aplicativo
Swift:import GoogleAdsOnDeviceConversion // Set the time when the app was first launched. ConversionManager.sharedInstance.setFirstLaunchTime(Date()) // Fetch the conversion info. ConversionManager.sharedInstance.fetchAggregateConversionInfo(for: .installation) { aggregateConversionInfo, error in guard error == nil else { return } guard let info = aggregateConversionInfo else { // Troubleshoot: // 1. Check that the Date passed to setFirstLaunchTime() was when the app // first launched. // 2. Check that your app is running in an approved region. return } guard info.count 0 else { return } print("Conversion info \(info)") // Use info as the value in the odm_info query parameter in // the App Conversion API detailed in Step 6. // For example, if info is "abcdEfadGdaf", then odm_info=abcdEfadGdaf. }
Objective C:@import GoogleAdsOnDeviceConversion; // Set the time when the app was first launched. [[ODCConversionManager sharedInstance] setFirstLaunchTime:[NSDate date]]; // Fetch the conversion info. [[ODCConversionManager sharedInstance] fetchAggregateConversionInfoForInteraction:ODCInteractionTypeInstallation completion:^(NSString * _Nullable aggregateConversionInfo, NSError * _Nullable error) { if (error) { return; } if (aggregateConversionInfo.length == 0) { // Troubleshoot: // 1. Check that the NSDate passed to setFirstLaunchTime() was when the app // first launched. // 2. Check that your app is running in an approved region. return; } NSLog(@"Conversion info %@", aggregateConversionInfo); // Use aggregateConversionInfo as the value in the odm_info query parameter in // the App Conversion API detailed in Step 6. // For example, if aggregateConversionInfo is "abcdEfadGdaf", // then odm_info=abcdEfadGdaf. }];
Importante:- Esta etapa é uma operação assíncrona, pelo que poderá exigir que não envie um evento Session antes de estar concluída.
- Colete o odm_info e compartilhe-o com o armazenamento do aplicativo para que você possa anexá-lo na primeira sessão. Esse valor será passado para a API S2S do Singular por meio do parâmetro "odm_info"
- Se houver um erro, recolha o erro. Este valor será passado para a API S2S da Singular através do parâmetro "odm_error".
- Note que o carimbo de data/hora passado com setFirstLaunchTime não deve diferir significativamente do carimbo de data/hora de instalação passado para a API S2S do Singular através do parâmetro "utime".
- Transmitir informações do dispositivo para a API S2S da Singular
Para cada sessão de instalação do aplicativo (install=true), inclua informações do ODM e erro do ODM no ponto de extremidade /launch do Singular S2S.
Políticas de dados do parceiro
Retenção de dados
Como parceiro do Google App Attribution, a Singular adere aos seguintes requisitos de retenção de dados exigidos pelo Google:
- Os dados de nível de utilizador do Google Ads são removidos após 6 meses da atribuição original. Após 6 meses, os usuários atribuídos ao Google Ads são tratados/marcados como"Orgânicos" e refletidos como tal nos relatórios agregados e no nível do usuário na Singular.
Tratamento do consentimento do utilizador do EEE
A partir de março de 2024, o Google Ads exige que os anunciantes passem sinais de consentimento para os utilizadores do EEE como parte das suas actualizações para apoiar o regulamento da Lei dos Mercados Digitais 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
- Consulte nossos artigos de documentação técnica da API do iOS, Android e Servidor para Servidor sobre "Limitar compartilhamento de dados"
- Recomenda-se que o LDS seja definido antes da inicialização do Singular SDK, 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 insights de publicidade
- O Singular LDS é mapeado para os tipos de consentimento do utilizador "ad_user_data" e "ad_personalization" do Google para utilizadores do EEE, conforme abaixo:
- LDS=true mapeia para ad_user_data/ad_personalization=0
- LDS=false mapeia para ad_user_data/ad_personalization=1
- LDS não definido mapeia para ad_user_data/ad_personalization não definido
- 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.
A partir de março de 2024
Para utilizadores do EEE que optem pelo consentimento do utilizador:
- A atribuição ao nível do utilizador para campanhas do Google Ads não estará disponível no Singular. A Google não poderá comunicar estas atribuições aos MMPs
- O Google Ads modelará as conversões para estes utilizadores, o que se reflecte nas métricas de rede agregadas que o Singular extrai do conetor de dados do Google Ads.
- O Google Ads 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 do Google Ads
- O Google Ads utilizará estes dados para fins publicitários
Recomendamos aos anunciantes que contactem o seu representante da Google para obterem informações mais detalhadas relativamente às suas campanhas e configurações específicas.
Dados criativos/de activos
Dependendo do tipo de campanha que estiver a executar, a Google fornecerá dados criativos/de activos. Consulte a tabela abaixo para saber que dados criativos e de grupos de anúncios estão disponíveis por tipo de campanha.
| Tipo de campanha (rastreador) | Tem ID de criativo | ID do grupo de anúncios | Nome do grupo de anúncios |
|---|---|---|---|
| Pesquisa | v | v | x |
| Exibir | v | v | x |
| Compras | v | v | x |
| Vídeo | v | v | x |
| ACI, ACE, ACPREX | x | v | v |
| Desempenho máximo | x | x | x |
| Hotel | v | v | x |
| Outros | v | v | x |