Options de configuration des spécifications de serveur et de modèle

Présentation

Les spécifications du serveur et du modèle peuvent être configurées dans le SDK de destination Adobe Experience Platform via le point de terminaison commun /authoring/destination-servers. Lisez Opérations de point d’entrée de l’API Destinations pour obtenir la liste complète des opérations que vous pouvez effectuer sur le point d’entrée.

Exemple de configuration

{
   "name":"Moviestar destination server",
   "destinationServerType":"URL_BASED",
   "urlBasedDestination":{
      "url":{
         "templatingStrategy":"PEBBLE_V1",
         "value":"https://api.moviestar.com/data/{{customerData.region}}/items"
      }
   },
   "httpTemplate":{
      "httpMethod":"POST",
      "requestBody":{
         "templatingStrategy":"PEBBLE_V1",
         "value":"{ \"attributes\": [ {% for ns in [\"external_id\", \"yourdestination_id\"] %} {% if input.profile.identityMap[ns] is not empty and first_namespace_encountered %} , {% endif %} {% set first_namespace_encountered = true %} {% for identity in input.profile.identityMap[ns]%} { \"{{ ns }}\": \"{{ identity.id }}\" {% if input.profile.segmentMembership.ups is not empty %} , \"AEPSegments\": { \"add\": [ {% for segment in input.profile.segmentMembership.ups %} {% if segment.value.status == \"realized\" or segment.value.status == \"existing\" %} {% if added_segment_found %} , {% endif %} {% set added_segment_found = true %} \"{{ destination.segmentAliases[segment.key] }}\" {% endif %} {% endfor %} ], \"remove\": [ {% for segment in input.profile.segmentMembership.ups %} {% if segment.value.status == \"exited\" %} {% if removed_segment_found %} , {% endif %} {% set removed_segment_found = true %} \"{{ destination.segmentAliases[segment.key] }}\" {% endif %} {% endfor %} ] } {% set removed_segment_found = false %} {% set added_segment_found = false %} {% endif %} {% if input.profile.attributes is not empty %} , {% endif %} {% for attribute in input.profile.attributes %} \"{{ attribute.key }}\": {% if attribute.value is empty %} null {% else %} \"{{ attribute.value.value }}\" {% endif %} {% if not loop.last%} , {% endif %} {% endfor %} } {% if not loop.last %} , {% endif %} {% endfor %} {% endfor %} ] }"
      },
      "contentType":"application/json"
   }
}

Spécifications du serveur

Configuration du serveur mise en surbrillance

Les clients pourront activer les données de Adobe Experience Platform vers votre destination par le biais d’exportations HTTP. La configuration du serveur contient des informations sur le serveur recevant les messages (le serveur de votre côté).

Ce processus fournit des données utilisateur sous la forme d’une série de messages HTTP vers votre plateforme de destination. Les paramètres ci-dessous forment le modèle de spécifications du serveur HTTP.

Paramètre Type Description
name Chaîne Obligatoire. Représente un nom convivial de votre serveur, visible uniquement par Adobe. Ce nom n’est pas visible par les partenaires ou les clients. Exemple Moviestar destination server.
destinationServerType Chaîne Obligatoire. URL_BASED est actuellement la seule option disponible.
templatingStrategy Chaîne Obligatoire.
  • Utilisez PEBBLE_V1 si l’Adobe doit transformer l’URL dans le champ value ci-dessous. Utilisez cette option si vous disposez d’un point de terminaison du type : https://api.moviestar.com/data/{{customerData.region}}/items
  • Utilisez NONE si aucune transformation n’est nécessaire côté Adobe, par exemple si vous avez un point de terminaison comme : https://api.moviestar.com/data/items
value Chaîne Obligatoire. Renseignez l’adresse du point de terminaison de l’API auquel l’Experience Platform doit se connecter.

Spécifications des modèles

Mise en surbrillance de la configuration des modèles

La spécification du modèle vous permet de configurer le format du message exporté vers votre destination. Adobe utilise un langage de modèle similaire à Jinja pour transformer les champs du schéma XDM en un format pris en charge par votre destination. Pour plus d’informations sur la transformation, consultez les liens ci-dessous :

CONSEIL

Adobe propose un outil de développement qui permet de créer et de tester un modèle de transformation des messages.

Paramètre Type Description
httpMethod Chaîne Obligatoire. Méthode que l’Adobe utilisera dans les appels à votre serveur. Les options sont GET, PUT, POST, DELETE, PATCH.
templatingStrategy Chaîne Obligatoire. Utilisation PEBBLE_V1.
value Chaîne Obligatoire. Cette chaîne est la version avec échappement par des caractères qui transforme les données des clients Platform au format attendu par votre service.
Pour plus d’informations sur l’écriture du modèle, consultez la section Utilisation de modèles.
Pour plus d’informations sur l’échappement des caractères, reportez-vous à la norme RFC JSON, section 7.
Pour un exemple de transformation simple, reportez-vous à la transformation Attributs de profil .
contentType Chaîne Obligatoire. Type de contenu que votre serveur accepte. Cette valeur est probablement application/json.

Sur cette page