{"id":10935,"date":"2025-04-15T21:07:31","date_gmt":"2025-04-15T21:07:31","guid":{"rendered":"https:\/\/wiki.pontiac.media\/?docs=ctv-documentation\/pixels\/query-string-parameters"},"modified":"2026-09-04T15:02:11","modified_gmt":"2026-09-04T15:02:11","slug":"query-string-macro-parameters","status":"publish","type":"docs","link":"https:\/\/wiki.pontiac.media\/?docs=ctv-documentation\/pixels\/query-string-macro-parameters","title":{"rendered":"Query String Macro Parameters"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">After a Pixel has been generated, optional query string parameters can be added to pass additional information with each Pixel fire. When enabled, the corresponding parameters and placeholders are added to the Pixel URL.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Work with your web developer to dynamically replace each placeholder with the appropriate value before the Pixel fires. Values passed through these parameters are available in <strong>Custom Reporting<\/strong> and can provide additional insight into campaign-driven conversions.<\/p>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"1008\" height=\"626\" src=\"https:\/\/wiki.pontiac.media\/wp-content\/uploads\/2025\/04\/Screenshot-2026-09-02-151646-1.png\" alt=\"\" class=\"wp-image-14933\" srcset=\"https:\/\/wiki.pontiac.media\/wp-content\/uploads\/2025\/04\/Screenshot-2026-09-02-151646-1.png 1008w, https:\/\/wiki.pontiac.media\/wp-content\/uploads\/2025\/04\/Screenshot-2026-09-02-151646-1-300x186.png 300w, https:\/\/wiki.pontiac.media\/wp-content\/uploads\/2025\/04\/Screenshot-2026-09-02-151646-1-766x476.png 766w\" sizes=\"auto, (max-width: 1008px) 100vw, 1008px\" \/><\/figure>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Order ID:<\/strong> Passes the unique order or transaction ID generated by your site. <\/li>\n\n\n\n<li><strong>Order Amount:<\/strong> Passes the value associated with the conversion or order. This can be used in reporting for metrics such as revenue and ROAS. <\/li>\n\n\n\n<li><strong>Consumer ID:<\/strong> Passes a unique customer, lead, or visitor identifier generated by your site. <\/li>\n\n\n\n<li><strong>Client IP:<\/strong> Passes the visitor IP address observed by your website when the Pixel fires. This can be useful when the Pixel is implemented through a container or another environment where the IP address detected directly by the Pixel may not represent the visitor accurately. When provided, the Client IP value is used for attribution and reporting. <\/li>\n\n\n\n<li><strong>GDPR Consent:<\/strong> Passes the visitor\u2019s IAB TCF consent string when applicable. This value should be populated dynamically using consent information collected by the website or Consent Management Platform (CMP). <\/li>\n\n\n\n<li><strong>GDPR:<\/strong> Indicates whether GDPR applies to the visitor associated with the Pixel fire, typically using <code>1<\/code> when GDPR applies and <code>0<\/code> when it does not.\n<ul class=\"wp-block-list\">\n<li>For additional information, see <a href=\"https:\/\/wiki.pontiac.media\/?docs=ctv-documentation\/seats\/gdpr-compliant-seats\/gdpr-query-string-macros\">GDPR Query String Macros<\/a>.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><strong>Custom Variable 1:<\/strong> Adds <code>var1=VAR1<\/code> to the Pixel URL and makes the value available as Custom Variable 1 in Custom Reporting. Additional values can be passed using <code>var2<\/code>, <code>var3<\/code>, and <code>var4<\/code>.\n<ul class=\"wp-block-list\">\n<li>Applicable Report Types:\n<ul class=\"wp-block-list\">\n<li>IP Conversion Pixel: Path to Conversion<\/li>\n\n\n\n<li>IP Conversion Pixel: Page Visits<\/li>\n\n\n\n<li>Cookies: Path to Conversion<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"351\" height=\"336\" src=\"https:\/\/wiki.pontiac.media\/wp-content\/uploads\/2025\/04\/Screenshot-2026-09-02-153627.png\" alt=\"\" class=\"wp-image-14935\" srcset=\"https:\/\/wiki.pontiac.media\/wp-content\/uploads\/2025\/04\/Screenshot-2026-09-02-153627.png 351w, https:\/\/wiki.pontiac.media\/wp-content\/uploads\/2025\/04\/Screenshot-2026-09-02-153627-300x287.png 300w, https:\/\/wiki.pontiac.media\/wp-content\/uploads\/2025\/04\/Screenshot-2026-09-02-153627-16x16.png 16w, https:\/\/wiki.pontiac.media\/wp-content\/uploads\/2025\/04\/Screenshot-2026-09-02-153627-18x18.png 18w, https:\/\/wiki.pontiac.media\/wp-content\/uploads\/2025\/04\/Screenshot-2026-09-02-153627-20x20.png 20w\" sizes=\"auto, (max-width: 351px) 100vw, 351px\" \/><\/figure>\n","protected":false},"author":17,"featured_media":0,"parent":9915,"menu_order":5,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_is_vendor_doc":"0","footnotes":""},"doc_tag":[],"class_list":["post-10935","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\/10935","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=10935"}],"version-history":[{"count":7,"href":"https:\/\/wiki.pontiac.media\/index.php?rest_route=\/wp\/v2\/docs\/10935\/revisions"}],"predecessor-version":[{"id":15114,"href":"https:\/\/wiki.pontiac.media\/index.php?rest_route=\/wp\/v2\/docs\/10935\/revisions\/15114"}],"up":[{"embeddable":true,"href":"https:\/\/wiki.pontiac.media\/index.php?rest_route=\/wp\/v2\/docs\/9915"}],"next":[{"title":"Whitelabel Pixel Domain Setup","link":"https:\/\/wiki.pontiac.media\/?docs=ctv-documentation\/pixels\/whitelabel-pixel-domain-setup","href":"https:\/\/wiki.pontiac.media\/index.php?rest_route=\/wp\/v2\/docs\/14593"}],"prev":[{"title":"Piggyback Pixels","link":"https:\/\/wiki.pontiac.media\/?docs=ctv-documentation\/pixels\/piggyback-pixels","href":"https:\/\/wiki.pontiac.media\/index.php?rest_route=\/wp\/v2\/docs\/14585"}],"wp:attachment":[{"href":"https:\/\/wiki.pontiac.media\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=10935"}],"wp:term":[{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/wiki.pontiac.media\/index.php?rest_route=%2Fwp%2Fv2%2Fdoc_tag&post=10935"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}