Abilitare un set di dati per Profile e Identity Service utilizzo delle API

Questa esercitazione descrive il processo di abilitazione di un set di dati per l’utilizzo in Real-Time Customer Profile e Identity Service, suddiviso nei seguenti passaggi:

  1. Abilitare un set di dati per l’utilizzo in Real-Time Customer Profile, utilizzando una delle due opzioni seguenti:
  2. Inserire dati nel set di dati
  3. Conferma l’acquisizione dei dati da Real-Time Customer Profile
  4. Conferma dell’acquisizione dei dati da parte del servizio Identity

Introduzione

Questo tutorial richiede una buona conoscenza di diversi servizi Adobe Experience Platform coinvolti nella gestione dei set di dati abilitati per il profilo. Prima di iniziare questo tutorial, consulta la documentazione relativa a Platform servizi:

  • Real-Time Customer Profile: fornisce un profilo consumer unificato e in tempo reale basato su dati aggregati provenienti da più origini.
  • Identity Service: Abilita Real-Time Customer Profile collegando le identità da diverse origini dati acquisite in Platform.
  • Catalog Service: API RESTful che consente di creare set di dati e configurarli per Real-Time Customer Profile e Identity Service.
  • Experience Data Model (XDM): il quadro standardizzato mediante il quale Platform organizza i dati sull’esperienza del cliente.

Le sezioni seguenti forniscono informazioni aggiuntive che sarà necessario conoscere per effettuare correttamente le chiamate alle API di Platform.

Lettura delle chiamate API di esempio

Questo tutorial 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 il codice JSON di esempio restituito nelle risposte API. Per informazioni sulle convenzioni utilizzate nella documentazione per le chiamate API di esempio, consulta la sezione su come leggere esempi di chiamate API nel Experience Platform guida alla risoluzione dei problemi.

Raccogli i valori per le intestazioni richieste

Per effettuare chiamate a Platform , devi prima completare le tutorial sull’autenticazione. Il completamento del tutorial sull’autenticazione fornisce i valori per ciascuna delle intestazioni richieste in tutte Experience Platform Chiamate API, come mostrato di seguito:

  • Authorization: Bearer {ACCESS_TOKEN}
  • x-api-key: {API_KEY}
  • x-gw-ims-org-id: {ORG_ID}

Tutte le richieste che contengono un payload (POST, PUT, PATCH) richiedono un ulteriore Content-Type intestazione. Il valore corretto per questa intestazione viene mostrato nelle richieste di esempio, se necessario.

Tutte le risorse in Experience Platform sono isolati in specifiche sandbox virtuali. Tutte le richieste a Platform Le API richiedono un x-sandbox-name intestazione che specifica il nome della sandbox in cui verrà eseguita l’operazione. Per ulteriori informazioni sulle sandbox in Platform, vedere documentazione di panoramica sulla sandbox.

Creare un set di dati abilitato per Profilo e Identità

Puoi 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 desideri abilitare un set di dati già creato, segui i passaggi per configurazione di un set di dati esistente disponibile più avanti in questo documento.

NOTA

Per creare un nuovo set di dati abilitato per il profilo, è necessario conoscere l’ID di uno schema XDM esistente abilitato per il profilo. Per informazioni su come cercare o creare uno schema abilitato per il profilo, consulta l’esercitazione su creazione di uno schema tramite l’API Schema Registry.

Per creare un set di dati abilitato per il profilo, puoi utilizzare una richiesta POST al /dataSets endpoint.

Formato API

POST /dataSets

Richiesta

Includendo unifiedProfile e unifiedIdentity in tags nel corpo della richiesta, il set di dati verrà immediatamente abilitato per Profile e Identity Service, rispettivamente. 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: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -d '{
    "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 del ProfileSchema abilitato su cui verrà basato il set di dati.
{TENANT_ID} Lo spazio dei nomi all’interno del Schema Registry che contiene risorse appartenenti alla tua organizzazione IMS. Consulta la TENANT_ID sezione del Schema Registry guida per gli sviluppatori per ulteriori informazioni.

Risposta

In caso di esito positivo, la risposta mostra un array contenente l’ID del set di dati appena creato sotto forma di "@/dataSets/{DATASET_ID}". Dopo aver creato e abilitato correttamente un set di dati, procedi come indicato di seguito. caricamento dati.

