Create or Edit a Format

Use the Formats page in the Audience Manager Admin tool to create a new format or to edit an existing format.


When selecting a format for your outbounded data, it’s best, if possible, to re-use an existing format. Using an already-proven format ensures that your outbound data will be generated successfully. To see exactly how an existing format is formatted, click the Formats option in the menu bar and search for your format either by name or by ID number. Malformed formats or macros used in formats will provide incorrectly formatted output or will prevent information from being output entirely.

  1. To create a new format, click Formats > Add Format. To edit an existing format, click the desired format in the Name column.

  2. Fill in the fields:

    • Name: (Required) Provide a descriptive name for the format.
    • Type: (Required) Select the desired format:
      • File: Sends data via FTP files.
      • HTTP: Encloses data in a JSON wrapper.
  3. (Conditional) If you chose File, fill in the fields:


    For a list of available macros, see File Format Macros and HTTP Format Macros.

    • File Name: Specify the file name for the data-transfer file.
    • Header: Specify the text that appears in the first row of the data-transfer file.
    • Data Row: Specify the text that appears in each outbounded row of the file.
    • Maximum File Size (In MB): Specify the maximum file size for data-transfer files. Compressed files must be smaller than 100 MB. There is no limit on uncompressed file size.
    • Compression: Select the desired compression type: gz or zip for your data files. For delivery to AWS S3, you must use .gz or uncompressed files.
    • .info Receipt: Specifies that a transfer-control (.info) file is generated. The .info file provides metadata information about file transfers so that partners can verify that Audience Manager handled file transfers correctly. For more information, see Transfer-Control Files for Log File Transfers.
    • MD5 Checksum Receipt: Specifies that an MD5 checksum receipt is generated. The MD5 checksum receipt so that partners can verify that Audience Manager handled the full transfer correctly.
  4. (Conditional) If you chose HTTP, fill in the fields:

    • Method: Choose the API method you want to use for your transfer process:
      • POST: If you select POST, select the content type (XML or JSON), then specify the request body.
      • GET: If you select GET, specify the query parameters.
  5. Click Create if you are creating a new format, or click Save Updates if you are editing an existing format.

Delete a format

  1. Click Formats.
  2. Click in the Actions column of the desired format.
  3. Click OK to confirm the deletion.

On this page