Delivery Methods for Metadata Files

Send or update metadata files by sending them to a special Amazon S3 directory for your Audience Manager account. Refer to this section for information about delivery/directory paths, file processing times, and updates.

Delivery Path Syntax and Examples

Data is stored in separate namespace for each customer in an Amazon S3 directory. The file path follows the syntax shown below. Note, italics indicates a variable placeholder. Brackets [ ] indicate optional parameters. The other elements are constants and do not change.

Syntax: .../log_ingestion/pid=AAM ID/dpid=d_src/[meta|status]/yyyymmdd_parent ID_child ID

The following table defines each of these elements in a file delivery path.

File Parameter Description

.../log_ingestion/

This is the start of the directory storage path. You'll receive the full path when everything is set up.

pid=AAM ID

This key-value pair that contains your Audience Manager customer ID.

dpid=d_src

This key-value pair contains the data source ID passed in on an event call. The data source ID is the value that ties all the contents in your file to the actual data it belongs to.

For example, say you have a creative with the ID 123 and the name "Advertiser Creative A." As an event call only passes in the ID you need to include "Advertiser Creative A" in the metadata file. The campaign and creative belong to a data source. The data source ID is what ties these together and lets us accurately associate file contents to an ID sent in on an event call. See How Event Call IDs Shape File Names, Contents, and Delivery Paths.

  • meta
  • status
  • meta is a file upload/storage directory.
  • status is a path to a directory that holds success or failure information about your processed files. After your file is processed, you'll see a .info file with yyyymmdd timestamp title. Status files contain data in a JSON object. See Status Updates for Metadata Files.

yyyymmdd_parent ID_child ID

This is the file name. See Naming Conventions for Metadata Files.

Sample Upload and Status Paths

To upload a metadata file or to check its status, the file paths will look similar to these:

  • Upload path: /log_ingestion/pid=1234/dpid=567/meta/20150827_1_2
  • Processing status path: /log_ingestion/pid=1234/dpid=567/status/20150827.info.

File Processing Times and Updates

Metadata files are processed twice daily, at 04:30 UTC and 17:30 UTC. If you miss these deadlines, your file will be processed the next day.

To update your metadata records, just send a file that contains new information. You don't need to send full updates each time.