Show Menu
TOPICS×

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 Determine File Names, Contents, and Delivery Paths .
yyyymmdd _ parent ID _ child ID
This is the file name. See Naming Conventions for Metadata Files .

File Processing Times and Updates

Metadata files are processed four times a day, at regular intervals.
To update your metadata records, just send a file that contains new information. You don't need to send full updates each time.