Platform Web SDK에서 Offer decisioning 사용

마지막 업데이트: 2023-12-06
  • 주제:
  • Web SDK
    이 항목에 대한 자세한 내용 보기
  • 작성 대상:
  • Developer
    User
    Admin
    Leader
노트

선택한 사용자에 대한 조기 액세스에서 Adobe Experience Platform Web SDK의 Offer decisioning을 사용할 수 있습니다. 일부 조직에서는 이 기능을 사용할 수 없습니다.

Adobe Experience Platform Web SDK 은 Offer Decisioning에서 관리되는 개인화된 오퍼를 제공하고 렌더링할 수 있습니다. offer decisioning UI(사용자 인터페이스) 또는 API를 사용하여 오퍼 및 기타 관련 개체를 만들 수 있습니다.

전제 조건

  • 조직이 Edge Decisioning에 대해 활성화되었습니다.
  • 오퍼, 활동 생성됨
  • 데이터 스트림이 게시됨

용어

offer decisioning 작업 시 다음 용어를 이해하는 것이 중요합니다. 자세한 내용을 알고 추가 약관을 보려면 다음을 방문하십시오. Offer decisioning 용어집.

  • 컨테이너: 용기는 서로 다른 문제를 분리하기 위한 격리 메커니즘입니다. 컨테이너 ID는 모든 저장소 API의 첫 번째 경로 요소입니다. 모든 의사 결정 개체는 컨테이너 내에 있습니다.

  • 결정 범위: offer decisioning의 경우 결정 범위는 offer decisioning 서비스가 오퍼를 제안하는 데 사용할 활동 및 배치 ID가 포함된 JSON의 Base64로 인코딩된 문자열입니다.

    결정 범위 JSON:

    {
      "activityId":"xcore:offer-activity:11cfb1fa93381aca",
      "placementId":"xcore:offer-placement:1175009612b0100c"
    }
    

    결정 범위 Base64 인코딩 문자열:

    "eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTFjZmIxZmE5MzM4MWFjYSIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjExNzUwMDk2MTJiMDEwMGMifQ=="
    

    다음에서 결정 범위 값을 복사할 수 있습니다. 활동 개요 UI의 페이지.

    결정 복사 설정.

  • 데이터스트림: 자세한 내용은 다음을 참조하십시오. 데이터스트림 설명서를 참조하십시오.

  • 신원: 자세한 내용은 이 설명서 의 개요를 참조하십시오 Platform Web SDK에서 ID 서비스 사용.

활성화 Offer decisioning

offer decisioning을 활성화하려면 다음 단계를 수행하십시오.

  1. 에서 Adobe Experience Platform 활성화됨 데이터스트림 및 "Offer decisioning" 상자를 선택합니다.

    offer-decisioning-edge-config

  2. 다음 지침을 따르십시오 sdk 설치 (SDK는 독립 실행형 또는 UI를 통해 설치할 수 있습니다. 다음을 참조하십시오. 태그 빠른 시작 안내서)를 참조하십시오.

  3. SDK 구성 offer decisioning. 추가적인 Offer decisioning 관련 단계는 아래에 나와 있습니다.

    • 독립 실행형 SDK 설치

      1. 를 사용하여 "sendEvent" 작업 구성 decisionScopes

         alloy("sendEvent", {
            ...
            "decisionScopes": [
                "eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTIxYWIwOWMxM2JkZDIyNCIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjEyMWFiMDZhODRkMDViMTEifQ==",
                "eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTIxYWIyNWI5NTUwNWIxZiIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjEyMWFiMjFmOTQzMDE0MmIifQ=="
            ]
         })
        
    • 태그를 통해 SDK 설치

      1. 태그 속성 만들기

      2. 포함 코드 추가

      3. "데이터스트림" 드롭다운에서 구성을 선택하여 생성한 데이터스트림으로 Platform Web SDK 확장을 설치하고 구성합니다. 다음에서 설명서를 참조하십시오. 확장.

        install-aep-web-sdk-extension

        configure-aep-web-sdk-extension

      4. 필요한 항목 만들기 데이터 요소. 최소한 Platform Web SDK ID 맵 및 Platform Web SDK XDM 개체 데이터 요소를 만들어야 합니다.

        identity-map-data-element

        xdm-object-data-element

      5. 사용자 만들기 규칙.

        • Platform Web SDK 이벤트 보내기 작업 추가 및 관련 작업 추가 decisionScopes 해당 작업 구성에 추가

          send-event-action-decisionScopes

      6. 라이브러리 만들기 및 게시 사용자가 구성한 모든 관련 규칙, 데이터 요소 및 확장 포함

샘플 요청 및 응답

1개 decisionScopes

요청

