Einbau des Google Mobile Ads SDK: Unterschied zwischen den Versionen

(12 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).

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

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

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

====Beispiel ====

Zeile 156:

[[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 364:

Zeile 368:

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

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.

@@ 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).
+#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====
 *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 value.
+*Im Fall einer politischen Anzeige sendet es ein Event an die App mit Key '''''political_ad''''' und der eingestellten PoliticalAdTransparencyUrl als "data"-String.
 ====Beispiel ====
@@ Zeile 156: / Zeile 156: @@
 [[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 364: / Zeile 368: @@
 ===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).
+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.