태그 규칙 만들기

태그 규칙을 사용하여 XDM 오브젝트와 함께 Adobe Experience Platform Edge Network에 이벤트를 전송하는 방법에 대해 알아봅니다. 태그 규칙은 태그 속성에 작업을 수행하도록 지시하는 이벤트, 조건 및 작업의 조합입니다. Platform Web SDK를 사용하면 규칙을 사용하여 적합한 데이터로 이벤트를 Platform Edge Network에 전송합니다.

학습 목표

이 단원을 마치면 다음을 수행할 수 있습니다.

  • 태그 내 규칙 관리에 명명 규칙 사용
  • 변수 업데이트 및 이벤트 보내기 작업을 사용하여 XDM 필드로 이벤트 보내기
  • 여러 규칙에 대해 여러 XDM 필드 세트 스택
  • 개별 또는 전체 배열 데이터 요소를 XDM 개체에 매핑
  • 개발 라이브러리에 태그 규칙 게시

전제 조건

데이터 수집 태그 및 Luma 데모 사이트 을(를) 통해 다음 자습서의 이전 단원을 완료했습니다.

이름 지정 규칙

태그에서 규칙을 관리하려면 표준 명명 규칙을 따르는 것이 좋습니다. 이 자습서에서는 5가지 부분으로 구성된 명명 규칙을 사용합니다.

  • [위치] - [이벤트] - [목적] - [주문]

다음의 경우

  1. 위치 는 규칙이 실행되는 사이트의 페이지입니다
  2. 이벤트 는 규칙의 트리거입니다.
  3. 목적 는 규칙에서 수행하는 기본 작업입니다
  4. 주문 은 다른 규칙과 관련하여 규칙이 실행되는 순서입니다

태그 규칙 만들기

태그에서 규칙은 다양한 조건에서 작업(호출 실행)을 실행하는 데 사용됩니다. Platform Web SDK 태그 확장에는 이 단원에서 사용하는 두 가지 작업이 포함되어 있습니다.

  • 변수 업데이트 xdm 개체의 속성에 데이터 요소 매핑
  • 이벤트 보내기 Experience Platform Edge Network에 XDM 개체 보내기

이 단원의 나머지 부분에서

  1. 를 사용하여 규칙 만들기 변수 업데이트 xdm 필드의 "전역 구성"을 정의하는 작업입니다.

  2. 을(를) 사용하여 추가 규칙 만들기 변수 업데이트 특정 조건에서 "전역 구성"을 무시하고 추가 XDM 필드를 제공하는 작업(예: 제품 페이지에 제품 세부 사항 추가).

  3. 을(를) 사용하여 다른 규칙 만들기 이벤트 보내기 전체 XDM 개체를 Adobe Experience Platform Edge Network으로 전송하는 작업입니다.

이러한 모든 규칙의 순서는 를 사용하여 올바르게 지정됩니다.주문" 옵션입니다.

이 비디오에서는 프로세스에 대한 개요를 제공합니다.

전역 구성 필드

글로벌 XDM 필드에 대한 태그 규칙을 만들려면 다음을 수행하십시오.

  1. 이 자습서에서 사용하는 태그 속성을 엽니다

  2. 다음으로 이동 규칙 왼쪽 탐색

  3. 다음 항목 선택 새 규칙 만들기 단추

    규칙 만들기

  4. 규칙 이름을 지정합니다 all pages - library loaded - set global variables - 1

  5. 다음에서 이벤트 섹션, 선택 추가

    규칙에 이름 지정 및 이벤트 추가

  6. 사용 코어 확장 및 선택 라이브러리가 로드됨 (페이지 상단) (으)로 이벤트 유형

  7. 선택 고급 드롭다운 및 enter 1 (으)로 주문

    note note
    NOTE
    주문 번호가 낮을수록 더 빨리 실행됩니다. 따라서 "글로벌 구성"에 낮은 주문 번호를 제공합니다.
  8. 선택 변경 내용 유지 기본 규칙 화면으로 돌아가기
    Library Loaded 트리거 선택

  9. 다음에서 작업 섹션, 선택 추가

  10. 다음으로: 확장, 선택 Adobe Experience Platform 웹 SDK

  11. 다음으로: 작업 유형, 선택 변수 업데이트

  12. 다음으로: 데이터 요소 ​를 선택하고 xdm.variable.content 다음 작업에서 을(를) 만들었습니다. 데이터 요소 만들기 단원

    변수 스키마 업데이트

