Offsite Audiences API

Ad Server New

Why It's Important

Offsite advertising extends your reach beyond your platform by targeting your customers across external channels like Google and Meta. This creates a unified advertising ecosystem that maximizes customer touchpoints throughout their journey.

The new Offsite Ads API enables you to create and manage custom audiences for advertising campaigns outside of your platform. Upload user lists to extend your targeting reach across external advertising channels like Google Ads and Meta.

What’s New

• Audience job creation: Submit custom user lists for offsite targeting campaigns
• Secure file uploads: Get presigned URLs for safe CSV file transfers
• Multi-platform support: Currently supports Google Ads and Meta advertising platforms
• Job tracking: Monitor audience creation status with unique job identifiers

Key Benefits

Extended Reach

Target your existing customers and prospects across external advertising platforms to maximize campaign reach.

Secure Uploads

Upload audience data safely using presigned URLs with automatic expiration for enhanced security.

Multi-Channel Targeting

Create audiences for multiple DSPs including Google Ads and Meta from a single API endpoint.

How It Works

The API creates offsite audience jobs in three steps:

1. Submit audience details including name, description, and target DSP
2. Upload CSV file using the provided presigned URL within one hour
3. Track job progress using the returned job identifier

Create Audience Job

curl --request POST \
  --url https://api.topsort.com/public/v1/offsite-ads/audiences \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "My user list audience",
    "description": "Custom audience for Q4 campaign",
    "vendor_id": "vendor_123",
    "dsp": "google_ads"
  }'

The API returns a job ID and presigned URL for file upload. Use the presigned URL with a PUT request and Content-Type: text/csv header to upload your audience data.

---

This release expands targeting capabilities beyond your platform. Learn more about the Offsite Ads API in our documentation, or explore our offsite and in-store advertising concepts to understand how these capabilities fit into your broader advertising strategy.