Questa pagina elenca e descrive tutte le operazioni API che puoi eseguire utilizzando /authoring/testing/template/sample endpoint API, per generare un modello di trasformazione dei messaggi per la tua destinazione. Per una descrizione delle funzionalità supportate da questo endpoint, leggere crea modello.
Guida introduttiva alle operazioni API con modelli di esempio
Prima di continuare, controlla la guida introduttiva per informazioni importanti che devi conoscere per effettuare correttamente le chiamate all’API, tra cui come ottenere l’autorizzazione di authoring di destinazione richiesta e le intestazioni richieste.
Ottieni modello di esempio
Puoi ottenere un modello di esempio effettuando una richiesta di GET al authoring/testing/template/sample/ e fornisce l'ID di destinazione della configurazione di destinazione in base a cui stai creando il modello.
SUGGERIMENTO
L'ID di destinazione da utilizzare qui è la variabile instanceId che corrisponde a una configurazione di destinazione, creata utilizzando /destinations punto finale. Fai riferimento a riferimento API per la configurazione della destinazione.
Formato API
GET authoring/testing/template/sample/{DESTINATION_ID}
Parametro
Descrizione
{DESTINATION_ID}
ID della configurazione di destinazione per la quale stai generando un modello di trasformazione del messaggio.
Richiesta
La richiesta seguente genera un nuovo modello di esempio, configurato dai parametri forniti nel payload.
Una risposta corretta restituisce lo stato HTTP 200 con un modello di esempio che è possibile modificare per adattarlo al formato di dati previsto.
Se l'ID di destinazione fornito corrisponde a una configurazione di destinazione con aggregazione dello sforzo migliore e maxUsersPerRequest=1 nel criterio di aggregazione, la richiesta restituisce un modello di esempio simile a questo:
{#- THIS is an example template for a single profile -#}
{#- A '-' at the beginning or end of a tag removes all whitespace on that side of the tag. -#}
{
"identities": [
{%- for idMapEntry in input.profile.identityMap -%}
{%- set namespace = idMapEntry.key -%}
{%- for identity in idMapEntry.value %}
{
"type": "{{ namespace }}",
"id": "{{ identity.id }}"
}{%- if not loop.last -%},{%- endif -%}
{%- endfor -%}{%- if not loop.last -%},{%- endif -%}
{% endfor %}
],
"AdobeExperiencePlatformSegments": {
"add": [
{%- for segment in input.profile.segmentMembership.ups | added %}
"{{ segment.key }}"{%- if not loop.last -%},{%- endif -%}
{% endfor %}
],
"remove": [
{#- Alternative syntax for filtering segments by status: -#}
{% for segment in removedSegments(input.profile.segmentMembership.ups) %}
"{{ segment.key }}"{%- if not loop.last -%},{%- endif -%}
{% endfor %}
]
}
}
Se l'ID di destinazione fornito corrisponde a un modello di server di destinazione con aggregazione configurabile o aggregazione dello sforzo migliore con maxUsersPerRequest maggiore di uno, la richiesta restituisce un modello di esempio simile a questo:
{#- THIS is an example template for multiple profiles -#}
{#- A '-' at the beginning or end of a tag removes all whitespace on that side of the tag. -#}
{
"profiles": [
{%- for profile in input.profiles %}
{
"identities": [
{%- for idMapEntry in profile.identityMap -%}
{%- set namespace = idMapEntry.key -%}
{%- for identity in idMapEntry.value %}
{
"type": "{{ namespace }}",
"id": "{{ identity.id }}"
}{%- if not loop.last -%},{%- endif -%}
{%- endfor -%}{%- if not loop.last -%},{%- endif -%}
{% endfor %}
],
"AdobeExperiencePlatformSegments": {
"add": [
{%- for segment in profile.segmentMembership.ups | added %}
"{{ segment.key }}"{%- if not loop.last -%},{%- endif -%}
{% endfor %}
],
"remove": [
{#- Alternative syntax for filtering segments by status: -#}
{% for segment in removedSegments(profile.segmentMembership.ups) %}
"{{ segment.key }}"{%- if not loop.last -%},{%- endif -%}
{% endfor %}
]
}
}{%- if not loop.last -%},{%- endif -%}
{% endfor %}
]
}
Gestione degli errori API
Gli endpoint API di Destination SDK seguono i principi generali dei messaggi di errore API di Experience Platform. Fai riferimento a Codici di stato API e errori di intestazione della richiesta nella guida alla risoluzione dei problemi di Platform.
Passaggi successivi
Dopo aver letto questo documento, ora sai come generare un modello di trasformazione del messaggio utilizzando /authoring/testing/template/sample Endpoint API. Successivamente, puoi utilizzare il Endpoint API per modello di rendering per generare profili esportati in base al modello e confrontarli con il formato dati previsto della destinazione.
