targetGlobalSettings()

Target Standard/Premium UI에서 설정을 구성하거나 REST API를 사용하는 대신 targetGlobalSettings()를 사용하여 at.js 라이브러리의 설정을 무시할 수 있습니다.

설정의 지침을 완료하여 이 설정을 변경할 수 있습니다

다음 설정을 재정의할 수 있습니다.

bodyHiddenStyle

• 유형: 문자열

• 기본값: body

• 설명: 다음 경우에만 사용됨 globalMboxAutocreate === true 깜박임 가능성을 최소화하기 위해.

  자세한 내용은 at.js에서 플리커를 관리하는 방법을 참조하십시오.

bodyHidingEnabled

• 유형: 부울
• 기본값: true
• 설명: 다음 경우에 플리커를 제어하는 데 사용됩니다. target-global-mbox 는 시각적 오퍼라고도 하는 시각적 경험 작성기에서 만든 오퍼를 전달하는 데 사용됩니다.

clientCode

• 유형: 문자열
• 기본값: UI를 통해 설정된 값.
• 설명: 클라이언트 코드를 나타냅니다.

cookieDomain

• 유형: 문자열
• 기본값: 가능한 경우 최상위 도메인으로 설정합니다.
• 설명: 쿠키를 저장할 때 사용되는 도메인을 나타냅니다.

crossDomain

• 유형: 문자열
• 기본값: UI를 통해 설정된 값.
• 설명: 도메인 간 추적이 활성화되었는지 여부를 나타냅니다. 허용되는 값은 다음과 같습니다. 비활성화, 활성화 또는 x 전용.

cspScriptNonce

• 유형: 자세한 내용은 컨텐츠 보안 정책 아래의 제품에서 사용할 수 있습니다.
• 기본값: 자세한 내용은 컨텐츠 보안 정책 아래의 제품에서 사용할 수 있습니다.
• 설명: 자세한 내용은 컨텐츠 보안 정책 아래의 제품에서 사용할 수 있습니다.

cspStyleNonce

• 유형: 자세한 내용은 컨텐츠 보안 정책 아래의 제품에서 사용할 수 있습니다.
• 기본값: 자세한 내용은 컨텐츠 보안 정책 아래의 제품에서 사용할 수 있습니다.
• 설명: 자세한 내용은 컨텐츠 보안 정책 아래의 제품에서 사용할 수 있습니다.

dataProviders

• 유형: 자세한 내용은 데이터 공급자 아래의 제품에서 사용할 수 있습니다.
• 기본값: 자세한 내용은 데이터 공급자 아래의 제품에서 사용할 수 있습니다.
• 설명: 자세한 내용은 데이터 공급자 아래의 제품에서 사용할 수 있습니다.

decisioningMethod

• 유형: 문자열

• 기본값: 서버측

• 기타 값: 온장치, 하이브리드

