Adobe 플러그인: pt

pt 플러그인은 Analytics 변수 목록에서 함수나 메서드를 실행합니다. 예를 들어 매번 수동으로 함수를 호출하지 않고 몇 개의 변수에서 clearVars 함수를 선택적으로 실행할 수 있습니다. 몇 가지 다른 플러그인은 이 코드를 사용하여 올바로 실행됩니다. 한 번에 두 개 이상의 Analytics 변수에서 특정 함수를 실행할 필요가 없거나 종속 플러그인을 사용하지 않는 경우에는 이 플러그인이 필요하지 않습니다.

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

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

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

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

1. AdobeID 자격 증명을 사용하여 Adobe Experience Platform 데이터 수집에 로그인합니다.
2. 원하는 태그 속성을 클릭합니다.
3. 확장 탭으로 이동한 다음, 카탈로그 버튼을 클릭합니다.
4. 일반적인 Analytics 플러그인 확장 기능을 설치 및 게시합니다.
5. 아직 없다면 다음 구성으로 "플러그인 초기화"라는 레이블이 지정된 규칙을 만듭니다.
   • 조건: 없음
   • 이벤트: 핵심 - 라이브러리가 로드됨 (페이지 상단)
6. 다음 구성으로 위의 규칙에 작업을 추가합니다.
   • 확장: 일반적인 Analytics 플러그인
   • 작업 유형: pt 초기화
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: pt v3.0 */
function pt(l,de,cf,fa){var b=l,d=de,f=cf,g=fa;if("-v"===b)return{plugin:"pt",version:"3.0"};a:{if("undefined"!==typeof window.s_c_il){var a=0;for(var c;a<window.s_c_il.length;a++)if(c=window.s_c_il[a],c._c&&"s_c"===c._c){a=c;break a}}a=void 0}if("undefined"!==typeof a&&(a.contextData.pt="3.0",b&&a[f])){b=b.split(d||",");d=b.length;for(var e=0;e<d;e++)if(c=a[f](b[e],g))return c}};
/******************************************** END CODE TO DEPLOY ********************************************/

플러그인 사용

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

• l (필수, 문자열): 인수에 cf 포함된 함수가 실행할 수 있는 변수의 목록입니다.
• de (선택 사항, 문자열): l 인수의 변수 목록을 구분하는 구분 기호입니다. 기본값은 쉼표(,)입니다.
• cf (필수, 문자열): l 인수에 포함된 각 변수에 대해 호출할 AppMeasurement 개체에 포함된 콜백 함수의 이름입니다.
• fa (선택 사항, 문자열): cf 인수의 함수가 실행될 때 이 함수가 추가적인 인수를 호출하는 경우 해당 인수를 여기에 포함하십시오. 기본값은 undefined입니다.

이 함수를 호출하면 cf 인수에서 콜백 함수가 값을 반환하는 경우 값이 반환됩니다.

호출 예

예 #1

다음 코드는 getQueryParam 플러그인의 일부입니다. 이 코드는 URL의 쿼리 문자열(fullQueryString)에 들어 있는 각 키-값 쌍에 대해 getParameterValue 도우미 함수를 실행합니다. 각 키-값 쌍을 추출하려면 fullQueryString을 앰퍼샌드 "&" 문자로 구분하여 분리해야 합니다. parameterKey는 플러그인이 쿼리 문자열에서 특별히 추출하려고 하는 쿼리 문자열 매개 변수를 참조합니다.

returnValue = pt(fullQueryString, "&", "getParameterValue", parameterKey)

위의 줄은 다음과 유사한 코드를 실행하는 간단한 방법입니다.

var returnValue = "",
  parameters = fullQueryString.split("&"),
  parametersLength = parameters.length;
for(var i = 0; i < parametersLength; i++)
{
  returnValue = getParameterValue(parameters[i], parameterKey);
  if(returnValue !== "") break;
}

버전 내역

3.0 (2021년 3월 19일)

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

2.01 (2019년 9월 24일)

• 전체 크기를 줄이기 위한 작은 코드 변경

2.0 (2018년 4월 17일)

• 포인트 릴리스 (다시 컴파일됨, 더 작은 코드 크기).
• H-코드 및 AppMeasurement 모두에 대한 지원을 추가했습니다.

1.0 (2013년 9월 23일)

• 초기 릴리스.