설명서Analytics구현 안내서

Adobe 플러그인: manageVars

Last update: Fri Jan 26 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

작성 대상:

  • Admin
  • Developer
IMPORTANT
이 플러그인은 Adobe Analytics를 최대한 활용할 수 있도록 Adobe Consulting에서 무료로 제공합니다. Adobe 고객 지원 센터는 설치 또는 문제 해결 등 본 플러그인에 대한 지원을 제공하지 않습니다. 본 플러그인에 대한 도움이 필요한 경우 조직의 Adobe 계정 팀에 문의하십시오. 계정 팀이 컨설턴트와의 미팅을 조정할 수 있습니다.

manageVars 플러그인을 사용하면 여러 Analytics 변수의 값을 한 번에 조작할 수 있습니다. 값을 소문자로 설정하거나 여러 변수 값에서 불필요한 문자를 동시에 제거할 수도 있습니다. 여러 변수의 값을 한 번에 정리하려면 이 플러그인을 사용하는 것이 좋습니다.

Web SDK 또는 Web SDK 확장을 사용하여 플러그인 설치

이 플러그인은 아직 웹 SDK에서 사용할 수 없습니다.

Adobe Analytics 확장을 사용하여 플러그인 설치

Adobe은 Adobe Analytics에서 가장 일반적으로 사용되는 플러그인을 사용할 수 있도록 해 주는 확장을 제공합니다.

  1. AdobeID 자격 증명을 사용하여 Adobe Experience Platform 데이터 수집에 로그인합니다.

  2. 원하는 태그 속성을 클릭합니다.

  3. 확장 탭으로 이동한 다음, 카탈로그 버튼을 클릭합니다.

  4. 일반적인 Analytics 플러그인 확장 기능을 설치 및 게시합니다.

  5. 아직 없다면 다음 구성으로 "플러그인 초기화"라는 레이블이 지정된 규칙을 만듭니다.

    • 조건: 없음
    • 이벤트: 핵심 - 라이브러리가 로드됨 (페이지 상단)

  6. 다음 구성으로 위의 규칙에 작업을 추가합니다.

    • 확장: 일반적인 Analytics 플러그인
    • 작업 유형: manageVars 초기화

  7. 변경 사항을 저장하고 규칙에 퍼블리싱합니다.

사용자 지정 코드 편집기를 사용하여 플러그인 설치

일반 Analytics 플러그인 확장 프로그램을 사용하지 않으려면 사용자 지정 코드 편집기를 사용할 수 있습니다.

  1. AdobeID 자격 증명을 사용하여 Adobe Experience Platform 데이터 수집에 로그인합니다.
  2. 원하는 속성을 클릭합니다.
  3. 확장 탭으로 이동한 다음, Adobe Analytics 확장 아래의 구성 버튼을 클릭합니다.
  4. 사용자 정의 코드를 사용하여 추적 구성 아코디언을 확장합니다. 그러면 편집기 열기 버튼이 표시됩니다.
  5. 사용자 정의 코드 편집기를 열고 아래에 제공된 플러그인 코드를 편집 창에 붙여넣습니다.
  6. 변경 사항을 저장하고 Analytics 확장에 게시합니다.

AppMeasurement를 사용하여 플러그인 설치

Analytics 추적 오브젝트가 인스턴스화 (s_gi 사용)된 후 AppMeasurement 파일의 아무 곳에나 다음 코드를 복사하여 붙여넣으십시오. 구현에서 코드의 댓글 및 버전 번호를 보존하면 Adobe에서 잠재적인 문제를 해결하는 데 도움이 됩니다.

/******************************************* BEGIN CODE TO DEPLOY *******************************************/
/* Adobe Consulting Plugin: manageVars v3.0 (Requires AppMeasurement) */
function manageVars(cb,l,il){var g=cb,c=l,d=il;if("-v"===g)return{plugin:"manageVars",version:"3.0"};var f=function(){if("undefined"!==typeof window.s_c_il)for(var a=0,b;a<window.s_c_il.length;a++)if(b=window.s_c_il[a],b._c&&"s_c"===b._c)return b}();if("undefined"!==typeof f){f.contextData.manageVars="3.0";f.blankVars=function(a){this[a]&&(0>a.indexOf("contextData")?this[a]="":(a=a.substring(a.indexOf(".")+1),this.contextData[a]&&(this.contextData[a]="")))};f.lowerCaseVars=function(a){this[a]&&("events"!==a&&-1===a.indexOf("contextData")?(this[a]=this[a].toString(),0!==this[a].indexOf("D=")&&(this[a]=this[a].toLowerCase())):-1<a.indexOf("contextData")&&(a=a.substring(a.indexOf(".")+1),this.contextData[a]&&(this.contextData[a]=this.contextData[a].toString().toLowerCase())))};f.cleanStr=function(a){function b(a){if("string"===typeof a){for(a=a.replace(/<\/?[^>]+(>|$)/g,"").trim().replace(/[\u2018\u2019\u201A]/g,"'").replace(/\t+/g,"").replace(/[\n\r]/g," ");-1<a.indexOf("  ");)a=a.replace(/\s\s/g," ");return a}return""}this[a]&&"function"===typeof b&&(0>a.indexOf("contextData")?this[a]=b(this[a]):(a=a.substring(a.indexOf(".")+1),this.contextData[a]&&(this.contextData[a]=b(this.contextData[a].toString()))))};f.pt=function(a,b,c,d){if(a&&this[c]){a=a.split(b||",");b=a.length;for(var e,f=0;f<b;f++)if(e=this[c](a[f],d))return e}};if(!f[g])return!1;c=c||"";d=d||!0;var b,e="pageName,purchaseID,channel,server,pageType,campaign,state,zip,events,products,transactionID";for(b=1;76>b;b++)e+=",prop"+b;for(b=1;251>b;b++)e+=",eVar"+b;for(b=1;6>b;b++)e+=",hier"+b;for(b=1;4>b;b++)e+=",list"+b;for(b in f.contextData)e+=",contextData."+b;if(c){if(1==d)e=c.replace("['",".").replace("']","");else if(0==d){c=c.split(",");d=e.split(",");e="";for(x in c)for(y in-1<c[x].indexOf("contextData")&&(c[x]="contextData."+c[x].split("'")[1]),d)c[x]===d[y]&&(d[y]="");for(y in d)e+=d[y]?","+d[y]:""}f.pt(e,",",g,0);return!0}return""===c&&d?(f.pt(e,",",g,0),!0):!1}};
/******************************************** END CODE TO DEPLOY ********************************************/

