Audience Export
Exporting audience identity clusters
Audiences can be exported to a configured destination. You can configure an audience export from the Audience > Exports tab in the DCN UI, or using the CLI. The exported data are either lists of identifiers belonging to the identity clusters making up the audience, or the JSON identity cluster records themselves.
To schedule an export of a given audience to a specified destination using the CLI, run optable-cli audience export <audience-id> <destination-id> <format>
The <format> argument allows you configure which type of data you are interested in exporting. The default "cluster_json" option exports JSON-encoded identity clusters, whereas the "id_csv" and "id_tsv" options export only IDs (without links and traits) in either CSV or TSV format, respectively.
Several optional flags allow for configuring the export:
  • The --filename=STRING flag allows you to specify the name of the file to create in the specified destination's bucket
  • The --[no]override-existing flag allows you to override an existing file of the same name. This defaults to True.
  • The --export-metadata flag allows you to export an additional Metadata file.
  • When exporting CSV or TSV ID values (i.e., "id_csv" or "id_tsv"), the first column contains the type-prefixed ID value and the second column contains the type of ID. The first row is a header indicating the names of the columns. You can control this behavior with the --[no-]id-include-header, --[no-]id-type-column and --[no-]id-type-prefix options.
  • When exporting JSON identity clusters (i.e., --format="cluster_json"), the options --[no-]cluster-include-sources and --[no-]cluster-include-traits allow you to control whether source information and traits data are included in the exported cluster data. The default is to include them.
  • You can further limit the types of IDs included in the export with the --identifiers-filter=... option.
A list of previously scheduled exports and their status can be obtained from the UI or the CLI with the optable-cli export list command.
Copy link