[
    "@/dataSets/5b020a27e7040801dedbf46e"
]

Configurare un set di dati esistente

I passaggi seguenti descrivono come abilitare un set di dati creato in precedenza per Real-Time Customer Profile e Identity Service. Se hai già creato un set di dati abilitato per il profilo, procedi come descritto di seguito. acquisizione dei dati.

Controlla se il set di dati è abilitato

Utilizzo di Catalog API, è possibile esaminare un set di dati esistente per determinare se è abilitato per l’utilizzo in Real-Time Customer Profile e Identity Service. La chiamata seguente 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 controllare.

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: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

Risposta

{
    "5b020a27e7040801dedbf46e": {
        "name": "Commission Program Events DataSet",
        "imsOrg": "{ORG_ID}",
        "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",
        "transforms": "@/dataSets/5b020a27e7040801dedbf46e/views/5b020a27e7040801dedbf46f/transforms",
        "files": "@/dataSets/5b020a27e7040801dedbf46e/views/5b020a27e7040801dedbf46f/files",
        "schema": "@/xdms/context/experienceevent",
        "schemaMetadata": {
            "primaryKey": [],
            "delta": [],
            "dule": []
        },
        "schemaRef": {
            "id": "https://ns.adobe.com/xdm/context/experienceevent",
            "contentType": "application/vnd.adobe.xed+json"
        }
    }
}

Sotto tags proprietà, puoi 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 set di dati.

Abilitare il set di dati

Se il set di dati esistente non è stato abilitato per Profile o Identity Service, puoi abilitarlo effettuando una richiesta 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-patch+json' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -d '[
        { "op": "add", "path": "/tags/unifiedProfile", "value": ["enabled:true"] },
        { "op": "add", "path": "/tags/unifiedIdentity", "value": ["enabled:true"] }
      ]'

Il corpo della richiesta include path a due tipi di tag, unifiedProfile e unifiedIdentity. Il value di ciascuno sono array contenenti la stringa enabled:true.

Risposta
In caso di esito positivo, la richiesta PATCH restituisce lo stato HTTP 200 (OK) e una matrice contenente l’ID del set di dati aggiornato. Questo ID deve corrispondere a quello inviato nella richiesta PATCH. Il unifiedProfile e unifiedIdentity Ora sono stati aggiunti dei tag e il set di dati è abilitato per l’utilizzo da parte dei servizi Profilo e Identità.

[
    "@/dataSets/5b020a27e7040801dedbf46e"
]

Inserire dati nel set di dati

Entrambi Real-Time Customer Profile e Identity Service consuma i dati XDM durante l’acquisizione in un set di dati. Per istruzioni su come caricare i dati in un set di dati, consulta l’esercitazione su creazione di un set di dati tramite API. Quando pianifichi quali dati inviare al tuo ProfileSet di dati abilitato, considera le seguenti best practice:

  • Includi tutti i dati da utilizzare come criteri di segmentazione.
  • Includi tutti gli identificatori che puoi verificare dai dati del profilo per massimizzare il grafico delle identità. Ciò consente Identity Service per unire in modo più efficace le identità tra i set di dati.

Conferma l’acquisizione dei dati da Real-Time Customer Profile

Quando si caricano dati in un nuovo set di dati per la prima volta, o come parte di un processo che coinvolge una nuova ETL o sorgente di dati, si consiglia di controllare attentamente i dati per assicurarsi che siano stati caricati come previsto. Utilizzo di Real-Time Customer Profile Access API (API di Access), puoi recuperare i dati batch non appena vengono caricati in un set di dati. Se non riesci a 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, assicurati che il formato e gli identificatori dei dati di origine supportino le aspettative. Per istruzioni dettagliate su come utilizzare il Real-Time Customer Profile API per accedere a Profile dati, fare riferimento al guida dell’endpoint "entities", noto anche come "Profile Access" API.

Conferma dell’acquisizione dei dati da parte del servizio Identity

Ogni frammento di dati acquisito che contiene più di un’identità crea un collegamento nel grafico dell’identità privata. Per ulteriori informazioni sui grafici delle identità e accedere ai dati di identità, consulta la sezione Panoramica del servizio Identity.

In questa pagina