응답 토큰을 사용하면 Adobe Target과(와) 관련된 정보를 브랜드 웹 페이지에 자동으로 출력할 수 있습니다. 이 정보에는 활동, 오퍼, 경험, 사용자 프로필, 지역 정보 등에 대한 세부 사항이 포함될 수 있습니다. 이러한 세부 정보는 내부 또는 타사 도구와 공유하거나 디버깅에 사용할 추가 응답 데이터를 제공합니다.
응답 토큰을 사용하면 사용할 변수(키 값 쌍)를 선택한 다음 Target 응답의 일부로 전송할 수 있습니다. 스위치를 사용하여 변수를 활성화하면 Target 응답이 있는 상태로 변수가 전송되며, 이 응답은 네트워크 호출에서 확인할 수 있습니다. 응답 토큰은 Preview 모드에서도 작동합니다.
플러그인과 응답 토큰 간의 주요 차이점은 플러그인이 전달 시 실행되는 페이지에 JavaScript을 전달한다는 것입니다. 그러나 응답 토큰은 이벤트 리스너를 사용할 때 읽고 작용할 수 있는 개체를 전달합니다. 응답 토큰 접근 방식은 더 안전하며 타사 통합을 보다 쉽게 개발하고 유지 관리할 수 있도록 해줍니다.
Platform Web SDK 버전 2.6.0 이상을 사용 중인지 확인하십시오. 최신 버전의 Platform Web SDK을 다운로드하는 방법에 대한 자세한 내용은 Platform Web SDK 개요 안내서에서 SDK 설치를 참조하십시오. Platform Web SDK의 각 버전에 대한 새로운 기능은 Platform Web SDK 개요 안내서의 릴리스 정보를 참조하십시오.
at.js 버전 1.1 이상을 사용 중인지 확인하십시오. 최신 버전의 at.js 다운로드에 대한 자세한 내용은 at.js 다운로드를 참조하십시오. 각 at.js 버전의 새로운 기능에 대한 자세한 내용은 at.js 버전 세부 사항을 참조하십시오. at.js를 사용하는 고객은 응답 토큰을 사용하고 플러그인을 사용하지 않는 것이 좋습니다. mbox.js(사용 중단됨)에는 존재했지만 at.js에는 존재하지 않는 내부 메서드에 의존하는 일부 플러그인은 전달되지만 실패합니다.
응답 토큰 사용 section_A9E141DDCBA84308926E68D05FD2AC62
Platform Web SDK 버전 2.6.0 이상 또는 at.js 버전 1.1 이상을 사용 중인지 확인하십시오.
추가 정보:
Platform Web SDK: Platform Web SDK 개요 안내서의 SDK 설치를 참조하십시오.
Target Administrator 역할을 가진 사용자만 응답 토큰을 활성화하거나 비활성화할 수 있습니다.
실행 중인 Platform Web SDK 2.6.0(또는 이전 버전)의 경우 어떻게 됩니까?
응답 토큰에 대한 액세스 권한이 없습니다.
at.js 1.0(또는 이전 버전)을 실행하는 경우 어떻게 됩니까?
응답 토큰이 표시되지만 at.js는 이를 사용할 수 없습니다.
Target Classic 플러그인과 응답 토큰을 동시에 활성화할 수 있습니까?
플러그인과 응답 토큰을 동시에 사용할 수 있습니다. 그러나 플러그인은 향후 더 이상 사용되지 않습니다.
모든 Target 응답을 통해 응답 토큰이 전달됩니까? 아니면 Target 응답에서만 활동을 전달합니까?
응답 토큰은 활동을 전달하는 Target개의 응답을 통해서만 전달됩니다.
내 Target Classic 플러그 인에 JavaScript이 포함되었습니다. 응답 토큰을 사용하여 해당 기능을 복제하려면 어떻게 해야 합니까?
응답 토큰으로 마이그레이션할 때 이러한 유형의 JavaScript은 코드 베이스 또는 태그 관리 솔루션에 유지되어야 합니다. Platform Web SDK 또는 at.js 사용자 지정 이벤트를 사용하여 이 코드를 트리거하고 응답 토큰 값을 JavaScript 함수에 전달할 수 있습니다.
내 프로필/고객 속성 매개 변수가 응답 토큰 목록에 표시되지 않는 이유는 무엇입니까?
Target은(는) 일반적으로 15분마다 매개 변수를 새로 고칩니다. 이 새로 고침은 사용자 작업에 따라 다르며 응답 토큰 페이지를 볼 때만 데이터가 새로 고쳐집니다. 매개 변수가 응답 토큰 목록에 표시되지 않으면 Target에서 데이터를 아직 새로 고치지 않았습니다.
또한 매개 변수에 영숫자가 아닌 문자나 밑줄 이외의 기호가 포함되어 있으면 매개 변수가 목록에 표시되지 않습니다. 현재 영숫자와 밑줄 문자만 지원됩니다.
응답 토큰이 삭제된 프로필 스크립트나 프로필 매개 변수를 사용하는 경우에도 콘텐츠를 전달합니까?
응답 토큰은 사용자 프로필에서 정보를 추출한 후에 전달합니다. 프로필 스크립트 또는 매개 변수를 삭제해도 사용자 프로필에서 해당 정보가 제거되지 않습니다. 사용자 프로필에는 프로필 스크립트에 해당하는 데이터가 여전히 있습니다. 응답 토큰은 콘텐츠를 계속 전달합니다. 프로필에 해당 정보가 저장되어 있지 않은 사용자 또는 새 방문자의 경우 데이터가 프로필에 없으므로 해당 토큰이 전달되지 않습니다.
Target은(는) 토큰을 자동으로 해제하지 않습니다. 프로필 스크립트를 삭제하고 토큰을 더 이상 전달하지 않으려면 토큰을 직접 해제해야 합니다.
프로필 스크립트의 이름을 바꾸었는데 해당 스크립트를 사용하는 토큰이 여전히 이전 이름으로 활성 상태인 이유는 무엇입니까?
위에서 언급한 대로 응답 토큰은 사용자에 따라 저장된 프로필 정보에 적용됩니다. 프로필 스크립트의 이름을 변경했지만 웹 사이트를 방문한 사용자의 프로필에 이전 프로필 스크립트 값이 저장됩니다. 토큰은 사용자 프로필에 이미 저장된 이전 값을 계속 선택합니다. 이제 새 이름으로 컨텐츠를 전달하려면 이전 토큰을 해제하고 새 토큰을 설정해야 합니다.
내 특성이 변경된 경우 해당 특성은 언제 목록에서 제거됩니까?
Target은(는) 정기적으로 특성을 새로 고칩니다. 켜지지 않는 속성은 다음 새로 고침 중에 제거됩니다. 그러나 전환된 속성이 제거되어 있는 경우 해당 스크립트를 해제할 때까지 속성 목록에서 제거되지 않습니다. 예를 들어 토큰으로 사용된 프로필 스크립트를 제거했습니다. Target은(는) 삭제되거나 이름이 바뀌는 경우 목록에서 전환된 속성만 제거합니다.
Google Analytics에게 데이터 보내기
다음 섹션에서는 Target 데이터를 Google Analytics 4로 보내는 방법을 설명합니다. 응답 토큰으로 전송된 데이터를 다른 타사 통합으로 전송할 수도 있습니다.
Platform Web SDK을 통해 Google Analytics에게 데이터 전송
Google Analytics은 HTML 페이지에 다음 코드를 추가하여 Platform Web SDK 버전 2.6.0 이상을 통해 데이터를 보낼 수 있습니다.
at.js를 통해 Google Analytics에게 데이터 보내기 section_04AA830826D94D4EBEC741B7C4F86156
at.js를 통해 HTML 페이지에 다음 코드를 추가하여 Google 애널리틱스에 데이터를 전송할 수 있습니다.
<script async src="https://www.googletagmanager.com/gtag/js?id=TAG_ID"></script>
<script type="text/javascript">
document.addEventListener(adobe.target.event.REQUEST_SUCCEEDED, function(e) {
var tokens = e.detail.responseTokens;
if (isEmpty(tokens)) {
return;
}
var activityNames = [];
var experienceNames = [];
var uniqueTokens = distinct(tokens);
uniqueTokens.forEach(function(token) {
activityNames.push(token["activity.name"]);
experienceNames.push(token["experience.name"]);
});
gtag('config', 'TAG_ID');
gtag('event', 'action_name', {'eventCategory': 'target',
'eventAction': experienceNames, 'eventLabel': activityNames
});
});
function isEmpty(val) {
return (val === undefined || val == null || val.length <= 0) ? true : false;
}
function key(obj) {
return Object.keys(obj)
.map(function(k) { return k + "" + obj[k]; })
.join("");
}
function distinct(arr) {
var result = arr.reduce(function(acc, e) {
acc[key(e)] = e;
return acc;
}, {});
return Object.keys(result)
.map(function(k) { return result[k]; });
}
</script>
디버깅
다음 섹션에서는 응답 토큰 디버깅에 대한 정보를 제공합니다.
Google Analytics 및 디버깅
다음 코드를 사용하면 Google Analytics을 사용하여 디버그할 수 있습니다.
<script async src="https://www.googletagmanager.com/gtag/js?id=TAG_ID"></script>
<script type="text/javascript">
document.addEventListener(adobe.target.event.REQUEST_SUCCEEDED, function(e) {
var tokens = e.detail.responseTokens;
if (isEmpty(tokens)) {
return;
}
var activityNames = [];
var experienceNames = [];
var uniqueTokens = distinct(tokens);
uniqueTokens.forEach(function(token) {
activityNames.push(token["activity.name"]);
experienceNames.push(token["experience.name"]);
});
gtag('config', 'TAG_ID');
gtag('event', 'action_name', {'eventCategory': 'target',
'eventAction': experienceNames, 'eventLabel': activityNames
});
});
function isEmpty(val) {
return (val === undefined || val == null || val.length <= 0) ? true : false;
}
function key(obj) {
return Object.keys(obj)
.map(function(k) { return k + "" + obj[k]; })
.join("");
}
function distinct(arr) {
var result = arr.reduce(function(acc, e) {
acc[key(e)] = e;
return acc;
}, {});
return Object.keys(result)
.map(function(k) { return result[k]; });
}
</script>
ttMeta 플러그인과 동등한 기능을 사용하여 디버깅
디버깅 목적의 ttMeta 플러그인과 동등한 기능은 HTML 페이지에 다음 코드를 추가하여 만들 수 있습니다.
<script type="text/javascript" >
document.addEventListener(adobe.target.event.REQUEST_SUCCEEDED, function (e) {
window.ttMETA= typeof(window.ttMETA)!="undefined" ? window.ttMETA : [];
var tokens=e.detail.responseTokens;
if (isEmpty(tokens)) {
return;
}
var uniqueTokens = distinct(tokens);
uniqueTokens.forEach(function(token) {
window.ttMETA.push({
'CampaignName': token["activity.name"],
'CampaignId' : token["activity.id"],
'RecipeName': token["experience.name"],
'RecipeId': token["experience.id"],
'OfferId': token["offer.id"],
'OfferName': token["offer.name"],
'MboxName': e.detail.mbox});
console.log(ttMETA);
});
});
function isEmpty(val){
return (val === undefined || val == null || val.length <= 0) ? true : false;
}
function key(obj) {
return Object.keys(obj)
.map(function(k) { return k + "" + obj[k]; })
.join("");
}
function distinct(arr) {
var result = arr.reduce(function(acc, e) {
acc[key(e)] = e;
return acc;
}, {});
return Object.keys(result)
.map(function(k) { return result[k]; });
}
</script>
교육 비디오: 응답 토큰 및 at.js 사용자 지정 이벤트 section_3AA0A6C8DBD94A528337A2525E3E05D5
다음 비디오에서는 응답 토큰 및 at.js 사용자 지정 이벤트를 사용하여 Target에서 타사 시스템으로 프로필 정보를 공유하는 방법을 설명합니다.
NOTE
Target Administration 메뉴 UI(이전 Setup)는 향상된 성능을 제공하고, 새로운 기능을 출시할 때 필요한 유지 관리 시간을 줄이고, 제품 전반에 걸쳐 사용자 경험을 개선할 수 있도록 새롭게 디자인되었습니다. 다음 비디오의 정보는 정확하지만 옵션이 약간 다른 위치에 있습니다.
비디오에는 각각 offer.name 및 offer.id(으)로 바뀐 option.name 및 option.id이(가) 언급되어 있습니다.