Platform Web SDK에서 Adobe Target 사용

Adobe Experience Platform Web SDK 은 에서 관리하는 개인화된 경험을 웹 채널 Adobe Target 에 제공하고 렌더링할 수 있습니다. 시각적 경험 작성기 (VEC)라고 하는 WYSIWYG 편집기 또는 양식 기반 경험 작성기라는 비시각적 인터페이스를 사용하여 활동 및 개인화 경험을 만들고, 활성화하고 전달할 수 있습니다.

중요

Adobe Target 설명서에는 Target 기능 및 기능과 관련된 Platform Web SDK와 관련된 정보가 포함된 항목이 포함되어 있습니다.

다음 기능은 테스트되었으며 현재 Target에서 지원됩니다.

Platform Web SDK 시스템 다이어그램

다음 다이어그램은 Target 및 Platform Web SDK Edge Decisioning의 워크플로우를 이해하는 데 도움이 됩니다.

Platform Web SDK를 사용한 Adobe Target Edge 의사 결정 다이어그램

호출 세부 사항
1 장치가 Platform Web SDK을 로드합니다. Platform Web SDK은(는) XDM 데이터, 데이터 스트림 환경 ID, 전달된 매개 변수 및 고객 ID(선택 사항)를 사용하여 Edge 네트워크에 요청을 보냅니다. 페이지(또는 컨테이너)는 미리 숨겨져 있습니다.
2 에지 네트워크는 방문자 ID, 동의 및 지리적 위치 및 장치 친숙한 이름과 같은 기타 방문자 컨텍스트 정보로 보강하기 위해 에지 서비스에 요청을 보냅니다.
3 에지 네트워크는 방문자 ID 및 전달된 매개 변수와 함께 Target 에지에 보강된 개인화 요청을 보냅니다.
4 프로필 스크립트가 실행된 다음 Target 프로필 저장소에 반영됩니다. 프로필 저장소는 대상 라이브러리에서 세그먼트를 가져옵니다(예: Adobe Analytics, Adobe Audience Manager, Adobe Experience Platform에서 공유된 세그먼트).
5 Target 은 URL 요청 매개 변수 및 프로필 데이터를 기반으로 현재 페이지 보기 및 향후 미리 가져온 보기에 대해 방문자에 대해 표시할 활동 및 경험을 결정합니다. Target 그런 다음 이 파일을 다시 에지 네트워크로 보냅니다.
6 a. 에지 네트워크는 개인화 응답을 다시 페이지로 보냅니다. 원할 경우 추가적인 개인화를 위한 프로필 값을 포함할 수 있습니다. 현재 페이지의 개인화된 콘텐츠는 기본 콘텐츠의 플리커 없이 가능한 한 빨리 나타납니다.
나. SPA(단일 페이지 애플리케이션)에서 사용자 작업의 결과로 표시되는 보기에 대한 개인화된 콘텐츠는 캐시되므로, 보기가 트리거될 때 추가 서버 호출 없이 즉시 적용할 수 있습니다.
c. 에지 네트워크가 동의, 세션 ID, ID, 쿠키 확인, 개인화 등의 쿠키에 방문자 ID 및 기타 값을 보냅니다.
7 에지 네트워크는 Target 분석 (A4T) 세부 사항(활동, 경험 및 변환 메타데이터)을 Analytics 에지에 전달합니다.

Adobe Target 활성화

Target을 활성화하려면 다음을 수행하십시오.

  1. 적절한 클라이언트 코드로 데이터 스트림에서 Target을 활성화합니다.
  2. 이벤트에 renderDecisions 옵션을 추가합니다.

그런 다음, 선택적으로 다음 옵션을 추가할 수도 있습니다.

  • decisionScopes: 이벤트에 이 옵션을 추가하여 특정 활동(양식 기반 작성기로 만든 활동에 유용함)을 검색합니다.
  • 코드 조각 사전 숨김: 페이지의 특정 부분만 숨깁니다.

Adobe Target VEC 사용

