클릭한 구성 요소를 Adobe Analytics에서 추적

이벤트 기반 사용 AEM 핵심 구성 요소를 사용하여 클라이언트 데이터 레이어 Adobe Adobe Experience Manager 사이트에서 특정 구성 요소의 클릭을 추적하려면 다음을 수행하십시오. Experience Platform Launch의 규칙을 사용하여 클릭 이벤트를 수신하고, 구성 요소로 필터링하고 추적 링크 비콘으로 데이터를 Adobe Analytics로 전송하는 방법에 대해 알아봅니다.

빌드할 내용

WKND 마케팅 팀은 홈 페이지에서 가장 잘 수행하는 CTA(Call to Action) 단추를 이해하려고 합니다. 이 자습서에서는 수신 대기하는 새 규칙을 Experience Platform Launch에 추가합니다 cmp:click 이벤트 티저단추 구성 요소를 사용하여 추적 링크 비콘과 함께 구성 요소 ID와 새 이벤트를 Adobe Analytics에 보냅니다.

클릭 추적 빌드

목표

  1. Launch에서 을 기반으로 이벤트 기반 규칙을 만듭니다. cmp:click 이벤트.
  2. 구성 요소 리소스 유형별로 다른 이벤트를 필터링합니다.
  3. 클릭한 구성 요소 ID를 설정하고 추적 링크 비콘으로 이벤트 Adobe Analytics을 보냅니다.

사전 요구 사항

이 자습서는 Adobe Analytics을 사용하여 페이지 데이터 수집 및 는 다음과 같은 내용이 있다고 가정합니다.

Inspect 단추 및 Teaser 스키마

Launch에서 규칙을 만들기 전에 단추 및 티저에 대한 스키마 데이터 레이어 구현에서 이를 검사합니다.

  1. 다음으로 이동 https://wknd.site/us/en.html

  2. 브라우저의 개발자 도구를 열고 콘솔. 다음 명령을 실행합니다.

    adobeDataLayer.getState();
    

    이렇게 하면 Adobe 클라이언트 데이터 레이어의 현재 상태가 반환됩니다.

    브라우저 콘솔을 통한 데이터 레이어 상태

  3. 응답을 확장하고 접두어가 있는 항목을 찾습니다. button-teaser-xyz-cta 을 입력합니다. 다음과 같은 데이터 스키마가 표시됩니다.

    단추 스키마:

    button-2e6d32893a:
        @type: "wknd/components/button"
        dc:title: "View All"
        parentId: "page-2eee4f8914"
        repo:modifyDate: "2020-07-11T22:17:55Z"
        xdm:linkURL: "/content/wknd/us/en/magazine.html"
    

    Teaser 스키마:

    teaser-da32481ec8-cta-adf3c09db9:
        @type: "wknd/components/teaser/cta"
        dc:title: "Surf's Up"
        parentId: "teaser-da32481ec8"
        xdm:linkURL: "/content/wknd/us/en/magazine/san-diego-surf.html"
    

    이것은 구성 요소/컨테이너 항목 스키마. Launch에서 만드는 규칙은 이 스키마를 사용합니다.

클릭한 CTA 규칙 만들기

