Benachrichtigung

Auf der Seite „Mein AdSense“ finden Sie kontospezifische Informationen dazu, wie Sie AdSense optimal nutzen.

Anzeigen für Suchergebnisseiten

Beschreibung der Parameter für benutzerdefinierte Suchanzeigen

Die folgende Liste der derzeit unterstützten Parameter für Designs richtet sich an fortgeschrittene Nutzer. Der Code, den Sie in AdSense erzeugen, enthält alle am häufigsten verwendeten Parametereinstellungen. Zwei Parameter sind immer erforderlich: pubId und query. AdSense stellt die Publisher-ID (pubId) bereit, aber Sie müssen den Code bearbeiten und einen Wert für den query-Parameter übergeben. Alle anderen Parameter sind optional und werden nachfolgend beschrieben.

Parametertypen

Es gibt zwei Parametertypen:

Unten finden Sie ein paar Ausgabebeispiele des Codegenerators mit zwei Anzeigenblöcken. Zum Konfigurieren dieses Codes müssen Sie den erforderlichen query-Parameter in der pageOptions-Zuordnung festlegen (z. B."query": myQuery). Mehr ist nicht notwendig, um mit dem Ausliefern von Anzeigen zu beginnen. Sie können außerdem optionale Parameter auf Seitenebene im Anzeigenblock und individuelle Parameter auf Blockebene in den Zuordnungen adblock1 und adblock2 festlegen.

<div id="afscontainer1"></div>
<div id="afscontainer2"></div>

<script type="text/javascript" charset="utf-8">

  // Page level parameters
  var pageOptions = {
    "pubId": "partner-pub-1234567891234567",
    "styleId": "1234567890",
    "query": myQuery,
  };

  // Unit level parameters
  var adblock1 = {
    "container": "afscontainer1"
  };

  var adblock2 = {
    "container": "afscontainer2"
  };

  _googCsa('ads', pageOptions, adblock1, adblock2);

</script>

Beschreibung der Parameter auf Seitenebene

Diese Parameter müssen nur einmal pro Seite angegeben werden und wirken sich auf alle Anzeigenblöcke auf der Seite aus.

Erforderlich

Parameter Beschreibung und Beispiele
adPage Erforderlich, wenn der Nutzer die nächste oder vorherige Ergebnisseite aufruft.

Der Parameter adPage gibt die Ergebnisseite an, auf der Anzeigen präsentiert werden. Er wird verwendet, wenn Nutzer über die erste Seite mit Suchergebnissen hinausgehen. Beispiel: Wenn fünf Anzeigen angefordert werden und für den adPage-Parameter der Wert „2“ festgelegt wurde, wird die zweite Ergebnisseite mit fünf Anzeigen zurückgegeben.

pubId Erforderlich
Ihre AdSense-Client-ID. Die pubId ist der Teil Ihrer Client-ID hinter „partner-“. Wenn Ihre Client-ID z. B. „partner-test-property“ lautet, ist Ihre pubId „test-property“. Dies ist das Standardprotokoll für CSA.

Beispiel:

'pubId' : 'test-property'
query Erforderlich
Die vom Nutzer eingegebene Suchanfrage. Der Wert des Suchparameters sollte unverschlüsselt sein.

Beispiele:

'query' : 'flowers'

'query' : 'black & decker'

'query' : myQuery // where myQuery is a JavaScript variable containing the search query

resultsPageBaseUrl Erforderlich, wenn sich auf der Seite Anzeigenblöcke für ähnliche Suchanfragen befinden
Gibt die URL der Suchergebnisseite an, auf der die Suchanfrage der ähnliche Suchbegriff ist, auf den der Nutzer geklickt hat. resultsPageBaseUrl kann eigene Parameter enthalten, mit Ausnahme der Suchanfrage, die automatisch angehängt wird.

Beispiel:

'resultsPageBaseUrl' : 'http://www.example.com/search?a=v1&b=v2'

styleId Erforderlich
Gibt die ID des Designs an, das auf die Anzeige oder Anzeigenblöcke für ähnliche Suchanfragen auf der Seite angewendet werden soll. Weitere Informationen zur Verwendung von Designs für die Suche Hinweis: Wenn der styleId-Parameter in einer Anzeigenanfrage angegeben ist, werden Anzeigen oder ähnliche Suchanfragen mit diesem Design gerendert. Ältere Design-Parameter werden ignoriert. Wenn „styleId“ nicht angegeben ist, wird das standardmäßige Design des Systems gerendert.

Beispiel

'styleId': '1234567890'

Optional

