Referenz

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 adPage gibt die Ergebnisseite an, auf der Anzeigen ausgeliefert 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.

pubId Erforderlich
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.
Die vom Nutzer eingegebene Suchanfrage. Der Wert des Suchparameters sollte nicht codiert.

Hinweis:Die Verwendung dieses Parameters bei ähnlichen Suchanfragen auf Content-Seiten führt zu folgenden zu unerwarteten Ergebnissen führen.

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, auf den der Nutzer geklickt hat. Die resultsPageBaseUrl kann eine eigene Parameter, 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 angefordert werden. Es steuert, welche Art von Je nach Seitenkontext werden ähnliche Suchanfragen angezeigt: <ph type="x-smartling-placeholder">
    </ph>
  • 'content' Verwenden Sie diese Option für ähnliche Suchanfragen auf Content-Seiten (z.B. Artikel, Blogposts).
  • 'query' Verwenden Sie diese Option ausschließlich für ähnliche Suchanfragen auf Suchergebnisseiten.

Hinweis:Der Parameter „relatedSearchTargeting“ wird automatisch auf „query“ ist standardmäßig aktiviert. Es ist jedoch wichtig zu beachten, dass dieser Standardwert speziell nur für Suchergebnisseiten entwickelt (ähnliche Suchanfragen in der Google Suche). Wenn Sie wenn Sie ähnliche Suchanfragen auf anderen Seiten (z.B. Artikeln oder Blogposts) verwenden, müssen Sie legen Sie den Parameter explizit auf "content" fest.

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

  • Bestimmte Funktionen für ähnliche Suchanfragen können aktiviert oder deaktiviert sein. Seitenparameter.
  • Falsche Darstellung des Seitentyps oder Verwendung der Standardabfrage für die Verbundenheit mit dem Parameter „relatedSearchTargeting“ auf Seiten, die keine Suchergebnisseiten sind, gilt als Verstoß gegen diesen schriftlichen Anweisungen entsprechen.
  • Google kann die Richtigkeit dieses Werts regelmäßig überprüfen, unabhängig davon, ob er festgelegt ist manuell oder mithilfe der Standardeinstellung.

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 angewendet wird in auf der Seite. <ph type="x-smartling-placeholder"></ph> Weitere Informationen zu benutzerdefinierten Designs finden Sie hier. 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.
  • '_top' Wird im selben Fenster geöffnet.
  • '_blank' Wird in einem neuen Fenster geöffnet.

Beispiel:

'linkTarget' : '_blank'
maxTermLength Optional
Gibt die maximale Anzahl der Zeichen eines ähnlichen Suchbegriffs einschließlich Leerzeichen an. Kein Höchstwert, wenn nicht festgelegt.

Beispiel:

'maxTermLength' : 50
referrerAdCreative Optional
Wenn ein Nutzer auf Ihre Content-Seite gelangt, die einen Anzeigenblock für ähnliche Suchanfragen für Content-Seiten enthält indem Sie auf einer anderen Website auf eine Anzeige oder einen Link klicken und die Anzeige bzw. der Link von Ihnen kontrolliert wird, Dieser Parameter sollte auf den Creative-Text dieser Anzeige oder dieses Links festgelegt werden.

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

  • Der Parameter sollte nur in einer Anfrage für ähnliche Suchanfragen für Content-Seiten bereitgestellt werden. bei allen anderen Anfragen ignoriert werden.
  • Es sollte nur für Zugriffe verwendet werden, die Sie absichtlich von anderen Quellen beziehen. und sollten nicht für organische Zugriffe verwendet werden.
  • Er sollte die Titelzeile, die Beschreibung und/oder jeden anderen Wortlaut der Anzeige oder Link-Creative.
  • Das Auslassen von Werten aus der Anzeige oder des Link-Creatives (oder das Einbeziehen zusätzlicher Werte) dieser schriftlichen Anweisungen nicht gerechtfertigt ist.
  • 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 es verwendet wird, kann sich das auf die Auswahl auswirken und das Ranking der Begriffe.

Hinweis:Dieser Parameter ist erforderlich bei Verwendung des Parameters terms-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 zusammen mit einer Anfrage für eine ähnliche Suchanfrage zurückgegeben. Es kann jedoch sein, dass Google das Bedingungen bereitgestellt werden.

Hinweis: Wenn Sie diesen Parameter verwenden, ist referrerAdCreative auch required und relatedSearchTargeting ist erforderlich und müssen festgelegt werden in „content“.

Beispiele:

'terms' : 'cars rental, flight ticket'
ignoredPageParams Optional
Gibt die Liste der URL-Parameter für eine Content-Seite mit einer ähnlichen Suchanfrage für Content an Anzeigenblock, der ohne Beeinträchtigung des Hauptinhalts oder der Nutzererfahrung ignoriert werden kann.

Hinweis:Bevor ähnliche Suchbegriffe auf Ihrer Website erscheinen können, muss Google Ihre Seiten crawlen, um sicherzustellen, dass die Begriffe kontextrelevant sind. Wenn eine Seite noch nicht gecrawlt wird oder deren Crawling blockiert ist (z. B. durch eine robots.txt-Datei), AdSense-Crawler, werden keine Vorschläge für ähnliche Suchbegriffe angezeigt, die Sie auf Google eingeben.

Das Produkt „Ähnliche Suchanfragen im Content-Werbenetzwerk“ stützt sich bei der Indexierung auf das Content-Crawling-System von Google. und relevante Suchbegriffe generieren. URLs von Content-Seiten mit Suchparametern wie da Tracking-Variablen, Nutzer-IDs, Sitzungs-IDs oder andere dynamische Kennungen die die Fähigkeit des Crawlers, die Hauptinhalte der Seite einzuschätzen, was zu ungenauen oder irrelevante verwandte Suchbegriffe. Dieser Seitenparameter weist den Google-Crawler an, diese nicht wesentlichen Parameter, wodurch eine ordnungsgemäße Indexierung von Inhalten sichergestellt und unnötiges Crawling reduziert wird. laden. So kann Google eine Seite besser als bereits gecrawlt erkennen und Es werden vorgeschlagene Begriffe angezeigt (sowohl Google als auch die des Partners, sofern berechtigt).

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

  • Der Parameter sollte nur in einer Anfrage für ähnliche Suchanfragen für Content-Seiten bereitgestellt werden. bei allen anderen Anfragen ignoriert werden.
  • Der Wert dieses Parameters sollte eine durch Kommas getrennte Liste von URL-Parametern sein, die wenn ein Nutzer die Content-Seite aufruft.
  • Die Groß- und Kleinschreibung wird berücksichtigt.
  • Wird ein URL-Parameter aus dieser Liste aus der URL der Content-Seite entfernt, sollte keine wesentlichen Auswirkungen auf den Inhalt, das Erscheinungsbild oder die Nutzererfahrung der Seite haben.
  • Verwendung eines URL-Parameters, der sich erheblich auf den Inhalt, das Erscheinungsbild oder User Experience 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 Content-Seite mit folgender URL:

http://example.com/content?utm_medium=social&page_id=123&click_id=456
Mit den folgenden ignorierbaren URL-Parametern:
'ignoredPageParams' : 'utm_medium,click_id,session_ref'
Die URL der Inhaltsseite würde 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 der einzelnen Werte auf zurückgegebene Anzeigen: <ph type="x-smartling-placeholder">
    </ph>
  • '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'
adtest Optional
Mit dem Parameter adtest wird angegeben, dass eine Anzeigenanforderung 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 von einer Domain stammen, die auf dem Tab „Websites“ nicht genehmigt wurde, werden Anzeigen mit der Bezeichnung „Testanzeige“ zurückgegeben. Overlay-Anzeigen und sind nicht anklickbar.

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 verwenden, um die Leistung verschiedener Seiten zu erfassen. Eindeutige Kanal-ID verwenden die in Ihrem AdSense-Konto oder von Ihrem Technical Account Manager erstellt wurden. Weitere Informationen zu Channels

Mehrere Channels sollten durch ein Pluszeichen (+) getrennt .

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 ie wird das Zeichencodierungsschema festgelegt, das zum Interpretieren des Abfragestrings verwendet werden soll.

Der Standardwert für ie ist utf-8.

Wert Standardname Verknüpfte unterstützte Sprachen
latin1 ISO-8859-1 Westeuropäisch (Dänisch, Deutsch, Englisch, Finnisch, Französisch, Indonesisch, Italienisch, Katalanisch, Niederländisch, Norwegisch, Portugiesisch, Schwedisch, Spanisch)
latin2 ISO-8859-2 Osteuropäisch (Kroatisch, Polnisch, Rumänisch, Serbisch, Slowakisch, Slowenisch, Tschechisch, Ungarisch)
latin3 ISO-8859-3  
latin4 ISO-8859-4 Baltisch (Estnisch, Lettisch, Litauisch)
Kyrillisch ISO-8859-5 Bulgarisch, Russisch
arabic ISO-8859-6  
Griechisch ISO-8859-7 Griechisch
hebrew ISO-8859-8 Hebräisch
latin5 ISO-8859-9  
latin6 ISO-8859-10 Isländisch
euc-jp EUC-JP Japanisch
euc-kr EUC-KR Koreanisch
sjis Shift_JIS Japanisch
big5 Big5 Chinesisch (traditionell)
gb GB2312 Chinesisch (vereinfacht)
utf-8 UTF-8 Alle
oe Optional

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.

