LiveRamp MAP propre room

LiveRamp (anciennement Habu) fournit une solution de collaboration de données sécurisée qui permet aux annonceurs d’utiliser des données où qu’elles se trouvent. Cette solution prend en charge un large éventail de cas d’usage dans la planification, le ciblage et la mesure.

Cette fonctionnalité est basée sur la plateforme d’informatique confidentielle Azure (ACC). Il permet aux clients Microsoft Advertising de :

  • Exécuter des requêtes personnalisées pour analyser des scénarios de mesure
  • Générer des insights actionnables
  • Créer des audiences personnalisées pour l’activation de campagne

Tous les traitements de données se produisent dans des environnements d’exécution approuvés (TEE) basés sur le matériel. Cela garantit que les données restent privées et sécurisées.

Signaux de l’annonceur chargés dans la salle de propre :

  • Restez dans la instance LiveRamp dédiée de l’annonceur
  • Ne sont pas accessibles ou exportables par Microsoft

L’analyse s’exécute dans le TEE sur des dimensions sélectionnées, telles que des campagnes ou des intervalles de temps. Les résultats sont agrégés et rendus anonymes pour répondre aux exigences strictes en matière de confidentialité.

Sources de données

Les données des événements de campagne Microsoft Advertising sont chiffrées et stockées sur une infrastructure de Azure gérée par Microsoft. Ces données peuvent provenir de campagnes MAP (Microsoft Advertising Platform) ou Microsoft Monetize.

Vous pouvez référencer ces données via les tableaux suivants :

  • Trafic map (Microsoft Advertising Platform)
  • Microsoft Monétiser le trafic
  • Tables de données de conversion
  • Appartenance au segment d’audience

Toutes les tables utilisent un schéma plat. Chaque colonne comprend :

  • Nom
  • Type de données
  • Description

La collaboration de données se produit dans les limites de confidentialité de la salle de propre et suit les contraintes k-min d’entrée et de sortie de Microsoft Advertising.

Les données d’événement chiffrées sont automatiquement mises à disposition quotidiennement dans la salle de propre LiveRamp. Les annonceurs ou leurs partenaires peuvent également charger des données et les rejoindre à l’aide de requêtes SQL ( appelées questions).

Actuellement, seules les jointures exactes sur les e-mails hachés (HEM) sont prises en charge. D’autres identificateurs peuvent être pris en charge à l’avenir.

Tables de trafic de la plateforme Microsoft Advertising (MAP)

Ces tableaux incluent les événements de trafic (impressions et clics) provenant de campagnes MAP ajoutées à la salle propre instance.

Les types de campagnes pris en charge sont les suivants :

  • Recherche
  • Audience
  • Achats
  • Hôtel
  • Performances maximales

map_ad_events table

Nom de colonne Type de données Description Types de campagnes pris en charge
rguid STRING Identificateur unique 128 bits pour une demande d’annonce. tous
date_time LONG (horodatage Unix) Date et heure de l’événement au format UTC. tous
event_type_id INTEGER Identificateur du type d’événement. Valeurs valides : 1 = Impressions, 2 = Clics.
hashed_email STRING E-mail haché SHA256 représentant l’utilisateur. tous
hashed_ip_address STRING Adresse IP hachée SHA256 représentant l’utilisateur. tous
country STRING Code de pays de l’événement (par exemple, États-Unis, CA). tous
Région STRING Région géographique de l’événement (par exemple, l’état aux États-Unis). tous
operating_system STRING Système d’exploitation de l’appareil. tous
Navigateur STRING Navigateur utilisé pour l’événement. tous
publisher_id INTEGER Identificateur unique de l’éditeur. tous
publisher_name STRING Nom lisible par l’utilisateur de l’éditeur. tous
site_domain STRING Identificateur de site le plus granulaire disponible. tous
advertiser_account_id INTEGER MAP : identificateur unique de l’annonceur. tous
campaign_id LONG MAP : identificateur unique de la campagne. tous
ad_group_id LONG MAP : identificateur unique du groupe d’annonces.
ad_id LONG MAP : identificateur unique de la publicité (créatif).
device_type_id INTEGER Identificateur du type d’appareil. tous
device_type_name STRING Type d’appareil lisible par l’utilisateur (par exemple, mobile, PC). tous
postal_code STRING Code postal où l’événement s’est produit (si disponible). tous
bidded_keyword STRING Mot clé ciblé par la campagne gagnante. Recherche
query_id STRING Identificateur d’une chaîne de requête unique. Recherche
Passer DECIMAL Coût du média (CPM). tous
advertiser_account_name STRING MAP : nom de l’annonceur lisible par l’utilisateur. tous
campaign_name STRING MAP : nom de la campagne lisible par l’utilisateur. tous
ad_group_name STRING MAP : nom du groupe d’annonces lisible par l’utilisateur.
start_date TIMESTAMP Date de début de la campagne ou du groupe d’annonces.
end_date TIMESTAMP Date de fin de la campagne ou du groupe d’annonces.
record_date STRING Date à laquelle l’enregistrement a été collecté. tous
campaign_type STRING Type de campagne (par exemple, SWF, AWF). tous
ad_group_type STRING Type de groupe d’annonces (par exemple, Standard de recherche, Recherche dynamique).
ad_group_price_type STRING Type de tarification du groupe d’annonces (par exemple, CPC, CPM, CPA).
asset_group_id INTEGER Identificateur du groupe de ressources. Pmax
asset_group_name STRING Nom du groupe de ressources. Pmax
asset_group_start_date TIMESTAMP Date de début du groupe de ressources. Pmax
asset_group_end_date TIMESTAMP Date de fin du groupe de ressources. Pmax
event_type_name STRING Nom du type d’événement lisible par l’utilisateur (par exemple, impression, clic, affichage).

