Einbau des Google Mobile Ads SDK: Unterschied zwischen den Versionen

Zeile 271: Zeile 271:


==Banner-Anzeigen==
==Banner-Anzeigen==
{{SDKAppInfo
|info=
Die Werbeplatzierung ist ein Banner innerhalb einer Content-Seite. Je nach Werbeform kann diese Anzeige mehr oder weniger Interaktivität für den Endnutzer besitzen. Sie kann anmiert oder eine komplexe HTML-Anzeige sein. Es ist auch möglich dass die Anzeige durch bestimmte Ereignisse sich in der Größe verändert.
|position=
Die Platzierung ist zwischen Content-Elemente einer Seite platziert und erfordert eine Anzeigenkennzeichnung "Anzeige" oberhalb der Platzierung. Üblicherweise befinden sich mehrere Platzierungen innerhalb einer Seite.
|template=
*kümmert sich um die Funktionalität, welche je nach Werbeform simpel oder komplex sein kann.
|app=
*sendet die Adrequests für alle Platzierungen einer Seite
*baut für jede Platzierung eine Anzeigenkennzeichnung "Anzeige" oberhalb der Platzierung ein
*erstellt den Werbecontainer mit Größe, welche in der Antwort vom Andserver auf das Adrequest mitgeliefert wird
*lauscht mit dem EventListener auf mögliche setsize- oder noad-Events und verändert den Werbecontainer entsprechend.
*im Falle einer Ausbuchung: empfängt sie ein noad-Event, muss sie die Werbeplatzierung und die zugehörige Anzeigenkennzeichnung komplett entfernen bzw. ausblenden
|workflowad=
#App sendet Adrequest an Adserver
#Adserver antwortet mit Werbebuchung
#App erzeugt dynamisch die Werbeseite
#Werbecontainer wird auf die Display-Abmaße aufgezogen
#Werbetemplate skaliert Werbemittel in dem Container
|workflownoad=
#App sendet Adrequest an Adserver
#Adserver antwortet, dass er keine Werbebuchung hat
#App erzeugt '''keine''' Werbeseite bzw. entfernt eine zuvor erzeugte Werbeseite aus dem Seitenfluss
|creativesizes=
320x50, 320x53, 320x80, 320x106, 320x160, 320x320, 320x416, 320x460, 300x50, 300x75, 300x100, 300x150, 300x200, 300x250, 300x600
Weitere Größen sind möglich. Je nach Platzierung wird nur ein Auszug der Größenliste im Adrequest verwendet. Eine genaue Zuordnung erfolgt in einem separaten Dokument.
|keywords=
;kw:nospa, enozqi, digtransform, iqadtileX*
;tile:X*
X entspricht dabei der Nummer der Platzierung, z.B. iqadtile1, iqadtile3, iqadtile4, iqadtile99, iqadtile8
|links=
;iOS:https://developers.google.com/ad-manager/mobile-ads-sdk/ios/banner
;Android:https://developers.google.com/ad-manager/mobile-ads-sdk/ios/banner
}}
===Beschreibung===
===Beschreibung===
Die Werbeplatzierungen sind Banner-Platzierungen innerhalb der Content-Seite, die üblicherweise 320px Breite und eine bestimmte Höhe einnehmen. Sollte keine Werbung gebucht sein, wird die Platzierung ausgeblendet, es sollte kein Weißraum entstehen.  
Die Werbeplatzierungen sind Banner-Platzierungen innerhalb der Content-Seite, die üblicherweise 320px Breite und eine bestimmte Höhe einnehmen. Sollte keine Werbung gebucht sein, wird die Platzierung ausgeblendet, es sollte kein Weißraum entstehen.  
Die  Adrequests für diese Platzierungen sollten initial beim Pagerequest erfolgen. Bei sehr langen Seiten, ist es auch möglich weiter unten liegende Banner Platzierungen erst zu laden, wenn der untere Content generiert wird. Jedoch sollte dabei immer berücksichtigt werden, dass das Ad genug Zeit hat, rechtzeitig angezeigt zu werden.
Die  Adrequests für diese Platzierungen sollten initial beim Pagerequest erfolgen. Bei sehr langen Seiten, ist es auch möglich weiter unten liegende Banner Platzierungen erst zu laden, wenn der untere Content generiert wird. Jedoch sollte dabei immer berücksichtigt werden, dass das Ad genug Zeit hat, rechtzeitig angezeigt zu werden.
Für Banner-Platzierungen benutzen wir Pseudo-größen (z.B. 310x1, 310x4, 310x8 usw.). Damit das Banner in der korrekten Größe dargestellt wird, rufen die iq digital Templates ein bestimmtes Event auf. Dazu stellt die iq digital ein EventHandler-Klasse für Android zur Verfügung, die in die App integriert werden muss. Für iOS muss diese Klasse von den Appentwicklern portiert werden. Die EventHandler-Klasse benutzt eine spezielle Syntax für ein resize-Event. Die App muss bei Erhalt des Events dann entsprechend der Logik die Größe des Ad entsprechend ändern.
Für Banner-Platzierungen benutzen wir Pseudo-größen (z.B. 310x1, 310x4, 310x8 usw.). Damit das Banner in der korrekten Größe dargestellt wird, rufen die iq digital Templates ein bestimmtes Event auf. Dazu stellt die iq digital ein EventHandler-Klasse für Android zur Verfügung, die in die App integriert werden muss. Für iOS muss diese Klasse von den Appentwicklern portiert werden. Die EventHandler-Klasse benutzt eine spezielle Syntax für ein resize-Event. Die App muss bei Erhalt des Events dann entsprechend der Logik die Größe des Ad entsprechend ändern.
Die App Events, die von der EventHandler-Klasse behandelt werden müssen, sind im Anhang A dokumentiert. Für Android gibt es mit der PublisherAdAppEventListener.java eine Vorlage, die nur noch um appspezifischen Code erweitert werden muss.
Die App Events, die von der EventHandler-Klasse behandelt werden müssen, sind im Anhang A dokumentiert. Für Android gibt es mit der PublisherAdAppEventListener.java eine Vorlage, die nur noch um appspezifischen Code erweitert werden muss.
 
