Configurer et utiliser la résolution d'entités dans BigQuery

LiveRamp

Prérequis

• Configurez l'identité intégrée LiveRamp dans BigQuery. Pour en savoir plus, consultez la section Activer l'identité intégrée LiveRamp dans BigQuery.
• Coordonnez les identifiants d'API avec LiveRamp pour les utiliser avec l'identité intégrée. Pour en savoir plus, consultez la section Authentification.

Configuration

Suivez la procédure ci-dessous lorsque vous utilisez l'identité intégrée LiveRamp pour la première fois. Une fois la configuration terminée, seules la table d'entrée et la table de métadonnées doivent être modifiées entre les exécutions.

Créer une table d'entrée

Créez une table dans l'ensemble de données d'entrée. Renseignez la table avec les RampID, les domaines cibles et les types cibles. Pour obtenir plus d'informations et des exemples, consultez la page Colonnes et descriptions des tables d'entrée.

Créer une table de métadonnées

La table de métadonnées permet de contrôler l'exécution de l'identité intégrée LiveRamp sur BigQuery. Créez une table de métadonnées dans l'ensemble de données d'entrée. Renseignez la table de métadonnées avec les ID client, les modes d'exécution, les domaines cibles et les types cibles. Pour obtenir plus d'informations et des exemples, consultez la page Colonnes et descriptions des tables de métadonnées.

Partager des tables avec LiveRamp

Accordez au compte de service LiveRamp Google Cloud un accès permettant d'afficher et de traiter les données de votre ensemble de données d'entrée. Pour obtenir plus d'informations et des exemples, consultez Partager des tables et des ensembles de données avec LiveRamp.

Exécuter un job d'identité intégré

Pour exécuter un job d'identité intégré avec LiveRamp dans BigQuery, procédez comme suit :

1. Vérifiez que tous les RampID encodés dans votre domaine se trouvent dans la table d'entrée.
2. Vérifiez que votre table de métadonnées est toujours exacte avant d'exécuter le job.
3. Contactez LiveRampIdentitySupport@liveramp.com pour demander un processus de job. Incluez l'ID du projet, l'ID de l'ensemble de données et l'ID de la table (le cas échéant) pour votre table d'entrée, votre table de métadonnées et votre ensemble de données de sortie. Pour en savoir plus, consultez la page Notifier LiveRamp pour lancer le transcodage.

Les résultats sont généralement envoyés à votre ensemble de données de sortie dans un délai de trois jours ouvrés.

Compatibilité avec LiveRamp

En cas de problèmes de compatibilité, contactez l'assistance LiveRamp Identity.

Facturation LiveRamp

LiveRamp se charge de gérer la facturation pour ce qui concerne la résolution d'entités.

TransUnion

Prérequis

• Contactez l'assistance TransUnion Cloud pour conclure un accord et accéder au service. Indiquez les détails de votre ID de projetGoogle Cloud , des types de données d'entrée, du cas d'utilisation et du volume de données.
• L'assistance TransUnion Cloud active le service pour votre projet Google Cloud et partage un guide d'implémentation détaillé qui inclut les données de sortie disponibles.

Configuration

Les étapes suivantes sont requises lorsque vous utilisez le service TruAudience Identity Resolution and Enrichment de TransUnion dans votre environnement BigQuery.

Créer une connexion externe

Créez une connexion à une source de données externe de type Modèles distants Vertex AI, fonctions à distance et BigLake (ressource Cloud). Vous utiliserez cette connexion pour déclencher le service de résolution des identités hébergé dans le compte TransUnion Google Cloud depuis votre compteGoogle Cloud .

Copiez l'ID de connexion et l'ID du compte de service, puis partagez-les avec l'équipe de livraison client de TransUnion.

Créer une fonction distante

Créez une fonction distante qui interagit avec le point de terminaison de l'orchestrateur de services hébergé sur le projet Google Cloud TransUnion pour transmettre les métadonnées nécessaires (y compris les mappages de schéma) au service TransUnion. Utilisez l'ID de connexion de la connexion externe que vous avez créée et le point de terminaison de la fonction Cloud hébergée par TransUnion, partagé par l'équipe de livraison client de TransUnion.

Créer une table d'entrée

Créez une table dans l'ensemble de données d'entrée. TransUnion accepte les noms, les adresses postales, les adresses e-mail, les numéros de téléphone, les dates de naissance, les adresses IPv4 et les ID d'appareil comme entrées. Suivez les consignes de mise en forme du guide d'implémentation que TransUnion vous a envoyé.

Créer une table de métadonnées

Créez une table de métadonnées qui stockera la configuration requise par le service de résolution des identités pour traiter les données, y compris les mappages de schéma. Pour obtenir des détails et des exemples, consultez le guide d'implémentation que TransUnion vous a envoyé.

Créer un tableau d'état des tâches

Créez une table qui recevra des informations sur le traitement d'un lot d'entrée. Vous pouvez interroger cette table pour déclencher d'autres processus en aval dans votre pipeline. Les états de job possibles sont les suivants : RUNNING, COMPLETED ou ERROR.

Créer l'appel de service

Procédez comme suit pour appeler le service de résolution d'identité TransUnion après avoir collecté toutes les métadonnées, les avoir empaquetées et les avoir transmises au point de terminaison de la fonction Cloud d'invocation hébergé par 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;

Créer la table de sortie correspondante

Exécutez le script SQL suivant pour créer la table de sortie correspondante. Il s'agit de la sortie standard de l'application, qui inclut les indicateurs de correspondance, les scores, les ID individuels persistants et les ID de foyer.

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

Configurer les métadonnées

Suivez le guide d'implémentation que TransUnion vous a fourni pour mapper votre schéma d'entrée au schéma d'application. Ces métadonnées configurent également la génération d'ID de collaboration, qui sont des identifiants non persistants partageables pouvant être utilisés dans les data clean rooms.

Accorder un accès en lecture et en écriture

Obtenez l'ID du compte de service de la connexion Apache Spark auprès de l'équipe TransUnion chargée de la livraison aux clients, puis accordez-lui un accès en lecture et en écriture à l'ensemble de données contenant les tables d'entrée et de sortie. Nous vous recommandons de fournir l'ID du compte de service avec un rôle Éditeur de données BigQuery sur l'ensemble de données.

Appeler l'application

Vous pouvez appeler l'application depuis votre environnement en exécutant le script suivant.

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

Assistance

Pour les problèmes techniques, contactez l'assistance TransUnion Cloud.

Facturation et utilisation

TransUnion suit l'utilisation de l'application et l'utilise à des fins de facturation. Les clients actifs peuvent contacter leur représentant TransUnion pour en savoir plus.