Adobe Analytics 태그 확장에서 웹 SDK 태그 확장으로 마이그레이션

이 구현 경로에는 Adobe Analytics 태그 확장에서 웹 SDK 태그 확장으로 이동하는 메소드 마이그레이션 접근 방식이 포함됩니다. 다른 구현 경로는 별도의 페이지에서 다룹니다.

  • Web SDK JavaScript 라이브러리에 AppMeasurement: 태그를 사용하지 않는 경우를 제외하고 Web SDK로 마이그레이션하는 유연하고 방법적인 방법입니다. 대신 수동으로 Adobe Analytics 데이터 수집 라이브러리(AppMeasurement.js)를 제거하고 Web SDK JavaScript 라이브러리(alloy.js)로 대체합니다.
  • 웹 SDK 태그 확장: Adobe Experience Platform 데이터 수집의 태그를 사용하여 구현을 관리하는 새로운 웹 SDK 설치입니다. XDM 스키마에 포함할 일반적인 Analytics 변수를 포함하는 Adobe Analytics ExperienceEvent 필드 그룹이 필요합니다.
  • Web SDK JavaScript 라이브러리: Web SDK JavaScript 라이브러리(alloy.js)를 사용하여 새로 설치한 웹 SDK입니다. 태그 UI를 사용하는 대신 구현을 직접 관리합니다. XDM 스키마에 포함할 일반적인 Analytics 변수를 포함하는 Adobe Analytics ExperienceEvent 필드 그룹이 필요합니다.

이 구현 경로의 장단점

이러한 마이그레이션 접근 방식을 사용하면 장점과 단점이 모두 있습니다. 각 옵션을 신중히 평가하여 조직에 가장 적합한 접근 방식을 결정하십시오.

장점
단점
  • 사이트에 코드가 변경되지 않음: 구현에 이미 태그가 설치되어 있으므로 태그 인터페이스에서 모든 마이그레이션 업데이트를 수행할 수 있습니다.
  • 기존 구현을 사용: 이 방법에서는 완전히 새로운 구현이 필요하지 않습니다. 새로운 규칙 작업이 필요하지만 최소한의 변경으로 기존 데이터 요소와 규칙 조건을 재사용할 수 있습니다.
  • 스키마가 필요하지 않습니다: Web SDK로 마이그레이션하는 이 단계에서는 XDM 스키마가 필요하지 않습니다. 대신 Adobe Analytics으로 직접 데이터를 보내는 data 개체를 채울 수 있습니다. 웹 SDK로의 마이그레이션이 완료되면 조직에 대한 스키마를 만들고 데이터스트림 매핑을 사용하여 적용 가능한 XDM 필드를 채울 수 있습니다. 마이그레이션 프로세스의 이 단계에서 스키마가 필요한 경우 조직에서 Adobe Analytics XDM 스키마를 사용해야 합니다. 이 스키마를 사용하면 향후 조직에서 자체 스키마를 사용하는 것이 더 어려워집니다.
  • 구현 기술 부채: 이 방법은 기존 구현의 수정된 형식을 사용하므로 구현 논리를 추적하고 필요한 경우 변경을 수행하는 것이 더 어려울 수 있습니다. 사용자 지정 코드는 특히 디버깅하기 어려울 수 있습니다.
  • 데이터를 플랫폼에 보내려면 매핑이 필요합니다: 조직에서 Customer Journey Analytics을 사용할 준비가 되면 Adobe Experience Platform의 데이터 세트로 데이터를 보내야 합니다. 이 작업을 수행하려면 data 개체의 모든 필드가 XDM 스키마 필드에 할당하는 데이터 스트림 매핑 도구의 항목이어야 합니다. 매핑은 이 워크플로우에 대해 한 번만 수행하면 되며 구현 변경을 수반하지 않습니다. 그러나 XDM 개체에서 데이터를 전송할 때는 필요하지 않은 추가 단계입니다.

Adobe은 다음 시나리오에서 이 구현 경로를 따를 것을 권장합니다.

  • Adobe Analytics 태그 확장을 사용하는 기존 구현이 있습니다. AppMeasurement을 사용하는 구현이 있는 경우 대신 AppMeasurement에서 Web SDK로 마이그레이션을 따르십시오.
  • 나중에 Customer Journey Analytics을 사용할 계획이지만 Analytics 구현을 처음부터 웹 SDK 구현으로 바꾸지는 않을 것입니다. 웹 SDK에서 구현을 처음부터 교체하려면 가장 많은 노력이 필요하지만 가장 실행 가능한 장기 구현 아키텍처도 제공합니다. 조직에서 깔끔한 웹 SDK 구현을 수행하려는 경우 Customer Journey Analytics 사용 안내서에서 Adobe Experience Platform Web SDK를 통해 데이터 수집을 참조하십시오.

