Einbau des Google Mobile Ads SDK: Unterschied zwischen den Versionen

(23 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)

Zeile 130:

*https://developers.google.com/ad-manager/mobile-ads-sdk/ios/targeting?hl=de#content_url

*https://developers.google.com/ad-manager/mobile-ads-sdk/android/targeting?hl=de#content_url

===Politische Werbung in nativen Apps===

Politische Kampagnen benötigen vom Benutzer einen Consent. Damit der Adserver dies korrekt berücksichtigen kann, benötigt er eine Information durch die App. Der genaue Workflow funktioniert wie folgt:

====Workflow====

#Benutzer entscheidet in der CMP, ob er Consent für poltische Werbung erteilt

#Die App wertet den Consent aus und prüft, ob für politische Werbung Consent erteilt worden ist

#Wurde Consent erteilt, fügt die App bei jedem Adrequest das Keyword '''''political_ad''''' zu den '''''kw''''' Keywords hinzu (siehe [[#Keywords (Anhängen von Key-Value-Paaren)]]).

#Der Adserver sieht das Keyword '''''political_ad''''' im Adrequest und hat jetzt die Möglichkeit eine politische Kampagne, die auf das Keyword getargetet ist, auszuliefern (Dies ist aber kein Zwang, er kann auch andere Kampagnen ausliefern)

#Wird vom Adserver eine politische Kampagne ausgespielt, wird ein Creative an die App ausgeliefert, welches eine zusätzlich Einstellung im Template trägt. Dies führt dazu, dass das Creative der App mitteilt, dass sich in dem betroffenen Werbeslot tatsächlich eine politische Kampagne befindet und die App darauf mit Wechsel der Anzeigenkennzeichnung reagieren sollte. Die Mitteilung erfolgt über ein '''''political_ad'''''-Event an die App (siehe [[#Dokumentation der iq digital App Events]])

#Die App empfängt das '''''political_ad'''''-Event und kann darauf reagieren. Die iqdigital empfiehlt, dass die Anzeigenkennzeichnung über dem betroffenen Werbeslot sich ändert zu '''''Politische Anzeige''''' und es einen Link auf die sogenannte Political Ad Transparency Url zu der Kampagne gibt (welche im Event übergeben wird). '''Wichtig:''' Die Verantwortlichkeit, ob und wie durch die App auf das '''''political_ad'''''-Event reagiert wird, liegt beim Publisher und der App.

====Aufgaben der App (Aufgaben des Publishers)====

*Die App wertet den Consent String aus und prüft, ob der Benutzer Consent für politische Werbung gegeben hat

*Im Falle von Consent für politische Werbung fügt die App das Keyword '''''political_ad''''' dem CustomTargeting hinzu (zum Key '''''kw''''')

*Wenn die App ein '''''political_ad'''''-Event durch ein Creative erhält, sollte sie darauf reagieren, zum Beispiel wie oben beschrieben die Anzeigenkennzeichnung abändern auf '''''Politische Anzeige'''''. Wenn im Event zusätzlich als data-String eine URL übergeben wird, sollte neben Anzeigenkennzeichnung '''''Politische Anzeige''''' ein Link mit der URL und dem Text '''''(mehr dazu)''''' erscheinen. Ein Klick auf den Link öffnet dann die Url, wo der Benutzer weiterführende Informationen zur Art der Kampagne erhält.

====Aufgaben des Werbetemplates====

*Im Adserver muss eine politische Kampagne entsprechend konfiguriert werden. Dies geschieht über Einstellungen im Werbetemplate. Dabei wird markiert, dass das Creative zu einer politischen Kampagne gehört und die PoliticalAdTransparencyUrl eingestellt (für den ''(mehr dazu)'' Link)

*Das Werbetemplate wertet intern aus, ob es eine politische Anzeige ist

*Im Fall einer politischen Anzeige sendet es ein Event an die App mit Key '''''political_ad''''' und der eingestellten PoliticalAdTransparencyUrl als "data"-String.

