Connexion LiveRamp - Onboarding

Utilisez la connexion LiveRamp - Onboarding pour intégrer des audiences à partir d’Adobe Real-time Customer Data Platform vers LiveRamp Connect.

Cas d’utilisation

Pour mieux comprendre quand et comment utiliser la destination LiveRamp - Onboarding, consultez l’exemple de cas d’utilisation ci-dessous que les clientes et clients d’Adobe Experience Platform peuvent résoudre à l’aide de cette destination.

En tant que personne spécialiste marketing, je souhaite envoyer des audiences d’Adobe Experience Platform vers des identités intégrées dans LiveRamp Connect afin que je puisse cibler les utilisateurs et utilisatrices sur les plateformes mobiles, web ouvertes, de réseaux sociaux et CTV, à l’aide de l’identifiant Ramp ID.

Conditions préalables

La connexion LiveRamp - Onboarding exporte les fichiers à l’aide du stockage SFTP de LiveRamp.

Avant d’envoyer des données d’Experience Platform vers LiveRamp - Onboarding, vous avez besoin de vos informations d’identification LiveRamp. Veuillez contacter votre représentant ou représentante LiveRamp pour obtenir vos informations d’identification, si vous ne les avez pas déjà.

Identités prises en charge

LiveRamp - Onboarding prend en charge l’activation d’identités telles que les identifiants basés sur des informations d’identification personnelles, les identifiants connus et les identifiants personnalisés, décrits dans la documentation de LiveRamp.

À l’étape de mappage du workflow d’activation, vous devez définir les mappages cibles en tant qu’attributs personnalisés.

Audiences prises en charge

Cette section décrit les types d’audiences que vous pouvez exporter vers cette destination.

Type et fréquence d’exportation

Reportez-vous au tableau ci-dessous pour plus d’informations sur le type et la fréquence d’exportation des destinations.

Se connecter à la destination

Pour vous connecter à cette destination, procédez comme décrit dans le tutoriel sur la configuration des destinations. Dans le workflow de configuration des destinations, renseignez les champs répertoriés dans les deux sections ci-dessous.

S’authentifier auprès de la destination

Pour vous authentifier à la destination, renseignez les champs requis et sélectionnez Se connecter à la destination.

Authentification SFTP avec mot de passe

• Nom d’utilisateur : nom d’utilisateur de votre emplacement de stockage LiveRamp - Onboarding.
• Mot de passe : mot de passe de votre emplacement de stockage LiveRamp - Onboarding.
• Clé de chiffrement PGP/GPG : vous pouvez éventuellement joindre votre clé publique au format RSA pour ajouter un chiffrement à vos fichiers exportés. Vous pouvez voir un exemple de clé correctement formatée dans l’image ci-dessous.
  
• ID de sous-clé : si vous fournissez une clé de chiffrement, vous devez également indiquer un ID de sous-clé. Consultez la documentation sur le chiffrement de LiveRamp pour savoir comment obtenir l’ID de sous-clé.

SFTP avec authentification par clé SSH

• Nom d’utilisateur : nom d’utilisateur de votre emplacement de stockage LiveRamp - Onboarding.

• Clé SSH : la clé privée SSH utilisée pour se connecter à votre emplacement de stockage LiveRamp - Onboarding. La clé privée doit être formatée sous la forme d’une chaîne codée en Base64 et ne doit pas être protégée par un mot de passe.

  • Pour connecter votre clé SSH au serveur LiveRamp - Onboarding, vous devez soumettre un ticket via le portail d’assistance technique de LiveRamp et fournir votre clé publique. Pour plus d’informations, voir la documentation LiveRamp.

• Clé de chiffrement PGP/GPG : vous pouvez éventuellement joindre votre clé publique au format RSA pour ajouter un chiffrement à vos fichiers exportés. Vous pouvez voir un exemple de clé correctement formatée dans l’image ci-dessous.
  

• ID de sous-clé : si vous fournissez une clé de chiffrement, vous devez également indiquer un ID de sous-clé. Consultez la documentation sur le chiffrement de LiveRamp pour savoir comment obtenir l’ID de sous-clé.

Renseigner les détails de la destination

