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 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, außer bei ähnlichen Suchanfragen auf Inhaltsseiten. Das ist die vom Nutzer eingegebene Suchanfrage. Der Wert des Abfrageparameters darf nicht codiert sein. Hinweis:Die Verwendung dieses Parameters für ähnliche 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 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.
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:
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 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.
Hinweis: Bei Verwendung dieses Parameters ist Beispiele: 'terms' : 'cars rental, flight ticket' |
ignoredPageParams
|
Optional Gibt die Liste von URL-Parametern für eine Contentseite mit einer Einheit für ähnliche Suchanfragen für Inhalte an, die ignoriert werden können, ohne dass sich dies auf den Hauptinhalt oder die Nutzererfahrung auswirkt. Hinweis:Für die Funktion „Ähnliche Suchanfrage in Inhalten“ wird das Crawling-System von Google benötigt, um Seiten zu indexieren und relevante Suchbegriffe zu generieren. URLs von Contentseiten, die Suchparameter wie Tracking-Variablen, Nutzer-IDs, Sitzungs-IDs oder andere dynamische Kennungen enthalten, können die Fähigkeit des Crawlers beeinträchtigen, die Hauptinhalte der Seite zu bewerten, und zu ungenauen oder irrelevanten ähnlichen Suchbegriffen führen. Mit diesem Seitenparameter wird der Google-Crawler angewiesen, diese nicht notwendigen Parameter zu ignorieren. So wird eine ordnungsgemäße Indexierung der Inhalte sichergestellt und eine unnötige Crawling-Last wird reduziert. So kann Google besser erkennen, dass eine Seite bereits gecrawlt wurde, und die vorgeschlagenen Begriffe anzeigen (sowohl von Google als auch denen des Partners, falls zutreffend). Für die Verwendung dieses Parameters gelten die folgenden Richtlinien:
Beispiele:
http://example.com/content?utm_medium=social&page_id=123&click_id=456Angabe der folgenden URL-Parameter, die ignoriert werden können: 'ignoredPageParams' : 'utm_medium,click_id,session_ref'Die URL der Contentseite wird wie folgt 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:
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 Der Standardwert für
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
oe
|
Optional Mit dem Parameter Der Standardwert für
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
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.
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:
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 |