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.

PlayFab API v2.png

Introduction

Step 1.png

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:


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.

  1. Select your project’s Info.plist file in Xcode Project navigator.

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

press to zoom

press to zoom
1/1

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

press to zoom

press to zoom
1/1

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

press to zoom

press to zoom
1/1

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

press to zoom

press to zoom
1/1

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

Construct 3 Project
Construct 3 Project

press to zoom
Construct 2 Project
Construct 2 Project

press to zoom
Construct 3 Project
Construct 3 Project

press to zoom
1/2

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.

Supporters

Only