contextData

컨텍스트 데이터 변수를 사용하면 처리 규칙이 읽을 수 있는 각 페이지에서 사용자 정의 변수를 정의할 수 있습니다. 코드에서 값을 Analytics 변수에 명시적으로 할당하는 대신 컨텍스트 데이터 변수에 데이터를 보낼 수 있습니다. 그러면 처리 규칙이 컨텍스트 데이터 변수 값을 가져와 각 Analytics 변수에 전달합니다. 관리자 사용 안내서의 처리 규칙을 참조하십시오.

컨텍스트 데이터 변수는 개발 팀이 번호가 매겨진 변수 대신 명명된 요소의 데이터를 수집하는 데 유용합니다. 예를 들어 개발 팀에게 페이지의 작성자를 eVar10에 할당하도록 요청하는 대신 s.contextData["author"]에 할당하도록 요청할 수 있습니다. 그런 다음 조직의 Analytics 관리자는 처리 규칙을 만들어 컨텍스트 데이터 변수를 보고를 위한 분석 변수에 매핑할 수 있습니다. 개발 팀은 궁극적으로 Adobe가 제공하는 많은 페이지 변수 대신 컨텍스트 데이터 변수만 걱정하게 됩니다.

Web SDK를 사용한 컨텍스트 데이터 변수

XDM 필드가 Adobe Analytics에 매핑되지 않은 경우 자동으로 컨텍스트 데이터 변수로 포함됩니다. 이후 처리 규칙을 사용하여 컨텍스트 데이터 변수를 원하는 Analytics 변수에 할당할 수 있습니다.

Datastream의 올바른 XDM 필드에 데이터를 매핑하는 것이 가장 좋은 방법이지만 이 방법도 비슷한 결과를 얻습니다.

Adobe Analytics 확장을 사용한 컨텍스트 데이터 변수

Adobe Experience Platform 데이터 수집에는 컨텍스트 데이터 변수를 설정하는 전용 필드가 없습니다. AppMeasurement 구문 다음에 나오는 사용자 정의 코드 편집기를 사용하십시오.

AppMeasurement 및 Analytics 확장 사용자 정의 코드 편집기의 s.contextData

s.contextData 변수는 값을 바로 사용하지 않습니다. 대신 이 변수의 속성을 문자열로 설정합니다.

// Assign the example_variable property a value
s.contextData["example_variable"] = "Example value";
  • 유효한 컨텍스트 데이터 변수에는 영숫자, 밑줄 및 마침표만 포함됩니다. Adobe는 하이픈과 같은 다른 문자를 포함하는 경우 처리 규칙을 통한 데이터 수집을 보장하지 않습니다.
  • 컨텍스트 데이터 변수를 "a."으로 시작하지 마십시오. 이 접두사는 Adobe에 의해 예약되어 사용 중입니다. 예를 들어 s.contextData["a.InstallEvent"]를 사용하지 마십시오.
  • 컨텍스트 데이터 변수는 대/소문자를 구분하지 않습니다. 변수 s.contextData["example"]s.contextData["EXAMPLE"]은 동일합니다.

처리 규칙을 사용하여 분석 변수 채우기

WARNING
컨텍스트 데이터 변수는 처리 규칙 실행 후 무시됩니다. 값을 변수에 배치하는 처리 규칙이 활성화되어 있지 않으면 해당 데이터가 영구적으로 손실됩니다.
  1. 구현을 업데이트하여 컨텍스트 데이터 변수 이름 및 값을 설정합니다.
  2. Adobe Analytics에 로그인하고 관리 > 보고서 세트로 이동합니다.
  3. 원하는 보고서 세트를 선택한 다음, 설정 편집 > 일반 > 처리 규칙으로 이동합니다.
  4. Analytics 변수를 컨텍스트 데이터 변수 값으로 설정하는 처리 규칙을 만듭니다.
  5. 변경 사항을 저장합니다.

처리 규칙은 저장 후 즉시 적용됩니다. 이전 데이터에는 적용되지 않습니다.

링크 추적 호출에서 컨텍스트 데이터 보내기

컨텍스트 데이터 변수를 s.linkTrackVars의 다음 contextData 속성으로 포함하십시오.

s.contextData["example_variable"] = "Example value";
s.linkTrackVars = "contextData.example_variable";
s.tl(true,"o","Example context data link");

컨텍스트 데이터 변수를 사용하여 이벤트 증가

처리 규칙을 만들 때 컨텍스트 데이터 변수를 이벤트에 지정할 수 있습니다.

  • 컨텍스트 데이터 변수에 텍스트가 포함되어 있으면 이벤트가 하나씩 증가합니다.
  • 컨텍스트 데이터 변수에 정수가 들어 있으면 이벤트가 해당 정수 단위로 증가합니다.
// Assigning this context data variable to an event increments it by one
s.contextData["example_text"] = "Text value";

// Assigning this context data variable to an event increments it by four
s.contextData["example_number"] = "4";
recommendation-more-help
b4f6d761-4a8b-4322-b801-c85b9e3be690