Referenz

Parameter

Beschreibung der Seitenebenenparameter

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. Der Parameter wird verwendet, wenn Nutzer über die erste Seite mit Suchergebnissen hinausgehen. Beispiel: Wenn fünf Anzeigen angefordert werden und für den Parameter adPage 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 Suchanzeigen.

Beispiel: 

'pubId' : 'test-property'
query Erforderlich, mit Ausnahme von ähnlichen Suchanfragen auf Content-Seiten.
Die vom Nutzer eingegebene Suchanfrage. Der Wert des Suchparameters sollte unverschlüsselt sein.

Hinweis:Wenn Sie diesen Parameter für ähnliche Suchanfragen auf Content-Seiten verwenden, führt dies zu unerwarteten Ergebnissen.

Beispiele: 

'query' : 'flowers'
 
'query' : 'black & decker'
 
'query' : myQuery // myQuery is a 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'
relatedSearchTargeting Erforderlich, wenn sich auf der Seite Anzeigenblöcke für ähnliche Suchanfragen befinden.
Dieser Parameter ist erforderlich, wenn Anzeigenblöcke für ähnliche Suchanfragen angefordert werden. Damit wird festgelegt, welche Art von ähnlichen Suchanfragen je nach Seitenkontext angezeigt wird:
  • 'content' Verwenden Sie diese Option für ähnliche Suchanfragen auf Inhaltsseiten (z.B. Artikel, Blogbeiträge).
  • 'query' Verwenden Sie diese Option ausschließlich für ähnliche Suchanfragen auf Suchergebnisseiten.

Hinweis:Der Seitenparameter „relatedSearchTargeting“ ist standardmäßig auf „query“ gesetzt. Dieser Standardwert ist jedoch nur für Suchergebnisseiten vorgesehen (ähnliche Suchanfragen in der Google Suche). Wenn Sie die ähnliche Suche auf einer anderen Art von Seite verwenden (z.B. Artikel, Blogbeiträge), müssen Sie den Parameter explizit auf „content“ festlegen.

Hinweis:Für diesen Parameter gelten folgende Richtlinien:

  • Je nach Wert dieses Seitenparameters können bestimmte Funktionen für ähnliche Suchanfragen aktiviert oder deaktiviert werden.
  • Die Falschdarstellung des Seitentyps oder die Verwendung der Standardeinstellung „query“ für den Parameter „relatedSearchTargeting“ auf Seiten, die keine Suchergebnisseiten sind, gilt als Verstoß gegen diese schriftlichen Anweisungen.
  • Google überprüft die Richtigkeit dieses Werts möglicherweise regelmäßig, unabhängig davon, ob er manuell oder mit dem Standardwert festgelegt wurde.

Beispiele:

'relatedSearchTargeting' : 'content'
 
'relatedSearchTargeting' : 'query'
styleId Erforderlich
Gibt die ID des benutzerdefinierten Designs an, das auf die Anzeige oder Anzeigenblöcke für ähnliche Suchanfragen auf der Seite angewendet werden soll. Weitere Informationen 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.
  • '_top' Wird im selben Fenster geöffnet.
  • '_blank' Wird in einem neuen Fenster geöffnet.

Beispiel: 

'linkTarget' : '_blank'
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 Traffic verwendet werden, den Sie absichtlich von anderen Websites erhalten, und nicht für organischen Traffic.
  • Er sollte die Titelzeile, die Beschreibung und/oder andere Formulierungen in der Anzeige oder im Link-Creative enthalten.
  • Wenn Sie Werte aus dem Creative der Anzeige oder des Links weglassen oder zusätzliche Werte hinzufügen, gilt das als Verstoß gegen diese schriftlichen Anweisungen.
  • Die Groß- und Kleinschreibung wird nicht berücksichtigt.
  • Er kann mit gültiger UTF-8-Codierung sowie Unicode- und diakritischen Zeichen erstellt werden.
  • 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.

Hinweis:Dieser Parameter ist erforderlich, wenn der Parameter terms verwendet wird.

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.

