AppMeasurement에서 웹 SDK으로 마이그레이션

Adobe Experience Platform 데이터 수집에서 데이터 스트림을 만듭니다. 이 데이터 스트림으로 데이터를 전송하면 데이터가 Adobe Analytics으로 전달됩니다. 향후에 이와 동일한 데이터스트림이 데이터를 Customer Journey Analytics에 전달합니다.

1. experience.adobe.com​(으)로 이동한 다음 자격 증명을 사용하여 로그인합니다.
2. 오른쪽 상단의 홈 페이지 또는 제품 선택기를 사용하여 데이터 수집(으)로 이동합니다.
3. 왼쪽 탐색에서 데이터스트림 ​을 선택합니다.
4. 새 데이터스트림 ​을 선택합니다.
5. 원하는 이름을 입력한 다음 저장 ​을 선택합니다.
6. 데이터 스트림이 만들어지면 서비스 추가 ​를 선택하십시오.
7. 서비스 드롭다운 메뉴에서 Adobe Analytics ​을(를) 선택합니다.
8. 현재 분석 데이터를 보내는 사이트와 동일한 보고서 세트 ID를 입력합니다. 저장 ​을 클릭합니다.

이제 데이터 스트림이 데이터를 받아서 Adobe Analytics에 전달할 준비가 되었습니다. 코드에서 웹 SDK을 구성할 때 이 ID가 필요하므로 데이터 스트림 ID를 참고하십시오.

웹 SDK configure 명령을 사용하여 이전 단계에서 만든 데이터 스트림을 가리키도록 구현을 설정하십시오. 라이브러리 설치 코드와 함께 configure 명령을 포함할 수 있도록 모든 페이지에서 명령을 설정해야 합니다.

웹 SDK datastreamId 명령 내에서 ​ orgId 및 ​configure 속성을 사용합니다.

• datastreamId을(를) 이전 단계에서 검색한 데이터 스트림 ID로 설정합니다.
• orgId을(를) 조직의 IMS 조직으로 설정합니다.

alloy("configure", {
    datastreamId: "ebebf826-a01f-4458-8cec-ef61de241c93",
    orgId: "ADB3LETTERSANDNUMBERS@AdobeOrg"
});

조직의 구현 요구 사항에 따라 configure 명령에서 다른 속성을 선택적으로 설정할 수 있습니다.

AppMeasurement.js 또는 s 개체에 의존하지 않도록 Analytics 구현을 변경하십시오. 대신 변수를 올바른 형식의 JavaScript 개체에 설정합니다. 이 개체는 Adobe에 전송될 때 JSON 개체로 변환됩니다. 사이트에 데이터 레이어가 있으면 동일한 값을 계속 참조할 수 있으므로 값을 설정할 때 많은 도움이 됩니다.

Adobe Analytics으로 데이터를 보내려면 웹 SDK 페이로드에서 data.__adobe.analytics을(를) 이 개체 내에 설정된 모든 분석 변수와 함께 사용해야 합니다. 이 개체 내의 변수는 AppMeasurement 변수 상대가 공유하는 것과 동일한 이름과 형식을 공유합니다. 예를 들어 products 변수를 설정하는 경우 XDM을 사용하는 것처럼 개별 개체로 분할하지 마십시오. 대신 s.products 변수를 설정하는 경우 문자열로 포함하십시오.

{
  "data": {
    "__adobe": {
      "analytics": {
        "products": "Shoes,Men's sneakers,1,49.99"
      }
    }
  }
}

궁극적으로 이 페이로드에는 원하는 값이 모두 포함되어 있으며 구현의 s 개체에 대한 모든 참조가 제거됩니다. 개별 값을 설정하는 점 표기법을 포함하여 JavaScript에서 제공하는 모든 리소스를 사용하여 이 페이로드 개체를 설정할 수 있습니다.

// Define the payload and set objects within it
var dataObj = {data: {__adobe: {analytics: {}}}};
dataObj.data.__adobe.analytics.pageName = window.document.title;
dataObj.data.__adobe.analytics.eVar1 = "Example value";

// Alternatively, set values in an object and use a spread operator to achieve identical results
var a = new Object;
a.pageName = window.document.title;
a.eVar1 = "Example value";
var dataObj = {data:{__adobe:{analytics:{...a}}}};

s.t() 및 s.tl()을(를) 호출하는 모든 인스턴스를 업데이트하여 sendEvent 명령으로 바꿉니다. 고려해야 할 세 가지 시나리오가 있습니다.

• 페이지 보기 추적: 페이지 보기 추적 호출을 웹 SDK sendEvent 명령으로 바꿉니다.

  code language-js
  // If your current implementation has this line of code: s.t(); // Replace it with this line of code. The dataObj object contains the variables to send. alloy("sendEvent", dataObj);

• 자동 링크 추적: clickCollectionEnabled 구성 속성이 기본적으로 활성화되어 있습니다. 데이터를 Adobe Analytics으로 전송할 올바른 링크 추적 변수를 자동으로 설정합니다. 자동 링크 추적을 사용하지 않도록 설정하려면 falseconfigure 명령 내에서 이 속성을 ​​(으)로 설정하십시오.

• 수동 링크 추적: 웹 SDK에는 pageview와 pageview가 아닌 호출 사이에 별도의 명령이 없습니다. 페이로드 객체 내에 해당 구분을 제공합니다.

  code language-js
  // If your current implementation has this line of code: s.tl(true,"o","Example custom link"); // Replace it with these lines of code. Add the required fields to the dataObj object. dataObj.data.__adobe.analytics.linkName = "Example custom link"; dataObj.data.__adobe.analytics.linkType = "o"; dataObj.data.__adobe.analytics.linkURL = "https://example.com"; alloy("sendEvent", dataObj);

AppMeasurement 및 s 개체에 대한 모든 참조를 제거했으면 변경 내용을 개발 환경에 게시하여 새 구현이 작동하는지 확인하십시오. 모든 것이 올바르게 작동하는지 확인했으면 프로덕션에 업데이트를 게시할 수 있습니다.

올바르게 마이그레이션되면 사이트에 AppMeasurement.js이(가) 더 이상 필요하지 않으며 이 스크립트에 대한 모든 참조를 제거할 수 있습니다.