Mobile IDFA
The Mobile IDFA plugin is specifically designed to implement native mobile AAID and IDFA compliance features in both Android and iOS, for games built using Construct 3.
The Identifier for Advertisers or IDFA is an anonymized unique identifier assigned by Apple to a user's device that allows an installed mobile application to track user behavior across other companies' applications.
The Advertising ID or AAID is a unique, user-resettable ID for advertising, provided by Google Play services. It gives users better controls and provides developers with simple, standard system to continue to monetize their apps. It enables users to reset their identifier or opt-out of personalized ads with Google Play apps.
Introduction
The Construct Master Collection supports the full and easy integration of native mobile Android SDKs and iOS SDKs for both Construct 3 and Construct 2.
Please click here to learn more about Mobile.
Features
The Mobile IDFA plugin is specifically designed to implement native mobile AAID and IDFA compliance features in both Android and iOS, for games built using Construct 3.
Here are some of the native features of the mobile plugin:
Android SDK
iOS SDK
Advertising ID (AAID)
Identifier for Advertisers (IDFA)
Retrieve device's advertising information.
Update device's advertising information.
Request tracking permission for iOS.
Request tracking consent dialog for iOS.
Compare tracking permission on iOS.
Check if tracking is limited.
Get the Android advertising identifer.
Get the iOS advertising identifier.
Get the advertising identifier automatically based on the platform.
Customize the tracking consent dialog on Xcode, for iOS.
Debugging tools
Well maintained and fully tested on all platforms and platform versions, and ready for production release.
For more information about native mobile or Android and iOS features, please click here to learn the introductory lessons to Mobile.
Platform Integration
Here are some of the platforms that are natively supported:
Android
iOS
Native Android
Native iOS
Build Support
Here are some of the supported build options:
Construct 3 Build Service
Android Studio
Xcode
Phonegap
Editor Features
Here are some of the features in the Construct editor:
Construct 3
How to use?
It is easy to use the Mobile IDFA plugin, you will only need to follow the steps below.
1. The first step is to add the Mobile IDFA object into the project.
iOS Consent Dialog
An additional step to configure the tracking consent dialog on iOS, is to set the NSUserTrackingUsageDescription key in the Information Property List (Info.plist).
In order to launch the tracking consent dialog, you need to provide a custom text that tells the user why your application is requesting permission to use data for tracking the user or the device.
The user has the option to grant or deny the authorization request. In order to add the usage description, please follow the steps below.
Select your project’s Info.plist file in Xcode Project navigator.
Modify the file using the Xcode Property List Editor: Privacy - Tracking Usage Description.
Use sentence-style capitalization and appropriate ending punctuation. Keep the text short and specific. You don’t need to include your app name because the system already identifies your app.
If the title is a sentence fragment, don’t add ending punctuation.
See Apple’s Human Interface Guidelines for example usage descriptions.
If you find this step too technical or complicated, you can also use our alternative plugin, the Mobile Consent plugin which has the same features as the Mobile IDFA plugin.
The Mobile Consent plugin simplifies this process by declaring the usage description automatically, however the usage description is predefined and not customizable.
Documentation
There is currently nothing to show, we will add more in the future.
Actions, Conditions & Expressions
Actions
The following action groups:
General
Features
General
Initialize - Run to initialize the mobile idfa sdk.
Request Permission (iOS) - Run a one-time request to authorize or deny access to app-related data that can be used for tracking the user or the device.
Features
Update Info - Run to update the current user's advertising information.
Conditions
The following condition groups:
General
Features
Info
General
On Initialized - Trigger fires when initialization is completed.
On Initialize Failed - Trigger fires when initialization has failed.
On Requested Permission (iOS) - Trigger fires when a permission request for advertisement tracking has succeeded.
On Request Permission Failed (iOS) - Trigger fires when a permission request for advertisement tracking has failed.
Is Initialized - Check if the mobile advertising sdk has been initialized.
Features
On Update - Trigger fires when the mobile advertising information has been updated.
On Update Failed - Trigger fires when the mobile advertising information has failed to update.
Info
Compare Tracking Permission (iOS) - Compare the current advertising tracking permission, only for iOS.
Permission - Choose the advertisement tracking permission to compare.
Is Tracking Limited - Check if advertisement tracking is not allowed by the user.
Expressions
The following expression groups:
Info
Current
Debug
Info
IDFA - Return the iOS advertising identifier.
AAID - Return the android advertising identifier.
Current
AdvertisingId - Return the idfa or aaid, depending on the platform.
Debug
Error - Return the error message in JSON string, after a condition event trigger failure.
Object Properties
Plugin Properties
The following property groups:
Config
Config - Configure the plugin functionality.
Debug - If checked, the plugin will log process details for debugging.
Showcase
There is currently nothing to show, we will add more in the future.
Game Projects
Instructions Kit
Specifications
-
Instructions - The game project contains instructions and steps on how to use the addon and its features.
-
Action, Conditions and Expressions - It covers the implementation of each action, condition and expression.
-
Tips and Tricks - It provides some tips and tricks on the recommended ways of using the addon.