Pour configurer les détails de la destination, renseignez les champs obligatoires et facultatifs ci-dessous. Un astérisque situé en regard d’un champ de l’interface utilisateur indique que le champ est obligatoire.

• Nom : un nom par lequel vous reconnaîtrez cette destination à l’avenir.
• Description : une description qui vous aidera à identifier cette destination à l’avenir.
• Chemin du dossier : saisissez le sous-dossier uploads de LiveRamp qui hébergera les fichiers exportés. Le préfixe uploads est automatiquement ajouté au chemin du dossier. LiveRamp recommande de créer un sous-dossier dédié pour les diffusions d’Adobe Real-Time CDP afin de séparer les fichiers des autres flux existants et de garantir le bon fonctionnement de l’automatisation.
  • Par exemple, si vous souhaitez exporter vos fichiers vers uploads/my_export_folder, saisissez my_export_folder dans le champ Chemin du dossier.
• Format de compression : sélectionnez le type de compression qu’Experience Platform doit utiliser pour les fichiers exportés. Les options disponibles sont GZIP ou Aucun.

Activer les alertes

Vous pouvez activer les alertes pour recevoir des notifications sur le statut de votre flux de données vers votre destination. Sélectionnez une alerte dans la liste et abonnez-vous à des notifications concernant le statut de votre flux de données. Pour plus d’informations sur les alertes, consultez le guide sur l’abonnement aux alertes des destinations dans l’interface utilisateur.

Lorsque vous avez terminé de renseigner les détails sur votre connexion de destination, sélectionnez Suivant.

Activer des audiences vers cette destination

Consultez la section Activer des données d’audience vers des destinations d’exportation de profils par lots pour obtenir des instructions sur l’activation des audience vers cette destination.

Planification

À l’étape Planification, créez une planification d’exportation pour chaque audience, avec les paramètres présentés ci-dessous.

• Options d’exportation de fichiers : Exporter des fichiers complets. Les exportations de fichiers incrémentiels ne sont actuellement pas prises en charge pour la destination LiveRamp.
• Fréquence : quotidiennement
• Date : sélectionnez les heures de début et de fin de l’exportation comme vous le souhaitez.

Le nom de fichier exporté ne peut actuellement pas être configuré par l’utilisateur ou l’utilisatrice. Tous les fichiers exportés vers la destination LiveRamp - Onboarding sont automatiquement nommés en fonction du modèle suivant :

%ORGANIZATION_NAME%_%DESTINATION%_%DESTINATION_INSTANCE_ID%_%DATETIME%

Par exemple, le nom d’un fichier exporté pour une organisation nommée Luma pourrait ressembler à ceci :

Luma_LiveRamp_52137231-4a99-442d-804c-39a09ddd005d_20230330_153857.csv

Mapper les attributs et les identités

À l’étape du Mappage, vous pouvez sélectionner les attributs et les identités que vous souhaitez exporter pour vos profils.

À l’étape Mappage, le mappage Champ cible définit le nom de l’en-tête de colonne dans le fichier CSV exporté. Vous pouvez remplacer les en-têtes de colonne CSV du fichier exporté par n’importe quel nom convivial, en fournissant un nom personnalisé pour le champ cible.

1. Dans l’étape Mappage, sélectionnez Ajouter un nouveau mappage. Une nouvelle ligne de mappage s’affichera à l’écran.

   

2. Dans la fenêtre Sélectionner le champ source, choisissez la catégorie Sélectionner des attributs et sélectionnez l’attribut XDM à mapper, ou choisissez la catégorie Sélectionner un espace de noms d’identité et sélectionnez une identité à mapper à votre destination.

   

3. Dans la fenêtre Sélectionner le champ cible, saisissez le nom de l’attribut auquel vous souhaitez mapper le champ source sélectionné. Le nom d’attribut défini ici se reflète dans le fichier CSV exporté sous la forme d’un en-tête de colonne.

   

   Vous pouvez également saisir le nom de l’attribut en le saisissant directement dans le champ cible.

   

Une fois que vous avez ajouté tous les mappages souhaités, sélectionnez Suivant et terminez le workflow d’activation.

Données exportées / Valider l’exportation des données

