SDK 초기화

SDK 초기화 다이어그램의 단계에 따라 Adobe Target at.js JavaScript 라이브러리를 로드하는 데 필요한 모든 작업이 올바른 순서로 실행되도록 하십시오.

TIP
전체 화면으로 확장하려면 이 항목의 이미지를 클릭하십시오.

SDK 다이어그램 초기화 diagram

다중 페이지 애플리케이션의 경우, 이 흐름은 페이지를 다시 로드하거나 방문자가 웹 사이트의 새 페이지로 이동할 때마다 발생합니다.

NOTE
다음 그림에서 단계 번호는 아래 섹션에 해당합니다. 단계 번호는 특정 순서가 아니며 활동을 만드는 동안 Target UI에서 수행한 단계 순서를 반영하지 않습니다.

SDK 다이어그램 초기화 {width="600" modal="regular"}

다음 링크를 클릭하여 원하는 섹션으로 이동합니다.

1.1: 방문자 API SDK 로드 load

이 단계는 VisitorAPI.js 라이브러리가 올바르게 로드, 구성 및 초기화되도록 하는 데 도움이 됩니다.

세부 정보 보기

방문자 API SDK 다이어그램 로드 {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 서비스 구현을 참조하세요.

판독값

작업

  • 웹 페이지에 VisitorAPI.js 파일을 포함합니다.
  • 방문자 ID/API 서비스에 대해 사용 가능한 구성을(를) 읽어 보십시오.
  • VisitorAPI.js 파일이 로드되면 필요한 구성을 사용하여 초기화하려면 Visitor.getInstance 메서드를 사용합니다.
  • 사용 가능한 메서드를 숙지하십시오.

이 페이지 상단의 다이어그램으로 돌아갑니다.

1.2: 고객 ID 설정 set

이 단계는 방문자의 알려진 ID(CRM ID, 사용자 ID 등)가 장치 간 개인화를 위해 Adobe의 익명 ID에 연결되어 있는지 확인하는 데 도움이 됩니다.

세부 정보 보기

고객 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을(를) 비활성화했거나 깜박임 처리가 필요하지 않은 경우 자체 깜박임 처리를 구현해야 합니다. 깜박임을 처리할 때는 테스트 중인 섹션을 숨기거나 테스트 중인 섹션에 두통을 표시하는 두 가지 방법을 사용할 수 있습니다.

판독값

작업

  • window.targetGlobalSettings 개체를 수정하여 bodyHiddenStylebodyHidingEnabled을(를) 설정합니다.

이 페이지 상단의 다이어그램으로 돌아갑니다.

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

사용자의 행동을 기반으로 권장 사항을 제공합니다.

세부 정보 보기

사용 가능한 기준

  • Recently Viewed Items
  • Recommended for You

필요한 엔터티 매개 변수

  • entity.id

판독값

이 페이지 상단의 다이어그램으로 돌아갑니다.

1.11: 사용자 지정 기준 custom

업로드하는 사용자 지정 파일을 기반으로 권장 사항을 제공합니다.

세부 정보 보기

사용 가능한 기준

  • Custom algorithm

필요한 엔터티 매개 변수

entity.id 또는 사용자 지정 알고리즘의 키로 사용되는 특성

판독값

이 페이지 상단의 다이어그램으로 돌아갑니다.

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 함수

작업

targetPageParams() 함수를 사용하여 Target (으)로 전송해야 하는 모든 필수 데이터를 설정하십시오.

이 페이지 상단의 다이어그램으로 돌아갑니다.

1.16: at.js 로드 web

이 단계에서는 at.js JavaScript 라이브러리가 로드되고 초기화되도록 합니다.

세부 정보 보기

Adobe Target at.js 다이어그램 로드 {width="400" modal="regular"}

전제 조건

  • 디지털 마케팅 팀에 at.js 2.*x* JavaScript 라이브러리 파일을 다운로드하거나 요청하십시오.

판독값

작업

실험, 최적화, 개인화 및 데이터 수집이 일어나야 하는 모든 웹 페이지에 at.js 파일을 포함합니다.

이 페이지 상단의 다이어그램으로 돌아갑니다.

2단계: 데이터 수집 구성으로 진행합니다.

recommendation-more-help
6906415f-169c-422b-89d3-7118e147c4e3