응답 토큰

응답 토큰을 사용하면 다음과 같은 특정 정보를 자동으로 출력할 수 있습니다 Adobe Target 브랜드 웹 페이지에 액세스합니다. 이 정보에는 활동, 오퍼, 경험, 사용자 프로필, 지역 정보 등에 대한 세부 사항이 포함될 수 있습니다. 이러한 세부 사항은 내부 또는 타사 도구와 공유하거나 디버깅에 사용할 추가 응답 데이터를 제공합니다.

응답 토큰을 사용하면 사용할 변수(키 값 쌍)를 선택한 다음 변수의 일부로 전송할 수 있습니다 Target 응답합니다. 스위치를 사용하여 변수를 활성화하면 변수가 Target 응답입니다. 이는 네트워크 호출에서 확인할 수 있습니다. 응답 토큰은 에서도 작동합니다 미리 보기 모드.

플러그인과 응답 토큰 간의 주요 차이점은 플러그인이 전달 시 실행되는 페이지에 JavaScript를 전달한다는 것입니다. 그러나 응답 토큰은 이벤트 리스너를 사용하여 읽고 작업할 수 있는 개체를 전달합니다. 응답 토큰 접근 방식은 더 안전하며 타사 통합을 보다 쉽게 개발하고 유지 관리할 수 있도록 해줍니다.

노트

at.js 버전 1.1 이상에서 응답 토큰을 사용할 수 있습니다.

Target SDK 제안된 작업
Adobe Experience Platform Web SDK Platform Web SDK 버전 2.6.0 이상을 사용 중인지 확인하십시오. 최신 버전의 Platform Web SDK를 다운로드하는 방법에 대한 자세한 내용은 SDK 설치Platform Web SDK 개요 안내서. 각 버전의 Platform Web SDK의 새로운 기능에 대한 내용은 릴리스 노트 에서 Platform Web SDK 개요 안내서.
at.js at.js 버전 1.1 이상을 사용 중인지 확인하십시오. 최신 버전의 at.js를 다운로드하는 방법에 대해서는 를 참조하십시오 at.js 다운로드 를 참조하십시오. 각 at.js 버전의 새로운 기능에 대한 내용은 at.js 버전 세부 사항.
at.js를 사용하는 고객은 응답 토큰을 사용하고 플러그인을 사용하지 않는 것이 좋습니다. mbox.js에 존재했지만 (이제 사용되지 않음) at.js에는 존재하지 않았던 내부 메서드에 의존하는 일부 플러그인은 전달되지만 실패합니다.

응답 토큰 사용

  1. Platform Web SDK 버전 2.6.0 이상 또는 at.js 버전 1.1 이상을 사용 중인지 확인하십시오.

    자세한 내용을 확인하십시오:

  2. in Target를 클릭합니다. 관리 > 응답 토큰.

  3. 다음과 같이 원하는 응답 토큰을 활성화합니다 activity.idoffer.id.

    기본적으로 다음 매개 변수를 사용할 수 있습니다.

    유형 매개 변수 참고
    내장 프로필 profile.activeActivities 방문자가 자격을 갖는 일련의 activityIds를 반환합니다. 사용자가 자격을 갖게 됨에 따라 증가합니다. 예를 들어, 두 개의 페이지가 있는 경우 Target 두 번째 요청에는 두 개의 다른 활동을 전달하는 요청이 모두 포함됩니다.
    profile.isFirstSession "true" 또는 "false"를 반환합니다.
    profile.isNewSession "true" 또는 "false"를 반환합니다.
    profile.daysSinceLastVisit 방문자가 마지막으로 방문한 이후 경과한 일수를 반환합니다.
    profile.tntId 방문자의 tntID를 반환합니다.
    profile.marketingCloudVisitorId 방문자의 Experience Cloud 방문자 ID를 반환합니다.
    profile.thirdPartyId 방문자의 타사 ID를 반환합니다.
    profile.categoryAffinity 방문자가 즐겨 찾는 카테고리를 반환합니다.
    profile.categoryAffinities 방문자의 상위 5개 카테고리의 배열을 문자열로 반환합니다.
    활동 activity.name
    activity.id
    experience.name
    experience.id
    offer.name
    offer.id
    현재 활동의 세부 사항입니다.
    오퍼 매개 변수의 값은 경험 수준에서 평가됩니다.
    지역 geo.country
    geo.state
    geo.city
    geo.zip
    geo.dma
    geo.domainName
    geo.ispName
    geo.connectionSpeed
    geo.mobileCarrier
    활동에서 지역 기반의 타깃팅을 사용하는 방법에 대한 자세한 내용은 지역을 참조하십시오.
    트래픽 할당 방법
    (적용 대상 자동 Target 및 Automated Personalization 활동 전용.)
    experience.trafficAllocationId 방문자가 "제어" 트래픽에서 경험을 받은 경우 0을 반환하고, 방문자가 "타깃팅된" 트래픽 배포에서 경험을 받은 경우 1을 반환합니다.
    experience.trafficAllocationType "control" 또는 "targeted"를 반환합니다.

    사용자 프로필 속성 및 고객 속성도 목록에 표시됩니다.

    노트

    특수 문자가 있는 매개 변수는 목록에 표시되지 않습니다. 영숫자 문자 및 밑줄만 지원됩니다.

  4. (조건부) 프로필 매개 변수를 응답 토큰으로 사용하기 위해 매개 변수가 Target 요청 및 이 Target UI를 사용하여 응답 토큰 추가 UI에 프로필을 추가하는 단추.

    클릭 응답 토큰 추가​에서 토큰 이름을 제공한 다음, 활성화.

  5. 활동을 만듭니다.