Adobe 클라이언트 데이터 계층은 이벤트 제어 데이터 레이어. 핵심 구성 요소를 클릭할 때 cmp:click 이벤트는 데이터 계층을 통해 전달됩니다. 다음 을(를) 수신할 규칙을 만듭니다 cmp:click 이벤트.

  1. AEM Site와 통합된 Experience Platform Launch 및 웹 속성으로 이동합니다.

  2. 로 이동합니다 규칙 섹션을 클릭한 다음 을(를) 클릭합니다. 규칙 추가.

  3. 규칙 이름을 지정합니다 클릭한 CTA.

  4. 클릭 이벤트 > 추가 열다 이벤트 구성 마법사

  5. 아래 이벤트 유형 선택 사용자 지정 코드.

    규칙 이름을 CTA Clicked 로 지정하고 사용자 지정 코드 이벤트 추가

  6. 클릭 편집기 열기 기본 패널에서 다음 코드 조각을 입력합니다.

    var componentClickedHandler = function(evt) {
       // defensive coding to avoid a null pointer exception
       if(evt.hasOwnProperty("eventInfo") && evt.eventInfo.hasOwnProperty("path")) {
          //trigger Launch Rule and pass event
          console.debug("cmp:click event: " + evt.eventInfo.path);
          var event = {
             //include the path of the component that triggered the event
             path: evt.eventInfo.path,
             //get the state of the component that triggered the event
             component: window.adobeDataLayer.getState(evt.eventInfo.path)
          };
    
          //Trigger the Launch Rule, passing in the new `event` object
          // the `event` obj can now be referenced by the reserved name `event` by other Launch data elements
          // i.e `event.component['someKey']`
          trigger(event);
       }
    }
    
    //set the namespace to avoid a potential race condition
    window.adobeDataLayer = window.adobeDataLayer || [];
    //push the event listener for cmp:click into the data layer
    window.adobeDataLayer.push(function (dl) {
       //add event listener for `cmp:click` and callback to the `componentClickedHandler` function
       dl.addEventListener("cmp:click", componentClickedHandler);
    });
    

    위의 코드 조각은 함수 푸시 참조하십시오. 이 cmp:click 이벤트가 트리거됨 componentClickedHandler 함수가 호출될 때 이 함수에서 몇 가지 상태 검사가 추가되고 새 event 객체는 최신 상태로 구성됩니다 데이터 계층의 상태 를 사용( 이벤트를 트리거한 구성 요소)할 수 있습니다.

    그 후 trigger(event) 가 호출됩니다. trigger() 는 Launch의 예약된 이름이며, Launch 규칙을 "트리거"합니다. Adobe는 event 개체를 매개 변수로 식별하면 이름이 인 Launch에서 다른 예약된 이름에 의해 노출됩니다. event. 이제 Launch의 데이터 요소는 다음과 같은 다양한 속성을 참조할 수 있습니다. event.component['someKey'].

  7. 변경 사항을 저장합니다.

  8. 다음 작업 click 추가 열다 작업 구성 마법사

  9. 아래 작업 유형 선택 사용자 지정 코드.

    사용자 지정 코드 작업 유형

  10. 클릭 편집기 열기 기본 패널에서 다음 코드 조각을 입력합니다.

    console.debug("Component Clicked");
    console.debug("Component Path: " + event.path);
    console.debug("Component type: " + event.component['@type']);
    console.debug("Component text: " + event.component['dc:title']);
    

    다음 event 객체에서 전달됩니다. trigger() 메서드가 사용자 지정 이벤트에서 호출되었습니다. component 는 데이터 레이어에서 파생된 구성 요소의 현재 상태입니다 getState 클릭을 트리거한 것입니다.

  11. 변경 내용을 저장하고 빌드 Launch에서 코드를 환경 AEM 사이트에서 사용됩니다.

    노트

    이렇게 하면 Adobe Experience Platform Debugger 포함 코드를 개발 환경.

  12. 로 이동합니다 WKND 사이트 개발자 도구를 열고 콘솔을 봅니다. 선택 로그 유지.

  13. 다음 중 하나를 클릭합니다 티저 또는 단추 다른 페이지로 이동할 CTA 단추.

    클릭하는 CTA 단추

  14. 개발자 콘솔에서 다음을 관찰합니다. 클릭한 CTA 규칙이 실행됨:

    클릭한 CTA 단추

데이터 요소 만들기

그런 다음 클릭한 구성 요소 ID와 제목을 캡처하는 데이터 요소 를 만듭니다. 이전 연습에서 event.path 과 비슷한 component.button-b6562c963d 및 값 event.component['dc:title'] "여행 보기"와 같은 것이었어요.

