설명서Target 개발자 안내서

adobe.target.sendNotifications(options)

Last update: Sat Jul 20 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 주제:

작성 대상:

  • 개발자

이 함수는 adobe.target.applyOffer() 또는 adobe.target.applyOffers()을(를) 사용하지 않고 경험을 렌더링할 때 Target Edge에 알림을 보냅니다.

NOTE
이 함수는 at.js 2.1.0에서 처음 소개되었으며, 2.1.0 이상 버전에서 사용할 수 있습니다.
키
유형
필수?
설명
consumerId
문자열
아니오
기본값이 제공되지 않을 경우 기본값은 클라이언트의 글로벌 mbox입니다. 이 키는 A4T 통합에 사용되는 보조 데이터 ID를 생성하는 데 사용됩니다.
요청
개체
예
아래의 "요청" 표를 참조하십시오.
timeout
숫자
아니오
요청 시간 제한. 지정하지 않으면 기본값 at.js 시간 제한이 사용됩니다.

요청

필드 이름
유형
필수?
제한 사항
설명
Request > notifications
개체 배열
예
표시된 콘텐츠, 클릭한 선택기 및/또는 방문 보기 또는 mbox에 대한 알림입니다.
Request > notifications > address
개체
아니오
Request > notifications > address > url
문자열
아니오
알림이 실행된 URL입니다.
Request > notifications > address > referringUrl
문자열
아니오
알림이 실행된 참조 URL입니다.
Request > notifications > parameters
문자열
아니오

매개 변수에는 다음 이름을 사용할 수 없습니다.

  • orderId
  • orderTotal
  • productPurchasedIds

다음 사항을 고려하십시오.

  • 매개 변수의 수는 최대 50개로 제한됩니다.
  • 매개 변수 이름은 비워둘 수 없습니다.
  • 매개 변수 이름은 최대 128자입니다.
  • 매개 변수 이름은 "profile"로 시작하면 안 됩니다.
  • 매개 변수 값의 최대 길이는 5000입니다.
Request > notifications > profileParameters
문자열
아니오

매개 변수에는 다음 이름을 사용할 수 없습니다.

  • orderId
  • orderTotal
  • productPurchasedIds

다음 사항을 고려하십시오.

  • 매개 변수의 수는 최대 50개로 제한됩니다.
  • 매개 변수 이름은 비워둘 수 없습니다.
  • 매개 변수 이름은 최대 128자입니다.
  • 매개 변수 이름은 "profile"로 시작하면 안 됩니다.
  • 매개 변수 값의 최대 길이는 5000입니다.
Request > notifications > order
개체
아니오
순서 세부 사항을 설명하는 개체입니다.

Request > notifications > order

id

문자열
아니오
<= 250자.
주문 ID.

Request > notifications > order

total

문자열
아니오
>= 0
주문 총액.

Request > notifications > order

purchasedProductIds

문자열의 배열
아니오
  • 값을 비워둘 수 없습니다.
  • 각 제품 ID의 최대 길이는 50자입니다.
  • 쉼표로 구분되고 연결된 제품 ID의 최대 길이가 250자를 초과하면 안 됩니다.
주문 제품 ID입니다.
Request > notifications > product
개체
아니오
Request > notifications > product > id
문자열
아니오
<= 128자이며, 비워 둘 수 없습니다.
제품 ID.
Request > notifications > product > categoryId
문자열
아니오
<= 128자이며, 비워 둘 수 없습니다.
카테고리 ID입니다.
Request > notifications > id
문자열
예
<= 200자.
알림 ID가 응답으로 반환되고, 알림이 성공적으로 처리되었음을 나타냅니다.
Request > notifications > impressionId
문자열
아니오
<= 128자.
노출 ID는 이전 알림을 사용하여 현재 알림을 연결(링크)하거나 요청을 실행하는 데 사용됩니다. 둘 다 일치하는 경우 두 번째와 다른 후속 요청이 활동 또는 경험에 대한 새로운 노출을 생성하지 않습니다.
Request > notifications > type
문자열
예
click 또는 display가 지원됩니다.
알림 유형입니다.
Request > notifications > timestamp
숫자<int64>
예
UNIX Epoch 이후 경과된 알림의 타임스탬프(밀리초)입니다.
Request > notifications > tokens
문자열의 배열
예
알림 유형에 따라 표시된 콘텐츠 또는 클릭한 선택기에 대한 토큰 목록입니다.
Request > notifications > mbox
개체
아니오
mbox에 대한 알림입니다.

Request > notifications > mbox

name

문자열
아니오

값을 비워둘 수 없습니다.

허용된 문자: 이 표 다음에 나오는 참고 사항을 참조하십시오.

mbox 이름.

Request > notifications > mbox

state

문자열
아니오
mbox 상태 토큰입니다.
Request > notifications > view
개체
아니오

Request > notifications > view

id

정수 <int64>
아니오
ID 보기. API 보기를 통해 보기를 만들 때 보기에 지정된 ID입니다.

Request > notifications > view

name

문자열
아니오
<= 128자.
보기의 이름입니다.

Request > notifications > view

key

문자열
아니오
<= 512자.
키 보기. API를 통해 보기에 설정된 키입니다.

Request > notifications > view

state

문자열
아니오
상태 토큰 보기.

참고: 다음 문자는 Request > notifications > mbox > name에 사용할 수 있는 허용되지 않음 ​입니다.

- '-, ./=`:;&!@#$%^&*()+|?~[]{}'

프리페치된 mbox 렌더링 후 sendNotifications() 호출

function createTokens(options) {
  return options.map(e => e.eventToken);
}

function createNotification(mbox, type, tokens) {
  const id = 11111; // here we should use a random ID like UUID
  const timestamp = Date.now();
  const { name, state, parameters, profileParameters, order, product } = mbox;
  const result = {
    id,
    type,
    timestamp,
    parameters,
    profileParameters,
    order,
    product
  };

  result.mbox = { name, state };
  result.tokens = tokens;

  return result;
}

adobe.target.getOffers({
  request: {
    prefetch: {
      mboxes: [
        {
          index: 0,
          name: "a1-serverside-ab"
        }
      ]
    }
  }
})
.then(response => {
  const mboxes = response.prefetch.mboxes;
  const notifications = mboxes.map(mbox => {
    const type = "display";
    const tokens = createTokens(mbox.options);

    return createNotification(mbox, type, tokens);
  });

  adobe.target.sendNotifications({
    request: { notifications }
  });
})
NOTE
미리 가져오기 전용 Adobe Analytics, getOffers() 및 sendNotifications()을(를) 사용하는 경우 sendNotifications()이(가) 실행된 후에 Analytics 요청을 실행해야 합니다. 목적은 sendNotifications()에 의해 생성된 SDID가 Analytics 및 Target에 전송된 SDID와 일치하는지 확인하는 것입니다.
recommendation-more-help
6906415f-169c-422b-89d3-7118e147c4e3