Wert Standardname Verknüpfte unterstützte Sprachen
latin1 ISO-8859-1 Westeuropäisch (Dänisch, Deutsch, Englisch, Finnisch, Französisch, Indonesisch, Italienisch, Katalanisch, Niederländisch, Norwegisch, Portugiesisch, Schwedisch, Spanisch)
latin2 ISO-8859-2 Osteuropäisch (Kroatisch, Polnisch, Rumänisch, Serbisch, Slowakisch, Slowenisch, Tschechisch, Ungarisch)
latin3 ISO-8859-3  
latin4 ISO-8859-4 Baltisch (Estnisch, Lettisch, Litauisch)
Kyrillisch ISO-8859-5 Bulgarisch, Russisch
arabic ISO-8859-6  
Griechisch ISO-8859-7 Griechisch
hebrew ISO-8859-8 Hebräisch
latin5 ISO-8859-9  
latin6 ISO-8859-10 Isländisch
euc-jp EUC-JP Japanisch
euc-kr EUC-KR Koreanisch
sjis Shift_JIS Japanisch
gb GB2312 Chinesisch (vereinfacht)
utf-8 UTF-8 Alle
ivt Optional
Mit diesem Parameter können Sie einen booleschen Wert angeben, der Google mitteilt, dass Sie Anzeigen zulassen möchten, die ein Cookie für ungültige Zugriffe und lokale Speicherung sowohl bei Zugriffen mit als auch bei Zugriffen ohne Einwilligung.
  • true Wenn dieser Parameter nicht vorhanden ist oder auf „true“ gesetzt ist, setzen wir ein Cookie für ungültige Zugriffe und verwenden die lokale Speicherung nur für Zugriffe, die mit Einwilligung der Nutzer*innen erhoben wurden.
  • false Wenn Sie diesen Parameter auf „false“ setzen Wir setzen ein Cookie für ungültige Zugriffe und verwenden die lokale Speicherung sowohl für Zugriffe mit als auch für Zugriffe ohne Einwilligung.

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 festlegen, die im oberen Anzeigenblock ausgeliefert werden sollen.

Hinweis: Dieser Parameter wird anstelle von "number" verwendet. . Dieser Anzeigenblock muss breit genug sein, damit die erste Zeile der Anzeigen nicht umgebrochen wird. maxTop verwenden auf einem anderen Placement auf der Seite als Richtlinienverstoß gilt.

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 für die Anzeigen oder ähnlichen Suchanfragen geladen werden oder wenn keine Anzeigen oder ähnlichen Suchanfragen ausgeliefert werden. Der Parameter sollte auf einen Von Ihnen implementierte JavaScript-Callback-Funktion, mit der eine Aktion ausgeführt werden kann, wenn der abgeschlossen ist.

Die Callback-Funktion verwendet folgende Parameter:

containerName Containername der Anzeige oder des Anzeigenblocks für ähnliche Suchanfragen.
adsLoaded Wird auf „true“ gesetzt, wenn mindestens eine Anzeige oder ein ähnlicher Suchbegriff ausgeliefert wird, und auf „false“ Es werden keine Anzeigen oder ähnlichen Suchanfragen zurückgegeben.
isExperimentVariant Wird auf „true“ gesetzt, wenn ein Test für benutzerdefinierte Stile läuft und die Variante der wird für das Rendern der Anzeigen ausgewählt.
callbackOptions Ein JSON-Objekt, das die folgenden Felder enthält:
termPositions: Enthält für einen Block für ähnliche Suchanfragen Folgendes: map<string,int> der vom Publisher bereitgestellten auf null indexierte Position dieser Begriffe in der Antwort setzen. Wenn ein Begriff angegeben wird aber nicht zurückgegeben wird, erscheint er nicht in der Karte.

Hinweis: Testen Sie Ihre Callback-Funktion, um sicherzustellen, dass sie keine Fehler generiert. 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 der Anzeigen, die in diesem Anzeigenblock gezeigt werden sollen. Der Standardwert liegt bei 2.

Beispiel:

'number' : 4
relatedSearches Optional
Die Anzahl verwandter Suchanfragen, die in diesem Anzeigenblock erscheinen sollen. Wenn keine Angabe erfolgt, wird der Standardwert 0 verwendet.

Beispiel:

'relatedSearches' : 4