Create Campaign

Create a new offsite campaign.

POST /public/v1/offsite-ads/campaigns

Create Campaign

cURL

curl --request POST \
  --url https://api.topsort.com/public/v1/offsite-ads/campaigns \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "dsps": [],
  "name": "<string>",
  "startDate": "2023-11-07T05:31:56Z",
  "endDate": "2023-11-07T05:31:56Z",
  "budget": 123,
  "targetRoas": 10.5,
  "locationIds": [
    "<string>"
  ],
  "productIds": [
    "prod1",
    "prod2",
    "prod3",
    "prod4",
    "prod5"
  ],
  "audienceIds": [
    "123456"
  ]
}
'

import requests

url = "https://api.topsort.com/public/v1/offsite-ads/campaigns"

payload = {
    "dsps": [],
    "name": "<string>",
    "startDate": "2023-11-07T05:31:56Z",
    "endDate": "2023-11-07T05:31:56Z",
    "budget": 123,
    "targetRoas": 10.5,
    "locationIds": ["<string>"],
    "productIds": ["prod1", "prod2", "prod3", "prod4", "prod5"],
    "audienceIds": ["123456"]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    dsps: [],
    name: '<string>',
    startDate: '2023-11-07T05:31:56Z',
    endDate: '2023-11-07T05:31:56Z',
    budget: 123,
    targetRoas: 10.5,
    locationIds: ['<string>'],
    productIds: ['prod1', 'prod2', 'prod3', 'prod4', 'prod5'],
    audienceIds: ['123456']
  })
};

fetch('https://api.topsort.com/public/v1/offsite-ads/campaigns', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.topsort.com/public/v1/offsite-ads/campaigns",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'dsps' => [
        
    ],
    'name' => '<string>',
    'startDate' => '2023-11-07T05:31:56Z',
    'endDate' => '2023-11-07T05:31:56Z',
    'budget' => 123,
    'targetRoas' => 10.5,
    'locationIds' => [
        '<string>'
    ],
    'productIds' => [
        'prod1',
        'prod2',
        'prod3',
        'prod4',
        'prod5'
    ],
    'audienceIds' => [
        '123456'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.topsort.com/public/v1/offsite-ads/campaigns"

	payload := strings.NewReader("{\n  \"dsps\": [],\n  \"name\": \"<string>\",\n  \"startDate\": \"2023-11-07T05:31:56Z\",\n  \"endDate\": \"2023-11-07T05:31:56Z\",\n  \"budget\": 123,\n  \"targetRoas\": 10.5,\n  \"locationIds\": [\n    \"<string>\"\n  ],\n  \"productIds\": [\n    \"prod1\",\n    \"prod2\",\n    \"prod3\",\n    \"prod4\",\n    \"prod5\"\n  ],\n  \"audienceIds\": [\n    \"123456\"\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.topsort.com/public/v1/offsite-ads/campaigns")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"dsps\": [],\n  \"name\": \"<string>\",\n  \"startDate\": \"2023-11-07T05:31:56Z\",\n  \"endDate\": \"2023-11-07T05:31:56Z\",\n  \"budget\": 123,\n  \"targetRoas\": 10.5,\n  \"locationIds\": [\n    \"<string>\"\n  ],\n  \"productIds\": [\n    \"prod1\",\n    \"prod2\",\n    \"prod3\",\n    \"prod4\",\n    \"prod5\"\n  ],\n  \"audienceIds\": [\n    \"123456\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.topsort.com/public/v1/offsite-ads/campaigns")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"dsps\": [],\n  \"name\": \"<string>\",\n  \"startDate\": \"2023-11-07T05:31:56Z\",\n  \"endDate\": \"2023-11-07T05:31:56Z\",\n  \"budget\": 123,\n  \"targetRoas\": 10.5,\n  \"locationIds\": [\n    \"<string>\"\n  ],\n  \"productIds\": [\n    \"prod1\",\n    \"prod2\",\n    \"prod3\",\n    \"prod4\",\n    \"prod5\"\n  ],\n  \"audienceIds\": [\n    \"123456\"\n  ]\n}"

response = http.request(request)
puts response.read_body

200

{
  "jobId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Autorisierungen

Authorization · string · header · erforderlich

A valid API key generated in Topsort's UI. Use the TSE API key if calling auctions or events API, otherwise use the TSC API key.

Abfrageparameter

vendor_id · string · erforderlich

The ID of the vendor to create the campaign for.

Body

application/json

dsps · enum<string>[] · erforderlich

The DSPs to create the campaign for.

Minimum array length: 1

Verfügbare Optionen: google_ads, meta

Beispiel:

["google_ads", "meta"]

name · string · erforderlich

The name of the campaign

Maximum string length: 35

Pattern: ^[^;"'<>\#\|,\ \ \\]*[^;"'<>\#\|,\ \ \\\s][^;"'<>\#\|,\ \ \\]*$

startDate · string<date-time> · erforderlich

The start date of the campaign

endDate · string<date-time> · erforderlich

The end date of the campaign

budget · integer<int64> · erforderlich

The daily budget in minor units of currency according to ISO 4217.

Beispiel:

1000

targetRoas · number · erforderlich

Target ROAS of the campaign. Acceptable values are between 1.0 and 20.0. Topsort maps this value to the closest equivalent bidding configuration supported by each DSP.

Erforderlicher Bereich: 1 <= x <= 20

Beispiel:

3

locationIds · string[] · erforderlich

The DSP-native location IDs to target. Retrieve available IDs via GET /offsite-ads/marketplace/geolocations and use the values from dspLocationIds for the target DSP. Reference: Google Ads geo targets (https://developers.google.com/google-ads/api/data/geotargets), Meta region IDs (https://developers.facebook.com/docs/marketing-api/audiences/reference/targeting-search#regions).

Minimum array length: 1

Beispiel:

["123456"]

productIds · string[] | null

The product ids to target. These are the product ids from the catalog. If not provided, all products will be targeted.

Minimum array length: 5

Beispiel:

["prod1", "prod2", "prod3", "prod4", "prod5"]

audienceIds · string[] | null

The audience ids to target. These are the audience ids from each DSP platform. Currently, only one audience is supported. If not provided, no audience will be targeted.

Maximum array length: 1

Beispiel:

["123456"]

Antwort

200

application/json

Successful Response

jobId · string<uuid> · erforderlich

The unique identifier for the queued job.