Custom Device ID Passback Integration

Vistar's custom device ID integration provides clients with a complete view of the devices that were exposed to their ad campaigns across all screens, as well as the metadata to measure the effectiveness of their campaigns.

This offering uses an Amazon S3 integration, and IDs can be provided alone or with additional metadata. This is typically used on a campaign-by-campaign basis for the purposes of measurement facilitated by the client internally or via a 3rd party.

File Transfer Details

  • Files are dropped daily onto a Vistar-hosted S3 bucket. 
  • Files are dropped as gzipped CSVs (.csv.gz). 
  • Device IDs are split evenly into 6 files to limit individual file size. 
  • All device IDs across all active Insertion Orders in a campaign are included in daily file drops.
  • Files sent daily are dropped into folders named with the date exposures within them correspond to.
    • Folder naming convention: YYYY-MM-DD

Fields Available: 

Name Description
UID Unique device IDs of the audience that matches to GPS data to build movement patterns and targeting shapes
Ad play time The amount of time played by the ad
Venue ID

Unique identifier associated with the venue. This ID is passed on each ad request that is sent.

 ((available for most UIDs))
Venue Type

The category that best defines your venue.  

If this is not provided, this field defaults to the venue type set on your network.

Example values: Airports, Doctor's Offices|Allergy, Office Buildings

DMA The designated market area (DMA) that was targeted. 
Advertiser ID The advertiser IDs, which are unique to each advertiser.
Network ID

The ID of the network you are making a request for.

Deal ID Unique identifier associated with each deal. Third-party DSPs use this ID to target the deal
Campaign ID Unique identifier associated with the campaign

 Note: The fields are subject to change and DSP-dependent. 


Set-Up Process

To get started using custom device IDs, please contact support@vistarmedia.comOnce the client has signed a data MSA and both parties have agreed to terms:

  1. Vistar creates an S3 bucket providing path and access keys. 
  2. Client provides desired fields
  3. Vistar provides sample file(s) for approval.
  4. Client approves the integration. 
  5. Vistar sets up integration.
  6. Vistar confirms delivery (daily). 
Was this article helpful?
0 out of 0 found this helpful