설명서TargetTarget 개발자 안내서

Get Offers (Node.js)

마지막 업데이트: 2025년 5월 5일
  • 주제:
  • APIs/SDKs

작성 대상:

  • 개발자

설명

getOffers()은(는) 결정을 실행하고 Adobe Target에서 경험을 검색하는 데 사용됩니다.

방법

getOffers

TargetClient.getOffers(options: Object): Promise

매개 변수

options 개체의 구조는 다음과 같습니다.

이름유형필수기본값설명
요청개체예없음Target 배달 API 요청 준수
visitorCookey문자열아니오없음ECID(VisitorId) 쿠키
target쿠키문자열아니오없음Target 쿠키
targetLocationHint문자열아니오없음Target 위치 힌트
consumerId문자열아니요없음Analytics for Target (A4T) 결합에 대한 consumerIds
고객 ID배열아니요없음VisitorId 호환 형식의 고객 ID
sessionId문자열아니오없음여러 Target개의 요청을 연결하는 데 사용됨
(방문자개체아니오새 VisitorId외부 VisitorId 인스턴스 제공

약속

반환된 Promise의 구조는 다음과 같습니다.

이름유형설명
요청개체Target Delivery API 요청
응답개체Target Delivery API 응답
visitorState개체방문자 API getInstance()에 전달해야 하는 개체
target쿠키개체Target 쿠키
targetLocationHintCookie개체Target 위치 힌트 쿠키
analyticsDetails배열클라이언트측 Analytics 사용의 경우 Analytics 페이로드
responseTokens배열응답 토큰 목록입니다.
추적배열모든 요청 mbox/보기에 대해 집계된 추적 데이터
status개체응답의 상태를 포함하는 개체.
decisioningMethod문자열사용할 의사 결정 방법(on-device, 서버측, 하이브리드)을 결정합니다

데이터를 다시 브라우저로 전달하는 데 사용되는 targetCookie 및 targetLocationHintCookie 개체의 구조는 다음과 같습니다.

이름유형설명
이름문자열쿠키 이름
valueAny쿠키 값, 은(는) 문자열로 변환됩니다.
maxAge숫자maxAge 옵션은 현재 시간(초)을 기준으로 하여 편리하게 만료되도록 설정할 수 있습니다.

대상 응답의 상태를 나타내는 데 사용되는 status 개체의 구조는 다음과 같습니다.

이름유형설명
status숫자HTTP 상태 코드
message문자열응답에 대한 메시지. 예를 들어 응답이 장치또는 서버측에서 결정되었는지 여부를 나타낼 수 있습니다
remoteMbox배열Decisioning 메서드가 on-device인 경우 온디바이스에서 완전히 결정할 수 없는 mbox 이름 배열이 제공됩니다. 즉, Target Delivery API 요청이 필요합니다.

예

Node.js

const TargetClient = require("@adobe/target-nodejs-sdk");
const CONFIG = {
  client: "acmeclient",
  organizationId: "1234567890@AdobeOrg"
};

const targetClient = TargetClient.create(CONFIG);

const request = {
    context: {channel: "web"},
    execute: {
        mboxes: [{
            name: "a1-serverside-ab",
            index: 1
        }]
}};

const response = await targetClient.getOffers({ request });
recommendation-more-help
6906415f-169c-422b-89d3-7118e147c4e3