구성 요소 ID

  1. AEM Site와 통합된 Experience Platform Launch 및 웹 속성으로 이동합니다.

  2. 로 이동합니다 데이터 요소 섹션을 클릭하고 새 데이터 요소 추가.

  3. 대상 이름 enter 구성 요소 ID.

  4. 대상 데이터 요소 유형 선택 사용자 지정 코드.

    구성 요소 ID 데이터 요소 양식

  5. 클릭 편집기 열기 및 사용자 지정 코드 편집기에 다음을 입력합니다.

    if(event && event.path && event.path.includes('.')) {
        // split on the `.` to return just the component ID
        return event.path.split('.')[1];
    }
    

    변경 사항을 저장합니다.

    노트

    이 사실을 상기시켜 event 개체는 를 트리거하는 이벤트를 기반으로 사용 및 범위가 지정됩니다 규칙 입니다. 데이터 요소의 값은 데이터 요소가 참조됨 규칙 내에서 사용할 수 있습니다. 따라서 다음과 같이 규칙 내에서 이 데이터 요소를 사용하는 것이 좋습니다 클릭한 CTA 이전 연습에서 만든 규칙 그러나 다른 컨텍스트에서는 를 사용할 수 없습니다.

구성 요소 제목

  1. 로 이동합니다 데이터 요소 섹션을 클릭하고 새 데이터 요소 추가.

  2. 대상 이름 enter 구성 요소 제목.

  3. 대상 데이터 요소 유형 선택 사용자 지정 코드.

  4. 클릭 편집기 열기 및 사용자 지정 코드 편집기에 다음을 입력합니다.

    if(event && event.component && event.component.hasOwnProperty('dc:title')) {
        return event.component['dc:title'];
    }
    

    변경 사항을 저장합니다.

CTA 클릭됨 규칙에 조건 추가

다음으로, 클릭한 CTA 규칙이 cmp:click 이벤트가 티저 또는 단추. Teaser의 CTA는 데이터 계층에서 별도의 객체로 간주되므로 Teaser에서 Teaser가 생성되었는지 확인하기 위해 상위를 확인하는 것이 중요합니다.

  1. Launch UI에서 클릭한 CTA 규칙이 이전에 생성되었습니다.

  2. 아래 조건 click 추가 열다 조건 구성 마법사

  3. 대상 조건 유형 선택 사용자 지정 코드.

    CTA가 조건 사용자 지정 코드를 클릭함

  4. 클릭 편집기 열기 및 사용자 지정 코드 편집기에 다음을 입력합니다.

    if(event && event.component && event.component.hasOwnProperty('@type')) {
        // console.log("Event Type: " + event.component['@type']);
        //Check for Button Type OR Teaser CTA type
        if(event.component['@type'] === 'wknd/components/button' ||
           event.component['@type'] === 'wknd/components/teaser/cta') {
            return true;
        }
    }
    
    // none of the conditions are met, return false
    return false;
    

    위의 코드는 먼저 리소스 유형이 단추 그런 다음 리소스 유형이 티저.

  5. 변경 사항을 저장합니다.

Analytics 변수 설정 및 추적 링크 비콘 트리거

