Opciones de configuración para destinos de flujo continuo especificaciones de servidor y plantilla

Información general

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

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. Establecer como URL_BASED para destinos de flujo continuo.
templatingStrategy Cadena Requerido.
  • Uso PEBBLE_V1 si utiliza una macro en lugar de un valor fijo en la variable value campo . Utilice esta opción si tiene un punto final como: https://api.moviestar.com/data/{{customerData.region}}/items
  • Uso 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 idioma de plantilla similar al 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

El Adobe ofrece un herramienta para desarrolladores esto le ayuda a crear y probar una plantilla de transformación de mensaje.

Configuración de ejemplo de destino de transmisión

{
   "name":"Moviestar destination server",
   "destinationServerType":"URL_BASED",
   "urlBasedDestination":{
      "url":{
         "templatingStrategy":"PEBBLE_V1",
         "value":"https://api.moviestar.com/data/{{customerData.endpointRegion}}/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"
   }
}
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 Uso de la sección de plantilla.
Para obtener más información sobre el escape de caracteres, consulte la sección RFC JSON estándar, sección siete.
Para ver un ejemplo de transformación sencilla, consulte la sección Atributos de perfil transformación.
contentType Cadena Requerido. El tipo de contenido que acepta el servidor. Es muy probable que este valor application/json.

En esta página