`advertising`(웹 SDK) advertising

마지막 업데이트: 2026년 11월 6일

작성 대상:

중급
개발자

advertising 개체는 Adobe Advertising과의 웹 SDK 통합을 구성합니다. Web SDK은 이러한 설정을 사용하여 클릭스루 및 뷰스루 전환을 측정하고 이벤트에 광고 ID를 추가합니다.

클릭스루 전환: 구성이 필요하지 않습니다. 방문자가 s_kwcid 또는 ef_id 쿼리 문자열 매개 변수가 있는 페이지에 도달하면 Web SDK에서 클릭스루 전환을 기록합니다.
뷰스루 전환: advertiserSettings에 활성화된 광고주가 하나 이상 필요합니다. Web SDK은 사용 가능한 광고 ID를 수집하고 해당 광고주에 대한 뷰스루 변환을 전송합니다.

웹 SDK은 방문자가 동의할 때까지 광고 전환을 처리하거나 광고 쿠키를 설정하지 않습니다. Advertising 구성 요소는 표준 웹 SDK 라이브러리에 포함되어 있습니다. 사용자 지정 빌드를 만들기하는 경우 Advertising 구성 요소를 포함하십시오.

속성 properties

속성

유형

기본

설명

enabled

부울

true

런타임 시 Adobe Advertising을 켜거나 끕니다. 런타임에 Advertising 끄기를 참조하세요. 웹 SDK 버전 2.37.0 이상에서 사용할 수 있습니다.

dspEnabled

부울

false

Adobe Advertising Demand-side Platform(DSP)을 사용하는 경우 true(으)로 설정합니다. true일 때 id5PartnerId 또는 rampIdJSPath을(를) 설정한 경우 뷰스루 전환에는 ID5 및 RampID 유니버설 ID가 포함됩니다.

advertiserSettings

오브젝트 배열

에 대한 뷰스루 전환을 측정할 광고주입니다. 각 개체에는 advertiserId 문자열과 enabled 부울이 있으며 둘 다 필요합니다. Web SDK에서는 enabled이(가) true(으)로 설정된 광고주만 사용합니다.

id5PartnerId

문자열

조직의 ID5 파트너 ID입니다. 이 설정을 사용하면 Web SDK에서 ID5 범용 ID를 수집할 수 있습니다.

rampIdJSPath

문자열

조직의 LiveRamp RampID JavaScript 코드(ats.js) 경로입니다. 이 설정을 사용하면 웹 SDK에서 RampID개의 유니버설 ID를 수집할 수 있습니다.

예 example

alloy("configure", {
  datastreamId: "ebebf826-a01f-4458-8cec-ef61de241c93",
  orgId: "ADB3LETTERSANDNUMBERS@AdobeOrg",
  advertising: {
    dspEnabled: true,
    advertiserSettings: [
      { advertiserId: "12345", enabled: true },
      { advertiserId: "67890", enabled: false }
    ],
    id5PartnerId: "1234",
    rampIdJSPath: "https://example.com/ats.js"
  }
});

런타임 시 Advertising 끄기 enabled

라이브러리에서 Advertising 구성 요소를 제거하지 않고 Adobe Advertising을 끄려면 advertising.enabled을(를) false(으)로 설정하십시오. enabled이(가) false인 경우 웹 SDK:

클릭스루 또는 뷰스루 전환을 전송하지 않습니다.
sendEvent 명령이 handleAdvertisingData을(를) "auto" 또는 "wait"(으)로 설정하는 경우에도 이벤트에 광고 ID를 추가하지 않습니다.
서퍼 ID, ID5 또는 RampID 호출을 수행하지 않으므로 광고 스크립트나 iframe이 로드되지 않습니다.
광고 쿠키를 읽거나 쓰지 않습니다. 기존 광고 쿠키는 그대로 유지됩니다.

enabled이(가) false인 동안 웹 SDK에서는 advertising 개체의 다른 속성을 무시합니다.

alloy("configure", {
  datastreamId: "ebebf826-a01f-4458-8cec-ef61de241c93",
  orgId: "ADB3LETTERSANDNUMBERS@AdobeOrg",
  advertising: {
    enabled: false
  }
});

enabled 속성은 부울 값만 허용합니다. 문자열 "true" 또는 "false"과(와) 같은 다른 값으로 인해 configure 명령이 실패합니다.

라이브러리를 다시 작성하지 않고 Advertising을 끄거나, 특정 페이지에서와 같이 조건부로 켜거나 끄려면 이 속성을 사용합니다. 라이브러리에서 Advertising 코드를 완전히 제거하려면 대신 사용자 지정 빌드에서 Advertising 구성 요소를 제외하십시오.

이벤트에 광고 ID 추가 handle-advertising-data

기본적으로 Web SDK에서는 sendEvent을(를) 사용하여 보내는 이벤트에 광고 ID를 추가하지 않습니다. 추가하려면 sendEvent 명령의 advertising.handleAdvertisingData을(를) 다음 값 중 하나로 설정하십시오.

"disabled": 기본값 웹 SDK은 이벤트에 광고 ID를 추가하지 않습니다.
"auto": Web SDK은 이전에 전환한 ID와 같이 이미 수집한 광고 ID를 추가합니다.
"wait": 웹 SDK에서도 아직 사용할 수 없는 광고 ID를 수집하려고 하며 이벤트를 보내기 전에 해당 ID를 잠시 기다립니다.

alloy("sendEvent", {
  xdm: {
    eventType: "web.webpagedetails.pageViews"
  },
  advertising: {
    handleAdvertisingData: "auto"
  }
});

웹 SDK은 방문자가 동의하고, advertiserSettings에서 하나 이상의 광고주가 활성화되어 있고, 페이지 URL에 클릭스루 매개 변수가 없는 경우에만 광고 ID를 이벤트에 추가합니다.

웹 SDK 태그 확장을 사용하여 Advertising 구성 tag-extension

이러한 설정은 Adobe Advertising 설정을 사용하여 웹 SDK 태그 확장에서 구성할 수 있습니다.

recommendation-more-help

experience-platform-help-collection

advertising(웹 SDK) advertising