Connexion LiveRamp - Onboarding 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 use-cases

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 prerequisites

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 supported-identities

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 supported-audiences

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 par l’Experience Platform Segmentation Service.
Chargements personnalisés
Audiences importées dans Experience Platform à partir de fichiers CSV.

Type et fréquence d’exportation export-type-frequency

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 connect

IMPORTANT
Pour vous connecter à la destination, vous avez besoin de l’événement Affichage des destinations et Gestion des destinations autorisations de contrôle d’accès. Lisez la présentation du contrôle d’accès ou contactez votre administrateur de produit pour obtenir les autorisations requises.

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 authenticate

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

Authentification SFTP avec mot de passe

Exemple de capture d’écran montrant comment s’authentifier à la destination à l’aide du SFTP avec un mot de passe

  • Port: port utilisé pour votre LiveRamp - Onboarding emplacement de stockage. Utilisez le port correspondant à votre emplacement géographique, comme décrit ci-dessous :

    • NA: utiliser le port 22
    • AU: utiliser le port 2222
  • 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.
    Image montrant un exemple de clé PGP correctement formatée dans l’interface utilisateur

  • 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

Exemple de capture d’écran montrant comment s’authentifier à la destination à l’aide de la clé SSH

  • Port: port utilisé pour votre LiveRamp - Onboarding emplacement de stockage. Utilisez le port correspondant à votre emplacement géographique, comme décrit ci-dessous :

    • UE: utiliser le port 4222
  • 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.
    Image montrant un exemple de clé PGP correctement formatée dans l’interface utilisateur

  • 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 destination-details

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.

Capture d’écran de l’interface utilisateur de Platform montrant comment remplir les détails pour votre destination

  • Nom  : un nom par lequel vous reconnaîtrez cette destination à l’avenir.
  • Description  : une description qui vous aidera à identifier cette destination à l’avenir.
  • Région: région géographique de votre instance du stockage SFTP LiveRamp.
  • 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 enable-alerts

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 activate

IMPORTANT
Pour activer les données, vous avez besoin de l’événement Affichage des destinations, Activation des destinations, Afficher les profils, et Affichage de segments autorisations de contrôle d’accès. Lisez la présentation du contrôle d’accès ou contactez votre administrateur ou administratrice du produit pour obtenir les autorisations requises.

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 scheduling

À 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.

Capture d’écran de l’interface utilisateur de Platform montrant l’étape de planification des audiences.

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%

Capture d’écran de l’interface utilisateur de Platform présentant le modèle de nom de fichier exporté.

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 map

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

IMPORTANT
Cette destination prend en charge l’activation d’un espace de noms d’identité source par flux d’activation. Si vous devez exporter plusieurs espaces de noms d’identité, tels que Email 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
Si vous modifiez les champs cibles après la diffusion initiale du fichier à LiveRamp, prévenez votre équipe de compte LiveRamp ou soumettez un ticket à l’assistance LiveRamp pour vous assurer que les modifications sont reflétées dans le processus d’automatisation.
  1. Dans l’étape Mappage, sélectionnez Ajouter un nouveau mappage. Une nouvelle ligne de mappage s’affichera à l’écran.

    Capture d’écran de l’interface utilisateur d’Experience Platform affichant l’écran Mappage.

  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.

    Capture d’écran de l’interface utilisateur d’Experience Platform affichant l’écran de mappage source.

  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.

    Capture d’écran de l’interface utilisateur d’Experience Platform affichant l’écran de mappage cible.

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

    Capture d’écran de l’interface utilisateur d’Experience Platform affichant l’écran de mappage 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 exported-data

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

La taille maximale des fichiers exportés est 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 du fichier unique, contactez votre LiveRamp représentez-vous et demandez-leur de configurer l’ingestion par lots pour vous.

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.

Capture d’écran de l’interface utilisateur d’Experience Platform affichant la mesure Identités activées.

Télécharger des données exportées vers LiveRamp upload-to-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 data-usage-governance

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 additional-resources

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

Journal des modifications changelog

Cette section répertorie les nouvelles fonctionnalités et les mises à jour importantes de la documentation consacrée au connecteur de destination.

Afficher le journal des modifications
table 0-row-3 1-row-3 2-row-3 layout-auto
Mois de publication Type de mise à jour Description
Mars 2024 Nouvelles fonctionnalités et mise à jour de la documentation
  • Ajout de la prise en charge des diffusions en Europe et en Australie LiveRamp SFTP instances.
  • 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 de fichier maximale à 10 millions de lignes (contre 5 millions auparavant).
  • Mise à jour de la documentation pour prendre en compte l’augmentation de la taille des fichiers.
Juillet 2023 Version initiale Publication de la destination initiale et de la documentation.
recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6