Parameter Beschreibung und Beispiele
linkTarget Optional
Gibt an, ob die Seite nach einem Anzeigenklick im selben oder in einem neuen Fenster geöffnet werden soll. Der Standardwert ist '_top'. Dieser Parameter kann auch auf Blockebene verwendet werden.
  • Mit '_top' wird die Seite im selben Fenster geöffnet.
  • Mit '_blank' erscheint sie in einem neuen Fenster.

Beispiel:

'linkTarget' : '_blank'
maxTermLength Optional
Mit diesem Parameter wird die maximale Anzahl von Zeichen eines ähnlichen Suchbegriffs angegeben, einschließlich Leerzeichen. Ohne diesen Parameter gilt keine Zeichenbeschränkung.

Beispiel:

'maxTermLength' : 50
referrerAdCreative Optional
Wird verwendet, wenn ein Nutzer auf Ihre Content-Seite mit einem Anzeigenblock für ähnliche Suchanfragen für Content-Seiten gelangt, nachdem er auf eine Anzeige oder einen Link auf einer anderen Website geklickt hat und diese Anzeige bzw. dieser Link von Ihnen verwaltet wird. Der Parameter sollte Wort für Wort auf den Text der Anzeige oder des Links festgelegt werden.

Für diesen Parameter gelten folgende Richtlinien:

  • Er sollte nur bei einer Anfrage für ähnliche Suchanfragen für Content-Seiten bereitgestellt werden. Bei allen anderen Anfragen wird er ignoriert.
  • Er sollte nur für Zugriffe verwendet werden, die Sie absichtlich von anderen Websites erhalten, und niemals für organische Zugriffe.
  • Er kann die Titelzeile und/oder die Beschreibung der Anzeige oder des Link-Creatives enthalten.
  • Die Groß- und Kleinschreibung wird nicht berücksichtigt.
  • Er kann mit gültiger UTF-8-Codierung sowie Unicode- und diakritischen Zeichen erstellt wenden.
  • Google kann den von Ihnen angegebenen Parameter verwenden oder ignorieren. Wenn er genutzt wird, kann er sich auf die Auswahl und das Ranking der Begriffe auswirken.

Beispiele:

'referrerAdCreative': 'search for ads related to dental implants'
'referrerAdCreative': 'The Early Signs of Psoriatic Arthritis'
resultsPageQueryParam Optional
Gibt den Namen des URL-Parameters für die Suchanfrage auf der Suchergebnisseite an. Wenn keine Angabe erfolgt, wird der Standardwert „q“ verwendet.

Beispiel:

'resultsPageQueryParam' : 'query'
terms Optional
Mit diesem Parameter können Sie eine durch Kommas getrennte Liste Ihrer eigenen ähnlichen Suchbegriffe angeben, die zusammen mit einer ähnlichen Suchanfrage zurückgegeben werden. Google kann diese Begriffe verwenden oder ignorieren.

Beispiel:

'terms' : 'cars rental, flight ticket'

Konfigurationseinstellungen

Parameter Beschreibung und Beispiele
adsafe Optional
Gibt die Filterregeln an, die Google auf Anzeigen anwenden soll, die der Suchanfrage entsprechen. Im Folgenden finden Sie die gültigen Einstellungen für adsafe und die Auswirkungen jedes Werts auf zurückgegebene Anzeigen:
  • 'high': Gibt jugendfreie Anzeigen zurück. Nicht jugendfreie Anzeigen oder solche mit pornografischem Content für Erwachsene werden nicht zurückgegeben.
  • 'medium': Gibt jugendfreie und nicht jugendfreie Anzeigen zurück. Gibt keine Anzeigen mit pornografischem Content zurück.
  • 'low': Gibt alle Anzeigentypen zurück.
Hinweis: Die Standardeinstellung für adsafe ist „high“.

Beispiel:

'adsafe': 'medium'
adtest Optional
Der Parameter adtest kennzeichnet eine Anzeigenanfrage als Test. Wenn der adtest-Parameter den Wert „on“ hat, werden die Anzeigenimpressionen von Google nicht gezählt und die Klickergebnisse werden nicht erfasst.

Hat der Parameter adtest den Wert „on“, erzielen Sie somit keinen Umsatz.

Hinweis: Verwenden Sie diesen Parameter nur für Testzwecke, jedoch nicht in Produktionssystemen. Andernfalls erhalten Sie keine Vergütung für die bei Ihnen ausgelieferten Anzeigen.

Der Standardwert von adtest lautet „off“.

Beispiel:

'adtest' : 'on'
channel Optional
Sie können AdSense für Suchergebnisseiten-Channels einfügen, um die Leistung verschiedener Seiten zu erfassen. Verwenden Sie die eindeutige Channel-ID, die Sie in Ihrem AdSense-Konto erstellt haben. Weitere Informationen finden Sie im Hilfeartikel Anzeigenleistung mit benutzerdefinierten Channels erfassen.

