Connessione Google Customer Match
Google Customer Match utilizza i tuoi dati online e offline per raggiungere e coinvolgere nuovamente i tuoi clienti nelle proprietà possedute e gestite da Google, ad esempio: Search, Shopping e Gmail.
Casi d’uso use-cases
Per aiutarti a capire meglio come e quando utilizzare la destinazione Google Customer Match, ecco alcuni esempi di casi d’uso che i clienti Adobe Experience Platform possono risolvere utilizzando questa funzione.
#1 del caso d’uso use-case-1
Un marchio di abbigliamento sportivo desidera raggiungere i clienti esistenti tramite Google Search e Google Shopping per personalizzare offerte ed articoli in base ai loro acquisti passati e alla cronologia di navigazione. Il marchio di abbigliamento può acquisire indirizzi e-mail dal proprio CRM per Experience Platform e creare tipi di pubblico dai propri dati offline. Quindi possono inviare questi tipi di pubblico a Google Customer Match per utilizzarli in Search e Shopping, ottimizzando le loro spese pubblicitarie.
#2 del caso d’uso use-case-2
Un’importante azienda tecnologica ha lanciato un nuovo telefono. Per promuovere questo nuovo modello di telefono, sono alla ricerca di far conoscere le nuove caratteristiche e funzionalità del telefono ai clienti che possiedono modelli precedenti dei loro telefoni.
Per promuovere la versione, caricano in Experience Platform gli indirizzi e-mail dal database CRM, utilizzandoli come identificatori. I tipi di pubblico vengono creati in base ai clienti che possiedono modelli di telefono meno recenti. Quindi i tipi di pubblico vengono inviati a Google Customer Match, in modo che l’azienda possa eseguire il targeting dei clienti attuali, dei clienti che possiedono modelli di telefono precedenti e di clienti simili in YouTube.
Governance dei dati per Google Customer Match destinazioni data-governance
Alcune destinazioni in Experience Platform hanno determinate regole e obblighi per i dati inviati alla piattaforma di destinazione o ricevuti da essa. L’utente è responsabile della comprensione delle limitazioni e degli obblighi relativi ai propri dati e del modo in cui li utilizza in Adobe Experience Platform e nella piattaforma di destinazione. Adobe Experience Platform fornisce strumenti di governance dei dati per aiutarti a gestire alcuni di questi obblighi di utilizzo dei dati. Ulteriori informazioni sugli strumenti e i criteri di governance dei dati.
Identità supportate supported-identities
Google Customer Match supporta l’attivazione delle identità descritte nella tabella seguente. Ulteriori informazioni su identità.
GAIDIDFAphone_sha256_e.164email_lc_sha256user_idaddress_info_first_nameaddress_info_last_name, address_info_country_code e address_info_postal_code, quando si desidera inviare i dati dell’indirizzo postale alla destinazione.Per assicurarsi che Google corrisponda all’indirizzo, è necessario mappare tutti e quattro i campi degli indirizzi (
address_info_first_name, address_info_last_name, address_info_country_code e address_info_postal_code) e assicurarsi che nessuno di questi campi sia mancante nei profili esportati.Se un campo non è mappato o contiene dati mancanti, Google non corrisponderà all’indirizzo.
address_info_last_nameaddress_info_first_name, address_info_country_code e address_info_postal_code, quando si desidera inviare i dati dell’indirizzo postale alla destinazione.Per assicurarsi che Google corrisponda all’indirizzo, è necessario mappare tutti e quattro i campi degli indirizzi (
address_info_first_name, address_info_last_name, address_info_country_code e address_info_postal_code) e assicurarsi che nessuno di questi campi sia mancante nei profili esportati.Se un campo non è mappato o contiene dati mancanti, Google non corrisponderà all’indirizzo.
address_info_country_codeaddress_info_first_name, address_info_last_name e address_info_postal_code, quando si desidera inviare i dati dell’indirizzo postale alla destinazione.Per assicurarsi che Google corrisponda all’indirizzo, è necessario mappare tutti e quattro i campi degli indirizzi (
address_info_first_name, address_info_last_name, address_info_country_code e address_info_postal_code) e assicurarsi che nessuno di questi campi sia mancante nei profili esportati.Se un campo non è mappato o contiene dati mancanti, Google non corrisponderà all’indirizzo.
Formato accettato: codici paese a due lettere minuscole in formato ISO 3166-1 alpha-2.
address_info_postal_codeaddress_info_first_name, address_info_last_name e address_info_country_code, quando si desidera inviare i dati dell’indirizzo postale alla destinazione.Per assicurarsi che Google corrisponda all’indirizzo, è necessario mappare tutti e quattro i campi degli indirizzi (
address_info_first_name, address_info_last_name, address_info_country_code e address_info_postal_code) e assicurarsi che nessuno di questi campi sia mancante nei profili esportati.Se un campo non è mappato o contiene dati mancanti, Google non corrisponderà all’indirizzo.
Tipi di pubblico supportati supported-audiences
Questa sezione descrive quali tipi di pubblico puoi esportare in questa destinazione.
Questa categoria include tutte le origini del pubblico al di fuori dei tipi di pubblico generati tramite Segmentation Service. Leggi informazioni sulle diverse origini del pubblico. Alcuni esempi includono:
- i tipi di pubblico per caricamento personalizzati importati in Experience Platform da file CSV,
- pubblico simile,
- pubblico federato,
- tipi di pubblico generati in altre app Experience Platform come Adobe Journey Optimizer,
- e altro ancora.
Tipi di pubblico supportati per tipo di dati sul pubblico:
Tipo e frequenza di esportazione export-type-frequency
Per informazioni sul tipo e sulla frequenza di esportazione della destinazione, consulta la tabella seguente.
Prerequisiti per l’account Google Customer Match google-account-prerequisites
Prima di configurare una destinazione Google Customer Match in Experience Platform, assicurati di aver letto e rispettato i criteri di Google per l’utilizzo di Customer Match, descritti nella documentazione di supporto Google.
Verificare quindi che l’account Google sia configurato per un livello di autorizzazione Standard o superiore. Per informazioni dettagliate, consulta la documentazione di Google Ads.
Elenco consentiti allowlist
Prima di creare la destinazione Google Customer Match in Experience Platform, assicurati che il tuo account Google Ads sia conforme ai Google Customer Match criteri.
I clienti con account conformi vengono inseriti nell’elenco Consentiti automaticamente da Google.
Requisiti di corrispondenza ID id-matching-requirements
Google non richiede l’invio di informazioni personali (PII, personally identifiable information) in chiaro. Pertanto, i tipi di pubblico attivati in Google Customer Match possono essere ricavati da identificatori con hash, ad esempio indirizzi e-mail o numeri di telefono.
A seconda del tipo di ID in cui si effettua l’acquisizione in Adobe Experience Platform, è necessario soddisfare i requisiti corrispondenti.
Comportamento del tipo di chiave durante l’aggiornamento delle mappature di identità key-type-behavior
Google Customer Match utilizza tre categorie di identificatori, denominate tipi chiave, per gestire elenchi clienti separati in Google Ads. Google definisce tre tipi di chiave nel riferimento CustomerMatchUploadKeyType:
CONTACT_INFO: indirizzi e-mail, numeri di telefono e indirizzi e-mailCRM_ID: ID utente personalizzati assegnati dall’inserzionistaMOBILE_ADVERTISING_ID: ID dispositivo mobile (IDFA e GAID)
Puoi mappare le identità da più categorie di tipi chiave nella stessa connessione di destinazione. Google mantiene un elenco clienti separato per ogni tipo di chiave.
Regola di eliminazione: Google elimina un elenco clienti solo quando vengono rimossi dalla destinazione tutti i campi di identità appartenenti a quel tipo di chiave. La rimozione di un campo è sicura purché rimanga mappato almeno un altro campo dello stesso tipo di chiave.
Ad esempio, se email_lc_sha256 e address_info_first_name sono mappati (entrambi appartengono al tipo di chiave CONTACT_INFO), la rimozione di address_info_first_name è sicura. L’elenco clienti CONTACT_INFO è stato mantenuto perché email_lc_sha256 ne fa ancora parte.
- Rimozione di tutti i campi di un tipo di chiave: Se ad esempio
user_idè il tuo unico campoCRM_IDe lo rimuovi, Google elimina l'intero elenco di clientiCRM_ID. L'aggiunta diuser_idin seguito crea un nuovo elenco vuoto. I dati precedenti non sono recuperabili. - Passaggio da un tipo di chiave all'altro: Rimozione di
user_idper passare aaddress_info_first_nameeaddress_info_last_name, quindi annullamento della modifica, eliminazione e ricreazione dell'elenco clienti interessato ogni volta. I dati storici del pubblico vengono persi.
Se devi mantenere attivi più tipi di chiave, puoi creare una connessione di destinazione separata per ogni tipo di chiave. Questo elimina il rischio di rimuovere accidentalmente tutti i campi di un tipo durante la modifica dell’altro.
All’interno del tipo di chiave CONTACT_INFO, è possibile combinare indirizzi di posta elettronica, numeri di telefono e indirizzi di posta nella stessa connessione. Google consiglia questo approccio perché migliora le percentuali di corrispondenza.
Requisiti di hashing del numero di telefono phone-number-hashing-requirements
Esistono due metodi per attivare i numeri di telefono in Google Customer Match:
- Acquisizione di numeri di telefono non elaborati: è possibile acquisire i numeri di telefono non elaborati nel formato E.164 in Experience Platform e vengono automaticamente sottoposti a hashing al momento dell’attivazione. Se si sceglie questa opzione, assicurarsi di inserire sempre i numeri di telefono non elaborati nello spazio dei nomi
Phone_E.164. - Inserimento di numeri di telefono con hash: è possibile inserire i numeri di telefono con hash prima dell’acquisizione in Experience Platform. Se scegli questa opzione, assicurati di acquisire sempre i numeri di telefono con hash nello spazio dei nomi
PHONE_SHA256_E.164.
Phone.Requisiti di hashing delle e-mail hashing-requirements
Puoi aggiungere hash agli indirizzi e-mail prima di acquisirli in Adobe Experience Platform, oppure usare indirizzi e-mail in chiaro in Experience Platform e impostarli come Experience Platform al momento dell’attivazione.
Per ulteriori informazioni sui requisiti di hashing di Google e altre restrizioni all’attivazione, consulta le seguenti sezioni nella documentazione di Google:
Per informazioni sull’acquisizione di indirizzi e-mail in Experience Platform, consulta la panoramica sull’acquisizione batch e la panoramica sull’acquisizione in streaming.
Se scegli di eseguire l’hash degli indirizzi e-mail da solo, assicurati di soddisfare i requisiti di Google, descritti nei collegamenti riportati sopra.
Requisiti di hashing del campo indirizzo address-field-hashing
Quando si mappano campi relativi agli indirizzi a Google Customer Match, Experience Platform inserisce automaticamente l’hash dei valori address_info_first_name e address_info_last_name prima di inviarli a Google. Questo hashing automatico è necessario per rispettare i requisiti di sicurezza e privacy di Google.
not fornisce valori con hash preliminare per address_info_first_name o address_info_last_name. Se fornisci valori con hash già, il processo corrispondente avrà esito negativo.
Utilizzo di spazi dei nomi personalizzati custom-namespaces
Prima di poter utilizzare lo spazio dei nomi User_ID per inviare dati a Google, assicurati di sincronizzare i tuoi identificatori utilizzando gTag. Per informazioni dettagliate, consulta la documentazione ufficiale di Google.
Panoramica video video-overview
Guarda il video seguente per una spiegazione dei vantaggi e di come attivare i dati per Google Customer Match.
Connettersi alla destinazione connect
Per connettersi a questa destinazione, seguire i passaggi descritti nell’esercitazione sulla configurazione della destinazione.
Parametri di connessione parameters
Durante la configurazione di questa destinazione, è necessario fornire le seguenti informazioni:
- Nome: fornisci un nome per questa connessione di destinazione
- Descrizione: fornisci una descrizione per questa connessione di destinazione
- ID account: ID cliente Google Ads. Il formato dell’ID è xxx-xxx-xxxx. Se utilizzi Google Ads Manager Account (My Client Center), non utilizzare il tuo ID account manager. Utilizza invece l’ID cliente di Google Ads.
- L'azione di marketing Combina con PII è selezionata per impostazione predefinita per la destinazione Google Customer Match e non può essere rimossa.
Autenticazione e autorizzazioni authentication-permissions
Quando si collega l’account Google Ads, Google richiede di concedere l’accesso all’applicazione Adobe. Devi approvare l’autorizzazione API di Google Ads in modo che Adobe possa creare e gestire gli elenchi dei clienti. Utilizza un utente di Google Ads con accesso Standard o superiore all’account cliente al quale intendi effettuare l’attivazione. Se utilizzi un account Manager (MCC), accedi con un utente sull’account cliente e fornisci l’ID dell’account cliente (non l’ID MCC).
Se l’autorizzazione Google Ads non viene concessa durante il flusso OAuth, le attivazioni potrebbero non riuscire in un secondo momento a causa di errori provenienti dall’API di Google Ads. Per ulteriori informazioni su come risolvere gli errori relativi alle autorizzazioni, vedere la sezione relativa alla risoluzione dei problemi.
Abilita avvisi enable-alerts
Puoi abilitare gli avvisi per ricevere notifiche sullo stato del flusso di dati verso la tua destinazione. Seleziona un avviso dall’elenco per abbonarti e ricevere notifiche sullo stato del flusso di dati. Per ulteriori informazioni sugli avvisi, consulta la guida su abbonamento a destinazioni avvisi tramite l’interfaccia utente.
Dopo aver fornito i dettagli per la connessione di destinazione, seleziona Avanti.
Attivare tipi di pubblico in questa destinazione activate
- Per attivare i dati, è necessario Visualizza destinazioni, Attiva destinazioni, Visualizza profili e Visualizza segmenti Autorizzazioni di controllo di accesso. Leggi la panoramica sul controllo degli accessi o contatta l'amministratore del prodotto per ottenere le autorizzazioni necessarie.
- Per esportare identità nelle destinazioni, è necessario disporre dell'autorizzazione Visualizza grafo identità Controllo di accesso.
Per istruzioni sull’attivazione dei tipi di pubblico in questa destinazione, consulta Attivare i dati del pubblico nelle destinazioni di esportazione del pubblico in streaming.
Nel passaggio Pianificazione segmento, devi fornire l’ID app quando invii tipi di pubblico IDFA o GAID a Google Customer Match.
Per informazioni dettagliate su come trovare App ID, consulta la documentazione ufficiale di Google o rivolgiti al tuo rappresentante Google.
Mappatura identità: attivazione dei dati del pubblico in Google Customer Match example-gcm
Utilizzare le istruzioni seguenti per selezionare gli spazi dei nomi dell’identità di origine e di destinazione corretti durante l’attivazione dei dati del pubblico in Google Customer Match.
Selezione dei campi di origine:
- Selezionare lo spazio dei nomi
Emailcome identità di origine se gli indirizzi e-mail utilizzati non sono con hash. - Seleziona lo spazio dei nomi
Email_LC_SHA256come identità di origine se esegui l’hashing degli indirizzi e-mail dei clienti al momento dell’acquisizione dei dati in Experience Platform, in base a Google Customer Match requisiti di hashing delle e-mail. - Selezionare lo spazio dei nomi
PHONE_E.164come identità di origine se i dati sono costituiti da numeri di telefono senza hash. Experience Platform eseguirà l’hash dei numeri di telefono per soddisfare i requisiti di Google Customer Match. - Seleziona lo spazio dei nomi
Phone_SHA256_E.164come identità di origine se hai aggiunto l’hashing ai numeri di telefono al momento dell’acquisizione dei dati in Experience Platform, in base ai Google Customer Match requisiti di hashing dei numeri di telefono. - Selezionare lo spazio dei nomi
IDFAcome identità di origine se i dati sono costituiti da Apple ID dispositivo. - Selezionare lo spazio dei nomi
GAIDcome identità di origine se i dati sono costituiti da Android ID dispositivo. - Selezionare lo spazio dei nomi
Customcome identità di origine se i dati sono costituiti da altri tipi di identificatori.
Selezione dei campi di destinazione:
- Selezionare lo spazio dei nomi
Email_LC_SHA256come identità di destinazione quando gli spazi dei nomi di origine sonoEmailoEmail_LC_SHA256. - Selezionare lo spazio dei nomi
Phone_SHA256_E.164come identità di destinazione quando gli spazi dei nomi di origine sonoPHONE_E.164oPhone_SHA256_E.164. - Selezionare gli spazi dei nomi
IDFAoGAIDcome identità di destinazione quando gli spazi dei nomi di origine sonoIDFAoGAID. - Selezionare lo spazio dei nomi
User_IDcome identità di destinazione quando lo spazio dei nomi di origine è personalizzato.
I dati degli spazi dei nomi senza hash vengono automaticamente sottoposti a hashing da Experience Platform al momento dell’attivazione.
L’hash dei dati di origine degli attributi non viene eseguito automaticamente. Se il campo di origine contiene attributi senza hash, selezionare l’opzione Applica trasformazione per impostare Experience Platform per l’hashing automatico dei dati all’attivazione.
Monitorare la destinazione monitor-destination
Dopo la connessione alla destinazione e la definizione di un flusso di dati di destinazione, puoi utilizzare la funzionalità di monitoraggio in Real-Time CDP per ottenere informazioni dettagliate sui record del profilo attivati nella destinazione in ogni esecuzione del flusso di dati.
address_info_first_name, address_info_last_name, address_info_country_code e address_info_postal_code), vengono conteggiate come identità singole separate per ciascun profilo nella pagina di monitoraggio del flusso di dati.Verifica che l’attivazione del pubblico sia avvenuta correttamente verify-activation
Dopo aver completato il flusso di attivazione, passa all’account Google Ads. I tipi di pubblico attivati vengono visualizzati nel tuo account Google come elenchi di clienti. A seconda della dimensione del pubblico, alcuni tipi di pubblico non si popolano a meno che non vi siano più di 100 utenti attivi da distribuire.
Quando si esegue il mapping di un pubblico agli ID mobili IDFA e GAID, Google Customer Match crea un pubblico separato per ogni mapping di ID. L’account Google Ads mostra due segmenti diversi, uno per IDFA e uno per il mapping GAID.
Risoluzione dei problemi troubleshooting
Le percentuali di corrispondenza scendono allo 0% dopo l’attivazione match-rate-reset
Se le percentuali di corrispondenza scendono allo 0% dopo l’attivazione, la causa probabile è che tutti i campi di identità per un tipo di chiave sono stati rimossi dalla connessione di destinazione.
Google elimina un elenco clienti quando tutti i campi appartenenti a un determinato tipo di chiave vengono rimossi da una destinazione. Due scenari attivano questo:
- Rimozione di tutti i campi di un tipo chiave: Se ad esempio
user_idè l’unico campoCRM_IDdella connessione e si rimuove, Google elimina l’elenco clientiCRM_ID. Le percentuali di corrispondenza sono state reimpostate sullo 0% perché Google crea un nuovo elenco di clienti vuoto. - Attivazione/disattivazione di tipi di chiave: Rimozione di tutti i campi di un tipo di chiave per aggiungere campi da un tipo diverso, quindi annullamento della modifica in un secondo momento. In questo modo, ogni volta viene eliminato e ricreato l’elenco dei clienti interessati. I dati storici del pubblico vengono persi.
La rimozione di un singolo campo è sicura purché nella connessione rimanga mappato almeno un altro campo dello stesso tipo di chiave.
Per evitare che ciò si verifichi:
- Non rimuovere tutti i campi di identità per un tipo di chiave in una singola esecuzione dell’attivazione. Mantieni mappato almeno un campo del tipo di chiave interessato.
- Se devi attivare più tipi di chiave, crea connessioni di destinazione separate per ciascun tipo di chiave che punta allo stesso pubblico di origine. Questo elimina il rischio di rimuovere accidentalmente tutti i campi di un tipo durante la modifica dell’altro.
Per ulteriori informazioni, vedere la sezione Comportamento del tipo di chiave durante l’aggiornamento dei mapping di identità.
400 Messaggio di errore di richiesta non valida bad-request
Durante la configurazione di questa destinazione, potrebbe venire visualizzato il seguente errore:
{"message":"Google Customer Match Error: OperationAccessDenied.ACTION_NOT_PERMITTED","code":"400 BAD_REQUEST"}
Questo errore si verifica quando gli account cliente non sono conformi ai prerequisiti. Per risolvere il problema, contattare Google e verificare che l’account sia inserito nell’elenco Consentiti e configurato per un livello di autorizzazione Standard o superiore. Per informazioni dettagliate, consulta la documentazione di Google Ads.
Errore interno del server 500 - Ambiti di autenticazione insufficienti insufficient-scopes
Quando attivi i tipi di pubblico in questa destinazione, potresti ricevere il seguente errore:
{"message":"com.google.api.gax.rpc.PermissionDeniedException: io.grpc.StatusRuntimeException: PERMISSION_DENIED: Request had insufficient authentication scopes.","code":"500 INTERNAL_SERVER_ERROR"}
Questo errore si verifica quando il token OAuth di Google utilizzato per questa connessione di destinazione è stato creato senza l’ambito API richiesto di Google Ads oppure quando l’utente connesso non dispone di autorizzazioni sufficienti sull’account cliente di destinazione.
Per risolvere il problema, effettua le seguenti operazioni:
-
Rigenerare l’autenticazione di Google per questo account di destinazione e assicurarsi di accettare le autorizzazioni Google Ads richieste:
- In Experience Platform, vai a Destinazioni > Account
- Individuare l’account Google Customer Match
- Seleziona Altre azioni (⋯) > Modifica > Rinnova
- Completa il flusso di accesso e consenso di Google, approvando tutte le autorizzazioni richieste
-
Se gestisci gli annunci tramite un account Manager (MCC), verifica di eseguire l’autenticazione con un utente con accesso Standard o superiore all’account cliente di destinazione e che l’ID account configurato nella destinazione sia l’ID account cliente (non l’ID MCC).
-
Rieseguire l’attivazione.
Se il problema persiste:
- Verifica che il tuo account Google Ads sia inserito nell’elenco Consentiti per Customer Match e soddisfi i requisiti dei criteri.
- Verificare che il livello di accesso dell’utente sia Standard o superiore nell’account cliente di Google Ads. Per informazioni dettagliate, consulta la documentazione di Google Ads.