Pasos adicionales para enviar eventos a Journey Orchestration

Última actualización: 2023-05-24
  • Creado para:
  • Intermediate
    User
NOTA

Al crear un evento, Journey Orchestration genera automáticamente un ID para este evento. El sistema que impulsa el evento no debe generar un ID, debe utilizar el que está disponible en la previsualización de carga útil. Consulte esta página.

Para configurar eventos que se enviarán a Streaming Ingestion APIs y para usar en Journey Orchestration, debe seguir estos pasos:

  1. Obtenga la URL de entrada desde las API de Adobe Experience Platform (consulte API de ingesta de transmisión).
  2. Copie la carga útil de la previsualización de carga útil en Event menú. Consulte esta página.

A continuación, debe configurar el sistema de datos que inserta eventos en las API de ingesta de transmisión mediante la carga útil copiada:

  1. Configure una llamada de la API del POST a la URL de las API de ingesta de transmisión (denominada entrada).
  2. Utilizar la carga útil copiada de Journey Orchestration en el cuerpo (sección de datos) de la llamada de API a las API de ingesta de transmisión. Consulte a continuación un ejemplo
  3. Determine dónde obtener todas las variables presentes en la carga útil. Ejemplo: si el evento debe transmitir la dirección, la carga útil pegada mostrará "dirección": "cadena". "cadena" debe reemplazarse por la variable que rellena automáticamente el valor correcto, el correo electrónico de la persona a la que enviar un mensaje. Tenga en cuenta que, en la previsualización de carga útil, en la variable Header , rellenamos automáticamente muchos valores que se espera que faciliten su trabajo.
  4. Seleccione "application/json" como tipo de cuerpo.
  5. Pase su ID de organización de IMS en el encabezado con la clave "x-gw-ims-org-id". Para el valor, utilice su ID de organización de IMS ("XXX@AdobeOrg").

Este es un ejemplo de evento de API de ingesta de transmisión:

{
    "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"
                    }
                }
            }
        }
    }
}

Para facilitar la identificación del lugar donde pegar la parte de "datos", puede utilizar una herramienta de visualización JSON como https://jsonformatter.curiousconcept.com

Para solucionar problemas de las API de ingesta de transmisión, consulte esto página.

En esta página