배달 API를 사용하여 권장 사항 가져오기

마지막 업데이트: 2025년 5월 5일

작성 대상:

  • 개발자

Adobe Target 및 Adobe Target Recommendations API를 사용하여 웹 페이지에 응답을 제공할 수 있지만 앱, 화면, 콘솔, 이메일, 키오스크 및 기타 디스플레이 장치를 비롯한 비 HTML 기반 경험에서도 사용할 수 있습니다. 즉, Target 라이브러리와 JavaScript을 사용할 수 없는 경우에도 Target 배달 API를 사용하면 전체 Target 기능에 액세스하여 개인화된 경험을 전달할 수 있습니다.

노트
실제 권장 사항(권장 제품 또는 항목)이 포함된 콘텐츠를 요청할 때 Target 배달 API를 사용하십시오.

권장 사항을 검색하려면 적절한 컨텍스트 정보로 Adobe Target 배달 API POST 호출을 전송하십시오. 이 정보에는 사용자 ID(사용자의 최근에 본 항목과 같은 프로필별 권장 사항과 함께 사용하기 위해), 관련 mbox 이름, mbox 매개 변수, 프로필 매개 변수 또는 기타 속성이 포함될 수 있습니다. 응답에는 JSON 또는 HTML 형식의 권장 entity.ids(및 다른 엔티티 데이터를 포함할 수 있음)가 포함되며, 해당 값은 장치에 표시될 수 있습니다.

Adobe Target용 배달 API은(는) 표준 Target 요청에서 제공하는 모든 기존 기능을 노출합니다.

게재 API:

  • RESTful 방식으로 위치 및 대상에 대한 경험 또는 오퍼를 검색할 수 있습니다.
  • 인증이 필요하지 않습니다.
  • POST만
  • 쿠키 또는 리디렉션 호출을 처리하지 않습니다.
  • 에서는 "사용자 역할"을 필요로 하지 않으며, 인식하지도 않습니다. 콘텐츠를 가져오거나 Target 에지 서버에 이벤트를 보고합니다.

배달 API를 사용하여 Target 경험(권장 사항 포함)을 전달하려면 다음 단계를 따르십시오.

  1. 시각적 경험 작성기가 아닌 양식 기반 작성기를 사용하여 Target 활동(A/B, XT, AP 또는 Recommendations)을 만듭니다.
  2. 배달 API를 사용하여 방금 만든 Target 활동으로 생성된 요청에 대한 응답을 가져옵니다.

<!— 질문: 두 가지 단계가 모두 필요한 이유는 무엇입니까? mbox에 대해 양식 기반 권장 사항이 정의된 경우 게재 API를 단계별로 사용하여 결과를 검색할 수 있다는 점/이점은 무엇입니까? 양식 기반 Rec로 대상 장치에 결과를 전달하지 않는 이유는 무엇입니까?..?? A: 아래 사용 사례 참조… 결과를 표시하기 전에 더 많은 작업을 수행하기 위해 보류 중인 결과를 "가로채기"하려는 경우입니다. 재고 수준에 대한 실시간 비교와 같은 것입니다. —>

양식 기반 경험 작성기를 사용하여 추천 만들기

배달 API와 함께 사용할 수 있는 권장 사항을 만들려면 양식 기반 작성기를 사용하십시오.

  1. 먼저 권장 사항에 사용할 JSON 기반 디자인을 작성 및 저장합니다. 샘플 JSON과 양식 기반 활동을 구성할 때 JSON 응답을 반환하는 방법에 대한 배경 정보는 권장 디자인 만들기에 대한 설명서를 참조하십시오. 이 예제에서 디자인 이름은 단순 JSON 입니다.
    server-side-create-recs-json-design.png

  2. Target에서 Activities > Create Activity > Recommendations(으)로 이동한 다음 Form ​을(를) 선택합니다.

    server-side-create-recs.png

  3. 속성을 선택하고 Next ​을(를) 클릭합니다.

  4. 사용자가 권장 사항의 응답을 받을 위치를 정의합니다. 아래 예제에서는 api_charter 위치를 사용합니다. 이전에 만든 단순 JSON 이라는 JSON 기반 디자인을 선택하십시오.
    server-side-create-recs-form.png

  5. 권장 사항을 저장하고 활성화합니다. 그러면 결과가 생성됩니다. 결과가 준비되면 배달 API를 사용하여 결과를 검색할 수 있습니다.

게재 API 사용

배달 API의 구문은 다음과 같습니다.

POST https://{{CLIENT_CODE}}.tt.omtrdc.net/rest/v1/delivery

  1. 클라이언트 코드가 필요합니다. 다시 말해서 Recommendations > Settings(으)로 이동하여 Adobe Target에서 클라이언트 코드를 찾을 수 있습니다. 권장 API 토큰 섹션의 클라이언트 코드 값을 참고하십시오.
    client-code.png

  2. 클라이언트 코드가 있으면 배달 API 호출을 구성합니다. 아래 예제는 배달 API Postman 컬렉션에서 제공된 Web Batched Mboxes Delivery API Call ​에서 시작하여 관련 내용을 수정합니다. 예:

    • browser 및 address 개체는 HTML 이외의 사용 사례에 필요하지 않으므로 Body ​에서 제거되었습니다.

    • api_charter ​이(가) 이 예제에서 위치 이름으로 나열됩니다.

    • 이 권장 사항은 현재 항목 키를 Target에 전달해야 하는 콘텐츠 유사성을 기반으로 하므로 entity.id가 지정됩니다.

      server-side-Delivery-API-call.png
      쿼리 매개 변수를 올바르게 구성해야 합니다. 예를 들어 필요에 따라 {{CLIENT_CODE}}을(를) 지정해야 합니다. <!— Q: 업데이트된 호출 구문에서 entity.id는 이전 버전에서와 같이 mboxParameter 대신 profileParameter로 나열됩니다. —> <!— Q: 이전 이미지 server-side-create-recs-post.png 이전 첨부 텍스트: "이 권장 사항은 mboxParameters를 통해 전송된 entity.id를 기반으로 하는 콘텐츠 유사 제품을 기반으로 합니다." —>
      client-code3

  3. 요청을 보냅니다. 권장 엔터티 목록을 출력하는 JSON 디자인으로 정의된 활성 권장 사항이 실행 중인 api_charter 위치에 대해 실행됩니다.

  4. JSON 디자인을 기반으로 응답을 받습니다.
    server-side-create-recs-json-response2.png
    응답에는 키 ID와 권장 엔티티의 엔티티 ID가 포함됩니다.

이러한 방식으로 권장 사항과 함께 배달 API를 사용하면 HTML이 아닌 장치에서 방문자에게 권장 사항을 표시하기 전에 추가 단계를 수행할 수 있습니다. 예를 들어 최종 결과를 표시하기 전에 배달 API의 응답을 가져와서 다른 시스템(예: CMS, PIM 또는 전자 상거래 플랫폼)에서 엔티티 속성 세부 사항(재고, 가격, 등급 등)을 추가로 실시간 조회할 수 있습니다.

이 안내서에 설명된 접근 방식을 사용하면 모든 애플리케이션에서 Target의 응답을 활용하여 개인화된 추천을 제공할 수 있습니다.