Additional steps to send events to Journey Orchestration

Nota

Quando create un evento, genera Journey Orchestration automaticamente un ID per questo evento. Il sistema che preme l'evento non deve generare un ID, ma deve utilizzare quello disponibile nell'anteprima del payload. Consulta questa pagina.

Per configurare gli eventi a cui inviare Streaming Ingestion APIs e in cui utilizzarli, Journey Orchestrationè necessario effettuare le seguenti operazioni:

  1. Ottenete l’URL di ingresso dalle API Adobe Experience Platform (consultate Streaming Ingestion API).
  2. Copiate il payload dall’anteprima del payload nel Event menu. Consulta questa pagina.

Quindi devi configurare il sistema di dati che invia gli eventi alle API Streaming Ingestion utilizzando il payload copiato:

  1. Configurate una chiamata API POST all'URL delle API di ingestione dello streaming (chiamata ingresso).
  2. Utilizzate il payload copiato Journey Orchestration nel corpo ("sezione dati") della chiamata API alle API di ingestione dello streaming. Vedere di seguito un esempio
  3. Determinare dove ottenere tutte le variabili presenti nel payload. Esempio: se l’evento deve trasmettere l’indirizzo, il payload incollato mostrerà "address": "string". "string" deve essere sostituito dalla variabile che popolerà automaticamente il valore corretto, l'e-mail della persona a cui inviare un messaggio. Nell’anteprima del payload, nella Header sezione, vengono automaticamente compilati molti valori che dovrebbero facilitare il lavoro.
  4. Selezionate "application/json" come tipo di corpo.
  5. Passa l’ID organizzazione IMS nell’intestazione utilizzando la chiave "x-gw-ims-org-id". Per questo valore, utilizzate il vostro ID organizzazione IMS ("XXX@AdobeOrg").

Di seguito è riportato un esempio di evento Streaming Ingestion APIs:

{
    "header": {
        "msgType": "xdmEntityCreate",
        "msgId": "c25585b9-252e-431d-b562-e73da70c04e7",
        "msgVersion": "1.0",
        "xactionId": "f5995abe-c49d-4848-9577-a7a4fc2996fb",
        "datasetId": "string - required if you want the data to land in a specific dataset - not mandatory",
        "imsOrgId": "XXX@AdobeOrg",
        "schemaRef": {
            "id": "XXX",
            "contentType": "application/vnd.adobe.xed-full+json;version=1"
        },
        "source": {
            "name": "Journeys"
        }
    },
    "body": {
        "xdmMeta": {
            "schemaRef": {
                "id": "XXX",
                "contentType": "application/vnd.adobe.xed-full+json;version=1"
            }
        },
        "xdmEntity": {
            "_instance_name": {
                "person": {
                    "firstName": "string",
                    "lastName": "string",
                    "gender": "string",
                    "birthYear": 10,
                    "emailAddress": "string"
                }
            },
            "identityMap": {
                "Email": [
                {
                    "id": "string"
                    }
                ]
            },
            "_id": "string",
            "timestamp": "2018-05-29T00:00:00.000Z",
            "_experience": {
                "campaign": {
                    "orchestration": {
                    "eventID": "XXX"
                    }
                }
            }
        }
    }
}

Per facilitare l’identificazione del luogo in cui incollare la parte "dati", potete utilizzare uno strumento di visualizzazione JSON, ad esempio https://jsonformatter.curiousconcept.com

Per risolvere eventuali problemi relativi alle API di inserimento in streaming, consultate questa pagina.

In questa pagina