Integration of the Google Mobile Ads SDK - Revision history

Tlohmann: /* Debugging */

2026-06-03T10:13:16Z

Debugging

← Older revision		Revision as of 12:13, 3 June 2026
Line 181:		Line 181:
	There are a wide range of options for activation of the Easter Egg. Multiple/Pointless taps on UI elements or highly specific input in the search field are just some examples. However, iq digital has defined a rule that the debug Easter Egg is activated identically under Android and iOS. We are happy to be of assistance with regard to the method via which the debug Easter Egg is activated.		There are a wide range of options for activation of the Easter Egg. Multiple/Pointless taps on UI elements or highly specific input in the search field are just some examples. However, iq digital has defined a rule that the debug Easter Egg is activated identically under Android and iOS. We are happy to be of assistance with regard to the method via which the debug Easter Egg is activated.

	Important! The keywords and settings in the Easter Egg must remain in place even after the app is restarted. During testing, it is often necessary to restart the app in order to repeat a "clean" test. The keywords and settings will therefore remain in place until a user manually resets them in the dialog.		'''Important!''' The keywords and settings in the Easter Egg must remain in place even after the app is restarted. During testing, it is often necessary to restart the app in order to repeat a "clean" test. The keywords and settings will therefore remain in place until a user manually resets them in the dialog.

	===Important notes on these instructions===		===Important notes on these instructions===

Tlohmann at 10:12, 3 June 2026

2026-06-03T10:12:59Z

← Older revision		Revision as of 12:12, 3 June 2026
Line 180:		Line 180:

	There are a wide range of options for activation of the Easter Egg. Multiple/Pointless taps on UI elements or highly specific input in the search field are just some examples. However, iq digital has defined a rule that the debug Easter Egg is activated identically under Android and iOS. We are happy to be of assistance with regard to the method via which the debug Easter Egg is activated.		There are a wide range of options for activation of the Easter Egg. Multiple/Pointless taps on UI elements or highly specific input in the search field are just some examples. However, iq digital has defined a rule that the debug Easter Egg is activated identically under Android and iOS. We are happy to be of assistance with regard to the method via which the debug Easter Egg is activated.

			Important! The keywords and settings in the Easter Egg must remain in place even after the app is restarted. During testing, it is often necessary to restart the app in order to repeat a "clean" test. The keywords and settings will therefore remain in place until a user manually resets them in the dialog.

	===Important notes on these instructions===		===Important notes on these instructions===
