Configurare e utilizzare la risoluzione delle entità in BigQuery

LiveRamp

Prerequisiti di LiveRamp

Prima di configurare la risoluzione delle entità LiveRamp in BigQuery, completa i seguenti prerequisiti:

• Configura LiveRamp Embedded Identity in BigQuery. Per ulteriori informazioni, vedi Attivare l'identità incorporata di LiveRamp in BigQuery.
• Coordina con LiveRamp l'attivazione delle credenziali API che funzionano con Embedded Identity. Per saperne di più, consulta Autenticazione.

Configurare la risoluzione delle entità LiveRamp

Quando utilizzi LiveRamp Embedded Identity per la prima volta, completa i seguenti passaggi di configurazione. Per le esecuzioni successive, devi solo aggiornare la tabella di input e la tabella dei metadati.

Crea una tabella di input LiveRamp

Crea una tabella nel set di dati di input e compilala con le seguenti colonne:

• RampIDs
• Domini di destinazione
• Tipi di target

Per ulteriori informazioni sullo schema della tabella di input, consulta Colonne e descrizioni della tabella di input.

Crea una tabella di metadati LiveRamp

Per controllare l'esecuzione di LiveRamp Embedded Identity in BigQuery, crea una tabella di metadati nel set di dati di input. Compila la tabella dei metadati con le seguenti colonne di configurazione:

• ID client
• Modalità di esecuzione
• Domini di destinazione
• Tipi di target

Per ulteriori informazioni sullo schema della tabella dei metadati, consulta Colonne e descrizioni della tabella dei metadati.

Concedere l'accesso al set di dati a LiveRamp

Dopo aver creato le tabelle richieste, concedi a LiveRamp l'accesso per visualizzare ed elaborare i dati nel set di dati di input. Concedi l'accesso al service account LiveRamp Google Cloud al set di dati. Per saperne di più sulla condivisione dei set di dati, consulta Condividere tabelle e set di dati con LiveRamp.

Esegui un job di risoluzione delle entità LiveRamp

Dopo aver configurato le tabelle e concesso l'accesso al set di dati, esegui un job di risoluzione delle entità con LiveRamp in BigQuery:

1. Nella tabella di input, verifica che siano presenti tutti gli ID rampa per il tuo dominio.
2. Prima di eseguire il job, verifica che la configurazione della tabella dei metadati sia accurata.
3. Per inviare una richiesta di elaborazione del job, invia un'email a LiveRampIdentitySupport@liveramp.com. Nella richiesta, includi l'ID progetto, l'ID set di dati e gli ID tabella applicabili per la tabella di input, la tabella dei metadati e il set di dati di output.

In genere LiveRamp fornisce i risultati della corrispondenza al set di dati di output entro tre giorni lavorativi.

Ricevere assistenza e informazioni sulla fatturazione di LiveRamp

LiveRamp gestisce l'assistenza tecnica e la fatturazione per l'identità incorporata in BigQuery:

• Assistenza tecnica: contatta l'assistenza per l'identità di LiveRamp per ricevere assistenza con la configurazione o l'esecuzione dei job.
• Fatturazione: LiveRamp ti fattura direttamente l'utilizzo della risoluzione delle entità.

TransUnion

Prerequisiti di TransUnion

Prima di configurare la risoluzione delle entità TransUnion in BigQuery, invia un'email all'indirizzo TransUnion Cloud Support per firmare un contratto di accesso al servizio. Nella richiesta, fornisci le seguenti informazioni:

• Il tuo Google Cloud ID progetto
• Tipi di dati di input
• Caso d'uso previsto
• Volume di dati stimato

Dopo che l'assistenza cloud di TransUnion approva la tua richiesta, attiva il servizio per il tuo progetto Google Cloud e condivide una guida all'implementazione che include gli schemi di output disponibili.

Configurare la risoluzione delle entità TransUnion

Quando utilizzi il servizio di risoluzione e arricchimento dell'identità TransUnion TruAudience in BigQuery per la prima volta, completa i seguenti passaggi di configurazione.

Crea una connessione esterna

Per connettere il tuo account Google Cloud al servizio di risoluzione dell'identità ospitato nell'account Google Cloud TransUnion, crea una connessione alle risorse Cloud. Quando configuri la connessione, seleziona Modelli remoti di Vertex AI, funzioni remote e BigLake (risorsa Cloud) come tipo di connessione.

Dopo aver creato la connessione, copia l'ID connessione e l'ID account di servizio, quindi condividi questi identificatori con il team di distribuzione clienti di TransUnion.

Creare una funzione remota

Per trasmettere le mappature dello schema e i metadati di configurazione all'endpoint dell'orchestratore del servizio TransUnion, crea una funzione remota. Quando crei la funzione remota, specifica l'ID connessione della tua connessione esterna e l'URL dell'endpoint della funzione Cloud Run che il team di distribuzione dei clienti di TransUnion ha condiviso con te.

Crea una tabella di input TransUnion

Crea una tabella di input nel set di dati di input. TransUnion supporta i seguenti attributi entità come colonne di input:

• Nome
• Indirizzo postale
• Indirizzo email
• Numero di telefono
• Data di nascita
• Indirizzo IPv4
• ID dispositivo

Segui le linee guida relative a schema e formattazione riportate nella guida all'implementazione che TransUnion ti ha inviato. Se mappi ogni tabella di input a un parametro config_id distinto nella tabella dei metadati, puoi utilizzare più tabelle di input.

Crea una tabella di metadati TransUnion

