Configurare e utilizzare la risoluzione delle entità in BigQuery

LiveRamp

Prerequisiti

• Configura LiveRamp Embedded Identity in BigQuery. Per ulteriori informazioni, vedi Abilitare l'identità incorporata di LiveRamp in BigQuery.
• Coordina con LiveRamp l'attivazione delle credenziali API per l'utilizzo con Embedded Identity. Per ulteriori informazioni, vedi Autenticazione.

Configurazione

I seguenti passaggi sono necessari quando utilizzi LiveRamp Embedded Identity per la prima volta. Al termine della configurazione, tra un'esecuzione e l'altra devono essere modificate solo la tabella di input e la tabella dei metadati.

Crea una tabella di input

Crea una tabella nel set di dati di input. Compila la tabella con RampID, domini target e tipi di target. Per dettagli ed esempi, vedi Colonne e descrizioni della tabella di input.

Crea una tabella di metadati

La tabella dei metadati viene utilizzata per controllare l'esecuzione di LiveRamp Embedded Identity su BigQuery. Crea una tabella di metadati nel set di dati di input. Compila la tabella dei metadati con ID client, modalità di esecuzione, domini di destinazione e tipi di targeting. Per dettagli ed esempi, vedi Colonne e descrizioni della tabella dei metadati.

Condividere tabelle con LiveRamp

Concedi all'account di servizio LiveRamp Google Cloud l'accesso per visualizzare ed elaborare i dati nel set di dati di input. Per dettagli ed esempi, vedi Condividere tabelle e set di dati con LiveRamp.

Esegui un job di identità incorporata

Per eseguire un job di identità incorporata con LiveRamp in BigQuery:

1. Verifica che tutti i RampID codificati nel tuo dominio si trovino nella tabella di input.
2. Prima di eseguire il job, verifica che la tabella dei metadati sia ancora accurata.
3. Contatta LiveRampIdentitySupport@liveramp.com con una richiesta di elaborazione del job. Includi l'ID progetto, l'ID set di dati e l'ID tabella (se applicabile) per la tabella di input, la tabella dei metadati e il set di dati di output. Per saperne di più, consulta Notifica a LiveRamp di avviare la transcodifica.

I risultati vengono generalmente inviati al set di dati di output entro tre giorni lavorativi.

Assistenza LiveRamp

Per problemi di assistenza, contatta l'assistenza per l'identità LiveRamp.

Fatturazione LiveRamp

LiveRamp gestisce la fatturazione per la risoluzione delle entità.

TransUnion

Prerequisiti

• Contatta l'assistenza TransUnion Cloud per eseguire un contratto per accedere al servizio. Fornisci i dettagli del tuo Google Cloud ID progetto, i tipi di dati di input, il caso d'uso e il volume di dati.
• L'assistenza cloud di TransUnion abilita il servizio per il tuo progetto Google Cloud e condivide una guida all'implementazione dettagliata che include i dati di output disponibili.

Configurazione

I seguenti passaggi sono necessari quando utilizzi il servizio di risoluzione e arricchimento dell'identità TruAudience di TransUnion nel tuo ambiente BigQuery.

Crea una connessione esterna

Crea una connessione a un'origine dati esterna di tipo Modelli remoti di Vertex AI, funzioni remote e BigLake (risorsa Cloud). Utilizzerai questa connessione per attivare il servizio di risoluzione dell'identità ospitato nell'account TransUnion Google Cloud dal tuo accountGoogle Cloud .

Copia l'ID connessione e l'ID account di servizio e condividili con il team di distribuzione clienti di TransUnion.

Creare una funzione remota

Crea una funzione remota che interagisce con l'endpoint dell'orchestratore di servizi ospitato nel progetto Google Cloud TransUnion per trasmettere i metadati necessari (inclusi i mapping dello schema) al servizio TransUnion. Utilizza l'ID connessione della connessione esterna che hai creato e l'endpoint della funzione cloud ospitata da TransUnion condiviso dal team di distribuzione clienti di TransUnion.

Crea una tabella di input

Crea una tabella nel set di dati di input. TransUnion supporta nome, indirizzo postale, email, telefono, data di nascita, indirizzo IPv4 e ID dispositivo come input. Segui le linee guida di formattazione riportate nella guida all'implementazione che TransUnion ti ha inviato.

Crea una tabella di metadati

Crea una tabella di metadati che memorizzi la configurazione richiesta dal servizio di risoluzione delle identità per elaborare i dati, incluse le mappature dello schema. Per dettagli ed esempi, consulta la guida all'implementazione che TransUnion ha condiviso con te.

Creare una tabella dello stato del job

Crea una tabella che riceverà aggiornamenti sull'elaborazione di un batch di input. Puoi eseguire query su questa tabella per attivare altri processi downstream nella pipeline. Gli stati del job possibili sono i seguenti: RUNNING, COMPLETED o ERROR.

Crea la chiamata al servizio

Utilizza la seguente procedura per chiamare il servizio di risoluzione dell'identità TransUnion dopo aver raccolto tutti i metadati, averli pacchettizzati e averli passati all'endpoint della funzione cloud di invocazione ospitata da TransUnion.

-- 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;

Crea la tabella di output delle corrispondenze

Esegui il seguente script SQL per creare la tabella di output corrispondente. Questo è l'output standard dell'applicazione, che include indicatori di corrispondenza, punteggi, ID individuali persistenti e ID nucleo familiare.

-- 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);

Configura i metadati

Segui la guida all'implementazione che TransUnion ti ha inviato per mappare lo schema di input allo schema dell'applicazione. Questi metadati configurano anche la generazione di ID di collaborazione, che sono identificatori non persistenti condivisibili che possono essere utilizzati nelle data clean room.

Concedi accesso in lettura e scrittura

Ottieni l'ID account di servizio della connessione Apache Spark dal team di distribuzione clienti di TransUnion e concedigli l'accesso in lettura e scrittura al set di dati contenente le tabelle di input e output. Ti consigliamo di fornire l'ID account di servizio con un ruolo Editor dati BigQuery nel set di dati.

Richiamare l'applicazione

Puoi richiamare l'applicazione dall'interno del tuo ambiente eseguendo lo script seguente.

call `<project_id>.<dataset_id>.TransUnion_get_identities`("<project_id>.<dataset_id>.TransUnion_er_metadata","1");
-- using metadata table, and 1 = config_id for the batch run

Assistenza

Per problemi tecnici, contatta l'assistenza TransUnion Cloud.

Fatturazione e utilizzo

TransUnion monitora l'utilizzo dell'applicazione e lo utilizza a fini di fatturazione. I clienti attivi possono contattare il proprio rappresentante per le consegne di TransUnion per ulteriori informazioni.