Opciones de configuración para especificaciones de servidor y plantilla

Información general

Las especificaciones de servidor y plantilla se pueden configurar en el SDK de destino de Adobe Experience Platform a través del extremo común /authoring/destination-servers. Lea Destinations API endpoint operations para obtener una lista completa de las operaciones que puede realizar en el punto final.

Ejemplo de configuración

{
   "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"
   }
}

Especificaciones del servidor

Configuración del servidor resaltada

Los clientes podrán activar datos desde Adobe Experience Platform a su destino mediante exportaciones HTTP. La configuración del servidor contiene información sobre el servidor que recibe los mensajes (el servidor de su parte).

Este proceso envía datos de usuario como una serie de mensajes HTTP a la plataforma de destino. Los parámetros siguientes forman la plantilla de especificaciones del servidor HTTP.

Parámetro Tipo Descripción
name Cadena Requerido. Representa un nombre descriptivo del servidor, visible solo para el Adobe. Este nombre no es visible para socios o clientes. Ejemplo Moviestar destination server.
destinationServerType Cadena Requerido. URL_BASED actualmente es la única opción disponible.
templatingStrategy Cadena Requerido.
  • Utilice PEBBLE_V1 si el Adobe necesita transformar la dirección URL en el campo value que aparece a continuación. Utilice esta opción si tiene un punto final como: https://api.moviestar.com/data/{{customerData.region}}/items
  • Utilice NONE si no se necesita ninguna transformación en el lado del Adobe, por ejemplo si tiene un punto final como: https://api.moviestar.com/data/items
value Cadena Requerido. Rellene la dirección del extremo de API al que se debe conectar el Experience Platform.

Especificaciones de plantilla

Configuración de plantilla resaltada

La especificación de plantilla le permite configurar cómo dar formato al mensaje exportado a su destino. Adobe utiliza un lenguaje de plantilla similar a Jinja para transformar los campos del esquema XDM en un formato compatible con el destino. Para obtener más información sobre la transformación, visite los vínculos siguientes:

SUGERENCIA

Adobe ofrece una herramienta para desarrolladores que le ayuda a crear y probar una plantilla de transformación de mensajes.

Parámetro Tipo Descripción
httpMethod Cadena Requerido. Método que Adobe utilizará en las llamadas al servidor. Las opciones son GET, PUT, POST, DELETE, PATCH.
templatingStrategy Cadena Requerido. En su lugar, utilice PEBBLE_V1.
value Cadena Requerido. Esta cadena es la versión con caracteres de escape que transforma los datos de los clientes de Platform al formato que el servicio espera.
Para obtener información sobre cómo escribir la plantilla, lea la sección Uso de plantillas .
Para obtener más información sobre el escape de caracteres, consulte el estándar JSON RFC, sección siete.
Para ver un ejemplo de transformación sencilla, consulte la transformación Atributo de perfil.
contentType Cadena Requerido. El tipo de contenido que acepta el servidor. Es muy probable que este valor sea application/json.

En esta página