„session_attributes“

Beim Import von Offline-Conversions (Offline Conversion Import, OCI) werden Offline-Conversions aus Importen anhand der GCLID (Google Click ID) erfasst. Wenn die GCLID nicht verfügbar ist, können OCI-Nutzer andere Kennungen wie etwa gehashte, von Nutzern bereitgestellte Daten, wbraid/gbraid oder session_attributes verwenden.

Themen in diesem Hilfeartikel

• „session_attributes“
• „session_attributes“ erfassen
• Daten an Google Ads senden

---

„session_attributes“

session_attributes ist ein Feld, das mehr Kontext und Signale zur Interaktion des Nutzers mit Ihrer Website liefert. So lassen sich die Conversion-Analyse, die Berichte (einschließlich Aufschlüsselung nach demselben Gerät oder geräteübergreifend) und die Gebotsgenauigkeit verbessern. Mit dem folgenden Frontend-Script können Sie den base64-codierten String von session_attributes erstellen, an Ihre Datenbank / Ihr CRM übergeben und in Ihren API-Importen an Google senden. Wenn Sie das Frontend-Script nicht verwenden können, senden Sie jedes Schlüssel/Wert-Paar einzeln über das Feld session_attributes_key_value_pairs.

Wir empfehlen, alle folgenden Unterfelder des Felds session_attributes zu senden, auch wenn nur 4 der 6 erforderlich sind:

• gad_source (erforderlich): Ein aggregierter Parameter, der in der URL übergeben wird, um die Quelle des Traffics zu identifizieren, der über Anzeigen erfolgt. Weitere Informationen zu den „gad_*“-URL-Parametern
  • Beispielwert: "1"
    Richtlinie: Dies sind aggregierte Parameter, die an die URL für Anzeigenklicks angehängt werden (z. B. &gad_source=1). Sie sollten den Wert erfassen, der in der Landingpage-URL enthalten ist.
• gad_campaignid (erforderlich): Die ID der Werbekampagne, die den Anzeigenklick ausgelöst hat. Weitere Informationen zu den „gad_*“-URL-Parametern
  • Beispielwert: "1234567890"
    Richtlinie: Dies ist ebenfalls ein URL-Parameter (z. B. &gad_campaignid=1234567890) und sollte aus der Landingpage-URL erfasst werden.
• session_start_time_usec (erforderlich): Der Zeitstempel für den Beginn der Nutzersitzung auf Ihrer Website. So lässt sich die Dauer der Nutzerbesuche nachvollziehen. Es ist wichtig, ein einheitliches Zeitformat mit Zeitstempel in Mikrosekunden seit der UNIX-Epoche zu verwenden.
  • Beispielwert:"1678886400000000" (stellt einen bestimmten Zeitpunkt in Mikrosekunden dar)
    Richtlinie: Achten Sie auf ein einheitliches Zeitformat (Zeitstempel in Mikrosekunden seit der UNIX-Epoche). So lässt sich die Dauer der Nutzerbesuche nachvollziehen.
• landing_page_user_agent (erforderlich): Ein String, der den Browser und das Betriebssystem des Nutzers identifiziert. Diese Informationen können nützlich sein, um die technische Umgebung Ihrer Nutzer besser zu verstehen.
  • Beispielwert: "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/117.0.0.0 Safari/537.36"
    Richtlinie: Dieser Wert sollte aus dem User-Agent-Header der eingehenden HTTP-Anfrage für die Landingpage erfasst werden. Vermeiden Sie generische oder hartcodierte Werte.
• landing_page_url: Die vollständige URL der Landingpage auf Ihrer Website. Das ist die Seite, auf die der Nutzer zuerst gelangt ist.
  • Beispielwert: "https://www.example.com/product/deluxe-widget?gad_source=1&gad_campaignid=1234567890"
    Richtlinie: Geben Sie die genaue, vollständige URL an. Verwenden Sie keine Platzhalterstrings, internen Anwendungspfade (z. B. „/productdetailscreen“) oder unvollständigen URLs. Lassen Sie dieses Feld besser aus, wenn die vollständige, korrekte URL nicht verfügbar ist.