Line 366:		Line 368:
	The "data" string has no meaning for this event and can be ignored. Since Google's AppEventListener interface has a @NonNull annotation for data, the noad event simply passes the value "noad" for data, since the empty string is converted as null by Google.		The "data" string has no meaning for this event and can be ignored. Since Google's AppEventListener interface has a @NonNull annotation for data, the noad event simply passes the value "noad" for data, since the empty string is converted as null by Google.

	===~~policial_ad~~ event===		===political_ad event===
	The ~~policial_ad~~ event is called by iq digital's advertising templates to signal to the app that a political campaign exists on this placement and that it should respond to it (see [[#Political advertising in native apps]]).		The political_ad event is called by iq digital's advertising templates to signal to the app that a political campaign exists on this placement and that it should respond to it (see [[#Political advertising in native apps]]).

	The "data" string contains the ~~PolticialAdTransparencyUrl~~, provided it has been defined in the campaign in the ad server.		The "data" string contains the PoliticalAdTransparencyUrl, provided it has been defined in the campaign in the ad server.

	====Example call:====		====Example call:====
	;<nowiki>"~~policial_ad~~","https://www.diesisteinekampagne.de/transparency.html"</nowiki>:The app should use "Politische Anzeige [https://www.diesisteinekampagne.de/transparency.html (mehr dazu)]" as the ad label for the placement, as recommended		;<nowiki>"political_ad","https://www.diesisteinekampagne.de/transparency.html"</nowiki>:The app should use "Politische Anzeige [https://www.diesisteinekampagne.de/transparency.html (mehr dazu)]" as the ad label for the placement, as recommended

	[[Kategorie:Ad Technology]][[Kategorie:APP]]		[[Kategorie:Ad Technology]][[Kategorie:APP]]
	[[de:Einbau des Google Mobile Ads SDK]]		[[de:Einbau des Google Mobile Ads SDK]]

Tlohmann: /* Political advertising in native apps */

2026-02-18T10:27:21Z

Political advertising in native apps

← Older revision		Revision as of 12:27, 18 February 2026
Line 146:		Line 146:
	*The app evaluates the consent string and checks whether the user has given consent for political advertising.		*The app evaluates the consent string and checks whether the user has given consent for political advertising.
	*If consent for political advertising has been given, the app adds the keyword '''''political_ad''''' to CustomTargeting (to key '''''kw''''').		*If consent for political advertising has been given, the app adds the keyword '''''political_ad''''' to CustomTargeting (to key '''''kw''''').
	*When the app receives a '''''political_ad''''' event through a creative, it should respond to it, for example by changing the ad label to '''''Politische Anzeige''''', as described above. If a URL is also passed as a data-String in the event, a link with the URL and the text '''''(~~more info~~)''''' should appear next to the ad label '''''Politische Anzeige'''''. Clicking on the link then opens the URL, where the user can find further information about the type of campaign.		*When the app receives a '''''political_ad''''' event through a creative, it should respond to it, for example by changing the ad label to '''''Politische Anzeige''''', as described above. If a URL is also passed as a data-String in the event, a link with the URL and the text '''''(mehr dazu)''''' should appear next to the ad label '''''Politische Anzeige'''''. Clicking on the link then opens the URL, where the user can find further information about the type of campaign.

	====Tasks of the advertising template====		====Tasks of the advertising template====
	*A political campaign must be configured accordingly in the ad server. This is done via settings in the advertising template. This involves marking that the creative belongs to a political campaign and setting the PoliticalAdTransparencyUrl (for the "(~~more info~~)" link).		*A political campaign must be configured accordingly in the ad server. This is done via settings in the advertising template. This involves marking that the creative belongs to a political campaign and setting the PoliticalAdTransparencyUrl (for the "(mehr dazu)" link).
	*The advertising template internally evaluates whether it is a political ad.		*The advertising template internally evaluates whether it is a political ad.
	*In the case of a political advertisement, it sends an event to the app with the key political_ad and the set PoliticalAdTransparencyUrl as the "data" string.		*In the case of a political advertisement, it sends an event to the app with the key political_ad and the set PoliticalAdTransparencyUrl as the "data" string.

Tlohmann: /* policial_ad event */

2026-02-18T10:26:35Z

policial_ad event

← Older revision		Revision as of 12:26, 18 February 2026
Line 367:		Line 367:

	===policial_ad event===		===policial_ad event===
	The policial_ad event is called by iq digital's advertising templates to signal to the app that a political campaign exists on this placement and that it should respond to it (see #Political advertising in native apps).		The policial_ad event is called by iq digital's advertising templates to signal to the app that a political campaign exists on this placement and that it should respond to it (see [[#Political advertising in native apps]]).

	The "data" string contains the PolticialAdTransparencyUrl, provided it has been defined in the campaign in the ad server.		The "data" string contains the PolticialAdTransparencyUrl, provided it has been defined in the campaign in the ad server.

Tlohmann: /* Documentation of the iq digital app events */

2026-02-18T10:25:53Z

Documentation of the iq digital app events

← Older revision		Revision as of 12:25, 18 February 2026
Line 365:		Line 365:

	The "data" string has no meaning for this event and can be ignored. Since Google's AppEventListener interface has a @NonNull annotation for data, the noad event simply passes the value "noad" for data, since the empty string is converted as null by Google.		The "data" string has no meaning for this event and can be ignored. Since Google's AppEventListener interface has a @NonNull annotation for data, the noad event simply passes the value "noad" for data, since the empty string is converted as null by Google.

			===policial_ad event===
			The policial_ad event is called by iq digital's advertising templates to signal to the app that a political campaign exists on this placement and that it should respond to it (see #Political advertising in native apps).

			The "data" string contains the PolticialAdTransparencyUrl, provided it has been defined in the campaign in the ad server.

			====Example call:====
			;<nowiki>"policial_ad","https://www.diesisteinekampagne.de/transparency.html"</nowiki>:The app should use "Politische Anzeige [https://www.diesisteinekampagne.de/transparency.html (mehr dazu)]" as the ad label for the placement, as recommended

	[[Kategorie:Ad Technology]][[Kategorie:APP]]		[[Kategorie:Ad Technology]][[Kategorie:APP]]
	[[de:Einbau des Google Mobile Ads SDK]]		[[de:Einbau des Google Mobile Ads SDK]]

Tlohmann: /* App tasks (publisher tasks) */

2026-02-18T10:22:14Z

App tasks (publisher tasks)

← Older revision		Revision as of 12:22, 18 February 2026
Line 146:		Line 146:
	*The app evaluates the consent string and checks whether the user has given consent for political advertising.		*The app evaluates the consent string and checks whether the user has given consent for political advertising.
	*If consent for political advertising has been given, the app adds the keyword '''''political_ad''''' to CustomTargeting (to key '''''kw''''').		*If consent for political advertising has been given, the app adds the keyword '''''political_ad''''' to CustomTargeting (to key '''''kw''''').
	*When the app receives a '''''political_ad''''' event through a creative, it should respond to it, for example by changing the ad label to '''''Politische Anzeige''''', as described above. If a URL is also passed as a ~~value~~ in the event, a link with the URL and the text '''''(more info)''''' should appear next to the ad label '''''Politische Anzeige'''''. Clicking on the link then opens the URL, where the user can find further information about the type of campaign.		*When the app receives a '''''political_ad''''' event through a creative, it should respond to it, for example by changing the ad label to '''''Politische Anzeige''''', as described above. If a URL is also passed as a data-String in the event, a link with the URL and the text '''''(more info)''''' should appear next to the ad label '''''Politische Anzeige'''''. Clicking on the link then opens the URL, where the user can find further information about the type of campaign.

	====Tasks of the advertising template====		====Tasks of the advertising template====

Tlohmann: /* Test placement */

2026-02-18T10:19:40Z

Test placement

← Older revision		Revision as of 12:19, 18 February 2026
Line 159:		Line 159:
	====Test placement====		====Test placement====
	The following keywords (separated by commas) can be set in the debug Easter egg:		The following keywords (separated by commas) can be set in the debug Easter egg:
			<pre>iqdtests,political_ad_test</pre>
	This will run an orange test ad on iqadtile1, iqadtile3 and/or iqadtile4 with the text "POLITICAL AD Test 320x320." However, this will only appear if the app transmits the keyword political_ad after evaluating consent in accordance with the instructions for political advertising.		This will run an orange test ad on iqadtile1, iqadtile3 and/or iqadtile4 with the text "POLITICAL AD Test 320x320." However, this will only appear if the app transmits the keyword political_ad after evaluating consent in accordance with the instructions for political advertising.

Tlohmann: /* App tasks (publisher tasks) */

2026-02-18T10:18:39Z

App tasks (publisher tasks)

← Older revision		Revision as of 12:18, 18 February 2026
Line 146:		Line 146:
	*The app evaluates the consent string and checks whether the user has given consent for political advertising.		*The app evaluates the consent string and checks whether the user has given consent for political advertising.
	*If consent for political advertising has been given, the app adds the keyword '''''political_ad''''' to CustomTargeting (to key '''''kw''''').		*If consent for political advertising has been given, the app adds the keyword '''''political_ad''''' to CustomTargeting (to key '''''kw''''').
	*When the app receives a '''''political_ad''''' event through a creative, it should respond to it, for example by changing the ad label to '''''Politische Anzeige''''', as described above. If a URL is also passed as a value in the event, a link with the URL and the text '''''(more info)" should appear next to the ad label '''''Politische Anzeige'''''. Clicking on the link then opens the URL, where the user can find further information about the type of campaign.		*When the app receives a '''''political_ad''''' event through a creative, it should respond to it, for example by changing the ad label to '''''Politische Anzeige''''', as described above. If a URL is also passed as a value in the event, a link with the URL and the text '''''(more info)''''' should appear next to the ad label '''''Politische Anzeige'''''. Clicking on the link then opens the URL, where the user can find further information about the type of campaign.

	====Tasks of the advertising template====		====Tasks of the advertising template====

Tlohmann: /* Political advertising in native apps */

2026-02-18T10:18:16Z

Political advertising in native apps

← Older revision		Revision as of 12:18, 18 February 2026
Line 138:		Line 138:
	#The user decides in the CMP whether to give consent for political advertising		#The user decides in the CMP whether to give consent for political advertising
	#The app evaluates the consent and checks whether consent has been given for political advertising		#The app evaluates the consent and checks whether consent has been given for political advertising
	#If consent has been given, the app adds the keyword '''''political_ad''''' to the '''''kw''''' keywords for each ad request (see #[[Keywords (attachment of key-value pairs)]]).		#If consent has been given, the app adds the keyword '''''political_ad''''' to the '''''kw''''' keywords for each ad request (see [[#Keywords (attachment of key-value pairs)]]).
	#The ad server sees the keyword '''''political_ad''''' in the ad request and now has the option of delivering a political campaign targeted to that keyword (however, this is not mandatory; it can also deliver other campaigns).		#The ad server sees the keyword '''''political_ad''''' in the ad request and now has the option of delivering a political campaign targeted to that keyword (however, this is not mandatory; it can also deliver other campaigns).
	#When an ad server plays a political campaign, a creative is delivered to the app that contains an additional setting in the template. This causes the creative to inform the app that the advertising slot in question actually contains a political campaign and that the app should respond by changing the ad label. The message is sent to the app via a political_ad event (see [[#Documentation of the iq digital app events]]).		#When an ad server plays a political campaign, a creative is delivered to the app that contains an additional setting in the template. This causes the creative to inform the app that the advertising slot in question actually contains a political campaign and that the app should respond by changing the ad label. The message is sent to the app via a political_ad event (see [[#Documentation of the iq digital app events]]).

Tlohmann: /* Political advertising in native apps */

2026-02-18T10:17:42Z

Political advertising in native apps

← Older revision		Revision as of 12:17, 18 February 2026
Line 138:		Line 138:
	#The user decides in the CMP whether to give consent for political advertising		#The user decides in the CMP whether to give consent for political advertising
	#The app evaluates the consent and checks whether consent has been given for political advertising		#The app evaluates the consent and checks whether consent has been given for political advertising
	#If consent has been given, the app adds the keyword '''''political_ad''''' to the '''''kw''''' keywords for each ad request (see #Keywords (~~Appending Key~~-~~Value Pairs~~)).		#If consent has been given, the app adds the keyword '''''political_ad''''' to the '''''kw''''' keywords for each ad request (see #[[Keywords (attachment of key-value pairs)]]).
	#The ad server sees the keyword '''''political_ad''''' in the ad request and now has the option of delivering a political campaign targeted to that keyword (however, this is not mandatory; it can also deliver other campaigns).		#The ad server sees the keyword '''''political_ad''''' in the ad request and now has the option of delivering a political campaign targeted to that keyword (however, this is not mandatory; it can also deliver other campaigns).
	#When an ad server plays a political campaign, a creative is delivered to the app that contains an additional setting in the template. This causes the creative to inform the app that the advertising slot in question actually contains a political campaign and that the app should respond by changing the ad label. The message is sent to the app via a political_ad event (see [[#Documentation of the iq digital app events]]).		#When an ad server plays a political campaign, a creative is delivered to the app that contains an additional setting in the template. This causes the creative to inform the app that the advertising slot in question actually contains a political campaign and that the app should respond by changing the ad label. The message is sent to the app via a political_ad event (see [[#Documentation of the iq digital app events]]).