Cette configuration vous permet d’indiquer les informations essentielles à votre destination de diffusion en continu, telles que votre nom de destination, votre catégorie, votre description, etc. Les paramètres de cette configuration déterminent également comment les utilisateurs d’Experience Platform s’authentifient pour votre destination, comment ils apparaissent dans l’interface utilisateur d’Experience Platform ainsi que les identités qui peuvent être exportées vers votre destination.
Cette configuration connecte également les autres configurations requises pour que votre destination fonctionne (métadonnées de serveur de destination et d’audience) à celle-ci. Découvrez comment vous pouvez référencer les deux configurations dans une section ci-dessous.
Vous pouvez configurer la fonctionnalité décrite dans ce document à l’aide du point d’entrée de l’API /authoring/destinations
. Consultez Opérations de point d’entrée de l’API Destinations pour obtenir une liste complète des opérations que vous pouvez effectuer sur le point d’entrée.
Voici un exemple de configuration d’une destination fictive de diffusion en continu, Moviestar, qui dispose de points d’entrée dans quatre endroits sur le globe. La destination appartient à la catégorie des destinations mobiles.
{
"name":"Moviestar",
"description":"Moviestar is a fictional destination, used for this example.",
"status":"TEST",
"customerAuthenticationConfigurations":[
{
"authType":"BEARER"
}
],
"customerDataFields":[
{
"name":"endpointRegion",
"type":"string",
"title":"Select Endpoint",
"description":"Moviestar manages several instances across the globe for REST endpoints that our customers are provisioned for. Select your endpoint in the dropdown list.",
"isRequired":true,
"enum":[
"US",
"EU",
"APAC",
"NZ"
]
},
{
"name":"customerID",
"type":"string",
"title":"Moviestar Customer ID",
"description":"Your customer ID in the Moviestar destination (e.g. abcdef).",
"isRequired":true,
"pattern":"^[A-Za-z]+$"
}
],
"uiAttributes":{
"documentationLink":"http://www.adobe.com/go/destinations-moviestar-en",
"category":"mobile",
"connectionType":"Server-to-server",
"frequency":"Streaming"
},
"identityNamespaces":{
"external_id":{
"acceptsAttributes":true,
"acceptsCustomNamespaces":true,
"acceptedGlobalNamespaces":{
"Email":{
}
}
},
"another_id":{
"acceptsAttributes":true,
"acceptsCustomNamespaces":true
}
},
"schemaConfig":{
"profileRequired":false,
"segmentRequired":true,
"identityRequired":true
},
"destinationDelivery":[
{
"authenticationRule":"CUSTOMER_AUTHENTICATION",
"destinationServerId":"9c77000a-4559-40ae-9119-a04324a3ecd4"
}
],
"segmentMappingConfig":{
"mapExperiencePlatformSegmentName":false,
"mapExperiencePlatformSegmentId":false,
"mapUserInput":false,
"audienceTemplateId":"cbf90a70-96b4-437b-86be-522fbdaabe9c"
},
"aggregation":{
"aggregationType":"CONFIGURABLE_AGGREGATION",
"configurableAggregation":{
"splitUserById":true,
"maxBatchAgeInSecs":2400,
"maxNumEventsInBatch":5000,
"aggregationKey":{
"includeSegmentId":true,
"includeSegmentStatus":true,
"includeIdentity":true,
"oneIdentityPerGroup":true,
"groups":[
{
"namespaces":[
"IDFA",
"GAID"
]
},
{
"namespaces":[
"EMAIL"
]
}
]
}
}
},
"backfillHistoricalProfileData":true
}
Paramètre | Type | Description |
---|---|---|
name |
Chaîne | Indique le titre de votre destination dans le catalogue Experience Platform. |
description |
Chaîne | Fournissez une description de votre carte de destination dans le catalogue des destinations Experience Platform. N’utilisez pas plus de 4 à 5 phrases. |
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. |
Cette section de la configuration des destinations génère la page Configurer une nouvelle destination dans l’interface utilisateur d’Experience Platform, où les utilisateurs connectent Experience Platform aux comptes qu’ils possèdent avec votre destination. Selon l’option d’authentification que vous indiquez dans le champ authType
, la page Experience Platform est générée pour les utilisateurs comme suit :
Lorsque vous configurez le type d’authentification du porteur, les utilisateurs doivent saisir le jeton du porteur qu’ils obtiennent de votre destination.
Les utilisateurs sélectionnent Se connecter à la destination pour déclencher le flux d’authentification OAuth 2 vers votre destination, comme illustré dans l’exemple ci-dessous pour la destination Audiences personnalisées de Twitter. Pour plus d’informations sur la configuration de l’authentification OAuth 2 à votre point d’entrée de destination, consultez la page Authentification OAuth 2 de Destination SDK.
Paramètre | Type | Description |
---|---|---|
customerAuthenticationConfigurations |
Chaîne | Indique la configuration utilisée pour authentifier les clients Experience Platform sur votre serveur. Consultez authType ci-dessous pour les valeurs acceptées. |
authType |
Chaîne | Les valeurs acceptées pour les destinations de diffusion en continu sont les suivantes :
|
Utilisez cette section pour demander aux utilisateurs de renseigner des champs personnalisés, spécifiques à votre destination, lors de la connexion à la destination dans l’interface utilisateur d’Experience Platform. La configuration se reflète dans le flux d’authentification comme illustré ci-dessous.
Vous pouvez accéder aux entrées client des champs de données client et les utiliser dans un modèle. Utilisation de la macro {{customerData.name}}
. Par exemple, si vous demandez aux utilisateurs de saisir un champ ID de client, avec le nom userId
, vous pouvez y accéder dans un modèle à l’aide de la macro . {{customerData.userId}}
. Affichez un exemple d’utilisation d’un champ de données client dans l’URL de votre point de terminaison API, dans la variable configuration du serveur de destination.
Paramètre | Type | Description |
---|---|---|
name |
Chaîne | Attribuez un nom au champ personnalisé que vous introduisez. |
type |
Chaîne | Indique le type de champ personnalisé que vous introduisez. Les valeurs acceptées sont les suivantes : string , object ou integer . |
title |
Chaîne | Indique le nom du champ tel qu’il est affiché par les clients dans l’interface utilisateur d’Experience Platform. |
description |
Chaîne | Fournissez une description du champ personnalisé. |
isRequired |
Booléen | Indique si ce champ est requis dans le workflow de configuration de destination. |
enum |
Chaîne | Rend le champ personnalisé sous forme de menu déroulant et répertorie les options disponibles pour l’utilisateur. |
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. |
Cette section fait référence aux éléments de l’interface utilisateur dans la configuration ci-dessus qu’Adobe doit utiliser pour votre destination dans l’interface utilisateur d’Adobe Experience Platform. Consultez le tableau ci-dessous :
Paramètre | Type | Description |
---|---|---|
documentationLink |
Chaîne | Fait référence à la page de documentation du Catalogue des destinations pour votre destination. Utilisez http://www.adobe.com/go/destinations-YOURDESTINATION-en , où YOURDESTINATION est le nom de votre destination. Par exemple, pour une destination appelée Moviestar, procédez comme suit : http://www.adobe.com/go/destinations-moviestar-en . Notez que ce lien ne fonctionne qu’après que Adobe a défini votre destination et que la documentation a été publiée. |
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 . Notez que vous ne pouvez actuellement sélectionner qu’une seule catégorie par destination. |
connectionType |
Chaîne | Server-to-server est actuellement la seule option disponible. |
frequency |
Chaîne | Fait référence au type d’exportation des données pris en charge par la destination. Valeurs prises en charge :
|
Utilisez les paramètres de la section schemaConfig
pour activer l’étape de mappage du workflow d’activation de destination. En utilisant les paramètres décrits ci-dessous, vous pouvez déterminer si les utilisateurs Experience Platform peuvent mapper des attributs de profil et/ou des identités au schéma souhaité du côté de votre destination.
Paramètre | Type | Description |
---|---|---|
profileFields |
Tableau | Non affiché dans l’exemple de configuration ci-dessus. Lorsque vous ajoutez des champs profileFields prédéfinis, les utilisateurs Experience Platform ont la possibilité de mapper les attributs de Platform aux attributs prédéfinis du côté de votre destination. |
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, tel qu’indiqué dans l’exemple de configuration ci-dessus. |
segmentRequired |
Booléen | Utilisez toujours segmentRequired:true . |
identityRequired |
Booléen | Utilisez true si les utilisateurs doivent être en mesure de mapper des espaces de noms d’identité d’Experience Platform à votre schéma souhaité. |
Les paramètres de cette section déterminent les identités acceptées par votre destination. Cette configuration renseigne également les identités et les attributs cibles dans l’étape de mappage de l’interface utilisateur dʼExperience Platform, où les utilisateurs mappent les identités et les attributs de leurs schémas XDM au schéma de votre destination.
Vous devez indiquer quelles identités Platform les clients peuvent exporter vers votre destination. Voici quelques exemples : Experience Cloud ID, e-mail haché, identifiant de l’appareil (IDFA, GAID). Ces valeurs sont les suivantes : espaces de noms d’identité Platform que les clients peuvent mapper aux espaces de noms d’identité de votre destination. Vous pouvez également indiquer si les clients peuvent mapper des espaces de noms personnalisés à des identités prises en charge par votre destination (acceptsCustomNamespaces: true
) et si les clients peuvent mapper des attributs XDM standard à des identités prises en charge par votre destination (acceptsAttributes: true
).
Les espaces de noms d’identité ne nécessitent pas de correspondance 1-1 entre Platform et votre destination.
Par exemple, les clients peuvent mapper un espace de nom Platform IDFA à un espace de noms IDFA depuis votre destination ou mapper le même espace de noms Platform IDFA à un espace de noms Customer ID dans votre destination.
En savoir plus sur les identités dans Présentation d’Identity Namespace.
Paramètre | Type | Description |
---|---|---|
acceptsAttributes |
Booléen | Indique si les clients peuvent mapper des attributs de profil standard à l’identité que vous configurez. |
acceptsCustomNamespaces |
Booléen | Indique si les clients peuvent configurer des espaces de noms personnalisés dans votre destination. |
transformation |
Chaîne | Non affiché dans l’exemple de configuration. Utilisé, par exemple, lorsque le client Platform dispose d’adresses électroniques simples en tant qu’attribut et que votre plateforme accepte les e-mails hachés uniquement. Dans cet objet, vous pouvez effectuer la transformation qui doit être appliquée (par exemple, transformer l’e-mail en minuscules, puis en hachage). Pour consulter un exemple, reportez-vous à la section requiredTransformation dans la référence de l’API de configuration de destination. |
acceptedGlobalNamespaces |
- | Indique : espaces de noms d’identité standard (par exemple, les clients IDFA) peuvent 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. |
Paramètre | Type | Description |
---|---|---|
authenticationRule |
Chaîne | Indique comment les clients Platform se connectent à votre destination. Les valeurs acceptées sont les suivantes : CUSTOMER_AUTHENTICATION , PLATFORM_AUTHENTICATION , NONE .
|
destinationServerId |
Chaîne | L’instanceId de la configuration du serveur de destination utilisé pour cette destination. |
Cette section de la configuration de destination concerne la manière dont les métadonnées de segment telles que les noms ou les identifiants doivent être partagées entre Experience Platform et votre destination.
Par le biais de audienceTemplateId
, cette section associe également cette configuration à la configuration des métadonnées d’audience.
Les paramètres affichés dans la configuration ci-dessus sont décrits dans la référence de l’API de point d’entrée des destinations.
Cette section vous permet de définir les stratégies d’agrégation qu’Experience Platform doit utiliser lors de l’exportation de données vers votre destination.
Une stratégie d’agrégation détermine la manière dont les profils exportés sont combinés dans les exportations de données. Les options disponibles sont les suivantes :
Lisez la section relative à l’utilisation de modèles ainsi que les exemples de clés d’agrégation pour comprendre comment inclure la stratégie d’agrégation dans votre modèle de transformation des messages en fonction de votre stratégie d’agrégation sélectionnée.
Utilisez cette option si votre point d’entrée API accepte moins de 100 profils par appel API.
Cette option fonctionne mieux pour les destinations qui préfèrent moins de profils par requête et qui préfèrent recevoir plus de requêtes avec moins de données que de requêtes avec plus de données.
Utilisez le paramètre maxUsersPerRequest
pour spécifier le nombre maximal de profils que votre destination peut prendre dans une requête.
Cette option fonctionne mieux si vous préférez accepter des lots volumineux, avec des milliers de profils sur le même appel. Cette option permet également d’agréger les profils exportés en fonction de règles d’agrégation complexes.
Cette option vous permet d’effectuer les opérations suivantes :
Lorsque vous utilisez l’option d’agrégation configurable pour votre destination, gardez à l’esprit les valeurs minimale et maximale que vous pouvez utiliser pour les deux paramètres. maxBatchAgeInSecs
(1 800 au minimum et 3 600 au maximum) et maxNumEventsInBatch
(minimum 1 000, maximum 10 000).
Pour des explications détaillées des paramètres d’agrégation, reportez-vous à la page de référence Opérations de point d’entrée de l’API Destinations, où chaque paramètre est décrit.
Vous pouvez utiliser le paramètre backfillHistoricalProfileData
dans la configuration des destinations pour déterminer si les qualifications des profils historiques doivent être exportées vers votre destination.
Paramètre | Type | Description |
---|---|---|
backfillHistoricalProfileData |
Booléen | Contrôle si les données de profil historiques sont exportées lorsque les segments sont activés vers la destination.
|
Certains de vos paramètres de destination doivent être configurés via le serveur de destination ou la configuration des métadonnées d’audience. La configuration de destination décrite ici connecte tous ces paramètres en référençant les deux autres configurations comme suit :
destinationServerId
pour référencer la configuration du serveur de destination et du modèle pour votre destination.audienceMetadataId
pour référencer la configuration des métadonnées d’audience pour votre destination.