• 설명: 아래의 Decisioning 메서드를 참조하십시오.

  의사결정 메서드

  On-Device Decisioning에서 Target은 의사 결정 방법 at.js에서 경험을 전달하는 방법을 지시합니다. 다음 decisioningMethod 에는 세 가지 값이 있습니다. 서버측 전용, 온장치 전용 및 하이브리드 When decisioningMethod 가 설정되어 있습니다. targetGlobalSettings()를 지정하는 경우, 모든 사용자에 대한 기본 의사 결정 방법 역할을 합니다 Target 결정.

  서버측 전용:

  서버측 전용 at.js 2.5+가 구현되고 웹 속성에 배포될 때 즉시 설정되는 기본 의사 결정 메서드입니다.

  사용 서버측 전용 기본 구성은 모든 결정이 Target 서버 호출을 차단하는 에지 네트워크. 이 접근 방식에서는 증분 지연을 도입할 수 있지만 Target의 기계 학습 기능을 다음과 같은 중요한 이점을 제공합니다 Recommendations, Automated Personalization (AP) 및 자동 Target 활동.

  또한 세션 및 채널마다 지속되는 Target의 사용자 프로필을 사용하여 개인화된 경험을 개선하면 비즈니스에 강력한 결과를 제공할 수 있습니다.

  마지막으로 서버측 전용 Adobe Experience Cloud을 사용하고 Audience Manager 및 Adobe Analytics 세그먼트를 통해 타깃팅할 수 있는 대상을 세밀하게 조정할 수 있습니다.

  온장치만:

  온장치만 는 On-Device Decisioning이 웹 페이지 전체에서 사용되어야 할 때 at.js 2.5+에서 설정해야 하는 의사 결정 방법입니다.

  On-Device Decisioning은 결정은 On-Device Decisioning에 적합한 모든 활동을 포함하는 캐시된 규칙 아티팩트로 수행되므로 매우 빠른 속도로 환경 및 개인화 활동을 제공할 수 있습니다.

  장치 내 의사 결정에 적합한 활동에 대한 자세한 내용은 지원되는 기능 섹션을 참조하십시오.

  이 의사 결정 방법은 결정을 필요로 하는 모든 페이지에서 성능이 매우 중요한 경우에만 사용해야 합니다 Target. 또한 이 의사 결정 방법을 선택하면 Target On-Device Decisioning에 대한 자격이 없는 활동은 전달되거나 실행되지 않습니다. at.js 라이브러리 2.5+는 결정을 내릴 캐시된 규칙 아티팩트만 찾도록 구성되어 있습니다.

  하이브리드:

  하이브리드 는 On-Device Decisioning과 Adobe Target Edge 네트워크에 대한 네트워크 호출이 필요한 활동을 모두 실행해야 할 때 at.js 2.5+에서 설정해야 하는 의사 결정 방법입니다.

  On-Device Decisioning 활동과 서버측 활동을 모두 관리하는 경우 배포 및 프로비저닝 방법을 생각할 때 약간 복잡하고 번거로울 수 있습니다 Target 참조하십시오. 의사 결정 방법으로 하이브리드 사용, Target 서버측 실행이 필요한 활동과 장치 내 의사 결정만 실행해야 하는 시기를 위해 Adobe Target Edge 네트워크에 서버 호출을 해야 하는 시기를 알고 있습니다.

  JSON 규칙 아티팩트에는 at.js에 mbox에 실행 중인 서버측 활동 또는 On-Device Decisioning 활동이 있는지 여부를 알리는 메타데이터가 포함되어 있습니다. 이 의사 결정 방법은 빠르게 전달하려는 활동을 On-Device Decisioning을 통해 수행하고 보다 강력한 ML 기반 개인화가 필요한 활동에 대해 이러한 활동을 Adobe Target Edge 네트워크를 통해 수행할 수 있도록 합니다.

defaultContentHiddenStyle

• 유형: 문자열
• 기본값: 가시성: 숨김
• 설명: DIV를 클래스 이름 "mboxDefault"와 함께 사용하고 을 통해 실행되는 mbox를 래핑하는 데만 사용됩니다. mboxCreate(), mboxUpdate(), 또는 mboxDefine() 기본 콘텐츠를 숨기려면

defaultContentVisibleStyle

• 유형: 문자열
• 기본값: 가시성: 표시
• 설명: DIV를 클래스 이름 "mboxDefault"와 함께 사용하고 을 통해 실행되는 mbox를 래핑하는 데만 사용됩니다. mboxCreate(), mboxUpdate(), 또는 mboxDefine() 적용된 오퍼(있는 경우) 또는 기본 컨텐츠를 표시하기 위해

deviceIdLifetime

• 유형: 숫자
• 기본값: 63244800000 ms = 2년
• 설명: 시간 deviceId 는 쿠키에 유지됩니다.

활성화됨

• 유형: 부울

• 기본값: true

• 설명: 활성화되면, Target 경험을 렌더링하기 위한 경험 검색 및 DOM 조작 요청이 자동으로 실행됩니다. 또한, Target 호출은 를 통해 수동으로 실행할 수 있습니다. getOffer(s) / applyOffer(s).

  비활성화되면, Target 요청은 자동으로 또는 수동으로 실행되지 않습니다.

globalMboxAutoCreate

• 유형: 숫자
• 기본값: UI를 통해 설정된 값.
• 설명: 글로벌 mbox 요청을 실행할지 여부를 나타냅니다.

imsOrgId

• 유형: 스팅
• 기본값: true
• 설명: IMS 조직 ID를 나타냅니다.

optinEnabled

