Target 구현에 대한 분석
Adobe Analytics을(를) Adobe Target의 보고 소스로 구현(A4T)할 때는 몇 가지 단계가 필요합니다. 프로세스는 Adobe Experience Platform Web SDK 또는 at.js로 A4T를 구현하는지 여부에 따라 다릅니다.
Adobe Experience Platform Web SDK 구현을 위한 구현 단계 platform
다음 섹션에서는 Platform Web SDK를 사용하려는 경우 이 통합을 사이트에 배포하는 데 필요한 단계에 대해 설명합니다.
1단계: Analytics 및 Target에 대한 프로비전 요청
A4T를 구현하기 전에 Analytics 및 Target을(를) 프로비저닝해야 합니다. 이 양식을 사용하여 제공을 요청하세요.
2단계: 사용자 권한 설정
Target의 Analytics을(를) 기반으로 활동을 만들려면 먼저 사용자 계정 요구 사항을 충족해야 합니다. 사용자 권한 요구 사항을 참조하세요.
3단계: Edge 구성 만들기
Edge 구성 도구를 사용하여 Adobe Experience Platform을(를) 사용하여 Edge 구성을 만듭니다. 데이터스트림 만들기 및 구성을 구성합니다.
4단계: Platform Web SDK 설치 및 구성
Target 경험 전달을 시작하고 추적 및 분석 목적으로 Analytics을(를) 적용하려면 사이트 페이지에서 Platform Web SDK를 설치하고 구성하십시오.
5단계: A4T 사용에 대한 옵션 활성화
Target UI에서 Administration > Visual Experience Composer 을(를) 클릭한 다음 Select per activity 또는 Adobe Analytics 을(를) 선택합니다.
- Select per activity 을(를) 사용하면 각 활동을 만들 때 Target에서 Analytics 중 하나를 선택할 수 있습니다.
- Adobe Analytics 은(는) 사용자가 만드는 모든 활동에 대해 Analytics을(를) 보고 소스로 설정합니다.
at.js 구현에 대한 구현 단계 section_73961BAD5BB4430A95E073DE5C026277
다음 섹션에서는 at.js를 사용하려는 경우 이 통합을 사이트에 배포하는 데 필요한 단계에 대해 설명합니다.
1단계: Analytics 및 Target 제공 요청
Analytics을(를) Target의 보고 소스로 구현한 후에는 Analytics 및 Target을(를) 프로비저닝해야 합니다. 이 양식을 사용하여 제공을 요청하세요.
2단계: 사용자 권한 설정
Target에서 Analytics 기반 활동을 만들려면 먼저 사용자 계정 요구 사항을 충족해야 합니다. 사용자 권한 요구 사항을 참조하세요.
3단계: Experience Cloud 방문자 ID 서비스 구현
방문자 ID 서비스를 사용하면 Adobe Experience Cloud 솔루션에서 사용자를 식별할 수 있습니다. 필요한 Experience Cloud 방문자 ID 버전을 구현하거나 이 버전으로 마이그레이션합니다. 자세한 내용은 구현하기 전에의 "구현 요구 사항"을 참조하십시오.
Experience Cloud ID 서비스 설명서의 Target용 Experience Cloud ID 서비스 구현을 참조하십시오.
4단계: AppMeasurement for JavaScript 또는 s_code의 AppMeasurement 업데이트
필요한 appMeasurement.js 버전을 구현하거나 이 버전으로 마이그레이션합니다. 자세한 내용은 구현하기 전에의 "구현 요구 사항"을 참조하십시오.
새로운 구현의 경우 Analytics 구현 안내서 에서 JavaScript 구현 개요를 참조하십시오.
마이그레이션은 Analytics AppMeasurement 가이드 에서 JavaScript 구현으로 마이그레이션을 참조하십시오.
5단계: at.js 다운로드 및 업데이트
프로덕션 계정을 사용하여 필요한 at.js 버전을 구현하거나 이 버전으로 마이그레이션합니다. 이 코드를 수정할 필요가 없습니다.
자세한 내용은 구현하기 전에의 "구현 요구 사항"을 참조하십시오.
6단계: at.js 호스팅
이전에 at.js를 배포한 경우에는 기존 파일을 업데이트된 버전으로 바꿀 수 있습니다. 자세한 내용은 구현하기 전에의 "구현 요구 사항"을 참조하십시오.
그렇지 않으면, JavaScript 파일용 AppMeasurement 및 방문자 ID 서비스와 함께 이 파일을 호스트할 수 있습니다. 이러한 파일은 사이트의 모든 페이지에서 액세스할 수 있는 웹 서버에 호스트되어야 합니다. 다음 단계에서 이 파일에 대한 경로가 필요합니다.
7단계: 모든 사이트 페이지에서 at.js 참조 step7
각 페이지의 태그에 다음 코드 행을 추가하여 VisitorAPI.js 아래에 at.js를 포함합니다.
at.js의 경우:
<script language="JavaScript" type="text/javascript"
src="http://INSERT-DOMAIN-AND-PATH-TO-CODE-HERE/at.js"></script>
VisitorAPI.js는 at.js 앞에 로드되어야 합니다. 기존 at.js 파일을 업데이트하는 경우 로드 순서를 확인해야 합니다.
구현 관점에서 Target 및 Analytics 통합에 대한 기본 설정은 페이지에서 전달되는 SDID를 사용하여 백엔드에서 Target 및 Analytics 요청을 자동으로 연결하는 것입니다.
보고 목적으로 Target과(와) 관련된 분석 데이터를 Analytics에 보내는 방법과 시기를 제어할 수 있습니다. Target 및 Analytics이(가) SDID를 통해 분석 데이터를 자동으로 연결하는 기본 설정으로 옵트인하지 않으려면 window.targetGlobalSettings 를 통해 analyticsLogging = client_side 을(를) 설정하십시오. 참고: 2.1 이하의 버전은 이 방법을 지원하지 않습니다.
예:
window.targetGlobalSettings = {
analyticsLogging: "client_side"
};
이 설정에는 전역 효과가 있습니다. 즉, at.js에 의한 모든 호출에는 Target 요청 내에 전송된 analyticsLogging: "client_side" 가 있으며 모든 요청에 대해 Analytics 페이로드가 반환됩니다. 이 옵션이 설정되면 반환되는 페이로드의 형식은 다음과 같습니다.
"analytics": {
"payload": {
"pe": "tnt",
"tnta": "167169:0:0|0|100,167169:0:0|2|100,167169:0:0|1|100"
}
}
그런 다음 데이터 삽입 API를 통해 페이로드를 Analytics에 전달할 수 있습니다. 자동 할당 및 자동 타겟 활동의 경우 sessionId도 전달해야 합니다. 자세한 내용은 Adobe Target SDK 안내서에서 Analytics for Target(A4T) 보고를 참조하십시오.
글로벌 설정을 원하지 않고 더 많은 요구 방식이 필요한 경우 analyticsLogging: "client_side" 를 전달하여 at.js 함수 getOffers()을(를) 사용하십시오. 이 호출에 대해서만 Analytics 페이로드가 반환되고 Target 백엔드는 페이로드를 Analytics에 전달하지 않습니다. 이 방법을 사용하면 모든 at.js Target 요청은 기본적으로 페이로드를 반환하지만, 대신 원하는 경우에만 페이로드를 반환합니다.
예:
adobe.target.getOffers({
request: {
experienceCloud: {
analytics: {
logging: "client_side"
}
},
prefetch: {
mboxes: [{
index: 0,
name: "a1-serverside-xt"
}]
}
}
})
.then(console.log)
이 호출은 Analytics 페이로드를 추출할 수 있는 응답을 호출합니다.
응답은 다음과 같습니다.
{
"prefetch": {
"mboxes": [{
"index": 0,
"name": "a1-serverside-xt",
"options": [{
"content": "<img src=\"http://s7d2.scene7.com/is/image/TargetAdobeTargetMobile/L4242-xt-usa?tm=1490025518668&fit=constrain&hei=491&wid=980&fmt=png-alpha\"/>",
"type": "html",
"eventToken": "n/K05qdH0MxsiyH4gX05/2qipfsIHvVzTQxHolz2IpSCnQ9Y9OaLL2gsdrWQTvE54PwSz67rmXWmSnkXpSSS2Q==",
"responseTokens": {
"profile.memberlevel": "0",
"geo.city": "bucharest",
"activity.id": "167169",
"experience.name": "USA Experience",
"geo.country": "romania"
}
}],
"analytics": {
"payload": {
"pe": "tnt",
"tnta": "167169:0:0|0|100,167169:0:0|2|100,167169:0:0|1|100"
}
}
}]
}
}
데이터 삽입 API를 통해 페이로드를 Analytics에 전달할 수 있습니다.
8단계: 구현의 유효성 검사 step8
JavaScript 라이브러리를 업데이트한 후 페이지를 로드하여 Target 호출의 mboxMCSDID
매개 변수 값이 Analytics 페이지 보기 호출의 sdid
매개 변수 값과 일치하는지 확인하십시오.
이러한 값이 호출 순서가 항상 예측 가능하지 않은 SPA(단일 페이지 애플리케이션)에서 일치하는지 확인하는 것이 특히 중요합니다.
9단계: (선택 사항) 이전 통합 코드 제거
Adobe은 구현을 단순화하고 시스템 간의 불일치를 처리할 필요가 없도록 이전 통합을 제거할 것을 권장합니다. mboxLoadSCPlugin
을(를) 포함하여 이전 SC에 배포한 모든 코드를 T&T 통합으로 제거할 수 있습니다.
10단계: Analytics를 Target의 보고 소스로 사용하기 위한 선택 사항 활성화
Target에서 Administration > Reporting 을(를) 클릭하고 Select per activity 또는 Adobe Analytics 을(를) 선택하여 옵션을 사용하도록 설정합니다.
- Select per activity 을(를) 사용하면 각 활동을 만들 때 Target에서 Analytics 중 하나를 선택할 수 있습니다.
- Adobe Analytics 은(는) 사용자가 만드는 모든 활동에 대해 Analytics을(를) 보고 소스로 설정합니다.