Activation des audiences vers des destinations basées sur des fichiers à l’aide de l’API Flow Service
Utilisez les fonctionnalités d’exportation de fichiers améliorées pour accéder à une fonctionnalité de personnalisation améliorée lors de l’exportation de fichiers hors 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 fichier du fichier 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 workflow 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 vous 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 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 avez besoin pour activer les données vers des destinations basées sur des fichiers dans Platform.
Autorisations nécessaires permissions
Pour exporter des profils, vous avez besoin des , activer les destinations, afficher les profils et afficher les 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.
Pour exporter des identités, vous avez besoin de l'autorisation Afficher le graphique d'identités 🔗.
{width="100" modal="regular"}
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 vers des API Platform, vous devez d’abord suivre le tutoriel sur l’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 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 documentation Flow Service - Destinations API sur le site web 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 des descriptions des termes que vous rencontrerez dans ce tutoriel sur l’API, consultez la section de glossaire de la documentation de référence sur l’API.
Sélectionner la destination vers laquelle exporter les audiences select-destination
Avant de démarrer le workflow pour exporter des profils, identifiez les spécifications de connexion et les identifiants de spécification de flux de la destination vers laquelle vous envisagez 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 référer à certaines parties de la spécification de connexion elle-même pour configurer certaines entités afin que vous puissiez récupérer la spécification de connexion à partir des API de service de flux. Consultez les exemples ci-dessous de récupération des spécifications de connexion pour toutes les destinations dans le tableau :
Requête
accordion | ||
---|---|---|
Récupérer connection spec pour Amazon S3 | ||
|
Réponse
accordion | ||
---|---|---|
Amazon S3 - Spécification de la connexion | ||
|
Requête
accordion | ||
---|---|---|
Récupérer connection spec pour Azure Blob Storage | ||
|
Réponse
accordion | ||
---|---|---|
Azure Blob Storage - Connection spec | ||
|
Requête
accordion | ||
---|---|---|
Récupérer 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 connection spec pour Data Landing Zone(DLZ) | ||
|
Réponse
accordion | ||
---|---|---|
Data Landing Zone(DLZ) - Connection spec | ||
|
Requête
accordion | ||
---|---|---|
Récupérer connection spec pour Google Cloud Storage | ||
|
Réponse
accordion | ||
---|---|---|
Google Cloud Storage - Connection spec | ||
|
Requête
accordion | ||
---|---|---|
Récupérer 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 de stockage dans le cloud. Pour certaines étapes, les requêtes et les réponses diffèrent entre les différentes destinations de stockage dans le cloud. Dans ce cas, utilisez les onglets de la page pour récupérer les requêtes et 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é de la destination vers laquelle vous exportez des audiences, vous devez créer une connexion source. La connexion source représente la connexion à la banque de profils Experience Platform interne.
Requête
Notez les lignes surlignées avec des commentaires intégrés dans l’exemple de requête, qui fournissent des informations supplémentaires. Supprimez les commentaires insérés lorsque vous copiez-collez la requête dans votre terminal de votre choix.
code language-shell |
---|
|
Réponse
code language-json |
---|
|
Une réponse réussie renvoie l’identifiant (id
) de la nouvelle connexion source 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 votre 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 les connection spec
correspondant à la destination souhaitée, comme décrit dans la section Sélectionner la destination où exporter des audiences, puis regardez 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 présentant auth spec | ||
Notez la ligne mise en surbrillance avec des commentaires intégrés dans l’exemple connection spec ci-dessous, qui fournit des informations supplémentaires sur l’emplacement des paramètres d’authentification dans connection spec.
|
accordion | ||
---|---|---|
Azure Blob Storage - Connection spec présentant auth spec | ||
Notez la ligne mise en surbrillance avec des commentaires intégrés dans l’exemple connection spec ci-dessous, qui fournit des informations supplémentaires sur l’emplacement des paramètres d’authentification dans connection spec.
|
accordion | ||
---|---|---|
Azure Data Lake Gen 2(ADLS Gen2) - Connection spec présentant auth spec | ||
Notez la ligne mise en surbrillance avec des commentaires intégrés dans l’exemple connection spec ci-dessous, qui fournit des informations supplémentaires sur l’emplacement des paramètres d’authentification dans connection spec.
|
accordion | |||||
---|---|---|---|---|---|
Data Landing Zone(DLZ) - Connection spec présentant auth spec | |||||
|
accordion | ||
---|---|---|
Google Cloud Storage - Connection spec présentant auth spec | ||
Notez la ligne mise en surbrillance avec des commentaires intégrés dans l’exemple connection spec ci-dessous, qui fournit des informations supplémentaires sur l’emplacement des paramètres d’authentification dans connection spec.
|
accordion | |||||
---|---|---|---|---|---|
SFTP - Connection spec avec auth spec | |||||
Notez la ligne mise en surbrillance avec des commentaires intégrés dans l’exemple connection spec ci-dessous, qui fournit des informations supplémentaires sur l’emplacement des paramètres d’authentification dans connection spec.
|
En utilisant les 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 authentification de clé d’accès et de clé secrète | |||||
Notez les lignes surlignées avec des commentaires intégrés dans l’exemple de requête, qui fournissent des informations supplémentaires. Supprimez les commentaires insérés dans la requête lorsque vous copiez-collez la requête dans votre terminal de votre choix.
|
accordion | |||||
---|---|---|---|---|---|
Amazon S3 - Requête de connexion de base avec authentification de rôle assumé | |||||
Notez les lignes surlignées avec des commentaires intégrés dans l’exemple de requête, qui fournissent des informations supplémentaires. Supprimez les commentaires insérés dans la requête lorsque vous copiez-collez la requête dans votre terminal de votre choix.
|
Réponse
accordion | ||
---|---|---|
Amazon S3 Réponse de connexion de base | ||
|
Requête
accordion | |||||
---|---|---|---|---|---|
Azure Blob Storage - Requête de connexion de base | |||||
Notez les lignes surlignées avec des commentaires intégrés dans l’exemple de requête, qui fournissent des informations supplémentaires. Supprimez les commentaires insérés dans la requête lorsque vous copiez-collez la requête dans votre terminal de votre choix.
|
Réponse
accordion | ||
---|---|---|
Azure Blob Storage - Réponse de connexion de base | ||
|
Requête
accordion | |||||
---|---|---|---|---|---|
Azure Data Lake Gen 2(ADLS Gen2) - Requête de connexion de base | |||||
Notez les lignes surlignées avec des commentaires intégrés dans l’exemple de requête, qui fournissent des informations supplémentaires. Supprimez les commentaires insérés dans la requête lorsque vous copiez-collez la requête dans votre terminal de votre choix.
|
Réponse
accordion | ||
---|---|---|
Azure Data Lake Gen 2(ADLS Gen2) - Réponse de connexion de base | ||
|
Requête
accordion | |||||
---|---|---|---|---|---|
Data Landing Zone(DLZ) - Requête de connexion de base | |||||
|
Réponse
accordion | ||
---|---|---|
Data Landing Zone - Réponse de connexion de base | ||
|
Requête
accordion | |||||
---|---|---|---|---|---|
Google Cloud Storage - Requête de connexion de base | |||||
Notez les lignes surlignées avec des commentaires intégrés dans l’exemple de requête, qui fournissent des informations supplémentaires. Supprimez les commentaires insérés dans la requête lorsque vous copiez-collez la requête dans votre terminal de votre choix.
|
Réponse
accordion | ||
---|---|---|
Google Cloud Storage - Réponse de connexion de base | ||
|
Requête
accordion | |||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
SFTP avec mot de passe - Demande de connexion de base | |||||||||||||||||||
Notez les lignes surlignées avec des commentaires intégrés dans l’exemple de requête, qui fournissent des informations supplémentaires. Supprimez les commentaires insérés dans la requête lorsque vous copiez-collez la requête dans votre terminal de votre choix.
|
accordion | |||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
SFTP avec clé SSH - requête de connexion de base | |||||||||||||||||||
Notez les lignes surlignées avec des commentaires intégrés dans l’exemple de requête, qui fournissent des informations supplémentaires. Supprimez les commentaires insérés dans la requête lorsque vous copiez-collez la requête dans votre terminal de votre choix.
|
Réponse
accordion | ||
---|---|---|
SFTP : réponse de connexion de base | ||
|
Ajout d’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 de 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 surlignées avec des commentaires intégrés dans l’exemple de requête, qui fournissent des informations supplémentaires. Supprimez les commentaires insérés lorsque vous copiez-collez la requête dans votre 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’identifiant de connexion 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
Vous devez ensuite créer une connexion cible. Les connexions Target stockent 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 CSV prises en charge dans la page de configuration du formatage de fichier.
Reportez-vous aux propriétés targetSpec
fournies dans le 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 présentant les paramètres de connexion cible | ||
Notez les lignes surlignées avec des commentaires intégrés dans l’exemple connection spec ci-dessous, qui fournissent des informations supplémentaires sur l’emplacement des paramètres target spec dans la spécification de connexion. Vous pouvez également voir dans l’exemple ci-dessous les paramètres de cible et non applicables aux destinations d’exportation d’audience.
|
accordion | ||
---|---|---|
Azure Blob Storage - Connection spec présentant les paramètres de connexion cible | ||
Notez les lignes surlignées avec des commentaires intégrés dans l’exemple connection spec ci-dessous, qui fournissent des informations supplémentaires sur l’emplacement des paramètres target spec dans la spécification de connexion. Vous pouvez également voir dans l’exemple ci-dessous les paramètres de cible et non applicables aux destinations d’exportation d’audience.
|
accordion | ||
---|---|---|
Azure Data Lake Gen 2(ADLS Gen2) - Connection spec présentant les paramètres de connexion cible | ||
Notez les lignes surlignées avec des commentaires intégrés dans l’exemple connection spec ci-dessous, qui fournissent des informations supplémentaires sur l’emplacement des paramètres target spec dans la spécification de connexion. Vous pouvez également voir dans l’exemple ci-dessous les paramètres de cible et non applicables aux destinations d’exportation d’audience.
|
accordion | ||
---|---|---|
Data Landing Zone(DLZ) - Connection spec présentant les paramètres de connexion cible | ||
Notez les lignes surlignées avec des commentaires intégrés dans l’exemple connection spec ci-dessous, qui fournissent des informations supplémentaires sur l’emplacement des paramètres target spec dans la spécification de connexion. Vous pouvez également voir dans l’exemple ci-dessous les paramètres de cible et non applicables aux destinations d’exportation d’audience.
|
accordion | ||
---|---|---|
Google Cloud Storage - Connection spec présentant les paramètres de connexion cible | ||
Notez les lignes surlignées avec des commentaires intégrés dans l’exemple connection spec ci-dessous, qui fournissent des informations supplémentaires sur l’emplacement des paramètres target spec dans la spécification de connexion. Vous pouvez également voir dans l’exemple ci-dessous les paramètres de cible et non applicables aux destinations d’exportation d’audience.
|
accordion | ||
---|---|---|
SFTP - Connection spec présentant les paramètres de connexion cible | ||
Notez les lignes surlignées avec des commentaires intégrés dans l’exemple connection spec ci-dessous, qui fournissent des informations supplémentaires sur l’emplacement des paramètres target spec dans la spécification de connexion. Vous pouvez également voir dans l’exemple ci-dessous les paramètres de cible et non applicables aux destinations d’exportation d’audience.
|
En utilisant la spécification ci-dessus, vous pouvez créer une requête de connexion cible spécifique à la destination de stockage dans le cloud souhaitée, comme indiqué dans les onglets ci-dessous.
Requête
accordion | |||||
---|---|---|---|---|---|
Amazon S3 - Requête de connexion Target | |||||
Notez les lignes surlignées avec des commentaires intégrés dans l’exemple de requête, qui fournissent des informations supplémentaires. Supprimez les commentaires insérés dans la requête lorsque vous copiez-collez la requête dans votre terminal de votre choix.
|
accordion | |||||
---|---|---|---|---|---|
Amazon S3 - Demande de connexion cible avec options CSV | |||||
|
Réponse
accordion | ||
---|---|---|
Connexion à Target - Réponse | ||
|
Requête
accordion | |||||
---|---|---|---|---|---|
Azure Blob Storage - Requête de connexion Target | |||||
Notez les lignes surlignées avec des commentaires intégrés dans l’exemple de requête, qui fournissent des informations supplémentaires. Supprimez les commentaires insérés dans la requête lorsque vous copiez-collez la requête dans votre terminal de votre choix.
|
accordion | |||||
---|---|---|---|---|---|
Azure Blob Storage - Demande de connexion cible avec options CSV | |||||
|
Réponse
accordion | ||
---|---|---|
Connexion à Target - Réponse | ||
|
Requête
accordion | |||||
---|---|---|---|---|---|
Azure Data Lake Gen 2(ADLS Gen2) - Requête de connexion Target | |||||
Notez les lignes surlignées avec des commentaires intégrés dans l’exemple de requête, qui fournissent des informations supplémentaires. Supprimez les commentaires insérés dans la requête lorsque vous copiez-collez la requête dans votre terminal de votre choix.
|
accordion | |||||
---|---|---|---|---|---|
Azure Data Lake Gen 2(ADLS Gen2) - Demande de connexion cible avec options CSV | |||||
|
Réponse
accordion | ||
---|---|---|
Connexion à Target - Réponse | ||
|
Requête
accordion | |||||
---|---|---|---|---|---|
Data Landing Zone - Requête de connexion Target | |||||
Notez les lignes surlignées avec des commentaires intégrés dans l’exemple de requête, qui fournissent des informations supplémentaires. Supprimez les commentaires insérés dans la requête lorsque vous copiez-collez la requête dans votre terminal de votre choix.
|
accordion | |||||
---|---|---|---|---|---|
Data Landing Zone - Demande de connexion cible avec options CSV | |||||
|
Réponse
accordion | ||
---|---|---|
Connexion à Target - Réponse | ||
|
Requête
accordion | |||||
---|---|---|---|---|---|
Google Cloud Storage - Requête de connexion Target | |||||
Notez les lignes surlignées avec des commentaires intégrés dans l’exemple de requête, qui fournissent des informations supplémentaires. Supprimez les commentaires insérés dans la requête lorsque vous copiez-collez la requête dans votre terminal de votre choix.
|
accordion | |||||
---|---|---|---|---|---|
Google Cloud Storage - Demande de connexion cible avec options CSV | |||||
|
Réponse
accordion | ||
---|---|---|
Connexion à Target - Réponse | ||
|
Requête
accordion | |||||
---|---|---|---|---|---|
SFTP - Demande de connexion Target | |||||
Notez les lignes surlignées avec des commentaires intégrés dans l’exemple de requête, qui fournissent des informations supplémentaires. Supprimez les commentaires insérés dans la requête lorsque vous copiez-collez la requête dans votre terminal de votre choix.
|
accordion | |||||
---|---|---|---|---|---|
SFTP : demande de connexion Target avec options CSV | |||||
|
Réponse
accordion | ||
---|---|---|
Connexion à Target - 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 relie les entités créées précédemment et fournit également des options pour configurer le planning d’exportation de l’audience. Pour créer le flux de données, utilisez les payloads ci-dessous, en fonction de la destination de stockage dans le cloud 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 relative à l’attribut ou au mappage d’identité au flux de données. Cela va suivre l'étape suivante.
Requête
accordion | ||
---|---|---|
Création d’un flux de données d’exportation d’audience vers la destination Amazon S3 - Requête | ||
Notez les lignes surlignées avec des commentaires intégrés dans l’exemple de requête, qui fournissent des informations supplémentaires. Supprimez les commentaires insérés dans la requête lorsque vous copiez-collez la requête dans votre terminal de votre choix.
|
Réponse
accordion | ||
---|---|---|
Créer un flux de données - Réponse | ||
|
Requête
accordion | ||
---|---|---|
Création d’un flux de données d’exportation d’audience vers la destination Azure Blob Storage - Requête | ||
Notez les lignes surlignées avec des commentaires intégrés dans l’exemple de requête, qui fournissent des informations supplémentaires. Supprimez les commentaires insérés dans la requête lorsque vous copiez-collez la requête dans votre terminal de votre choix.
|
Réponse
accordion | ||
---|---|---|
Créer un flux de données - Réponse | ||
|
Requête
accordion | ||
---|---|---|
Création d’un flux de données d’exportation d’audience vers la destination Azure Data Lake Gen 2(ADLS Gen2) - Requête | ||
Notez les lignes surlignées avec des commentaires intégrés dans l’exemple de requête, qui fournissent des informations supplémentaires. Supprimez les commentaires insérés dans la requête lorsque vous copiez-collez la requête dans votre terminal de votre choix.
|
Réponse
accordion | ||
---|---|---|
Créer un flux de données - Réponse | ||
|
Requête
accordion | ||
---|---|---|
Création d’un flux de données d’exportation d’audience vers la destination Data Landing Zone - Requête | ||
Notez les lignes surlignées avec des commentaires intégrés dans l’exemple de requête, qui fournissent des informations supplémentaires. Supprimez les commentaires insérés dans la requête lorsque vous copiez-collez la requête dans votre terminal de votre choix.
|
Réponse
accordion | ||
---|---|---|
Créer un flux de données - Réponse | ||
|
Requête
accordion | ||
---|---|---|
Création d’un flux de données d’exportation d’audience vers la destination Google Cloud Storage - Requête | ||
Notez les lignes surlignées avec des commentaires intégrés dans l’exemple de requête, qui fournissent des informations supplémentaires. Supprimez les commentaires insérés dans la requête lorsque vous copiez-collez la requête dans votre terminal de votre choix.
|
Réponse
accordion | ||
---|---|---|
Créer un flux de données - Réponse | ||
|
Requête
accordion | ||
---|---|---|
Création d’un flux de données d’exportation d’audience vers une destination SFTP - Requête | ||
Notez les lignes surlignées avec des commentaires intégrés dans l’exemple de requête, qui fournissent des informations supplémentaires. Supprimez les commentaires insérés dans la requête lorsque vous copiez-collez la requête dans votre terminal de votre choix.
|
Réponse
accordion | ||
---|---|---|
Créer un flux de données - Réponse | ||
|
Notez l’identifiant du flux de données de la réponse. Cet identifiant sera nécessaire lors d’étapes ultérieures.
Ajouter des audiences à l'export
Au cours de cette étape, vous pouvez également sélectionner les audiences à exporter vers la destination. Pour obtenir des informations détaillées sur cette étape et le format de requête afin d’ajouter une audience au flux de données, consultez les exemples de la section Mise à jour d’un flux de données de destination de la documentation de référence de l’API.
Configuration du 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 comprend trois étapes, répertoriées ci-dessous :
- Création d’un schéma d’entrée
- Création d’un schéma de sortie
- Configuration d’un jeu de mappages pour connecter les schémas créés
Par exemple, pour obtenir le mappage suivant affiché dans l’interface utilisateur, vous devez passer en revue les trois étapes répertoriées ci-dessus et détaillées 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 mapping source.
Vous trouverez ci-dessous des exemples de requêtes et de réponses pour récupérer des attributs et des identités.
Requête pour obtenir des attributs
code language-shell |
---|
|
Réponse
La réponse ci-dessous a été raccourcie pour plus de concision.
code language-json |
---|
|
Demande d’obtention d’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 custom que vous avez configurés 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 la réponse JSON entière 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 ultérieurement.
Création d’un schéma de sortie
Vous devez ensuite configurer le schéma de sortie de votre export. Tout d’abord, vous devez rechercher et examiner votre schéma de partenaire existant.
Requête
Notez que l’exemple ci-dessous utilise connection spec ID
pour Amazon S3. Remplacez 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
Inspect la réponse que vous obtenez lorsque vous effectuez l’appel ci-dessus. Vous devez descendre dans la hiérarchie de la réponse 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 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 ultérieurement.
Créer un jeu de mappages create-mapping-set
Ensuite, utilisez l’ API de préparation de données pour créer le jeu de mappages à l’aide de l’ID de schéma d’entrée, de l’ID de schéma de sortie et des mappages de champ souhaités.
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 que vous souhaitez mettre à jour.
Voir récupération des 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
du 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 de flux de données other-dataflow-updates
Pour mettre à 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, 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 à 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}
est l’identifiant de 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, 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 à 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}
est l’identifiant de 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 |
---|
|
Ajouter 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 à 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}
est l’identifiant de 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 |
---|
|
Validation du flux de données (Obtention des 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 des 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 Dataflow run dans la documentation de référence de l’API.
Gestion des erreurs d’API api-error-handling
Les points de terminaison d’API de ce tutoriel suivent les principes généraux des messages d’erreur de l’API d’Experience Platform. Pour plus d’informations sur l’interprétation des réponses d’erreur, reportez-vous aux codes d’état d’API et erreurs d’en-tête de requête dans le guide de dépannage de Platform.
Étapes suivantes next-steps
En suivant ce tutoriel, vous avez réussi à connecter 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 :