Google Ads 目标客户匹配 DAG

概览

本页面将逐步介绍如何配置 tcrm_bq_to_ads_cm_v2 和 tcrm_gcs_to_ads_cm_v2 DAG，以及如何准备数据。

借助目标客户匹配功能，您可以利用您的线上及线下数据，在 Google 搜索、“购物”标签页、Gmail、YouTube 和展示广告网络上覆盖和再次吸引客户。目标客户匹配功能利用客户与您分享的信息，将广告定位到这些客户及其他类似客户。

如需了解详情，请参阅目标客户匹配简介

配置 Airflow 变量

创建新的必需 tcrm_bq_to_ads_cm_v2 DAG 变量

以下部分指出运行 tcrm_bq_to_ads_cm_v2 DAG 所需的变量。仅当您计划使用 BigQuery 作为数据源时，才需要设置这些变量。

变量名称 示例值 变量信息
tcrm_bq_to_ads_cm_v2_bq_dataset_id my_dataset 包含数据的 BigQuery 数据集的名称。
tcrm_bq_to_ads_cm_v2_bq_table_id my_table 包含数据的 BigQuery 表的名称。
tcrm_bq_to_ads_cm_v2_google_ads_yaml_credentials Google Ads API 的身份验证信息，请参阅 Google Ads API 概览，了解详情。
tcrm_bq_to_ads_cm_v2_ads_cm_user_list_name my_name_list 目标客户匹配用户名单的名称。
tcrm_bq_to_ads_cm_v2_ads_upload_key_type CONTACT_INFO 从 CONTACT_INFO、CRM_ID 或 MOBILE_ADVERTISING_ID 中选择的上传密钥类型。请参阅 Google Ads 中的用户列表
tcrm_bq_to_ads_cm_v2_ads_cm_create_list False True/False，指明当列表不存在时是否创建新列表。
tcrm_bq_to_ads_cm_v2_ads_cm_membership_lifespan_in_days 30 用户的 Cookie 保留天数。
tcrm_bq_to_ads_cm_v2_ads_cm_app_id 用于创建用户列表的移动应用 ID。仅当 ads_upload_key_type 为 MOBILE_ADVERTISING_ID 时才需要。

创建新的必需 tcrm_gcs_to_ads_cm_v2 DAG 变量

以下部分指出运行 tcrm_gcs_to_ads_cm_v2 DAG 所需的变量。仅当您计划使用 Google Cloud Storage 作为数据源时，才需要设置这些变量。

变量名称 示例值 变量信息
tcrm_gcs_to_ads_cm_v2_gcs_bucket_name my_bucket Cloud Storage 存储分区名称。
tcrm_gcs_to_ads_cm_v2_gcs_bucket_prefix folder/sub_folder 存储分区中数据文件夹的路径。
tcrm_gcs_to_ads_cm_v2_gcs_content_type（可选） JSON 或 CSV。 Cloud Storage 内容类型。
tcrm_gcs_to_ads_cm_v2_google_ads_yaml_credentials Google Ads API 的身份验证信息，请参阅 Google Ads API 概览，了解详情。
tcrm_gcs_to_ads_cm_v2_ads_cm_user_list_name my_name_list 目标客户匹配用户名单的名称。
tcrm_gcs_to_ads_cm_v2_ads_upload_key_type CONTACT_INFO 从 CONTACT_INFO、CRM_ID 或 MOBILE_ADVERTISING_ID 中选择的上传密钥类型。请参阅 Google Ads 中的用户列表
tcrm_gcs_to_ads_cm_v2_ads_cm_create_list False True/False，指明当列表不存在时是否创建新列表。
tcrm_gcs_to_ads_cm_v2_ads_cm_membership_lifespan_in_days 30 用户的 Cookie 保留天数。
tcrm_gcs_to_ads_cm_v2_ads_cm_app_id 用于创建用户列表的移动应用 ID。仅当 ads_upload_key_type 为 MOBILE_ADVERTISING_ID 时才需要。

准备要发送到 Google Ads 目标客户匹配的数据

对于每个 upload_key_type，数据架构都略有不同。

  1. 联系信息

数据架构有 3 种子类型：

按“hashedEmail”匹配：

CustomerId 经过哈希处理的电子邮件地址
1234567890 dadbbb93...

按“hashedPhoneNumber”匹配：

CustomerId 经过哈希处理的电子邮件地址
1234567890 dadbbb93...

按“addressInfo”匹配：

CustomerId HashFirstName 经过哈希处理的姓氏 countryCode postalCode
1234567890 dadbbb9337941ad abcd97af923499 日本 1031103
  1. 移动设备 ID

按mobileId匹配

CustomerId 移动设备 ID
1234567890 12345678-1234-1234-abcdef123456
  1. 客户 ID

按thirdPartyUserId匹配

CustomerId 第三方用户 ID
1234567890 <您的组织> id_defined_in

数据存储有两种类型，即 BigQuery 表或 Google Cloud Storage

  1. 使用 SQL 表格式的 tcrm_bq_to_ads_cm_v2 DAG 从 BigQuery 导出。 （示例数据因过长而故意被截断。）

    CustomerId 经过哈希处理的电子邮件地址
    1234567890 dadbbb93...

  2. 从 Google Cloud Storage 中导入 JSON 格式的 tcrm_gcs_to_ads_cm_v2 DAG。

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

  3. 使用 tcrm_gcs_to_ads_cm_v2 格式从 Google Cloud Storage 中导入 CSV 格式的 DAG。

    customerId,hashedEmail
1234567890,dadbbb9327c711e4b626f7820fb299871d23d6020683bbd1e08d37e0246c7e90

运行 DAG

在 Airflow 控制台中，点击顶部菜单栏中的 DAGs 选项。在左侧的列表中找到要运行的 DAG。然后点击列表右侧的 Play 按钮来运行它。

读取 DAG 的日志

请参阅常见问题解答中的读取 DAG 日志。