Platform Web SDK 구현에서 VEC를 사용하려면 Firefox 또는 Chrome VEC Helper 확장 프로그램을 설치 및 활성화합니다.

자세한 내용은 Adobe Target 안내서​에서 시각적 경험 작성기 Helper 확장 프로그램을 참조하십시오.

개인화된 콘텐츠 렌더링

자세한 내용은 개인화 콘텐츠 렌더링을 참조하십시오.

XDM의 대상

Platform Web SDK 를 통해 전달되는 Target 활동의 대상을 정의할 때 XDM을(를) 정의하고 사용해야 합니다. XDM 스키마, 클래스 및 스키마 필드 그룹을 정의한 후 타깃팅을 위해 XDM 데이터로 정의된 Target 대상 규칙을 만들 수 있습니다. Target 내에 XDM 데이터가 Audience Builder에 사용자 지정 매개 변수로 표시됩니다. XDM은 점 표기법을 사용하여 일련화됩니다(예: web.webPageDetails.name).

사용자 지정 매개 변수 또는 사용자 프로필을 사용하는 사전 정의된 대상이 있는 Target 활동이 있는 경우 SDK를 통해 올바로 전달되지 않습니다. 사용자 지정 매개 변수 또는 사용자 프로필을 사용하는 대신 XDM을 대신 사용해야 합니다. 그러나 Platform Web SDK을 통해 지원되는 기본 대상 타깃팅 필드는 XDM이 필요하지 않습니다. 이러한 필드는 XDM이 필요하지 않은 Target UI에서 사용할 수 있습니다.

  • 타겟 라이브러리
  • 지역
  • 네트워크
  • 운영 체제
  • 사이트 페이지
  • 브라우저
  • 트래픽 소스
  • 시간대

자세한 내용은 Adobe Target 안내서​에서 대상 카테고리를 참조하십시오.

응답 토큰

응답 토큰은 주로 Google, Facebook 등과 같은 타사에 메타데이터를 전송하는 데 사용됩니다. 응답 토큰이 반환됩니다
propositions -> items 내의 meta 필드에서 다음을 수행합니다. 다음은 샘플입니다.

{
  "id": "AT:eyJhY3Rpdml0eUlkIjoiMTI2NzM2IiwiZXhwZXJpZW5jZUlkIjoiMCJ9",
  "scope": "__view__",
  "scopeDetails": ...,
  "renderAttempted": true,
  "items": [
    {
      "id": "0",
      "schema": "https://ns.adobe.com/personalization/dom-action",
      "meta": {
        "experience.id": "0",
        "activity.id": "126736",
        "offer.name": "Default Content",
        "offer.id": "0"
      }
    }
  ]
}

응답 토큰을 수집하려면 alloy.sendEvent 약속에 가입하고 propositions 를 반복합니다
items -> meta에서 세부 정보를 추출합니다. 모든 proposition에는 renderAttempted 부울 필드가 있습니다
proposition 렌더링되었는지 여부를 나타냅니다. 아래 샘플을 참조하십시오.

alloy("sendEvent",
  {
    renderDecisions: true,
    decisionScopes: [
      "hero-container"
    ]
  }).then(result => {
    const { propositions } = result;

    // filter rendered propositions
    const renderedPropositions = propositions.filter(proposition => proposition.renderAttempted === true);

    // collect the item metadata that represents the response tokens
    const collectMetaData = (items) => {
      return items.filter(item => item.meta !== undefined).map(item => item.meta);
    }

    const pageLoadResponseTokens = renderedPropositions
      .map(proposition => collectMetaData(proposition.items))
      .filter(e => e.length > 0)
      .flatMap(e => e);
  });
  

자동 렌더링 이 활성화되면 Proposition 배열에 다음이 포함됩니다.

페이지 로드 시:

  • renderAttempted 플래그가 false로 설정된 양식 기반 작성기 propositions
  • renderAttempted 플래그가 true로 설정된 시각적 경험 작성기 기반 제안
  • renderAttempted 플래그가 true로 설정된 단일 페이지 애플리케이션 보기에 대한 시각적 경험 작성기 기반 제안

