Get the conversion tracking code of an action

Returns what the console's Conversion Tracking Code window shows for the action.

Reference

GET https://YOUR-NETWORK-DOMAIN/rest-api/action/id/{id}/tracking-code.do

Returns what the console's Conversion Tracking Code window shows for the action. 'postback' (needs ACTION_TRACKING_S2S) — the server-to-server URLs: actionTrackUrl, fired with the click id the landing page received in the easclid parameter (landingUrlExample shows the $$CLICK_ID$$ macro to put in the click URL), and the legacy per-action variant (subIdMacro, subIdLandingUrlExample, subIdActionTrackUrl). 'pixel' (needs ACTION_TRACKING_CODE and a campaignId, as the pixel is campaign-specific) — jsPixelCode, the image pixel URL pixelTrackingUrl, and jsPixelCodeWithPiggybacks when the campaign has piggyback pixels on and the role holds PIGGYBACK_PIXEL_TRACKING. The codes are built on 'host' when given (one of the selectable ad-serving domains), else on the campaign's conversion-pixel domain, else on the action's own; the domain used is echoed in 'host'. Requires VIEW access to the action, and to the campaign's advertiser when campaignId is given.

Path Params

id integer required

The numeric database ID of the action

301

Query Params

campaignId integer

Campaign the codes are for; required for the pixel

2001

host string

Ad-serving domain to build the codes on; one of the selectable domains

ads.example.com

Responses

200

The tracking codes the caller may see, under postback and/or pixel

400

Unknown ad-serving domain, or only the pixel is permitted and no campaignId was given

401

Authentication error

403

No access to the action or campaign, or neither ACTION_TRACKING_S2S nor ACTION_TRACKING_CODE

404

Action or campaign not found

Language

cURL Request

curl --request GET \
  --url 'https://YOUR-NETWORK-DOMAIN/rest-api/action/id/301/tracking-code.do?campaignId=2001&host=ads.example.com' \
  --header 'X-Api-Key: YOUR_API_KEY'

Python Request

import requests

response = requests.request("GET", "https://YOUR-NETWORK-DOMAIN/rest-api/action/id/301/tracking-code.do?campaignId=2001&host=ads.example.com", headers={"X-Api-Key": "YOUR_API_KEY"})
print(response.json())

Node Request

const response = await fetch('https://YOUR-NETWORK-DOMAIN/rest-api/action/id/301/tracking-code.do?campaignId=2001&host=ads.example.com', {
  method: 'GET',
  headers: { 'X-Api-Key': 'YOUR_API_KEY' },
});

console.log(await response.json());

Java Request

HttpClient client = HttpClient.newHttpClient();

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://YOUR-NETWORK-DOMAIN/rest-api/action/id/301/tracking-code.do?campaignId=2001&host=ads.example.com"))
    .header("X-Api-Key", "YOUR_API_KEY")
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

C# Request

using var client = new HttpClient();

var request = new HttpRequestMessage(new HttpMethod("GET"), "https://YOUR-NETWORK-DOMAIN/rest-api/action/id/301/tracking-code.do?campaignId=2001&host=ads.example.com");
request.Headers.Add("X-Api-Key", "YOUR_API_KEY");

var response = await client.SendAsync(request);
Console.WriteLine(await response.Content.ReadAsStringAsync());

Go Request

package main

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

func main() {
	req, _ := http.NewRequest("GET", "https://YOUR-NETWORK-DOMAIN/rest-api/action/id/301/tracking-code.do?campaignId=2001&host=ads.example.com", nil)
	req.Header.Set("X-Api-Key", "YOUR_API_KEY")

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

	out, _ := io.ReadAll(res.Body)
	fmt.Println(string(out))
}

PHP Request

<?php
$ch = curl_init("https://YOUR-NETWORK-DOMAIN/rest-api/action/id/301/tracking-code.do?campaignId=2001&host=ads.example.com");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["X-Api-Key: YOUR_API_KEY"]);

echo curl_exec($ch);
curl_close($ch);

Ruby Request

require 'net/http'
require 'json'

uri = URI("https://YOUR-NETWORK-DOMAIN/rest-api/action/id/301/tracking-code.do?campaignId=2001&host=ads.example.com")
request = Net::HTTP::Get.new(uri)
request['X-Api-Key'] = 'YOUR_API_KEY'

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
puts response.body