Referenz

Der Parameter adPage gibt die Ergebnisseite an, auf der Anzeigen präsentiert 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 Anzeigen auf der zweiten Seite mit fünf Anzeigen zurückgegeben.

Beispiel:

'pubId' : 'test-property'

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

Beispiel:

'resultsPageBaseUrl' : 'http://www.example.com/search?a=v1&b=v2'

• 'content' Verwenden Sie diese Option für ähnliche Suchanfragen auf Inhaltsseiten (z.B. Artikel, Blogposts).
• 'query' Verwenden Sie diese Option ausschließlich für ähnliche Suchanfragen auf Suchergebnisseiten.

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:

• Je nach Wert dieses Seitenparameters können bestimmte Funktionen für ähnliche Suchanfragen aktiviert oder deaktiviert sein.
• Eine falsche Darstellung des Seitentyps oder die Verwendung der Standardeinstellung „Suchanfrage“ für den Parameter „relatedSearchTargeting“ auf Seiten, die keine Suchergebnisseiten sind, gilt als Verstoß gegen diese schriftlichen Anweisungen.
• Google kann die Genauigkeit dieses Werts regelmäßig prüfen, unabhängig davon, ob er manuell oder in der Standardeinstellung festgelegt ist.

Beispiele:

'relatedSearchTargeting' : 'content'

'relatedSearchTargeting' : 'query'

Beispiel:

'styleId': '1234567890'

• '_top' Wird im selben Fenster geöffnet.
• '_blank' Wird in einem neuen Fenster geöffnet.

Beispiel:

'linkTarget' : '_blank'

Beispiel:

'maxTermLength' : 50

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

• Der Parameter sollte nur in einer Anfrage für ähnliche Suchanfragen für Inhalte angegeben werden. Er wird bei allen anderen Anfragen ignoriert.
• Es sollte nur für Zugriffe verwendet werden, die Sie absichtlich von anderen Websites erhalten, und nicht für organische Zugriffe.
• Sie sollte die Titelzeile und/oder eine Beschreibung der Anzeige oder des Link-Creatives enthalten.
• Die Angabe von Werten, die nicht Teil der Anzeige oder des Link-Creatives sind, wird als Verstoß gegen diese schriftlichen Anweisungen betrachtet.
• Die Groß-/Kleinschreibung wird nicht berücksichtigt.
• Es wird eine gültige UTF-8-Codierung akzeptiert. 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.

Hinweis:Dieser Parameter ist bei Verwendung des Parameters terms erforderlich.

Beispiele:

'referrerAdCreative': 'search for ads related to dental implants'

'referrerAdCreative': 'The Early Signs of Psoriatic Arthritis'

Beispiel:

'resultsPageQueryParam' : 'query'

Hinweis:Wenn Sie diesen Parameter verwenden, ist auch referrerAdCreative erforderlich und relatedSearchTargeting ist erforderlich und muss auf „content“ festgelegt sein.

Beispiele:

'terms' : 'cars rental, flight ticket'

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:

• Der Parameter sollte nur in einer Anfrage für ähnliche Suchanfragen für Inhalte angegeben werden. Er wird bei allen anderen Anfragen ignoriert.
• Der Wert dieses Parameters sollte eine durch Kommas getrennte Liste von URL-Parametern sein, die angezeigt werden kann, wenn ein Nutzer die Inhaltsseite aufruft.
• Die Groß- und Kleinschreibung wird berücksichtigt.
• Wird ein URL-Parameter aus dieser Liste aus der URL der Inhaltsseite entfernt, sollte dies keine wesentlichen Auswirkungen auf den Inhalt, die Darstellung oder die Nutzerfreundlichkeit der Seite haben.
• Die Verwendung eines URL-Parameters, der sich erheblich auf den Inhalt, die Darstellung oder die Nutzererfahrung der Seite auswirkt, wird als Verstoß gegen diese schriftlichen Anweisungen betrachtet.
• Google kann regelmäßig überprüfen, ob sich das Ignorieren der angegebenen URL-Parameter auswirkt.

Beispiele:
Ein Nutzer besucht eine Contentseite mit der folgenden URL:

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

• 'high' Gibt jugendfreie Anzeigen zurück. Nicht jugendfreie Anzeigen oder Anzeigen mit sexuellem Content für Erwachsene werden nicht ausgeliefert.
• 'medium' Gibt jugendfreie und nicht jugendfreie Anzeigen zurück. Gibt keine Anzeigen mit sexuellen Inhalten zurück.
• 'low' Gibt alle Anzeigentypen zurück.

Standardmäßig ist „adsafe“ auf „Hoch“ eingestellt.

Beispiel:

'adsafe': 'medium'

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'

Beispiele:

'channel' :  'testA'  

'channel' :  'testA+testB'  

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'

Mit dem Parameter ie wird das Zeichencodierungsschema festgelegt, das zum Interpretieren des Abfragestrings verwendet werden soll.

Der Standardwert für ie ist utf-8.

Mit dem Parameter oe wird das Zeichencodierungsschema festgelegt, mit dem Google den Text der Anzeigen codieren soll. Aus technischer Sicht optional, wir empfehlen jedoch, einen Wert für diesen Parameter zu übergeben.

Der Standardwert für oe ist utf-8.

• true Wenn dieser Parameter nicht vorhanden ist oder Sie ihn auf „true“ setzen, setzen wir ein Cookie nur für ungültige Zugriffe und verwenden die lokale Speicherung nur bei Zugriffen, die mit Einwilligung der Nutzer*innen erhoben wurden.
• false Wenn Sie diesen Parameter auf „false“ setzen, setzen wir ein Cookie für ungültige Zugriffe und verwenden die lokale Speicherung sowohl bei Zugriffen mit als auch bei Zugriffen ohne Einwilligung.

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

Beispiel:

'ivt': false

Beispiel:

'container' : 'afscontainer1'

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

Beispiel:

'width' : '700px'

'width' : 700

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
    }
  }
};
      

Beispiel:

'number' : 4

Beispiel:

'relatedSearches' : 4