Show Menu
화제×

Analytics for Target 구현

Adobe Analytics를 Target(A4T)의 보고 소스로 구현할 때 몇 가지 단계가 필요합니다.

구현 절차

다음 표에서는 이 통합을 사이트에 배포하는 데 필요한 단계에 대해 설명합니다.

1단계: Analytics 및 Target 제공 요청

Analytics를 Target의 보고 소스로 구현한 후에는 Analytics 및 Target 제공을 요청해야 합니다. 이 양식을 사용하여 제공을 요청합니다 .

2단계: 사용자 권한 설정

Adobe Target에서 Adobe Analytics 기반 활동을 만들려면 사용자 계정 요구 사항을 충족해야 합니다. 자세한 내용은 사용자 권한 요구 사항 을 참조하십시오.

3단계: Experience Cloud 방문자 ID 서비스 구현

방문자 ID 서비스를 통해 Experience Cloud 솔루션에서 사용자를 식별할 수 있습니다. 필요한 Experience Cloud 방문자 ID 버전을 구현하거나 이 버전으로 마이그레이션해야 합니다. 자세한 내용은 구현하기 전에 의 "구현 요구 사항"을 참조하십시오.
Experience Cloud 방문자 ID 서비스 설명서의 Target용 Experience Cloud ID 서비스 구현 을 참조하십시오.

4단계: AppMeasurement for JavaScript 또는 s_code의 AppMeasurement 업데이트

필요한 appMeasurement.js 버전을 구현하거나 이 버전으로 마이그레이션해야 합니다. 자세한 내용은 구현하기 전에 의 "구현 요구 사항"을 참조하십시오.
새 구현에 대해서는 Analytics 구현 안내서의 JavaScript 구현 개요를 참조하십시오 .
마이그레이션에 대해서는 Analytics 구현 안내서의 JavaScript용 AppMeasurement 마이그레이션을 참조하십시오 .

5단계: at.js 또는 mbox.js 다운로드하여 업데이트

프로덕션 계정을 사용하여 필요한 at.js 또는 mbox.js 버전을 구현하거나 이 버전으로 마이그레이션해야 합니다. 이 코드를 수정할 필요가 없습니다.
자세한 내용은 구현하기 전에 의 "구현 요구 사항"을 참조하십시오.

6단계: at.js 또는 mbox.js 호스팅

이전에 at.js나 mbox.js를 배포한 경우에는 기존 파일을 업데이트된 버전으로 대체할 수 있습니다. 자세한 내용은 구현하기 전에 의 "구현 요구 사항"을 참조하십시오.
그렇지 않으면, JavaScript 파일용 AppMeasurement 및 방문자 ID 서비스와 함께 이 파일을 호스트할 수 있습니다. 이러한 파일은 사이트의 모든 페이지에서 액세스할 수 있는 웹 서버에 호스트되어야 합니다. 다음 단계에서 이 파일에 대한 경로가 필요합니다.

7단계: 모든 사이트 페이지에서 at.js 또는 mbox.js 참조

각 페이지의 태그에 다음 코드 행을 추가하여 VisitorAPI.js 아래에 at.js 또는 mbox.js를 포함합니다.
at.js의 경우:
<script language="JavaScript" type="text/javascript"
src="http://INSERT-DOMAIN-AND-PATH-TO-CODE-HERE/at.js"></script>

mbox.js의 경우:
<script language="JavaScript" type="text/javascript"
src="http://INSERT-DOMAIN-AND-PATH-TO-CODE-HERE/mbox.js"></script>

VisitorAPI.js가 at.js 또는 mbox.js보다 먼저 로드되어야 합니다. 기존 at.js 또는 mbox.js 파일을 업데이트하는 경우 로드 순서를 확인해야 합니다.
구현 관점에서 Target 및 Analytics 통합에 대한 기본 설정이 구성되는 방법은 페이지에서 전달되는 SDID를 사용하여 자동으로 백엔드에서 Target과 Analytics 요청을 함께 연결하는 것입니다.
하지만 보고 목적을 위해 Target과 관련된 Analytics 데이터를 언제, 어떻게 Analytics로 보낼 것이지에 대해 자세히 제어하고, Target 및 Analytics에서 SDID를 통해 Analytics 데이터를 자동으로 연결하게 하는 기본 설정으로 옵트인하지 않으려는 경우 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로 전달할 수 있습니다 .
글로벌 설정을 원하지 않고 더 많은 요구 방식이 필요한 경우 at.js 함수 getOffers() 를 사용하면 analyticsLogging: "client_side" ​를 전달하여 이를 수행할 수 있습니다. 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단계: 구현의 유효성 검사

JavaScript 라이브러리를 업데이트한 후 페이지를 로드하여 Target 호출의 mboxMCSDID 매개 변수 값이 Analytics page-view 호출의 sdid 매개 변수 값과 일치하는지 확인하십시오.
이 검사는 호출 순서가 항상 예측 가능하지는 않은 단일 페이지 애플리케이션(SPA)에서 확인하는 데 특히 중요합니다.
참고: A4T가 올바로 작동하려면 이 값이 일치해야 합니다.

9단계: (선택 사항) 이전 통합 코드 제거

구현을 간소화하고 시스템 간의 불일치를 처리할 필요가 없도록 이전 통합을 제거하는 것이 좋습니다. mboxLoadSCPlugin 을 비롯하여 이전 SC에 배포한 모든 코드를 T&T 통합으로 이동할 수 있습니다.

10단계: Analytics를 Target의 보고 소스로 사용하기 위한 선택 사항 활성화

Target에서 설정 &gt; 환경 설정을 클릭하고 활동당 선택 또는 Adobe Analytics를 선택하여 선택 사항을 활성화합니다.
  • 활동당 선택옵션을 사용하면 각 활동을 만들 때 Target과 Analytics 중에서 선택할 수 있습니다.
  • Adobe Analytics에서는 만들어지는 모든 활동에 대해 Analytics를 보고 소스로 설정합니다.