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 die nächste oder vorherige Ergebnisseite aufruft. Der Parameter |
pubId
|
Erforderlich Dies ist Ihre AdSense-Client-ID. Ihre Publisher-ID ist der Teil Ihrer Client-ID hinter „partner-“. Wenn Ihre Client-ID beispielsweise „partner-test-property“ lautet, ist Ihre Publisher-ID „test-property“. Dies ist das Standardprotokoll für benutzerdefinierte Suchanzeigen. Beispiel: 'pubId' : 'test-property' |
query
|
Erforderlich Das ist die Suchanfrage, die vom Nutzer eingegeben wurde. Der Wert des Suchparameters sollte nicht codiert sein. Beispiele: 'query' : 'flowers' 'query' : 'black & decker' 'query' : myQuery // myQuery is a variable containing the search query |
resultsPageBaseUrl
|
Erforderlich, wenn auf der Seite ähnliche Anzeigenblöcke vorhanden sind. Gibt die URL der Suchergebnisseite an, auf der die Suchanfrage der ähnliche 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 ähnliche Anzeigenblöcke auf der Seite angewendet werden soll. Weitere Informationen zu benutzerdefinierten Designs Wenn „styleId“ für eine Anfrage festgelegt ist, werden Anzeigen oder ähnliche Suchanfragen mit diesem Stil gerendert. Ältere Stilparameter werden ignoriert. Wenn styleId nicht in der Anfrage angegeben ist, 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 einem neuen Fenster geöffnet wird. Der Standardwert ist „_top“. Dieser Parameter kann auch auf Anzeigenblockebene verwendet werden.
Beispiel: 'linkTarget' : '_blank' |
maxTermLength
|
Optional Gibt die maximale Anzahl von Zeichen eines ähnlichen Suchbegriffs einschließlich Leerzeichen an. Kein Höchstwert, wenn nicht festgelegt. Beispiel: 'maxTermLength' : 50 |
referrerAdCreative
|
Optional Falls ein Nutzer auf Ihre Content-Seite mit einem Anzeigenblock für ähnliche Suchanfragen für Contentseiten gelangt, indem er auf eine Anzeige oder einen Link auf einer anderen Website klickt und diese Anzeige oder dieser Link von Ihnen verwaltet wird, sollte der Parameter auf den Creative-Text der Anzeige oder des Links festgelegt werden. Für die Verwendung dieses Parameters gelten die folgenden Richtlinien:
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 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:
Standardmäßig ist „adsafe“ auf „Hoch“ eingestellt. Beispiel: 'adsafe': 'medium' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
adtest
|
Optional Mit dem Parameter „adtest“ wird angegeben, dass es sich bei einer Anzeigenanforderung 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. Wenn der Parameter „adtest“ den Wert on hat, 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 einfügen, um die Leistung verschiedener Seiten zu erfassen. Verwende die eindeutige Kanal-ID, die in deinem AdSense-Konto oder von deinem technischen Account Manager erstellt wurde. Weitere Informationen zu Kanälen Mehrere Kanäle sollten durch ein Pluszeichen (+) 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 werden sollen. Der Standardwert ist en. Google unterstützt alle Sprachcodes der AdWords API. 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 Der Standardwert für
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
oe
|
Optional Mit dem Parameter Der Standardwert für
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
personalizedAds
|
Optional Gibt an, ob Nutzer eingewilligt haben, dass der Publisher personenbezogene Daten für personalisierte Anzeigen an Google weitergeben darf.
Standardmäßig ist „Personalisierte Anzeigen“ auf „wahr“ festgelegt. Beispiel: 'personalizedAds': 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 der Anzeigen festlegen, die im oberen Anzeigenblock ausgeliefert werden sollen. Hinweis: Dieser Parameter wird anstelle des Parameters „number“ verwendet. Dieser Anzeigenblock sollte breit genug sein, damit die erste Zeile der Anzeigen nicht umgebrochen wird. Die Verwendung des Parameters „maxTop“ auf 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 die Anzeigen oder ähnlichen Suchanfragen geladen wurden oder wenn keine Anzeigen oder ähnlichen Suchanfragen ausgeliefert werden. Der Parameter sollte auf eine von Ihnen implementierte JavaScript-Callback-Funktion festgelegt werden, mit der eine Aktion ausgeführt werden kann, wenn der Anzeigenaufruf abgeschlossen ist. Die Callback-Funktion verwendet folgende Parameter:
Hinweis: Teste deine Callback-Funktion, um sicherzustellen, dass sie keine Fehler generiert, insbesondere solche, die das Laden deiner Seite stören 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 der Standardwert 0 verwendet. Beispiel: 'relatedSearches' : 4 |