Création d’une configuration de destination
Cette page illustre la requête d’API et la payload que vous pouvez utiliser pour créer votre propre configuration de destination à l’aide du point d’entrée de l’API /authoring/destinations
.
Pour obtenir une description détaillée des fonctionnalités configurables avec ce point d’entrée, consultez les articles suivants :
- Configuration de l’authentification du client
- Autorisation OAuth2
- Champs de données client
- Attributs de l’interface utilisateur
- Configuration du schéma
- Configuration de l’espace de noms d’identité
- Diffusion de destination
- Configuration des métadonnées d’audience
- Configuration des métadonnées d’audience
- Politique d’agrégation
- Configuration par lots
- Qualifications des profils historiques
Prise en main des opérations dʼAPI de configuration de destinations get-started
Avant de poursuivre, consultez le guide de prise en main pour obtenir des informations importantes à connaître avant d’effectuer des appels vers l’API, notamment sur la manière d’obtenir l’autorisation de création de la destination et les en-têtes obligatoires.
Création d’une configuration de destination create
Vous pouvez créer une configuration de destination en effectuant une requête POST au point d’entrée /authoring/destinations
.
platform.adobe.io/data/core/activation/authoring/destinations
Format d’API
POST /authoring/destinations
La requête suivante crée une configuration de destination Amazon S3, configurée en fonction des paramètres fournis dans la payload. La payload ci-dessous inclut tous les paramètres des destinations basées sur des fichiers acceptés par le point d’entrée /authoring/destinations
.
Notez que vous n’avez pas à ajouter tous les paramètres à l’appel API et que la payload est personnalisable, conformément aux exigences de votre API.
code language-shell |
---|
|
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 7-row-3 8-row-3 9-row-3 10-row-3 11-row-3 12-row-3 13-row-3 14-row-3 15-row-3 16-row-3 17-row-3 18-row-3 19-row-3 20-row-3 21-row-3 22-row-3 23-row-3 24-row-3 25-row-3 26-row-3 27-row-3 28-row-3 29-row-3 30-row-3 31-row-3 layout-auto | ||
---|---|---|
Paramètre | Type | Description |
name |
Chaîne | Indique le titre de la destination dans le catalogue Experience Platform. |
description |
Chaîne | Fournissez une description qu’Adobe utilisera dans le catalogue des destinations Experience Platform pour votre carte de destination. N’utilisez pas plus de 4 à 5 phrases. {width="100" modal="regular"} |
status |
Chaîne | Indique le statut du cycle de vie de la carte de destination. Les valeurs acceptées sont TEST , PUBLISHED et DELETED . Utilisez TEST lorsque vous configurez votre destination pour la première fois. |
customerAuthenticationConfigurations.authType |
Chaîne | Indique la configuration utilisée pour authentifier la clientèle d’Experience Platform sur votre serveur de destination. Pour en savoir plus sur les types d’authentification pris en charge, consultez la configuration de l’authentification du client. |
customerDataFields.name |
Chaîne | Attribuez un nom au champ personnalisé que vous introduisez. Pour en savoir plus sur les types d’authentification pris en charge, consultez les champs de données client. {width="100" modal="regular"} |
customerDataFields.type |
Chaîne | Indique le type de champ personnalisé que vous introduisez. Les valeurs acceptées sont les suivantes : string , object ou integer .Pour en savoir plus sur les types d’authentification pris en charge, consultez les champs de données client. |
customerDataFields.title |
Chaîne | Indique le nom du champ tel qu’il est affiché par les clients dans l’interface utilisateur d’Experience Platform. Pour en savoir plus sur les types d’authentification pris en charge, consultez les champs de données client. |
customerDataFields.description |
Chaîne | Fournissez une description du champ personnalisé. Pour en savoir plus sur ces paramètres, consultez les champs de données client. |
customerDataFields.isRequired |
Booléen | Indique si ce champ est obligatoire dans le workflow de configuration de destination. Pour en savoir plus sur les types d’authentification pris en charge, consultez les champs de données client. |
customerDataFields.enum |
Chaîne | Rend le champ personnalisé sous forme de menu déroulant et répertorie les options disponibles pour l’utilisateur. Pour en savoir plus sur les types d’authentification pris en charge, consultez les champs de données client. |
customerDataFields.default |
Chaîne | Définit la valeur par défaut d’une liste enum . |
customerDataFields.pattern |
Chaîne | Impose un modèle pour le champ personnalisé, le cas échéant. Utilisez des expressions régulières pour appliquer un modèle. Par exemple, si vos identifiants de client n’incluent pas de chiffres ou de traits de soulignement, saisissez ^[A-Za-z]+$ dans ce champ.Pour en savoir plus sur les types d’authentification pris en charge, consultez les champs de données client. |
uiAttributes.documentationLink |
Chaîne | Fait référence à la page de documentation du Catalogue des destinations pour votre destination. Utilisez https://www.adobe.com/go/destinations-YOURDESTINATION-en , où YOURDESTINATION est le nom de votre destination. Par exemple, pour une destination appelée Moviestar, vous utiliseriez https://www.adobe.com/go/destinations-moviestar-en . Notez que ce lien ne fonctionne qu’une fois la destination mise en ligne par Adobe et la documentation publiée.Pour en savoir plus sur ces paramètres, consultez les attributs de l’interface utilisateur. {width="100" modal="regular"} |
uiAttributes.category |
Chaîne | Fait référence à la catégorie affectée à votre destination dans Adobe Experience Platform. Pour plus d’informations, consultez la section Catégories de destinations. Utilisez l’une des valeurs suivantes : adobeSolutions, advertising, analytics, cdp, cloudStorage, crm, customerSuccess, database, dmp, ecommerce, email, emailMarketing, enrichment, livechat, marketingAutomation, mobile, personalization, protocols, social, streaming, subscriptions, surveys, tagManagers, voc, warehouses, payments .Pour en savoir plus sur ces paramètres, consultez les attributs de l’interface utilisateur. |
uiAttributes.connectionType |
Chaîne |
Type de connexion en fonction de la destination. Valeurs prises en charge :
|
uiAttributes.frequency |
Chaîne | Fait référence au type d’exportation des données pris en charge par la destination. Définissez-le sur Streaming quand les intégrations sont basées sur des API, ou sur Batch lorsque vous exportez des fichiers vers les destinations. |
identityNamespaces.externalId.acceptsAttributes |
Booléen | Indique si la clientèle peut mapper des attributs de profil standard à l’identité que vous configurez. |
identityNamespaces.externalId.acceptsCustomNamespaces |
Booléen | Indique s’il est possible de mapper des identités appartenant à des espaces de noms personnalisés à l’identité que vous êtes en train de configurer. |
identityNamespaces.externalId.transformation |
Chaîne | Non affiché dans l’exemple de configuration. Utilisé, par exemple, lorsque le client Platform dispose d’adresses e-mail simples en tant qu’attribut et que votre plateforme accepte les e-mails hachés uniquement. C’est ici que vous devez fournir la transformation à appliquer (transformer l’adresse e-mail en minuscules, puis la hacher, par exemple). |
identityNamespaces.externalId.acceptedGlobalNamespaces |
- | Indique quels espaces de noms d’identité standard (par exemple, IDFA) la clientèle peut mapper à l’identité que vous configurez. Lorsque vous utilisez acceptedGlobalNamespaces , vous pouvez employer "requiredTransformation":"sha256(lower($))" pour mettre en minuscules ou hacher des adresses e-mails ou des numéros de téléphone. |
destinationDelivery.authenticationRule |
Chaîne |
Indique comment la clientèle Platform se connecte à votre destination. Les valeurs acceptées sont les suivantes :
|
destinationDelivery.destinationServerId |
Chaîne | instanceId du modèle de serveur de destination utilisé pour cette destination. |
backfillHistoricalProfileData |
Booléen | Contrôle si les données de profil historiques sont exportées quand les audiences sont activées vers la destination. Définissez toujours ce paramètre sur true . |
segmentMappingConfig.mapUserInput |
Booléen | Contrôle si l’identifiant de mappage d’audiences dans le workflow d’activation de destination est saisi par l’utilisateur ou l’utilisatrice. |
segmentMappingConfig.mapExperiencePlatformSegmentId |
Booléen | Contrôle si l’identifiant de mappage d’audience dans le workflow d’activation de destination est l’identifiant d’audience Experience Platform. |
segmentMappingConfig.mapExperiencePlatformSegmentName |
Booléen | Contrôle si l’identifiant de mappage d’audiences dans le workflow d’activation de destination est le nom de l’audience Experience Platform. |
segmentMappingConfig.audienceTemplateId |
Chaîne | instanceId du modèle de métadonnées d’audience utilisé pour cette destination. |
schemaConfig.profileFields |
Tableau | Lorsque vous ajoutez des champs profileFields prédéfinis, comme illustré dans la configuration ci-dessus, les utilisateurs ont la possibilité de mapper les attributs Experience Platform aux attributs prédéfinis du côté de votre destination. |
schemaConfig.profileRequired |
Booléen | Utilisez true si les utilisateurs doivent être en mesure de mapper les attributs de profil d’Experience Platform aux attributs personnalisés du côté de votre destination, comme indiqué dans l’exemple de configuration ci-dessus. |
schemaConfig.segmentRequired |
Booléen | Utilisez toujours segmentRequired:true . |
schemaConfig.identityRequired |
Booléen | Utilisez true si vous souhaitez que les utilisateurs puissent mapper des espaces de noms d’identité d’Experience Platform au schéma souhaité. |
Gestion des erreurs d’API
Les points d’entrée de l’API Destination SDK suivent les principes généraux des messages d’erreur de l’API Experience Platform. Consultez les sections Codes dʼétat d’API et Erreurs dʼen-tête de requête dans le guide de dépannage de Platform.
Étapes suivantes
Vous êtes arrivé au bout de ce document. À présent, vous savez comment créer une configuration de destination avec le point d’entrée /authoring/destinations
Destination SDK de l’API.
Pour en savoir plus sur les fonctionnalités offertes par ce point d’entrée, consultez les articles suivants :
Pour comprendre la place de ce point d’entrée dans le processus de création de destinations, consultez les articles suivants :