플러그인 사용

manageVars 함수에서는 다음 인수를 사용합니다.

  • cb (필수, 문자열): 플러그인이 Analytics 변수를 조작하는 데 사용하는 콜백 함수의 이름입니다. cleanStr과 같은 Adobe 기능이나 사용자 지정 기능을 사용할 수 있습니다.

  • l (선택 사항, 문자열): 조작하려는 Analytics 변수의 쉼표로 구분된 목록입니다. 설정하지 않으면 기본값은 다음을 포함한 모든 Adobe Analytics 변수로 설정됩니다.

    • pageName
    • purchaseID
    • channel
    • server
    • pageType
    • campaign
    • state
    • zip
    • events
    • products
    • transactionID
    • 모든 prop
    • 모든 eVar
    • 모든 계층 변수
    • 모든 목록 변수
    • 모든 컨텍스트 데이터 변수

  • Il (선택 사항, 부울): l 인수에 선언된 변수 목록을 포함하지 않고 제외 ​하려면 false로 설정하십시오. 기본값은 true입니다.

이 함수를 호출하면 아무 것도 반환되지 않습니다. 대신 원하는 콜백 함수를 기반으로 Analytics 변수의 값을 변경합니다.

호출 예

예 #1

다음 코드…

manageVars("lowerCaseVars");

…은 위에서 설명한 모든 변수의 값을 소문자로 변경합니다. 일부 이벤트 (예: scAdd, scCheckout 등)는 대/소문자를 구분하며 소문자를 사용하지 않아야 하므로 위 코드에 대한 유일한 예외는 events 변수입니다.

예 #2

다음 코드…

manageVars("lowerCaseVars", "events", false);

…은 기본적으로 events 변수가 소문자화되지 않으므로 첫 번째 예와 동일한 결과를 생성합니다.

예 #3

다음 코드…

manageVars("lowerCaseVars", "eVar1,eVar2,eVar3,list2");

…은 eVar1, eVar2, eVar3 및 list2의 값만 변경합니다(예: 소문자).

예 #4

다음 코드…

manageVars("lowerCaseVars", "eVar1,eVar2,eVar3,list2", false);

…은 eVar1, eVar2, eVar3 및 list2를 제외하고 위에 설명된 모든 변수의 값을 변경합니다(예: 소문자).

예 #5

다음 코드…

manageVars("cleanStr");

…은 events 변수를 포함하여 위에 설명된 모든 변수의 값을 변경합니다. 특히 cleanStr 콜백 함수는 각 변수의 값에 대해 다음을 수행합니다.

  • HTML 인코딩 제거
  • 값의 시작과 끝에 있는 공백 제거
  • 왼쪽/오른쪽 작은 따옴표를 곧은 작은 따옴표(')
  • 탭 문자, 줄바꿈 문자 및 캐리지 리턴 문자를 공백으로 바꾸기
  • 모든 이중 (또는 삼중 등) 공백을 단일 공백으로 바꾸기

버전 내역

3.0 (2021년 3월 19일)

  • 버전 번호를 컨텍스트 데이터로 추가했습니다.

2.1 (2019년 1월 14일)

  • Internet Explorer 11 브라우저에 대한 버그 수정.
  • s.cleanStr에 대한 변경 사항 - 이제 일반적인 cleanStr 함수를 사용합니다.

2.0 (2018년 5월 7일)

  • 포인트 릴리스 (플러그인의 전체 재분석/다시 작성 포함)
  • cleanStr 콜백 함수를 추가했습니다.
recommendation-more-help
b4f6d761-4a8b-4322-b801-c85b9e3be690