Show Menu
화제×

Analytics for Target 구현

Several steps are required when implementing Adobe Analytics as the reporting source for Target (A4T).

Implementation steps

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

1단계: Analytics 및 Target 제공 요청

After you implement Analytics as the reporting source for Target, you must be provisioned for Analytics and Target. 이 양식을 사용하여 제공을 요청합니다 .

2단계: 사용자 권한 설정

User account requirements must be met before you can create an Analytics-based activity in Target. See User permission requirements .

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

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

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 파일을 업데이트하는 경우 로드 순서를 확인해야 합니다.
The way the out-of-the-box settings are configured for Target and Analytics integration from an implementation perspective is to use the SDID that is passed from the page to stitch the Target and Analytics request together on the backend automatically for you.
However, if you want more control on how and when to send analytics data related to Target to Analytics for reporting purposes, and you do not want to opt-in to the default settings of having Target and Analytics automatically stitch the analytics data via the SDID, then you can set analyticsLogging = client_side via window.targetGlobalSettings . 참고: 2.1 이하의 버전은 이 방법을 지원하지 않습니다.
예:
window.targetGlobalSettings = {
  analyticsLogging: "client_side"
};

이 설정에는 전역 효과가 있습니다. 즉, at.js에 의한 모든 호출에는 요청 내에 전송된 analyticsLogging: "client_side" ​가 있으며 모든 요청마다 Analytics 페이로드가 반환됩니다. Target 이 기능이 설정되면 반환되는 페이로드의 형식은 다음과 같이 나타납니다.
"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" ​를 전달하여 이를 수행할 수 있습니다. The analytics payload will be returned for only this call and the Target backend will not forward the payload to Analytics. By pursuing this approach, every at.js Target request will not return the payload by default, but instead only when desired and specified.
예:
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 라이브러리를 업데이트한 후 페이지를 로드하여 호출의 mboxMCSDID Target 매개 변수 값이 page-view 호출의 sdid Analytics 매개 변수 값과 일치하는지 확인하십시오.
이 검사는 호출 순서가 항상 예측 가능하지는 않은 단일 페이지 애플리케이션(SPA)에서 확인하는 데 특히 중요합니다.
참고: A4T가 올바로 작동하려면 이 값이 일치해야 합니다.

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

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

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

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