Questa esercitazione descrive il processo di attivazione di un dataset da utilizzare in Real-time Customer Profile e Identity Service, suddivisi nei seguenti passaggi:
Questa esercitazione richiede una conoscenza approfondita dei diversi servizi Adobe Experience Platform coinvolti nella gestione dei set di dati Profileabilitati. Prima di iniziare questa esercitazione, consulta la documentazione relativa a questi Platform servizi correlati:
Le sezioni seguenti forniscono informazioni aggiuntive che sarà necessario conoscere per effettuare correttamente chiamate alle API della piattaforma.
Questa esercitazione fornisce esempi di chiamate API per dimostrare come formattare le richieste. Questi includono percorsi, intestazioni richieste e payload di richieste formattati correttamente. Viene inoltre fornito un JSON di esempio restituito nelle risposte API. Per informazioni sulle convenzioni utilizzate nella documentazione per le chiamate API di esempio, vedete la sezione come leggere chiamate API di esempio nella guida alla Experience Platform risoluzione dei problemi.
Per effettuare chiamate alle Platform API, è prima necessario completare l'esercitazione sull'autenticazione. Completando l'esercitazione sull'autenticazione, vengono forniti i valori per ciascuna delle intestazioni richieste in tutte le chiamate Experience Platform API, come illustrato di seguito:
{ACCESS_TOKEN}
{API_KEY}
{IMS_ORG}
Tutte le richieste che contengono un payload (POST, PUT, PATCH) richiedono un'intestazione aggiuntiva:
Tutte le risorse in Experience Platform sono isolate in sandbox virtuali specifiche. Tutte le richieste alle Platform API richiedono un'intestazione che specifica il nome della sandbox in cui avrà luogo l'operazione. Per ulteriori informazioni sulle sandbox in Platform, consultate la documentazione sulla panoramica dellasandbox.
{SANDBOX_NAME}
È possibile abilitare un set di dati per Real-time Customer Profile e Identity Service immediatamente dopo la creazione o in qualsiasi momento dopo la creazione del set di dati. Se si desidera abilitare un dataset già creato, seguire i passaggi per configurare un dataset esistente trovato più avanti in questo documento. Per creare un nuovo set di dati, è necessario conoscere l'ID di uno schema XDM esistente abilitato per il profilo cliente in tempo reale. Per informazioni su come ricercare o creare uno schema abilitato per il profilo, vedere l'esercitazione sulla creazione di uno schema tramite l'APIdel Registro di sistema dello schema. La seguente chiamata all' Catalog API abilita un dataset per Profile e Identity Service.
Formato API
POST /dataSets
Richiesta
Includendo unifiedProfile
e unifiedIdentity
sotto tags
nel corpo della richiesta, il set di dati sarà immediatamente abilitato per Profile e, rispettivamente, Identity Service. I valori di questi tag devono essere una matrice contenente la stringa "enabled:true"
.
curl -X POST \
https://platform.adobe.io/data/foundation/catalog/dataSets \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {IMS_ORG}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-d '{
"fileDescription" : {
"persisted": true,
"containerFormat": "parquet",
"format": "parquet"
},
"fields":[],
"schemaRef" : {
"id": "https://ns.adobe.com/{TENANT_ID}/schemas/31670881463308a46f7d2cb09762715",
"contentType": "application/vnd.adobe.xed-full-notext+json; version=1"
},
"tags" : {
"unifiedProfile": ["enabled:true"],
"unifiedIdentity": ["enabled:true"]
}
}'
Proprietà | Descrizione |
---|---|
schemaRef.id |
ID dello schema Profileabilitato su cui si baserà il dataset. |
{TENANT_ID} |
Lo spazio dei nomi all'interno del Schema Registry quale sono contenute risorse appartenenti all'organizzazione IMS. Per ulteriori informazioni, consulta la sezione TENANT_ID della guida per Schema Registry gli sviluppatori. |
Risposta
Una risposta corretta mostra un array contenente l’ID del set di dati appena creato sotto forma di "@/dataSets/{DATASET_ID}"
. Dopo aver creato e attivato correttamente un dataset, procedere con i passaggi necessari per caricare i dati.
[
"@/dataSets/5b020a27e7040801dedbf46e"
]
I passaggi seguenti descrivono come abilitare un dataset creato in precedenza per Real-time Customer Profile e Identity Service. Se hai già creato un set di dati con abilitazione per il profilo, procedi alla procedura di acquisizione dei dati.
Utilizzando l' Catalog API, potete ispezionare un dataset esistente per determinare se è abilitato per l'uso in Real-time Customer Profile e Identity Service. La seguente chiamata recupera i dettagli di un set di dati per ID.
Formato API
GET /dataSets/{DATASET_ID}
Parametro | Descrizione |
---|---|
{DATASET_ID} |
ID di un set di dati da esaminare. |
Richiesta
curl -X GET \
'https://platform.adobe.io/data/foundation/catalog/dataSets/5b020a27e7040801dedbf46e' \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {IMS_ORG}' \
-H 'x-sandbox-name: {SANDBOX_NAME}'
Risposta
{
"5b020a27e7040801dedbf46e": {
"name": "Commission Program Events DataSet",
"imsOrg": "{IMS_ORG}",
"tags": {
"adobe/pqs/table": [
"unifiedprofileingestiontesteventsdataset"
],
"unifiedProfile": [
"enabled:true"
],
"unifiedIdentity": [
"enabled:true"
]
},
"lastBatchId": "6dcd9128a1c84e6aa5177641165e18e4",
"lastBatchStatus": "success",
"dule": {},
"statsCache": {
"startDate": null,
"endDate": null
},
"namespace": "ACP",
"state": "DRAFT",
"version": "1.0.1",
"created": 1536536917382,
"updated": 1539793978215,
"createdClient": "{CLIENT_CREATED}",
"createdUser": "{CREATED_BY}",
"updatedUser": "{CREATED_BY}",
"viewId": "5b020a27e7040801dedbf46f",
"status": "enabled",
"fileDescription": {
"persisted": true,
"containerFormat": "parquet",
"format": "parquet"
},
"transforms": "@/dataSets/5b020a27e7040801dedbf46e/views/5b020a27e7040801dedbf46f/transforms",
"files": "@/dataSets/5b020a27e7040801dedbf46e/views/5b020a27e7040801dedbf46f/files",
"schema": "@/xdms/context/experienceevent",
"schemaMetadata": {
"primaryKey": [],
"delta": [],
"dule": [],
"gdpr": []
},
"schemaRef": {
"id": "https://ns.adobe.com/xdm/context/experienceevent",
"contentType": "application/vnd.adobe.xed+json"
}
}
}
Sotto la tags
proprietà, è possibile vedere che unifiedProfile
e unifiedIdentity
sono entrambi presenti con il valore enabled:true
. Pertanto, Real-time Customer Profile e Identity Service sono abilitati rispettivamente per questo dataset.
Se il set di dati esistente non è stato abilitato per Profile o Identity Service, potete attivarlo effettuando una richiesta di PATCH utilizzando l'ID del set di dati.
Formato API
PATCH /dataSets/{DATASET_ID}
Parametro | Descrizione |
---|---|
{DATASET_ID} |
ID di un set di dati da aggiornare. |
Richiesta
curl -X PATCH \
https://platform.adobe.io/data/foundation/catalog/dataSets/5b020a27e7040801dedbf46e \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {IMS_ORG}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-d '{
"tags" : {
"unifiedProfile": ["enabled:true"],
"unifiedIdentity": ["enabled:true"]
}
}'
Il corpo della richiesta include una tags
proprietà, che contiene due proprietà secondarie: "unifiedProfile"
e "unifiedIdentity"
. I valori di queste proprietà secondarie sono matrici contenenti la stringa "enabled:true"
.
Risposta Una richiesta PATCH riuscita restituisce lo stato HTTP 200 (OK) e un array contenente l’ID del set di dati aggiornato. Questo ID deve corrispondere a quello inviato nella richiesta PATCH. Sono stati aggiunti "unifiedProfile"
e "unifiedIdentity"
i tag e il set di dati è abilitato per l’uso da parte dei servizi Profilo e Identità.
[
"@/dataSets/5b020a27e7040801dedbf46e"
]
I dati XDM Real-time Customer Profile e Identity Service i relativi utenti vengono caricati in un dataset. Per istruzioni su come caricare i dati in un dataset, fare riferimento all'esercitazione sulla creazione di un dataset mediante le API. Quando pianificate quali dati inviare al dataset Profileabilitato, tenete presenti le seguenti procedure ottimali:
Quando si caricano i dati in un nuovo dataset per la prima volta, o come parte di un processo che coinvolge una nuova ETL o una nuova origine dati, si consiglia di controllare attentamente i dati per assicurarsi che siano stati caricati come previsto. Utilizzando l'API Real-time Customer Profile Access, è possibile recuperare i dati batch mentre vengono caricati in un dataset. Se non è possibile recuperare le entità previste, il set di dati potrebbe non essere abilitato per Real-time Customer Profile. Dopo aver confermato che il set di dati è stato abilitato, accertati che il formato e gli identificatori dei dati di origine supportino le tue aspettative. Per istruzioni dettagliate su come utilizzare l' Real-time Customer Profile API per accedere ai Profile dati, seguite la guida all'endpointentità, nota anche come "Profile Access API".
Ogni frammento di dati inserito contenente più identità crea un collegamento nel grafico dell'identità privata. Per ulteriori informazioni sui grafici identità e sui dati di accesso all'identità, leggere la panoramica del servizioidentità.