Adobe 플러그인: getAndPersistValue

getAndPersistValue 플러그인을 사용하면 방문 중에 나중에 검색할 수 있는 쿠키에 값을 저장할 수 있습니다. 이 플러그인은 Adobe Experience Platform Launch의 저장 유지 시간 기능과 유사한 역할을 합니다. 변수가 설정된 후 Analytics 변수를 후속 히트에서 동일한 값으로 자동으로 유지하려면 이 플러그인을 사용하는 것이 좋습니다. Launch의 저장 유지 시간 기능이 충분하거나, 변수를 후속 히트에서 동일한 값으로 설정하여 유지할 필요가 없는 경우에는 이 플러그인이 필요하지 않습니다. eVar 변수는 Adobe에 의해 서버측에서 지속되므로 이 변수의 기본적인 지속성에서는 이 플러그인을 사용할 필요가 없습니다.

Adobe Experience Platform Launch 확장 기능을 사용하여 플러그인 설치

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

1. AdobeID 자격 증명을 사용하여 launch.adobe.com에 로그인합니다.
2. 원하는 속성을 클릭합니다.
3. 확장 탭으로 이동한 다음, 카탈로그 버튼을 클릭합니다.
4. 일반적인 Analytics 플러그인 확장 기능을 설치 및 게시합니다.
5. 아직 없다면 다음 구성으로 "플러그인 초기화"라는 레이블이 지정된 규칙을 만듭니다.
   • 조건: 없음
   • 이벤트: 핵심 - 라이브러리가 로드됨 (페이지 상단)
6. 다음 구성으로 위의 규칙에 작업을 추가합니다.
   • 확장: 일반적인 Analytics 플러그인
   • 작업 유형: getAndPersistValue 초기화
7. 변경 사항을 저장하고 규칙에 게시합니다.

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

플러그인 확장 기능을 사용하지 않으려는 경우 사용자 지정 코드 편집기를 사용할 수 있습니다.

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

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

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

/******************************************* BEGIN CODE TO DEPLOY *******************************************/
/* Adobe Consulting Plugin: getAndPersistValue v3.0 (Requires AppMeasurement) */
function getAndPersistValue(vtp,cn,ex){var d=vtp,k=cn,l=ex;if("undefined"!==typeof d&&"-v"===d)return{plugin:"getAndPersistValue",version:"3.0"};var a=function(){if("undefined"!==typeof window.s_c_il)for(var c=0,b;c<window.s_c_il.length;c++)if(b=window.s_c_il[c],b._c&&"s_c"===b._c)return b}();"undefined"!==typeof a&&(a.contextData.getAndPersistValue="3.0");window.cookieWrite=window.cookieWrite||function(c,b,f){if("string"===typeof c){var h=window.location.hostname,a=window.location.hostname.split(".").length-1;if(h&&!/^[0-9.]+$/.test(h)){a=2<a?a:2;var e=h.lastIndexOf(".");if(0<=e){for(;0<=e&&1<a;)e=h.lastIndexOf(".",e-1),a--;e=0<e?h.substring(e):h}}g=e;b="undefined"!==typeof b?""+b:"";if(f||""===b)if(""===b&&(f=-60),"number"===typeof f){var d=new Date;d.setTime(d.getTime()+6E4*f)}else d=f;return c&&(document.cookie=encodeURIComponent(c)+"="+encodeURIComponent(b)+"; path=/;"+(f?" expires="+d.toUTCString()+";":"")+(g?" domain="+g+";":""),"undefined"!==typeof cookieRead)?cookieRead(c)===b:!1}};window.cookieRead=window.cookieRead||function(c){if("string"===typeof c)c=encodeURIComponent(c);else return"";var b=" "+document.cookie,a=b.indexOf(" "+c+"="),d=0>a?a:b.indexOf(";",a);return(c=0>a?"":decodeURIComponent(b.substring(a+2+c.length,0>d?b.length:d)))?c:""};a=new Date;k=k?k:"s_gapv";(l=l?l:0)?a.setTime(a.getTime()+864E5*l):a.setTime(a.getTime()+18E5);"undefined"!==typeof d&&d||(d=cookieRead(k));cookieWrite(k,d,a);return d};
/******************************************** END CODE TO DEPLOY ********************************************/

플러그인 사용

getAndPersist 메서드에서는 다음 인수를 사용합니다.

