Endpoint API: https://platform.adobe.io/data/core/activation/authoring/sample-profiles
Questa pagina elenca e descrive tutte le operazioni API che puoi eseguire utilizzando /authoring/sample-profiles
Endpoint API.
Utilizza questo endpoint API per generare profili di esempio per due casi d’uso separati. Puoi effettuare le seguenti operazioni:
Puoi generare profili di esempio in base allo schema di origine XDM di Adobe (da utilizzare durante il test della destinazione) o allo schema di destinazione supportato dalla destinazione (da utilizzare durante la creazione del modello). Per comprendere la differenza tra lo schema di origine XDM di Adobe e lo schema di destinazione, consulta la sezione panoramica della Formato del messaggio articolo.
Si noti che gli scopi per i quali i profili di esempio possono essere utilizzati non sono intercambiabili. Profili generati in base al ID destinazione può essere utilizzato solo per creare modelli di trasformazione dei messaggi e profili generati in base a ID istanza di destinazione può essere utilizzato solo per testare l'endpoint di destinazione.
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.
Aggiungi i profili di esempio generati qui alle chiamate HTTP quando verifica della destinazione.
Puoi generare profili di esempio basati sullo schema di origine effettuando una richiesta di GET al authoring/sample-profiles/
e fornisce l'ID di un'istanza di destinazione creata in base alla configurazione di destinazione che desideri verificare.
Per ottenere l’ID di un’istanza di destinazione, devi prima creare una connessione nell’interfaccia utente di Experience Platform alla destinazione prima di provare la destinazione. Leggi la sezione esercitazione su come attivare la destinazione e consulta il suggerimento seguente su come ottenere l’ID di istanza delle destinazioni da utilizzare per questa API.
Formato API
GET authoring/sample-profiles?destinationInstanceId={DESTINATION_INSTANCE_ID}&count={COUNT}
Parametro query | Descrizione |
---|---|
{DESTINATION_INSTANCE_ID} |
L’ID dell’istanza di destinazione in base a cui stai generando profili di esempio. |
{COUNT} |
Facoltativo. Il numero di profili di esempio che stai generando. Il parametro può accettare valori compresi tra 1 - 1000 . Se il parametro count non è specificato, il numero predefinito di profili generati è determinato dalla maxUsersPerRequest nel configurazione del server di destinazione. Se questa proprietà non è definita, Adobe genererà un profilo di esempio. |
Richiesta
La seguente richiesta genera profili di esempio, configurati dalla {DESTINATION_INSTANCE_ID}
e {COUNT}
parametri di query.
curl --location --request GET 'https://platform.adobe.io/data/core/activation/authoring/sample-profiles?destinationInstanceId=49966037-32cd-4457-a105-2cbf9c01826a&count=3' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'x-api-key: {API_KEY}' \
--header 'Authorization: Bearer {ACCESS_TOKEN}' \
--header 'x-gw-ims-org-id: {ORG_ID}' \
--header 'x-sandbox-name: {SANDBOX_NAME}' \
Risposta
Una risposta corretta restituisce lo stato HTTP 200 con il numero specificato di profili di esempio, con appartenenza al segmento, identità e attributi di profilo corrispondenti allo schema XDM di origine.
La risposta restituisce solo l’appartenenza al segmento, le identità e gli attributi di profilo utilizzati nell’istanza di destinazione. Anche se lo schema di origine dispone di altri campi, questi vengono ignorati.
[
{
"segmentMembership": {
"ups": {
"03fb9938-8537-4b4c-87f9-9c4d413a0ee5": {
"lastQualificationTime": "2021-06-30T18:40:07.591378Z",
"status": "realized"
},
"27e05542-d6a3-46c7-9c8e-d59d50229530": {
"lastQualificationTime": "2021-06-30T18:40:07.591380Z",
"status": "realized"
}
}
},
"personalEmail": {
"address": "john.smith@abc.com"
},
"identityMap": {
"ECID": [
{
"id": "ECID-7VEsJ"
}
]
},
"person": {
"name": {
"firstName": "string"
}
}
},
{
"segmentMembership": {
"ups": {
"03fb9938-8537-4b4c-87f9-9c4d413a0ee5": {
"lastQualificationTime": "2021-06-30T18:40:07.591378Z",
"status": "realized"
},
"27e05542-d6a3-46c7-9c8e-d59d50229530": {
"lastQualificationTime": "2021-06-30T18:40:07.591380Z",
"status": "realized"
}
}
},
"personalEmail": {
"address": "john.smith@abc.com"
},
"identityMap": {
"ECID": [
{
"id": "ECID-Y55JJ"
}
]
},
"person": {
"name": {
"firstName": "string"
}
}
},
{
"segmentMembership": {
"ups": {
"03fb9938-8537-4b4c-87f9-9c4d413a0ee5": {
"lastQualificationTime": "2021-06-30T18:40:07.591378Z",
"status": "realized"
},
"27e05542-d6a3-46c7-9c8e-d59d50229530": {
"lastQualificationTime": "2021-06-30T18:40:07.591380Z",
"status": "realized"
}
}
},
"personalEmail": {
"address": "john.smith@abc.com"
},
"identityMap": {
"ECID": [
{
"id": "ECID-Nd9GK"
}
]
},
"person": {
"name": {
"firstName": "string"
}
}
}
]
Proprietà | Descrizione |
---|---|
segmentMembership |
Un oggetto map che descrive le appartenenze al segmento del singolo utente. Per ulteriori informazioni su segmentMembership , leggi Dettagli di appartenenza al segmento. |
lastQualificationTime |
Una marca temporale dell’ultima volta che il profilo è qualificato per il segmento. |
xdm:status |
Campo stringa che indica se l’appartenenza al segmento è stata realizzata come parte della richiesta corrente. Sono accettati i seguenti valori:
|
identityMap |
Campo di tipo mappa che descrive i vari valori di identità di un singolo utente, insieme ai relativi namespace associati. Per ulteriori informazioni su identityMap , leggi Base della composizione dello schema. |
Utilizza i profili di esempio generati qui durante la creazione del modello, nel passaggio del modello di rendering.
Puoi generare profili di esempio basati sullo schema di destinazione effettuando una richiesta di GET al authoring/sample-profiles/
e fornisce l'ID di destinazione della configurazione di destinazione in base a cui stai creando il modello.
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/sample-profiles?destinationId={DESTINATION_ID}&count={COUNT}
Parametro query | Descrizione |
---|---|
{DESTINATION_ID} |
L’ID della configurazione di destinazione in base alla quale stai generando profili di esempio. |
{COUNT} |
Facoltativo. Il numero di profili di esempio che stai generando. Il parametro può accettare valori compresi tra 1 - 1000 . Se il parametro count non è specificato, il numero predefinito di profili generati è determinato dalla maxUsersPerRequest nel configurazione del server di destinazione. Se questa proprietà non è definita, Adobe genererà un profilo di esempio. |
Richiesta
La seguente richiesta genera profili di esempio, configurati dalla {DESTINATION_ID}
e {COUNT}
parametri di query.
curl --location --request GET 'https://platform.adobe.io/data/core/activation/authoring/sample-profiles?destinationId=49966037-32cd-4457-a105-2cbf9c01826a&count=3' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'x-api-key: {API_KEY}' \
--header 'Authorization: Bearer {ACCESS_TOKEN}' \
--header 'x-gw-ims-org-id: {ORG_ID}' \
--header 'x-sandbox-name: {SANDBOX_NAME}' \
Risposta
Una risposta corretta restituisce lo stato HTTP 200 con il numero specificato di profili di esempio, con appartenenza al segmento, identità e attributi di profilo corrispondenti allo schema XDM di destinazione.
[
{
"segmentMembership": {
"ups": {
"segmentid1": {
"lastQualificationTime": "2021-06-30T18:42:27.609326Z",
"status": "existing"
},
"segmentid3": {
"lastQualificationTime": "2021-06-30T18:42:27.609328Z",
"status": "exited"
},
"segmentid2": {
"lastQualificationTime": "2021-06-30T18:42:27.609328Z",
"status": "realized"
}
}
},
"identityMap": {
"phone_sha256": [
{
"id": "phone_sha256-vizii"
}
],
"gaid": [
{
"id": "gaid-adKYs"
}
],
"idfa": [
{
"id": "idfa-t4sKv"
}
],
"extern_id": [
{
"id": "extern_id-C3enB"
}
],
"email_lc_sha256": [
{
"id": "email_lc_sha256-bfnbs"
}
]
}
},
{
"segmentMembership": {
"ups": {
"segmentid1": {
"lastQualificationTime": "2021-06-30T18:42:27.609626Z",
"status": "existing"
},
"segmentid3": {
"lastQualificationTime": "2021-06-30T18:42:27.609627Z",
"status": "exited"
},
"segmentid2": {
"lastQualificationTime": "2021-06-30T18:42:27.609627Z",
"status": "realized"
}
}
},
"identityMap": {
"phone_sha256": [
{
"id": "phone_sha256-6YjGc"
}
],
"gaid": [
{
"id": "gaid-SfJ21"
}
],
"idfa": [
{
"id": "idfa-eQMWS"
}
],
"extern_id": [
{
"id": "extern_id-d3WzP"
}
],
"email_lc_sha256": [
{
"id": "email_lc_sha256-eWfFn"
}
]
}
},
{
"segmentMembership": {
"ups": {
"segmentid1": {
"lastQualificationTime": "2021-06-30T18:42:27.609823Z",
"status": "existing"
},
"segmentid3": {
"lastQualificationTime": "2021-06-30T18:42:27.609824Z",
"status": "exited"
},
"segmentid2": {
"lastQualificationTime": "2021-06-30T18:42:27.609824Z",
"status": "realized"
}
}
},
"identityMap": {
"phone_sha256": [
{
"id": "phone_sha256-2PMjZ"
}
],
"gaid": [
{
"id": "gaid-3aLez"
}
],
"idfa": [
{
"id": "idfa-D2H1J"
}
],
"extern_id": [
{
"id": "extern_id-i6PsF"
}
],
"email_lc_sha256": [
{
"id": "email_lc_sha256-VPUtZ"
}
]
}
}
]
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.
Dopo aver letto questo documento, ora sai come generare profili di esempio da utilizzare quando verifica di un modello di trasformazione dei messaggi o quando verifica se la destinazione è configurata correttamente.