Microsoft Monétiser les tables de trafic

Ces tableaux incluent des données d’impression et de clics pour les articles de ligne XBox directement vendus.

monetize_ad_events table

Nom de colonne Type de données Description
auction_id_64 LONG Identificateur unique 64 bits pour une enchère.
date_time LONG (horodatage Unix) Date et heure de l’événement au format UTC.
event_type INTEGER Identificateur du type d’événement (par exemple, impression, clic).
hashed_email STRING E-mail haché SHA256 représentant l’utilisateur.
hashed_ip_address STRING Adresse IP hachée SHA256 représentant l’utilisateur.
country STRING Code du pays de l’événement (par exemple, États-Unis, CA).
Région STRING Région géographique de l’événement (par exemple, l’état aux États-Unis).
operating_system STRING Système d’exploitation de l’appareil.
Navigateur STRING Navigateur utilisé pour l’événement.
publisher_id INTEGER Identificateur unique de l’éditeur.
publisher_name STRING Nom lisible par l’utilisateur de l’éditeur.
site_domain STRING Identificateur de site le plus granulaire disponible.
advertiser_id INTEGER Xandr : identificateur unique de l’annonceur.
insertion_order_id INTEGER Xandr : identificateur unique pour l’ordre d’insertion.
line_item_id INTEGER Xandr : identificateur unique de l’élément de ligne.
creative_id INTEGER Xandr : identificateur unique pour le créatif.
device_unique_id STRING Identificateur unique de l’appareil.
device_type_id INTEGER Identificateur du type d’appareil.
device_type_name STRING Type d’appareil lisible par l’utilisateur (par exemple, mobile, PC).
postal_code STRING Code postal où l’événement s’est produit (si disponible).
media_cost DECIMAL Coût du média (CPM).
advertiser_name STRING Xandr : nom de l’annonceur.
insertion_order_name STRING Xandr : nom de l’ordre d’insertion.
line_item_name STRING Xandr : nom de l’élément de ligne.
start_date LONG Date de début de l’élément de ligne.
end_date LONG Date de fin de l’élément de ligne.
line_item_type STRING Type de l’élément de ligne (par exemple, bannière, native).
line_item_price_type STRING Type de tarification utilisé par l’élément de ligne (par exemple, CPM).
split_id INTEGER Identificateur du fractionnement ciblé par l’enchère.
split_name STRING Nom du fractionnement ciblé.
Visible INT32 Indique si l’événement publicitaire était visible.
booked_revenue_usd DOUBLE Budget remis pour l’événement publicitaire.
creative_name STRING Nom du créatif défini par l’annonceur.
creative_type STRING Type de création (par exemple, bannière, native, vidéo, audio).
placement_id INTEGER Identificateur du placement où l’annonce a été servie.
placement_group STRING Groupe de placement défini par le serveur de publication.
placement_name STRING Nom défini par le serveur de publication du placement.

Tables de données de conversion MAP

Ces tables incluent les deux :

  • Conversions (attributs) exposées à des annonces
  • Conversions non exposées aux annonces (non attribuées)

Les sources de données sont les suivantes :

  • Suivi des événements universels (UET)
  • Événements de serveur à serveur (S2S) de suivi des conversions
  • Conversions hors connexion
  • Événements du Kit de développement logiciel (SDK) de suivi des conversions
  • Événements d’API de conversion

Une conversion est considérée comme ad-attribute si un utilisateur a reçu un événement de trafic dans la fenêtre de recherche arrière de la campagne (par défaut : 30 jours) avant la conversion.

map_attributed_conversion_events table

