DAG-i na potrzeby kierowania na listę klientów

Omówienie

Na tej stronie dowiesz się, jak skonfigurować DAG-i tcrm_bq_to_ads_cm_v2 i tcrm_gcs_to_ads_cm_v2 oraz jak przygotować dane.

Dzięki kierowaniu na listę klientów możesz wykorzystywać dane online i offline, aby docierać do klientów i ponownie ich angażować w wyszukiwarce, Gmailu, YouTube, sieci reklamowej i na karcie Zakupy. Na podstawie informacji udostępnionych Ci przez klientów funkcja kierowania na listę klientów będzie kierować reklamy na tych i podobnych klientów.

Więcej informacji znajdziesz w artykule Kierowanie na listę klientów.

Skonfiguruj zmienne Airflow

Utwórz nowe wymagane zmienne tcrm_bq_to_ads_cm_v2 DAG-ów

W tej sekcji podano, które zmienne są niezbędne do uruchamiania DAG-a tcrm_bq_to_ads_cm_v2. Zmienne te musisz skonfigurować tylko wtedy, gdy zamierzasz używać BigQuery jako źródła danych.

Nazwa zmiennej Przykładowa wartość Informacje o zmiennej
tcrm_bq_to_ads_cm_v2_bq_dataset_id my_dataset Nazwa zbioru danych BigQuery zawierającego dane.
tcrm_bq_to_ads_cm_v2_bq_table_id my_table Nazwa tabeli BigQuery zawierającej dane.
tcrm_bq_to_ads_cm_v2_google_ads_yaml_credentials Dane uwierzytelniające dla interfejsu Google Ads API znajdziesz w artykule Omówienie interfejsu API Google Ads.
tcrm_bq_to_ads_cm_v2_ads_cm_user_list_name my_name_list Nazwa listy użytkowników z kierowania na listę klientów.
tcrm_bq_to_ads_cm_v2_ads_upload_key_type CONTACT_INFO Typ klucza przesyłania do wyboru: CONTACT_INFO, CRM_ID lub MOBILE_ADVERTISING_ID. Zapoznaj się z listą użytkowników w Google Ads.
tcrm_bq_to_ads_cm_v2_ads_cm_create_list False Prawda/fałsz: wskazuje, czy nowa lista nie istnieje.
tcrm_bq_to_ads_cm_v2_ads_cm_membership_lifespan_in_days 30 Liczba dni, przez które plik cookie użytkownika pozostaje.
tcrm_bq_to_ads_cm_v2_ads_cm_app_id Identyfikator aplikacji mobilnej do tworzenia listy użytkowników. Wymagane tylko wtedy, gdy ads_upload_key_type ma wartość MOBILE_ADVERTISING_ID.

Utwórz nowe wymagane zmienne tcrm_gcs_to_ads_cm_v2 DAG-ów

W tej sekcji podano, które zmienne są niezbędne do uruchamiania DAG-a tcrm_gcs_to_ads_cm_v2. Zmienne te musisz skonfigurować tylko wtedy, gdy zamierzasz używać Google Cloud Storage jako źródła danych.

Nazwa zmiennej Przykładowa wartość Informacje o zmiennej
tcrm_gcs_to_ads_cm_v2_gcs_bucket_name my_bucket Nazwa zasobnika Cloud Storage.
tcrm_gcs_to_ads_cm_v2_gcs_bucket_prefix folder/sub_folder Ścieżka do folderu danych wewnątrz zasobnika.
tcrm_gcs_to_ads_cm_v2_gcs_content_type (opcjonalnie) Może to być JSON lub CSV. Typ treści w Cloud Storage.
tcrm_gcs_to_ads_cm_v2_google_ads_yaml_credentials Dane uwierzytelniające dla interfejsu Google Ads API znajdziesz w artykule Omówienie interfejsu API Google Ads.
tcrm_gcs_to_ads_cm_v2_ads_cm_user_list_name my_name_list Nazwa listy użytkowników z kierowania na listę klientów.
tcrm_gcs_to_ads_cm_v2_ads_upload_key_type CONTACT_INFO Typ klucza przesyłania do wyboru: CONTACT_INFO, CRM_ID lub MOBILE_ADVERTISING_ID. Zapoznaj się z listą użytkowników w Google Ads.
tcrm_gcs_to_ads_cm_v2_ads_cm_create_list False Prawda/fałsz: wskazuje, czy nowa lista nie istnieje.
tcrm_gcs_to_ads_cm_v2_ads_cm_membership_lifespan_in_days 30 Liczba dni, przez które plik cookie użytkownika pozostaje.
tcrm_gcs_to_ads_cm_v2_ads_cm_app_id Identyfikator aplikacji mobilnej do tworzenia listy użytkowników. Wymagane tylko wtedy, gdy ads_upload_key_type ma wartość MOBILE_ADVERTISING_ID.

Przygotuj dane do wysłania na listę klientów Google Ads

Dla każdego obiektu upload_key_type schemat danych jest nieco inny.

  1. CONTACT_INFO

Schemat danych ma 3 podtypy:

Pasuje według: hashedEmail:

IDklienta zaszyfrowanyE-mail
1234567890 dadbbb93...

Pasuje według: hashedPhoneNumber:

IDklienta zaszyfrowanyE-mail
1234567890 dadbbb93...

Pasuje według: addressInfo:

IDklienta zahaszowany HashLastName Kod kraju Kod pocztowy
1234567890 dadbbb9337941ad abcd97af923499 JP 1031103
  1. ID_REKLAMY_MOBILNEJ

Pasuje według: mobileId

IDklienta mobileId
1234567890 12345678-1234-1234-abcdef123456
  1. Identyfikator CRM

Pasuje według: thirdPartyUserId

IDklienta identyfikator innej firmy
1234567890 ID_zdefiniowane_w_Twojej_organizacji

Są 2 typy pamięci masowej: tabela BigQuery i Google Cloud Storage

  1. Z BigQuery przy użyciu DAG-a tcrm_bq_to_ads_cm_v2 w formacie tabeli SQL. (Przykładowe dane zostały celowo obcięte ze względu na długość).

    IDklienta zaszyfrowanyE-mail
    1234567890 dadbbb93...

  2. Z Google Cloud Storage przy użyciu DAG-a tcrm_gcs_to_ads_cm_v2 w formacie JSON.

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

  3. Z Google Cloud Storage przy użyciu DAG-a tcrm_gcs_to_ads_cm_v2 w formacie CSV.

    customerId,hashedEmail
1234567890,dadbbb9327c711e4b626f7820fb299871d23d6020683bbd1e08d37e0246c7e90

Uruchamianie DAG-a

W konsoli Airflow kliknij opcję DAGs na górnym pasku menu. Znajdź na liście po lewej stronie DAG-a, który chcesz uruchomić. Aby go uruchomić, kliknij przycisk Play po prawej stronie listy.

Odczytywanie logów DAG-a

Więcej informacji znajdziesz w sekcji Odczytywanie dzienników DAG-a w najczęstszych pytaniach.