Opzioni di configurazione per le specifiche del server e del modello

Panoramica

Le specifiche del server e del modello possono essere configurate in Adobe Experience Platform Destination SDK tramite l'endpoint comune /authoring/destination-servers. Leggi Operazioni endpoint API delle destinazioni per un elenco completo delle operazioni che puoi eseguire sull'endpoint.

Esempio di configurazione

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

Specifiche del server

Configurazione del server evidenziata

I clienti potranno attivare i dati da Adobe Experience Platform alla tua destinazione tramite esportazioni HTTP. La configurazione del server contiene informazioni sul server che riceve i messaggi (il server sul tuo lato).

Questo processo distribuisce i dati utente sotto forma di serie di messaggi HTTP alla piattaforma di destinazione. I parametri seguenti formano il modello delle specifiche del server HTTP.

Parametro Tipo Descrizione
name Stringa Obbligatorio. Rappresenta un nome descrittivo del server, visibile solo ad Adobe. Questo nome non è visibile ai partner o clienti. Esempio Moviestar destination server.
destinationServerType Stringa Obbligatorio. URL_BASED al momento è l’unica opzione disponibile.
templatingStrategy Stringa Obbligatorio.
  • Utilizza PEBBLE_V1 se l'Adobe deve trasformare l'URL nel campo value sottostante. Utilizza questa opzione se disponi di un endpoint come: https://api.moviestar.com/data/{{customerData.region}}/items
  • Utilizza NONE se non è necessaria alcuna trasformazione sul lato Adobe, ad esempio se disponi di un endpoint come: https://api.moviestar.com/data/items
value Stringa Obbligatorio. Inserisci l’indirizzo dell’endpoint API a cui Experience Platform deve connettersi.

Specifiche dei modelli

Configurazione del modello evidenziata

La specifica del modello ti consente di configurare la modalità di formattazione del messaggio esportato verso la destinazione. Adobe utilizza un linguaggio di template simile a Jinja per trasformare i campi dallo schema XDM in un formato supportato dalla destinazione. Per ulteriori informazioni sulla trasformazione, visita i collegamenti seguenti:

SUGGERIMENTO

Adobe offre uno strumento per sviluppatori che consente di creare e testare un modello di trasformazione dei messaggi.

Parametro Tipo Descrizione
httpMethod Stringa Obbligatorio. Il metodo che Adobe utilizzerà nelle chiamate al server. Le opzioni sono GET, PUT, POST, DELETE, PATCH.
templatingStrategy Stringa Obbligatorio. Seleziona PEBBLE_V1.
value Stringa Obbligatorio. Questa stringa è la versione con sequenza di caratteri che trasforma i dati dei clienti Platform nel formato previsto dal servizio.
Per informazioni su come scrivere il modello, consulta la sezione Utilizzo del modello.
Per ulteriori informazioni sull’escape dei caratteri, consulta la sezione sette dello standard RFC JSON.
Per un esempio di trasformazione semplice, consulta Profile Attributestransformation (Attribuzione profilo).
contentType Stringa Obbligatorio. Il tipo di contenuto accettato dal server. Questo valore è molto probabilmente application/json.

In questa pagina