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 la variable API de service de flux pour 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 de votre Real-Time Customer Profile data.
- 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 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.
Pour exporter identités, vous avez besoin de la fonction Affichage du graphique des identités autorisation de contrôle d’accè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 à Platform API, vous devez d’abord renseigner la variable Tutoriel sur l’authentification des 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 un 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. Voir Service de flux - Documentation de l’API Destinations 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 une description des termes que vous rencontrerez dans ce tutoriel sur l’API, consultez la rubrique section glossaire de la documentation de référence de 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 | ||
---|---|---|
Retrieve connection spec pour Amazon S3 | ||
|
Réponse
accordion | ||
---|---|---|
Amazon S3 - Spécification de la connexion | ||
|
Requête
accordion | ||
---|---|---|
Retrieve connection spec pour Azure Blob Storage | ||
|
Réponse
accordion | ||
---|---|---|
Azure Blob Storage - Connection spec | ||
|
Requête
accordion | ||
---|---|---|
Retrieve 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 | ||
---|---|---|
Retrieve connection spec pour Data Landing Zone(DLZ) | ||
|
Réponse
accordion | ||
---|---|---|
Data Landing Zone(DLZ) - Connection spec | ||
|
Requête
accordion | ||
---|---|---|
Retrieve connection spec pour Google Cloud Storage | ||
|
Réponse
accordion | ||
---|---|---|
Google Cloud Storage - Connection spec | ||
|
Requête
accordion | ||
---|---|---|
Retrieve 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 la variable connection spec
et flow spec
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 variable connexion source représente la connexion à l’interface Boutique de profils Experience Platform.
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
A connexion de base stocke en toute sécurité les informations d’identification dans votre destination. Selon le type de destination, les informations d’identification nécessaires pour s’authentifier sur cette destination peuvent varier. Pour rechercher ces paramètres d’authentification, récupérez d’abord la variable connection spec
pour la destination souhaitée, comme décrit dans la section Sélectionner la destination vers laquelle exporter les audiences et puis regardez le authSpec
de la réponse. Référencez les onglets ci-dessous pour le authSpec
propriétés de toutes les destinations prises en charge.
accordion | ||
---|---|---|
Amazon S3 - Connection spec affichage auth spec | ||
Notez la ligne mise en surbrillance avec les commentaires insérés dans la connection spec l’exemple ci-dessous, qui fournit des informations supplémentaires sur l’emplacement des paramètres d’authentification dans la variable connection spec.
|
accordion | ||
---|---|---|
Azure Blob Storage - Connection spec affichage auth spec | ||
Notez la ligne mise en surbrillance avec les commentaires insérés dans la connection spec l’exemple ci-dessous, qui fournit des informations supplémentaires sur l’emplacement des paramètres d’authentification dans la variable connection spec.
|
accordion | ||
---|---|---|
Azure Data Lake Gen 2(ADLS Gen2) - Connection spec affichage auth spec | ||
Notez la ligne mise en surbrillance avec les commentaires insérés dans la connection spec l’exemple ci-dessous, qui fournit des informations supplémentaires sur l’emplacement des paramètres d’authentification dans la variable connection spec.
|
accordion | |||||
---|---|---|---|---|---|
Data Landing Zone(DLZ) - Connection spec affichage auth spec | |||||
|
accordion | ||
---|---|---|
Google Cloud Storage - Connection spec affichage auth spec | ||
Notez la ligne mise en surbrillance avec les commentaires insérés dans la connection spec l’exemple ci-dessous, qui fournit des informations supplémentaires sur l’emplacement des paramètres d’authentification dans la variable connection spec.
|
accordion | |||||
---|---|---|---|---|---|
SFTP - Connection spec affichage auth spec | |||||
Notez la ligne mise en surbrillance avec les commentaires insérés dans la connection spec l’exemple ci-dessous, qui fournit des informations supplémentaires sur l’emplacement des paramètres d’authentification dans la variable connection spec.
|
En utilisant les propriétés spécifiées dans la spécification d’authentification (c.-à-d. 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 par clé d’accès et 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ée | |||||
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 la 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 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 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. Connexions à Target stockent les paramètres d'export 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 page des configurations de mise en forme des fichiers.
Voir targetSpec
propriétés fournies dans la variable connection spec
pour comprendre les propriétés prises en charge pour chaque type de destination. Référencez les onglets ci-dessous pour le targetSpec
propriétés de toutes les destinations prises en charge.
accordion | ||
---|---|---|
Amazon S3 - Connection spec affichage des paramètres de connexion cible | ||
Notez les lignes surlignées avec des commentaires intégrés dans la variable connection spec exemple ci-dessous, qui fournit des informations supplémentaires sur l’emplacement de la variable target spec dans la spécification de connexion. Vous pouvez également voir dans l’exemple ci-dessous les paramètres de cible not applicable aux destinations d’exportation d’audience.
|
accordion | ||
---|---|---|
Azure Blob Storage - Connection spec affichage des paramètres de connexion cible | ||
Notez les lignes surlignées avec des commentaires intégrés dans la variable connection spec exemple ci-dessous, qui fournit des informations supplémentaires sur l’emplacement de la variable target spec dans la spécification de connexion. Vous pouvez également voir dans l’exemple ci-dessous les paramètres de cible not applicable aux destinations d’exportation d’audience.
|
accordion | ||
---|---|---|
Azure Data Lake Gen 2(ADLS Gen2) - Connection spec affichage des paramètres de connexion cible | ||
Notez les lignes surlignées avec des commentaires intégrés dans la variable connection spec exemple ci-dessous, qui fournit des informations supplémentaires sur l’emplacement de la variable target spec dans la spécification de connexion. Vous pouvez également voir dans l’exemple ci-dessous les paramètres de cible not applicable aux destinations d’exportation d’audience.
|
accordion | ||
---|---|---|
Data Landing Zone(DLZ) - Connection spec affichage des paramètres de connexion cible | ||
Notez les lignes surlignées avec des commentaires intégrés dans la variable connection spec exemple ci-dessous, qui fournit des informations supplémentaires sur l’emplacement de la variable target spec dans la spécification de connexion. Vous pouvez également voir dans l’exemple ci-dessous les paramètres de cible not applicable aux destinations d’exportation d’audience.
|
accordion | ||
---|---|---|
Google Cloud Storage - Connection spec affichage des paramètres de connexion cible | ||
Notez les lignes surlignées avec des commentaires intégrés dans la variable connection spec exemple ci-dessous, qui fournit des informations supplémentaires sur l’emplacement de la variable target spec dans la spécification de connexion. Vous pouvez également voir dans l’exemple ci-dessous les paramètres de cible not applicable aux destinations d’exportation d’audience.
|
accordion | ||
---|---|---|
SFTP - Connection spec affichage des paramètres de connexion cible | ||
Notez les lignes surlignées avec des commentaires intégrés dans la variable connection spec exemple ci-dessous, qui fournit des informations supplémentaires sur l’emplacement de la variable target spec dans la spécification de connexion. Vous pouvez également voir dans l’exemple ci-dessous les paramètres de cible not applicable 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 - 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 | |||||
---|---|---|---|---|---|
Amazon S3 - Demande de connexion Target avec les options CSV | |||||
|
Réponse
accordion | ||
---|---|---|
Connexion à Target - Réponse | ||
|
Requête
accordion | |||||
---|---|---|---|---|---|
Azure Blob Storage - 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 | |||||
---|---|---|---|---|---|
Azure Blob Storage - Demande de connexion Target avec les options CSV | |||||
|
Réponse
accordion | ||
---|---|---|
Connexion à Target - Réponse | ||
|
Requête
accordion | |||||
---|---|---|---|---|---|
Azure Data Lake Gen 2(ADLS Gen2) - 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 | |||||
---|---|---|---|---|---|
Azure Data Lake Gen 2(ADLS Gen2) - Demande de connexion Target avec les options CSV | |||||
|
Réponse
accordion | ||
---|---|---|
Connexion à Target - Réponse | ||
|
Requête
accordion | |||||
---|---|---|---|---|---|
Data Landing Zone - 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 | |||||
---|---|---|---|---|---|
Data Landing Zone - Demande de connexion Target avec les options CSV | |||||
|
Réponse
accordion | ||
---|---|---|
Connexion à Target - Réponse | ||
|
Requête
accordion | |||||
---|---|---|---|---|---|
Google Cloud Storage - 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 | |||||
---|---|---|---|---|---|
Google Cloud Storage - Demande de connexion Target avec les 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 que 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 une 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. A dataflow associe 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 Amazon S3 destination - 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 Azure Blob Storage destination - 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 Azure Data Lake Gen 2(ADLS Gen2) destination - 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 Data Landing Zone destination - 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 Google Cloud Storage destination - 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 Mettre à jour un flux de données de destination de la documentation de référence sur les 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.
Demande d’obtention d’attributs
code language-shell |
---|
|
Réponse
La réponse ci-dessous a été raccourcie pour plus de concision.
code language-json |
---|
|
Requête 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 deux standard et custom espaces de noms d’identité 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 la réponse JSON entière de la réponse ci-dessus et la placer dans la variable jsonSchema
comme 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 la variable 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 le 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 la méthode API de préparation des données pour créer le mappage défini à l’aide de l’identifiant de schéma d’entrée, de l’identifiant 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
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 de flux de données other-dataflow-updates
Pour mettre à jour votre flux de données, utilisez la variable PATCH
opération. 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
Un en-tête est requis lors de la création d’une PATCH
requête. 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}
point de terminaison , où {ID}
est l’identifiant de flux de données que vous souhaitez mettre à jour.If-Match
en-tête entre guillemets doubles comme dans les exemples ci-dessous lors de l’exécution de PATCH
requêtes.Requête
code language-shell |
---|
|
Réponse
Une réponse réussie renvoie un code de réponse 200
ainsi que l’identifiant du flux de données mis à jour et l’eTag 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
Un en-tête est requis lors de la création d’une PATCH
requête. 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}
point de terminaison , où {ID}
est l’identifiant de flux de données que vous souhaitez mettre à jour.If-Match
en-tête entre guillemets doubles comme dans les exemples ci-dessous lors de l’exécution de PATCH
requêtes.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, voir les exemples de requête et de réponse ci-dessous
If-Match
Un en-tête est requis lors de la création d’une PATCH
requête. 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}
point de terminaison , où {ID}
est l’identifiant de flux de données que vous souhaitez mettre à jour.If-Match
en-tête entre guillemets doubles comme dans les exemples ci-dessous lors de l’exécution de PATCH
requêtes.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 la variable divers 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. Voir Codes d’état d’API et erreurs d’en-tête de requête dans le guide de dépannage de Platform pour plus d’informations sur l’interprétation des réponses d’erreur.
É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 :