Destinations

Exporting data to your DSPs and storage buckets for targeting and manipulation.

Destinations are used when exporting audience data from a DCN. The type of data exported from an audience to a destination consists of type-prefixed identifiers and identity clusters. There are different types of destinations, such as Google Cloud Storage (GCS), Amazon Simple Storage Service (S3) and Azure Blob Storage.

Destinations Types

You can create a new destination from your DCN UI or using the CLI by running optable-cli destination create with the type of destination, the bucket location, and access credentials. You can create as many destinations as you like.

Demand-side Platforms (DSPs)

DSPs are platforms to which you can export your audience for real time programmatic advertising. Examples of DSPs are The Trade Desk and Google's Display & Video 360. You can push audiences to these destinations via the "Export" button in the audience you wish to export.

Storage Buckets

Storage buckets are destinations to which you can export your audiences as either CSVs, TSVs, JSON or Parquet objects. Examples of storage buckets are Google Cloud Storage (GCS), Amazon Simple Storage Service (S3) and Azure Blob Storage. Exporting to these destinations enables you to use the output files in your preferred data visualization, modelling and reporting tools.

Destination Features

Destination Export History

You can view a history of all exports to a specific destination as well as errors related to those exports by navigating to your destination in Audiences -> Destinations , selecting your Export Configuration and clicking on the "History" tab.

Destination Archival

From the UI

Destinations can be archived via the UI by navigating to the specific destination you wish to archive in Audiences -> Destinations and clicking "Archive".

From the CLI

Destinations can be archived from the CLI by using optable-cli with the following command:

optable-cli destination archive <id>

Note that data (exported results) will not be deleted from the destination when archiving said destination.

CLI Options

Listing Destinations

Destinations can be deleted from the DCN UI or by using optable-cli with the following invocation optable-cli destination archive <id>

You can list all destinations with the CLI by running optable-cli destination list command. The command returns a list of destinations encoded in JSON. You can use the excellent jq utility to parse and manipulate JSON from the command line. For example, to list just the names and type of all destinations:

$ optable-cli destination list | jq '[.name,.kind]'
[
  "example-s3-bucket-name",
  "DESTINATION_KIND_S3"
]