Uploading Audiences

The Audience Marketplace allows you to upload an audience which is then matched against our pool of devices.

Basic Format

The format of the file is expected to be an Android advertising id or iOS IDFA followed by a line break. We support CR, LF or CRLF.

38b0852c-9673-4230-9b58-e0a336a348fe
4175f9fa-83db-4da7-95d6-62d1f2296c56
689626da-ebe3-4e01-a505-e36b09acae33
7f9e25cd-119b-44f3-8351-5c95ce3f8009
80b7407f-abee-42c2-86c2-00b49241c214
8d553fa4-1173-4263-b9b2-4ed33b6a5d60
964cf285-ee6a-4161-a291-3dbeda009a37
00026568-4479-4768-8aa1-42af920fefe5
000857c8-da88-4fd3-b853-1d919f982ff0
000c1019-f6cf-49d8-acc7-83ff7b1883f2

Duplicates will be removed during the matching process.

Event Format

You can optionally specify one or more events for each device. To specify an event put a comma after the device identifier and then the text of the event name. You may use any event names that make sense to you, and they will become available in the Audience Marketplace after the upload is processed.

Note there are three "special" event names that are treated specifically in the Audience Marketplace:

  • impression
  • click
  • conversion

If generating files from a platform which tracks these advertising-related events, please try to use these event names if possible.

38b0852c-9673-4230-9b58-e0a336a348fe,impression
4175f9fa-83db-4da7-95d6-62d1f2296c56,impression
689626da-ebe3-4e01-a505-e36b09acae33,impression
7f9e25cd-119b-44f3-8351-5c95ce3f8009,impression
80b7407f-abee-42c2-86c2-00b49241c214,impression
8d553fa4-1173-4263-b9b2-4ed33b6a5d60,impression
964cf285-ee6a-4161-a291-3dbeda009a37,impression
00026568-4479-4768-8aa1-42af920fefe5,impression
000857c8-da88-4fd3-b853-1d919f982ff0,impression
689626da-ebe3-4e01-a505-e36b09acae33,click
000c1019-f6cf-49d8-acc7-83ff7b1883f2,impression
964cf285-ee6a-4161-a291-3dbeda009a37,click
689626da-ebe3-4e01-a505-e36b09acae33,conversion

Every line does not have to specify an event. If a single device has more than one event associated with it, create a row for each event repeating the event name.