{
  "events": [
    {
      "xdm": {
        "identityMap": {
          "ECID": [
            {
              "id": "91133425615229052182584359620783097099"
            }
          ]
        }
      },
      "query": {
        "personalization": {
          "decisionScopes": [
            "eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTFjZmIxZmE5MzM4MWFjYSIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjExNzUwMDk2MTJiMDEwMGMifQ=="
          ]
        }
      }
    }
  ]
}
속성 필수 여부 설명 제한
identityMap 다음을 참조하십시오. Identity Service 설명서. 요청당 하나의 ID. { "identityMap": { "ECID": [ { "id": "91133425615229052182584359620783097099" } ] } } 질문에 답합니다.

참고: 사용자는 다음을 포함할 필요가 없습니다 ECID API 호출의 매개 변수입니다. 이 매개 변수는 필요한 경우 호출에 자동으로 추가됩니다.
decisionScopes 활동 및 배치 ID가 포함된 JSON의 Base64 인코딩 문자열 배열입니다. 최대 30 decisionScopes 요청에 따라. "decisionScopes": ["eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTFjZmIxZmE5MzM4MWFjYSIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjExNzUwMDk2MTJiMDEwMGMifQ=="]

응답

{
  "requestId": "94c4f2f1-9218-43ce-afd3-eb0d853c5174",
  "handle": [
    {
      "payload": [
        {
          "id": "2862bb89-5df2-4bc6-85c2-d8f7e1a091de",
          "scope": "eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTFjZmIxZmE5MzM4MWFjYSIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjExNzUwMDk2MTJiMDEwMGMifQ==",
          "activity": {
            "id": "xcore:offer-activity:11cfb1fa93381aca",
            "etag": "2"
          },
          "placement": {
            "id": "xcore:offer-placement:1175009612b0100c",
            "etag": "1"
          },
          "items": [
            {
              "id": "xcore:personalized-offer:124cc332095cfa74",
              "schema": "https://ns.adobe.com/experience/offer-management/content-component-html",
              "etag": "1",
              "data": {
                "id": "xcore:personalized-offer:124cc332095cfa74",
                "format": "text/html",
                "language": [
                  "en-US"
                ],
                "content": "<p>20% Off on shipping</p>",
                "characteristics": {
                  "foo": "bar",
                  "foo1": "bar1"
                }
              }
            }
          ]
        }
      ],
      "type": "personalization:decisions",
      "eventIndex": 0
    }
  ]
}
속성 설명
scope 제안된 오퍼의 원인이 되는 결정 범위입니다. "scope": "eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTFjZmIxZmE5MzM4MWFjYSIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjExNzUwMDk2MTJiMDEwMGMifQ=="
activity.id 오퍼 활동에 대한 고유 ID. "id": "xcore:offer-activity:11cfb1fa93381aca"
placement.id 오퍼 배치에 대한 고유 ID. "id": "xcore:offer-placement:1175009612b0100c"
items.id 제안된 오퍼의 ID입니다. "id": "xcore:personalized-offer:124cc332095cfa74"
schema 제안된 오퍼와 연관된 콘텐츠의 스키마. "schema": "https://ns.adobe.com/experience/offer-management/content-component-html"
data.id 제안된 오퍼의 ID입니다. "id": "xcore:personalized-offer:124cc332095cfa74"
format 제안된 오퍼와 연관된 콘텐츠의 형식입니다. "format": "text/html"
language 제안된 오퍼의 콘텐츠와 연관된 언어의 배열입니다. "language": [ "en-US" ]
content 문자열 형식으로 제안된 오퍼와 연결된 콘텐츠. "content": "<p style="color:red;">20% Off on shipping</p>"
deliveryUrl 제안된 오퍼와 연결된 이미지 컨텐츠(URL 형식). "deliveryURL": "https://image.jpeg"
characteristics JSON 오브젝트 형식으로 제안된 오퍼와 연관된 특성입니다. "characteristics": { "foo": "bar", "foo1": "bar1" }

복수 decisionScopes

요청

{
  "events": [
    {
      "xdm": {
        "identityMap": {
          "ECID": [
            {
              "id": "91133425615229052182584359620783097099"
            }
          ]
        }
      },
      "query": {
        "personalization": {
          "decisionScopes": [
            "eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTFjZmIxZmE5MzM4MWFjYSIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjExNzUwMDk2MTJiMDEwMGMifQ==",
            "eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTIyMjA4YjNhODc0MDU1OCIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjEyMjIwNDUyOTUxNGEyYzAifQ==",
            "eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTIyYzkxMzg1Mjc2MDE4YyIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjEyMzMxZjU2MTYyYWEyZjcifQ=="
          ]
        }
      }
    }
  ]
}
속성 필수 여부 설명 제한
identityMap 다음을 참조하십시오. Identity Service 설명서. 요청당 하나의 ID. { "identityMap": { "ECID": [ { "id": "91133425615229052182584359620783097099" } ] } } 질문에 답합니다.

