DocumentaciónJourney OrchestrationJourney Orchestration

Pasos adicionales para enviar eventos a Journey Orchestration concept_xrz_n1q_y2b

Last update: Wed Jul 17 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Temas:

Creado para:

  • Intermedio
  • Usuario
NOTE
Al crear un evento, Journey Orchestration genera automáticamente un identificador 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 los eventos que se enviarán a Streaming Ingestion APIs y que se utilizarán en Journey Orchestration, debe seguir estos pasos:

  1. Obtenga la URL de entrada de 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 el menú Event. 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. Utilice la carga que copió 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 sección 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 esta página.

recommendation-more-help
4f4a00c1-77c9-4eee-84df-bbe6206c3ab9