응답 수신 및 응답 토큰 읽기

수신 대기하는 데 사용하는 프로세스입니다 Target 응답 및 읽기 응답 토큰은 있는지 여부에 따라 다릅니다 Platform Web SDK 또는 at.js 구현을 참조하십시오.

Adobe Experience Platform 웹 SDK 배지 Platform Web SDK Handle 개체 클래스 사용

Handle 객체 클래스를 사용합니다. 이 클래스는 메타 데이터 개체와 수신할 데이터 개체가 있습니다 Target 응답 및 응답 토큰 읽기

다음 응답 예는 를 추가합니다 Platform Web SDK 사용자 지정 이벤트 핸들러를 HTML 페이지에 직접 추가합니다. 이 표에서는 코드에 사용된 개체에 대해 설명합니다.

개체 정보
유형 - Personalization.decision 그 결정이 Target 또는 Offer decisioning 공급자.
의사 결정 공급자 - TGT TGT-Target. Target 페이지에 응답 토큰 메타데이터 및 값을 제공합니다.
메타 페이지에 전달되는 메타데이터입니다.
데이터 페이지에 전달된 메타데이터의 값입니다.
<html>

<head>
 ...
 <script src="alloy.js"></script>
 <script>
  {
   "requestId": "4d0a7cfd-952c-408c-b3b8-438edc38250a",
   "handle": [{
    "type": "personalization:decisions",
    "payload": [{
     "id": "....",
     "scope": "__view__",
     "scopeDetails": {
      "decisionProvider": "TGT",
      "activity": {
       "id": "..."
      },
      "experience": {
       "id": "...."
      }
     },
     "items": [{
      "id": "123",
      "schema": "https://ns.adobe.com/personalization/dom-action",
      "meta": {
       "activity.id": "...",
       "activity.name": "...",
       "profile.foo": "...",
       "profile.bar": "..."
      },
      "data": {
       "id": "123",
       "type": "setHtml",
       "selector": "#foo",
       "prehidingSelector": "#foo",
       "content": "<div>Hello world</div>"
      }
     }]
    }]
   }]
  }
  });
 </script>
</head>

<body>
 ...
</body>

</html>

at.js 배지 사용자 지정 이벤트를 사용하는 at.js

사용 at.js 사용자 지정 이벤트에서 수신 대기 Target 응답하고 응답 토큰을 읽습니다.

다음 코드 샘플은 at.js 사용자 지정 이벤트 핸들러를 HTML 페이지에 바로 추가합니다.

<html>
  <head>
    ....
    <script src="at.js"></script>
    <script>
      document.addEventListener(adobe.target.event.REQUEST_SUCCEEDED, function(e) {
        console.log("Request succeeded", e.detail);
      });
    </script>
  <head>
  <body>
  ...
  </body>
</html>

응답 토큰 FAQ

응답 토큰을 활성화하거나 비활성화하는 데 필요한 역할은 무엇입니까?

응답 토큰은 Target 관리자 역할.

내가 실행 중이면 어떻게 되지? 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에 데이터를 추가합니다. 응답 토큰으로 전송된 데이터는 다른 타사 통합에도 전송될 수 있습니다.

