RTI audience file format reference
If you are a supported RTI provider that facilitates audience transactions, you can send your audience files to Index Exchange (IX) using SFTP to be processed within 15-20 minutes by the Audience Manager system.
Note: This audience format is only available for select RTI providers. If you have any questions, contact your IX Representative.
File formats
IX supports a dual file format for an audience file. With a dual file format, IX expects to receive a single audience for each pair of files (multi-audience upload is not yet supported). Each audience is represented by two files: the data file and meta file. Both the data and meta files are required for every audience upload, including any changes to existing audiences. For more information on these file formats, refer to the table below.
file type | file name | file format | contents |
---|---|---|---|
Data |
|
gzip | List of RTI identifiers separated by newline characters. |
Meta v1.1 |
|
json |
Meta file version, audience scope, audience name, audience ID, source audience ID, advertiser account ID, file name, export timestamp. With the addition of audience scope in meta file v1.1, advertisers can run their audience across all eligible IX publishers with a single file upload. A meta file with |
Meta v1.0 | <audienceID>.json
|
json | Audience name, audience ID, source audience ID, advertiser account ID, IX publisher ID, file name, export timestamp. |
The data and meta files are linked by the audience ID and the file name, as shown in the following example:
Data file name: 1a956a17-7f7d-48fd-92ad-ade76e154a6b.gz
Meta file name: 1a956a17-7f7d-48fd-92ad-ade76e154a6b.json
List of meta file fields
field | supported meta file version | description |
---|---|---|
meta_version
|
1.1 |
Version of the meta file, where
|
audience_scope
|
1.1 |
The scope of audience matching.
|
audienceName
|
All | Name of the audience or segment. This name is what appears in the IX app. |
audienceID
|
All |
Provider-specific identifier for a given audience. Uploads with the same Uploads with unique |
advertiserAccount_id
|
All | Unique Identity identifier for the advertiser or buyer of the audience assigned by the RTI provider. |
publisher_id
|
All |
IX publisher identifier. A |
exportTimestamp
|
All | Time, in UTC (Coordinated Universal Time), of when the audience was exported. |
Meta file version 1.1 examples
The following meta file has a direct audience scope:
{
"meta_version": "1.1",
"audience_scope": "DIRECT",
"audienceName": "New Customers Signups",
"audienceID": "1a956a17-7f7d-48fd-92ad-ade76e154a6b",
"advertiserAccount_id": "Netflix",
"publisher_id": 183728,
"exportTimestamp": "2018-06-11 13:20:35"
}
The following meta file has a platform audience scope:
{
"meta_version": "1.1",
"audience_scope": "PLATFORM",
"audienceName": "New Customers Signups",
"audienceID": "1a956a17-7f7d-48fd-92ad-ade76e154a6b",
"advertiserAccount_id": "Netflix",
"exportTimestamp": "2018-06-11 13:20:35"
}
Meta file version 1.0 example
{
"audienceName": "New Customers Signups",
"audienceID": "1a956a17-7f7d-48fd-92ad-ade76e154a6b",
"advertiserAccount_id": "Netflix",
"publisher_id": 183728,
"exportTimestamp": "2018-06-11 13:20:35",
}