현재 클릭한 CTA 규칙은 콘솔 문을 출력하기만 합니다. 다음으로, 데이터 요소 및 Analytics 확장을 사용하여 Analytics 변수를 작업. 또한 을(를) 트리거하는 추가 작업을 설정할 것입니다 추적 링크 수집된 데이터를 Adobe Analytics에 보냅니다.

  1. 에서 클릭한 CTA 규칙 제거 a 코어 - 사용자 지정 코드 action (console 문):

    사용자 지정 코드 작업 제거

  2. Actions에서 추가 새 작업을 추가하려면 다음을 수행하십시오.

  3. 설정 확장 유형 Adobe Analytics 그리고 작업 유형 to 변수 설정.

  4. 에 대해 다음 값을 설정합니다. eVar, Prop, 및 이벤트:

    • evar8 - %Component ID%
    • prop8 - %Component ID%
    • event8

    eVar Prop 및 이벤트 설정

    노트

    여기 %Component ID% 는 클릭한 CTA에 대한 고유 식별자를 보장하므로 사용됩니다. 사용 시 발생할 수 있는 단점 %Component ID% 분석 보고서에 다음과 같은 값이 포함됩니다. button-2e6d32893a. 사용 %Component Title% 은 보다 친숙한 이름을 제공하지만 이 값은 고유하지 않을 수 있습니다.

  5. 그런 다음 오른쪽의 오른쪽에 추가 작업을 추가합니다 Adobe Analytics - 변수 설정 을 눌러 plus 아이콘:

    추가 Launch 작업 추가

  6. 설정 확장 유형 Adobe Analytics 그리고 작업 유형 to 비콘 보내기.

  7. 아래 추적 라디오 단추를 로 설정합니다. s.tl().

  8. 대상 링크 유형 선택 사용자 지정 링크 및 대상 링크 이름 값을 다음으로 설정: %Component Title%: CTA Clicked:

    링크 비콘 보내기 구성

    이렇게 하면 데이터 요소의 동적 변수가 결합됩니다 구성 요소 제목 및 정적 문자열 클릭한 CTA.

  9. 변경 사항을 저장합니다. 다음 클릭한 CTA 규칙에는 이제 다음 구성이 있어야 합니다.

    최종 실행 구성

    • 1. 다음 내용을 들어 보십시오. cmp:click 이벤트.
    • 2. 이벤트가 단추 또는 티저.
    • 3. 을 추적할 Analytics 변수를 설정합니다. 구성 요소 ID 로서의 eVar, prop, 및 이벤트.
    • 4. Analytics 추적 링크 비콘 보내기(및 작업) not 페이지 보기로 처리합니다).
  10. 모든 변경 사항을 저장하고 해당 환경으로 승격하여 Launch 라이브러리를 빌드합니다.

추적 링크 비콘 및 Analytics 호출 유효성 검사

이제 클릭한 CTA 규칙이 Analytics 비콘을 전송합니다. Experience Platform 디버거를 사용하여 Analytics 추적 변수를 볼 수 있습니다.

  1. 를 엽니다. WKND 사이트 브라우저에서

  2. Debugger 아이콘 클릭 Experience platform Debugger 아이콘 Experience Platform 디버거를 엽니다.

  3. 디버거가 Launch 속성을 your 이전 및 설명한 대로 개발 환경 콘솔 로깅 이(가) 선택되어 있습니다.

  4. Analytics 메뉴를 열고 보고서 세트가 your 보고서 세트.

    Analytics 탭 디버거

  5. 브라우저에서 티저 또는 단추 다른 페이지로 이동할 CTA 단추.

    클릭하는 CTA 단추

  6. Experience Platform 디버거로 돌아가서 아래로 스크롤하여 확장합니다. 네트워크 요청 > 보고서 세트. 이 파일을 찾을 수 있어야 합니다. eVar, prop, 및 이벤트 설정합니다.

    클릭 시 추적된 Analytics 이벤트, evar 및 prop

  7. 브라우저로 돌아가서 개발자 콘솔을 엽니다. 사이트의 바닥글로 이동하고 탐색 링크 중 하나를 클릭합니다.

    바닥글에서 탐색 링크 를 클릭합니다

  8. 브라우저 콘솔에서 메시지를 관찰합니다 "CTA 클릭됨" 규칙에 대한 "사용자 지정 코드"가 충족되지 않음.

    탐색 구성 요소가 cmp:click 이벤트 그러나 리소스 유형에 대해 을(를) 확인했으므로 작업이 수행되지 않습니다.

    노트

    콘솔 로그가 표시되지 않으면 콘솔 로깅 이(가) 체크 아웃되었습니다. Launch ( Experience Platform 디버거에서)를 참조하십시오.

축하합니다!

이벤트 기반 Adobe 클라이언트 데이터 레이어 및 Experience Platform Launch을 사용하여 Adobe Experience Manager 사이트에서 특정 구성 요소의 클릭을 추적했습니다.

이 페이지에서는