====Beispiel ====

Angefügt ist ein Beispiel einer Testkampagne, welche als politische Anzeige markiert worden ist.

[[Datei:Political_Ad_Testkampagne.png|800px|thumbnail|Darstellung einer politischen Kampagne aus dem Web (rechts im Bild)]]

====Testschaltung====

Im Debug Easteregg können folgende folgendes Keyword (Komma separiert) eingestellt werden:

<pre>iqdtests,political_ad_test</pre>

Damit läuft auf iqadtile3 und/oder iqadtile4 ein oranges Test Ad mit dem Text "POLITICAL AD Test 320x320". Dies erscheint allerdings nur, wenn die App gemäß der Anleitung für politische Werbung das Keyword political_ad nach Auswertung des Consents übermittelt.

===Debugging===

Zeile 159:

Zeile 189:

Die iq digital steht für Fragen und Kommentare gerne zur Verfügung. Sollten wir einmal nicht weiterhelfen können, ist es uns möglich einen Entwickler von Google als Ansprechpartner in die Diskussion mit einzubeziehen.

====Tim Lohmann (Mobile Developer Ad Technology)====

====Mary Habibi (Web Developer)====

~~;Telefon:+49 211 887 2336~~

;E-Mail:mary.habibi@iqdigital.de

====Tim Lohmann (Senior Mobile Developer Ad Technology)====

;E-Mail:tim.lohmann@iqdigital.de

Zeile 318:

Zeile 350:

Der "data"-String hat das Format '''"width:height"''' für eine sofortige Änderung der Größe.

=====Parameter=====

====Parameter====

Die Parameter werden mit einem Doppelpunkt von einander getrennt.

;width:Die neue Breite des Adviews in Pixel (Device-Independent-Pixel) als ganze Zahl.

Zeile 324:

Zeile 356:

{{Warnung|text=Ausnahme: Für eine Anpassung auf die maximal verfügbare Breite oder Höhe wird der Wert '''max''' verwendet. Mit maximaler verfügbare Breite bzw. Höhe ist im Normalfall die Displaybreite bzw. -Höhe gemeint. Sollte eine App hier zwingende Abweichungen haben, wie einen notwendigen Rand, muss dies unbedingt '''frühzeitig mit iq digital''' besprochen werden.}}

====Beispielaufrufe:====

Beispielaufrufe:

;<nowiki>"setsize","320:80"</nowiki>:Adview bekommt die neue Größe 320x80 Pixel

;<nowiki>"setsize","320:240"</nowiki>:Adview bekommt die neue Größe 320x240 Pixel

Zeile 336:

Zeile 367:

Der "data"-String hat für dieses Event keine Bedeutung und kann ignoriert werden. Da das AppEventListener Interface von Google eine @NonNull Annotation für data hat, wird beim noad-Event einfach der Wert "noad" für data übergeben, da der leere String von Google als null umgewandelt wird.

===policial_ad - Event===

