DAG списков электронных адресов для рекламы

Обзор

На этой странице вы узнаете, как настроить группы обеспечения доступности баз данных tcrm_bq_to_ads_cm_v2 и tcrm_gcs_to_ads_cm_v2 , а также как подготовить данные.

Списки электронных адресов позволяют использовать ваши онлайн- и офлайн-данные для привлечения клиентов и повторного взаимодействия с ними в Поиске, на вкладке "Покупки", в Gmail, на YouTube и в контекстно-медийной сети. Используя информацию, которой ваши клиенты поделились с вами, списки электронных адресов будут нацеливать рекламу на этих клиентов и других клиентов, подобных им.

Подробнее см. в разделе Списки электронных адресов.

Настройка переменных воздушного потока

Создайте новые обязательные переменные DAG tcrm_bq_to_ads_cm_v2

В следующем разделе указано, какие переменные необходимы для запуска группы обеспечения доступности баз данных tcrm_bq_to_ads_cm_v2 . Вам нужно настроить эти переменные только в том случае, если вы планируете использовать 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 Идентификатор мобильного приложения для создания списка пользователей. Требуется, только если ads_upload_key_type имеет MOBILE_ADVERTISING_ID .

Создайте новые обязательные переменные DAG tcrm_gcs_to_ads_cm_v2

В следующем разделе указано, какие переменные необходимы для запуска группы обеспечения доступности баз данных tcrm_gcs_to_ads_cm_v2 . Вам нужно настроить эти переменные только в том случае, если вы планируете использовать Google Cloud Storage в качестве источника данных.

Имя переменной Пример значения Переменная информация
tcrm_gcs_to_ads_cm_v2_gcs_bucket_name my_bucket Имя сегмента облачного хранилища.
tcrm_gcs_to_ads_cm_v2_gcs_bucket_prefix folder/sub_folder Путь к папке данных внутри корзины.
tcrm_gcs_to_ads_cm_v2_gcs_content_type (необязательно) Либо JSON , либо CSV . Тип содержимого облачного хранилища.
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 Идентификатор мобильного приложения для создания списка пользователей. Требуется, только если ads_upload_key_type имеет MOBILE_ADVERTISING_ID .

Подготовка данных для отправки в Google Ads Customer Match

Для каждого upload_key_type схема данных немного отличается.

  1. КОНТАКТНАЯ ИНФОРМАЦИЯ

Существует 3 подтипа схемы данных:

Соответствие по hashedEmail :

Пользовательский ИД hashedEmail
1234567890 даббб93...

Сопоставление по hashedPhoneNumber :

Пользовательский ИД hashedEmail
1234567890 даббб93...

Сопоставление по addressInfo :

Пользовательский ИД hashedFirstName hashedLastName код страны Почтовый индекс
1234567890 папабб9337941объявление abcd97af923499 Япония 1031103
  1. MOBILE_ADVERTISING_ID

Сопоставление по mobileId

Пользовательский ИД мобильный идентификатор
1234567890 12345678-1234-1234-abcdef123456
  1. CRM_ID

Сопоставление по адресу thirdPartyUserId

Пользовательский ИД идентификатор третьего пользователя
1234567890 id_defined_in_your_organization

Для хранения данных есть 2 типа: таблица BigQuery или Google Cloud Storage.

  1. Из BigQuery с использованием DAG tcrm_bq_to_ads_cm_v2 в формате таблицы SQL. (Данные примера намеренно усечены из-за длины.)

    Пользовательский ИД hashedEmail
    1234567890 даббб93...

  2. Из Google Cloud Storage с помощью DAG tcrm_gcs_to_ads_cm_v2 в формате JSON.

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

  3. Из Google Cloud Storage с использованием DAG tcrm_gcs_to_ads_cm_v2 в формате CSV.

    customerId,hashedEmail
1234567890,dadbbb9327c711e4b626f7820fb299871d23d6020683bbd1e08d37e0246c7e90

Запустите свою группу обеспечения доступности баз данных

В консоли Airflow щелкните параметр DAGs в верхней строке меню. Найдите нужную DAG в списке слева. Затем запустите его, нажав кнопку Play в правой части списка.

Чтение журналов DAG

См. Чтение журналов DAG в разделе часто задаваемых вопросов.