이제 를 매핑합니다. 데이터 요소 (으)로 스키마 xdm 개체에서 사용됩니다. 개별 속성 또는 전체 객체에 매핑할 수 있습니다. 이 예제에서는 개별 속성에 매핑합니다.

  1. eventType 필드를 찾아 선택합니다.

  2. 값 입력 web.webpagedetails.pageViews

    note tip
    TIP
    에서 채울 값을 이해하려면 eventType 필드: 스키마 페이지로 이동하여 eventType 오른쪽 레일에서 제안된 값을 보기 위한 필드입니다. 필요한 경우 새 값을 입력할 수도 있습니다.
    스키마 페이지의 eventType 제안 값
  3. 그런 다음 identityMap 스키마의 객체를 선택하고

  4. 에 매핑 identityMap.loginID 데이터 요소

    변수 ID 맵 업데이트

    note tip
    TIP
    데이터 요소가 null인 경우 XDM 필드는 네트워크 요청에 포함되지 않습니다. 따라서 사용자가 인증되지 않은 경우 및 identityMap.loginID 데이터 요소가 null이면 identityMap 개체가 전송되지 않습니다. 이것이 "전역 구성"에서 이 구성을 정의할 수 있는 이유입니다.
  5. 에 도달할 때까지 아래로 스크롤합니다. web 오브젝트

  6. 열려면 선택하십시오.

  7. 다음 데이터 요소를 해당 항목에 매핑 web XDM 변수

    • web.webPageDetials.name%page.pageInfo.pageName%
    • web.webPageDetials.server%page.pageInfo.server%
    • web.webPageDetials.siteSection%page.pageInfo.hierarchie1%
  8. web.webPageDetials.pageViews.value1로 설정합니다.

    변수 콘텐츠 업데이트

    note tip
    TIP
    While nothing eventType 을 로 설정 web.webpagedetails.pageViews nor web.webPageDetails.pageViews.value Adobe Analytics에서 비콘을 페이지 보기로 처리하는 데 필요한 경우, 다른 다운스트림 애플리케이션에 대한 페이지 보기를 표시하는 표준 방법을 사용하는 것이 유용합니다.
  9. 선택 변경 내용 유지 그런 다음 저장 다음 화면의 규칙 을 클릭하여 규칙 만들기를 완료합니다

제품 페이지 필드

이제 변수 업데이트 또한 순차적 규칙은에 보내기 전에 XDM 개체를 보강하는 것입니다. 플랫폼 Edge Network.

TIP
규칙 순서는 이벤트가 트리거될 때 먼저 실행되는 규칙을 결정합니다. 두 규칙의 이벤트 유형이 동일한 경우 숫자가 가장 낮은 규칙이 먼저 실행됩니다.

Luma의 제품 세부 사항 페이지에서 제품 보기를 추적하여 시작합니다.

  1. 선택 규칙 추가

  2. 이름 지정 ecommerce - library loaded - set product details variables - 20

  3. 다음 항목 선택 + 기호 새 트리거를 추가할 이벤트

  4. 아래 확장, 선택 코어

  5. 아래 이벤트 유형, 선택 라이브러리가 로드됨 (페이지 상단)

  6. 열려면 선택하십시오. 고급 옵션, 입력 20. 이 순서 값은 규칙 실행을 보장합니다 이후 다음 all pages - library loaded - set global variables - 1 전역 구성을 설정합니다.

  7. 선택 변경 내용 유지

    Analytics XDM 규칙

  8. 아래 조건 ​을(를) 선택합니다 추가

  9. 나가기 논리 유형 다음으로: 보통

  10. 나가기 확장 다음으로: 코어

  11. 선택 조건 유형 다음으로: 쿼리 문자열이 없는 경로

  12. 오른쪽에서 정규 표현식 전환

  13. 아래 경로가 다음과 같음 set /products/. Luma 데모 사이트의 경우 규칙이 제품 페이지에서만 트리거되도록 합니다

  14. 선택 변경 내용 유지

    Analytics XDM 규칙

  15. 아래 작업 선택 추가

  16. 선택 Adobe Experience Platform 웹 SDK 확장

  17. 선택 작업 유형 다음으로: 변수 업데이트

  18. 선택 xdm.variable.content (으)로 데이터 요소

  19. 아래로 스크롤하여 commerce 오브젝트

  20. 를 엽니다. 제품 보기 오브젝트 및 세트 1

    제품 보기 설정

    note tip
    TIP
    XDM에서 commerce.productViews.value=1 을 설정하면 prodView analytics의 이벤트
  21. 아래로 스크롤하여 eventType 및 설정 commerce.productViews

    note note
    NOTE
    이 규칙의 순서가 높으므로 eventType "전역 구성" 규칙으로 설정합니다. eventType 은 하나의 값만 포함할 수 있으며 가장 중요한 이벤트로 설정하는 것이 좋습니다.
  22. 아래로 스크롤하여 선택 productListItems 배열

  23. 선택 개별 항목 제공

  24. 선택 항목 추가

    제품 보기 이벤트 설정 중

    note caution
    CAUTION
    다음 productListItems 은(는) array 데이터가 요소의 컬렉션으로 들어올 것을 예상하도록 데이터 유형입니다. Luma 데모 사이트의 데이터 레이어 구조와 Luma 사이트에서 한 번에 하나의 제품만 볼 수 있으므로 항목을 개별적으로 추가합니다. 자체 웹 사이트에서 를 구현할 때 데이터 레이어 구조에 따라 전체 어레이를 제공할 수 있습니다.
  25. 열려면 선택하십시오. 항목 1

  26. productListItems.item1.SKU%product.productInfo.sku%

    제품 SKU XDM 개체 변수

  27. 선택 변경 내용 유지

  28. 선택 저장 규칙을 저장하려면

