subscribeRulesetItems

subscribeRulesetItems 명령을 사용하면 충족된 규칙 세트의 결과인 제안을 구독할 수 있습니다. 필터링할 기준 표면 및 스키마를 지정하고 콜백 함수를 제공하여 이 작업을 수행할 수 있습니다.

sendEvent 명령이 전송될 때마다 규칙 집합이 평가됩니다. 콜백 함수에서 제안 배열이 포함된 result 개체를 받습니다.

IMPORTANT
subscribeRulesetItems 명령은 sendEvent개의 결과와 함께 반환되지 않으므로 규칙 세트에서 가져온 제안을 가져올 수 있는 유일한 방법입니다. sendEvent을(를) 호출하기 전에 구독을 설정하여 제안을 캡처해야 합니다.
alloy("subscribeRulesetItems", {
  surfaces: ["web://example.com/#welcome"],
  schemas: ["https://ns.adobe.com/personalization/message/content-card"],
  callback: (result, collectEvent) => {
    const { propositions = [] } = result;
    renderMyPropositions(propositions);
    collectEvent("display", propositions);
  },
});

위의 코드는 콘텐츠 카드의 web://example.com/#welcome 표면을 구독하고 collectEvent 편의 메서드를 사용하여 모든 제안에 대해 display 이벤트를 내보냅니다.

명령 옵션 command-options

이 명령은 다음 속성을 가진 options 개체를 사용합니다.

속성
유형
설명
surfaces
문자열 배열
서피스 목록입니다. 여기에 제공된 표면 중 하나와 일치하는 경우에만 제안이 콜백 함수에 의해 수신됩니다.
schemas
문자열 배열
스키마 목록. 제안이 여기에 제공된 스키마 중 하나와 일치하는 경우 콜백 함수에서만 수신됩니다.
callback
함수
제안이 충족된 규칙 세트의 결과인 경우 호출되는 콜백 함수입니다. 콜백 함수를 호출할 때 두 개의 매개 변수를 받습니다. resultcollectEvent. 자세한 내용은 콜백 매개 변수를 참조하십시오.
TIP
추가 값을 surfacesschemas 배열에 전달하여 단일 명령으로 여러 표면 및 스키마를 구독할 수 있습니다.

콜백 매개 변수 callback-parameters

콜백 함수는 호출 시 아래 표에 설명된 두 매개 변수를 수신합니다.

매개변수
유형
설명
result
오브젝트
이 개체에는 propositions 배열이 있습니다. 이 제안은 충족된 규칙 세트의 직접적인 결과입니다. result 개체는 ​ 절을 사용하여 ​에서 반환된 sendEvent결과 개체then와 동일하게 구조화되었습니다.
collectEvent
함수
인터랙션, 디스플레이 및 기타 이벤트를 추적하기 위해 Edge Network 이벤트를 전송하는 데 사용할 수 있는 편의 기능입니다.

collectEvent 함수 collectevent-function

collectEvent 함수는 상호 작용, 디스플레이 및 기타 이벤트를 추적하기 위해 Edge Network 이벤트를 전송하는 데 사용할 수 있는 편의 함수입니다. 이는 아래 표에 설명된 두 매개 변수를 허용합니다.

매개변수
유형
설명
이벤트 유형
문자열
내보낼 제안 이벤트 유형을 나타내는 문자열입니다. 지원되는 이벤트 유형은 display, interact 또는 dismiss입니다.
propositions
배열
이벤트에 해당하는 제안 배열.

collectEvent 함수는 콜백 외부에서 독립적으로 호출할 수 있습니다. 이 함수를 호출하면 사용자 작업에 대한 응답과 같이 나중에 상호 작용이나 해제를 추적할 때 유용합니다.

collectEvent("interact", propositions);

웹 SDK 태그 확장을 사용하여 콘텐츠 카드 구독

명령 응답에 해당하는 웹 SDK 태그 확장은 Subscribe ruleset items 이벤트를 구독하는 규칙입니다. 이벤트를 사용하면 원하는 스키마와 표면을 제공할 수 있습니다.

recommendation-more-help
1ae86b30-e55e-49c1-ab11-9d0356a5f3e1