Advertising Identifier

danger

We have made the decision to deprecate the advertising identifier functionality from the Adverts extension.

This is due to the increased authorisation required around this identifier with iOS 14.5 and increased protections around its usage for children and family rated applications. In order for applications to continue to provide advertising while

If you require the identifier in your application, please look to the IDFA (IDentifier For Advertising) extension, available for free.

This functionality will now fail on iOS, returning "00000000-0000-0000-0000-000000000000" as the identifier and will not correctly determine the ad limiting status.

It will continue to operate on Android as long as you include the appropriate "ads identifier" dependency.

The advertising identifier is a user-specific, unique, resettable ID for advertising, provided by Google Play services and the iOS SDK. It gives users better controls and provides developers with a simple, standard system to continue to monetize your apps. It is an anonymous identifier for advertising purposes and enables users to reset their identifier or opt out of interest-based ads within Google Play and iOS apps.

• iOS: this is the value of the ASIdentifierManager advertisingIdentifier property - documentation
• Android: this is the value of the Google Play Services advertising ID - documentation.

The user has the ability to limit ad tracking on both iOS and Android through the device settings. This value can also be retrieved so that you can respect this value in any tracking your application performs.

Retrieving this information is through the use of the getAdvertisingId() function which asynchronously retrieves the current AdvertisingIdInfo object. This object contains the current advertisting identifier and whether the user has limited ad tracking.

For example:

Adverts.service.addEventListener( AdvertisingIdEvent.ADVERTISING_ID, advertisingIdHandler );
Adverts.service.getAdvertisingId();

function advertisingIdHandler( event:AdvertisingIdEvent ):void
{
    // event.info contains the advertising info object

    var info:AdvertisingIdInfo = event.info;

    trace( info.advertisingId );
    trace( info.isLimitAdTrackingEnabled );
}

Callback

If you wish you can also add a callback to the getAdvertisingId function. This callback takes one parameter being the AdvertisingIdInfo object.

For example:

Adverts.service.getAdvertisingId(
    function( info:AdvertisingIdInfo ):void
    {
        trace( info.advertisingId );
        trace( info.isLimitAdTrackingEnabled );
    }
);

Errors

Please note that you need to include the com.distriqt.playservices.AdsIdentifier dependency in order to support the advertising identifier on Android.

If you don't include this extension you may receive an ErrorEvent.ERROR during the getAdvertisingId() call with text indicating the missing extension.

Adverts.service.addEventListener( ErrorEvent.ERROR, errorHandler );


...

Adverts.service.getAdvertisingId();

...


function errorHandler( event:ErrorEvent ):void
{
    // An error occurred
}