Decisioning API를 사용하여 오퍼 게재

의사 결정 관리를 사용하면 비즈니스 로직 및 의사 결정 규칙을 사용하여 채널 및 애플리케이션에서 최종 사용자 맞춤형 오퍼 경험을 만들고 전달할 수 있습니다. 오퍼는 오퍼를 볼 수 있는 사용자를 지정하는 규칙과 연관된 규칙이 있을 수 있는 마케팅 메시지입니다.

에 POST 요청을 만들어 오퍼를 만들고 게재할 수 있습니다 Decisioning API.

이 자습서에서는 특히 의사 결정 관리와 관련된 API를 제대로 이해해야 합니다. 자세한 내용은 의사 결정 관리 API 개발자 안내서. 또한 이 자습서에서는 고유한 배치 ID와 결정 ID 값을 사용할 수 있어야 합니다. 이러한 값을 얻지 못한 경우 배치 만들기 및 결정 생성.

➡️ 비디오에서 이 기능 살펴보기

Accept 및 Content-Type 헤더

다음 표에서는 컨텐츠 유형 및 수락 요청 헤더의 필드:

헤더 이름	값
Accept	`application/vnd.adobe.xdm+json; schema="https://ns.adobe.com/experience/offer-management/decision-response;version=1.0"`
Content-Type	`application/vnd.adobe.xdm+json; schema="https://ns.adobe.com/experience/offer-management/decision-request;version=1.0"`

API 형식

POST /{ENDPOINT_PATH}/{CONTAINER_ID}/decisions

매개 변수	설명	예
`{ENDPOINT_PATH}`	저장소 API의 끝점 경로입니다.	`https://platform.adobe.io/data/core/ode/`
`{CONTAINER_ID}`	결정이 있는 컨테이너입니다.	`e0bd8463-0913-4ca1-bd84-6309134ca1f6`

요청

curl -X POST \
  'https://platform.adobe.io/data/core/ode/e0bd8463-0913-4ca1-bd84-6309134ca1f6/decisions' \
  -H 'Accept: application/vnd.adobe.xdm+json; schema="https://ns.adobe.com/experience/offer-management/decision-response;version=1.0"' \
  -H 'Content-Type: application/vnd.adobe.xdm+json; schema="https://ns.adobe.com/experience/offer-management/decision-request;version=1.0'
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'
  -d '{
        "xdm:propositionRequests": [
            {
              "xdm:placementId": "xcore:offer-placement:ffed0456",
              "xdm:activityId": "xcore:offer-activity:ffed0123",
              "xdm:itemCount": 2
            },
            {
              "xdm:placementId": "xcore:offer-placement:ffed0012",
              "xdm:activityId": "xcore:offer-activity:fffc0789"
            }
        ],
        "xdm:profiles": [
            {
              "xdm:identityMap": {
                "SWCUSTID": [
                {
                    "xdm:id": "123@abc.com"
                }
                ]
            },
            "xdm:decisionRequestId": "0AA00002-0000-1337-c0de-c0fefec0fefe"
            }
        ],
        "xdm:allowDuplicatePropositions": {
            "xdm:acrossActivities": true,
            "xdm:acrossPlacements": true
        },
        "xdm:mergePolicy": {
            "xdm:id": "5f3ed32f-eaf1-456c-b0f0-7b338c4cb18a"
        },
        "xdm:responseFormat": {
            "xdm:includeContent": true,
            "xdm:includeMetadata": {
            "xdm:activity": [
                "name"
            ],
            "xdm:option": [
                "name"
            ],
            "xdm:placement": [
                "name"
            ]
            }
        }
      }'