• 유형: 부울
• 기본값: false
• 설명: Target 은 를 통해 옵트인 기능 지원을 제공합니다. Adobe Experience Platform 동의 관리 전략을 지원하는 데 도움이 됩니다. 선택 기능을 통해 고객이 태그를 실행하는 방법과 시기를 제어할 수 있습니다. Target 또한 Adobe Experience Platform를 통해서 Target 태그를 사전 승인할 수 있는 옵션이 있습니다. 에서 옵트인을 사용하는 기능을 활성화하려면 Target at.js 라이브러리를 추가하고 optinEnabled=true 설정 in Adobe Experience Platform 다음 중에서 "활성화"를 선택해야 합니다. GDPR 옵트인 확장 설치 보기의 드롭다운 목록입니다. 자세한 내용은 Adobe Experience Platform 설명서 자세한 내용 유럽 연합의 GDPR(General Data Protection Regulation) 및 캘리포니아 소비자 개인 정보 보호법(CCPA)을 비롯한 개인 정보 및 데이터 보호 규정에 관한 이 설정에 대한 자세한 내용은 다음을 참조하십시오 개인 정보 보호 및 데이터 보호 규정.

optoutEnabled

• 유형: 부울
• 기본값: false
• 설명: Target이 방문자 API를 호출해야 하는지를 나타냅니다 isOptedOut() 함수 위에 있어야 합니다. Device Graph 지원의 일부입니다.

overrideMboxEdgeServer

• 유형: 부울

• 기본값: true(at.js 버전 1.6.2부터 true)

• 설명: 다음을 사용해야 하는지 여부를 나타냅니다 <clientCode>.tt.omtrdc.net 도메인 또는 mboxedge<clusterNumber>.tt.omtrdc.net 도메인.

  이 값이 true면 mboxedge<clusterNumber>.tt.omtrdc.net 도메인이 쿠키에 저장됩니다. 현재 이 CNAME at.js 1.8.2 및 at.js 2.3.1 이전 버전의 at.js를 사용할 때 문제가 되는 경우 다음을 고려하십시오. at.js 업데이트 지원되는 최신 버전으로 마이그레이션 하는 것이 좋습니다.

overrideMboxEdgeServerTimeout

• 유형: 숫자
• 기본값: 1860000 => 31분
• 설명: 를 포함하는 쿠키 라이프타임을 나타냅니다 mboxedge<clusterNumber>.tt.omtrdc.net 값.

pageLoadEnabled

• 유형: 부울
• 기본값: true
• 설명: 이 옵션이 활성화되면 페이지 로드 시 반환해야 하는 경험을 자동으로 검색합니다.

secureOnly

• 유형: 부울
• 기본값: false
• 설명: at.js에서 HTTPS만 사용되는지 또는 페이지 프로토콜을 기준으로 HTTP와 HTTPS 간을 전환할 수 있는지를 나타냅니다. true로 설정되면 secureOnly는 Secure 및 SameSite 속성을 mbox 쿠키로 설정합니다.

selectorsPollingTimeout

• 유형: 숫자

• 기본값: 5000ms = 5s

• 설명: at.js 0.9.6에서, Target 를 통해 대체할 수 있는 이 새 설정을 도입했습니다. targetGlobalSettings.

  다음 selectorsPollingTimeout 설정은 선택기로 식별된 모든 요소가 페이지에 표시되도록 하기 위해 클라이언트가 대기하는 시간을 나타냅니다.

  VEC(시각적 경험 작성기)를 통해 작성된 활동에는 선택기를 포함하는 오퍼가 있습니다.

serverDomain

• 유형: 문자열
• 기본값: UI를 통해 설정된 값.
• 설명: Target 에지 서버를 나타냅니다.

serverState

• 유형: 자세한 내용은 하이브리드 개인화 아래의 제품에서 사용할 수 있습니다.
• 기본값: 자세한 내용은 하이브리드 개인화 아래의 제품에서 사용할 수 있습니다.
• 설명: 자세한 내용은 하이브리드 개인화 아래의 제품에서 사용할 수 있습니다.

telemetryEnabled

• 유형: 부울
• 기본값: true
• 설명: 활성화되면, Adobe SDK 기능 사용 및 성능 원격 분석 데이터를 수집합니다. 개인 데이터는 수집되지 않습니다.

