Creative-Code mit Anfrage ohne Tags laden

Anstelle eines Anzeigen-Tags kann eine Anfrage ohne Tags verwendet werden, um den Rohcode eines Creatives anzufordern, der in Ad Manager getraffickt wird. Anfragen ohne Tags werden normalerweise eingesetzt, wenn benutzerdefiniertes Parsing und eine individuelle Darstellung erforderlich sind, wie bei Set-Top-Boxen oder anderen Umgebungen ohne Tag-Kennzeichnung von Google oder SDK-Unterstützung.

Wenn eine Anfrage ohne Tags gestellt wird, wird in Ad Manager nur der Rohcode des Creatives zurückgegeben, und zwar genau so, wie er getraffickt wird. Die Anzeige wird dabei weder ausgeliefert noch eingeblendet. Sollte keine Anzeige gefunden werden, wird der Status 200/OK mit einer leeren Antwort ausgegeben.

Der Code muss von der App, dem Player oder der Website ausgeführt werden, damit die Anzeige zu sehen und das Impressions-Tracking möglich ist.

Eine Anfrage ohne Tags sollte nicht verwendet werden, um Anzeigen in E-Mails auszuliefern. Hier finden Sie alle nicht unterstützten Funktionen.

Anfrage ohne Tags manuell erstellen

Wenn Sie eine Anfrage ohne Tags erstellen möchten, müssen Sie in die Basis-URL alle erforderlichen Parameter und die gewünschten optionalen Parameter einfügen. Mit diesen Parametern werden beispielsweise der Anzeigenblock, die Creative-Größe, die Schlüssel/Wert-Paare und andere Anfragedetails festgelegt.

