DokumentationExperience PlatformDatenerfassung

advertising (Web SDK) advertising

Letzte Aktualisierung: 6. November 2026

Erstellt für:

  • Fortgeschritten
  • Entwicklerin/Entwickler

Das advertising-Objekt konfiguriert die Web SDK-Integration mit Adobe Advertising. Web SDK verwendet diese Einstellungen, um Clickthrough- und View-Through-Konversionen zu messen und um Ereignis-IDs hinzuzufügen.

  • Clickthrough-Konversionen: Es ist keine Konfiguration erforderlich. Wenn ein Besucher auf einer Seite mit einem s_kwcid oder ef_id Abfragezeichenfolgenparameter ankommt, zeichnet Web SDK eine Clickthrough-Konversion auf.
  • View-Through-Konversionen: Erfordert mindestens einen aktivierten Advertiser in advertiserSettings. Web SDK erfasst die verfügbaren Werbe-IDs und sendet Viewthrough-Konversionen für diese Advertiser.

Web SDK verarbeitet keine Werbekonversionen oder setzt keine Werbe-Cookies, bis der Besucher seine Zustimmung erteilt. Die Advertising-Komponente ist in der standardmäßigen Web-SDK-Bibliothek enthalten. Wenn Sie benutzerdefinierten Build erstellen schließen Sie die Advertising-Komponente ein.

Eigenschaften properties

Eigenschaft
Typ
Standard
Beschreibung
enabled
Boolesch
true
Schaltet Adobe Advertising zur Laufzeit ein oder aus. Siehe Advertising zur Laufzeit deaktivieren. Verfügbar in Web SDK Version 2.37.0 oder höher.
dspEnabled
Boolesch
false
Setzen Sie diesen Wert auf true, wenn Sie Adobe Advertising Demand-Side Platform (DSP) verwenden. Wenn true, enthalten die Durchsichtskonvertierungen universelle IDs vom Typ ID5 und RampIDs, wenn Sie id5PartnerId oder rampIdJSPath festlegen.
advertiserSettings
Array von Objekten
Die Werbetreibenden, die Viewthrough-Konversionen für messen. Jedes Objekt enthält eine advertiserId Zeichenfolge und einen enabled booleschen Wert. Beide Werte sind erforderlich. Web SDK verwendet nur Werbetreibende, für die enabled auf “true” festgelegt ist.
id5PartnerId
Zeichenfolge
Die ID5-Partner-ID Ihres Unternehmens. Mit dieser Einstellung kann Web SDK universelle ID5-IDs erfassen.
rampIdJSPath
Zeichenfolge
Der Pfad zum LiveRamp RampID JavaScript-Code (ats.js) Ihres Unternehmens. Mit dieser Einstellung kann Web SDK universelle IDs RampID.

Beispiel 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 zur Laufzeit deaktivieren enabled

Legen Sie advertising.enabled auf false fest, um Adobe Advertising zu deaktivieren, ohne die Advertising-Komponente aus Ihrer Bibliothek zu entfernen. Wenn enabled false ist, Web SDK:

  • Sendet keine Clickthrough- oder View-Through-Konvertierungen.
  • Fügt keine Werbe-IDs zu Ereignissen hinzu, auch wenn ein sendEvent-Befehl handleAdvertisingData auf "auto" oder "wait" setzt.
  • Führt keine Surfer-ID-, ID5- oder RampID-Aufrufe durch, sodass keine Werbeskripte oder iFrames geladen werden.
  • Werbe-Cookies werden nicht gelesen oder geschrieben. Bestehende Werbe-Cookies bleiben unverändert.

Web SDK ignoriert die anderen Eigenschaften im advertising-Objekt, während enabled false wird.

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

Die enabled-Eigenschaft akzeptiert nur boolesche Werte. Andere Werte, z. B. die Zeichenfolgen "true" oder "false", führen dazu, dass der configure-Befehl fehlschlägt.

Verwenden Sie diese Eigenschaft, wenn Sie Advertising deaktivieren möchten, ohne die Bibliothek neu zu erstellen, oder sie bedingt aktivieren oder deaktivieren möchten, z. B. für bestimmte Seiten. Um den Advertising-Code vollständig aus Ihrer Bibliothek zu entfernen, schließen Sie stattdessen die Advertising-Komponente von einem benutzerdefinierten Build aus.

Hinzufügen von Werbe-IDs zu Ereignissen handle-advertising-data

Standardmäßig fügt Web SDK keine Werbe-IDs zu Ereignissen hinzu, die Sie mit sendEvent senden. Um sie hinzuzufügen, legen Sie advertising.handleAdvertisingData im sendEvent-Befehl auf einen der folgenden Werte fest:

  • "disabled": Der Standardwert. Web SDK fügt dem Ereignis keine Werbe-IDs hinzu.
  • "auto": Web SDK fügt Werbe-IDs hinzu, die bereits erfasst wurden, z. B. IDs aus früheren Konversionen.
  • "wait": Web SDK versucht auch, noch nicht verfügbare Werbe-IDs zu erfassen, und wartet kurz auf sie, bevor die Veranstaltung gesendet wird.
alloy("sendEvent", {
  xdm: {
    eventType: "web.webpagedetails.pageViews"
  },
  advertising: {
    handleAdvertisingData: "auto"
  }
});

Web SDK fügt einem Ereignis nur dann Werbe-IDs hinzu, wenn der Besucher seine Zustimmung erteilt hat, mindestens ein Advertiser in advertiserSettings aktiviert ist und die Seiten-URL keine Clickthrough-Parameter enthält.

Konfigurieren von Advertising mithilfe der Tag-Erweiterung „Web SDK" tag-extension

Diese Einstellungen können in der Tag-Erweiterung „Web SDK" mithilfe von Adobe Advertising-Einstellungen konfiguriert ​.

recommendation-more-help
experience-platform-help-collection