Per archiviare i mapping e la configurazione dello schema richiesti dal servizio di risoluzione dell'identità, crea una tabella di metadati nel set di dati di input. Per ulteriori informazioni sullo schema dei metadati, consulta la guida all'implementazione che TransUnion ha condiviso con te.

Crea una tabella dello stato dei job

Per ricevere aggiornamenti sull'elaborazione batch, crea una tabella di stato del job nel tuo set di dati. Per monitorare i job e attivare i processi downstream nella pipeline, esegui una query su questa tabella di stato dei job. La tabella registra i seguenti stati:

• RUNNING: il servizio di risoluzione dell'identità sta elaborando il batch.
• COMPLETED: il servizio ha terminato l'elaborazione del batch e ha scritto i risultati nella tabella di output.
• ERROR: il servizio ha riscontrato un errore durante l'elaborazione del batch.

Crea la procedura di chiamata del servizio

La stored procedure TransUnion_get_identities raggruppa i metadati di configurazione e richiama l'endpoint della funzione Cloud Run di TransUnion. Per creare questa stored procedure, esegui la seguente istruzione SQL:

-- create service invocation procedure
CREATE OR REPLACE
  PROCEDURE
    `PROJECT_ID.DATASET_ID.TransUnion_get_identities`(metadata_table STRING, config_id STRING)
      begin
        declare sql_query STRING;

declare json_result STRING;
declare base64_result STRING;

SET sql_query =
  '''select to_json_string(array_agg(struct(config_id,key,value))) from `''' || metadata_table
  || '''` where  config_id="''' || config_id || '''" ''';

EXECUTE immediate sql_query INTO json_result;

SET base64_result = (SELECT to_base64(CAST(json_result AS bytes)));

SELECT
  `PROJECT_ID.DATASET_ID.remote_call_TransUnion_er`(
    base64_result);
END;

Sostituisci quanto segue:

• PROJECT_ID: il tuo ID progetto Google Cloud .
• DATASET_ID: l'ID del set di dati in cui crei la procedura e la funzione remota.

Crea la tabella di output corrispondente

La tabella di output corrispondente memorizza i risultati della risoluzione delle entità di TransUnion, inclusi flag di corrispondenza, punteggi di collegamento, ID individuali persistenti e ID nucleo familiare. Per creare la tabella di output corrispondente, esegui la seguente istruzione SQL:

-- create output table
CREATE TABLE `PROJECT_ID.DATASET_ID.TransUnion_identity_output`(
  batchid STRING,
  uniqueid STRING,
  ekey STRING,
  hhid STRING,
  collaborationid STRING,
  firstnamematch STRING,
  lastnamematch STRING,
  addressmatches STRING,
  addresslinkagescores STRING,
  phonematches STRING,
  phonelinkagescores STRING,
  emailmatches STRING,
  emaillinkagescores STRING,
  dobmatches STRING,
  doblinkagescore STRING,
  ipmatches STRING,
  iplinkagescore STRING,
  devicematches STRING,
  devicelinkagescore STRING,
  lastprocessed STRING);

Sostituisci quanto segue:

• PROJECT_ID: il tuo ID progetto Google Cloud .
• DATASET_ID: l'ID del set di dati in cui crei la tabella di output corrispondente.

Configura i metadati della mappatura dello schema

Per mappare lo schema di input allo schema dell'applicazione TransUnion, segui le istruzioni nella guida all'implementazione che TransUnion ti ha inviato. Questi metadati configurano anche il modo in cui il servizio genera gli ID collaborazione, che sono identificatori condivisibili e non persistenti che puoi utilizzare nelle data clean room.

Concedere l'accesso al set di dati a TransUnion

Dopo aver creato le tabelle e la stored procedure richieste, concedi a TransUnion l'accesso per leggere i dati di input e scrivere i risultati della corrispondenza. Ottieni l'ID account di servizio di connessione Apache Spark dal team di distribuzione clienti di TransUnion. Poi, concedi a questo account di servizio il ruolo Editor dati BigQuery (roles/bigquery.dataEditor) nel set di dati contenente le tabelle di input e output.

Esegui un job di risoluzione delle entità TransUnion

Dopo aver configurato le tabelle e concesso l'accesso al set di dati, puoi avviare un'esecuzione batch della risoluzione delle entità. Per richiamare il servizio di risoluzione delle entità, chiama la stored procedure TransUnion_get_identities:

CALL `PROJECT_ID.DATASET_ID.TransUnion_get_identities`(
  "PROJECT_ID.DATASET_ID.TransUnion_er_metadata",
  "CONFIG_ID");

Sostituisci quanto segue:

• PROJECT_ID: il tuo ID progetto Google Cloud .
• DATASET_ID: l'ID del set di dati che contiene la tabella dei metadati e la stored procedure.
• CONFIG_ID: l'ID configurazione dell'esecuzione batch, ad esempio "1".

Ricevi assistenza e dati di fatturazione di TransUnion

Per assistenza in merito a problemi tecnici o domande sulla fatturazione relative alla risoluzione e all'arricchimento dell'identità TruAudience in BigQuery, contatta direttamente TransUnion:

• Assistenza tecnica: contatta l'assistenza TransUnion Cloud per ricevere aiuto con la configurazione, il mapping dello schema o la risoluzione dei problemi.
• Fatturazione: TransUnion monitora l'utilizzo del servizio a fini di fatturazione. Contatta il tuo rappresentante per le consegne di TransUnion per i dettagli su account e prezzi.