Opções de configuração para destinos de transmissão especificações do servidor e do modelo

Visão geral

As especificações do servidor e do modelo podem ser configuradas no Adobe Experience Platform Destination SDK por meio do endpoint comum /authoring/destination-servers. Ler Operações de endpoint da API de destinos para obter uma lista completa de operações que podem ser realizadas no ponto de extremidade.

Especificações do servidor

Configuração do servidor realçada

Os clientes poderão ativar os dados do Adobe Experience Platform para o seu destino por meio de exportações HTTP. A configuração do servidor contém informações sobre o servidor que recebe as mensagens (o servidor no seu lado).

Esse processo fornece dados do usuário como uma série de mensagens HTTP para sua plataforma de destino. Os parâmetros abaixo formam o modelo de especificações do servidor HTTP.

Parâmetro Tipo Descrição
name String Obrigatório. Representa um nome amigável do seu servidor, visível somente para o Adobe. Este nome não está visível para parceiros ou clientes. Exemplo Moviestar destination server.
destinationServerType String Obrigatório. Defina como URL_BASED para destinos de transmissão.
templatingStrategy String Obrigatório.
  • Use PEBBLE_V1 se estiver usando uma macro em vez de um valor fixo na value campo. Use essa opção se você tiver um terminal como: https://api.moviestar.com/data/{{customerData.region}}/items
  • Use NONE se nenhuma transformação for necessária no lado do Adobe, por exemplo, se você tiver um terminal como: https://api.moviestar.com/data/items
value String Obrigatório. Preencha o endereço do ponto de extremidade da API ao qual o Experience Platform deve se conectar.

Especificações do modelo

Configuração do modelo realçada

A especificação do modelo permite configurar como formatar a mensagem exportada para o destino. O Adobe usa uma linguagem de modelo semelhante a Jinja para transformar os campos do esquema XDM em um formato compatível com seu destino. Para obter mais informações sobre a transformação, visite os links abaixo:

DICA

O Adobe oferece um ferramenta desenvolvedor isso ajuda a criar e testar um template de transformação de mensagem.

Configuração de exemplo de destino de fluxo

{
   "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 Descrição
httpMethod String Obrigatório. O método que o Adobe usará nas chamadas para o seu servidor. As opções são GET, PUT, POST, DELETE, PATCH.
templatingStrategy String Obrigatório. Use PEBBLE_V1.
value String Obrigatório. Essa é a versão sem caracteres que transforma os dados dos clientes da Platform no formato que seu serviço espera.
Para obter informações sobre como gravar o modelo, leia o Uso da seção de modelos.
Para obter mais informações sobre o escape de caracteres, consulte Padrão RFC JSON, seção sete.
Para obter um exemplo de transformação simples, consulte Atributos do perfil transformação.
contentType String Obrigatório. O tipo de conteúdo que seu servidor aceita. Esse valor provavelmente application/json.

Nesta página