속성	설명	예
`xdm:propositionRequests`	이 개체에는 배치 및 결정 식별자가 들어 있습니다.
`xdm:propositionRequests.xdm:placementId`	고유 배치 식별자입니다.	`"xdm:placementId": "xcore:offer-placement:ffed0456"`
`xdm:propositionRequests.xdm:activityId`	고유한 결정 식별자입니다.	`"xdm:activityId": "xcore:offer-activity:ffed0123"`
`xdm:itemCount`	반환할 오퍼 수입니다. 최대 수는 30개입니다.	`"xdm:itemCount": 2`
`xdm:profiles`	이 개체에는 의사 결정을 요청한 프로필에 대한 정보가 들어 있습니다. API 요청의 경우 여기에 하나의 프로필이 포함됩니다.
`xdm:profiles.xdm:identityMap`	이 개체에는 ID의 네임스페이스 통합 코드를 기반으로 하는 최종 사용자 ID 세트가 들어 있습니다. ID 맵은 각 네임스페이스의 ID를 두 개 이상 보유할 수 있습니다. 네임스페이스에 대한 자세한 내용은 이 페이지.	`Email: [{"xdm:id": "123@abc.com"}]`
`xdm:profiles.xdm:decisionRequestId`	프로필 결정 요청을 고유하게 식별하는 데 사용할 수 있는 클라이언트가 생성한 ID입니다. 이 ID는 응답에서 다시 반복되며 결정 결과에 영향을 주지 않습니다.	`"xdm:decisionRequestId": "0AA00002-0000-1337-c0de-c0fefec0fefe"`
`xdm:allowDuplicatePropositions`	이 개체는 중복 제거 규칙의 제어 구조입니다. 특정 차원에 대해 동일한 옵션을 제안할 수 있는지 여부를 나타내는 일련의 플래그로 구성됩니다. True로 설정된 플래그는 중복을 사용할 수 있으며 플래그로 표시된 카테고리에서 제거해서는 안 됩니다. false로 설정된 플래그는 의사 결정 엔진이 차원 전체에서 동일한 제안을 하지 않고 대신 하위 결정 중 하나에 대해 다음 우수 옵션을 선택해야 함을 의미합니다.
`xdm:allowDuplicatePropositions.xdm:acrossActivities`	true로 설정하면 여러 결정에서 동일한 옵션을 지정할 수 있습니다.	`"xdm:acrossActivities": true`
`xdm:allowDuplicatePropositions.xdm:acrossPlacements`	true로 설정하면 여러 배치에 동일한 옵션이 할당될 수 있습니다.	`"xdm:acrossPlacements": true`
`xdm:mergePolicy.xdm:id`	프로필 액세스 서비스에서 반환된 데이터를 제어할 병합 정책을 식별합니다. 요청에 지정되지 않은 경우 의사 결정 관리에서 프로필 액세스 서비스를 전달하지 않고, 그렇지 않으면 호출자가 제공한 ID가 전달됩니다.	`"xdm:id": "5f3ed32f-eaf1-456c-b0f0-7b338c4cb18a"`
`xdm:responseFormat`	응답 콘텐츠를 포맷하는 플래그 세트입니다.
`xdm:responseFormat.xdm:includeContent`	로 설정된 경우 부울 값 `true`에는 응답에 대한 컨텐츠가 포함됩니다.	`"xdm:includeContent": true`
`xdm:responseFormat.xdm:includeMetadata`	반환되는 추가 메타데이터를 지정하는 데 사용되는 객체입니다. 이 속성이 포함되지 않은 경우 `xdm:id` 및 `repo:etag` 기본적으로 반환됩니다.	`name`
`xdm:responseFormat.xdm:activity`	이 플래그는 에 대해 반환되는 특정 메타데이터 정보를 식별합니다 `xdm:activity`.	`name`
`xdm:responseFormat.xdm:option`	이 플래그는 에 대해 반환되는 특정 메타데이터 정보를 식별합니다 `xdm:option`.	`name`, `characteristics`
`xdm:responseFormat.xdm:placement`	이 플래그는 에 대해 반환되는 특정 메타데이터 정보를 식별합니다 `xdm:placement`.	`name`, `channel`, `componentType`

응답

성공적인 응답은 고유한 오퍼를 포함하여 제안에 대한 정보를 반환합니다 xdm:propositionId.

{
  "xdm:propositionId": "5d0ffb5e-dfc6-4280-99b6-0bf3131cb8b8",
  "xdm:propositions": [
    {
      "xdm:activity": {
        "xdm:id": "xcore:activity:ffed0123",
        "repo:etag": 4
      },
      "xdm:placement": {
        "xdm:id": "xcore:placement:ffed0456",
        "repo:etag": 1
      },
      "xdm:options": [
        {
          "xdm:id": "xcore:personalized-option:ccc0111",
          "repo:etag": 3,
          "@type": "https://ns.adobe.com/experience/decisioning/content-component-html-template",
          "xdm:content": "<html>some html</html>"
        },
        {
          "xdm:id": "xcore:personalized-option:ccc0222",
          "repo:etag": 5,
          "@type": "https://ns.adobe.com/experience/decisioning/content-component-html-template",
          "xdm:content": "<html>hello, world</html>",
          "xdm:score": 45.65
        }
      ]
    },
    {
      "xdm:activity": {
        "xdm:id": "xcore:activity:ffed0123",
        "repo:etag": 4
      },
      "xdm:placement": {
        "xdm:id": "xcore:placement:ffed0789",
        "repo:etag": 2
      },
      "xdm:fallback": {
        "xdm:id": "xcore:fallback:ccc0222",
        "repo:etag": 5,
        "@type": "https://ns.adobe.com/experience/decisioning/content-component-imagelink",
        "dc:format": "image/png",
        "xdm:deliveryURL": "https://cdn.adobe.com/content/1445323-1134331.png",
        "xdm:content": "https://www.adobe.com/index2.html"
      }
    }
  ],
  "ode:createDate": 1566497582038
}

