Referenz

Parameter

Beschreibung der Seitenebenenparameter

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

Erforderlich

Parameter Beschreibung und Beispiele
adPage Erforderlich, wenn der Nutzer zur nächsten oder vorherigen Ergebnisseite navigiert.

Der Parameter adPage gibt die Ergebnisseite an, auf der Anzeigen ausgeliefert werden. Der Parameter wird verwendet, wenn Nutzer über die erste Seite mit Suchergebnissen hinausgehen. Wenn beispielsweise fünf Anzeigen angefordert werden und der Parameter adPage auf 2 gesetzt ist, werden die zurückgegebenen Anzeigen auf der zweiten Seite mit fünf Anzeigen präsentiert.

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

Beispiel:

'pubId' : 'test-property'

query Erforderlich
Das ist die vom Nutzer eingegebene Suchanfrage. Der Wert des Abfrageparameters darf nicht codiert sein.

Beispiele:

'query' : 'flowers'
'query' : 'black & decker'
'query' : myQuery // myQuery is a variable containing the search query

resultsPageBaseUrl Erforderlich, wenn die Seite Anzeigenblöcke für ähnliche Suchanfragen enthält.
Gibt die URL der Suchergebnisseite an, auf der die Suchanfrage dem ähnlichen Suchbegriff ist, auf den der Nutzer geklickt hat. Die 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 benutzerdefinierten Designs an, das auf die Anzeige oder Anzeigenblöcke für ähnliche Suchanfragen auf der Seite angewendet werden soll. Weitere Informationen zur Verwendung benutzerdefinierter Designs Wenn die styleId für eine Anfrage festgelegt ist, werden Anzeigen oder ähnliche Suchanfragen mit diesem Design gerendert. Ältere Stilparameter werden ignoriert. Ist „styleId“ nicht in der Anfrage angegeben, wird ein Systemstandardstil gerendert.

Beispiel:

'styleId': '1234567890'

Optional

Parameter Beschreibung und Beispiele
linkTarget Optional
Gibt an, ob ein Klick auf eine Anzeige im selben oder in einem neuen Fenster geöffnet wird. Der Standardwert ist „_top“. Dieser Parameter kann auch auf Anzeigenblockebene verwendet werden.
  • '_top' wird im selben Fenster geöffnet.
  • '_blank' Wird in einem neuen Fenster geöffnet.

Beispiel:

'linkTarget' : '_blank'

maxTermLength Optional
Gibt die maximale Anzahl von Zeichen eines ähnlichen Suchbegriffs an, einschließlich Leerzeichen. Kein Höchstwert, wenn nicht festgelegt.

Beispiel:

'maxTermLength' : 50

referrerAdCreative Optional
Wenn ein Nutzer durch Klicken auf eine Anzeige oder einen Link auf einer anderen Website auf Ihre Inhaltsseite gelangt, die einen Anzeigenblock für ähnliche Suchanfragen für Content enthält, und von Ihnen gesteuert wird, sollte dieser Parameter wortgetreu auf den Creative-Text der Anzeige oder des Links festgelegt werden.

Für die Verwendung dieses Parameters gelten die folgenden Richtlinien:

  • Er sollte nur bei einer Anfrage für ähnliche Suchanfragen für Inhalte angegeben werden. Bei allen anderen Anfragen wird er ignoriert.
  • Es sollte nur für Zugriffe verwendet werden, die Sie absichtlich von anderen Websites erhalten, und niemals für organische Zugriffe.
  • Es kann die Titelzeile und/oder die Beschreibung der Anzeige oder des Link-Creatives enthalten.
  • Die Groß-/Kleinschreibung wird nicht berücksichtigt.
  • Er akzeptiert eine gültige UTF-8-Codierung; Unicode-Zeichen und diakritische Zeichen werden unterstützt.
  • Google kann den von Ihnen eingereichten Parameter verwenden oder ignorieren. Wenn er verwendet 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 standardmäßig „q“ verwendet.

Beispiel:

'resultsPageQueryParam' : 'query'

terms Optional
Mit diesem Parameter können Sie eine durch Kommas getrennte Liste Ihrer eigenen ähnlichen Suchbegriffe angeben, die bei einer ähnlichen Suchanfrage zurückgegeben werden. Google kann die hier angegebenen Begriffe verwenden oder auch nicht.