===Anhängen von Key-Value-Paaren:===
Bei den Werbeanzeigen muss die App entsprechend der Platzierung ein Keyword mitgeben, z.B. iqadtile1 für die Banner-Platzierung ganz oben, analog zu den MEW Platzierungen. (siehe oben: Anhängen von 1.2 Key-Value-Paaren).
Zusätzlich werden Key-Value-Paar tile1 benötigt
addCustomTargeting("tile","1")
Für die übrigen Platzierungen ist analog zu verfahren.


===Werbemittelkennzeichnung:===
Der Mandant muss über jeder Werbeplatzierung eine Werbemittelkennzeichnung einbauen. Hier empfehlen wir eine Kennzeichnung analog zur MEW-Werbekennzeichnung, z.B. das Wort "Anzeige" in vergleichbarer Schriftgröße und -farbe.
Damit die Werbekennzeichnung nicht sichtbar ist, falls keine Werbung für eine Platzierung gebucht ist, muss die Werbekennzeichnung ausgeblendet werden können. Hierzu stellt die oben beschriebene EventHandler-Klasse der iq digital ein spezielles noad-Event zur Verfügung. Der Mandant muss hier nur die Logik zum Ausblenden der Kennzeichnung einbauen. Das iq digital Template ruft im Falle einer Leer-Ausspielung dieses Event auf und die App blendet die Werbeplatzierung samt der Kennzeichnung aus. Eine Kennzeichnung über der Platzierung durch die iq digital ist nicht möglich.
Eine Beschreibung des noad-Event befindet sich im Anhang A.
==Anhang==
==Anhang==
===Dokumentation der iq digital App Events===
===Dokumentation der iq digital App Events===