Content Format for Metadata Files content-format-for-metadata-files

Format the contents of your Audience Optimization metadata file according to these specifications.

Syntax syntax

The following syntax defines the structure of well-formed contents in a metadata file. Note, italics indicates a variable placeholder.

Syntax: content ID | name | -1

The third column -1 is technically the Parent ID, which is a legacy field. The value should always be set as -1.

NOTE
Note that one metadata file per dimension is needed, so multiple metadata files are expected in the bucket. The dimensions are listed in the article Naming Conventions for Metadata File.

Separate File Entries With ^a (control-A or ASCII 001)

Use ^a (control-A or ASCII 001) to separate content in your metadata files. As these are non-printing characters, the syntax example above shows a pipe “|” for display purposes only.

If needed, you may download the example file - 20181105_0_1. Unzip it and edit in your editor of choice and adjust according to your actual metadata contents, as it already contains the required delimiter.

IMPORTANT
Do not add header rows to metadata files.

Examples examples

Let’s take a look at how you would structure content in a metadata file. Part of this structure depends on the dimension. The dimensions are listed in the article Naming Conventions for Metadata File.

Campaign

In this example, the file title is 20180921_0_1 and the three columns in the file are: Campaign ID, Name, and Parent ID.

//File Title
20180921_0_1

111 Campaign A -1
222 Campaign B -1
333 Campaign C -1

Creative

In this example, the file title is 20180827_0_2 and the three columns in the file are: Creative ID, Name, and Parent ID.

//File Title
20180921_0_2

111 Creative A -1
222 Creative B -1
333 Creative C -1

Site

In this example, the file title is 20180921_0_5 and the three columns in the file are: Site ID, Name, and Parent ID.

//File Title
20180921_0_5

111 Site A -1
222 Site B -1
333 Site C -1
recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695