Hinweis:Wenn Sie diesen Parameter verwenden, ist auch referrerAdCreative erforderlich. Außerdem muss relatedSearchTargeting auf „content“ festgelegt sein.

Beispiele: 

'terms' : 'cars rental, flight ticket'
ignoredPageParams Optional
Liste der URL-Parameter für eine Inhaltsseite mit einem Anzeigenblock für ähnliche Suchanfragen für Inhalte, die ignoriert werden können, ohne dass sich das auf die Hauptinhalte oder die Nutzerfreundlichkeit auswirkt.

Hinweis:Bevor ähnliche Suchbegriffe auf Ihrer Website angezeigt werden können, muss Google Ihre Seiten crawlen, um sicherzustellen, dass die Begriffe kontextuell relevant sind. Wenn eine Seite noch nicht vom AdSense-Crawler gecrawlt wurde oder das Crawling durch eine robots.txt-Datei blockiert ist, werden keine von Ihnen angegebenen Vorschläge für ähnliche Suchanfragen angezeigt.

Das Produkt „Ähnliche Suchanfragen zu Inhalten“ nutzt das Crawling-System von Google, um Seiten zu indexieren und relevante Suchbegriffe zu generieren. URLs von Inhaltsseiten, die Suchparameter wie Tracking-Variablen, Nutzer-IDs, Sitzungs-IDs oder andere dynamische Kennungen enthalten, können die Fähigkeit des Crawlers beeinträchtigen, den Hauptinhalt der Seite zu bewerten, und zu ungenauen oder irrelevanten ähnlichen Suchbegriffen führen. Mit diesem Seitenparameter wird der Google-Crawler angewiesen, diese nicht erforderlichen Parameter zu ignorieren. So wird eine ordnungsgemäße Inhaltsindexierung sichergestellt und unnötige Crawling-Last reduziert. So kann Google besser erkennen, dass eine Seite bereits gecrawlt wurde, und Vorschläge für Suchbegriffe anzeigen (sowohl von Google als auch vom Partner, sofern zutreffend).

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.
  • Der Wert dieses Parameters sollte eine durch Kommas getrennte Liste von URL-Parametern sein, die angezeigt werden können, wenn ein Nutzer die Inhaltsseite aufruft.
  • Die Groß- und Kleinschreibung wird berücksichtigt.
  • Wenn ein URL-Parameter aus dieser Liste aus der URL der Inhaltsseite entfernt wird, sollte dies keine wesentlichen Auswirkungen auf den Inhalt, das Aussehen oder die Nutzerfreundlichkeit der Seite haben.
  • Das Einfügen eines URL-Parameters, der sich erheblich auf den Inhalt, das Erscheinungsbild oder die Nutzerfreundlichkeit der Seite auswirkt, gilt als Verstoß gegen diese schriftlichen Anweisungen.
  • Google kann die Auswirkungen des Ignorierens der angegebenen URL-Parameter regelmäßig überprüfen.

Beispiele:
Ein Nutzer besucht eine Inhaltsseite mit der folgenden URL: 

http://example.com/content?utm_medium=social&page_id=123&click_id=456
 Geben Sie die folgenden ignorierbaren URL-Parameter an: 
'ignoredPageParams' : 'utm_medium,click_id,session_ref'
 Die URL der Inhaltsseite wird so behandelt: 
http://example.com/content?page_id=123

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 sexuellem Inhalt für Erwachsene werden nicht zurückgegeben.
  • 'medium' Gibt jugendfreie und nicht jugendfreie Anzeigen zurück. Gibt keine Anzeigen mit sexuellem Inhalt zurück.
  • 'low': Gibt alle Anzeigentypen zurück.

Standardmäßig ist „adsafe“ auf „high“ festgelegt.

Beispiel: 

'adsafe': 'medium'
adtest Optional
Der Parameter „adtest“ gibt an, dass es sich bei einer Anzeigenanfrage um einen Test handelt. Wenn der Parameter „adtest“ den Wert on hat, behandelt Google die Anfrage als Test und zählt die Anzeigenimpressionen nicht und erfasst die Klickergebnisse nicht.

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