Nom de colonne Type de données Description
RGUID STRING RGUID de l’événement attribué ; correspond à l’impression ou au clic associé.
event_timestamp LONG Horodatage UTC du moment où l’événement d’origine s’est produit.
conversion_timestamp LONG Horodatage UTC du moment où la conversion s’est produite.
campaign_id LONG Campagne MAP associée à la conversion.
ad_id LONG Annonce MAP associée à la conversion.
goal_id LONG ID d’objectif de MAP.
goal_name STRING Nom de l’objectif ou de la balise de MAP.
domaine STRING Domaine où l’événement s’est produit.
hashed_email STRING E-mail haché associé à l’événement (via la recherche UMS s’il n’est pas présent).
goal_value DOUBLE Valeur d’objectif monétaire ou non monétaire définie dans MAP.
goal_currency_code STRING Devise de la valeur de l’objectif.
goal_value_microcents LONG Valeur d’objectif en microcents.
iso_country_code STRING Code de pays ISO de l’utilisateur au moment de l’événement.
goal_lookback_days INT Fenêtre de recherche arrière configurée pour l’objectif.
ms_click_id STRING Cliquez sur ID associé à l’événement.

map_raw_conversion_events table

Nom de colonne Type de données Description
event_timestamp LONG Heure à laquelle l’événement de suivi des conversions s’est produit.
collected_timestamp LONG Heure à laquelle l’événement de suivi des conversions a été collecté pour les événements S2S et/ou CAPI.
tag_id LONG ID de balise de l’événement (indiqué dans l’interface utilisateur MAP).
tag_name STRING Nom de la balise de l’événement (indiqué dans l’interface utilisateur MAP).
event_source STRING Source de l’événement (par exemple, UET, UETS2S, CAPI).
domaine STRING Domaine où l’événement s’est produit.
hashed_email STRING E-mail haché associé à l’événement (via la recherche UMS s’il n’est pas déjà présent).
iso_country_code STRING Code de pays ISO de l’utilisateur au moment de l’événement.
ms_click_id STRING Cliquez sur ID associé à l’événement.

map_goal_achieved_conversion_events table

Nom de colonne Type de données Description
event_timestamp LONG Heure à laquelle l’événement de suivi des conversions s’est produit.
tag_id LONG ID de balise de suivi des conversions associé à l’objectif.
goal_id LONG ID d’objectif de l’événement (indiqué dans l’interface utilisateur MAP).
goal_name STRING Nom de l’objectif de l’événement (indiqué dans l’interface utilisateur MAP).
goal_value DOUBLE Valeur d’objectif monétaire ou non monétaire définie dans MAP.
goal_currency_code STRING Devise de l’objectif défini dans MAP.
goal_value_microcents LONG Valeur d’objectif en microcents.
goal_lookback_days INT Fenêtre de recherche de dernier clic configurée pour l’objectif.
event_source STRING Source de l’événement (par exemple, UET, UETS2S, CAPI).
domaine STRING Domaine où l’événement s’est produit.
hashed_email STRING E-mail haché associé à l’événement (via la recherche UMS s’il n’est pas déjà présent).
iso_country_code STRING Code de pays ISO de l’utilisateur au moment de l’événement.
ms_click_id STRING Cliquez sur ID associé à l’événement.

Monétiser les tables de données de conversion

Ce tableau contient les événements d’achat du Xbox Store associés à monétiser les éléments de ligne.

Les conversions exposées par la publicité et non exposées à la publicité sont incluses.

Une conversion est considérée comme ad-attribute si un utilisateur a reçu un événement de trafic dans la fenêtre de recherche différée configurée (1 à 14 jours) avant la conversion.

xbox_conversions table

Nom de colonne Type de données PII? (étiquette k-min requise) Description
date INTEGER Non Date de l’événement de conversion au format AAAAMMJJ.
purchase_time LONG Non Horodatage Unix lors de l’achat et de la réalisation de l’article.
line_item_id INTEGER Non Monétiser l’ID d’élément de ligne associé au produit.
advertiser_id INTEGER Non Monétiser l’ID d’annonceur associé à l’élément de ligne.
hashed_email STRING Oui Hachage SHA256 utilisé comme clé de jointure aux expositions.
product_id STRING Non Identificateur unique du produit.
product_name STRING Non Nom du produit lisible par l’utilisateur.
product_category STRING Non Catégorie ou genre du produit (à partir de categoryName).
is_paid_transaction BOOLEAN Non Indique si l’achat est payant ou gratuit.
purchase_price_usd DECIMAL Non Prix d’achat en USD avant taxes.
purchase_price_usd_microcents LONG Non Prix d’achat en microcents.
purchase_currency_code STRING Non Devise utilisée pour l’achat.
device_family STRING Non Famille d’appareils (par exemple, PC, console, mobile).
device_model STRING Non Modèle d’appareil (par exemple, Xbox One X, Xbox Series S).
in_game_purchase BOOLEAN Non Indique si l’achat a eu lieu dans le jeu.
has_xbox_live_subscription BOOLEAN Non Indique si l’utilisateur dispose d’un abonnement Xbox Live.
has_xbox_game_pass_for_console BOOLEAN Non Indique si l’utilisateur dispose du Xbox Game Pass pour console.
has_xbox_game_pass_for_pc BOOLEAN Non Indique si l’utilisateur dispose du Xbox Game Pass pour PC.
has_xbox_game_pass_ultimate BOOLEAN Non Indique si l’utilisateur dispose du Xbox Game Pass Ultimate.
transaction_type STRING Non Type de transaction (par exemple, précommande, achat).
iso_country_code STRING Non Code du pays où l’événement s’est produit.
order_id STRING Non ID de transaction unique associé à l’achat.
hashed_xbox_id LONG Oui XUID associé à l’achat.

