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 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, außer bei ä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, kann das zu unerwarteten Ergebnissen führen. 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. 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 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 gesteuert, welche Art von ähnlichen Suchanfragen angezeigt wird, je nach Seitenkontext:
Hinweis:Der Seitenparameter „relatedSearchTargeting“ wird standardmäßig automatisch auf „query“ festgelegt. Dieser Standardwert ist jedoch nur für Suchergebnisseiten (ähnliche Suchanfragen in der Suche) vorgesehen. Wenn Sie die Funktion „Ähnliche Suchanfragen“ auf einer anderen Art von Seite (z.B. Artikeln oder Blogposts) verwenden, müssen Sie den Parameter explizit auf „content“ festlegen. Hinweis:Für diesen Parameter gelten folgende Richtlinien:
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 Anfrage 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.
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:
Hinweis:Dieser Parameter ist erforderlich, wenn der Parameter 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 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 gefahrlos ignoriert werden können, ohne dass sich dies auf die Kerninhalte 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 kontextbezogen relevant sind. Wenn eine Seite noch nicht gecrawlt wurde oder das Crawlen durch den AdSense-Crawler blockiert wird (z. B. durch eine robots.txt-Datei), werden keine vorgeschlagenen Begriffe für die Funktion „Ähnliche Suchanfragen“ angezeigt, die Sie Google zur Verfügung stellen. Das Produkt „Ähnliche Suchanfragen auf Inhaltsseiten“ basiert auf dem Content-Crawling-System von Google, mit dem Seiten indexiert und relevante Suchbegriffe generiert werden. Content-Seiten-URLs, 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. Dies kann zu ungenauen oder irrelevanten ähnlichen Suchbegriffen führen. Mit diesem Seitenparameter wird der Crawler von Google angewiesen, diese nicht unbedingt erforderlichen Parameter zu ignorieren. So wird eine korrekte Inhaltsindexierung gewährleistet und die unnötige Crawling-Last reduziert. So kann Google besser erkennen, dass eine Seite bereits gecrawlt wurde, und vorgeschlagene Begriffe (sowohl von Google als auch vom Partner, sofern berechtigt) anzeigen. Für diesen Parameter gelten folgende Richtlinien:
Beispiele:
http://example.com/content?utm_medium=social&page_id=123&click_id=456 'ignoredPageParams' : 'utm_medium,click_id,session_ref' 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:
Standardmäßig ist „adsafe“ auf „high“ festgelegt. Beispiel: 'adsafe': 'medium' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
adtest
|
Optional Der Parameter „adtest“ kennzeichnet eine Anzeigenanfrage als Test. Wenn der Parameter „adtest“ den Wert on hat, wird die Anfrage von Google als Test behandelt. Die Anzeigenimpressionen werden nicht gezählt und die Klickergebnisse werden nicht erfasst. Hat der Parameter „adtest“ den Wert on, erzielen Sie keinen Umsatz. Anzeigenanfragen mit dem Parameter „adtest“ auf on, die von einer Domain stammen, die auf dem Tab „Websites“ nicht genehmigt wurde, geben nicht anklickbare Anzeigen mit dem Overlay „test ad“ 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 AdSense für Suchergebnisseiten-Channels 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 Der Standardwert für
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
oe
|
Optional Der Parameter Der Standardwert für
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
ivt
|
Optional Mit diesem Parameter können Sie einen booleschen Wert angeben, der Google darüber informiert, 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.
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:
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 liegt bei 2. Beispiel: 'number' : 4 |
||||||||
relatedSearches
|
Optional Die Anzahl ähnlicher Suchanfragen, die in diesem Anzeigenblock eingeblendet werden sollen. Wenn dieser Wert kleiner als 3 ist, werden keine ähnlichen Suchanfragen angezeigt. Beispiel: 'relatedSearches' : 4 |