Adobe 클라이언트 데이터 레이어 확장

이 설명서는 Adobe 클라이언트 데이터 레이어 확장을 사용하는 방법에 대한 예제와 모범 사례를 제공합니다.

설치

확장을 설치하려면 Experience Platform UI 또는 데이터 수집 UI에서 확장 카탈로그로 이동하고 클라이언트 데이터 레이어 Adobe 를 선택합니다.

확장 보기

기본적으로 ACDL 스크립트는 변수 이름으로 새 데이터 레이어를 만듭니다 adobeDataLayer. 확장 보기는 원하는 경우 이 이름을 변경할 수 있는 기능을 제공합니다. 설정한 이름은 태그가 로드될 때 인스턴스화됩니다.

이벤트

확장은 데이터 레이어에서 이벤트를 수신할 수 있는 기능을 제공합니다. 다음 이벤트를 사용할 수 있습니다.

모든 데이터 변경 사항 수신

이 옵션을 선택하면 이벤트 리스너가 데이터 계층에 대한 모든 변경 사항을 수신합니다.

다음 예제 푸시 이벤트는 리스너에 의해 추적됩니다.

다음 예제 푸시 이벤트는 리스너에 의해 추적되지 않습니다.

모든 이벤트 수신

이 옵션을 선택하면 이벤트 리스너가 데이터 레이어로 푸시된 이벤트를 수신합니다.

다음 예제 푸시 이벤트는 리스너에 의해 추적됩니다.

다음 예제 푸시 이벤트는 리스너에 의해 추적되지 않습니다.

특정 이벤트 수신

이벤트를 지정하는 경우 이벤트 리스너는 특정 문자열과 일치하는 모든 이벤트를 추적합니다.

예, 설정 myEvent 이 구성을 사용하면 리스너가 다음 푸시 이벤트만 추적합니다.

이벤트 리스너의 범위를 변경할 수도 있습니다. 다른 옵션은 아래에 요약되어 있습니다.

작업

다음 섹션에서는 확장에서 지원하는 작업에 대해 간략히 설명합니다.

데이터 레이어 재설정

확장은 데이터 레이어 길이를 재설정하는 방법을 제공하여 단일 페이지 애플리케이션(SPA)의 제한된 크기를 유지하는 데 도움이 됩니다.

그러나 현재 푸시 방법 중에 이전에 설정한 정보를 완전히 제거할 가능성은 없습니다.

다음 계산된 상태 재설정 및 설정 작업은 마지막 계산된 상태를 복사하고 데이터 레이어 개체를 비운 다음 마지막 상태를 다시 푸시합니다.

데이터 레이어로 푸시

확장은 JSON 콘텐츠를 데이터 레이어 자체에 푸시하는 작업을 제공합니다. 이 작업을 통해 JSON에서 직접 데이터 요소를 사용할 수 있습니다. JSON 편집기 내에서 퍼센트 표기법을 사용하여 데이터 요소를 참조해야 합니다(예: %dataElementName%).

{
    "page": {
        "url": "%url%",
        "previous_url": "%previous_url%",
        "concatenated_values": "static string %dataElement%"
    }
}

데이터 요소

아래 섹션에서는 확장에서 제공하는 고유한 데이터 요소 유형을 다룹니다.

계산된 상태

데이터 레이어 계산된 상태 데이터 요소는 구성 방법에 따라 다음 두 가지 중 하나를 반환할 수 있습니다.

데이터 레이어 크기

이 데이터 요소는 데이터 레이어의 크기를 반환합니다. 데이터 레이어의 크기는 이 개체에 푸시된 요소의 수로 표시됩니다.

다음 푸시 이벤트 목록이 주어지면 이 데이터 요소는 정수를 반환합니다 2:

adobeDataLayer.push({"event":"myEvent"})
adobeDataLayer.push({"data":{"foo":"bar"}})