• landing_page_referrer: Die URL der Webseite, über die der Nutzer auf Ihre Website gelangt ist. So können Sie die Traffic-Quellen Ihrer Website nachvollziehen. Weitere Informationen zu Verweis-URLs finden Sie in diesem Artikel. Er bezieht sich zwar auf Analytics, das Konzept der Verweis-URL ist jedoch allgemein im Web gültig.

  • Beispielwert: "https://www.google.com/" oder "https://www.socialmedia.com/referral"
    Richtlinie: Dies ist die Seite, auf der sich der Nutzer unmittelbar vor dem Aufrufen Ihrer Website befunden hat.

Best Practices für die Datenqualität

• Falsche landing_page_url-Daten vermeiden: Falsche oder unvollständige landing_page_url-Werte sind schädlich für die Modellierung. Wenn Sie die vollständige, korrekte URL nicht angeben können, lassen Sie das Feld besser leer.
• Doppelte Uploads vermeiden: Senden Sie dasselbe Conversion-Ereignis nicht mehrmals. Verwenden Sie eine eindeutige Kennung wie die Bestell-ID, um Duplikate zu entfernen.

Die empfohlene Speichergröße für das Feld session_attributes beträgt 5 KB. Das ist für die meisten Anwendungsfälle ausreichend. Wenn session_attributes größer als 5 KB ist, empfehlen wir Ihnen, die Feldgröße von Ihrem CRM-Anbieter ändern zu lassen. Sie können auch die Parameter landing_page_url und landing_page_referrer aus der JavaScript-Hilfsfunktion entfernen.

---

„session_attributes“ erfassen

Mit der folgenden JavaScript-Hilfsfunktion und dem unten dargestellten HTML-Formular auf Ihrer Landingpage können Sie session_attributes erfassen und speichern.

In diesem Beispielcode werden Daten in localStorage gespeichert. Vor der Implementierung auf Ihrer Website müssen Sie außerdem dafür sorgen, dass alle erforderlichen Einwilligungs- und Datenaufbewahrungsanforderungen für Ihre Website eingehalten werden.

HTML-Formular

1. Sie müssen in jede Seite für die Formulareinreichung ein ausgeblendetes Feld für session_attributes einfügen. Damit werden session_attributes an Ihr Backend-System übergeben. Nachstehend finden Sie einen Beispielcode, das dies veranschaulicht.
   <form action="" name="meinFormular">
Name: <input type="text" name="name">
<input type="hidden" id="session_attributes_field" name="session_attributes_field" value="">
<input type="submit" value="Formular senden" name="btnSubmit">
</form>
2. Beispielscript zum Erfassen von session_attributes_encoded und Festlegen des Werts im Formularfeld. In diesem Beispielcode werden Daten in localStorage gespeichert.

   <script>