AEP 배지 Platform Web SDK를 통해 Google Analytics에게 데이터 보내기

Google Analytics 페이지에 다음 코드를 추가하여 Platform Web SDK 버전 2.6.0 이상을 통해 데이터를 전송할 수 있습니다.

노트

응답 토큰 키 값 쌍이 alloy(“sendEvent” 개체.

<script type="text/javascript">
   (function(i, s, o, g, r, a, m) {
   i['GoogleAnalyticsObject'] = r;
   i[r] = i[r] || function() {
   (i[r].q = i[r].q || []).push(arguments)
   }, i[r].l = 1 * new Date();


   a = s.createElement(o),
   m = s.getElementsByTagName(o)[0];
   a.async = 1;
   a.src = g;
   m.parentNode.insertBefore(a, m)
   })(window, document, 'script', 'https://www.google-analytics.com/analytics.js', 'ga');
   ga('create', 'Google Client Id', 'auto');
</script>
<script type="text/javascript">
   alloy("sendEvent", {


   })
   .then(({ renderedPropositions, nonRenderedPropositions }) => {
   // concatenate all the propositions
   const propositions = [...renderedPropositions, ...nonRenderedPropositions];
   // extractResponseTokens() extract the meta from item -> meta
   const tokens = extractResponseTokens(propositions);
   const activityNames = [];
   const experienceNames = [];
   const uniqueTokens = distinct(tokens);


   uniqueTokens.forEach(token => {
   activityNames.push(token["activity.name"]);
   experienceNames.push(token["experience.name"]);
   });


   ga('send', 'event', {
   eventCategory: "target",
   eventAction: experienceNames,
   eventLabel: activityNames
   });


   });
</script>

at.js 배지 at.js를 통해 Google Analytics에 데이터 보내기

at.js를 통해 HTML 페이지에 다음 코드를 추가하여 Google 애널리틱스에 데이터를 전송할 수 있습니다.

<script type="text/javascript">
  (function(i, s, o, g, r, a, m) {
    i['GoogleAnalyticsObject'] = r;
    i[r] = i[r] || function() {
      (i[r].q = i[r].q || []).push(arguments)
    }, i[r].l = 1 * new Date();
    a = s.createElement(o),
      m = s.getElementsByTagName(o)[0];
    a.async = 1;
    a.src = g;
    m.parentNode.insertBefore(a, m)
  })(window, document, 'script', 'https://www.google-analytics.com/analytics.js', 'ga');
  ga('create', 'Google Client Id', 'auto');
</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"]);
    });

    ga('send', 'event', {
      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>

디버깅

다음 섹션에서는 디버깅 응답 토큰에 대한 정보를 제공합니다.

at.js 배지 Google Analytics 및 디버깅

다음 코드를 사용하면 Google Analytics을 사용하여 디버깅할 수 있습니다.

<script type="text/javascript">
  (function(i, s, o, g, r, a, m) {
    i['GoogleAnalyticsObject'] = r;
    i[r] = i[r] || function() {
      (i[r].q = i[r].q || []).push(arguments)
    }, i[r].l = 1 * new Date();
    a = s.createElement(o),
      m = s.getElementsByTagName(o)[0];
    a.async = 1;
    a.src = g;
    m.parentNode.insertBefore(a, m)
  })(window, document, 'script', 'https://www.google-analytics.com/analytics.js', 'ga');
  ga('create', 'Google Client Id', 'auto');
</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"]);
    });

    ga('send', 'event', {
      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]; });
  }

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 교육 비디오: 응답 토큰 및 at.js 사용자 지정 이벤트

다음 비디오에서는 응답 토큰 및 at.js 사용자 지정 이벤트를 사용하여 프로필 정보를 Target 타사 시스템으로 이동합니다.

노트

Target 관리 메뉴 UI(이전명: 설정)는 향상된 성능을 제공하고, 새로운 기능을 출시할 때 필요한 유지 관리 시간을 줄이고, 제품 전반에 걸쳐 사용자 경험을 개선할 수 있도록 새롭게 디자인되었습니다. 다음 비디오의 정보가 올바릅니다. 그러나 옵션은 약간 다른 위치에 있습니다.

비디오에 대한 언급 option.nameoption.id: offer.nameoffer.id각각 입니다.

이 페이지에서는