참고: 사용자는 다음을 포함할 필요가 없습니다 ECID API 호출의 매개 변수입니다. 이 매개 변수는 필요한 경우 호출에 자동으로 추가됩니다.
decisionScopes 활동 및 배치 ID가 포함된 JSON의 Base64 인코딩 문자열 배열입니다. 최대 30 decisionScopes 요청에 따라. "decisionScopes":["eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTFjZmIxZmE5MzM4MWFjYSIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjExNzUwMDk2MTJiMDEwMGMifQ==", "eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTIyMjA4YjNhODc0MDU1OCIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjEyMjIwNDUyOTUxNGEyYzAifQ=="

응답

{
  "requestId": "94c4f2f1-9218-43ce-afd3-eb0d853c5174",
  "handle": [
    {
      "payload": [
        {
          "id": "a2804dfb-a0ec-4df9-8311-59d3ecdeb642",
          "scope": "eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTFjZmIxZmE5MzM4MTEyMyIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjExNzUwMDk2MTJiMDExMjMifQ==",
          "activity": {
            "id": "xcore:offer-activity:11cfb1fa93381123",
            "etag": "1"
          },
          "placement": {
            "id": "xcore:offer-placement:1175009612b01123",
            "etag": "3"
          },
          "items": [
            {
              "id": "xcore:personalized-offer:11e36d4a22954123",
              "schema": "https://ns.adobe.com/experience/offer-management/content-component-text",
              "etag": "2",
              "data": {
                "id": "xcore:personalized-offer:11e36d4a22954123",
                "format": "text/text",
                "language": [
                  "en"
                ],
                "content": "20% Off on shipping",
                "characteristics": {
                  "foo2": "bar2"
                }
              }
            }
          ]
        },
        {
          "id": "a2804dfb-a0ec-4df9-8311-59d3ecdeb642",
          "scope": "eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTFjZmIxZmE5MzM4MWFjYSIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjExNzUwMDk2MTJiMDEwMGMifQ==",
          "activity": {
            "id": "xcore:offer-activity:11cfb1fa93381aca",
            "etag": "2"
          },
          "placement": {
            "id": "xcore:offer-placement:1175009612b0100c",
            "etag": "1"
          },
          "items": [
            {
              "id": "xcore:personalized-offer:11e36d4a2295415d",
              "schema": "https://ns.adobe.com/experience/offer-management/content-component-imagelink",
              "etag": "1",
              "data": {
                "id": "xcore:personalized-offer:11e36d4a2295415d",
                "format": "image/png",
                "language": [
                  "en"
                ],
                "deliveryURL": "https://image.jpeg",
                "characteristics": {
                  "foo": "bar",
                  "foo1": "bar1"
                }
              }
            }
          ]
        }
      ],
      "type": "personalization:decisions",
      "eventIndex": 0
    }
  ]
}
속성 설명
scope 제안된 오퍼의 원인이 되는 결정 범위입니다. "scope": "eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTFjZmIxZmE5MzM4MWFjYSIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjExNzUwMDk2MTJiMDEwMGMifQ=="
activity.id 오퍼 활동에 대한 고유 ID. "id": "xcore:offer-activity:11cfb1fa93381123"
placement.id 오퍼 배치에 대한 고유 ID. "xcore:offer-placement:1175009612b01123"
items.id 제안된 오퍼의 ID입니다. "id": "xcore:personalized-offer:11e36d4a22954123"
schema 제안된 오퍼와 연관된 콘텐츠의 스키마. "schema": "https://ns.adobe.com/experience/offer-management/content-component-text"
data.id 제안된 오퍼의 ID입니다. "id": "xcore:personalized-offer:11e36d4a22954123"
format 제안된 오퍼와 연관된 콘텐츠의 형식입니다. "format": "text/text"
language 제안된 오퍼의 콘텐츠와 연관된 언어의 배열입니다. "language": [ "en-US" ]
content 문자열 형식으로 제안된 오퍼와 연결된 콘텐츠. "content": "<p style="color:red;">20% Off on shipping</p>"
deliveryUrl 제안된 오퍼와 연결된 이미지 컨텐츠(URL 형식). "deliveryURL": "https://image.jpeg"
characteristics JSON 오브젝트 형식으로 제안된 오퍼와 연관된 특성입니다. "characteristics": { "foo": "bar", "foo1": "bar1" }

제한 사항

일부 오퍼 제한 사항은 현재 모바일 Edge Network 워크플로에서 지원되지 않습니다(예: 한도). 한도 필드 값은 모든 사용자에게 오퍼를 제공할 수 있는 횟수를 지정합니다. 자세한 내용은 오퍼 자격 규칙 및 제한 설명서.

이 페이지의