Etapas adicionais para enviar eventos ao Journey Orchestration

Última atualização em 2023-05-24
  • Tópicos
  • Journeys
    Exibir mais informações sobre este tópico
  • Criado para:
  • Intermediate
    User
OBSERVAÇÃO

Ao criar um evento, Journey Orchestration O gera automaticamente uma ID para esse evento. O sistema que envia o evento não deve gerar uma ID, mas usar a disponível na pré-visualização de carga. Consulte esta página.

Para configurar eventos a serem enviados para o Streaming Ingestion APIs e para serem utilizados em Journey Orchestration, é necessário seguir estas etapas:

  1. Obter o URL de entrada das APIs do Adobe Experience Platform (consulte APIs de assimilação de fluxo).
  2. Copie o conteúdo da pré-visualização de carga no Event menu. Consulte esta página.

Em seguida, é necessário configurar o sistema de dados que envia eventos para as APIs de assimilação de streaming usando a carga útil copiada:

  1. Configure uma chamada de API POST para o URL das APIs de assimilação de streaming (chamada de entrada).
  2. Usar a carga copiada do Journey Orchestration no corpo ("seção de dados") da chamada da API para as APIs de assimilação de streaming. Veja um exemplo abaixo
  3. Determine onde obter todas as variáveis presentes na carga. Exemplo: se o evento deve transmitir o endereço, a carga colada mostrará "address": "string". "string" deve ser substituída pela variável que preencherá automaticamente o valor correto, o email da pessoa para a qual enviar uma mensagem. Observe que na pré-visualização de carga, no campo Header preenchemos automaticamente muitos valores para facilitar o trabalho.
  4. Selecione "application/json" como um tipo de corpo.
  5. Passe sua IMS Organization ID no cabeçalho usando a chave "x-gw-ims-org-id". Para o valor, use sua IMS Organization ID ("XXX@AdobeOrg").

Este é um exemplo de um evento de APIs de assimilação de fluxo:

{
    "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 a identificação do local onde colar a parte de "dados", você pode usar uma ferramenta de visualização JSON, como https://jsonformatter.curiousconcept.com

Para solucionar problemas de APIs de assimilação de fluxo, consulte esta página.

Nesta página