• vtp (필수): 페이지에서 페이지로 유지할 값입니다.
• cn (선택 사항): 값을 저장할 쿠키의 이름입니다. 이 인수를 설정하지 않으면 쿠키의 이름이 "s_gapv"로 지정됩니다.
• ex (선택 사항): 쿠키가 만료될 때까지 남은 일 수입니다. 이 인수가 0이거나 설정되지 않으면 방문이 끝날 때 (30분 동안 활동이 없음) 쿠키가 만료됩니다.

vtp 인수의 변수가 설정되면 플러그인은 쿠키를 설정한 후 쿠키 값을 반환합니다. vtp 인수의 변수가 설정되지 않으면 플러그인은 쿠키 값 반환만 수행합니다.

예

예 #1

다음 코드는 eVar21을 "hello"라는 값과 동일하게 설정합니다. 그러면 이 코드는 28일 후에 만료되고 eVar21의 값과 같은 ev21gapv 쿠키를 설정합니다 (즉, "hello"). 그러면 코드는 eVar21을 ev21gapv 쿠키의 값과 동일하게 (재)설정합니다.

s.eVar21 = "hello";
s.eVar21 = s.getAndPersistValue(s.eVar21,"ev21gapv",28);

예 #2

eVar21이 현재 페이지에 아직 설정되지 않았지만 지난 28일 내에 이전 페이지에서 "hello"로 설정되었다고 가정하십시오. 다음 코드는 eVar21만을 ev21gapv 쿠키의 값 (즉, "hello")과 동일하게 설정합니다. eVar21이 함수가 호출되기 전에 현재 페이지에서 설정되지 않았으므로 이 코드를 실행해도 ev21gapv 쿠키가 재설정되지는 않습니다.

s.eVar21 = s.getAndPersistValue(s.eVar21,"ev21gapv",28);

예 #3

eVar21이 현재 페이지에 아직 설정되지 않았지만 지난 28일 내에 이전 페이지에서 "hello"로 설정되었다고 가정하십시오. 다음 코드는 prop35만을 ev21gapv 쿠키의 값 (즉, "hello")과 동일하게 설정합니다. eVar21은 설정하지 않습니다.

s.prop35 = s.getAndPersistValue(s.eVar21,"ev21gapv",28);

예 #4

다음 코드는 eVar21을 "howdy"라는 값과 동일하게 설정합니다. 그러면 이 코드는 28일 후에 만료되고 eVar21의 값과 같은 ev21gapv 쿠키를 설정 (또는 재설정)합니다 (즉, "howdy"). 그런 다음 이 코드는 prop35를 ev21gapv 쿠키의 값 (즉, "howdy")과 동일하게 설정합니다.

s.eVar21 = "howdy";
s.prop35 = s.getAndPersistValue(s.eVar21,"ev21gapv",28);

예 #5

s.eVar21이 지난 28일 내에 어떤 페이지에서도 설정되지 않았다고 가정하십시오. 다음 코드는 ev21gapv 쿠키가 마지막으로 설정되고 28일 후 만료되었으므로 s.eVar21을 nothing과 동일하게 설정합니다.

s.eVar21 = s.getAndPersistValue(s.eVar21,"ev21gapv",28);

예 #6

다음 코드는 eVar30을 "shopping"과 동일하게 설정합니다. 그런 다음, 브라우저 세션이 끝날 때 만료되는 s_gapv 쿠키를 s.eVar30의 값과 동일하게 설정합니다 (즉, "shopping"). 그런 다음 s.eVar30을 s_gapv 쿠키의 값과 동일하게 설정합니다 (즉, getAndPersistValue 호출은 s_gapv 쿠키의 값을 반환하며, 이 경우 그 값은 "shopping").

s.eVar30 = "shopping";
s.eVar30 = s.getAndPersistValue(s.eVar30);

s.eVar30이 세션 중에 표시되는 추가 페이지에 명시적 값으로 설정되어 있지 않지만 다음 코드를 통해 설정되는 경우 (doPlugins에서)…

s.eVar30 = s.getAndPersistValue(s.eVar30);

…s.eVar30은 "shopping" (즉, s_gapv 쿠키의 지속적인 값)으로 설정됩니다.

버전 내역

3.0 (2021년 3월 19일)

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

2.0 (2018년 4월 16일)

• 포인트 릴리스 (작은 코드 크기)
• 이제 0을 ex 인수에 전달하면 브라우저 세션이 끝날 때 만료되지 않고 30분 동안 아무 활동이 없으면 만료가 강제 적용됩니다.

1.0 (2016년 1월 18일)

• 초기 릴리스.