Skip to content

Latest commit

 

History

History
97 lines (71 loc) · 5.49 KB

ftrackIdSystem.md

File metadata and controls

97 lines (71 loc) · 5.49 KB

Flashtalking's FTrack Identity Framework User ID Module

The FTrack Identity Framework User ID Module allows publishers to take advantage of Flashtalking's FTrack ID during the bidding process.

FTrack

Flashtalking’s cookieless tracking technology uses probabilistic device recognition to derive a privacy-friendly persistent ID for each device.

ANTI-FINGERPRINTING
FTrack operates in strict compliance with Google’s definition of anti-fingerprinting. FTrack does not access PII or sensitive information and provides consumers with notification and choice on every impression. We do not participate in the types of activities that most concern privacy advocates (profiling consumers, building audience segments, and/or monetizing consumer data).

GDPR COMPLIANT
Flashtalking is integrated with the IAB EU’s Transparency & Consent Framework (TCF) and operates on a Consent legal basis where required. As a Data Processor under GDPR, Flashtalking does not combine data across customers nor sell data to third parties.

Support or Maintenance:

Questions? Comments? Bugs? Praise? Please contact FlashTalking's Prebid Support at [email protected]

FTrack User ID Configuration

The following configuration parameters are available:

pbjs.setConfig({
  userSync: {
    userIds: [{
      name: 'FTrack',
      params: {
        url: 'https://d9.flashtalking.com/d9core', // required, if not populated ftrack will not run
        ids: {
          'device id': true,
          'single device id': true,
          'household id': true
        }
      },
      storage: {
        type: 'html5',           // "html5" is the required storage type
        name: 'FTrackId',        // "FTrackId" is the required storage name
        expires: 90,             // storage lasts for 90 days
        refreshInSeconds: 8*3600 // refresh ID every 8 hours to ensure it's fresh
      }
    }],
    auctionDelay: 50             // 50ms maximum auction delay, applies to all userId modules
  }
});
Param under userSync.userIds[] Scope Type Description Example
name Required String The name of this module: "FTrack" "FTrack"
params Required Object The IDs available, if not populated then the defaults "Device ID" and "Single Device ID" will be returned
params.url Required String The URL for the ftrack library reference. If not populate, ftrack will not run. 'https://d9.flashtalking.com/d9core'
params.ids Optional Object The ftrack IDs available, if not populated then the defaults "Device ID" and "Single Device ID" will be returned
params.ids['device id'] Optional Boolean Should ftrack return "device id". Set to true to return it. If set to undefined or false, ftrack will not return "device id". Default is false true
params.ids['single device id'] Optional Boolean Should ftrack return "single device id". Set to true to return it. If set to undefined or false, ftrack will not return "single device id". Default is false true
params.ids['household id'] Optional; Requires pairing with either "device id" or "single device id" Boolean 1. Should ftrack return "household id". Set to true to attempt to return it. If set to undefined or false, ftrack will not return "household id". Default is false. 2. This will only return "household id" if value of this field is true AND "household id" is defined on the device. 3. "household id" requires either "device id" or "single device id" to be also set to true, otherwise ftrack will not return "household id". true
storage Required Object Storage settings for how the User ID module will cache the FTrack ID locally
storage.type Required String This is where the results of the user ID will be stored. FTrack requires "html5". "html5"
storage.name Required String The name of the local storage where the user ID will be stored. FTrack requires "FTrackId". "FTrackId"
storage.expires Optional Integer How long (in days) the user ID information will be stored. FTrack recommends 90. 90
storage.refreshInSeconds Optional Integer How many seconds until the FTrack ID will be refreshed. FTrack strongly recommends 8 hours between refreshes 8*3600

Privacy Policies.

Complete information available on the Flashtalking privacy policy page.

OPTING OUT OF INTEREST-BASED ADVERTISING & COLLECTION OF PERSONAL INFORMATION

Please visit our Opt Out Page.

REQUEST REMOVAL OF YOUR PERSONAL DATA (WHERE APPLICABLE)

You may request by emailing mailto:[email protected].

GDPR

In its current state, Flashtalking’s FTrack Identity Framework User ID Module does not create an ID if a user's consentData is "truthy" (true, 1). In other words, if GDPR applies in any way to a user, FTrack does not create an ID.

If you are using pbjs.getUserIdsAsEids():

Please note that the uids value is a stringified object of the IDs so publishers will need to JSON.parse() the value in order to use it:

{
    "HHID": ["<USERS HH ID>"],
    "DeviceID": ["<USERS DEVICE ID>"],
    "SingleDeviceID": ["USERS SINGLE DEVICE ID"]
}