timeout

• 유형: 숫자
• 기본값: UI를 통해 설정된 값.
• 설명: 를 나타냅니다 Target edge 요청 시간 제한.

viewsEnabled

• 유형: 부울
• 기본값: true
• 설명: 활성화되면 페이지 로드 시 반환해야 하는 보기를 자동으로 검색합니다. 보기는 at.js 2에서 지원됩니다.x 에만 사용할 수 있습니다.

visitorApiTimeout

• 유형: 숫자
• 기본값: 2000ms = 2s
• 설명: 를 나타냅니다 방문자 API 요청 시간 제한.

사용

이 함수는 at.js가 로드되기 전에 또는 관리 > 구현 > at.js 설정 편집 > 코드 설정 > 라이브러리 헤더.

라이브러리 헤더 필드에는 자유 형식 JavaScript를 입력할 수 있습니다. 사용자 지정 코드는 다음 예제와 유사해야 합니다.

window.targetGlobalSettings = {
   timeout: 200, // using custom timeout
   visitorApiTimeout: 500, // using custom API timeout
   enabled: document.location.href.indexOf('https://www.adobe.com') >= 0 // enabled ONLY on adobe.com
};

데이터 공급자

이 설정을 사용하여 고객은 Demandbase, BlueKai 및 사용자 지정 서비스와 같은 서드 파티 데이터 공급자로부터 데이터를 수집하고, 글로벌 mbox의 mbox 매개 변수가 요청할 때 Target으로 데이터를 전달할 수 있습니다. 비동기 및 동기 요청을 통해 여러 공급자로부터 데이터를 수집하도록 지원합니다. 이 접근 방식을 사용하면 각 공급자에 대해 독립적인 시간 제한을 포함하여 페이지 성능에 미치는 영향을 제한하면서, 기본 페이지 콘텐츠의 깜박임을 쉽게 관리할 수 있습니다

다음 비디오에는 추가 정보가 포함되어 있습니다.

window.targetGlobalSettings.dataProviders 설정은 데이터 공급자의 배열입니다.

각 데이터 공급자의 구조는 다음과 같습니다.

다음 예제에서는 데이터 공급자가 동기화 실행을 사용하는 위치를 보여 줍니다.

var syncDataProvider = {
  name: "simpleDataProvider",
  version: "1.0.0",
  provider: function(callback) {
    callback(null, {t1: 1});
  }
};

window.targetGlobalSettings = {
  dataProviders: [
    syncDataProvider
  ]
};

at.js가 window.targetGlobalSettings.dataProviders를 처리하면 Target 요청에 새 매개 변수인 t1=1이 포함됩니다.

다음은 Target 요청에 추가하려는 매개 변수를 Bluekai, Demandbase 등과 같은 서드 파티 서비스에서 가져오는 경우의 예입니다.

var blueKaiDataProvider = {
   name: "blueKai",
   version: "1.0.0",
   provider: function(callback) {
      // simulating network request
     setTimeout(function() {
       callback(null, {t1: 1, t2: 2, t3: 3});
     }, 1000);
   }
}

window.targetGlobalSettings = {
   dataProviders: [
      blueKaiDataProvider
   ]
};

at.js가 window.targetGlobalSettings.dataProviders를 처리한 후에 Target 요청에는 추가 매개 변수인 t1=1, t2=2 및 t3=3이 포함됩니다.

다음 예제에서는 데이터 공급자를 사용하여 날씨 API 데이터를 수집하고 Target 요청에 매개 변수로 전송합니다. Target 요청에는 country 및 weatherCondition과 같은 추가 매개 변수가 사용됩니다.

var weatherProvider = {
      name: "weather-api",
      version: "1.0.0",
      timeout: 2000,
      provider: function(callback) {
        var API_KEY = "caa84fc6f5dc77b6372d2570458b8699";
        var lat = 44.426767399999996;
        var lon = 26.1025384;
        var url = "//api.openweathermap.org/data/2.5/weather?lang=en";
        var data = {
          lat: lat,
          lon: lon,
          appId: API_KEY
        }

        $.ajax({
          type: "GET",
                url: url,
          dataType: "json",
          data: data,
          success: function(data) {
            console.log("Weather data", data);
            callback(null, {
              country: data.sys.country,
              weatherCondition: data.weather[0].main
            });
          },
          error: function(err) {
            console.log("Error", err);
            callback(err);
          }
        });
      }
    };

    window.targetGlobalSettings = {
      dataProviders: [weatherProvider]
    };

