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

Visão geral

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

Exemplo de configuração

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

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. URL_BASED no momento, é a única opção disponível.
templatingStrategy String Obrigatório.
  • Use PEBBLE_V1 se o Adobe precisar transformar o URL no campo value abaixo. 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 uma ferramenta de desenvolvedor que ajuda a criar e testar um modelo de transformação de mensagem.

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 a seção Uso do modelo .
Para obter mais informações sobre o escape de caracteres, consulte o padrão JSON RFC, seção 7.
Para obter um exemplo de uma transformação simples, consulte a transformação dos atributos de perfil .
contentType String Obrigatório. O tipo de conteúdo que seu servidor aceita. Esse valor provavelmente é application/json.

Nesta página