DocumentationJourney OrchestrationJourney Orchestration

Étapes supplémentaires pour l’envoi d’événements à Journey Orchestration concept_xrz_n1q_y2b

Last update: Mon Nov 14 2022 00:00:00 GMT+0000 (Coordinated Universal Time)

Créé pour :

  • Intermediate
  • User
NOTE
Lors de la création d’un événement, Journey Orchestration génère automatiquement un identifiant qui lui correspond. Le système à l'origine de l'envoi de l'événement ne doit pas générer d'identifiant, mais plutôt utiliser celui indiqué dans l'aperçu de la payload. Voir cette page.

Pour configurer les événements qui doivent être envoyés aux API d’ingestion en flux continu et utilisés dans Journey Orchestration, procédez comme suit :

  1. Récupérez l’URL d’inlet à partir des API d’Adobe Experience Platform (voir API d’ingestion en flux continu).
  2. Copiez la payload depuis son aperçu dans le menu Événement. Voir cette page.

Vous devez ensuite configurer le système de données qui envoie les événements vers les API d’ingestion en flux continu à l’aide de la payload que vous avez copiée :

  1. Configurez un appel d’API POST à l’URL des API d’ingestion en flux continu (désignée sous le nom « inlet »).
  2. Utilisez la payload que vous avez copiée depuis Journey Orchestration, dans le corps (« section de données ») de l’appel d’API, vers les API d’ingestion en flux continu. Reportez-vous à l’exemple ci-dessous.
  3. Déterminez où obtenir toutes les variables présentes dans la payload. Exemple : si l’événement est censé transmettre l’adresse, la payload collée indique "address": "string". "string" doit être remplacé par la variable qui renseigne automatiquement la valeur appropriée, c’est-à-dire l’adresse e-mail du destinataire du message. Notez que dans la section En-tête de l’aperçu de la payload, de nombreuses valeurs sont renseignées automatiquement afin de vous faciliter la tâche.
  4. Sélectionnez "application/json" comme type de corps.
  5. Transmettez votre identifiant d’organisation IMS dans l’en-tête à l’aide de la clé « x-gw-ims-org-id ». Pour cette valeur, utilisez votre identifiant d’organisation IMS (« XXX@AdobeOrg »).

Voici un exemple d’événement d’API d’ingestion en flux continu :

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

Pour identifier plus facilement l’endroit où coller la partie « données », vous pouvez utiliser un outil de visualisation JSON tel que https://jsonformatter.curiousconcept.com.

Pour résoudre les problèmes liés aux API d’ingestion en flux continu, consultez cette page.

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