웹 SDK로 마이그레이션하는 데 필요한 단계

다음 단계에는 구체적인 작업 목표가 포함되어 있습니다. 각 단계를 클릭하여 수행 방법에 대한 자세한 지침을 확인하십시오.

1. 데이터 스트림 만들기 및 구성

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

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

Adobe Analytics 서비스 추가

이제 데이터 스트림이 데이터를 받아서 Adobe Analytics에 전달할 준비가 되었습니다.

2. Web SDK 확장을 태그 속성에 추가

이 섹션에서는 다음 단계에서 수행되는 대량의 마이그레이션 작업에 대해 태그를 준비합니다.

  1. Adobe Experience Platform 인터페이스 왼쪽 상단의 햄버거 아이콘을 클릭한 다음 태그 ​를 선택합니다.

  2. 원하는 태그 속성을 선택합니다.

  3. 태그 속성의 왼쪽 탐색에서 확장 ​을 선택합니다.

  4. 사용 가능한 모든 확장 목록을 보려면 맨 위의 카탈로그 ​를 선택하십시오.

  5. Adobe Experience Platform Web SDK 확장을 검색하여 선택한 다음 오른쪽의 설치 ​를 클릭합니다.

    카탈로그

  6. 확장 구성 설정이 나타납니다. [데이터스트림] 섹션을 찾아 이전 단계에서 생성한 데이터스트림을 선택합니다.

    데이터 스트림 선택

  7. 저장 ​을 선택합니다.

이제 태그 속성에 웹 SDK가 설치됩니다.

3. 데이터 개체 데이터 요소 만들기

데이터 개체 데이터 요소는 Web SDK가 데이터 스트림으로 전송하는 데 사용하는 페이로드를 구성하는 직관적인 프레임워크를 제공합니다. 다음 단계에서 업데이트하는 대부분의 규칙은 이 데이터 요소와 상호 작용합니다.

  1. 태그 인터페이스의 왼쪽 탐색에서 데이터 요소 ​를 선택합니다.

  2. 데이터 요소 추가 선택

  3. 데이터 요소에 다음 설정을 지정합니다.

    • 이름: "데이터 레이어" 또는 "데이터 개체"와 같이 원하는 모든 항목
    • 확장: Adobe Experience Platform Web SDK
    • 데이터 요소 형식: 변수
    • 확인란은 그대로 남아 있을 수 있습니다
  4. 오른쪽에서 다음 설정을 선택합니다.

    • 속성 라디오 단추: 데이터
    • 해결 방법: Adobe Analytics
  5. 저장 ​을 선택합니다.

데이터 요소 만들기

이제 태그 속성에 각 규칙을 업데이트하는 데 필요한 모든 것이 있습니다.

4. Analytics 확장 대신 웹 SDK 확장을 사용하도록 규칙을 업데이트합니다.

이 단계에는 Web SDK로 마이그레이션하는 데 필요한 많은 작업이 포함되어 있으며 구현 작동 방식에 대한 지식이 필요합니다. 다음은 일반적인 태그 규칙을 편집하는 방법의 예입니다. 구현의 모든 태그 규칙을 업데이트하여 Adobe Analytics 확장에 대한 모든 참조를 웹 SDK 확장으로 바꿉니다.

  1. 태그 인터페이스의 왼쪽 탐색에서 규칙 ​을 선택합니다.

  2. 편집할 규칙을 선택합니다.

  3. Adobe Analytics - 변수 설정 작업 선택

  4. 이 규칙 내에 설정된 모든 Analytics 변수를 확인합니다. 드롭다운 메뉴에 설정된 변수와 사용자 지정 코드 내에 설정된 변수를 모두 포함합니다.

  5. 작업 구성을(를) 다음 설정으로 변경합니다.

    • 확장: Adobe Experience Platform Web SDK
    • 작업 유형: 변수 업데이트
  6. 오른쪽 드롭다운에서 데이터 개체가 선택되었는지 확인합니다.

  7. Analytics 변수를 Analytics 확장에서 구성된 것과 동일한 해당 값으로 설정합니다.

    • 태그 인터페이스 내에 설정된 변수는 동일한 값으로 직접 변환할 수 있습니다.
    • 사용자 지정 코드 내에 설정된 문자열 변수는 최소한의 조정이 필요합니다. s 개체를 사용하지 않고 data.__adobe.analytics을(를) 사용합니다. 예를 들어 s.eVar1은(는) data.__adobe.analytics.eVar1(으)로 변환됩니다.
    • 사용자 지정 코드의 Analytics 구성 변수 및 메서드 호출에는 수정된 구현 논리가 필요할 수 있습니다. 각 변수을(를) 참조하여 Web SDK를 사용하여 이와 동등한 기능을 달성하는 방법을 결정하십시오.
  8. Web SDK 확장을 사용하여 모든 규칙 논리가 복제되면 변경 내용 유지 ​를 선택합니다.

  9. Adobe Analytics 확장을 사용하여 값을 설정하는 모든 작업 구성에 대해 이 단계를 반복합니다. 이 단계에는 태그 인터페이스를 사용하여 설정된 변수와 사용자 지정 코드를 사용하여 설정된 변수가 모두 포함됩니다. 사용자 지정 코드 블록은 어디에서나 s 개체를 참조할 수 없습니다.

