Audience Manager 태그 확장 기능에서 웹 SDK 태그 확장 기능으로 Audience Manager용 데이터 수집 라이브러리 업데이트

의도한 대상

이 페이지는 Audience Manager 태그 확장을 사용하여 웹 컬렉션 데이터를 Audience Manager으로 가져오는 Audience Manager 고객을 위한 것입니다. AppMeasurement JavaScript Audience Manager 라이브러리를 사용하는 고객의 경우 AppMeasurement JavaScript 라이브러리에서 웹 SDK JavaScript 라이브러리로 의 데이터 수집 라이브러리를 업데이트하는 방법에 대한 안내서를 참조하십시오.

이 구현 경로의 장단점

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

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

Adobe Adobe Audience Manager 태그 확장을 사용하는 기존 구현이 있는 경우 이 구현 경로를 따르는 것이 좋습니다.

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

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

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

Adobe Experience Platform 데이터 수집에서 데이터 스트림을 생성하려면 아래 지침을 따르십시오. 이 데이터 스트림으로 데이터를 전송하면 데이터가 Audience Manager으로 전달됩니다. 향후에 이와 동일한 데이터스트림이 데이터를 Real-Time CDP에 전달합니다.

  1. experience.adobe.com​(으)로 이동한 다음 자격 증명을 사용하여 로그인합니다.

  2. Data Collection(으)로 이동하려면 오른쪽 상단의 홈 페이지 또는 제품 선택기를 사용하십시오.

  3. 왼쪽 탐색에서 Datastreams ​을(를) 선택합니다.

  4. New Datastream ​을(를) 선택합니다.

  5. 원하는 이름을 입력한 다음 Save ​을(를) 선택합니다.

  6. 데이터 스트림이 만들어지면 Add Service ​을(를) 선택합니다.

  7. 서비스 드롭다운 메뉴에서 Adobe Audience Manager ​을(를) 선택합니다.

  8. Enable XDM Flattened Fields 옵션이 선택 취소되어 있는지 확인하십시오.

    Audience Manager 서비스 추가

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

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

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

  1. Adobe Experience Platform 인터페이스 왼쪽 상단에서 햄버거 아이콘을 선택한 다음 Tags ​을(를) 선택합니다.

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

  3. 태그 속성의 왼쪽 탐색에서 Extensions ​을(를) 선택합니다.

  4. 사용 가능한 모든 확장 목록을 보려면 상단 근처에 있는 Catalog ​을(를) 선택하십시오.

  5. Adobe Experience Platform Web SDK 확장을 검색하여 선택한 다음 오른쪽에서 Install ​을(를) 선택합니다.

    카탈로그

  6. 확장 구성 설정이 나타납니다. Datastreams 섹션을 찾아 사용 중인 샌드박스와 이전 단계에서 만든 데이터 스트림을 선택합니다.

    데이터 스트림 선택

  7. Save ​을(를) 선택합니다.

이제 태그 속성에 웹 SDK이 설치되어 있습니다.

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

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

  1. 태그 인터페이스의 왼쪽 탐색에서 Data Elements ​을(를) 선택합니다.

  2. Add Data Element 선택

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

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

    • 속성 라디오 단추: Data
    • Solution: Adobe Audience Manager
  5. Save ​을(를) 선택합니다.

    데이터 요소 만들기

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

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

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

  1. 태그 인터페이스의 왼쪽 탐색에서 Rules ​을(를) 선택합니다.

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

  3. Audience Manager - Set Variables 작업 선택

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

  5. Action Configuration을(를) 다음 설정으로 변경합니다.

    • Extension: Adobe Experience Platform Web SDK
    • Action type: 변수 업데이트
  6. 3단계에서 만든 데이터 개체가 Data element 필드의 오른쪽 드롭다운에서 선택되어 있는지 확인합니다.

  7. Audience Manager 키-값 쌍을 Audience Manager 확장에 구성된 것과 동일한 해당 값으로 설정합니다.

  8. 웹 SDK 확장을 사용하여 모든 규칙 논리가 복제되면 Keep Changes ​을(를) 선택합니다.

  9. Audience Manager 태그 확장을 사용하여 값을 설정하는 모든 작업 구성에 대해 이 단계를 반복합니다.

위의 단계는 값을 설정하는 규칙에만 적용됩니다. 다음 단계는 Action Configuration Send Event을(를) 사용하는 모든 작업을 대체합니다.

  1. 웹 SDK 이벤트를 보내는 규칙을 선택합니다.

  2. 작업 유형 Send Event ​을(를) 선택하십시오.

  3. Action Configuration을(를) 다음 설정으로 변경합니다.

    • Extension: Adobe Experience Platform Web SDK
    • Action type: Send event
  4. 오른쪽에서 작업 설정을 다음과 같이 변경합니다.

    • Type: Web Webpagedetails Page Views 사용
    • Data: 3단계에서 만든 데이터 개체를 선택합니다.
  5. Keep Changes ​을(를) 선택합니다.

  6. Audience Manager을 사용하여 이벤트를 전송하는 모든 작업 구성에 대해 이 단계를 반복합니다.

5. 업데이트된 규칙 게시

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

  1. 태그 인터페이스의 왼쪽 탐색에서 Publishing Flow ​을(를) 선택합니다.

  2. Add Library ​을(를) 선택합니다.

  3. 이 태그 커밋에 "Web SDK으로 업그레이드"와 같은 이름을 지정합니다.

  4. Add All Changed Resources ​을(를) 선택합니다.

  5. Save ​을(를) 선택합니다.

  6. 게시 작업 과정에는 작성 중임을 나타내는 주황색 점이 표시됩니다. 점이 녹색으로 바뀌면 개발 환경에서 변경 사항을 사용할 수 있습니다.

  7. 개발 환경에서 변경 사항을 테스트하여 모든 규칙이 올바르게 실행되는지, 그리고 데이터 개체가 예상 값으로 채워지는지 확인합니다.

  8. 준비가 되면 승인을 위해 라이브러리를 제출하고 스테이징으로 빌드한 다음 최종적으로 승인하고 프로덕션에 게시합니다.

    게시 흐름

6. Audience Manager 확장 사용 안 함

태그 구현이 웹 SDK으로 완전히 마이그레이션되면 Audience Manager 확장을 비활성화할 수 있습니다.

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

이 시점에서 Audience Manager 구현은 웹 SDK으로 완전히 마이그레이션되며 향후 Real-Time CDP으로 이동할 준비가 되었습니다.

recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695