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 |
pubId
|
Erforderlich Dies ist Ihre AdSense-Client-ID. Die pubId ist der Teil Ihrer Client-ID hinter "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, außer für ähnliche Suchanfragen auf Content-Seiten. Das ist die vom Nutzer eingegebene Suchanfrage. Der Wert des Abfrageparameters darf nicht codiert sein. Hinweis:Die Verwendung dieses Parameters bei ähnlichen Suchanfragen auf Inhaltsseiten führt zu unerwarteten Ergebnissen. Beispiele: 'query' : 'flowers' 'query' : 'black & decker' 'query' : myQuery // myQuery is a variable containing the search query |
resultsPageBaseUrl
|
Erforderlich, wenn auf der Seite Anzeigenblöcke für ähnliche Suchanfragen vorhanden sind. Gibt die URL der Suchergebnisseite an, auf der die Suchanfrage dem ähnlichen Suchbegriff entspricht, 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' |
relatedSearchTargeting
|
Erforderlich, wenn auf der Seite Anzeigenblöcke für ähnliche Suchanfragen vorhanden sind. Dieser Parameter ist obligatorisch, wenn Einheiten für ähnliche Suchanfragen angefragt werden. Je nach Seitenkontext legt sie fest, welche Art von ähnlichen Suchanfragen angezeigt wird:
Hinweis:Der Parameter „relatedSearchTargeting“ ist standardmäßig auf „Suchanfrage“ festgelegt. Dieser Standardwert ist jedoch nur für Suchergebnisseiten vorgesehen, also für ähnliche Suchanfragen in der Google Suche. Wenn du ähnliche Suchanfragen auf einer anderen Art von Seite verwendest (z.B. in Artikeln oder Blogposts), musst du den Parameter explizit auf „content“ setzen. Hinweis:Für die Verwendung dieses Parameters gelten die folgenden Richtlinien:
Beispiele: 'relatedSearchTargeting' : 'content' 'relatedSearchTargeting' : 'query' |
styleId
|
Erforderlich Gibt die ID des benutzerdefinierten Designs an, das auf die Anzeige oder die Anzeigenblöcke für ähnliche Suchanfragen auf der Seite angewendet werden soll. Weitere Informationen zu benutzerdefinierten Designs Wenn die styleId für eine Anfrage festgelegt ist, werden Anzeigen oder ähnliche Suchanfragen mit dem Design gerendert und alte Designparameter werden ignoriert. Wenn „styleId“ in der Anfrage nicht angegeben ist, wird ein Standardstil des Systems gerendert. Beispiel: 'styleId': '1234567890' |
Optional
Parameter | Beschreibung und Beispiele |
---|---|
linkTarget
|
Optional Gibt an, ob der 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.
Beispiel: 'linkTarget' : '_blank' |
maxTermLength
|
Optional Damit wird die maximale Anzahl der Zeichen eines ähnlichen Suchbegriffs einschließlich Leerzeichen angegeben. 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 die Contentseite mit einem Anzeigenblock für ähnliche Suchanfragen für Content gelangt und Sie die Kontrolle über diese Anzeige oder diesen Link haben, sollte dieser Parameter wortwörtlich auf den Creative-Text der Anzeige oder des Links festgelegt werden. Für die Verwendung dieses Parameters gelten die folgenden Richtlinien:
Hinweis:Dieser Parameter ist bei Verwendung des Parameters 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 in einer ähnlichen Suchanfrage zurückgegeben werden sollen. Google kann die hier angegebenen Begriffe verwenden oder nicht.
Hinweis:Wenn Sie diesen Parameter verwenden, ist auch Beispiele: 'terms' : 'cars rental, flight ticket' |
ignoredPageParams
|
Optional Gibt die Liste der URL-Parameter für eine Inhaltsseite mit einem Anzeigenblock für ähnliche Suchanfragen für Inhalte an, die problemlos ignoriert werden können, ohne die Hauptinhalte oder die Nutzerfreundlichkeit zu beeinträchtigen. Hinweis:Bevor ähnliche Suchbegriffe auf Ihrer Website angezeigt werden können, muss Google Ihre Seiten crawlen, um sicherzustellen, dass sie kontextrelevant sind. Wenn eine Seite noch nicht gecrawlt wurde oder deren Crawling durch den AdSense-Crawler blockiert wird (z. B. durch eine robots.txt-Datei), werden keine Vorschläge für ähnliche Suchbegriffe angezeigt, die du Google zur Verfügung stellst. Das Produkt „Ähnliche Suchanfragen für Inhalte“ nutzt das Content-Crawling-System von Google, um Seiten zu indexieren und relevante Suchbegriffe zu generieren. URLs von Inhaltsseiten mit Suchparametern wie Tracking-Variablen, Nutzer-IDs, Sitzungs-IDs oder anderen dynamischen Kennungen können die Fähigkeit des Crawlers beeinträchtigen, die Hauptinhalte einer Seite zu beurteilen, und zu ungenauen oder irrelevanten ähnlichen Suchbegriffen führen. Mit diesem Seitenparameter wird der Crawler von Google angewiesen, diese nicht wesentlichen Parameter zu ignorieren. So wird eine ordnungsgemäße Indexierung der Inhalte sichergestellt und unnötige Crawling-Lasten werden reduziert. So kann Google besser erkennen, dass eine Seite bereits gecrawlt wurde, und vorgeschlagene Begriffe anzeigen – sowohl von Google als auch vom Partner, sofern die Voraussetzungen erfüllt sind. Für die Verwendung dieses Parameters gelten die folgenden Richtlinien:
Beispiele:
http://example.com/content?utm_medium=social&page_id=123&click_id=456Mit den folgenden ignorierbaren URL-Parametern: 'ignoredPageParams' : 'utm_medium,click_id,session_ref'Die URL der Contentseite würde 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 der einzelnen Werte auf zurückgegebene Anzeigen:
Standardmäßig ist „adsafe“ auf „Hoch“ eingestellt. Beispiel: 'adsafe': 'medium' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
adtest
|
Optional Mit dem Parameter „adtest“ wird angegeben, dass eine Anzeigenanfrage ein Test ist. Wenn der Parameter adtest den Wert on hat, behandelt Google die Anfrage als Test und zählt weder Anzeigenimpressionen noch Klickergebnisse. Hat der Parameter adtest den Wert on, erzielen Sie keinen Umsatz. Bei Anzeigenanfragen, bei denen der Parameter „adtest“ auf on gesetzt ist und die von einer Domain stammen, die auf dem Tab „Websites“ nicht genehmigt wurde, werden Anzeigen zurückgegeben, die ein „Testanzeige“-Overlay haben und nicht anklickbar sind. Verwenden Sie diesen Parameter nur beim Testen, aber nicht in Produktionssystemen. Andernfalls erhalten Sie keine Vergütung für die bei Ihnen eingeblendeten Anzeigen. Der Standardwert für "adtest" ist "off". Beispiel: 'adtest' : 'on' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
channel
|
Optional Sie können einen Kanal für AdSense für Suchergebnisseiten hinzufügen, um die Leistung verschiedener Seiten zu erfassen. Verwende die eindeutige Kanal-ID, die du in deinem AdSense-Konto oder von deinem Technical Account Manager erstellt hast. Weitere Informationen zu Channels Mehrere Channels sollten durch das Symbol „+“ 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 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 Der Standardwert für
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
oe
|
Optional Mit dem Parameter Der Standardwert für
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
ivt
|
Optional Mit diesem Parameter können Sie einen booleschen Wert angeben, mit dem Sie Google mitteilen, dass Sie Anzeigen zulassen möchten, bei denen sowohl bei Zugriffen mit als auch bei Zugriffen ohne Einwilligung ein Cookie und die lokale Speicherung von ungültigen Zugriffen verwendet wird.
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 ausgeliefert 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 so breit sein, dass die erste Zeile der Anzeigen nicht umgebrochen wird. Die Verwendung des Parameters maxTop für ein anderes 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 sollte 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:
Hinweis: Teste deine Callback-Funktion, um sicherzustellen, dass sie keine Fehler generiert, insbesondere solche, 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 eingeblendet 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 |