Vos données sont exportées vers l’emplacement de stockage LiveRamp - Onboarding que vous avez configuré, sous forme de fichiers CSV.

Lors de l’exportation de fichiers vers la destination LiveRamp - Onboarding, Platform génère un fichier CSV pour chaque ID de stratégie de fusion.

Prenons par exemple les audiences suivantes :

• Audience A (politique de fusion 1)
• Audience B (politique de fusion 2)
• Audience C (politique de fusion 1)
• Audience D (politique de fusion 1)

Platform exportera deux fichiers CSV vers LiveRamp - Onboarding :

• un fichier CSV contenant les audiences A, C et D ;
• un fichier CSV contenant l’audience B.

Les fichiers CSV exportés contiennent des profils avec les attributs sélectionnés et le statut d’audience correspondant, sur des colonnes distinctes, avec le nom de l’attribut, et les paires audience_namespace:audience_ID en tant qu’en-têtes de colonne, comme illustré dans l’exemple ci-dessous :

ATTRIBUTE_NAME, AUDIENCE_NAMESPACE_1_AUDIENCE_ID_1, AUDIENCE_NAMESPACE_2_AUDIENCE_ID_2,..., AUDIENCE_NAMESPACE_X_AUDIENCE_ID_X

Les profils inclus dans les fichiers exportés peuvent correspondre à l’un des statuts de qualification d’audience suivants :

• Active : le profil est actuellement qualifié pour l’audience.
• Expired : le profil n’est plus qualifié pour l’audience, mais il l’a déjà été.
• "" (chaîne vide) : le profil n’a jamais été qualifié pour l’audience.

Par exemple, un fichier CSV exporté avec un attribut email, deux audiences provenant du Segmentation Service d’Experience Platform et une audience externe importée ressemble à ceci :

email,ups_aa2e3d98-974b-4f8b-9507-59f65b6442df,ups_45d4e762-6e57-4f2f-a3e0-2d1893bcdd7f,CustomerAudienceUpload_7729e537-4e42-418e-be3b-dce5e47aaa1e
abc117@testemailabc.com,active,,
abc111@testemailabc.com,,,active
abc102@testemailabc.com,,,active
abc116@testemailabc.com,active,,
abc107@testemailabc.com,active,expired,active
abc101@testemailabc.com,active,active,

Dans l’exemple ci-dessus, les sections ups_aa2e3d98-974b-4f8b-9507-59f65b6442df et ups_45d4e762-6e57-4f2f-a3e0-2d1893bcdd7f décrivent les audiences provenant de Segmentation Service, tandis que CustomerAudienceUpload_7729e537-4e42-418e-be3b-dce5e47aaa1e décrit une audience importée dans Platform sous la forme d’un chargement personnalisé.

Comme Platform génère un fichier CSV pour chaque ID de stratégie de fusion, il génère également une exécution de flux de données distincte pour chaque ID de stratégie de fusion.

Cela signifie que les mesures Identités activées et Profils reçus de la page exécutions de flux de données sont agrégées pour chaque groupe d’audiences qui utilisent la même politique de fusion, au lieu d’être affichées pour chaque audience.

Du fait de la génération d’exécutions de flux de données pour un groupe d’audiences qui utilisent la même politique de fusion, les noms d’audience ne s’affichent pas dans le tableau de bord de surveillance.

Télécharger des données exportées vers LiveRamp

Une fois vos données exportées vers le stockage LiveRamp - Onboarding, vous devez télécharger les données vers la plateforme LiveRamp.

Pour plus d’informations sur la manière de télécharger vos fichiers depuis le stockage LiveRamp - Onboarding vers une audience LiveRamp, consultez la documentation suivante : Remarques concernant le téléchargement du premier fichier vers une audience.

Utilisation et gouvernance des données

Lors de la gestion de vos données, toutes les destinations Adobe Experience Platform se conforment aux politiques d’utilisation des données. Pour obtenir des informations détaillées sur la manière dont Adobe Experience Platform applique la gouvernance des données, consultez la Présentation de la gouvernance des données.

Ressources supplémentaires

Pour plus d’informations sur la configuration de votre stockage LiveRamp - Onboarding, consultez la documentation officielle.