Activez les audiences vers des destinations basées sur des fichiers à l’aide de l’API Flow Service
Utilisez les fonctionnalités améliorées d’exportation de fichiers pour accéder à la fonctionnalité de personnalisation améliorée lors de l’exportation de fichiers en dehors d’Experience Platform :
- Options de dénomination de fichier supplémentaires.
- Possibilité de définir des en-têtes de fichier personnalisés dans vos fichiers exportés via l’étape de mappage améliorée.
- Possibilité de sélectionner le type de fichierfichier exporté.
- Possibilité de personnaliser le formatage des fichiers de données CSV exportés.
Cette fonctionnalité est prise en charge par les six cartes de stockage dans le cloud répertoriées ci-dessous :
Cet article explique le processus requis pour utiliser l’API Flow Service afin d’exporter des profils qualifiés de Adobe Experience Platform vers l’un des emplacements de stockage dans le cloud liés ci-dessus.
Commencer get-started
Ce guide nécessite une compréhension professionnelle des composants suivants d’Adobe Experience Platform :
- Experience Data Model (XDM) System : cadre normalisé selon lequel Experience Platform organise les données de l’expérience client.
- Segmentation Service : Adobe Experience Platform Segmentation Service permet de créer des audiences et de générer des audiences dans Adobe Experience Platform à partir de vos données Real-Time Customer Profile.
- Sandboxes : Experience Platform fournit des sandbox virtuels qui divisent une instance Experience Platform unique en environnements virtuels distincts pour favoriser le développement et l’évolution d’applications d’expérience digitale.
Les sections suivantes apportent des informations supplémentaires dont vous aurez besoin afin d’activer des données vers des destinations basées sur des fichiers dans Experience Platform.
Autorisations nécessaires permissions
Pour exporter des profils, vous avez besoin des autorisations de contrôle d’accès Afficher les destinations, Activer les destinations, Afficher les profils et Afficher les segments 🔗. Lisez la présentation du contrôle d’accès ou contactez votre administrateur ou administratrice du produit pour obtenir les autorisations requises.
Pour exporter des identités, vous devez disposer de l’autorisation de contrôle d’accès Afficher le graphique d’identités 🔗.
Lecture d’exemples d’appels API reading-sample-api-calls
Ce tutoriel fournit des exemples d’appels API pour démontrer comment formater vos requêtes. Il s’agit notamment de chemins d’accès, d’en-têtes requis et de payloads de requêtes correctement formatés. L’exemple JSON renvoyé dans les réponses de l’API est également fourni. Pour plus d’informations sur les conventions utilisées dans la documentation pour les exemples d’appels d’API, voir la section concernant la lecture d’exemples d’appels d’API dans le guide de dépannage Experience Platform.
Collecter des valeurs pour les en-têtes obligatoires et facultatifs gather-values-headers
Pour lancer des appels aux API Experience Platform, vous devez d’abord suivre le tutoriel Authentification Experience Platform. Le tutoriel d’authentification fournit les valeurs de chacun des en-têtes requis dans tous les appels d’API Experience Platform, comme indiqué ci-dessous :
- Authorization: Bearer
{ACCESS_TOKEN}
- x-api-key :
{API_KEY}
- x-gw-ims-org-id :
{ORG_ID}
Les ressources dans Experience Platform peuvent être isolées dans des sandbox spécifiques. Dans les requêtes aux API Experience Platform, vous pouvez spécifier le nom et l’identifiant du sandbox dans lequel l’opération aura lieu. Il s’agit de paramètres facultatifs.
- x-sandbox-name :
{SANDBOX_NAME}
Toutes les requêtes contenant une payload (POST
, PUT
, PATCH
) nécessitent un en-tête de type de média supplémentaire :
- Content-Type:
application/json
Documentation de référence sur les API api-reference-documentation
Ce tutoriel vous permet de trouver la documentation de référence relative à toutes les opérations API. Reportez-vous à la section Documentation de l’API Flow Service - Destinations sur le site web d’Adobe Developer. Nous vous recommandons de consulter ce tutoriel et la documentation de référence sur les API en parallèle.
Glossaire glossary
Pour obtenir une description des termes que vous rencontrerez dans ce tutoriel sur l’API, consultez la section glossaire de la documentation de référence de l’API.
Sélectionner la destination où exporter les audiences select-destination
Avant de démarrer le workflow d’exportation de profils, identifiez la spécification de connexion et les identifiants de spécification de flux de la destination vers laquelle vous avez l’intention d’exporter des audiences. Utilisez le tableau ci-dessous à titre de référence.
4fce964d-3f37-408f-9778-e597338a21ee
1a0514a6-33d4-4c7f-aff8-594799c47549
6d6b59bf-fb58-4107-9064-4d246c0e5bb2
752d422f-b16f-4f0d-b1c6-26e448e3b388
be2c3209-53bc-47e7-ab25-145db8b873e1
17be2013-2549-41ce-96e7-a70363bec293
10440537-2a7b-4583-ac39-ed38d4b848e8
cd2fc47e-e838-4f38-a581-8fff2f99b63a
c5d93acb-ea8b-4b14-8f53-02138444ae99
585c15c4-6cbf-4126-8f87-e26bff78b657
36965a81-b1c6-401b-99f8-22508f1e6a26
fd36aaa4-bf2b-43fb-9387-43785eeeb799
Vous avez besoin de ces identifiants pour construire différentes entités de service de flux dans les étapes suivantes de ce tutoriel. Vous devez également vous reporter à des parties de la spécification de connexion elle-même pour configurer certaines entités afin de pouvoir récupérer la spécification de connexion à partir des API Flow Service. Consultez les exemples ci-dessous de récupération des spécifications de connexion pour toutes les destinations du tableau :
Requête
accordion | ||
---|---|---|
Récupérer des connection spec pour Amazon S3 | ||
|
Réponse
accordion | ||
---|---|---|
Amazon S3 - Spécification de connexion | ||
|
Requête
accordion | ||
---|---|---|
Récupérer des connection spec pour Azure Blob Storage | ||
|
Réponse
accordion | ||
---|---|---|
Azure Blob Storage - Connection spec | ||
|
Requête
accordion | ||
---|---|---|
Récupérer des connection spec pour Azure Data Lake Gen 2(ADLS Gen2) | ||
|
Réponse
accordion | ||
---|---|---|
Azure Data Lake Gen 2(ADLS Gen2) - Connection spec | ||
|
Requête
accordion | ||
---|---|---|
Récupérer des connection spec pour Data Landing Zone(DLZ) | ||
|
Réponse
accordion | ||
---|---|---|
Data Landing Zone(DLZ) - Connection spec | ||
|
Requête
accordion | ||
---|---|---|
Récupérer des connection spec pour Google Cloud Storage | ||
|
Réponse
accordion | ||
---|---|---|
Google Cloud Storage - Connection spec | ||
|
Requête
accordion | ||
---|---|---|
Récupération de connection spec pour SFTP | ||
|
Réponse
accordion | ||
---|---|---|
SFTP - Connection spec | ||
|
Suivez les étapes ci-dessous pour configurer un flux de données d’exportation d’audience vers une destination d’espace de stockage. Pour certaines étapes, les requêtes et les réponses diffèrent entre les différentes destinations d’espace de stockage. Dans ce cas, utilisez les onglets de la page pour récupérer les requêtes et les réponses spécifiques à la destination à laquelle vous souhaitez vous connecter et exporter des audiences. Veillez à utiliser les connection spec
et flow spec
corrects pour la destination que vous configurez.
Création d’une connexion Source create-source-connection
Après avoir décidé vers quelle destination vous exportez des audiences, vous devez créer une connexion source. La connexion source représente la connexion au magasin de profils Experience Platform interne.
Requête
Notez les lignes en surbrillance avec des commentaires intégrés dans l’exemple de requête, qui fournissent des informations supplémentaires. Supprimez les commentaires intégrés lors du copier-coller de la requête dans le terminal de votre choix.
code language-shell |
---|
|
Réponse
code language-json |
---|
|
Une réponse réussie renvoie l’identifiant (id
) de la connexion source nouvellement créée et un etag
. Notez l’identifiant de connexion source, car vous en aurez besoin ultérieurement lors de la création du flux de données.
Créer une connexion de base create-base-connection
Une connexion de base stocke en toute sécurité les informations d’identification vers la destination. Selon le type de destination, les informations d’identification nécessaires pour s’authentifier sur cette destination peuvent varier. Pour trouver ces paramètres d’authentification, récupérez d’abord le connection spec
de la destination souhaitée, comme décrit dans la section Sélectionner la destination où exporter les audiences, puis examinez le authSpec
de la réponse. Référencez les onglets ci-dessous pour les propriétés authSpec
de toutes les destinations prises en charge.
accordion | ||
---|---|---|
Amazon S3 - Connection spec des auth spec | ||
Notez la ligne en surbrillance avec des commentaires intégrés dans l’exemple de connection spec ci-dessous, qui fournissent des informations supplémentaires sur l’emplacement des paramètres d’authentification dans le connection spec.
|
accordion | ||
---|---|---|
Azure Blob Storage - Connection spec des auth spec | ||
Notez la ligne en surbrillance avec des commentaires intégrés dans l’exemple de connection spec ci-dessous, qui fournissent des informations supplémentaires sur l’emplacement des paramètres d’authentification dans le connection spec.
|
accordion | ||
---|---|---|
Azure Data Lake Gen 2(ADLS Gen2) - Connection spec des auth spec | ||
Notez la ligne en surbrillance avec des commentaires intégrés dans l’exemple de connection spec ci-dessous, qui fournissent des informations supplémentaires sur l’emplacement des paramètres d’authentification dans le connection spec.
|
accordion | |||||
---|---|---|---|---|---|
Data Landing Zone(DLZ) - Connection spec des auth spec | |||||
|
accordion | ||
---|---|---|
Google Cloud Storage - Connection spec des auth spec | ||
Notez la ligne en surbrillance avec des commentaires intégrés dans l’exemple de connection spec ci-dessous, qui fournissent des informations supplémentaires sur l’emplacement des paramètres d’authentification dans le connection spec.
|
accordion | |||||
---|---|---|---|---|---|
SFTP - Connection spec affichant les auth spec | |||||
Notez la ligne en surbrillance avec des commentaires intégrés dans l’exemple de connection spec ci-dessous, qui fournissent des informations supplémentaires sur l’emplacement des paramètres d’authentification dans le connection spec.
|
À l’aide des propriétés spécifiées dans la spécification d’authentification (c’est-à-dire authSpec
à partir de la réponse), vous pouvez créer une connexion de base avec les informations d’identification requises, spécifiques à chaque type de destination, comme illustré dans les exemples ci-dessous :
Requête
accordion | |||||
---|---|---|---|---|---|
Amazon S3 - Demande de connexion de base avec clé d’accès et authentification par clé secrète | |||||
Notez les lignes en surbrillance avec des commentaires intégrés dans l’exemple de requête, qui fournissent des informations supplémentaires. Supprimez les commentaires intégrés dans la requête lors du copier-coller de la requête dans le terminal de votre choix.
|
accordion | |||||
---|---|---|---|---|---|
Amazon S3 - Demande de connexion de base avec authentification du rôle assumé | |||||
Notez les lignes en surbrillance avec des commentaires intégrés dans l’exemple de requête, qui fournissent des informations supplémentaires. Supprimez les commentaires intégrés dans la requête lors du copier-coller de la requête dans le terminal de votre choix.
|
Réponse
accordion | ||
---|---|---|
Amazon S3 réponse de connexion de base | ||
|
Requête
accordion | |||||
---|---|---|---|---|---|
Azure Blob Storage - Demande de connexion de base | |||||
Notez les lignes en surbrillance avec des commentaires intégrés dans l’exemple de requête, qui fournissent des informations supplémentaires. Supprimez les commentaires intégrés dans la requête lors du copier-coller de la requête dans le terminal de votre choix.
|
Réponse
accordion | ||
---|---|---|
Azure Blob Storage - Réponse de la connexion de base | ||
|
Requête
accordion | |||||
---|---|---|---|---|---|
Azure Data Lake Gen 2(ADLS Gen2) - Demande de connexion de base | |||||
Notez les lignes en surbrillance avec des commentaires intégrés dans l’exemple de requête, qui fournissent des informations supplémentaires. Supprimez les commentaires intégrés dans la requête lors du copier-coller de la requête dans le terminal de votre choix.
|
Réponse
accordion | ||
---|---|---|
Azure Data Lake Gen 2(ADLS Gen2) - Réponse de la connexion de base | ||
|
Requête
accordion | |||||
---|---|---|---|---|---|
Data Landing Zone(DLZ) - Demande de connexion de base | |||||
|
Réponse
accordion | ||
---|---|---|
Data Landing Zone - Réponse de la connexion de base | ||
|
Requête
accordion | |||||
---|---|---|---|---|---|
Google Cloud Storage - Demande de connexion de base | |||||
Notez les lignes en surbrillance avec des commentaires intégrés dans l’exemple de requête, qui fournissent des informations supplémentaires. Supprimez les commentaires intégrés dans la requête lors du copier-coller de la requête dans le terminal de votre choix.
|
Réponse
accordion | ||
---|---|---|
Google Cloud Storage - Réponse de la connexion de base | ||
|
Requête
accordion | |||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
SFTP avec mot de passe - Demande de connexion de base | |||||||||||||||||||
Notez les lignes en surbrillance avec des commentaires intégrés dans l’exemple de requête, qui fournissent des informations supplémentaires. Supprimez les commentaires intégrés dans la requête lors du copier-coller de la requête dans le terminal de votre choix.
|
accordion | |||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
SFTP avec clé SSH - Demande de connexion de base | |||||||||||||||||||
Notez les lignes en surbrillance avec des commentaires intégrés dans l’exemple de requête, qui fournissent des informations supplémentaires. Supprimez les commentaires intégrés dans la requête lors du copier-coller de la requête dans le terminal de votre choix.
|
Réponse
accordion | ||
---|---|---|
SFTP - Réponse de la connexion de base | ||
|
Ajouter un chiffrement aux fichiers exportés
Vous pouvez éventuellement ajouter un chiffrement à vos fichiers exportés. Pour ce faire, vous devez ajouter des éléments à partir du encryptionSpecs
. Consultez l’exemple de requête ci-dessous avec les paramètres obligatoires mis en surbrillance :
code language-json line-numbers data-start-1 data-line-offset-4 h-26-27 |
---|
|
Requête
Notez les lignes en surbrillance avec des commentaires intégrés dans l’exemple de requête, qui fournissent des informations supplémentaires. Supprimez les commentaires intégrés lors du copier-coller de la requête dans le terminal de votre choix.
code language-shell line-numbers data-start-1 data-line-offset-4 h-19 |
---|
|
Réponse
code language-json |
---|
|
Notez l’ID de connexion à partir de la réponse. Cet identifiant sera requis à l’étape suivante lors de la création de la connexion cible.
Créer une connexion cible create-target-connection
Ensuite, vous devez créer une connexion cible. Connexions Target stockez les paramètres d’exportation pour les audiences exportées. Les paramètres d’exportation incluent l’emplacement d’exportation, le format de fichier, la compression et d’autres détails. Par exemple, pour les fichiers CSV, vous pouvez sélectionner plusieurs options d’exportation. Obtenez des informations détaillées sur toutes les options d’exportation de fichiers CSV prises en charge sur la page configurations de formatage de fichier.
Reportez-vous aux propriétés targetSpec
fournies dans la connection spec
de la destination pour comprendre les propriétés prises en charge pour chaque type de destination. Référencez les onglets ci-dessous pour les propriétés targetSpec
de toutes les destinations prises en charge.
accordion | ||
---|---|---|
Amazon S3 - Connection spec affichant les paramètres de connexion cible | ||
Notez les lignes mises en surbrillance avec des commentaires intégrés dans l’exemple de connection spec ci-dessous, qui fournissent des informations supplémentaires sur l’emplacement des paramètres de target spec dans la spécification de connexion. Vous pouvez également voir dans l’exemple ci-dessous quels paramètres cibles ne s’appliquent pas aux destinations d’exportation d’audiences.
|
accordion | ||
---|---|---|
Azure Blob Storage - Connection spec affichant les paramètres de connexion cible | ||
Notez les lignes mises en surbrillance avec des commentaires intégrés dans l’exemple de connection spec ci-dessous, qui fournissent des informations supplémentaires sur l’emplacement des paramètres de target spec dans la spécification de connexion. Vous pouvez également voir dans l’exemple ci-dessous quels paramètres cibles ne s’appliquent pas aux destinations d’exportation d’audiences.
|
accordion | ||
---|---|---|
Azure Data Lake Gen 2(ADLS Gen2) - Connection spec affichant les paramètres de connexion cible | ||
Notez les lignes mises en surbrillance avec des commentaires intégrés dans l’exemple de connection spec ci-dessous, qui fournissent des informations supplémentaires sur l’emplacement des paramètres de target spec dans la spécification de connexion. Vous pouvez également voir dans l’exemple ci-dessous quels paramètres cibles ne s’appliquent pas aux destinations d’exportation d’audiences.
|
accordion | ||
---|---|---|
Data Landing Zone(DLZ) - Connection spec affichant les paramètres de connexion cible | ||
Notez les lignes mises en surbrillance avec des commentaires intégrés dans l’exemple de connection spec ci-dessous, qui fournissent des informations supplémentaires sur l’emplacement des paramètres de target spec dans la spécification de connexion. Vous pouvez également voir dans l’exemple ci-dessous quels paramètres cibles ne s’appliquent pas aux destinations d’exportation d’audiences.
|
accordion | ||
---|---|---|
Google Cloud Storage - Connection spec affichant les paramètres de connexion cible | ||
Notez les lignes mises en surbrillance avec des commentaires intégrés dans l’exemple de connection spec ci-dessous, qui fournissent des informations supplémentaires sur l’emplacement des paramètres de target spec dans la spécification de connexion. Vous pouvez également voir dans l’exemple ci-dessous quels paramètres cibles ne s’appliquent pas aux destinations d’exportation d’audiences.
|
accordion | ||
---|---|---|
SFTP - Connection spec affichant les paramètres de connexion cible | ||
Notez les lignes mises en surbrillance avec des commentaires intégrés dans l’exemple de connection spec ci-dessous, qui fournissent des informations supplémentaires sur l’emplacement des paramètres de target spec dans la spécification de connexion. Vous pouvez également voir dans l’exemple ci-dessous quels paramètres cibles ne s’appliquent pas aux destinations d’exportation d’audiences.
|
En utilisant la spécification ci-dessus, vous pouvez créer une demande de connexion cible spécifique à la destination d’espace de stockage souhaitée, comme illustré dans les onglets ci-dessous.
Requête
accordion | |||||
---|---|---|---|---|---|
Amazon S3 - Demande de connexion cible | |||||
Notez les lignes en surbrillance avec des commentaires intégrés dans l’exemple de requête, qui fournissent des informations supplémentaires. Supprimez les commentaires intégrés dans la requête lors du copier-coller de la requête dans le terminal de votre choix.
|
accordion | |||||
---|---|---|---|---|---|
Amazon S3 - Demande de connexion cible avec des options CSV | |||||
|
Réponse
accordion | ||
---|---|---|
Connexion cible - Réponse | ||
|
Requête
accordion | |||||
---|---|---|---|---|---|
Azure Blob Storage - Demande de connexion cible | |||||
Notez les lignes en surbrillance avec des commentaires intégrés dans l’exemple de requête, qui fournissent des informations supplémentaires. Supprimez les commentaires intégrés dans la requête lors du copier-coller de la requête dans le terminal de votre choix.
|
accordion | |||||
---|---|---|---|---|---|
Azure Blob Storage - Demande de connexion cible avec des options CSV | |||||
|
Réponse
accordion | ||
---|---|---|
Connexion cible - Réponse | ||
|
Requête
accordion | |||||
---|---|---|---|---|---|
Azure Data Lake Gen 2(ADLS Gen2) - Demande de connexion cible | |||||
Notez les lignes en surbrillance avec des commentaires intégrés dans l’exemple de requête, qui fournissent des informations supplémentaires. Supprimez les commentaires intégrés dans la requête lors du copier-coller de la requête dans le terminal de votre choix.
|
accordion | |||||
---|---|---|---|---|---|
Azure Data Lake Gen 2(ADLS Gen2) - Demande de connexion cible avec des options CSV | |||||
|
Réponse
accordion | ||
---|---|---|
Connexion cible - Réponse | ||
|
Requête
accordion | |||||
---|---|---|---|---|---|
Data Landing Zone - Demande de connexion cible | |||||
Notez les lignes en surbrillance avec des commentaires intégrés dans l’exemple de requête, qui fournissent des informations supplémentaires. Supprimez les commentaires intégrés dans la requête lors du copier-coller de la requête dans le terminal de votre choix.
|
accordion | |||||
---|---|---|---|---|---|
Data Landing Zone - Demande de connexion cible avec des options CSV | |||||
|
Réponse
accordion | ||
---|---|---|
Connexion cible - Réponse | ||
|
Requête
accordion | |||||
---|---|---|---|---|---|
Google Cloud Storage - Demande de connexion cible | |||||
Notez les lignes en surbrillance avec des commentaires intégrés dans l’exemple de requête, qui fournissent des informations supplémentaires. Supprimez les commentaires intégrés dans la requête lors du copier-coller de la requête dans le terminal de votre choix.
|
accordion | |||||
---|---|---|---|---|---|
Google Cloud Storage - Demande de connexion cible avec des options CSV | |||||
|
Réponse
accordion | ||
---|---|---|
Connexion cible - Réponse | ||
|
Requête
accordion | |||||
---|---|---|---|---|---|
SFTP - Demande de connexion cible | |||||
Notez les lignes en surbrillance avec des commentaires intégrés dans l’exemple de requête, qui fournissent des informations supplémentaires. Supprimez les commentaires intégrés dans la requête lors du copier-coller de la requête dans le terminal de votre choix.
|
accordion | |||||
---|---|---|---|---|---|
SFTP - Demande de connexion cible avec des options CSV | |||||
|
Réponse
accordion | ||
---|---|---|
Connexion cible - Réponse | ||
|
Notez le target connection ID
de la réponse. Cet identifiant sera requis à l’étape suivante lors de la création du flux de données pour exporter des audiences.
Une réponse réussie renvoie l’identifiant (id
) de la nouvelle connexion source cible et un etag
. Notez l’identifiant de connexion cible, car vous en aurez besoin ultérieurement lors de la création du flux de données.
Créer un flux de données create-dataflow
L’étape suivante de la configuration de destination consiste à créer un flux de données. Un flux de données lie les entités créées précédemment et fournit également des options pour configurer le planning d’exportation des audiences. Pour créer le flux de données, utilisez les payloads ci-dessous, en fonction de la destination d’espace de stockage souhaitée, et remplacez les identifiants d’entité de flux des étapes précédentes. Notez que dans cette étape, vous n’ajoutez aucune information liée au mappage d’attribut ou d’identité au flux de données. Cela se fera à l'étape suivante.
Requête
accordion | ||
---|---|---|
Créer un flux de données d’exportation d’audience vers Amazon S3 destination - Requête | ||
Notez les lignes en surbrillance avec des commentaires intégrés dans l’exemple de requête, qui fournissent des informations supplémentaires. Supprimez les commentaires intégrés dans la requête lors du copier-coller de la requête dans le terminal de votre choix.
|
Réponse
accordion | ||
---|---|---|
Créer un flux de données - Réponse | ||
|
Requête
accordion | ||
---|---|---|
Créer un flux de données d’exportation d’audience vers Azure Blob Storage destination - Requête | ||
Notez les lignes en surbrillance avec des commentaires intégrés dans l’exemple de requête, qui fournissent des informations supplémentaires. Supprimez les commentaires intégrés dans la requête lors du copier-coller de la requête dans le terminal de votre choix.
|
Réponse
accordion | ||
---|---|---|
Créer un flux de données - Réponse | ||
|
Requête
accordion | ||
---|---|---|
Créer un flux de données d’exportation d’audience vers Azure Data Lake Gen 2(ADLS Gen2) destination - Requête | ||
Notez les lignes en surbrillance avec des commentaires intégrés dans l’exemple de requête, qui fournissent des informations supplémentaires. Supprimez les commentaires intégrés dans la requête lors du copier-coller de la requête dans le terminal de votre choix.
|
Réponse
accordion | ||
---|---|---|
Créer un flux de données - Réponse | ||
|
Requête
accordion | ||
---|---|---|
Créer un flux de données d’exportation d’audience vers Data Landing Zone destination - Requête | ||
Notez les lignes en surbrillance avec des commentaires intégrés dans l’exemple de requête, qui fournissent des informations supplémentaires. Supprimez les commentaires intégrés dans la requête lors du copier-coller de la requête dans le terminal de votre choix.
|
Réponse
accordion | ||
---|---|---|
Créer un flux de données - Réponse | ||
|
Requête
accordion | ||
---|---|---|
Créer un flux de données d’exportation d’audience vers Google Cloud Storage destination - Requête | ||
Notez les lignes en surbrillance avec des commentaires intégrés dans l’exemple de requête, qui fournissent des informations supplémentaires. Supprimez les commentaires intégrés dans la requête lors du copier-coller de la requête dans le terminal de votre choix.
|
Réponse
accordion | ||
---|---|---|
Créer un flux de données - Réponse | ||
|
Requête
accordion | ||
---|---|---|
Créer un flux de données d’exportation d’audience vers une destination SFTP - Requête | ||
Notez les lignes en surbrillance avec des commentaires intégrés dans l’exemple de requête, qui fournissent des informations supplémentaires. Supprimez les commentaires intégrés dans la requête lors du copier-coller de la requête dans le terminal de votre choix.
|
Réponse
accordion | ||
---|---|---|
Créer un flux de données - Réponse | ||
|
Notez l’identifiant du flux de données dans la réponse. Cet identifiant sera requis lors des étapes suivantes.
Ajouter des audiences à l’exportation
Au cours de cette étape, vous pouvez également sélectionner les audiences que vous souhaitez exporter vers la destination. Pour obtenir des informations détaillées sur cette étape et le format de requête permettant d’ajouter une audience au flux de données, consultez les exemples dans la section Mettre à jour un flux de données de destinationde la documentation de référence de l’API.
Configurer le mappage des attributs et des identités attribute-and-identity-mapping
Après avoir créé votre flux de données, vous devez configurer le mappage pour les attributs et les identités que vous souhaitez exporter. Il s’agit de trois étapes, répertoriées ci-dessous :
- Création d’un schéma d’entrée
- Création d’un schéma de sortie
- Configurer un jeu de mappages pour connecter les schémas créés
Par exemple, pour obtenir le mappage suivant illustré dans l’interface utilisateur, vous devez suivre les trois étapes répertoriées ci-dessus et décrites en détail dans les en-têtes suivants.
Création d’un schéma d’entrée
Pour créer un schéma d’entrée, vous devez d’abord récupérer votre schéma d’union et les identités qui peuvent être exportées vers la destination. Il s’agit du schéma des attributs et des identités que vous pouvez sélectionner comme mappage source.
Consultez ci-dessous des exemples de requêtes et de réponses pour récupérer les attributs et les identités.
Demande d’obtention des attributs
code language-shell |
---|
|
Réponse
La réponse ci-dessous a été abrégée par souci de concision.
code language-json |
---|
|
Demande d’obtention des identités
code language-shell |
---|
|
Réponse
La réponse renvoie les identités que vous pouvez utiliser lors de la création du schéma d’entrée. Notez que cette réponse renvoie les espaces de noms d’identité standard et personnalisés que vous configurez dans Experience Platform.
code language-json |
---|
|
Ensuite, vous devez copier la réponse ci-dessus et l’utiliser pour créer votre schéma d’entrée. Vous pouvez copier l’intégralité de la réponse JSON de la réponse ci-dessus et la placer dans l’objet jsonSchema
indiqué ci-dessous.
Demande de création d’un schéma d’entrée
code language-shell |
---|
|
Réponse
code language-json |
---|
|
L’identifiant dans la réponse représente l’identifiant unique du schéma d’entrée que vous avez créé. Copiez l’identifiant de la réponse, car vous le réutiliserez à une étape ultérieure.
Création d’un schéma de sortie
Vous devez ensuite configurer le schéma de sortie pour votre exportation. Tout d’abord, vous devez rechercher et inspecter votre schéma de partenaire existant.
Requête
Notez que l’exemple ci-dessous utilise le connection spec ID
pour Amazon S3. Veuillez remplacer cette valeur par l’identifiant de spécification de connexion spécifique à votre destination.
code language-shell |
---|
|
Réponse avec un exemple de schéma
Examinez la réponse que vous obtenez lors de l’exécution de l’appel ci-dessus. Vous devez analyser la réponse en profondeur pour trouver l’objet targetSpec.attributes.partnerSchema.jsonSchema
code language-json |
---|
|
Vous devez ensuite créer un schéma de sortie. Copiez la réponse JSON obtenue ci-dessus et collez-la dans l’objet jsonSchema
ci-dessous.
Requête
code language-shell |
---|
|
Réponse
code language-json |
---|
|
L’identifiant dans la réponse représente l’identifiant unique du schéma d’entrée que vous avez créé. Copiez l’identifiant de la réponse, car vous le réutiliserez à une étape ultérieure.
Créer un jeu de mappages create-mapping-set
Utilisez ensuite l’API data prep pour créer le jeu de mappages à l’aide de l’identifiant de schéma d’entrée, de l’identifiant de schéma de sortie et des mappages de champs de votre choix.
Requête
note important |
---|
IMPORTANT |
|
code language-shell line-numbers data-start-1 data-line-offset-4 h-16-38 |
---|
|
Réponse
code language-json |
---|
|
Notez l’identifiant du jeu de mappages, car vous en aurez besoin à l’étape suivante pour mettre à jour le flux de données existant avec l’identifiant du jeu de mappages.
Ensuite, obtenez l’identifiant du flux de données à mettre à jour.
Voir récupérer les détails d’un flux de données de destination pour plus d’informations sur la récupération de l’identifiant d’un flux de données.
Enfin, vous devez PATCH
le flux de données avec les informations du jeu de mappages que vous venez de créer.
Requête
code language-shell |
---|
|
Réponse
La réponse de l’API Flow Service renvoie l’identifiant du flux de données mis à jour.
code language-json |
---|
|
Effectuer d’autres mises à jour du flux de données other-dataflow-updates
Pour apporter des mises à jour à votre flux de données, utilisez l’opération PATCH
. Par exemple, vous pouvez ajouter une action marketing à vos flux de données. Vous pouvez également mettre à jour vos flux de données pour sélectionner des champs comme clés obligatoires ou clés de déduplication.
Ajout d’une action marketing add-marketing-action
Pour ajouter une action marketing, reportez-vous aux exemples de requête et de réponse ci-dessous.
If-Match
est requis lors de l’exécution d’une requête PATCH
. La valeur de cet en-tête est la version unique du flux de données que vous souhaitez mettre à jour. La valeur etag est mise à jour avec chaque mise à jour réussie d’une entité de flux telle que le flux de données, la connexion cible, etc.https://platform.adobe.io/data/foundation/flowservice/flows/{ID}
, où {ID}
correspond à l’identifiant du flux de données que vous souhaitez mettre à jour.If-Match
entre guillemets doubles, comme dans les exemples ci-dessous, lors de l’exécution de requêtes PATCH
.Requête
code language-shell |
---|
|
Réponse
Une réponse réussie renvoie le code de réponse 200
avec l’identifiant du flux de données mis à jour et la balise électronique mise à jour.
code language-json |
---|
|
Ajouter une clé obligatoire add-mandatory-key
Pour ajouter une clé obligatoire, reportez-vous aux exemples de requête et de réponse ci-dessous.
If-Match
est requis lors de l’exécution d’une requête PATCH
. La valeur de cet en-tête est la version unique du flux de données que vous souhaitez mettre à jour. La valeur etag est mise à jour avec chaque mise à jour réussie d’une entité de flux telle que le flux de données, la connexion cible, etc.https://platform.adobe.io/data/foundation/flowservice/flows/{ID}
, où {ID}
correspond à l’identifiant du flux de données que vous souhaitez mettre à jour.If-Match
entre guillemets doubles, comme dans les exemples ci-dessous, lors de l’exécution de requêtes PATCH
.Requête
code language-shell |
---|
|
code language-shell |
---|
|
Réponse
code language-json |
---|
|
Ajout d’une clé de déduplication add-deduplication-key
Pour ajouter une clé de déduplication, consultez les exemples de requête et de réponse ci-dessous
If-Match
est requis lors de l’exécution d’une requête PATCH
. La valeur de cet en-tête est la version unique du flux de données que vous souhaitez mettre à jour. La valeur etag est mise à jour avec chaque mise à jour réussie d’une entité de flux telle que le flux de données, la connexion cible, etc.https://platform.adobe.io/data/foundation/flowservice/flows/{ID}
, où {ID}
correspond à l’identifiant du flux de données que vous souhaitez mettre à jour.If-Match
entre guillemets doubles, comme dans les exemples ci-dessous, lors de l’exécution de requêtes PATCH
.Requête
code language-shell |
---|
|
code language-shell |
---|
|
Réponse
code language-json |
---|
|
Valider le flux de données (obtenir les exécutions du flux de données) get-dataflow-runs
Pour vérifier les exécutions d’un flux de données, utilisez l’API d’exécutions de flux de données :
Requête
code language-shell |
---|
|
Réponse
code language-json |
---|
|
Vous trouverez des informations sur les différents paramètres renvoyés par l’API d’exécution de flux de données dans la documentation de référence de l’API.
Gestion des erreurs d’API api-error-handling
Les points d’entrée d’API de ce tutoriel suivent les principes généraux des messages d’erreur de l’API Experience Platform. Pour plus d’informations sur l’interprétation des réponses d’erreur🔗 consultez les sections Codes d’état API et Erreurs d’en-tête de requête dans le guide de dépannage d’Experience Platform.
Étapes suivantes next-steps
En suivant ce tutoriel, vous avez réussi à connecter Experience Platform à l’une de vos destinations de stockage dans le cloud préférées et à configurer un flux de données vers la destination correspondante pour exporter des audiences. Consultez les pages suivantes pour plus d’informations, telles que la modification des flux de données existants à l’aide de l’API Flow Service :