Anfragen ohne Tags müssen über SSL erfolgen (https://), damit sie sicher sind.

Basis-URL als Ausgangspunkt

Verwenden Sie diese Basis-URL: https://securepubads.g.doubleclick.net/gampad/adx?.

Parameter der Anzeigenanfrage angeben

Erforderliche Parameter

Parameter	Beschreibung
iu	Code eines Google Ad Manager-Anzeigenblocks einschließlich des Codes Ihres Google Ad Manager-Netzwerks. Wenn Sie mehrere Ebenen einbeziehen möchten, verwenden Sie einen Schrägstrich (/) als Trennzeichen. Beispiel iu=/123/homepage iu=/456/sports/baseball Wenn Sie das Publisher-Verwaltungstool mit Anfragen ohne Tags verwenden, verwenden Sie für den Netzwerkcode die parent,child-Struktur. Beispiel (Publisher-Verwaltungstool) iu=/123,456/homepage
sz	Creative-Größe. Wenn Sie mehrere Größen einbeziehen möchten, verwenden Sie ein Pipe-Zeichen (|) als Trennelement zwischen den einzelnen Größen. Beispiel sz=320x50 für eine einzelne Größe sz=320x50|300x50 für mehrere Größen In Anfragen ohne Tags sollten Sie den senkrechten Strich (|) mit %7c codieren. Beispiel &sz=216x36|300x50|320x50 wird zu &sz=216x36%7c300x50%7c320x50.
url	URL der Domain, auf der die ursprüngliche Anzeigenanfrage gehostet wird. Nur für Anfragen im Publisher-Verwaltungstool erforderlich. Beispiel url=www.example.com
c	Korrelator- oder Cache-Busting-Wert. Diese zufällige Zahl (Buchstaben sind nicht erlaubt) muss von einem Publisher generiert werden, damit jedes Mal, wenn die Seite geladen wird, ein neuer Aufruf an den Ad-Server gesendet wird. So werden Diskrepanzen bei der Impressionszählung vermieden. Beispiel c=8362527364
tile	Position des Tags auf einer Webseite. Der Wert muss eine eindeutige Ganzzahl sein. Um die Implementierung zu vereinfachen, empfehlen wir aufsteigende Werte. Dieser Parameter ist nur erforderlich, wenn auf einer Seite für mehrere Anzeigen-Tags derselbe Anzeigenblockcode (iu=) und Korrelator (c=) verwendet werden. Beispiel https://securepubads.g.doubleclick.net/gampad/adx?iu=/1234/homepage&sz=320x50&c=54631&tile=1 https://securepubads.g.doubleclick.net/gampad/adx?iu=/1234/homepage&sz=320x50&c=54631&tile=2

Optionale Parameter

Parameter	Beschreibung
d_imp	Umschaltfunktion für verzögerte Impressionen. Wird die Funktion verwendet, wird die Impressionszählung auf Anforderung deaktiviert. Zum Erfassen einer Impression wird entweder das Makro für gesehene Impressionen im zurückgegebenen Creative oder der Hinweis aus dem Parameter d_imp_hdr verwendet. Beispiel d_imp=1 d_imp=0: Standardwert für die Impressionszählung in Google Ad Manager
d_imp_hdr	Umschaltfunktion für Headerinformationen zu verzögerten Impressionen. Wird die Funktion verwendet, wird die Anzeige-URL, die zur Impressionszählung genutzt werden soll, im HTTP-Header zurückgegeben. Diese Headerinformationen werden standardmäßig nicht definiert. Der Publisher muss die Anzeige-URL dann per Ping kontaktieren, damit eine Impression erfasst wird. Weitere Informationen zur Impressionszählung und zu Anfragen ohne Tags Der Header Google-Delayed-Impression enthält die Impressions-URL für Google Ad Manager. Der Header Google-3rdParty-Delayed-Impression enthält die Impressions-URL des Drittanbieters, falls im Creative vorhanden. Beispiel d_imp_hdr=1 d_imp_hdr=0: deaktiviert die Headerinformationen zu verzögerten Impressionen
t	Schlüssel/Wert-Paare auf Ebene der Anzeigenfläche. Jeder Schlüssel ist von seinem Wert durch ein Gleichheitszeichen = und die einzelnen Schlüssel/Wert-Paare sind durch ein Et-Zeichen & voneinander getrennt. Jeder Schlüssel und jeder Wert sollte eine eigene URL-Codierung erhalten. Dann sollte die gesamte Zeichenfolge eine URL-Codierung erhalten. Jeder Schlüssel in einem Schlüssel/Wert-Paar muss eindeutig sein. Wenn Sie denselben Schlüssel mehrmals verwenden, wird nur einer der verknüpften Werte berücksichtigt. Beispiel Mit dem Parameter t=genre%3Daction%26movie%3DMr+%2526+Mrs+Smith wird dem Schlüssel „genre“ der Wert „action“ und dem Schlüssel „movie“ der Wert „Mr & Mrs Smith“ zugewiesen. Das Und-Zeichen „&“ zwischen den Schlüssel/Wert-Paaren ist einfach codiert (%26). Wird es innerhalb eines Werts verwendet, muss es doppelt codiert (%2526) werden. Verwenden Sie excl_cat als speziellen Schlüssel für Konkurrenzausschlüsse. Beispiel t=excl_cat%3Dairlines t=interest%3Dsports%2Cnews%26excl_cat%3Dairlines Folgende Zeichen sind in Schlüssel/Wert-Paaren nicht zulässig: " ' ! + # * ~ ; ^ ( ) < > [ ] = . Leerzeichen sind zwar in Werten erlaubt (als %20 oder + maskiert), in Schlüsseln sind sie jedoch nicht zulässig. Beispiel Die Zuordnung von Schlüssel "a" zu Wert "b+c" mit t=a%3Db%252Bc funktioniert nicht.
m	Wert des Mime-Typs im HTTP-Header Beispiel m=text/wml
mob	Hinweis, dass es sich um eine mobile Anzeigenanfrage handelt Beispiel mob=js: einzig zulässiger Wert
ppid	Ein PPID-Parameter (Publisher Provided Identifier, vom Publisher bereitgestellte Kennung) ermöglicht Ihnen, eine Kennung an Google Ad Manager zu senden, die beim Frequency Capping, bei der Zielgruppensegmentierung und beim Zielgruppen-Targeting, bei der sequenziellen Anzeigenrotation und bei anderen Funktionen zur zielgruppenbasierten Anzeigenauslieferung auf beliebigen Geräten verwendet wird. Beispiel ppid=12JD92JD8078S8J29SDOAKC0EF230337
u_w	Bildschirmbreite des Mobilgeräts, die Vorrang vor der automatischen Erkennung durch den Ad-Server hat. Beispiel u_w=1024
u_h	Bildschirmhöhe des Mobilgeräts, mit der die automatisch vom Ad-Server erkannte Höhe überschrieben wird Beispiel u_h=768
submodel	Hardware-Informationen zum Mobilgerät, die die automatische Erkennung durch den Ad-Server überschreiben. Beispiel submodel=iPhone4%2C1: Das Komma, mit dem der Wert des Untermodells unterteilt wird, ist codiert. Werte für das Untermodell: iPhone, 1. Generation: iphone1,1 iPhone 3G: iphone1,2 iPhone 3GS: iphone2,1 iPhone 4 (GSM): iphone3,1 iPhone 4 (GSM): iphone3,2 iPhone 4 (CDMA): iphone3,3 iPhone 4S: iPhone4,1 iPhone 5 (GSM und LTE): iPhone5,1 iPhone 5 (CDMA und LTE): iPhone5,2 iPhone 5c (GSM und CDMA): iPhone5,3 iPhone 5c (GSM und CDMA): iPhone5,4 iPhone 5s (GSM und CDMA): iPhone6,1 iPhone 5s (GSM und CDMA): iPhone6,2 iPhone 6: iPhone7,2 iPhone 6 Plus: iPhone7,1 iPhone 6s: iPhone8,1 iPhone 6s Plus: iPhone8,2 iPhone SE: iPhone8,4 iPhone 7: iPhone9,1 iPhone 7 Plus: iPhone9,2  iPod,1. Generation: iPod1,1 iPod, 2. Generation: iPod2,1 iPod, 3. Generation: iPod3,1 iPod, 4. Generation: iPod4,1 iPod, 5. Generation: iPod5,1 iPad, 1. Generation (Wi-Fi): iPad1,1 iPad, 1. Generation (AT&T): iPad1,2 iPad, 2. Generation (Wi-Fi): iPad2,1 iPad, 2. Generation (AT&T): iPad2,2 iPad, 2. Generation (Verizon): iPad2,3 iPad, 2. Generation (Wi-Fi): iPad2,4 iPad, 3. Generation (Wi-Fi): iPad3,1 iPad, 3. Generation (Verizon): iPad3,2 iPad, 3. Generation (AT&T): iPad3,3 iPad, 4. Generation (Wi-Fi): iPad3,4 iPad, 4. Generation (AT&T): iPad3,5 iPad, 4. Generation (Verizon): iPad3,6 iPad mini (Wi-Fi): iPad2,5 iPad mini (AT&T-US; GSM und LTE 4, 17): iPad2,6 iPad mini (Verizon-World; GSM, DMA und LTE 1, 3, 5, 13, 25): iPad2,7 iPad mini Retina (Wi-Fi): iPad4,4 iPad mini Retina (LTE): iPad4,5 iPad Air (Wi-Fi): iPad4,1 iPad Air (LTE): iPad4,2

 

Sie können die rücksetzbare Geräte-ID (RDID) für das Frequency Capping und das Zielgruppen-Targeting verwenden. Weitere Informationen dazu, wie Sie für Anfragen ohne Tags die RDID konfigurieren

Impressions-Tracking aktivieren

In Ad Manager können bei Anfragen ohne Tags heruntergeladene Impressionen erfasst werden, die auch als „verzögerte Impressionen“ bezeichnet werden. Verwenden Sie beliebige der unten aufgeführten Optionen, jedoch nicht alle, ansonsten werden die Impressionen möglicherweise doppelt oder sogar dreifach gezählt.

Wir empfehlen Option 1. Sie müssen dafür aber Zugriff auf die HTTP-Antwortheader haben und ein Header-basiertes Protokoll implementieren können.

Option 1: HTTP-Antwortheader lesen, um die Impressionszählung zu steuern

Fügen Sie der Anfrage ohne Tags die Parameter d_imp=1 und d_imp_hdr=1 hinzu, damit Google Ad Manager erst eine Impression oder heruntergeladene Impression erfasst, wenn Sie mit der HTTP-Header-URL Google-Delayed-Impression manuell einen Impressions-Ping auslösen. Wird der Impressions-Ping ausgelöst, werden in Google Ad Manager eine Ad-Server-Impression und eine vom Ad-Server heruntergeladene Impression verzeichnet.

Bei Creatives, die über Anfragen ohne Tags zurückgegeben werden, dürfen Sie das Makro für gesehene Impressionen nicht einbinden. Andernfalls werden die Impressionen doppelt gezählt.

Option 2: Makro für gesehene Impressionen im Creative-Code verwenden

Wenn Sie keinen Zugriff auf die Header der HTTP-Antwort haben, fügen Sie das Makro für gesehene Impressionen ins Code-Snippet aller Creatives ein, die von einem einfachen URL-Tag zurückgegeben werden. Dieses Makro wird in eine URL erweitert, die beim Rendern vom Creative gesendet wird.

Anfrage ohne Tags stellen, um den Creative-Code abzurufen

Webcontent

Anfragen ohne Tags werden normalerweise in Umgebungen ohne Tag-Kennzeichnung von Google oder SDK-Unterstützung verwendet. Wenn Sie eine Anfrage ohne Tags im Web laden möchten, muss sie in einem <iframe> geladen werden, damit der zurückgegebene Rohcode ausgeführt werden kann.

Benutzerdefinierte Umgebungen ohne Google SDK

Um den Rohcode eines Creatives in Umgebungen ohne Tag-Kennzeichnung von Google oder SDK-Unterstützung (z. B. nicht von Google stammende Set-Top-Box) abzurufen, sollten Sie sich an die folgenden Richtlinien halten:

• Legen Sie im Anfrage-Header mit dem Element User-Agent einen gültigen User-Agent fest, damit das Targeting wie gewünscht funktioniert.
• In Ihrer Umgebung müssen Rich Media-Funktionsweisen einschließlich JavaScript-Code und Creative-Maximierungen unterstützt werden.
• Senden Sie eine HTTPS-Anfrage an Google Ad Manager.
• Prüfen Sie den Antwortstatus. Enthält er "HTTP 200/OK", wurde die Anforderung korrekt formatiert.

Nicht unterstützte Funktionen bei Anfragen ohne Tags

• Active View
• Ad Exchange
• Cookies oder Kennungen mobiler Apps, die für das Tracking verwendet werden
• Creative-Wrapper
• Dynamische Zuordnung mit AdSense, Ad Exchange oder AdMob
• Natives Inventar
• Preferred Deals
• Creative-Vorschau

Anfragen ohne Tags mit gampad/ad in den HTML-Bild-Tags (<img>) lassen sich nicht mit JavaScript-Tracking-Code verwenden. Sie werden bei der Zählung heruntergeladener Impressionen nicht berücksichtigt.

Wenn Sie Ad Manager-Berichte zu diesen Anzeigen erstellen möchten, müssen Sie den Messwert Gesamtzahl der Codeübermittlungen verwenden.