Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Table Plus
FieldTypeDescriptionDefaultRequired On
idintThe ID of the third-party pixel. PUT/DELETE
activebooleanFlag indicating whether the pixel is active.true 
namestringThe name of the third-party pixel.  
member_idintID of the member/network that owns this pixel. POST (specified within the query string)
advertiser_idintID of the advertiser that owns the thirdparty-pixel.null 
formatstring

The format of the pixel. Possible values for creatives: "raw-js", "url-html", "url-js", "url-image", or "raw-url".

"raw-js"

POST/PUT if changing content, secure_content, url, or url_secure fields.

contentstring

If the pixel's format is "raw-js", this is the JavaScript content to serve with the creative. The content and/or secure_content fields are required on POST for raw-js pixels.

You can also add macros to your pixel. For a list of the creative macros that you may append to your pixel, see Creative Macros (Customer login required).

 POST if the pixel's format is "raw-js".
secure_contentstring

If the pixel's format is "raw-js", the JavaScript content to serve with the creative. The content and/or secure_content fields are required on POST for raw-js pixels.

You can also add macros to your pixel. For a list of the creative macros that you may append to your pixel; see Creative Macros (Customer login required).

 POST if the pixel's format is "raw-js".
urlstring

If the pixel's format is "url-html", "url-js", "url-image", or "raw-url", the URL of the HTML, JavaScript, or Image pixel to serve with the creative. The url and/or secure_url fields are required on POST for these pixel types.

You can also add macros to your pixel. For a list of the creative macros that you may append to your pixel, see Creative Macros (Customer login required).

  
secure_urlstring

If the pixel's format is "url-html", "url-js", "url-image", or "raw-url", the URL of the HTML, JavaScript, or Image pixel to serve with the creative on a secure (https) call. The url and/or secure_url fields are required on POST for these pixel types. You can also add macros to your pixel.

You can also add macros to your pixel. For a list of the creative macros that you may append to your pixel, see Creative Macros (Customer login required).

 POST if the pixel's format is "url-html", "url-js", "url-image", or "raw-url".
membersarray of objects

Optional. If specified, this field will contain the ID of the member that owns the pixel and this pixel will render on all creatives owned by that member.

Example:

Code Block
 "members":[{"id":1}]
  
advertisersarray of objects

Optional. If the pixel has an owning advertiser (i.e., advertiser_id is not null), this array must contain the ID (and only the ID) of the advertiser that owns the pixel, As a result, this pixel will render on all creatives owned by that advertiser. If the pixel does not have an owning advertiser, this array can contain multiple advertisers to which the pixel will be applied.

Example:

Code Block
"advertisers":[{"id":3}]
  
creativesarray of objects

Read only. The creatives to which a pixel is applied. The creatives must belong to the owning member/advertiser. To attach a third-party pixel to a creative, use the Creative Service.

Example:

Code Block
"creatives": [{"id":860851}]
  
audit_statusstring

Read-only. The audit status of the pixel. Possible values are "pending", "rejected", "approved" or "exempt".

Note

An unaudited pixel will not prevent a creative from serving, but it will not serve along with the creative until it has passed audit.

"pending" 
supply_exceptionsarray of objects

The names of members on which the pixel should not serve. "AdX" is currently the only acceptable value.

Example:

Code Block
"supply_exceptions":[{"name":"AdxAdX"}]
  
adserversarray of objects

The adservers that the pixel calls. Required for pixels that serve on AdX inventory. A full list of adservers can be retrieved from the ad server service.

Example:

Code Block
"adservers":[{"id":11}, {"id":12}]
  

...