Code voor advertentiemateriaal laden met een Tagless Request

Een Tagless Request kan in plaats van een advertentietag worden gebruikt om de onbewerkte code voor advertentiemateriaal op te vragen die is gedistribueerd in Ad Manager. Tagless Requests worden doorgaans gebruikt als aangepaste parsering en weergave is vereist, zoals voor settopboxen of andere omgevingen zonder Google-tags of SDK-support.

Als u een Tagless Request maakt, retourneert Ad Manager alleen de onbewerkte code voor advertentiemateriaal, precies zoals gedistribueerd, zonder de advertentie uit te voeren en weer te geven. Als er geen advertentie wordt gevonden, wordt de status 200/OK geretourneerd met een lege reactie.

Uw app, speler of site moet de code uitvoeren om de advertentie weer te geven en tracking van vertoningen activeren.

Een Tagless Request moet niet worden gebruikt om advertenties weer te geven in e-mails. Bekijk alle niet-ondersteunde functies.

Handmatig een Tagless Request maken

Als u een Tagless Request wilt maken, begint u met de basis-URL, neemt u alle vereiste parameters op en voegt u eventuele aanvullende optionele parameters toe. Gebruik deze parameters om het advertentieblok, het formaat van het advertentiemateriaal, sleutel/waarden en andere informatie over het verzoek op te geven.

