contextData

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

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

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

XDM 개체 ​를 사용하는 경우 Adobe Analytics 변수에 매핑되지 않은 모든 필드가 자동으로 컨텍스트 데이터 변수로 포함됩니다. XDM 개체를 사용하여 컨텍스트 데이터를 명시적으로 설정할 수도 있습니다. 그런 다음 처리 규칙을 사용하여 컨텍스트 데이터 변수를 원하는 Analytics 변수에 할당할 수 있습니다. 자세한 내용은 Analytics 변수에 다른 XDM 필드 매핑을 참조하십시오.

데이터 개체 ​를 사용하는 경우 모든 컨텍스트 데이터 변수는 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";

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

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

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

컨텍스트 데이터 변수를 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";