adobe.target.applyOffers(options) - at.js 2.x
마지막 업데이트: 2025년 5월 5일
작성 대상:
- 개발자
이 함수를 사용하면 adobe.target.getOffers()로 검색된 오퍼를 두 개 이상 적용할 수 있습니다.
이 함수는 at.js 2.x. 이 함수는 at.js 버전 1.x 에는 사용할 수 없습니다.
| 키 | 유형 | 필수? | 설명 |
|---|---|---|---|
| selector | 문자열 | 아니오 | Target이 오퍼 컨텐츠를 배치해야 하는 HTML 요소를 식별하는 데 사용되는 HTML 요소 또는 CSS 선택기입니다. 선택기를 제공하지 않으면 Target에서 사용할 HTML 요소를 HTML HEAD으로 간주합니다. |
| 응답 | 개체 | 예 | getOffers()의 응답 개체.아래의 "요청" 표를 참조하십시오. |
응답
아래 나열된 모든 필드에 허용되는 유형에 대한 자세한 내용은 배달 API 설명서를 참조하십시오.
| 필드 이름 | 설명 |
|---|---|
| response > prefetch > views > options > content | "선택 사항"의 컨텐츠가 잘 정의되어 있지 않으며 선택 사항 유형/템플릿 구조에 직접적으로 의존합니다. |
| response > prefetch > views > options > type | 선택 사항 유형. "컨텐츠" 필드의 유형을 반영합니다. 지원되는 유형은 작업입니다. |
| response > prefetch > views > state | 보기에 대한 디스플레이 알림과 함께 전달해야 하는 불투명 보기 상태 토큰 |
| response > prefetch > views > options > responseTokens | 현재 선택 사항이 처리 중일 때 수집된 responseTokens의 맵을 포함합니다. |
| response > prefetch > views > analytics > payload | 보기를 적용한 후 Analytics에 전송해야 하는 클라이언트측 통합을 위한 Analytics 페이로드입니다. |
| response > prefetch > views > trace | 보기당 미리 가져오기 호출에 대한 모든 추적 데이터를 포함하는 개체. 추적 개체에는 추적용 버전도 포함됩니다. 추적 개체에는 현재 보기에 대한 세부 정보도 포함됩니다. |
| response > prefetch > views > options > eventToken | 이벤트 로깅은 선택 사항별로 수행됩니다. 적용된 모든 선택 사항에 대해 각각의 이벤트 토큰을 알림 토큰 목록에 추가해야 합니다. 보기는 여러 선택 사항으로 구성됩니다. 모든 선택 사항이 적용되어 표시되면 모든 eventTokens이 알림에 포함되어야 합니다. |
| response > prefetch > views > name | 사람이 읽을 수 있는 보기 이름. |
| response > prefetch > views > metrics | 감시하고 Target에 알려야 하는 보고 지표. 현재, 클릭 지표만 지원됩니다. 요소를 클릭하면 적절한 eventTokens가 수집되고 알림이 전송되어야 합니다. |
| response > prefetch > views > key | 보기를 식별하는 키 또는 지문. |
| response > prefetch > views > id | 보기의 ID. |
| 응답 > 알림 > ID | 알림 ID. |
| response > notifications > events > type | 알림, 클릭 또는 표시의 유형. |
| response > notifications > events > trace | 알림 이벤트에 대한 추적. |
| response > notifications > events > token | 알림 이벤트와 함께 전송된 토큰. |
| response > notifications > events > timestamp | 알림 이벤트와 함께 전송된 타임스탬프. |
| response > notifications > events > errorCode | 알림이 실패한 경우 코드가 실패 이유를 나타냅니다. |
| response > notifications > events | 현재 알림에 대해 기록되었거나 기록되지 않은 이벤트. |
| response > notifications | 기록되었거나 실패한 알림을 가리킵니다. |
| response > execute > mboxes > mbox > trace | 개별 mbox 요청에 대한 모든 추적 데이터를 포함하는 개체. |
| response > execute > mboxes > mbox > responseTokens | 특정 mbox 요청 실행을 위한 responseTokens의 맵을 포함합니다. |
| response > execute > mboxes > mbox > option > content | "선택 사항"의 컨텐츠가 잘 정의되어 있지 않으며 선택 사항 유형/템플릿 구조에 직접적으로 의존합니다. |
| response > execute > mboxes > mbox > option > type | 선택 사항 유형. "컨텐츠" 필드의 유형을 반영합니다. 지원되는 유형은 html, 리디렉션, JSON 및 다이내믹입니다. |
| response > execute > mboxes > mbox > options | 응답 선택 사항. |
| response > execute > mboxes > mbox > metrics > eventToken | 클릭 이벤트의 토큰. |
| response > execute > mboxes > mbox > metrics > type | "click" |
| response > execute > mboxes > mbox > metrics | clickThrough 지표 목록을 포함합니다. |
| response > execute > mboxes > mbox > mbox | mbox의 이름. |
| response > execute > mboxes > mbox >index | 응답이 요청에서 나온 이 색인이 있는 mbox용임을 나타냅니다. |
| response > execute > mboxes > mbox > analytics > payload | mbox가 적용된 후 Analytics (으)로 전송해야 하는 클라이언트측 통합을 위한 Analytics 페이로드입니다. (A4T 사용 "캠페인" 섹션을 참조하십시오.) |
| response > execute > mboxes | 실행된 mbox 목록. |
| response > execute > pageLoad > options > content | "선택 사항"의 컨텐츠가 잘 정의되어 있지 않으며 선택 사항 유형/템플릿 구조에 직접적으로 의존합니다. |
| response > execute > pageLoad > options > type | 선택 사항 유형. "컨텐츠" 필드의 유형을 반영합니다. 지원되는 유형은 html, 리디렉션, JSON, 다이내믹 및 작업입니다. |
| response > execute > pageLoad > options | 보기를 기준으로 그룹화되지 않은 선택 사항(target-global-mbox + 보기를 기준으로 그룹화되지 않은 보기를 사용하는 활동의 선택 사항). |
| response > execute > pageLoad > metrics | 특정 보기에 속하도록 설정되지 않은 클릭 지표. |
| response > execute > pageLoad > trace | pageLoad 요청에 대한 모든 추적 데이터를 포함하는 개체. |
| response > execute > pageLoad > analytics > payload | 페이지 로드 콘텐츠가 적용된 후 Analytics (으)로 전송해야 하는 클라이언트측 통합을 위한 Analytics 페이로드입니다. (A4T 사용 "캠페인" 섹션을 참조하십시오.) |
applyOffers() 호출 예
adobe.target.applyOffers({response:{
"execute": {
"pageLoad": {
"options": [{
"type": "html",
"content": "page-load"
},
{
"type": "actions",
"content": [{
"type": "setHtml",
"content": "<h1>Container 1</h1>",
"selector": "#container1",
"cssSelector": "#container1"
},
{
"type": "setHtml",
"content": "<h3>Container 3</h3>",
"selector": "#container3",
"cssSelector": "#container3"
}]
}],
"metrics": [{
"type": "click",
"selector": "#container1",
"eventToken": "page-load-click-metric"
}]
}
}
}});
getOffers() 및 applyOffers()이(가) Promise 기반이므로 이 함수를 사용하는 Promise 체인 호출 예
adobe.target.getOffers({...})
.then(response => adobe.target.applyOffers({ response: response }))
.then(() => console.log("Success"))
.catch(error => console.log("Error", error));
getOffers()를 사용하는 방법에 대한 자세한 예는 getOffers 설명서를 참조하십시오.
페이지 로드 요청 예
adobe.target.getOffers({
request: {
execute: {
pageLoad: {}
}
}
}).
then(response => adobe.target.applyOffers({ response: response }))
.then(() => console.log("Success"))
.catch(error => console.log("Error", error));
recommendation-more-help
6906415f-169c-422b-89d3-7118e147c4e3