SDK 초기화
SDK 초기화 다이어그램의 단계에 따라 Adobe Target at.js JavaScript 라이브러리를 로드하는 데 필요한 모든 작업이 올바른 순서로 실행되도록 하십시오.
SDK 다이어그램 초기화 diagram
다중 페이지 애플리케이션의 경우, 이 흐름은 페이지를 다시 로드하거나 방문자가 웹 사이트의 새 페이지로 이동할 때마다 발생합니다.
{width="600" modal="regular"}
다음 링크를 클릭하여 원하는 섹션으로 이동합니다.
1.1: 방문자 API SDK 로드 load
이 단계는 VisitorAPI.js
라이브러리가 올바르게 로드, 구성 및 초기화되도록 하는 데 도움이 됩니다.
{width="400" modal="regular"}
전제 조건
- 방문자 ID/API 서비스를 사용하려면 회사에 Adobe Experience Cloud이(가) 사용하도록 설정되어 있고 Organization ID이(가) 있어야 합니다. 자세한 내용은 ID 서비스 도움말 안내서의 Experience Cloud 요구 사항: 조직 ID을 참조하세요.
VisitorAPI.js
파일이 필요합니다. Adobe Analytics을(를) 구현한 경우 이 파일이 이미 있어야 합니다. 이 파일은 Adobe Experience Platform 태그 확장을 통해 추가하거나 Adobe Analytics 코드 관리자에서 다운로드할 수도 있습니다.
VisitorAPI.js 구성 및 참조
자세한 내용은 Target용 Experience Cloud 서비스 구현을 참조하세요.
판독값
- Experience Cloud ID 서비스 개요
- ID 서비스 정보
- 쿠키 및 Experience Cloud ID 서비스
- Experience Cloud ID 서비스에서 ID를 요청하고 설정하는 방법
- ID 동기화 및 일치율 이해하기
작업
- 웹 페이지에
VisitorAPI.js
파일을 포함합니다. - 방문자 ID/API 서비스에 대해 사용 가능한 구성을(를) 읽어 보십시오.
VisitorAPI.js
파일이 로드되면 필요한 구성을 사용하여 초기화하려면Visitor.getInstance
메서드를 사용합니다.- 사용 가능한 메서드를 숙지하십시오.
1.2: 고객 ID 설정 set
이 단계는 방문자의 알려진 ID(CRM ID, 사용자 ID 등)가 장치 간 개인화를 위해 Adobe의 익명 ID에 연결되어 있는지 확인하는 데 도움이 됩니다.
{width="400" modal="regular"}
전제 조건
- 방문자의 알려진 ID는 데이터 레이어에서 사용할 수 있어야 합니다.
고객 ID 설정
자세한 내용은 setCustomerIDs을(를) 참조하십시오.
판독값
작업
visitor.setCustomerIDs
을(를) 사용하여 방문자의 알려진 ID를 설정합니다.
1.3: 자동 페이지 로드 요청 구성 automatic
이 단계를 통해 at.js는 at.js JavaScript 라이브러리 파일을 로드하는 동안 페이지에 렌더링되어야 하는 모든 경험을 가져올 수 있습니다.
{width="400" modal="regular"}
전제 조건
- 데이터 계층의 모든 데이터를 Target (으)로 보낼 필요는 없습니다. 실험, 최적화 및 개인화에 유용한 데이터를 결정하려면 비즈니스 팀(디지털 마케팅 팀)과 상의하십시오. 이 데이터만 Target (으)로 전송해야 합니다.
- PII(개인 식별 정보) 데이터를 Target (으)로 보내지 마십시오.
자동 페이지 로드 요청 구성
자세한 내용은 targetGlobalSettings()를 참조하십시오.
판독값
targetGlobalSettings()의 pageLoadEnabled
설정에 대해 알아봅니다.
작업
- 자동 페이지 로드 요청을 사용하도록 설정하려면
window.targetGlobalSettings
개체를 수정하십시오.
1.4: 플리커 처리 구성 flicker
이 단계는 경험을 전달할 때 페이지 깜박임이 없는지 확인하는 데 도움이 됩니다.
{width="400" modal="regular"}
전제 조건
- at.js에서 사용하는 기본 방법을 사용하여 플리커를 제어하는 것의 장단점에 대해 웹 페이지 성능을 담당하는 팀과 논의합니다. 로더 애니메이션과 같은 사용자 지정 플리커 처리 솔루션을 사용할 수 있는 디자인 패턴을 검색할 수 있습니다. 패턴을 찾지 못한 경우 새 패턴을 요청할 수 있습니다.
깜박임 처리 구성
자세한 내용은 targetGlobalSettings()를 참조하십시오.
bodyHidingEnabled
을(를) true
(으)로 설정하면 페이지 로드 요청이 진행되는 동안 전체 페이지 본문이 숨겨집니다. 어떤 이유로든 자동 페이지 로드 요청을 활성화하지 않은 경우(예: 나중에 데이터가 준비되지 않은 경우) 이 설정을 false
(으)로 설정하는 것이 가장 좋습니다.
APLR을 실행하지 않고 나중에 페이지 요청을 실행하려고 하기 때문에 bodyHidingEnabled
을(를) 비활성화했거나 깜박임 처리가 필요하지 않은 경우 자체 깜박임 처리를 구현해야 합니다. 깜박임을 처리할 때는 테스트 중인 섹션을 숨기거나 테스트 중인 섹션에 두통을 표시하는 두 가지 방법을 사용할 수 있습니다.
판독값
- at.js에서 플리커를 관리하는 방법
- targetGlobalSettings()의 bodyHiddenStyle 및 bodyHidingEnabled 개체에 대해 알아봅니다.
작업
window.targetGlobalSettings
개체를 수정하여bodyHiddenStyle
및bodyHidingEnabled
을(를) 설정합니다.
1.5: 데이터 매핑 구성 data-mapping
이 단계는 Target (으)로 전송해야 하는 모든 데이터가 설정되도록 하는 데 도움이 됩니다.
{width="400" modal="regular"}
전제 조건
-
데이터 레이어는 Target (으)로 전송해야 하는 모든 데이터로 준비되어야 합니다.
-
Recommendations: 프로필 보강.
entity.id
을(를) 전달하여 마지막으로 본 제품에 기반한 기준을 기반으로 최근에 본 기준 및 항목에 대한 데이터를 캡처합니다.- 즐겨찾는 범주에 따라 인기도 기준에 대한 데이터를 캡처하려면
entity.id
을(를) 전달합니다. - 사용자 지정 기준이 프로필 속성을 기반으로 하거나 임의의 기준에서 포함 규칙 필터링에 사용되는 경우 프로필 속성을 전달합니다.
-
Recommendations: 제품 데이터를 수집합니다.
- 다른 엔터티 매개 변수(예약된 매개 변수 및 사용자 지정)를 전달하여 Recommendations에서 제품 카탈로그를 수집하거나 업데이트할 수 있습니다.
- Target UI 또는 API를 사용하여 엔터티 피드를 사용하여 제품 카탈로그를 업데이트할 수도 있습니다.
데이터를Target 에 매핑
자세한 내용은 targetPageParams()을 참조하십시오.
판독값
작업
targetPageParams()
함수를 사용하여 Target (으)로 전송해야 하는 모든 필수 데이터를 설정하십시오.
1.6: 프로모션 promotion
프로모션된 항목을 추가하고 Target Recommendations 디자인에서 해당 배치를 제어합니다.
1.7: 장바구니 기반 기준 cart
사용자의 장바구니 콘텐츠를 기반으로 추천을 제공합니다.
사용 가능한 기준
- People Who Viewed These, Viewed Those
- People Who Viewed These, Bought Those
- People Who Bought These, Bought Those
필요한 엔터티 매개 변수
- cartIds
판독값
1.8: 인기도 기반 기준 popularity
사이트에서 항목의 전체 인기도를 기반으로 추천하거나 사용자가 좋아하거나 가장 많이 본 카테고리, 브랜드, 장르 등의 항목 인기도를 기반으로 추천합니다.
사용 가능한 기준
- Most Viewed Across the Site
- Most Viewed by Category
- Most Viewed by Item Attribute
- Top Sellers Across the Site
- Top Sellers by Category
- Top Sellers by Item Attribute
- Top by Analytics Metric
필요한 엔터티 매개 변수
entity.categoryId
또는 기준이 현재 항목 또는 항목 특성을 기준으로 하는 인기도 항목 특성입니다.- 사이트에서 가장 많이 본 항목/가장 많이 판매된 항목에 대해서는 아무 것도 전달하지 않아야 합니다.
판독값
1.9: 품목 기반 기준 item
사용자가 보고 있거나 최근에 본 항목과 유사한 항목을 찾은 후 권장 사항을 제공합니다.
사용 가능한 기준
- People Who Viewed This, Viewed That
- People Who Viewed This, Bought That
- People Who Bought This, Bought That
- Items with Similar Attributes
필요한 엔터티 매개 변수
entity.id
또는 키로 사용되는 모든 프로필 특성
판독값
1.10: 사용자 기반 기준 user
사용자의 행동을 기반으로 권장 사항을 제공합니다.
1.11: 사용자 지정 기준 custom
업로드하는 사용자 지정 파일을 기반으로 권장 사항을 제공합니다.
1.12: 포함 규칙에 사용되는 속성 제공 inclusion
판독값
1.13: excludedIds 제공 exclude
권장 사항에서 제외하려는 엔티티에 대한 엔티티 ID를 전달합니다. 예를 들어 장바구니에 이미 있는 항목을 제외할 수 있습니다.
1.14: entity.event.detailsOnly=true
매개 변수 전달 true
엔터티 특성을 사용하여 제품 또는 콘텐츠 정보를 Target Recommendations에 전달합니다.
판독값
1.15: 원격 데이터 매핑 구성(원격)
이 단계에서는 Target (으)로 전송해야 하는 모든 데이터가 설정되었는지 확인합니다.
{width="400" modal="regular"}
전제 조건
- 데이터 레이어는 Target에 전송해야 하는 모든 데이터로 준비되어야 합니다.
데이터 공급자 설정
자세한 내용은 데이터 공급자를 참조하세요.
판독값
작업
targetPageParams()
함수를 사용하여 Target (으)로 전송해야 하는 모든 필수 데이터를 설정하십시오.
1.16: at.js 로드 web
이 단계에서는 at.js JavaScript 라이브러리가 로드되고 초기화되도록 합니다.
{width="400" modal="regular"}
전제 조건
- 디지털 마케팅 팀에
at.js 2.*x*
JavaScript 라이브러리 파일을 다운로드하거나 요청하십시오.
판독값
작업
실험, 최적화, 개인화 및 데이터 수집이 일어나야 하는 모든 웹 페이지에 at.js 파일을 포함합니다.
2단계: 데이터 수집 구성으로 진행합니다.