Mehrere Channels sollten durch ein Plussymbol (+) getrennt werden.
 

Beispiele:

'channel' : 'testA'
'channel' : 'testA+testB'
hl Optional
Dieser Parameter gibt die Sprache an, auf die die angeforderten Anzeigen ausgerichtet sein sollen. Der Standardwert lautet „en“.

Google unterstützt alle Google Ads API-Sprachcodes.

Hinweis: Werbetreibende geben die Sprachen an, auf die ihre Anzeigen ausgerichtet sind. Wenn Sie diesen Parameter in Ihre Anfrage aufnehmen, gibt Google nur Anzeigen zurück, die auf die von Ihnen angegebene Sprache oder auf alle Sprachen ausgerichtet sind. Es kann jedoch nicht garantiert werden, dass der Anzeigentext tatsächlich in der angegebenen Sprache verfasst ist.

Normalerweise sollten Sie den hl-Parameter auf die primäre Sprache der Seite festlegen, von der dieser Parameter gesendet wird.

Beispiele:

'hl' : 'es'
ie Optional

Mit dem Parameter ie legen Sie das Zeichencodierungsschema fest, das zur Auswertung des Abfragestrings verwendet werden soll.

Der Standardwert für ie lautet „utf-8“.

Wert Standardname Verknüpfte unterstützte Sprachen
latin1 ISO-8859-1 Westeuropäisch (Deutsch, Dänisch, Englisch, Finnisch, Französisch, Indonesisch, Italienisch, Katalanisch, Niederländisch, Norwegisch, Portugiesisch, Schwedisch, Spanisch)
latin2 ISO-8859-2 Osteuropäisch (Kroatisch, Polnisch, Rumänisch, Serbisch, Slowakisch, Slowenisch, Tschechisch, Ungarisch)
latin3 ISO-8859-3  
latin4 ISO-8859-4 Baltisch (Estnisch, Lettisch, Litauisch)
Kyrillisch ISO-8859-5 Bulgarisch, Russisch
Arabisch ISO-8859-6  
Griechisch ISO-8859-7 Griechisch
Hebräisch ISO-8859-8 Hebräisch
latin5 ISO-8859-9  
latin6 ISO-8859-10 Isländisch
euc-jp EUC-JP Japanisch
euc-kr EUC-KR Koreanisch
sjis Shift_JIS Japanisch
big5 Big5 Chinesisch (traditionell)
GB GB2312 Chinesisch (vereinfacht)
utf-8 UTF-8 Alle
oe Optional

Der Parameter oe bestimmt das Zeichencodierungsschema, mit dem Google den Text der Anzeigen codieren soll. Aus technischer Sicht ist dies optional. Wir empfehlen jedoch, trotzdem einen Wert für diesen Parameter anzugeben.

Der Standardwert für oe lautet „utf-8“.

Wert Standardname Verknüpfte unterstützte Sprachen
latin1 ISO-8859-1 Westeuropäisch (Deutsch, Dänisch, Englisch, Finnisch, Französisch, Indonesisch, Italienisch, Katalanisch, Niederländisch, Norwegisch, Portugiesisch, Schwedisch, Spanisch)
latin2 ISO-8859-2 Osteuropäisch (Kroatisch, Polnisch, Rumänisch, Serbisch, Slowakisch, Slowenisch, Tschechisch, Ungarisch)
latin3 ISO-8859-3  
latin4 ISO-8859-4 Baltisch (Estnisch, Lettisch, Litauisch)
Kyrillisch ISO-8859-5 Bulgarisch, Russisch
Arabisch ISO-8859-6  
Griechisch ISO-8859-7 Griechisch
Hebräisch ISO-8859-8 Hebräisch
latin5 ISO-8859-9  
latin6 ISO-8859-10 Isländisch
euc-jp EUC-JP Japanisch
euc-kr EUC-KR Koreanisch
sjis Shift_JIS Japanisch
gb GB2312 Chinesisch (vereinfacht)
utf-8 UTF-8 Alle
personalizedAds Optional
Gibt an, ob der Publisher die Einwilligung der Nutzer hat, um personenbezogene Daten für personalisierte Anzeigen an Google weiterzugeben.
  • true: gibt Anzeigen mit Abfragen-Targeting und einige Anzeigen zurück, deren Targeting über die Google-Cookies des Nutzers erfolgt. Wenn sich der Nutzer in der EU befindet, muss er für Ihre Website erst einwilligen, dass personenbezogene Daten für personalisierte Anzeigen an Google weitergegeben werden dürfen.
  • false: gibt nur Anzeigen mit Abfragen-Targeting zurück. Anzeigen, deren Targeting über die Google-Cookies des Nutzers erfolgt, werden mit dieser Einstellung nicht zurückgegeben. Wenn ein Nutzer für Ihre Website nicht eingewilligt hat, dass personenbezogene Daten für personalisierte Werbung an Google weitergegeben werden dürfen, müssen Sie als Wert für diesen Parameter „false“ angeben.
