DAGs da Segmentação por lista de clientes do Google Ads

Visão geral

Nesta página, você vai aprender a configurar os DAGs tcrm_bq_to_ads_cm_v2 e tcrm_gcs_to_ads_cm_v2 e a preparar os dados.

Com a Segmentação por lista de clientes, é possível usar dados on-line e off-line para alcançar e atrair novamente seus clientes na Pesquisa Google, na guia "Shopping", no Gmail, no YouTube e na Rede de Display. Com base nas informações compartilhadas pelos clientes, a Segmentação por lista de clientes segmenta os anúncios para esses clientes e outros clientes semelhantes.

Para mais detalhes, consulte Sobre a Segmentação por lista de clientes.

Configurar variáveis do Airflow

Criar novas variáveis do DAG tcrm_bq_to_ads_cm_v2 obrigatórias

A seção a seguir indica quais variáveis são necessárias para executar o DAG tcrm_bq_to_ads_cm_v2. Você só precisará configurar essas variáveis se planeja usar o BigQuery como fonte de dados.

Nome da variável Valor de exemplo Informações da variável
tcrm_bq_to_ads_cm_v2_bq_dataset_id my_dataset O nome do conjunto de dados do BigQuery que contém os dados.
tcrm_bq_to_ads_cm_v2_bq_table_id my_table O nome da tabela do BigQuery que contém os dados.
tcrm_bq_to_ads_cm_v2_google_ads_yaml_credentials As informações de autenticação da API Google Ads estão disponíveis na Visão geral da API Google Ads para mais informações.
tcrm_bq_to_ads_cm_v2_ads_cm_user_list_name my_name_list O nome da lista de usuários da Segmentação por lista de clientes.
tcrm_bq_to_ads_cm_v2_ads_upload_key_type CONTACT_INFO O tipo de chave de upload que escolhe entre CONTACT_INFO, CRM_ID ou MOBILE_ADVERTISING_ID. Consulte AdID no Google Ads.
tcrm_bq_to_ads_cm_v2_ads_cm_create_list False Verdadeiro/Falso, indica se está criando uma nova lista quando ela não existe.
tcrm_bq_to_ads_cm_v2_ads_cm_membership_lifespan_in_days 30 Número de dias de permanência do cookie de um usuário.
tcrm_bq_to_ads_cm_v2_ads_cm_app_id ID do app para dispositivos móveis para criar uma lista de usuários. Obrigatório apenas quando ads_upload_key_type é MOBILE_ADVERTISING_ID.

Criar novas variáveis do DAG tcrm_gcs_to_ads_cm_v2 obrigatórias

A seção a seguir indica quais variáveis são necessárias para executar o DAG tcrm_gcs_to_ads_cm_v2. Você só precisará configurar essas variáveis se planeja usar o Google Cloud Storage como sua fonte de dados.

Nome da variável Valor de exemplo Informações da variável
tcrm_gcs_to_ads_cm_v2_gcs_bucket_name my_bucket Nome do bucket do Cloud Storage.
tcrm_gcs_to_ads_cm_v2_gcs_bucket_prefix folder/sub_folder O caminho para a pasta de dados dentro do bucket.
tcrm_gcs_to_ads_cm_v2_gcs_content_type (opcional) JSON ou CSV. Tipo de conteúdo do Cloud Storage.
tcrm_gcs_to_ads_cm_v2_google_ads_yaml_credentials As informações de autenticação da API Google Ads estão disponíveis na Visão geral da API Google Ads para mais informações.
tcrm_gcs_to_ads_cm_v2_ads_cm_user_list_name my_name_list O nome da lista de usuários da Segmentação por lista de clientes.
tcrm_gcs_to_ads_cm_v2_ads_upload_key_type CONTACT_INFO O tipo de chave de upload que escolhe entre CONTACT_INFO, CRM_ID ou MOBILE_ADVERTISING_ID. Consulte AdID no Google Ads.
tcrm_gcs_to_ads_cm_v2_ads_cm_create_list False Verdadeiro/Falso, indica se está criando uma nova lista quando ela não existe.
tcrm_gcs_to_ads_cm_v2_ads_cm_membership_lifespan_in_days 30 Número de dias de permanência do cookie de um usuário.
tcrm_gcs_to_ads_cm_v2_ads_cm_app_id ID do app para dispositivos móveis para criar uma lista de usuários. Obrigatório apenas quando ads_upload_key_type é MOBILE_ADVERTISING_ID.

Preparar dados para enviar à Segmentação por lista de clientes do Google Ads

Para cada upload_key_type, o esquema de dados é um pouco diferente.

  1. CONTATO_CONTATO

Há três subtipos de esquema de dados:

Correspondência de hashedEmail:

CustomerId hashedEmail
1234567890 dadbbb93...

Correspondência de hashedPhoneNumber:

CustomerId hashedEmail
1234567890 dadbbb93...

Correspondência de addressInfo:

CustomerId hashedFirstName Sobrenome do hash Código do país postalCode
1234567890 dadbbb9337941ad abcd97af923499 Japão 1031103
  1. ID_DISPOSITIVOS MÓVEIS

Correspondência de mobileId

CustomerId ID móvel
1234567890 12345678-1234-1234-abcdef123456
  1. ID do CRM

Correspondência de thirdPartyUserId

CustomerId ID de terceiros
1234567890 código_definido_na_sua_organização

Para o armazenamento de dados, há dois tipos: tabela do BigQuery ou Google Cloud Storage

  1. No BigQuery, use o DAG tcrm_bq_to_ads_cm_v2 no formato de tabela SQL. Os dados do exemplo estão deliberadamente truncados devido ao tamanho.

    CustomerId hashedEmail
    1234567890 dadbbb93...

  2. Do Google Cloud Storage usando o DAG tcrm_gcs_to_ads_cm_v2 no formato JSON.

    {'customerId': '1234567890', 'hashedEmail': 'f660ab912ec121d1b1e928a0bb4bc61b15f5ad44d5efdc4e1c92a25e99b8e44a'}

  3. Do Google Cloud Storage usando o DAG tcrm_gcs_to_ads_cm_v2 no formato CSV.

    customerId,hashedEmail
1234567890,dadbbb9327c711e4b626f7820fb299871d23d6020683bbd1e08d37e0246c7e90

Execute seu DAG

No Console do Airflow, clique na opção DAGs na barra de menus superior. Encontre o DAG que você quer executar na lista à esquerda. Em seguida, execute-o clicando no botão Play no lado direito da lista.

Como ler registros do DAG

Consulte Como ler registros do DAG em "Perguntas frequentes".