...

Appendix

ATT (App Tracking Transparency / iOS) configuration.

Since iOS 14 Apple introduced the Apple Tracking Transparency framework, which requires that every app needs to expose which tracking data it uses. The R89SDK before presenting the CMP will make the ATT request. Add the NSUserTrackingUsageDescription to the Info.plist with an appropriate message.

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
	...
	<key>NSUserTrackingUsageDescription</key>
	<string>This app uses your data to provide personalized ads and improve user experience.</string>
	...
</dict>
</plist>

Geolocation permission configuration

The R89SDK will ask for the user’s location for setting it as a user-oriented First-Party Data. Add the NSLocationWhenInUseUsageDescription to the Info.plist with an appropriate message.

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
	...
	<key>NSLocationWhenInUseUsageDescription</key>
	<string>This app uses your location to display  advertisement according to geolocation</string>
	...
</dict>
</plist>

Background mode configuration

The R89SDK may track the advertisement session when the application is in the background. It internally uses the BgTaskScheduler and BGAppRefreshTask from the iOS framework. Before enabling the background mode add the “Background Modes“ capability to your project.

...

After adding the “Background Modes“ capability enable the “Background fetch“ and “Background processing“ modes.

...

Next, in the Info.plist, add the following task identifier com.refinery89.background under the BGTaskSchedulerPermittedIdentifiers key, as shown below

<dict>
    ...
	<key>BGTaskSchedulerPermittedIdentifiers</key>
	<array>
		<string>com.refinery89.background</string>
	</array>
	...
</dict>