Beispiele:

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

Die Standardeinstellung für „adsafe“ ist „hoch“.

Beispiel:

'adsafe': 'medium'

adtest Optional
Mit dem Parameter „adtest“ wird angegeben, 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 weder die Anzeigenimpressionen noch die Klickergebnisse.

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

Verwenden Sie diesen Parameter nur für Tests, aber 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 hinzufügen, um die Leistung verschiedener Seiten zu erfassen. Verwenden Sie die eindeutige Kanal-ID, die in Ihrem AdSense-Konto oder von Ihrem Technical Account Manager erstellt wurde. Weitere Informationen zu Channels

Mehrere Kanäle müssen durch ein Pluszeichen (+) getrennt werden.

Beispiele:

'channel' :  'testA'  
'channel' :  'testA+testB'  

hl Optional
Mit diesem Parameter wird die Sprache festgelegt, auf die die angeforderten Anzeigen oder ähnlichen Suchanfragen ausgerichtet werden 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

Der Parameter ie legt das Zeichencodierungsschema fest, das zur Interpretation 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  
Grieche / Griechin / griechisch / 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 wird das Zeichencodierungsschema festgelegt, mit dem Google den Text der Anzeigen codieren soll. Aus technischer Sicht optional, empfiehlt es sich jedoch, einen Wert für diesen Parameter zu übergeben.

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  
Grieche / Griechin / griechisch / 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
Über diesen Parameter können Sie einen booleschen Wert angeben, der Google darüber informiert, dass Anzeigen zulässig sind, bei denen ein Cookie für ungültige Zugriffe und lokale Speicherung sowohl für Zugriffe mit als auch für solche ohne Einwilligung verwendet werden.
  • true Wenn dieser Parameter nicht vorhanden ist oder Sie ihn auf „true“ setzen, wird ein Cookie für ungültige Zugriffe gesetzt und die lokale Speicherung nur für Zugriffe mit Einwilligung verwendet.
  • false Wenn Sie diesen Parameter auf „false“ setzen, wird ein Cookie für ungültige Zugriffe gesetzt und die lokale Speicherung sowohl bei Zugriffen mit als auch ohne Einwilligung verwendet.

Die Standardeinstellung für ungültige Zugriffe ist „true“.

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 erscheinen soll.

Beispiel:

'container' : 'afscontainer1'

maxTop Erforderlich, wenn sich der Anzeigenblock über den Suchergebnissen befindet.

Mit diesem Parameter können Sie die Anzahl der Anzeigen angeben, 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. Die Verwendung des maxTop-Parameters in einem anderen Placement auf der Seite stellt einen Richtlinienverstoß dar.

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 wenn keine Anzeigen oder ähnlichen Suchanfragen ausgeliefert werden. Der Parameter muss auf eine von Ihnen implementierte JavaScript-Callback-Funktion festgelegt werden, mit der 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 angezeigt werden soll, und auf „false“, wenn keine Anzeigen oder ähnlichen Suchanfragen zurückgegeben werden.
isExperimentVariant Legen Sie den Wert auf „true“ fest, wenn ein Test für benutzerdefinierte Stile ausgeführt wird und die Testvariante zum Rendern der Anzeigen ausgewählt wird.
callbackOptions Ein JSON-Objekt mit den folgenden Feldern:
termPositions: Enthält bei einem Block für ähnliche Suchanfragen einen „map<string,int>“ mit vom Publisher bereitgestellten Begriffen für eine nullindexierte Position dieser Begriffe in der Antwort. Wenn ein Begriff angegeben, aber nicht zurückgegeben wird, erscheint er nicht in der Karte.

Hinweis: Teste deine Callback-Funktion, um sicherzustellen, dass sie keine Fehler generiert. Dies gilt insbesondere für Fehler, die das Laden deiner 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 ausgeliefert werden sollen. Der Standardwert liegt bei 2.

Beispiel:

'number' : 4

relatedSearches Optional
Die Anzahl ähnlicher Suchanfragen, die in diesem Anzeigenblock angezeigt werden sollen. Wenn keine Angabe erfolgt, wird standardmäßig 0 verwendet.

Beispiel:

'relatedSearches' : 4