장바구니 필드

배열이 XDM 스키마의 형식과 일치하는 경우 전체 배열을 XDM 개체에 매핑할 수 있습니다. 사용자 지정 코드 데이터 요소 cart.productInfo 다음을 통해 이전 루프를 만들었습니다. digitalData.cart.cartEntries luma의 데이터 레이어 개체를 필요한 형식의 productListItems XDM 스키마 오브젝트.

이를 설명하기 위해서는 아래 Luma 사이트 데이터 레이어(왼쪽)와 번역된 데이터 요소(오른쪽)의 비교를 참조하십시오.

XDM 개체 배열 형식

데이터 요소를 productListItems 구조(힌트, 일치해야 함).

IMPORTANT
숫자 변수가 데이터 레이어의 문자열 값과 함께 변환되는 방식을 확인합니다. priceqty 데이터 요소의 숫자로 형식이 변경되었습니다. 이러한 형식 요구 사항은 플랫폼의 데이터 무결성에 중요하며 다음 기간 동안 결정됩니다. 스키마 구성 단계. 이 예에서는 수량 를 사용합니다. 정수 데이터 유형.
XDM 스키마 데이터 유형

이제 배열을 XDM 개체에 매핑하겠습니다.

  1. (이)라는 이름의 새 규칙 만들기 ecommerce - library loaded - set shopping cart variables - 20

  2. 다음 항목 선택 + 기호 새 트리거를 추가할 이벤트

  3. 아래 확장, 선택 코어

  4. 아래 이벤트 유형, 선택 라이브러리가 로드됨 (페이지 상단)

  5. 열려면 선택하십시오. 고급 옵션, 입력 20

  6. 선택 변경 내용 유지

    Analytics XDM 규칙

  7. 아래 조건 ​을(를) 선택합니다 추가

  8. 나가기 논리 유형 다음으로: 보통

  9. 나가기 확장 다음으로: 코어

  10. 선택 조건 유형 다음으로: 쿼리 문자열이 없는 경로

  11. 오른쪽이요 금지 활성화 정규 표현식 전환

  12. 아래 경로가 다음과 같음 set /content/luma/us/en/user/cart.html. Luma 데모 사이트의 경우 규칙이 장바구니 페이지에서 트리거만 하는지 확인합니다

  13. 선택 변경 내용 유지

    Analytics XDM 규칙

  14. 아래 작업 선택 추가

  15. 선택 Adobe Experience Platform 웹 SDK 확장

  16. 선택 작업 유형 다음으로: 변수 업데이트

  17. 선택 xdm.variable.content (으)로 데이터 요소

  18. 아래로 스크롤하여 commerce 을(를) 개체하고 을(를) 선택하여 엽니다.

  19. 를 엽니다. 제품 목록 보기 수 오브젝트 및 세트 1

    제품 보기 설정

    note tip
    TIP
    XDM에서 commerce.productListViews.value=1 을 설정하면 scView analytics의 이벤트
  20. 선택 eventType 및 을 (으)로 설정 commerce.productListViews

  21. 아래로 스크롤하여 선택 productListItem 배열

  22. 선택 전체 스토리지 제공

  23. 다음에 매핑 cart.productInfo 데이터 요소

  24. 선택 변경 내용 유지

  25. 선택 저장 규칙을 저장하려면

아래 차이점을 사용하여 동일한 패턴에 따라 체크아웃 및 구매를 위한 다른 두 규칙을 만듭니다.