dataProviders 설정을 사용할 때는 다음 사항을 고려하십시오.

• window.targetGlobalSettings.dataProviders에 추가된 데이터 공급자가 비동기 상태인 경우 병렬로 실행됩니다. 방문자 API 요청은 최소 대기 시간을 허용하기 위해 window.targetGlobalSettings.dataProviders에 추가된 함수와 함께 실행됩니다.
• at.js는 데이터를 캐시하려고 하지 않습니다. 데이터 공급자는 데이터를 한 번만 가져오는 경우 데이터가 캐시되는지 확인해야 하고, 공급자 함수가 호출될 때 두 번째 호출을 위해 캐시 데이터를 제공해야 합니다.

콘텐츠 보안 정책

at.js 2.3.0+는 전달된 Target 오퍼을 적용할 때 SCRIPT에서 컨텐츠 보안 정책 논점 및 페이지 DOM에 추가된 STYLE 태그 설정을 지원합니다.

SCRIPT 및 STYLE 논문은 targetGlobalSettings.cspScriptNonce 및 targetGlobalSettings.cspStyleNonce 이에 따라 at.js 2.3.0 이상 로드 전에 아래 예를 참조하십시오.

...
<head>
 <script nonce="<script_nonce_value>">
window.targetGlobalSettings = {
  cspScriptNonce: "<csp_script_nonce_value>",
  cspStyleNonce: "<csp_style_nonce_value>"
};
 </script>
 <script nonce="<script_nonce_value>" src="at.js"></script>
...
</head>
...

후 cspScriptNonce 및 cspStyleNonce 설정이 지정되면 at.js 2.3.0+는 Target 오퍼을 적용할 때 DOM에 적용되는 모든 SCRIPT 및 STYLE 태그에 대한 임시 속성으로 설정합니다.

하이브리드 개인화

serverState 는 Target의 하이브리드 통합이 구현될 때 페이지 성능을 최적화하는 데 사용할 수 있는 at.js v2.2+에서 사용할 수 있는 설정입니다. 하이브리드 통합은 클라이언트측에서 at.js v2.2+를 사용하고 있으며, 서버측에서 배달 API 또는 Target SDK를 모두 사용하고 있음을 의미합니다. serverState 는 at.js v2.2+에서 서버측에서 가져온 콘텐츠에서 직접 경험을 적용하고 서비스되는 페이지의 일부로 클라이언트에 반환할 수 있는 기능을 제공합니다.

사전 요구 사항

의 하이브리드 통합이 있어야 합니다 Target.

• 서버측: 새 배달 API 또는 Target SDK.
• 고객측: 를 사용해야 합니다. at.js 버전 2.2 이상.

코드 샘플

이 작동 방식을 더 잘 이해하려면 서버에 있을 아래의 코드 예를 참조하십시오. 이 코드에서는 사용자가 Target Node.js SDK.

// First, we fetch the offers via Target Node.js SDK API, as usual
const targetResponse = await targetClient.getOffers(options);
// A successfull response will contain Target Delivery API request and response objects, which we need to set as serverState
const serverState = {
  request: targetResponse.request,
  response: targetResponse.response
};
// Finally, we should set window.targetGlobalSettings.serverState in the returned page, by replacing it in a page template, for example
const PAGE_TEMPLATE = `
<!doctype html>
<html>
<head>
  ...
  <script>
    window.targetGlobalSettings = {
      overrideMboxEdgeServer: true,
      serverState: ${JSON.stringify(serverState, null, " ")}
    };
  </script>
  <script src="at.js"></script>
</head>
...
</html>
`;
// Return PAGE_TEMPLATE to the client ...

샘플 serverState 미리 가져오기 보기에 대한 JSON 개체는 다음과 같습니다.

