3.5 Creare un segmento - API

In questo esercizio, utilizzerai Postman e Adobe I/O per creare un segmento e memorizzare i risultati di tale segmento come un set di dati, utilizzando le API di Adobe Experience Platform.

Storia

Nel Profilo cliente in tempo reale, tutti i dati del profilo vengono visualizzati insieme ai dati dell’evento e alle appartenenze al segmento esistenti. I dati visualizzati possono provenire da qualsiasi luogo, da applicazioni di Adobe e soluzioni esterne. Questa è la vista più potente in Adobe Experience Platform, il sistema di esperienza di registrazione.

Esercizio 3.5.1 - Creare un segmento tramite l’API di Platform

Vai da Postman.

Individua la raccolta: Abilitazione _Adobe Experience Platform. In questa raccolta verrà visualizzata una cartella 2. Segmentazione. In questo esercizio utilizzeremo queste richieste.

Segmentazione

In seguito, seguiremo tutti i passaggi necessari per creare un segmento tramite l’API. Costruiremo un segmento semplice: "ldap - Tutti I Clienti Femminili".

Passaggio 1 - Creare una definizione di segmento

Fai clic sulla richiesta denominata Passaggio 1 - Profilo: Creare Una Definizione Di Segmento.

Segmentazione

Vai al Corpo sezione di questa richiesta.

Segmentazione

In Corpo di questa richiesta vedrai quanto segue:

Segmentazione

La lingua utilizzata per questa richiesta è denominata Lingua query profilo oppure PQL.

Puoi trovare ulteriori informazioni e documentazione su PQL qui.

Attention: please update the variable name in the below request by replacing ldap with your specific ldap.

{
    "name" : "ldap - API - All Female Customer",
    "expression" : {"type":"PQL", "format":"pql/json", "value":"{\"nodeType\":\"fnApply\",\"fnName\":\"in\",\"params\":[{\"nodeType\":\"fieldLookup\",\"fieldName\":\"gender\",\"object\":{\"nodeType\":\"fieldLookup\",\"fieldName\":\"person\",\"object\":{\"nodeType\":\"literal\",\"literalType\":\"XDMObject\",\"value\":\"profile\"}}},{\"literalType\":\"List\",\"nodeType\":\"literal\",\"value\":[\"female\"]}]}"},
    "createdBy": "ldap",
    "schema" : { "name" : "_xdm.context.profile"},
    "ttlInDays" : 90
}

After adding your specific ldap, the Body should look similar to this:

{
    "name" : "vangeluw - API - All Female Customer",
    "expression" : {"type":"PQL", "format":"pql/json", "value":"{\"nodeType\":\"fnApply\",\"fnName\":\"in\",\"params\":[{\"nodeType\":\"fieldLookup\",\"fieldName\":\"gender\",\"object\":{\"nodeType\":\"fieldLookup\",\"fieldName\":\"person\",\"object\":{\"nodeType\":\"literal\",\"literalType\":\"XDMObject\",\"value\":\"profile\"}}},{\"literalType\":\"List\",\"nodeType\":\"literal\",\"value\":[\"female\"]}]}"},
    "createdBy": "vangeluw",
    "schema" : { "name" : "_xdm.context.profile"},
    "ttlInDays" : 90
}

È inoltre necessario verificare la Intestazione - campi della richiesta. Vai a Intestazioni. Vedrai questo:

Postman

Chiave Valore
x-sandbox-name --aepSandboxId--
NOTA

È necessario specificare il nome della sandbox Adobe Experience Platform in uso. Il tuo nome x-sandbox dovrebbe essere --aepSandboxId--.

Ora fai clic sul blu Invia per creare il segmento e visualizzarne i risultati.

Segmentazione

Dopo questo passaggio, puoi visualizzare la definizione del segmento nell’interfaccia utente di Platform. Per controllare, accedi a Adobe Experience Platform e vai a Segmenti.

Segmentazione

Passaggio 2 - Creare un processo POST segmento

Nell'esercizio precedente, hai creato un streaming segmento. Un segmento in streaming valuta continuamente le qualifiche in tempo reale. Quello che state facendo qui, è creare un batch segmento. Il segmento batch fornisce un’anteprima dell’aspetto del segmento in termini di qualifiche, ma questo non significa che il segmento sia stato eseguito. Attualmente, nessuno è idoneo per questo segmento. Per rendere le persone idonee, il segmento batch deve essere eseguito, che è esattamente ciò che faremo qui.

Ora POST un processo di segmento.

Vai da Postman.

Segmentazione

In your Postman collection, click on the request named Step 2 - POST Segment Job to open it.

Segmentazione

È inoltre necessario verificare la Intestazione - campi della richiesta. Go to Headers. Vedrai questo:

Postman

Chiave Valore
x-sandbox-name --aepSandboxId--
NOTA

È necessario specificare il nome della sandbox Adobe Experience Platform in uso. Il tuo nome x-sandbox dovrebbe essere --aepSandboxId--.

Clicca sul blu Invia pulsante .

Dovresti vedere un risultato simile:

Segmentazione

Il processo del segmento è ora in esecuzione e l’operazione potrebbe richiedere del tempo. In Step 3, you'll be able to check the status of this job.

Passaggio 3 - GET dello stato del processo del segmento

Vai da Postman.

Segmentazione

Nella tua raccolta Postman, fai clic sulla richiesta denominata Passaggio 3 - GET dello stato del processo del segmento.

Segmentazione

You should also verify the Header - fields of your request. Vai a Intestazioni. Vedrai questo:

Postman

Chiave Valore
x-sandbox-name --aepSandboxId--
NOTA

È necessario specificare il nome della sandbox Adobe Experience Platform in uso. Il tuo nome x-sandbox dovrebbe essere --aepSandboxId--.

Clicca sul blu Invia pulsante .

Dovresti vedere un risultato simile:

Segmentazione

In questo esempio, la status del processo è impostato su IN CODA.

Ripeti questa richiesta facendo clic su blu Invia ogni due minuti fino al status è impostato su COMPLETATO.

Segmentazione

Once the status is SUCCEEDED, your segment job has run and customers are now qualifying for the segment.

Congrats, you've successfully completed the Segmentation exercise. Vediamo ora come può essere attivato il Profilo cliente in tempo reale nell’intera azienda.

Passaggio successivo: 3.6 Vedi Profilo cliente in tempo reale in azione nel Call Center

Torna al modulo 3

Torna a tutti i moduli

In questa pagina