Valutare e accedere ai risultati dei segmenti

Questo documento fornisce un’esercitazione per valutare i segmenti e accedere ai risultati dei segmenti utilizzando Segmentation API.

Introduzione

Questo tutorial richiede una buona conoscenza delle varie Adobe Experience Platform servizi coinvolti nella creazione di segmenti di pubblico. Prima di iniziare questo tutorial, consulta la documentazione dei seguenti servizi:

• Real-Time Customer Profile: fornisce un profilo cliente unificato in tempo reale basato su dati aggregati provenienti da più origini.
• Adobe Experience Platform Segmentation Service: consente di creare segmenti di pubblico da Real-Time Customer Profile dati.
• Experience Data Model (XDM): framework standardizzato tramite il quale Platform organizza i dati sull’esperienza del cliente. Per utilizzare al meglio la segmentazione, assicurati che i dati vengano acquisiti come profili ed eventi in base alla best practice per la modellazione dei dati.
• Sandbox: Experience Platform fornisce sandbox virtuali che permettono di suddividere un singolo Platform in ambienti virtuali separati, per facilitare lo sviluppo e l’evoluzione delle applicazioni di esperienza digitale.

Intestazioni richieste

Questo tutorial richiede anche di aver completato tutorial sull’autenticazione per effettuare correttamente chiamate a Platform API. Il completamento del tutorial sull’autenticazione fornisce i valori per ciascuna delle intestazioni richieste in tutte Experience Platform Chiamate API, come mostrato di seguito:

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

Tutte le risorse in Experience Platform sono isolati in specifiche sandbox virtuali. Richieste a Platform Le API richiedono un’intestazione che specifichi il nome della sandbox in cui verrà eseguita l’operazione:

• x-sandbox-name: {SANDBOX_NAME}

Tutte le richieste di POST, PUT e PATCH richiedono un’intestazione aggiuntiva:

• Content-Type: application/json

Valutare un segmento

Dopo aver sviluppato, testato e salvato la definizione del segmento, puoi valutarlo tramite valutazione pianificata o su richiesta.

Valutazione programmata (nota anche come "segmentazione pianificata") consente di creare una pianificazione ricorrente per l’esecuzione di un processo di esportazione in un momento specifico, mentre valutazione on-demand implica la creazione di un processo di segmentazione per generare immediatamente il pubblico. Di seguito sono descritti i passaggi per ciascuno di essi.

Se non hai ancora completato creare un segmento utilizzando l’API di segmentazione esercitazione o ha creato una definizione di segmento utilizzando Generatore di segmenti, esegui questa operazione prima di procedere con questa esercitazione.

Valutazione programmata

Mediante la valutazione pianificata, l’organizzazione IMS può creare una pianificazione ricorrente per eseguire automaticamente i processi di esportazione.

Creare una pianificazione

Effettuando una richiesta POST al /config/schedules endpoint, puoi creare una pianificazione e includere l’ora specifica in cui attivare la pianificazione.

Informazioni più dettagliate sull’utilizzo di questo endpoint sono disponibili nella sezione guida dell’endpoint "schedule"

Abilitare una pianificazione

Per impostazione predefinita, una pianificazione non è attiva al momento della creazione, a meno che state proprietà impostata su active nel corpo della richiesta create (POST). È possibile abilitare una pianificazione (impostare state a active) inoltrando una richiesta PATCH al /config/schedules e l’ID della pianificazione nel percorso.

Informazioni più dettagliate sull’utilizzo di questo endpoint sono disponibili nella sezione guida dell’endpoint "schedule"

Aggiornare l’ora di pianificazione

È possibile aggiornare la pianificazione effettuando una richiesta PATCH al /config/schedules e l’ID della pianificazione nel percorso.

Informazioni più dettagliate sull’utilizzo di questo endpoint sono disponibili nella sezione guida dell’endpoint "schedule"

Valutazione a richiesta