속성	설명	예
`xdm:propositionId`	XDM DecisionEvent와 연결된 제안 엔티티에 대한 고유 식별자입니다.	`"xdm:propositionId": "5d0ffb5e-dfc6-4280-99b6-0bf3131cb8b8"`
`xdm:propositions`	이 개체에는 단일 결정 제안이 포함되어 있습니다. 결정에 대해 여러 옵션을 반환할 수 있습니다. 옵션을 찾을 수 없으면 의사 결정의 대체 오퍼가 반환됩니다. 단일 의사 결정 제안에는 항상 `options` 속성 또는 `fallback` 속성을 사용합니다. 존재할 경우 `options` 속성은 비워 둘 수 없습니다.
`xdm:propositions.xdm:activity`	이 개체에는 결정에 대한 고유 식별자가 들어 있습니다.	`"xdm:id": "xcore:activity:ffed0123"`
`xdm:propositions.xdm:placement`	이 개체에는 오퍼 배치에 대한 고유 식별자가 들어 있습니다.	`"xdm:id": "xcore:placement:ffed0456"`
`xdm:propositions.xdm:options`	이 개체에는 고유 식별자를 포함한 단일 옵션이 포함되어 있습니다. 있는 경우 이 개체를 비워 둘 수 없습니다.	`xdm:id": "xcore:personalized-option:ccc0111`
`xdm:propositions.xdm:options.@type`	구성 요소의 유형을 정의합니다. `@type` 클라이언트의 처리 계약 역할을 합니다. 경험을 어셈블하면 작성기가 특정 유형의 구성 요소를 찾습니다.	`https://ns.adobe.com/experience/offer-management/content-component-imagelink`
`xdm:propositions.xdm:content`	응답 컨텐츠의 형식입니다.	응답 콘텐츠는 다음과 같습니다. `text`, `html block`, 또는 `image link`
`xdm:score`	옵션 또는 결정과 연관된 등급 함수의 결과로 계산되는 옵션의 점수. 순위 지정 중 오퍼의 점수를 결정하는 데 등급 함수가 관여하는 경우 API에서 이 필드가 반환됩니다.	`"xdm:score": 45.65`
`xdm:propositions.xdm:fallback`	이 개체에는 고유 식별자를 포함한 단일 대체 오퍼가 포함되어 있습니다.	`"xdm:id": "xcore:fallback:ccc0222"`
`xdm:propositions.xdm:fallback.dc:format`	리소스의 실제 또는 디지털 표시. 일반적으로 형식에는 리소스의 미디어 유형이 포함되어야 합니다. 이 형식은 리소스를 표시하거나 운영하는 데 필요한 소프트웨어, 하드웨어 또는 기타 장비를 결정하는 데 사용할 수 있습니다. 통제 어휘에서 값(예: 인터넷 미디어 유형 컴퓨터 미디어 형식 정의	`"dc:format": "image/png"` 또는 `"image/jpeg"`
`xdm:propositions.xdm:fallback.xdm:deliveryURL`	컨텐츠 전달 네트워크 또는 서비스 종단점에서 자산을 읽을 수 있는 선택적 URL입니다. 이 URL은 사용자 에이전트에서 공개적으로 자산에 액세스하는 데 사용됩니다.	`https://d37yhxrr0p3l3l.cloudfront.net/0fd0f090-a148-11ea-89e3-f1f2ad52f7e8/urn:aaid:sc:US:a68c86a6-9295-4940-a083-11916b665500/0/40d78a12-f8b6-3f07-8e67-7cb8ae2cc7ec`
`ode:createDate`	의사 결정 응답 메시지를 만든 시간입니다. 이것은 시대를 대표하는 것이다.	`"ode:createDate": 1566497582038`

튜토리얼 비디오

다음 비디오는 의사 결정 관리의 구성 요소를 이해할 수 있도록 하기 위한 것입니다.

노트

이 비디오는 Adobe Experience Platform을 기반으로 하는 Offer decisioning 애플리케이션 서비스에 적용됩니다. 그러나 Journey Optimizer 컨텍스트에서 오퍼를 사용하는 일반적인 지침을 제공합니다.

다음 단계

이 API 안내서를 따르면 Decisions API. 자세한 내용은 의사 결정 관리 개요.

새로운 검색, 검색 기능 개선

Decisioning API를 사용하여 오퍼 게재

Accept 및 Content-Type 헤더

튜토리얼 비디오

다음 단계

Business.Adobe.com 리소스

이 페이지에서는

다음 보기:

학습

기술 문서

커뮤니티

고객지원

리소스

Adobe 계정

Adobe