DAG de anuncios de Segmentación por clientes

Descripción general

En la página, se explica cómo configurar los DAG tcrm_bq_to_ads_cm_v2 y tcrm_gcs_to_ads_cm_v2, y cómo preparar los datos.

La Segmentación por clientes te permite usar los datos en línea y sin conexión para llegar a los clientes y volver a atraerlos en la Búsqueda, la pestaña Shopping, Gmail, YouTube y Display. Mediante la información que sus clientes compartieron con usted, la Segmentación por clientes orientará los anuncios a esos clientes y a otros similares.

Para obtener más información, consulta Acerca de la Segmentación por clientes.

Configurar variables de Airflow

Nota: Para obtener información sobre cómo configurar la variable de Airflow con la IU, consulta la sección 3.2 en la guía de instalación básica.

Nota: Para obtener información sobre cómo configurar variables generales, como la programación, el reintento o la supervisión, consulta la sección 3.3 en la guía de instalación básica.

Crear nuevas variables de DAG obligatorias del tipo tcrm_bq_to_ads_cm_v2

En la siguiente sección, se indica qué variables se necesitan para ejecutar el DAG tcrm_bq_to_ads_cm_v2. Solo necesitas configurar estas variables si planeas usar BigQuery como la fuente de datos.

Nombre de la variable	Valor de ejemplo	Información de la variable
tcrm_bq_to_ads_cm_v2_bq_dataset_id	my_dataset	El nombre del conjunto de datos de BigQuery que contiene los datos.
tcrm_bq_to_ads_cm_v2_bq_table_id	my_table	El nombre de la tabla de BigQuery que contiene los datos.
tcrm_bq_to_ads_cm_v2_google_ads_yaml_credentials		Para obtener más información sobre la autenticación de la API de Google Ads, consulte la Descripción general de la API de Google Ads.
tcrm_bq_to_ads_cm_v2_ads_cm_user_list_name	my_name_list	Es el nombre de la lista de usuarios de Segmentación por clientes.
tcrm_bq_to_ads_cm_v2_ads_upload_key_type	CONTACT_INFO	Es el tipo de clave de carga que se elige en CONTACT_INFO, CRM_ID o MOBILE_ADVERTISING_ID. Consulte la lista de usuarios en Google Ads
tcrm_bq_to_ads_cm_v2_ads_cm_create_list	False	Verdadero/falso, indica si la lista nueva no se está creando.
tcrm_bq_to_ads_cm_v2_ads_cm_membership_lifespan_in_days	30	Cantidad de días que la cookie del usuario permanece.
tcrm_bq_to_ads_cm_v2_ads_cm_app_id		Es el ID de la aplicación para dispositivos móviles a fin de crear una lista de usuarios. Solo se requiere cuando ads_upload_key_type es MOBILE_ADVERTISING_ID.

Crear nuevas variables de DAG obligatorias del tipo tcrm_gcs_to_ads_cm_v2

En la siguiente sección, se indica qué variables se necesitan para ejecutar el DAG tcrm_gcs_to_ads_cm_v2. Solo necesitas configurar estas variables si planeas usar Google Cloud Storage como fuente de datos.

Nombre de la variable	Valor de ejemplo	Información de la variable
tcrm_gcs_to_ads_cm_v2_gcs_bucket_name	my_bucket	Nombre del bucket de Cloud Storage.
tcrm_gcs_to_ads_cm_v2_gcs_bucket_prefix	folder/sub_folder	La ruta a la carpeta de datos dentro del bucket.
tcrm_gcs_to_ads_cm_v2_gcs_content_type (opcional)	JSON o CSV	Tipo de contenido de Cloud Storage
tcrm_gcs_to_ads_cm_v2_google_ads_yaml_credentials		Para obtener más información sobre la autenticación de la API de Google Ads, consulte la Descripción general de la API de Google Ads.
tcrm_gcs_to_ads_cm_v2_ads_cm_user_list_name	my_name_list	Es el nombre de la lista de usuarios de Segmentación por clientes.
tcrm_gcs_to_ads_cm_v2_ads_upload_key_type	CONTACT_INFO	Es el tipo de clave de carga que se elige en CONTACT_INFO, CRM_ID o MOBILE_ADVERTISING_ID. Consulte la lista de usuarios en Google Ads
tcrm_gcs_to_ads_cm_v2_ads_cm_create_list	False	Verdadero/falso, indica si la lista nueva no se está creando.
tcrm_gcs_to_ads_cm_v2_ads_cm_membership_lifespan_in_days	30	Cantidad de días que la cookie del usuario permanece.
tcrm_gcs_to_ads_cm_v2_ads_cm_app_id		Es el ID de la aplicación para dispositivos móviles a fin de crear una lista de usuarios. Solo se requiere cuando ads_upload_key_type es MOBILE_ADVERTISING_ID.

Prepare los datos para enviar a la Segmentación por clientes de Google Ads

Para cada upload_key_type, el esquema de datos es un poco diferente.

1. Información de contacto

Hay 3 subtipos de esquema de datos:

Coincidencia por hashedEmail:

CustomerId	Correo electrónico con hash
1234567890	pablo93...

Coincidencia por hashedPhoneNumber:

CustomerId	Correo electrónico con hash
1234567890	pablo93...

Coincidencia por addressInfo:

CustomerId	hashedFirstName.	Último apellido con hash	Código de país	Código postal
1234567890	pablo9337941	abcd97af923499	JP	1031103

1. ID DE ANUNCIO MÓVIL

Coincidencia por mobileId

CustomerId	ID de dispositivo móvil
1234567890	12345678-1234-1234-abcdef123456

1. ID de CRM

Coincidencia por thirdPartyUserId

CustomerId	ID de usuario tercero
1234567890	id_definido_en_su_organización

Para el almacenamiento de datos, hay 2 tipos: una tabla de BigQuery o Google Cloud Storage.

1. Desde BigQuery con el DAG tcrm_bq_to_ads_cm_v2 en formato de tabla SQL (Los datos de ejemplo se truncan deliberadamente debido a la longitud).

   CustomerId	Correo electrónico con hash
   1234567890	pablo93...

2. Desde Google Cloud Storage mediante el DAG tcrm_gcs_to_ads_cm_v2 en formato JSON.

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

3. Desde Google Cloud Storage mediante el DAG tcrm_gcs_to_ads_cm_v2 en formato CSV.

   customerId,hashedEmail
   1234567890,dadbbb9327c711e4b626f7820fb299871d23d6020683bbd1e08d37e0246c7e90
   

Ejecuta tu DAG

En la consola de Airflow, haga clic en la opción DAGs en la barra de menú superior. Busca el DAG que deseas ejecutar en la lista de la izquierda. Luego, para ejecutarla, haz clic en el botón Play que se encuentra a la derecha de la lista.

Lee los registros del DAG

Consulta Leer los registros del DAG en las Preguntas frecuentes.