{
 "request": {
  "requestId": "076ace1cd3624048bae1ced1f9e0c536",
  "id": {
   "tntId": "08210e2d751a44779b8313e2d2692b96.21_27"
  },
  "context": {
   "channel": "web",
   "timeOffsetInMinutes": 0
  },
  "experienceCloud": {
   "analytics": {
    "logging": "server_side",
    "supplementalDataId": "7D3AA246CC99FD7F-1B3DD2E75595498E"
   }
  },
  "prefetch": {
   "views": [
    {
     "address": {
      "url": "my.testsite.com/"
     }
    }
   ]
  }
 },
 "response": {
  "status": 200,
  "requestId": "076ace1cd3624048bae1ced1f9e0c536",
  "id": {
   "tntId": "08210e2d751a44779b8313e2d2692b96.21_27"
  },
  "client": "testclient",
  "edgeHost": "mboxedge21.tt.omtrdc.net",
  "prefetch": {
   "views": [
    {
     "name": "home",
     "key": "home",
     "options": [
      {
       "type": "actions",
       "content": [
        {
         "type": "setHtml",
         "selector": "#app > DIV.app-container:eq(0) > DIV.page-container:eq(0) > DIV:nth-of-type(2) > SECTION.section:eq(0) > DIV.container:eq(1) > DIV.heading:eq(0) > H1.title:eq(0)",
         "cssSelector": "#app > DIV:nth-of-type(1) > DIV:nth-of-type(1) > DIV:nth-of-type(2) > SECTION:nth-of-type(1) > DIV:nth-of-type(2) > DIV:nth-of-type(1) > H1:nth-of-type(1)",
         "content": "<span style=\"color:#FF0000;\">Latest</span> Products for 2020"
        }
       ],
       "eventToken": "t0FRvoWosOqHmYL5G18QCZNWHtnQtQrJfmRrQugEa2qCnQ9Y9OaLL2gsdrWQTvE54PwSz67rmXWmSnkXpSSS2Q==",
       "responseTokens": {
        "profile.memberlevel": "0",
        "geo.city": "dublin",
        "activity.id": "302740",
        "experience.name": "Experience B",
        "geo.country": "ireland"
       }
      }
     ],
     "state": "J+W1Fq18hxliDDJonTPfV0S+mzxapAO3d14M43EsM9f12A6QaqL+E3XKkRFlmq9U"
    }
   ]
  }
 }
}

페이지가 브라우저에 로드되면 at.js가 모든 Target 오퍼 serverState 즉시, Target edge. 또한 at.js는 가 있는 DOM 요소만 미리 숨깁니다 Target 가져온 컨텐츠 서버측에서 오퍼를 사용할 수 있으므로 페이지 로드 성능 및 최종 사용자 경험에 긍정적인 영향을 줄 수 있습니다.

중요 정보

을 사용할 때는 다음 사항을 고려하십시오 serverState:

• 현재 at.js v2.2에서는 다음 용도로 serverState를 통해 경험만 전달하도록 지원합니다.

  • 페이지 로드 시 실행되는 VEC 생성 활동.

  • 미리 가져온 보기.

    SPA에서 Target 보기 및 triggerView() at.js API에서 at.js v2.2는 서버 측에서 미리 가져온 모든 보기에 대한 컨텐츠를 캐시하고 각 보기가 를 통해 트리거되는 즉시 적용합니다. triggerView()Target에 대한 추가적인 컨텐츠 가져오기 호출을 하지 않고 을 다시 한 번 호출합니다.

  • 참고: 현재, 서버측에서 검색한 mbox는에서 지원되지 않습니다. serverState.

• 적용 시 serverState 오퍼에서는 at.js가 고려합니다 pageLoadEnabled 및 viewsEnabled 설정(예: 페이지 로드 오퍼는 pageLoadEnabled 설정이 false입니다.

  이러한 설정을 켜려면 토글을 활성화합니다 관리 > 구현 > 편집 > 페이지 로드 활성화.

  

• 사용 중인 경우 serverState 및 <script> 반환된 컨텐츠의 태그에서 HTML 컨텐츠가 <\/script> 대신 </script>. 만약 </script>를 검색하는 경우 </script> 를 인라인 SCRIPT의 끝으로 만든 후 HTML 페이지를 부를 수 있습니다.

추가 리소스

방법을 자세히 알아보려면 serverState 다음 리소스를 확인하십시오.

• 샘플 코드.
• SPA(단일 페이지 애플리케이션) 샘플 앱 serverState.