Hinweis: Die Standardeinstellung für personalizedAds ist „true“.

Beispiel:

'personalizedAds': false

Beschreibung der Parameter auf Anzeigenblockebene

Diese Parameter beeinflussen die Art und Weise, wie einzelne Anzeigenblöcke auf einer Seite dem Nutzer präsentiert werden. Alle Parameter können für jeden Anzeigenblock individuell festgelegt werden.

Erforderlich

Parameter Beschreibung und Beispiele
container Erforderlich
Die ID des leeren Anzeigencontainers <div id='afscontainer1'></div>, in dem die Anzeige eingeblendet werden soll.

Beispiel:

'container' : 'afscontainer1'
maxTop Erforderlich

Mit diesem Parameter können Sie die Anzahl von Anzeigen festlegen, die im oberen Anzeigenblock ausgeliefert werden sollen.

Hinweis: Dieser Parameter wird anstelle des Parameters number verwendet. Der Anzeigenblock sollte so breit sein, dass die erste Zeile der Anzeigen nicht umgebrochen wird. Der maxTop-Parameter darf für kein anderes Placement auf der Seite verwendet werden. Dies wäre ein Richtlinienverstoß.

Beispiel:

'maxTop' : 4
width Erforderlich
Gibt die Breite des Anzeigenblocks oder Anzeigenblocks für ähnliche Suchanfragen in Pixeln an.

Beispiele:

'width' : '700px'
'width' : 700

Konfigurationseinstellungen

Parameter Beschreibung und Beispiele
adLoadedCallback Optional
Gibt eine JavaScript-Funktion an, die aufgerufen wird, wenn Anzeigen oder ähnliche Suchanfragen geladen wurden oder nichts ausgeliefert wird. Der Parameter sollte auf eine von Ihnen implementierte JavaScript-Callback-Funktion festgelegt werden, sodass nach Abschluss des Anzeigenaufrufs eine Aktion ausgeführt werden kann.

Die Callback-Funktion verwendet folgende Parameter:

containerName Containername der Anzeige oder des Anzeigenblocks für ähnliche Suchanfragen.
adsLoaded Wird auf „true“ gesetzt, wenn mindestens eine Anzeige oder ein ähnlicher Suchbegriff geladen wurden, und auf „false“, wenn nichts zurückgegeben wird.
isExperimentVariant Wird auf „true“ gesetzt, wenn ein benutzerdefiniertes Design getestet und die Testvariante für das Rendering der Anzeigen ausgewählt wird.
callbackOptions Ein JSON-Objekt mit folgenden Feldern:

termPositions: Enthält bei einem Anzeigenblock für ähnliche Suchanfragen eine vom Publisher bereitgestellte map<string,int>-Zuordnung für die nullindizierte Position dieser Anfragen in der Antwort. Wenn ein Suchbegriff angegeben, aber nicht zurückgegeben wird, erscheint er nicht in der Zuordnung.

Hinweis: Sie sollten die Callback-Funktion testen, damit keine Fehler auftreten, insbesondere solche, die das Laden der Seite beeinträchtigen könnten.

Beispiel für einen JavaScript-Callback:

var adblock1 = {
  'container' : 'adblock1_div_id',
  'adLoadedCallback' : function(containerName, adsLoaded,
    isExperimentVariant, callbackOptions) {
    if (adsLoaded) {
       try {
         // most likely do nothing
       } catch (e) {
         alert ("Error in callback function");
         // Do something to handle error gracefully
       }
    } else {
       // as you always do when there is no ad coverage from Google
    }
  }
};
number Optional
Die Anzahl von Anzeigen, die in diesem Anzeigenblock eingeblendet werden sollen. Der Standardwert lautet „2“.

Beispiel:

'number' : 4 
relatedSearches Optional
Die Anzahl ähnlicher Suchanfragen, die in diesem Anzeigenblock eingeblendet werden sollen. Dieser Parameter gibt mindestens drei ähnliche Suchanfragen zurück, sofern er nicht auf null gesetzt ist. Ist keine Angabe vorhanden, wird standardmäßig „0“ verwendet.

Beispiel:

'relatedSearches' : 4

War das hilfreich?

Wie können wir die Seite verbessern?
Suche
Suche löschen
Suche schließen
Google-Apps
Hauptmenü
2766071731804837208
true
Suchen in der Hilfe
true
true
true
true
true
157
false
false