개인화에 Adobe Target 및 Web SDK 사용

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

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

Web SDK 시스템 다이어그램

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

Adobe Target 사용

Target을(를) 사용하려면 다음을 수행하십시오.

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

Adobe Target VEC 사용

VEC를 Web SDK 구현과 함께 사용하려면 Firefox 또는 Chrome VEC Helper 확장 프로그램을 설치하고 활성화하십시오.

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

개인화된 콘텐츠 렌더링

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

XDM의 대상

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

사용자 지정 매개 변수 또는 사용자 프로필을 사용하는 사전 정의된 대상이 있는 Target 활동이 있는 경우 SDK를 통해 해당 활동이 올바르게 전달되지 않습니다. 사용자 지정 매개 변수 또는 사용자 프로필을 사용하는 대신 XDM을 사용해야 합니다. 그러나 XDM이 필요하지 않은 Web SDK을(를) 통해 지원되는 기본 대상 타깃팅 필드가 있습니다. 이러한 필드는 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마다 proposition이(가) 렌더링되었는지 여부를 나타내는 renderAttempted 부울 필드가 있습니다. 아래 샘플을 참조하십시오.

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);
  });

자동 렌더링이 활성화된 경우 제안 배열에 다음이 포함됩니다.

페이지 로드 시:

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

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

페이지 로드 시:

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

단일 프로필 업데이트

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

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

콘텐츠가 최종 사용자에게 표시될 때까지 프로필 또는 엔터티 매개 변수 저장 지연

콘텐츠가 표시될 때까지 프로필의 기록 특성을 지연하려면 요청에서 data.adobe.target._save=false을(를) 설정하십시오.

예를 들어 웹 사이트에는 웹 사이트의 세 범주 링크(남성, 여성 및 아동)에 해당하는 세 가지 결정 범위가 포함되어 있으며 사용자가 최종적으로 방문한 범주를 추적하려고 합니다. 콘텐츠가 요청될 때 범주가 지속되지 않도록 __save 플래그를 false(으)로 설정하여 이러한 요청을 보냅니다. 콘텐츠가 시각화되면 기록할 해당 특성에 대한 적절한 페이로드(eventToken 및 stateToken 포함)를 보냅니다.

아래 예제에서는 trackEvent 스타일 메시지를 보내고, 프로필 스크립트를 실행하고, 속성을 저장하고, 이벤트를 즉시 기록합니다.

alloy ( "sendEvent" , {
  renderDecisions : true,
  data : {
    __adobe : {
      target : {
        "profile.gender" : "female",
        "profile.age" : 30,
        "entity.name" : "T-shirt" ,
        "entity.id" : "1234" ,
        "track": {
          "scopes": [ "mbox1", "mbox2"],
          "type": "display|click|..."
        }
      }
    }
  }
} ) ;

프로필 데이터가 있는 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 특성과 각 특성이 Web SDK을(를) 통해 지원되는지 여부가 나열되어 있습니다.

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

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

디버깅

mboxTrace 및 mboxDebug는 더 이상 사용되지 않습니다. 대신 Web SDK 디버깅의 메서드를 사용하십시오.

용어

제안: Adobe Target에서 제안은 활동에서 선택한 경험과 상관 관계가 있습니다.

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

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

XDM: XDM은 점 표기법으로 serialize된 다음 mBox 매개 변수로 Adobe Target에 삽입됩니다.