Einbau des Google Mobile Ads SDK: Unterschied zwischen den Versionen

(7 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)

Zeile 132:

===Politische Werbung in nativen Apps===

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

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 ~~danach~~ das Keyword '''''political_ad''''' zu den '''''kw''''' Keywords hinzu (siehe [[#Keywords (Anhängen von Key-Value-Paaren)]]).

#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 ~~entsprechende~~ 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 reagieren sollte. Die Mitteilung erfolgt über ein '''''political_ad'''''-Event an die App (siehe [[#Dokumentation der iq digital App Events]])

#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 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 ~~value~~ 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.

*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====

Zeile 158:

====Testschaltung====

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

<pre>iqdtests,political_ad_test</pre>

~~'''~~iqdtests~~'''~~,~~'''~~political_ad_test~~'''~~

Damit läuft auf iqadtile1, 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.

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 182:

Zeile 180:

Es gibt vielfältige Optionen, wie das Easter-Egg aktiviert werden kann. Mehrfache/unsinnige Taps auf UI-Elemente oder eine ganz spezielle Eingabe ins Suchfeld seien hier beispielhaft genannt. Die iq digital erlaubt sich aber die Vorgabe, dass unter Android und iOS das Debug-Easter-Egg identisch aktiviert wird. Bei der Art der Aktivierung des Debug-Easter-Egg stehen wir gerne beratend zur Seite.

'''Achtung!''' Die Keywords und die Einstellungen im Easter-Egg müssen auch nach App Neustart verbleiben. Bei Tests ist es oft notwendig, dass die App zur Wiederholung eines "sauberen" Tests neu gestartet werden muss. Die Keywords und Einstellungen verbleiben also solange, bis ein Nutzer diese Einstellung im Dialog wieder manuell zurücksetzt.

===Wichtige Hinweise zu dieser Anleitung===

Zeile 369:

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===

===political_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]]).

Das political_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.

Der "data"-String enthält die PoliticalAdTransparencyUrl, 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.

;<nowiki>"political_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]]

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

@@ Zeile 132: / Zeile 132: @@
 ===Politische Werbung in nativen Apps===
-Politische Kampagnen benötigen vom Benutzer Consent in der Datenschutzerklärung. Damit der Adserver auch korrekt dies berücksichtigen kann, benötigt er eine Information durch die App. Der genaue Workflow funktioniert wie folgt:
+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 danach das Keyword '''''political_ad''''' zu den '''''kw''''' Keywords hinzu (siehe [[#Keywords (Anhängen von Key-Value-Paaren)]]).
+#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 entsprechende 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 reagieren sollte. Die Mitteilung erfolgt über ein '''''political_ad'''''-Event an die App (siehe [[#Dokumentation der iq digital App Events]])
+#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 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 value 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.
+*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====
@@ Zeile 158: / Zeile 158: @@
 ====Testschaltung====
 Im Debug Easteregg können folgende folgendes Keyword (Komma separiert) eingestellt werden:
+<pre>iqdtests,political_ad_test</pre>
-'''iqdtests''','''political_ad_test'''
+Damit läuft auf iqadtile1, 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.
-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 182: / Zeile 180: @@
 Es gibt vielfältige Optionen, wie das Easter-Egg aktiviert werden kann. Mehrfache/unsinnige Taps auf UI-Elemente oder eine ganz spezielle Eingabe ins Suchfeld seien hier beispielhaft genannt. Die iq digital erlaubt sich aber die Vorgabe, dass unter Android und iOS das  Debug-Easter-Egg identisch aktiviert wird. Bei der Art der Aktivierung des Debug-Easter-Egg stehen wir gerne beratend zur Seite.
+'''Achtung!''' Die Keywords und die Einstellungen im Easter-Egg müssen auch nach App Neustart verbleiben. Bei Tests ist es oft notwendig, dass die App zur Wiederholung eines "sauberen" Tests neu gestartet werden muss. Die Keywords und Einstellungen verbleiben also solange, bis ein Nutzer diese Einstellung im Dialog wieder manuell zurücksetzt.
 ===Wichtige Hinweise zu dieser Anleitung===
@@ Zeile 369: / Zeile 369: @@
 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===
+===political_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]]).
+Das political_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.
+Der "data"-String enthält die PoliticalAdTransparencyUrl, 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.
+;<nowiki>"political_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]]
 [[en:Integration of the Google Mobile Ads SDK]]