Einbau des Google Mobile Ads SDK - Versionsgeschichte

Tlohmann am 3. Juni 2026 um 10:10 Uhr

2026-06-03T10:10:48Z

← Nächstältere Version		Version vom 3. Juni 2026, 12:10 Uhr
Zeile 180:		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.		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===		===Wichtige Hinweise zu dieser Anleitung===
Zeile 367:		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.		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:====		====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]]		[[Kategorie:Ad Technology]][[Kategorie:APP]]
	[[en:Integration of the Google Mobile Ads SDK]]		[[en:Integration of the Google Mobile Ads SDK]]

Tlohmann: /* Testschaltung */

2026-05-06T13:59:53Z

Testschaltung

← Nächstältere Version		Version vom 6. Mai 2026, 15:59 Uhr
Zeile 159:		Zeile 159:
	Im Debug Easteregg können folgende folgendes Keyword (Komma separiert) eingestellt werden:		Im Debug Easteregg können folgende folgendes Keyword (Komma separiert) eingestellt werden:
	<pre>iqdtests,political_ad_test</pre>		<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.		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.

	===Debugging===		===Debugging===

Tlohmann: /* Aufgaben der App (Aufgaben des Publishers) */

2026-02-18T10:21:51Z

Aufgaben der App (Aufgaben des Publishers)

← Nächstältere Version		Version vom 18. Februar 2026, 12:21 Uhr
Zeile 145:		Zeile 145:
	*Die App wertet den Consent String aus und prüft, ob der Benutzer Consent für politische Werbung gegeben hat		*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''''')		*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====		====Aufgaben des Werbetemplates====

Tlohmann: /* Aufgaben der App (Aufgaben des Publishers) */

2026-02-18T10:20:53Z

Aufgaben der App (Aufgaben des Publishers)

← Nächstältere Version		Version vom 18. Februar 2026, 12:20 Uhr
Zeile 145:		Zeile 145:
	*Die App wertet den Consent String aus und prüft, ob der Benutzer Consent für politische Werbung gegeben hat		*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''''')		*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 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.

	====Aufgaben des Werbetemplates====		====Aufgaben des Werbetemplates====

Tlohmann am 18. Februar 2026 um 10:19 Uhr

2026-02-18T10:19:53Z

← Nächstältere Version		Version vom 18. Februar 2026, 12:19 Uhr
Zeile 158:		Zeile 158:
	====Testschaltung====		====Testschaltung====
	Im Debug Easteregg können folgende folgendes Keyword (Komma separiert) eingestellt werden:		Im Debug Easteregg können folgende folgendes Keyword (Komma separiert) eingestellt werden:

	<pre>iqdtests,political_ad_test</pre>		<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.		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.

Tlohmann: /* Politische Werbung in nativen Apps */

2026-02-18T09:58:14Z

Politische Werbung in nativen Apps

← Nächstältere Version		Version vom 18. Februar 2026, 11:58 Uhr
Zeile 132:		Zeile 132:

	===Politische Werbung in nativen Apps===		===Politische Werbung in nativen Apps===
	Politische Kampagnen benötigen vom Benutzer Consent. Damit der Adserver dies korrekt 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====		====Workflow====

Tlohmann: /* Politische Werbung in nativen Apps */

2026-02-18T09:57:36Z

Politische Werbung in nativen Apps

← Nächstältere Version		Version vom 18. Februar 2026, 11:57 Uhr
Zeile 132:		Zeile 132:

	===Politische Werbung in nativen Apps===		===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 Consent. Damit der Adserver dies korrekt berücksichtigen kann, benötigt er eine Information durch die App. Der genaue Workflow funktioniert wie folgt:

	====Workflow====		====Workflow====
	#Benutzer entscheidet in der CMP, ob er Consent für poltische Werbung erteilt		#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		#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)		#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.		#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		*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''''')		*Im Falle von Consent für politische Werbung fügt die App das Keyword '''''political_ad''''' dem CustomTargeting hinzu (zum Key '''''kw''''')

Tlohmann: /* Testschaltung */

2026-02-18T07:12:14Z

Testschaltung

← Nächstältere Version		Version vom 18. Februar 2026, 09:12 Uhr
Zeile 159:		Zeile 159:
	Im Debug Easteregg können folgende folgendes Keyword (Komma separiert) eingestellt werden:		Im Debug Easteregg können folgende folgendes Keyword (Komma separiert) eingestellt werden:

	~~'''~~iqdtests~~'''~~,~~'''~~political_ad_test~~'''~~		<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.		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.

Tlohmann: /* Testschaltung */

2026-02-18T07:11:36Z

Testschaltung

← Nächstältere Version		Version vom 18. Februar 2026, 09:11 Uhr
Zeile 157:		Zeile 157:

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

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

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

Tlohmann: /* Testschaltung */

2026-02-17T14:46:30Z

Testschaltung

← Nächstältere Version		Version vom 17. Februar 2026, 16:46 Uhr
Zeile 159:		Zeile 159:
	Im Debug Easteregg kann folgendes Keyword eingestellt werden:		Im Debug Easteregg kann folgendes Keyword eingestellt werden:

	~~<pre>~~political_ad_test~~</pre>~~		'''political_ad_test'''

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