Tagless Requests moeten beveiligd worden verzonden via SSL (https://).

Beginnen met een basis-URL

Gebruik deze basis-URL:  https://securepubads.g.doubleclick.net/gampad/adx?

De parameters van uw advertentieverzoek opgeven

Vereiste parameters

Parameter	Beschrijving
iu	Google Ad Manager-advertentieblokcode, inclusief uw Google Ad Manager-netwerkcode. Als u meerdere niveaus wilt opnemen, gebruikt u de schuine streep naar voren (/) als scheidingsteken. Voorbeeld iu=/123/homepage iu=/456/sports/baseball Als u Beheer van meerdere klanten (Multiple Customer Management, MCM) gebruikt met Tagless Requests, gebruikt u de structuur parent,child voor de netwerkcode. Voorbeeld (MCM) iu=/123,456/homepage
sz	Formaat van advertentiemateriaal. Als u meerdere formaten wilt opnemen, gebruikt u de verticale balk (|) als scheidingsteken tussen de formaten. Voorbeeld sz=320x50 voor één formaat sz=320x50|300x50 voor meerdere formaten We raden u aan sluistekens (|) in Tagless Requests te coderen met %7c. Voorbeeld &sz=216x36|300x50|320x50 wordt &sz=216x36%7c300x50%7c320x50.
url	URL van het domein dat het eerste advertentieverzoek host. Alleen vereist voor MCM-verzoeken. Voorbeeld url=www.example.com
c	Correlatorwaarde (of cachebusting-waarde). Dit moet een willekeurig getal zijn (letters zijn niet toegestaan) dat door een uitgever is gepubliceerd om te zorgen dat een nieuwe oproep naar de advertentieserver wordt gestuurd telkens als de pagina wordt geladen, om verschillen in het aantal getelde vertoningen te voorkomen. Voorbeeld c=8362527364
tile	Positie van de tag op een webpagina. De waarde moet een uniek geheel getal zijn. Voor een gemakkelijkere implementatie raden we een oplopende waarde aan. Dit is alleen vereist als meerdere advertentietags dezelfde advertentieblokcode (iu=) en correlatorwaarde (c=) gebruiken op dezelfde pagina. Voorbeeld 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

Optionele parameters

Parameter	Beschrijving
d_imp	Schakelaar voor vertraagde vertoningen. Indien opgenomen, zijn vertoningsaantallen op verzoek uitgezet en wordt de macro voor weergegeven vertoningen in het geretourneerde advertentiemateriaal of de informatie van de parameter d_imp_hdr gebruikt om een vertoning te registreren. Voorbeeld d_imp=1 d_imp=0 (Dit is de standaardwaarde voor het tellen van Google Ad Manager-vertoningen.)
d_imp_hdr	Schakelaar voor informatie over vertraagde vertoningsheaders. Indien opgenomen, wordt de weergave-URL die wordt gebruikt voor vertoningsaantallen geretourneerd in de HTTP-header. Deze headerinformatie wordt standaard niet gedefinieerd. Een uitgever moet vervolgens deze weergave-URL pingen om een vertoning te tellen. Meer informatie over vertoningsaantallen en Tagless Requests. De header Google-Delayed-Impression bevat de Google Ad Manager-vertonings-URL. De Google-3rdParty-Delayed-Impression-header bevat de externe vertonings-URL, indien aanwezig in het advertentiemateriaal. Voorbeeld d_imp_hdr=1 d_imp_hdr=0 (Schakelt informatie over vertraagde vertoningsheaders expliciet uit.)
t	Sleutel/waarde-paren op advertentieruimteniveau. Elke sleutel en waarde worden gescheiden door het gelijkteken =. Sleutel/waarde-paren worden gescheiden door een ampersand &. Elke sleutel en waarde moeten individueel worden gecodeerd met een URL en vervolgens moet de gehele tekenreeks worden gecodeerd met een URL. Elke sleutel in een set sleutel/waarden moet uniek zijn. Als u dezelfde sleutel meerdere keren opgeeft, wordt er slechts rekening gehouden met een van de bijbehorende waarden. Voorbeeld De parameter t=genre%3Daction%26movie%3DMr+%2526+Mrs+Smith wijst de sleutel 'genre' toe aan de waarde 'action' en de sleutel 'movie' aan 'Mr & Mrs Smith'. Houd er rekening mee dat de '&' tussen sleutel/waarde-toewijzingen enkelvoudig is gecodeerd (%26), maar dubbel is gecodeerd (%2526) als deze voorkomt in een waarde. Gebruik excl_cat als een speciale sleutel voor concurrentie-uitsluitingen. Voorbeeld t=excl_cat%3Dairlines t=interest%3Dsports%2Cnews%26excl_cat%3Dairlines De volgende tekens zijn niet toegestaan in sleutels of waarden: " ' ! + # * ~ ; ^ ( ) < > [ ] = . Spaties zijn toegestaan in waarden (met de escapecodes %20 of +), maar niet in sleutels. Voorbeeld Als de sleutel 'a' wordt ingesteld op de waarde 'b+c' met t=a%3Db%252Bc, werkt deze niet.
m	De waarde mime-type van de HTTP-header. Voorbeeld m=text/wml
mob	Verzoekindicator voor mobiele advertentie. Voorbeeld mob=js (Dit is de enige geaccepteerde waarde.)
ppid	Met de door de uitgever verstrekte ID (PPID) kunnen uitgevers Google Ad Manager een ID sturen voor gebruik in frequentielimieten, doelgroepsegmentering en -targeting, opeenvolgende advertentieroulatie en andere beheeropties voor op doelgroepen gebaseerde advertentieweergave op apparaten. Voorbeeld ppid=12JD92JD8078S8J29SDOAKC0EF230337
u_w	Breedte van scherm van mobiel apparaat, waarbij de automatische detectie van de advertentieserver wordt overschreven. Voorbeeld u_w=1024
u_h	Hoogte van scherm van mobiel apparaat, waarbij de automatische detectie van de advertentieserver wordt overschreven. Voorbeeld u_h=768
submodel	Hardware-informatie over het mobiele apparaat, waarbij de automatische detectie van de advertentieserver wordt overschreven. Voorbeeld submodel=iPhone4%2C1 (De komma om de submodelwaarde te scheiden, is gecodeerd.) Submodelwaarden: iPhone (eerste generatie): 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 en LTE): iPhone5,1 iPhone 5 (CDMA en LTE): iPhone5,2 iPhone 5c: (GSM en CDMA): iPhone5,3 iPhone 5c (GSM en CDMA): iPhone5,4 iPhone 5s (GSM en CDMA): iPhone6,1 iPhone 5s (GSM en 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  Eerste generatie iPod: iPod1,1 Tweede generatie iPod: iPod2,1 Derde generatie iPod: iPod3,1 Vierde generatie iPod: iPod4,1 Vijfde generatie iPod: iPod5,1 Eerste generatie iPad (wifi): iPad1,1 Eerste generatie iPad (AT&T): iPad1,2 Tweede generatie iPad (wifi): iPad2,1 Tweede generatie iPad (AT&T): iPad2,2 Tweede generatie iPad (Verizon): iPad2,3 Tweede generatie iPad (wifi): iPad2,4 Derde generatie iPad (wifi): iPad3,1 Derde generatie iPad (Verizon): iPad3,2 Derde generatie iPad (AT&T): iPad3,3 Vierde generatie iPad (wifi): iPad3,4 Vierde generatie iPad (AT&T): iPad3,5 Vierde generatie iPad (Verizon): iPad3,6 iPad Mini (wifi): iPad2,5 iPad Mini (AT&T-US; GSM en LTE 4, 17): iPad2,6 iPad Mini (Verizon-World; GSM, DMA en LTE 1,3,5,13,25): iPad2,7 iPad Mini Retina (wifi): iPad4,4 iPad Mini Retina (LTE): iPad4,5 iPad Air (wifi): iPad4,1 iPad Air (LTE): iPad4,2

 

U kunt de opnieuw instelbare apparaat-ID (RDID) gebruiken voor frequentielimieten en doelgroeptargeting. Meer informatie over hoe u RDID instelt voor Tagless Requests.

Vertoningstracking activeren

Ad Manager kan gedownloade vertoningen, ook wel vertraagde vertoningen genoemd, bijhouden voor Tagless Requests. Gebruik hiervoor een van de onderstaande opties, maar niet allemaal tegelijk. Als u alle opties tegelijk gebruikt, kan het voorkomen dat vertoningen dubbel (of driedubbel) worden geteld.

We raden optie 1 aan, maar daarvoor moet u toegang hebben tot HTTP-reactieheaders en een op headers gebaseerd protocol kunnen implementeren.

Optie 1: Lees de HTTP-reactieheader om vertoningsaantallen te beheren

Voeg de parameter d_imp=1 en d_imp_hdr=1 toe aan uw Tagless Request, zodat Google Ad Manager pas een (gedownloade) vertoning registreert nadat u handmatig een vertoningsping activeert met de HTTP-header-URL Google-Delayed-Impression. Wanneer de vertoningsping is geactiveerd, wordt er een 'Advertentieserver-vertoning' en een 'Gedownloade advertentieserver-vertoning' geregistreerd door Google Ad Manager.

Voeg de macro voor weergegeven vertoningen niet toe voor advertentiemateriaal dat wordt geretourneerd door Tagless Requests om zo te voorkomen dat een vertoning twee keer wordt meegeteld.

Optie 2: Gebruik de macro voor weergegeven vertoningen

Als u geen toegang heeft tot HTTP-reactieheaders, voegt u de macro voor weergegeven vertoningen toe aan het codefragment van elk advertentiemateriaalitem dat door een Tagless Request wordt geretourneerd. Deze macro wordt uitgebreid naar een URL die tijdens de weergave door het advertentiemateriaal wordt verzonden.

Een Tagless Request maken om de code voor advertentiemateriaal op te halen

Webcontent.

Tagless Requests worden doorgaans gebruikt in omgevingen zonder Google-tags of SDK-support. Als u een Tagless Request op internet maakt, moet u deze in een <iframe> laden om de geretourneerde onbewerkte code uit te voeren.

Aangepaste omgevingen zonder een Google SDK

Als u onbewerkte code voor advertentiemateriaal wilt ophalen zonder Google-tags of SDK-support (bijvoorbeeld in het geval van een settopbox die niet van Google is), raadpleegt u de volgende richtlijnen:

• Stel een geldige user-agent in in de User-Agent-header van het verzoek om te zorgen dat de targeting correct werkt.
• Zorg dat uw omgeving rich media-gedrag kan verwerken, inclusief JavaScript en uitbreiding van advertentiemateriaal.
• Stuur een HTTPS-verzoek naar Google Ad Manager.
• Inspecteer de reactiestatus om te controleren of 'HTTP 200/OK' aanwezig is, waarmee wordt aangegeven dat het verzoek correct is opgemaakt.

Niet-ondersteunde functies met Tagless Requests

• Actieve weergave
• Ad Exchange
• Cookies of mobiele app-ID's die worden gebruikt voor tracking
• Wrappers voor advertentiemateriaal
• Dynamische toewijzing met AdSense, Ad Exchange of AdMob
• Native voorraad
• Voorkeursdeals
• Voorbeelden van advertentiemateriaal

Tagless Requests die gampad/ad in html-afbeeldingstags (<img>) gebruiken, bieden geen JavaScript-trackingcode en worden niet ondersteund voor het tellen van gedownloade vertoningen.

Als u over deze advertenties wilt rapporteren, gebruikt u de statistiek Totaal aantal codeweergaven in de Ad Manager-rapportage.