Anzeigenanfragen mit dem Parameter „adtest“ auf on, die von einer Domain stammen, die nicht auf dem Tab „Websites“ genehmigt wurde, geben nicht anklickbare Anzeigen mit dem Overlay „Testanzeige“ zurück.

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 für „adtest“ ist „off“.

Beispiel: 

'adtest' : 'on'
channel Optional
Sie können einen AdSense für Suchergebnisseiten-Channel einfügen, um die Leistung verschiedener Seiten zu erfassen. Verwenden Sie die eindeutige Channel-ID, die in Ihrem AdSense-Konto oder von Ihrem Technical Account Manager erstellt wurde. Weitere Informationen zu Kanälen

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 oder ähnlichen Suchanfragen ausgerichtet sein sollen. Der Standardwert ist en.

Google unterstützt alle AdWords API-Sprachcodes.

Hinweis: Inserenten geben die Sprachen an, auf die ihre Anzeigen abzielen. Wenn Sie diesen Parameter in Ihre Anfrage einschließen, gibt Google nur Anzeigen zurück, die auf diese Sprache oder auf alle Sprachen abzielen. Wir können jedoch nicht garantieren, dass der Anzeigentext in der angegebenen Sprache angezeigt wird.

Normalerweise sollten Sie den Parameter „hl“ 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 ist utf-8.

Wert Standardname Verknüpfte unterstützte Sprachen
latin1 ISO-8859-1 Westeuropäisch (Dänisch, Deutsch, 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
arabic ISO-8859-6  
Griechisch ISO-8859-7 Griechisch
hebrew 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

Mit dem Parameter oe legen Sie das Zeichencodierungsschema fest, das Google zum Codieren des Texts der Anzeigen verwenden soll. Aus technischer Sicht ist dies optional. Wir empfehlen jedoch, trotzdem einen Wert für diesen Parameter anzugeben.

Der Standardwert für oe ist utf-8.

Wert Standardname Verknüpfte unterstützte Sprachen
latin1 ISO-8859-1 Westeuropäisch (Dänisch, Deutsch, 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
arabic ISO-8859-6  
Griechisch ISO-8859-7 Griechisch
hebrew 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
ivt Optional
Mit diesem Parameter können Sie Google mitteilen, dass Sie Anzeigen zulassen möchten, bei denen Cookies zur Erkennung ungültiger Zugriffe und lokale Speicherung sowohl für Traffic mit als auch ohne Einwilligung verwendet werden.
  • true Wenn dieser Parameter nicht vorhanden ist oder Sie ihn auf „wahr“ setzen, setzen wir ein Cookie zur Erkennung ungültiger Zugriffe und verwenden die lokale Speicherung nur bei Zugriffen mit Einwilligung.
  • false Wenn Sie diesen Parameter auf „false“ (falsch) setzen, setzen wir ein Cookie zur Erkennung ungültiger Zugriffe und verwenden die lokale Speicherung sowohl für Zugriffe mit als auch ohne Einwilligung.

Standardmäßig ist „IVT“ auf „true“ festgelegt.

Beispiel: 

'ivt': false

Beschreibung der Blockebenenparameter

Diese Parameter beeinflussen die Art und Weise, wie individuelle Anzeigenblöcke auf einer Seite dem Nutzer präsentiert werden. Jeder Parameter kann einzeln für jeden Anzeigenblock festgelegt werden.

Erforderlich

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

Beispiel: 

'container' : 'afscontainer1'
maxTop Erforderlich, wenn sich der Anzeigenblock über den Suchergebnissen befindet.

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 Parameter „maxTop“ darf für kein anderes Placement auf der Seite verwendet werden. Dies wäre ein Richtlinienverstoß.

Beispiel:

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

Beispiel: 

'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 der Anzeigen, die in diesem Anzeigenblock eingeblendet werden sollen. Der Standardwert liegt bei 2.

Beispiel: 

'number' : 4
relatedSearches Optional
Die Anzahl ähnlicher Suchanfragen, die in diesem Anzeigenblock eingeblendet werden sollen. Wenn keine Angabe gemacht wird, ist der Standardwert 0.

Beispiel: 

'relatedSearches' : 4