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 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 unerwartete Ergebnisse. 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:
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:
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. 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.
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:
Hinweis:Dieser Parameter ist erforderlich 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 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 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. Die Indexierung des Produkts „Ähnliche Suchanfragen im Content-Werbenetzwerk“ erfolgt über 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:
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 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:
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 zurückgegeben, die eine „Testanzeige“ haben. 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 AdSense für Suchergebnisseiten-Channels einfügen, 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 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, 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.
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:
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 |