Skip to end of metadata
Go to start of metadata

Third-Party Pixel Service

The third-party pixel service allows you to upload and modify third-party creative pixels, and attach them to advertisers, or creatives. You can also attach third-party creative pixels to your member.

On This Page

REST API

Add a new third-party pixel:

Modify an existing third-party pixel:

View all of your third-party pixels:

View a specific third-party pixel:

Delete an existing third-party pixel:

JSON Fields

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” in the UI documentation (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” in the UI documentation (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” in the UI documentation (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” in the UI documentation (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:

  
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:

  
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:

  
audit_statusstring

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

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:

  
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:

  

Examples

View a specific third-party pixel
Add a new third-party pixel
Update a third-party pixel
Delete a third-party pixel

Related Topics

  • No labels