function getSessionAttributes() {
const searchParams = new URLSearchParams(window.location.search);
if (Array.from(searchParams.keys()).some(key => key.startsWith('gad_')) ||
searchParams.has('gclid') || searchParams.has('gbraid')) {
const params = {};
searchParams.forEach((value, key) => {
if (key.startsWith('gad_')) params[key] = value;
});
params['session_start_time_usec'] =
(new Date().getTime() * 1000).toString();
params['landing_page_url'] = window.location.href;
params['landing_page_referrer'] = document.referrer;
params['landing_page_user_agent'] = navigator.userAgent;
const sessionAttributesEncoded = btoa(JSON.stringify(params))
.replace(/\+/g, '-')
.replace(/\//g, '_')
.replace(/=+$/, '');
localStorage.setItem('google_session_attributes', sessionAttributesEncoded);
return sessionAttributesEncoded;
}
return localStorage.getItem('google_session_attributes') || '';
}

   
   function addSessionAttributes() {
const sessionAttributesEncoded = getSessionAttributes();
var sessionAttributesFormField =
document.getElementById('session_attributes_field');
if (sessionAttributesFormField && sessionAttributesEncoded != '') {
sessionAttributesFormField.value = sessionAttributesEncoded;
}
}
window.addEventListener('load', addSessionAttributes);
</script>

---

Daten an Google Ads senden

1. Feld „session_attributes_encoded“ in der Google Ads API

Ab dem 2. Februar 2026 werden in der Google Ads API bei Conversion-Importen keine neuen Nutzer akzeptiert, für die Daten mit Sitzungsattributen oder IP-Adressen verwendet werden. Damit komplexe Daten zuverlässiger und in größerem Umfang verarbeitet werden können, empfehlen wir Google Ads API-Entwicklern, zur Data Manager API zu wechseln. Dort werden Sitzungsattribute und IP-Adressen akzeptiert. Weitere Informationen zu den Änderungen bei der Unterstützung von IP-Adressen und Sitzungsattributen in der Google Ads API

Senden Sie beim Import von Offline-Conversions (OCI) vorhandener Nutzer, für die JavaScript verwendet wird, diese Daten, indem Sie in ihrem vorhandenen Uploadschema die codierten session_attributes, die über das bereitgestellte JavaScript erfasst wurden, in einem neuen Feld namens ClickConversion.session_attributes_encoded angeben. Verwenden Sie weiterhin Ihren aktuellen OCI-Prozess, aber legen Sie bei Importen dieses neue Feld fest. In Google Ads werden session_attributes verwendet, wenn Ihre anderen Kennungen nicht vorhanden sind.

Alle neuen Nutzer müssen die Data Manager API verwenden. Wenn ein Konto nicht auf der Zulassungsliste steht, um IP-Adressen oder Sitzungsattribute über die Google Ads API zu übertragen, wird für diese Conversions ein Fehler gemeldet.

Hinweis: Für den Zugriff auf das neue Feld in der Google Ads API ist ein Upgrade auf v19 oder höher erforderlich.

Erweitert

Wenn Sie JavaScript nicht verwenden können, haben Sie die Möglichkeit, die einzelnen Schlüssel/Wert-Paare zu erfassen und mit Ihren Offline-Conversion-Importen zu senden.

Für Nutzer, bei denen Offline-Conversions ohne JavaScript importiert werden, können Sie das Schlüssel/Wert-Paar-Feld ClickConversion.session_attributes_key_value_pairs auch in ihrem vorhandenen Uploadschema angeben. Wir empfehlen, in API-Aufrufen Schlüssel/Wert-Paare mit diesen Feldern zu senden. In der Entwicklerdokumentation wird beschrieben, wie Sie einer ClickConversion einzelne Schlüssel/Wert-Paare hinzufügen.

Sehen Sie sich die folgenden Empfehlungen an und aktualisieren Sie Ihre Implementierung, damit gültige Daten gesendet werden:

• gad_campaignid (Kampagnen-ID): Achten Sie darauf, dass Sie immer die gültige Google Ads-Kampagnen-ID senden, die mit dem Anzeigenklick verknüpft ist. Das ist die Kampagnen-ID, die in der Anzeigenklick-URL als gad_campaignid=1234 angegeben ist. Dieses Attribut ist von entscheidender Bedeutung für eine korrekte Attribution.
• session_start_time_usec: Senden Sie jedes Mal das Attribut (den Zeitstempel für den Beginn der Nutzersitzung).
• landing_page_url (URL): Achten Sie darauf, die korrekte, vollständige URL der Landingpage zu senden. Senden Sie keine Platzhalterstrings, internen Anwendungspfade oder unvollständigen URLs.
  • Hinweis: Wenn die genaue, vollständige URL nicht verfügbar ist, empfiehlt es sich, das gesamte Feld zu entfernen, da sich falsche Daten negativ auf die Modellierung auswirken können.
• landing_page_user_agent (User-Agent): Der String muss den Browser und das Betriebssystem des Nutzers korrekt wiedergeben. Senden Sie keine generischen oder hartcodierten Werte.

2. Feld „session_attributes“ mit Data Manager

Das Feld session_attributes lässt sich auch über Data Manager senden.

• Data Manager-Benutzeroberfläche: Mit dem bereitgestellten JavaScript können Sie das Feld session_attributes erstellen und über die Data Manager-Benutzeroberfläche hochladen.
• Data Manager API: Sie haben auch die Möglichkeit, die Data Manager API einzubinden, um Ihre Daten programmatisch hochzuladen. Eine Anleitung und Schemadetails finden Sie in der Data Manager-Dokumentation.

Wenn Sie die geeigneten Daten senden, kann Google Ads damit Conversions den entsprechenden Kampagnen zuordnen und umfassendere Conversion-Berichte erstellen.