Appartenance au segment d’audience

Ce tableau contient les dernières associations d’utilisateur à segment pour les utilisateurs actifs. Un utilisateur actif est défini comme un utilisateur à qui une impression a été fournie. Pour plus d’informations, consultez audiences disponibles sur le marché.

map_ima_segment_exposures table

Nom de colonne Type de données Description
hashed_email STRING E-mail haché SHA256 représentant l’utilisateur associé à l’enregistrement.
segment_id INTEGER ID de segment unique auquel appartient l’utilisateur.
segment_name STRING Nom de segment lisible par l’utilisateur.

Chargement des données de l’annonceur

Les annonceurs peuvent charger des données internes dans la salle de propre LiveRamp de deux manières :

  1. Connecter des données à partir de sources de cloud public prises en charge sans déplacer les données
  2. Charger des fichiers utilisateur directement

Les jeux de données chargés peuvent inclure divers types de données, tels que :

  • Données de transaction hors connexion (par exemple, les visites dans le magasin ou les achats dans l’application qui ne sont pas suivis par le suivi du suivi des conversions ou de l’interface capi)
  • Segments d’audience CRM ou données client
  • Profils client (par exemple, les membres du programme de fidélité)
  • Événements d’analytique web ou d’application

Les jeux de données qui incluent des identificateurs pris en charge (tels que les e-mails hachés) peuvent être joints aux données Microsoft pour prendre en charge l’attribution personnalisée pour les impressions et les clics.

Tous les fichiers qui contiennent des informations d’identification personnelle (PII), telles que des adresses e-mail, doivent être normalisés et hachés avant le chargement. SHA-256 est la méthode de hachage prise en charge.

Données de format et de hachage

Pour protéger la confidentialité des utilisateurs, mettre en forme et hacher les données personnelles avant le chargement.

Mettre en forme les données

Suivez les conseils suivants :

  • Mettre en forme les numéros de téléphone à l’aide de la norme E.164

Pour les adresses e-mail :

  • Supprimer les espaces blancs de début et de fin
  • Convertir tous les caractères en minuscules
  • Supprimer le texte entre « + » et « @ »
    • Exemple : name+alias@outlook.com → name@outlook.com
  • Supprimer les points avant « @ »
    • Exemple : e.xample@outlook.com → example@outlook.com
  • Vérifiez que l’adresse contient « @ »
  • Supprimer tous les espaces
  • Vérifier qu’un suffixe de domaine est présent (par exemple, .com)
  • Supprimer les caractères accentués (par exemple, à)

Données de hachage

  • Utiliser l’algorithme de hachage SHA-256
  • Ne pas appliquer de salage
Type de clé Exemple de valeur Hachage (SHA-256 ; sans sel ; caractères minuscules)
XUID 1234567890123456 7a51d064a1a216a692f753fcdab276e4ff201a01d8b66f56d50d4d719fd0dc87
E-mail example@outlook.com 912ec7074338e900ecd85cd53cf0e7c3e4e00cb65120eb5a18463a30f0e3e208

Processus d’approbation de requête (question)

Les requêtes qui incluent les données d’une autre partie doivent passer par un processus d’approbation avant l’exécution.

Ce processus permet de protéger les informations d’identification personnelle et de garantir la conformité avec les protections de confidentialité.

Étapes de validation

  1. Validation de la syntaxe
    Confirme que les requêtes SQL respectent les contraintes de jeu de données définies par le propriétaire des données

  2. Vérifications de la confidentialité et de la qualité
    Garantit que toutes les requêtes sont conformes aux contrôles de confidentialité des salles propre, y compris les seuils k-min d’entrée et de sortie

  3. Approbation des requêtes
    Nécessite une approbation manuelle de Microsoft et de l’annonceur avant l’exécution

  • Last updated on