규칙 이름: ecommerce - library loaded - set checkout variables - 20

  1. 조건: /content/luma/us/en/user/checkout.html

  2. eventTypecommerce.checkouts로 설정합니다.

  3. commerce.checkout.value1로 설정합니다.

    note tip
    TIP
    이는 설정에 해당합니다. scCheckout analytics의 이벤트

규칙 이름: ecommerce - library loaded - set purchase variables - 20

  1. 조건: /content/luma/us/en/user/checkout/order/thank-you.html

  2. eventTypecommerce.purchases로 설정합니다.

  3. commerce.purchases.value1로 설정합니다.

    note tip
    TIP
    이는 설정에 해당합니다. purchase analytics의 이벤트
  4. 설정 commerce.order.purchaseID (으)로 cart.orderId 데이터 요소

  5. 설정 commerce.order.currencyCode 하드코딩된 값에 USD

    Analytics용 purchaseID 설정

    note tip
    TIP
    이는 설정에 해당합니다. s.purchaseIDs.currencyCode analytics의 변수
  6. 아래로 스크롤하여 선택 productListItem 배열

  7. 선택 전체 스토리지 제공

  8. 다음에 매핑 cart.productInfo.purchase 데이터 요소

  9. 선택 변경 내용 유지

  10. 선택 저장

완료되면 다음 규칙이 생성됩니다.

Analytics XDM 규칙

이벤트 규칙 보내기

변수를 설정했으므로 이제 를 사용하여 전체 XDM 개체를 Platform Edge Network에 전송하는 규칙을 만들 수 있습니다. 이벤트 보내기 작업.

  1. 오른쪽에서 을 선택합니다. 규칙 추가 다른 규칙을 만들려면

  2. 규칙 이름을 지정합니다 all pages - library loaded - send event - 50

  3. 다음에서 이벤트 섹션, 선택 추가

  4. 사용 코어 확장 및 선택 Library Loaded (Page Top) (으)로 이벤트 유형

  5. 선택 고급 드롭다운 및 enter 50 위치: 주문. 이렇게 하면 이 규칙은 사용자가 구성한 다른 모든 규칙(이 있었음) 이후에 실행됩니다 1 또는 20 (으)로 주문).

  6. 선택 변경 내용 유지 기본 규칙 화면으로 돌아가기
    Library Loaded 트리거 선택

  7. 다음에서 작업 섹션, 선택 추가

  8. 다음으로: 확장, 선택 Adobe Experience Platform 웹 SDK

  9. 다음으로: 작업 유형, 선택 이벤트 보내기

  10. 다음으로: XDM ​를 선택하고 xdm.variable.content 이전 단원에서 만든 데이터 요소

  11. 선택 변경 내용 유지 기본 규칙 화면으로 돌아가기

    이벤트 보내기 작업 추가

  12. 선택 저장 규칙을 저장하려면

    규칙 저장

라이브러리에 규칙 게시

그런 다음 규칙이 작동하는지 확인할 수 있도록 개발 환경에 규칙을 게시합니다.

라이브러리를 만들려면 다음 작업을 수행하십시오.

  1. 다음으로 이동 게시 플로우 왼쪽 탐색

  2. 선택 라이브러리 추가

    라이브러리 추가 를 선택합니다

  3. 의 경우 이름, 입력 Luma Web SDK Tutorial

  4. 의 경우 환경, 선택 Development

  5. 선택 변경된 모든 리소스 추가

    note note
    NOTE
    이전 단원에서 만든 모든 태그 구성 요소가 표시됩니다. 코어 확장에는 모든 웹 태그 속성에 필요한 기본 JavaScript가 포함되어 있습니다.
  6. 선택 개발을 위한 저장 및 구축

    라이브러리 만들기 및 빌드

라이브러리를 빌드하는 데 몇 분 정도 소요될 수 있으며 완료되면 라이브러리 이름 왼쪽에 녹색 점이 표시됩니다.

빌드 완료

에서 볼 수 있듯이 게시 플로우 화면에는 게시 프로세스에 대한 훨씬 많은 내용이 있으며, 이는 이 자습서의 범위를 벗어납니다. 이 자습서에서는 개발 환경의 단일 라이브러리를 사용합니다.

이제 Adobe Experience Platform Debugger을 사용하여 요청에 있는 데이터의 유효성을 검사할 준비가 되었습니다.

다음

NOTE
Adobe Experience Platform Web SDK에 대해 학습하는 데 시간을 투자해 주셔서 감사합니다. 질문이 있거나, 일반적인 피드백을 공유하거나, 향후 콘텐츠에 대한 제안이 있는 경우 이에 대해 공유하십시오. Experience League 커뮤니티 토론 게시물
recommendation-more-help
8cbc0fd8-ca1d-433b-9c3d-bc3f113347d4