La valutazione su richiesta consente di creare un processo di segmentazione per generare un segmento di pubblico ogni volta che necessario. A differenza della valutazione pianificata, questa si verifica solo quando richiesto e non è ricorrente.

Creare un processo di segmentazione

Un processo di segmentazione è un processo asincrono che crea un segmento di pubblico su richiesta. Fa riferimento a una definizione di segmento, nonché a eventuali criteri di unione che controllano come Real-Time Customer Profile unisce attributi sovrapposti tra i frammenti di profilo. Al termine di un processo di segmentazione, puoi raccogliere varie informazioni sul segmento, ad esempio eventuali errori che si sono verificati durante l’elaborazione e le dimensioni finali del pubblico. È necessario eseguire un processo di segmentazione ogni volta che desideri aggiornare il pubblico attualmente idoneo per la definizione del segmento.

Per creare un nuovo processo di segmentazione, devi effettuare una richiesta POST al /segment/jobs endpoint nella Real-Time Customer Profile API.

Informazioni più dettagliate sull’utilizzo di questo endpoint sono disponibili nella sezione guida dell’endpoint "segment jobs"

Cercare lo stato del processo di segmento

È possibile utilizzare id per un processo di segmento specifico per eseguire una richiesta di ricerca (GET) per visualizzare lo stato corrente del processo.

Informazioni più dettagliate sull’utilizzo di questo endpoint sono disponibili nella sezione guida dell’endpoint "segment jobs"

Interpretare i risultati dei segmenti

Quando i processi di segmentazione vengono eseguiti correttamente, il segmentMembership La mappa viene aggiornata per ogni profilo incluso nel segmento. segmentMembership memorizza anche eventuali segmenti di pubblico pre-valutati che vengono acquisiti in Platform, consentendo l'integrazione con altre soluzioni come Adobe Audience Manager.

Nell'esempio seguente viene illustrato il segmentMembership per ogni singolo record di profilo:

{
  "segmentMembership": {
    "UPS": {
      "04a81716-43d6-4e7a-a49c-f1d8b3129ba9": {
        "timestamp": "2018-04-26T15:52:25+00:00",
        "status": "existing"
      },
      "53cba6b2-a23b-454a-8069-fc41308f1c0f": {
        "lastQualificationTime": "2018-04-26T15:52:25+00:00",
        "status": "realized"
      }
    },
    "Email": {
      "abcd@adobe.com": {
        "lastQualificationTime": "2017-09-26T15:52:25+00:00",
        "status": "exited"
      }
    }
  }
}

Accedere ai risultati dei segmenti

È possibile accedere ai risultati di un processo di segmentazione in uno dei due modi seguenti: accedere a singoli profili o esportare un intero pubblico in un set di dati.

Le sezioni seguenti descrivono queste opzioni in modo più dettagliato.

Cercare un profilo

Se conosci il profilo specifico a cui desideri accedere, utilizza Real-Time Customer Profile API. I passaggi completi per accedere ai singoli profili sono disponibili nella sezione Accedere ai dati del profilo cliente in tempo reale utilizzando l’API del profilo esercitazione.

Esportare un segmento

Dopo il completamento di un processo di segmentazione (il valore della status è "RIUSCITO"), puoi esportare il pubblico in un set di dati in cui è possibile accedervi e agire di conseguenza.

Per esportare il pubblico, sono necessari i seguenti passaggi:

• Creare un set di dati di destinazione : crea il set di dati per includere i membri del pubblico.
• Generare profili di pubblico nel set di dati : popola il set di dati con i singoli profili XDM in base ai risultati di un processo di segmentazione.
• Monitorare l’avanzamento dell’esportazione - Controllare l'avanzamento corrente del processo di esportazione.
• Lettura dei dati sul pubblico : recupera i profili individuali XDM risultanti che rappresentano i membri del pubblico.

Creare un set di dati di destinazione

Durante l’esportazione di un pubblico, è necessario creare prima un set di dati di destinazione. È importante che il set di dati sia configurato correttamente per garantire l’esportazione in modo corretto.

