{"id":14724,"date":"2026-09-01T18:45:14","date_gmt":"2026-09-01T18:45:14","guid":{"rendered":"https:\/\/wiki.pontiac.media\/?docs=api\/getting-started-with-pontiac-api\/object-hierarchy"},"modified":"2026-09-01T19:40:13","modified_gmt":"2026-09-01T19:40:13","slug":"object-hierarchy","status":"publish","type":"docs","link":"https:\/\/wiki.pontiac.media\/?docs=api\/getting-started-with-pontiac-api\/object-hierarchy","title":{"rendered":"Object Hierarchy"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">Pontiac&#8217;s RTB API uses a hierarchical object structure for campaign setup.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">For a standard Seat, the core hierarchy is:<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><code>Seat &gt; Advertiser &gt; Campaign &gt; Line<\/code><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">For accounts using a Master Seat structure, the hierarchy is:<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><code>Master Seat &gt; Sub-Seat &gt; Advertiser &gt; Campaign &gt; Line<\/code><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Creatives, Pixels, and Audiences are created separately and are associated with the applicable Advertiser, Campaign, or Line depending on the object type and management settings.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Master Seat<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">A Master Seat is the top-level account used to manage one or more Sub-Seats.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Master Seats are typically used by organizations that operate multiple advertiser environments, business units, clients, or managed accounts under a single parent account.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Hierarchy:<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><code>Master Seat &gt; Sub-Seat<\/code><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Depending on the endpoint and workflow, API requests may be made from the Master Seat while specifying the applicable Sub-Seat.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Sub-Seat<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">A Sub-Seat is an individual Seat managed beneath a Master Seat.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Advertisers, Campaigns, Lines, Creatives, Pixels, and other RTB objects are created within the applicable Sub-Seat.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Hierarchy:<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><code>Master Seat &gt; Sub-Seat &gt; Advertiser<\/code><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">For accounts that do not use a Master Seat structure, the Seat itself acts as the top-level account.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Advertiser<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">An Advertiser is created within a Seat or Sub-Seat and represents the brand or organization running the advertising activity.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Advertisers contain the Campaigns and advertiser-level resources associated with that advertiser.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Hierarchy:<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><code>Seat &gt; Advertiser<\/code><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">or:<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><code>Master Seat &gt; Sub-Seat &gt; Advertiser<\/code><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Example:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Seat ID: <code>1000<\/code><\/li>\n\n\n\n<li>Advertiser ID: <code>5943<\/code><\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">The <code>advertiserId<\/code> returned when the Advertiser is created is used when creating Campaigns, Lines, Creatives, Pixels, and other advertiser-level objects.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Campaign<\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">A Campaign is created under an Advertiser.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Campaigns define the broader settings that can apply to the Lines created beneath them, including:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Campaign dates<\/li>\n\n\n\n<li>Budget and budget type<\/li>\n\n\n\n<li>Flights<\/li>\n\n\n\n<li>Pacing<\/li>\n\n\n\n<li>Dayparting<\/li>\n\n\n\n<li>Frequency and recency<\/li>\n\n\n\n<li>Targeting<\/li>\n\n\n\n<li>Creative management<\/li>\n\n\n\n<li>Pixel management<\/li>\n\n\n\n<li>Programmatic Guaranteed settings<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">Hierarchy:<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><code>Advertiser &gt; Campaign<\/code><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Example:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Advertiser ID: <code>5943<\/code><\/li>\n\n\n\n<li>Campaign ID: <code>14901<\/code><\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">A Campaign does not bid directly on inventory. At least one Line must be created under the Campaign in order for it to deliver.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Line<\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">A Line is created under a Campaign and is the core bidding and delivery object.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Lines define how Pontiac bids on eligible inventory, including settings such as:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Bid type<\/li>\n\n\n\n<li>Bid price<\/li>\n\n\n\n<li>Maximum bid<\/li>\n\n\n\n<li>Line-level targeting<\/li>\n\n\n\n<li>Inventory type<\/li>\n\n\n\n<li>Budget allocation<\/li>\n\n\n\n<li>Other Line-specific delivery settings<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">Hierarchy:<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><code>Campaign &gt; Line<\/code><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Example:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Campaign ID: <code>14901<\/code><\/li>\n\n\n\n<li>Line ID: <code>75913<\/code><\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">Each Line belongs to exactly one Campaign.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Creatives<\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">Creatives are created under an Advertiser and contain the ad content that can be served by Campaigns and Lines.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Example:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Advertiser ID: <code>5943<\/code><\/li>\n\n\n\n<li>Creative ID: <code>30336<\/code><\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">Creatives can be associated directly with Lines or managed at the Campaign level.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">When Campaign-level Creative management is enabled, Creatives associated with the Campaign are inherited by its Lines.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Pixels<\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">Pixels are created under an Advertiser and are used for measurement, conversion tracking, and audience creation.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Example:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Advertiser ID: <code>5943<\/code><\/li>\n\n\n\n<li>Pixel ID: <code>18887<\/code><\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">Pixels can be associated at either the Campaign or Line level.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">When Campaign-level Pixel management is enabled, Pixels associated with the Campaign are inherited by its Lines.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Audiences<\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">Audiences are created and managed at the Seat level.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Depending on the audience type, these may include:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>First-party audiences<\/li>\n\n\n\n<li>Third-party audiences<\/li>\n\n\n\n<li>Contextual audiences<\/li>\n\n\n\n<li>ART audiences<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">Audiences can be created, updated, and managed at the applicable Seat level and then used as targeting criteria across eligible Campaigns and Lines within that Seat.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">For accounts using a Master Seat structure, audiences created at the Master Seat level may also be available to associated Sub-Seats. These inherited audiences cannot be edited from the Sub-Seat. When applicable, the interface displays:<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><em>This audience cannot be edited because it belongs to the Master Seat.<\/em><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Audience targeting can be applied at either the Campaign or Line level.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Flights<\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">Flights define budget and date ranges within a Campaign.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">When Flights are enabled, a Campaign can contain one or more Campaign Flights. Lines beneath the Campaign can also have corresponding Line Flights.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Example:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Campaign ID: <code>14901<\/code><\/li>\n\n\n\n<li>Campaign Flight ID: <code>8371<\/code><\/li>\n\n\n\n<li>Line ID: <code>75913<\/code><\/li>\n\n\n\n<li>Line Flight ID: <code>58824<\/code><\/li>\n<\/ul>\n\n\n\n<h4 class=\"wp-block-heading\">How the Objects Work Together<\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">For a standard Seat:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>Seat\n\u251c\u2500\u2500 Audiences\n\u2514\u2500\u2500 Advertiser\n    \u251c\u2500\u2500 Creatives\n    \u251c\u2500\u2500 Pixels\n    \u2514\u2500\u2500 Campaign\n        \u251c\u2500\u2500 Campaign Flights\n        \u2514\u2500\u2500 Line\n            \u2514\u2500\u2500 Line Flights\n<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">For a Master Seat account:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>Master Seat\n\u251c\u2500\u2500 Audiences\n\u2514\u2500\u2500 Sub-Seat\n    \u251c\u2500\u2500 Audiences\n    \u2514\u2500\u2500 Advertiser\n        \u251c\u2500\u2500 Creatives\n        \u251c\u2500\u2500 Pixels\n        \u2514\u2500\u2500 Campaign\n            \u251c\u2500\u2500 Campaign Flights\n            \u2514\u2500\u2500 Line<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Audiences created at the Master Seat level are available to associated Sub-Seats for targeting, but they remain owned and managed by the Master Seat. Sub-Seats can use these audiences but cannot edit them.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Sub-Seats can also create and manage their own audiences. Audiences created within a Sub-Seat are owned by that Sub-Seat and can be edited there.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Creatives and Pixels, by contrast, are associated with an Advertiser and can then be applied at either the Campaign or Line level, depending on the applicable management settings.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><\/p>\n","protected":false},"author":17,"featured_media":0,"parent":710,"menu_order":1,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_is_vendor_doc":"0","footnotes":""},"doc_tag":[],"class_list":["post-14724","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\/14724","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=14724"}],"version-history":[{"count":6,"href":"https:\/\/wiki.pontiac.media\/index.php?rest_route=\/wp\/v2\/docs\/14724\/revisions"}],"predecessor-version":[{"id":14734,"href":"https:\/\/wiki.pontiac.media\/index.php?rest_route=\/wp\/v2\/docs\/14724\/revisions\/14734"}],"up":[{"embeddable":true,"href":"https:\/\/wiki.pontiac.media\/index.php?rest_route=\/wp\/v2\/docs\/710"}],"next":[{"title":"Campaign vs. Line Management Inheritance","link":"https:\/\/wiki.pontiac.media\/?docs=api\/getting-started-with-pontiac-api\/campaign-vs-line-management-inheritance","href":"https:\/\/wiki.pontiac.media\/index.php?rest_route=\/wp\/v2\/docs\/14735"}],"prev":[{"title":"Pontiac API Overview","link":"https:\/\/wiki.pontiac.media\/?docs=api\/getting-started-with-pontiac-api\/pontiac-api-overview","href":"https:\/\/wiki.pontiac.media\/index.php?rest_route=\/wp\/v2\/docs\/6457"}],"wp:attachment":[{"href":"https:\/\/wiki.pontiac.media\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=14724"}],"wp:term":[{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/wiki.pontiac.media\/index.php?rest_route=%2Fwp%2Fv2%2Fdoc_tag&post=14724"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}