이 페이지에서: 구성한 이벤트가 실제로 Journey Optimizer에 도달하고 여정을 트리거하도록 스트리밍 수집 API에 이벤트를 푸시하도록 데이터 시스템을 설정합니다.
스트리밍 수집 API에 보내고 Journey Optimizer에서 사용할 이벤트를 구성하려면 다음 단계를 수행해야 합니다.
- Adobe Experience Platform API에서 인렛 URL을 가져옵니다. 수집 API 스트리밍 개요에서 자세히 알아보세요.
- 이벤트 메뉴의 페이로드 미리 보기에서 페이로드를 복사합니다. 이 페이지에서 자세히 알아보십시오.
IMPORTANT
이벤트 요구 사항 및 제한 사항(스트리밍, 쿼리 서비스, 일괄 처리 수집)에 대해서는 여정 보호 - 이벤트를 참조하십시오.
그런 다음 복사한 페이로드를 사용하여 이벤트를 스트리밍 수집 API로 푸시하는 데이터 시스템을 구성해야 합니다.
- 스트리밍 수집 API URL(인렛이라고 함)에 대한 POST API 호출을 설정합니다.
- 스트리밍 수집 API에 대한 API 호출의 본문(“데이터 섹션”)에 있는 Journey Optimizer에서 복사한 페이로드를 사용합니다. 예제는 아래를 참조하십시오
- 페이로드에 있는 모든 변수를 가져올 위치를 결정합니다. 예: 이벤트가 주소를 전달해야 하는 경우 붙여넣은 페이로드에 “address”: "string"이 표시됩니다. "string"은 올바른 값(메시지를 보낼 사람의 이메일)을 자동으로 채우는 변수로 대체해야 합니다. 페이로드 미리 보기의 헤더 섹션에서 작업을 용이하게 하기 위해 필요한 많은 값을 자동으로 채웁니다.
- 본문 유형으로 "application/json"을 선택합니다.
- “x-gw-ims-org-id” 키를 사용하여 헤더에 조직 ID를 전달합니다. 값에 조직 ID(“XXX@AdobeOrg”)를 사용합니다.
다음은 스트리밍 수집 API 이벤트의 예입니다.
{
"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": "2023-05-29T00:00:00.000Z",
"_experience": {
"campaign": {
"orchestration": {
"eventID": "XXX"
}
}
}
}
}
}
“데이터” 부분을 붙여넣을 위치를 쉽게 확인하려면 JSON 포맷터와 같은 JSON 시각화 도구를 사용할 수 있습니다.
스트리밍 수집 API의 문제를 해결하려면 Experience Platform 설명서를 참조하세요.
AI Knowledge Reference
This section contains structured knowledge intended to support interpretation, retrieval, and question answering related to this topic.
For complete understanding, this information should be combined with the documentation on this page. Neither source is intended to stand alone; the page describes the feature, while this section provides additional context that helps disambiguate terminology, intent, applicability, and constraints.
- TL;DR: This page explains the additional steps to set up a data system that pushes events to the Streaming Ingestion APIs, using the payload copied from the payload preview, so configured events actually reach Journey Optimizer and trigger journeys.
Intents:
- Get the inlet URL from Adobe Experience Platform APIs
- Copy the payload from the payload preview in the Event menu
- Set up a POST API call to the Streaming Ingestion APIs inlet using the copied payload
- Map the payload variables to the values that should populate them
- Configure the request body type and the organization ID header for the call
Glossary:
- Streaming Ingestion APIs: The Adobe Experience Platform APIs to which events must be pushed so they reach Journey Optimizer (product-specific)
- Inlet: The Streaming Ingestion APIs URL to which the POST API call is sent (product-specific)
- Payload preview: The view in the Event menu from which you copy the payload to use in the body of the API call (product-specific)
- x-gw-ims-org-id: The header key used to pass your organization ID in the API call (product-specific)
Guardrails:
- Set up a POST API call to the Streaming Ingestion APIs URL (the inlet) and place the copied payload in the body, the data section, of the call.
- Select application/json as the body type.
- Pass the organization ID in the header using the key x-gw-ims-org-id, with the organization ID value in the form XXX@AdobeOrg.
- In the payload preview Header section, many expected values are autofilled to facilitate the work.
Terminology:
- Canonical name: Streaming Ingestion APIs — Acronym: n/a — variants: inlet, inlet URL
- Synonyms: “inlet” = “Streaming Ingestion APIs URL”
- Do not confuse: “header” (section carrying values such as x-gw-ims-org-id) ≠ “body” (the data section carrying the payload)
FAQ:
- Q: Where do I get the payload to send? — Copy it from the payload preview in the Event menu.
- Q: What body type should the API call use? — application/json.
- Q: How do I pass the organization ID? — In the header, using the key x-gw-ims-org-id with the value in the form XXX@AdobeOrg.
- Q: What kind of API call is used to send events? — A POST API call to the Streaming Ingestion APIs URL, called an inlet.
recommendation-more-help
journey-optimizer-help