보기 시 - 변경(캐시된 보기의 경우):

  • renderAttempted 플래그가 true로 설정된 단일 페이지 애플리케이션 보기에 대한 시각적 경험 작성기 기반 제안

자동 렌더링 이 비활성화되면 Proposition 배열에 다음이 포함됩니다.

페이지 로드 시:

  • renderAttempted 플래그가 false로 설정된 양식 기반 작성기 propositions
  • renderAttempted 플래그가 false로 설정된 시각적 경험 작성기 기반 제안
  • renderAttempted 플래그가 false로 설정된 단일 페이지 애플리케이션 보기에 대한 시각적 경험 작성기 기반 제안

보기 시 - 변경(캐시된 보기의 경우):

  • renderAttempted 플래그가 false로 설정된 단일 페이지 애플리케이션 보기에 대한 시각적 경험 작성기 기반 제안

단일 프로필 업데이트

Platform Web SDK을(를) 사용하면 프로필을 Target 프로필 및 Platform Web SDK에 경험 이벤트로 업데이트할 수 있습니다.

Target 프로필을 업데이트하려면 프로필 데이터가 다음과 같이 전달되는지 확인하십시오.

  • “data {“
  • “__adobe.target” 아래
  • 접두어 “profile.”(예: 아래)
유형 설명
renderDecisions 부울 개인화 구성 요소가 DOM 작업을 해석해야 하는지 여부를 지정합니다
decisionScopes 배열 <String> 결정을 검색할 범위 목록
xdm 개체 Platform Web SDK에 경험 이벤트로 실행되는 XDM에서 형식이 지정된 데이터
data 개체 대상 클래스 아래의 Target 솔루션으로 전송된 임의 키/값 쌍입니다.

이 명령을 사용하는 일반적인 Platform Web SDK 코드는 다음과 같습니다.

sendEvent프로필 데이터 사용

alloy("sendEvent", {
   renderDecisions: true|false,
   xdm: { // Experience Event XDM data },
   data: { // Freeform data }
});

프로필 속성을 Adobe Target에 보내는 방법:

alloy("sendEvent", {
  renderDecisions: true,
  data: {
    __adobe: {
      target: {
        "profile.gender": "female",
        "profile.age": 30
      }
    }
  }
});

권장 사항 요청

다음 표에는 Recommendations 속성과 Platform Web SDK을 통해 각 속성이 지원되는지 여부가 나열되어 있습니다.

카테고리 속성 지원 상태
Recommendations - 기본 엔티티 속성 entity.id 지원됨
entity.name 지원됨
entity.categoryId 지원됨
entity.pageUrl 지원됨
entity.thumbnailUrl 지원됨
entity.message 지원됨
entity.value 지원됨
entity.inventory 지원됨
entity.brand 지원됨
entity.margin 지원됨
entity.event.detailsOnly 지원됨
Recommendations - 사용자 지정 엔티티 속성 entity.yourCustomAttributeName 지원됨
Recommendations - 예약된 mbox/페이지 매개 변수 excludedIds 지원됨
cartIds 지원됨
productPurchasedId 지원됨
카테고리 친화성에 대한 페이지 또는 항목 카테고리 user.categoryId 지원됨

Recommendations 특성을 Adobe Target에 보내는 방법:

alloy("sendEvent", {
  renderDecisions: true,
  data: {
    __adobe: {
      target: {
        "entity.id" : "123",
        "entity.genre" : "Drama"
      }
    }
  }
});

디버깅

mboxTrace 및 mboxDebug는 더 이상 사용되지 않습니다. Platform Web SDK 디버깅을 사용하십시오.

용어

제안: 에서 Targetproposition은 활동에서 선택한 경험과 상호 연결됩니다.

스키마: 결정 스키마는 의 오퍼 유형입니다 Target.

범위: 결정 범위입니다. Target에서 범위는 mBox입니다. 글로벌 mBox는 __view__ 범위입니다.

XDM: XDM은 점 표기법으로 직렬화된 다음 mBox 매개 Target 변수로 삽입됩니다.

이 페이지에서는