Connexion LiveRamp - Onboarding
- Rubriques :
- Destinations
Créé pour :
- Administration
- Utilisateur ou utilisatrice
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.
| Origine de l’audience | Pris en charge | Description |
|---|---|---|
| Segmentation Service | ✓ | Audiences générées via Experience Platform Segmentation Service. |
| Chargements personnalisés | ✓ | Audiences importées dans Experience Platform à partir de fichiers CSV. |
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.
| Élément | Type | Notes |
|---|---|---|
| Type d’exportation | Exportation d’audience | Vous exportez tous les profils membres d’une audience ainsi que les identifiants (nom, numéro de téléphone ou autres) utilisés dans la destination LiveRamp - Onboarding. |
| Fréquence des exportations | Lot quotidien | Étant donné que les profils sont mis à jour dans Experience Platform en fonction de l’évaluation des audiences, les profils (identités) sont mis à jour une fois par jour en aval de la plateforme de destination. En savoir plus sur les destinations basées sur des fichiers par lots. |
Se connecter à la destination
IMPORTANTPour 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
-
Port : port utilisé pour votre emplacement de stockage LiveRamp - Onboarding. Utilisez le port correspondant à votre situation géographique, comme décrit ci-dessous :
- NA : utiliser le port
22 - AU : utilisez le port
2222
- NA : utiliser le port
-
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
-
Port : port utilisé pour votre emplacement de stockage LiveRamp - Onboarding. Utilisez le port correspondant à votre situation géographique, comme décrit ci-dessous :
- EU : utiliser le port
4222
- EU : utiliser le port
-
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.
- Region : région géographique pour votre instance du stockage SFTP LiveRamp.
- Chemin du dossier : saisissez le sous-dossier
uploadsde LiveRamp qui hébergera les fichiers exportés. Le préfixeuploadsest 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, saisissezmy_export_folderdans le champ Chemin du dossier.
- Par exemple, si vous souhaitez exporter vos fichiers vers
- 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
IMPORTANTConsultez 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.
IMPORTANTEmail et Phone, vous devez créer un flux d’activation distinct pour chaque identité.À 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.
IMPORTANT-
Dans l’étape Mappage, sélectionnez Ajouter un nouveau mappage. Une nouvelle ligne de mappage s’affichera à l’écran.
-
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.
-
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.
Les fichiers exportés ont une taille maximale de 10 millions de lignes. Experience Platform génère plusieurs fichiers par diffusion si les audiences sélectionnées dépassent 10 millions de lignes. Si vous prévoyez de dépasser la limite de fichier unique, contactez votre représentant LiveRamp et demandez-lui de configurer l’ingestion par lots pour vous.
Lors de l’exportation de fichiers vers la destination LiveRamp - Onboarding, Experience Platform génère un fichier CSV pour chaque ID de politique 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)
Experience 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 Experience Platform en tant que chargement personnalisé.
Comme Experience Platform génère un fichier CSV pour chaque ID de politique de fusion, il génère également une exécution de flux de données distincte pour chaque ID de politique 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.
Journal des modifications
Cette section répertorie les nouvelles fonctionnalités et les mises à jour importantes de la documentation consacrée au connecteur de destination.
- Ajout de la prise en charge des diffusions vers l’Europe et l’Australie LiveRamp les instances SFTP.
- Mise à jour de la documentation afin de décrire les configurations spécifiques pour les régions nouvellement prises en charge.
- Augmentation de la taille maximale du fichier à 10 millions de lignes (contre 5 millions auparavant).
- Mise à jour de la documentation pour prendre en compte l’augmentation de la taille des fichiers.