Panoramica
La pagina illustra come configurare i DAG tcrm_bq_to_ads_cm_v2 e tcrm_gcs_to_ads_cm_v2 e come preparare i dati.
Customer Match ti consente di utilizzare i dati online e offline per raggiungere e coinvolgere nuovamente clienti sulla rete di ricerca, nella scheda Shopping, su Gmail, YouTube e sulla Rete Display. Utilizzando le informazioni che i clienti hanno condiviso con te, Customer Match sceglierà come target degli annunci questi clienti e altri clienti simili.
Per maggiori dettagli, consulta Informazioni su Customer Match
Configura variabili Airflow
Crea nuove variabili DAG tcrm_bq_to_ads_cm_v2 obbligatorie
La sezione seguente indica quali variabili sono necessarie per eseguire il DAG tcrm_bq_to_ads_cm_v2. Devi configurare queste variabili solo se prevedi di utilizzare BigQuery come origine dati.
| Nome variabile | Valore di esempio | Informazioni sulle variabili |
|---|---|---|
tcrm_bq_to_ads_cm_v2_bq_dataset_id |
my_dataset |
Il nome del set di dati BigQuery contenente i dati. |
tcrm_bq_to_ads_cm_v2_bq_table_id |
my_table |
Il nome della tabella BigQuery contenente i dati. |
tcrm_bq_to_ads_cm_v2_google_ads_yaml_credentials |
Per informazioni sull'autenticazione dell'API Google Ads, consulta Panoramica dell'API Google Ads. | |
tcrm_bq_to_ads_cm_v2_ads_cm_user_list_name |
my_name_list |
Il nome dell'elenco di utenti Customer Match. |
tcrm_bq_to_ads_cm_v2_ads_upload_key_type |
CONTACT_INFO |
Il tipo di chiave di caricamento scelto tra CONTACT_INFO, CRM_ID o MOBILE_ADVERTISING_ID. Consulta UserList in Google Ads. |
tcrm_bq_to_ads_cm_v2_ads_cm_create_list |
False |
Vero/Falso, indica se si sta creando un nuovo elenco quando non esiste. |
tcrm_bq_to_ads_cm_v2_ads_cm_membership_lifespan_in_days |
30 |
Numero di giorni in cui il cookie di un utente rimane. |
tcrm_bq_to_ads_cm_v2_ads_cm_app_id |
ID app mobile per la creazione di un elenco di utenti. Obbligatorio solo quando ads_upload_key_type è MOBILE_ADVERTISING_ID. |
Crea nuove variabili DAG tcrm_gcs_to_ads_cm_v2 obbligatorie
La sezione seguente indica quali variabili sono necessarie per eseguire il DAG tcrm_gcs_to_ads_cm_v2. Devi configurare queste variabili solo se prevedi di utilizzare Google Cloud Storage come origine dati.
| Nome variabile | Valore di esempio | Informazioni sulle variabili |
|---|---|---|
tcrm_gcs_to_ads_cm_v2_gcs_bucket_name |
my_bucket |
Nome del bucket Cloud Storage. |
tcrm_gcs_to_ads_cm_v2_gcs_bucket_prefix |
folder/sub_folder |
Il percorso della cartella di dati all'interno del bucket. |
tcrm_gcs_to_ads_cm_v2_gcs_content_type (facoltativo) |
JSON o CSV. |
Tipo di contenuti di Cloud Storage. |
tcrm_gcs_to_ads_cm_v2_google_ads_yaml_credentials |
Per informazioni sull'autenticazione dell'API Google Ads, consulta Panoramica dell'API Google Ads. | |
tcrm_gcs_to_ads_cm_v2_ads_cm_user_list_name |
my_name_list |
Il nome dell'elenco di utenti Customer Match. |
tcrm_gcs_to_ads_cm_v2_ads_upload_key_type |
CONTACT_INFO |
Il tipo di chiave di caricamento scelto tra CONTACT_INFO, CRM_ID o MOBILE_ADVERTISING_ID. Consulta UserList in Google Ads. |
tcrm_gcs_to_ads_cm_v2_ads_cm_create_list |
False |
Vero/Falso, indica se si sta creando un nuovo elenco quando non esiste. |
tcrm_gcs_to_ads_cm_v2_ads_cm_membership_lifespan_in_days |
30 |
Numero di giorni in cui il cookie di un utente rimane. |
tcrm_gcs_to_ads_cm_v2_ads_cm_app_id |
ID app mobile per la creazione di un elenco di utenti. Obbligatorio solo quando ads_upload_key_type è MOBILE_ADVERTISING_ID. |
Prepara i dati da inviare a Customer Match di Google Ads
Lo schema dei dati è leggermente diverso per ogni upload_key_type.
- INFORMAZIONI DI CONTATTO
Esistono tre sottotipi di schema di dati:
Corrispondenza di hashedEmail:
| ID Cliente | hash.email |
|---|---|
| 1234567890 | dadbbb93... |
Corrispondenza di hashedPhoneNumber:
| ID Cliente | hash.email |
|---|---|
| 1234567890 | dadbbb93... |
Corrispondenza di addressInfo:
| ID Cliente | HashedFirstName | CognomeHashed | Codice Paese | codice postale |
|---|---|---|---|---|
| 1234567890 | dadbbb9337941annuncio | abcd97af923499 | JP | 1031103 |
- ID_MOBILE_ADVERTISING_
Corrispondenza di mobileId
| ID Cliente | ID dispositivo mobile |
|---|---|
| 1234567890 | 12345678-1234-1234-abcdef123456 |
- ID_CRM
Corrispondenza di thirdPartyUserId
| ID Cliente | IDUtenteDiTerzo |
|---|---|
| 1234567890 | ID_definito_nella_tua_organizzazione |
Esistono due tipi di archiviazione dei dati: tabella BigQuery o Google Cloud Storage
Da BigQuery utilizzando il DAG
tcrm_bq_to_ads_cm_v2in formato tabella SQL. I dati di esempio vengono troncati intenzionalmente a causa della lunghezza.ID Cliente hash.email 1234567890 dadbbb93... Da Google Cloud Storage utilizzando il DAG
tcrm_gcs_to_ads_cm_v2in formato JSON.{'customerId': '1234567890', 'hashedEmail': 'f660ab912ec121d1b1e928a0bb4bc61b15f5ad44d5efdc4e1c92a25e99b8e44a'}Da Google Cloud Storage utilizzando il DAG
tcrm_gcs_to_ads_cm_v2in formato CSV.customerId,hashedEmail 1234567890,dadbbb9327c711e4b626f7820fb299871d23d6020683bbd1e08d37e0246c7e90
Gestisci il tuo DAG
Nella console Airflow fai clic sull'opzione DAGs nella barra dei menu in alto. Individua il DAG da eseguire nell'elenco a sinistra. Quindi eseguilo facendo clic sul pulsante Play sul lato destro dell'elenco.
Lettura dei log di DAG
Consulta le Domande frequenti sulla lettura dei log di DAG nelle Domande frequenti.