위의 단계는 값을 설정하는 규칙에만 적용됩니다. 다음 단계는 작업 구성 비콘 보내기를 사용하는 모든 작업을 대체합니다.

  1. 비콘을 보내는 규칙을 선택합니다.

  2. Adobe Analytics - 비콘 보내기 작업을 선택합니다.

  3. 오른쪽에 있는 Tracking 라디오 단추의 현재 값(s.t() 또는 s.tl())을 참고하십시오.

  4. 작업 구성을(를) 다음 설정으로 변경합니다.

    • 확장: Adobe Experience Platform Web SDK
    • 작업 유형: 이벤트 보내기
  5. 오른쪽에서 작업 설정을 다음과 같이 변경합니다.

    • 유형: s.t()의 경우 웹 Webpagedetails 페이지 보기 ​를 사용하십시오. s.tl()의 경우 웹 웹 인터랙션 링크 클릭 수 ​를 사용하십시오. s.tl()을(를) 사용하는 경우 데이터 개체에 다음 필드도 포함해야 합니다. 이러한 필드는 변수 업데이트 작업 구성을 수행할 때 추가 속성 아래에 나열됩니다.

  6. 변경사항 유지 ​를 선택합니다.

  7. Adobe Analytics을 사용하여 비콘을 전송하는 모든 작업 구성에 대해 이 단계를 반복합니다.

5. Publish에서 규칙을 업데이트했습니다

업데이트된 규칙을 게시하는 것은 태그 구성에 대한 다른 변경 사항과 동일한 워크플로우를 따릅니다.

  1. 태그 인터페이스의 왼쪽 탐색에서 게시 흐름 ​을 선택합니다.
  2. 라이브러리 추가 ​를 선택합니다.
  3. 이 태그 커밋에 "Web SDK로 업그레이드"와 같은 이름을 지정합니다.
  4. 변경된 모든 리소스 추가 ​를 선택합니다.
  5. 저장 ​을 선택합니다.
  6. 게시 작업 과정에는 작성 중임을 나타내는 주황색 점이 표시됩니다. 점이 녹색으로 바뀌면 개발 환경에서 변경 사항을 사용할 수 있습니다.
  7. 개발 환경에서 변경 사항을 테스트하여 모든 규칙이 올바르게 실행되는지, 그리고 데이터 개체가 예상 값으로 채워지는지 확인합니다.
  8. 준비가 되면 승인을 위해 라이브러리를 제출하고 스테이징으로 빌드한 다음 최종적으로 승인하고 프로덕션에 게시합니다.

게시 흐름

6. Analytics 확장 사용 안 함

태그 구현이 웹 SDK에서 완전히 실행되면 Adobe Analytics 확장을 비활성화할 수 있습니다.

  1. 태그 인터페이스의 왼쪽 탐색에서 확장 ​을 선택합니다.
  2. Adobe Analytics 확장을 찾아 선택합니다. 오른쪽에서 사용 안 함 ​을 선택합니다.
  3. 위의 동일한 게시 작업 과정을 따라 Adobe Analytics 확장 제거를 게시하십시오.
  4. 프로덕션에서 확장이 비활성화되면 완전히 제거할 수 있습니다. 확장을 선택하고 오른쪽에 있는 점 3개 메뉴를 선택한 다음 제거 ​를 선택합니다.
  5. 위의 동일한 게시 작업 과정을 따라 이러한 변경 사항을 프로덕션에 게시하십시오.

이 시점에서 Analytics 구현은 완전히 웹 SDK에 있으며 향후 Customer Journey Analytics으로 이동할 준비가 되어 있습니다.

recommendation-more-help
b4f6d761-4a8b-4322-b801-c85b9e3be690