{"id":14692,"date":"2026-09-01T16:51:28","date_gmt":"2026-09-01T16:51:28","guid":{"rendered":"https:\/\/wiki.pontiac.media\/?docs=api\/pontiac-bidder-api-campaign-tutorial\/creating-a-pixel"},"modified":"2026-09-01T18:59:31","modified_gmt":"2026-09-01T18:59:31","slug":"creating-a-pixel","status":"publish","type":"docs","link":"https:\/\/wiki.pontiac.media\/?docs=api\/pontiac-bidder-api-campaign-tutorial\/creating-a-pixel","title":{"rendered":"Creating a Pixel"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">Pixels are created at the Advertiser level using: POST \/rtb\/pixels\/ip-conversion-pixel<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">IP Conversion Pixels track user actions, such as purchases or sign-ups, after ad exposure. They can also be configured to create an RTB retargeting audience for use in Campaign and Line targeting.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">In this example, we will create a conversion Pixel for the Advertiser (ID: 5943) created earlier.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Pixel Settings<\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">The Pixel request includes the following core fields:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>name: Pixel display name.<\/li>\n\n\n\n<li>pixelType: Pixel implementation type.<\/li>\n\n\n\n<li>advertiserId: Parent Advertiser ID.<\/li>\n\n\n\n<li>seatId: Seat ID associated with the Pixel.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">Additional tracking and audience options can also be enabled:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>createRtbAudience: Creates an RTB retargeting audience from users captured by the Pixel.<\/li>\n\n\n\n<li>daysToLiveRTB: Number of days users remain in the associated RTB audience.<\/li>\n\n\n\n<li>orderIdMacro: Enables an Order ID macro.<\/li>\n\n\n\n<li>orderAmountMacro: Enables an Order Amount macro.<\/li>\n\n\n\n<li>clientIpMacro: Enables a Client IP macro.<\/li>\n\n\n\n<li>consumerIdMacro: Enables a Consumer ID macro.<\/li>\n\n\n\n<li>gdprConsentMacro: Enables a GDPR Consent macro.<\/li>\n\n\n\n<li>gdprMacro: Enables a GDPR flag macro.<\/li>\n\n\n\n<li>customVariableMacro: Enables a Custom Variable macro.<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">Request<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">The following example creates an IP Conversion Pixel and enables an RTB retargeting audience with a 180-day audience duration.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>curl -X 'POST' \\\n  'https:\/\/api.pontiac.media\/rtb\/pixels\/ip-conversion-pixel' \\\n  -H 'accept: application\/json' \\\n  -H 'auth: YOUR_AUTH_TOKEN' \\\n  -H 'Content-Type: application\/json' \\\n  -d '{\n    \"name\": \"API example\",\n    \"pixelType\": 1,\n    \"advertiserId\": 5943,\n    \"seatId\": 1000,\n    \"createRtbAudience\": true,\n    \"orderIdMacro\": true,\n    \"orderAmountMacro\": true,\n    \"clientIpMacro\": true,\n    \"consumerIdMacro\": true,\n    \"gdprConsentMacro\": true,\n    \"gdprMacro\": true,\n    \"daysToLiveRTB\": 180,\n    \"customVariableMacro\": true\n  }'<\/code><\/pre>\n\n\n\n<h3 class=\"wp-block-heading\">Response<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">A successful request returns the newly created Pixel and its stored configuration.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n  \"timestamp\": \"2026-09-01 16:55:00\",\n  \"response\": {\n    \"pontiacPixelId\": 18887,\n    \"name\": \"API example\",\n    \"pixelType\": \"2\",\n    \"advertiserId\": 5943,\n    \"seatId\": 1000,\n    \"createRtbAudience\": 1,\n    \"orderIdMacro\": 1,\n    \"orderAmountMacro\": 1,\n    \"clientIpMacro\": 1,\n    \"consumerIdMacro\": 1,\n    \"gdprConsentMacro\": 1,\n    \"gdprMacro\": 1,\n    \"daysToLiveRTB\": 180,\n    \"customVariableMacro\": 1,\n    \"piggybackPixels\": &#91;]\n  },\n  \"accountStatus\": 1,\n  \"seatId\": 1000\n}<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">From the response, save the pontiacPixelId. This ID can be used later when associating the Pixel with the applicable Campaign or Line.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">In this example: Pixel ID: 18887<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Because createRtbAudience is enabled, the Pixel can also be used to build an RTB retargeting audience from captured users.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">The response also includes a piggybackPixels array. If additional third-party tracking Pixels are associated with the Pontiac Pixel, they are returned in this field.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Pontiac Bidder UI Validation<\/h4>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"642\" src=\"https:\/\/wiki.pontiac.media\/wp-content\/uploads\/2026\/09\/Screenshot-2026-09-01-095730-1024x642.png\" alt=\"\" class=\"wp-image-14698\" srcset=\"https:\/\/wiki.pontiac.media\/wp-content\/uploads\/2026\/09\/Screenshot-2026-09-01-095730-1024x642.png 1024w, https:\/\/wiki.pontiac.media\/wp-content\/uploads\/2026\/09\/Screenshot-2026-09-01-095730-300x188.png 300w, https:\/\/wiki.pontiac.media\/wp-content\/uploads\/2026\/09\/Screenshot-2026-09-01-095730-768x481.png 768w, https:\/\/wiki.pontiac.media\/wp-content\/uploads\/2026\/09\/Screenshot-2026-09-01-095730-1536x963.png 1536w, https:\/\/wiki.pontiac.media\/wp-content\/uploads\/2026\/09\/Screenshot-2026-09-01-095730.png 1954w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\"><\/p>\n","protected":false},"author":17,"featured_media":0,"parent":14675,"menu_order":4,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_is_vendor_doc":"0","footnotes":""},"doc_tag":[],"class_list":["post-14692","docs","type-docs","status-publish","hentry","no-post-thumbnail"],"comment_count":0,"_links":{"self":[{"href":"https:\/\/wiki.pontiac.media\/index.php?rest_route=\/wp\/v2\/docs\/14692","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wiki.pontiac.media\/index.php?rest_route=\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/wiki.pontiac.media\/index.php?rest_route=\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/wiki.pontiac.media\/index.php?rest_route=\/wp\/v2\/users\/17"}],"replies":[{"embeddable":true,"href":"https:\/\/wiki.pontiac.media\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=14692"}],"version-history":[{"count":2,"href":"https:\/\/wiki.pontiac.media\/index.php?rest_route=\/wp\/v2\/docs\/14692\/revisions"}],"predecessor-version":[{"id":14699,"href":"https:\/\/wiki.pontiac.media\/index.php?rest_route=\/wp\/v2\/docs\/14692\/revisions\/14699"}],"up":[{"embeddable":true,"href":"https:\/\/wiki.pontiac.media\/index.php?rest_route=\/wp\/v2\/docs\/14675"}],"next":[{"title":"Creating a Campaign","link":"https:\/\/wiki.pontiac.media\/?docs=api\/pontiac-bidder-api-campaign-tutorial\/creating-a-campaign","href":"https:\/\/wiki.pontiac.media\/index.php?rest_route=\/wp\/v2\/docs\/14700"}],"prev":[{"title":"Uploading a Creative","link":"https:\/\/wiki.pontiac.media\/?docs=api\/pontiac-bidder-api-campaign-tutorial\/uploading-a-creative","href":"https:\/\/wiki.pontiac.media\/index.php?rest_route=\/wp\/v2\/docs\/14689"}],"wp:attachment":[{"href":"https:\/\/wiki.pontiac.media\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=14692"}],"wp:term":[{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/wiki.pontiac.media\/index.php?rest_route=%2Fwp%2Fv2%2Fdoc_tag&post=14692"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}