Global device ID validation

Last update: March 21, 2022

CREATED FOR:

  • Experienced
  • Developer

Device Advertising Identifiers (i.e. iDFA, GAID, Roku ID) have formatting standards that must be met in order to be usable in the digital advertising ecosystem. Today, customers and partners can upload IDs to our Global data sources in any format without being notified of whether the ID is properly formatted. This feature will introduce validation of device IDs sent to the Global data sources for proper formatting and will provide error messaging when IDs are incorrectly formatted. We will support validation for iDFA, Google Advertising and Roku IDs at launch.

Overview of format standards

The following are the global Device Advertising ID pools that are currently recognized and supported by AAM. These are implemented as shared Data Sources that can be used by any customer or data partner that works with data tied to users of these platforms.

PlatformAAM Data Source IDID FormatAAM PIDNotes
Google Android (GAID)2091432 hex numbers, generally presented as 8-4-4-4-12 example, 97987bca-ae59-4c7d-94ba-ee4f19ab8c211352This ID must be collected in a raw/unhashed/unaltered form Reference - https://play.google.com/about/monetization-ads/ads/ad-id/
Apple iOS (IDFA)2091532 hex numbers, generally presented as 8-4-4-4-12 example, 6D92078A-8246-4BA4-AE5B-76104861E7DC3560This ID must be collected in a raw/unhashed/unaltered form Reference - https://support.apple.com/en-us/HT205223
Roku (RIDA)12196332 hex numbers, generally presented as 8-4-4-4-12 example, fcb2a29c-315a-5e6b-bcfd-d889ba19aada11536This ID must be collected in a raw/unhashed/unaltered form Reference - https://sdkdocs.roku.com/display/sdkdoc/Roku+Advertising+Framework
Microsoft Advertising ID (MAID)389146Alpha numeric string14593This ID must be collected in a raw/unhashed/unaltered form Reference - https://docs.microsoft.com/en-us/uwp/api/windows.system.userprofile.advertisingmanager.advertisingid
https://msdn.microsoft.com/en-us/library/windows/apps/windows.system.userprofile.advertisingmanager.advertisingid.aspx
Samsung DUID404660Alpha numeric string example, 7XCBNROQJQPYW15950This ID must be collected in a raw/unhashed/unaltered form Reference - https://developer.samsung.com/tv/develop/api-references/samsung-product-api-references/productinfo-api

Setting an Advertising Identifier in the App

Setting the advertiser ID in the app is really a two step process, first retrieving the advertiser ID, and then sending it to the Experience Cloud. Links are found below for performing these steps.

  1. Retrieve the ID

    1. Apple information about the advertising ID can be found HERE.
    2. Some information about setting the advertiser ID for Android developers can be found HERE.

  2. Send it into the Experience Cloud using the setAdvertisingIdentifier method in the SDK

    1. Information for using setAdvertisingIdentifier is in the documentation for both iOS and Android.

// iOS (Swift) example for using setAdvertisingIdentifier:
ACPCore.setAdvertisingIdentifier([AdvertisingId]) // ...where [AdvertisingId] is replaced by the actual advertising ID

DCS Error Messaging for Incorrect IDs

When an incorrect Global Device ID (IDFA, GAID, etc) is submitted in realtime to Audience Manager, an error code will be returned on the hit. Following is an example of an error returned because the ID is sent in as an Apple IDFA, which should only contain upper case letters, and yet there is a lower case ‘x’ in the ID.

error image

Please see the documentation for the list of error codes.

Onboarding Global Device IDs

In addition to realtime submission of Global Device IDs, you are also able to “onboard” (upload) data against the IDs as well. This process is the same as when you are onboarding data against your customer IDs (typically via key/value pairs), but you would simply use the proper Data Source IDs, so that the data is assigned to the global device ID. Documentation about the onboarding process can be found in the documentation. Just remember to use the global data source ID, depending on the platform that you are using.

If incorrect Global Device IDs are submitted through the onboarding process, the errors will show in the Onboarding Status Report.

Following is a sample of an error that would come through that report:

error image

Previous pageSet permissions with role-based access control
Next pageIAB TCF 2.2 support

Audience Manager