Das policial_ad-Event wird von den Werbetemplates der iq digital aufgerufen, um der App zu signalisieren, dass auf dieser Platzierung eine Politische Kampagen existiert und sie darauf reagieren soll (siehe [[#Politische Werbung in nativen Apps]]).

Der "data"-String enthält die PolticialAdTransparencyUrl, sofern sie in der Kampagne im Adserver definiert wurde.

====Beispielaufruf:====

;<nowiki>"policial_ad","https://www.diesisteinekampagne.de/transparency.html"</nowiki>: Die App sollte gemäß der Empfehlung "Politische Anzeige [https://www.diesisteinekampagne.de/transparency.html (mehr dazu)]" als Anzeigenkennzeichnung für die Platzierung benutzen.

[[Kategorie:Ad Technology]][[Kategorie:APP~~]][[Kategorie:Test~~]]

[[Kategorie:Ad Technology]][[Kategorie:APP]]

[[en:Integration of the Google Mobile Ads SDK]]

@@ Zeile 130: / Zeile 130: @@
 *https://developers.google.com/ad-manager/mobile-ads-sdk/ios/targeting?hl=de#content_url
 *https://developers.google.com/ad-manager/mobile-ads-sdk/android/targeting?hl=de#content_url
+===Politische Werbung in nativen Apps===
+Politische Kampagnen benötigen vom Benutzer einen Consent. Damit der Adserver dies korrekt berücksichtigen kann, benötigt er eine Information durch die App. Der genaue Workflow funktioniert wie folgt:
+====Workflow====
+#Benutzer entscheidet in der CMP, ob er Consent für poltische Werbung erteilt
+#Die App wertet den Consent aus und prüft, ob für politische Werbung Consent erteilt worden ist
+#Wurde Consent erteilt, fügt die App bei jedem Adrequest das Keyword '''''political_ad''''' zu den '''''kw''''' Keywords hinzu (siehe [[#Keywords (Anhängen von Key-Value-Paaren)]]).
+#Der Adserver sieht das Keyword '''''political_ad''''' im Adrequest und hat jetzt die Möglichkeit eine politische Kampagne, die auf das Keyword getargetet ist, auszuliefern (Dies ist aber kein Zwang, er kann auch andere Kampagnen ausliefern)
+#Wird vom Adserver eine politische Kampagne ausgespielt, wird ein Creative an die App ausgeliefert, welches eine zusätzlich Einstellung im Template trägt. Dies führt dazu, dass das Creative der App mitteilt, dass sich in dem betroffenen Werbeslot tatsächlich eine politische Kampagne befindet und die App darauf mit Wechsel der Anzeigenkennzeichnung reagieren sollte. Die Mitteilung erfolgt über ein '''''political_ad'''''-Event an die App (siehe [[#Dokumentation der iq digital App Events]])
+#Die App empfängt das '''''political_ad'''''-Event und kann darauf reagieren. Die iqdigital empfiehlt, dass die Anzeigenkennzeichnung über dem betroffenen Werbeslot sich ändert zu '''''Politische Anzeige''''' und es einen Link auf die sogenannte Political Ad Transparency Url zu der Kampagne gibt (welche im Event übergeben wird). '''Wichtig:''' Die Verantwortlichkeit, ob und wie durch die App auf das '''''political_ad'''''-Event reagiert wird, liegt beim Publisher und der App.
+====Aufgaben der App (Aufgaben des Publishers)====
+*Die App wertet den Consent String aus und prüft, ob der Benutzer Consent für politische Werbung gegeben hat
+*Im Falle von Consent für politische Werbung fügt die App das Keyword '''''political_ad''''' dem CustomTargeting hinzu (zum Key '''''kw''''')
+*Wenn die App ein '''''political_ad'''''-Event durch ein Creative erhält, sollte sie darauf reagieren, zum Beispiel wie oben beschrieben die Anzeigenkennzeichnung abändern auf '''''Politische Anzeige'''''. Wenn im Event zusätzlich als data-String eine URL übergeben wird, sollte neben Anzeigenkennzeichnung '''''Politische Anzeige''''' ein Link mit der URL und dem Text '''''(mehr dazu)''''' erscheinen. Ein Klick auf den Link öffnet dann die Url, wo der Benutzer weiterführende Informationen zur Art der Kampagne erhält.
+====Aufgaben des Werbetemplates====
+*Im Adserver muss eine politische Kampagne entsprechend konfiguriert werden. Dies geschieht über Einstellungen im Werbetemplate. Dabei wird markiert, dass das Creative zu einer politischen Kampagne gehört und die PoliticalAdTransparencyUrl eingestellt (für den ''(mehr dazu)'' Link)
+*Das Werbetemplate wertet intern aus, ob es eine politische Anzeige ist
+*Im Fall einer politischen Anzeige sendet es ein Event an die App mit Key '''''political_ad''''' und der eingestellten PoliticalAdTransparencyUrl als "data"-String.
+====Beispiel ====
+Angefügt ist ein Beispiel einer Testkampagne, welche als politische Anzeige markiert worden ist.
+[[Datei:Political_Ad_Testkampagne.png|800px|thumbnail|Darstellung einer politischen Kampagne aus dem Web (rechts im Bild)]]
+====Testschaltung====
+Im Debug Easteregg können folgende folgendes Keyword (Komma separiert) eingestellt werden:
+<pre>iqdtests,political_ad_test</pre>
+Damit läuft auf iqadtile3 und/oder iqadtile4 ein oranges Test Ad mit dem Text "POLITICAL AD Test 320x320". Dies erscheint allerdings nur, wenn die App gemäß der Anleitung für politische Werbung das Keyword political_ad nach Auswertung des Consents übermittelt.
 ===Debugging===
@@ Zeile 159: / Zeile 189: @@
 Die iq digital steht für Fragen und Kommentare gerne zur Verfügung. Sollten wir einmal nicht weiterhelfen können, ist es uns möglich einen Entwickler von Google als Ansprechpartner in die Diskussion mit einzubeziehen.
-====Tim Lohmann (Mobile Developer Ad Technology)====
+====Mary Habibi (Web Developer)====
-;Telefon:+49 211 887 2336
+;E-Mail:mary.habibi@iqdigital.de
+====Tim Lohmann (Senior Mobile Developer Ad Technology)====
 ;E-Mail:tim.lohmann@iqdigital.de
@@ Zeile 318: / Zeile 350: @@
 Der "data"-String hat das Format '''"width:height"''' für eine sofortige Änderung der Größe.
-=====Parameter=====
+====Parameter====
 Die Parameter werden mit einem Doppelpunkt von einander getrennt.
 ;width:Die neue Breite des Adviews in Pixel  (Device-Independent-Pixel) als ganze Zahl.
@@ Zeile 324: / Zeile 356: @@
 {{Warnung|text=Ausnahme: Für eine Anpassung auf die maximal verfügbare Breite oder Höhe wird der Wert '''max''' verwendet. Mit maximaler verfügbare Breite bzw. Höhe ist im Normalfall die Displaybreite bzw. -Höhe gemeint. Sollte eine App hier zwingende Abweichungen haben, wie einen notwendigen Rand, muss dies unbedingt '''frühzeitig mit iq digital''' besprochen werden.}}
+====Beispielaufrufe:====
-Beispielaufrufe:
 ;<nowiki>"setsize","320:80"</nowiki>:Adview bekommt die neue Größe 320x80 Pixel
 ;<nowiki>"setsize","320:240"</nowiki>:Adview bekommt die neue Größe 320x240 Pixel
@@ Zeile 336: / Zeile 367: @@
 Der "data"-String hat für dieses Event keine Bedeutung und kann ignoriert werden. Da das AppEventListener Interface von Google eine @NonNull Annotation für data hat, wird beim noad-Event einfach der Wert "noad" für data übergeben, da der leere String von Google als null umgewandelt wird.
+===policial_ad - Event===
+Das policial_ad-Event wird von den Werbetemplates der iq digital aufgerufen, um der App zu signalisieren, dass auf dieser Platzierung eine Politische Kampagen existiert und sie darauf reagieren soll (siehe [[#Politische Werbung in nativen Apps]]).
+Der "data"-String enthält die PolticialAdTransparencyUrl, sofern sie in der Kampagne im Adserver definiert wurde.
+====Beispielaufruf:====
+;<nowiki>"policial_ad","https://www.diesisteinekampagne.de/transparency.html"</nowiki>: Die App sollte gemäß der Empfehlung "Politische Anzeige [https://www.diesisteinekampagne.de/transparency.html (mehr dazu)]" als Anzeigenkennzeichnung für die Platzierung benutzen.
-[[Kategorie:Ad Technology]][[Kategorie:APP]][[Kategorie:Test]]
+[[Kategorie:Ad Technology]][[Kategorie:APP]]
 [[en:Integration of the Google Mobile Ads SDK]]