contextData
컨텍스트 데이터 변수를 사용하면 처리 규칙이 읽을 수 있는 각 페이지에서 사용자 정의 변수를 정의할 수 있습니다. 코드에서 값을 Analytics 변수에 명시적으로 할당하는 대신 컨텍스트 데이터 변수에 데이터를 보낼 수 있습니다. 그러면 처리 규칙이 컨텍스트 데이터 변수 값을 가져와 각 Analytics 변수에 전달합니다. 관리자 사용 안내서의 처리 규칙을 참조하십시오.
컨텍스트 데이터 변수는 개발 팀이 번호가 매겨진 변수 대신 명명된 요소의 데이터를 수집하는 데 유용합니다. 예를 들어 개발 팀에게 페이지의 작성자를 eVar10
에 할당하도록 요청하는 대신 s.contextData["author"]
에 할당하도록 요청할 수 있습니다. 그런 다음 조직의 Analytics 관리자는 처리 규칙을 만들어 컨텍스트 데이터 변수를 보고를 위한 분석 변수에 매핑할 수 있습니다. 개발 팀은 궁극적으로 Adobe가 제공하는 많은 페이지 변수 대신 컨텍스트 데이터 변수만 걱정하게 됩니다.
Web SDK를 사용한 컨텍스트 데이터 변수
을 사용하는 경우 XDM 개체, Adobe Analytics 변수에 매핑되지 않은 모든 필드는 컨텍스트 데이터 변수로 자동 포함됩니다. 이후 처리 규칙을 사용하여 컨텍스트 데이터 변수를 원하는 Analytics 변수에 할당할 수 있습니다.
을 사용하는 경우 데이터 개체, 모든 컨텍스트 데이터 변수 data.__adobe.analytics.contextData
키-값 쌍으로:
alloy("sendEvent", {
"data": {
"__adobe": {
"analytics": {
"contextData": {
"example_variable": "Example value",
"second_example": "Another value"
}
}
}
}
});
다음 처리 규칙 인터페이스에 c.example_variable
및 c.second_example
적용 가능한 드롭다운 메뉴 내에서 확인할 수 있습니다.
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"]
은 동일합니다.
처리 규칙을 사용하여 분석 변수 채우기
- 구현을 업데이트하여 컨텍스트 데이터 변수 이름 및 값을 설정합니다.
- Adobe Analytics에 로그인하고 관리 > 보고서 세트로 이동합니다.
- 원하는 보고서 세트를 선택한 다음, 설정 편집 > 일반 > 처리 규칙으로 이동합니다.
- Analytics 변수를 컨텍스트 데이터 변수 값으로 설정하는 처리 규칙을 만듭니다.
- 변경 사항을 저장합니다.
처리 규칙은 저장 후 즉시 적용됩니다. 이전 데이터에는 적용되지 않습니다.
링크 추적 호출에서 컨텍스트 데이터 보내기
컨텍스트 데이터 변수를 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";