Una delle considerazioni chiave è lo schema su cui si basa il set di dati (schemaRef.id nella richiesta di esempio API (di seguito). Per esportare un segmento, il set di dati deve essere basato su XDM Individual Profile Union Schema (https://ns.adobe.com/xdm/context/profile__union). Uno schema di unione è uno schema di sola lettura generato dal sistema che aggrega i campi degli schemi che condividono la stessa classe, in questo caso la classe XDM Individual Profile. Per ulteriori informazioni sugli schemi di visualizzazione unione, consulta la Sezione Profilo cliente in tempo reale della guida per gli sviluppatori del registro dello schema.

Esistono due modi per creare il set di dati necessario:

• Utilizzo delle API: I passaggi seguenti in questa esercitazione descrivono come creare un set di dati che faccia riferimento a XDM Individual Profile Union Schema utilizzando Catalog API.
• Utilizzo dell’interfaccia utente: Per utilizzare Adobe Experience Platform per creare un set di dati che faccia riferimento allo schema di unione, segui i passaggi descritti in Esercitazione sull’interfaccia utente e quindi tornare a questo tutorial per procedere con i passaggi per generazione di profili di pubblico.

Se disponi già di un set di dati compatibile e conosci il relativo ID, puoi procedere direttamente al passaggio per generazione di profili di pubblico.

Formato API

POST /dataSets

Richiesta

La richiesta seguente crea un nuovo set di dati, fornendo i parametri di configurazione nel payload.

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 '{
    "name": "Segment Export",
    "schemaRef": {
        "id": "https://ns.adobe.com/xdm/context/profile__union",
        "contentType": "application/vnd.adobe.xed+json;version=1"
    }
}'

Risposta

In caso di esito positivo, la risposta restituisce un array contenente l’ID univoco di sola lettura generato dal sistema per il set di dati appena creato. Per esportare correttamente i membri del pubblico è necessario un ID set di dati configurato correttamente.

[
  "@/datasets/5b020a27e7040801dedba61b"
]

Generare profili per i membri del pubblico

Una volta che hai un set di dati persistente nell’unione, puoi creare un processo di esportazione per rendere persistenti i membri del pubblico nel set di dati effettuando una richiesta POST al /export/jobs endpoint nella Real-Time Customer Profile e fornendo l’ID del set di dati e le informazioni sul segmento per i segmenti che desideri esportare.

Informazioni più dettagliate sull’utilizzo di questo endpoint sono disponibili nella sezione guida dell’endpoint "export jobs"

Monitorare l’avanzamento dell’esportazione

Durante l’elaborazione di un processo di esportazione, puoi monitorarne lo stato effettuando una richiesta GET al /export/jobs e che include id del processo di esportazione nel percorso. Il processo di esportazione viene completato una volta che status restituisce il valore "SUCCESSEDED".

Informazioni più dettagliate sull’utilizzo di questo endpoint sono disponibili nella sezione guida dell’endpoint "export jobs"

Passaggi successivi

Una volta completata correttamente l’esportazione, i dati sono disponibili all’interno di Data Lake in Experience Platform. È quindi possibile utilizzare Data Access API per accedere ai dati utilizzando batchId associato all’esportazione. A seconda delle dimensioni del segmento, i dati possono essere in blocchi e il batch può essere costituito da diversi file.

Per istruzioni dettagliate su come utilizzare il Data Access API per accedere e scaricare i file batch, seguire la Tutorial sull’accesso ai dati.

Puoi anche accedere ai dati dei segmenti esportati correttamente utilizzando Adobe Experience Platform Query Service. Utilizzando l’interfaccia utente o l’API RESTful, Query Service consente di scrivere, convalidare ed eseguire query sui dati all'interno di Data Lake.

Per ulteriori informazioni su come eseguire query sui dati del pubblico, consulta la documentazione su Query Service.

Risorse Business.Adobe.com

Journey Management Preference Centers Audio Analytics Mobile Marketing Marketing Analytics Predictive Analytics