Creatives

The Creatives resource provides a way to submit new creatives to Google's creative verification pipeline.

For a list of methods for this resource, see the end of this page.

Resource representations

A creative and its classification data.

{
  "kind": "adexchangebuyer#creative",
  "accountId": integer,
  "buyerCreativeId": string,
  "agencyId": long,
  "version": integer,
  "apiUploadTimestamp": datetime,
  "HTMLSnippet": string,
  "nativeAd": {
    "headline": string,
    "body": string,
    "callToAction": string,
    "advertiser": string,
    "image": {
      "url": string,
      "width": integer,
      "height": integer
    },
    "logo": {
      "url": string,
      "width": integer,
      "height": integer
    },
    "appIcon": {
      "url": string,
      "width": integer,
      "height": integer
    },
    "starRating": double,
    "impressionTrackingUrl": [
      string
    ],
    "clickTrackingUrl": string,
    "price": string,
    "store": string
  },
  "videoURL": string,
  "clickThroughUrl": [
    string
  ],
  "impressionTrackingUrl": [
    string
  ],
  "vendorType": [
    integer
  ],
  "attribute": [
    integer
  ],
  "width": integer,
  "height": integer,
  "advertiserName": string,
  "status": string,
  "disapprovalReasons": [
    {
      "reason": string,
      "details": [
        string
      ]
    }
  ],
  "advertiserId": [
    long
  ],
  "sensitiveCategories": [
    integer
  ],
  "restrictedCategories": [
    integer
  ],
  "productCategories": [
    integer
  ],
  "corrections": [
    {
      "reason": string,
      "details": [
        string
      ]
    }
  ],
  "filteringReasons": {
    "date": string,
    "reasons": [
      {
        "filteringStatus": integer,
        "filteringCount": long
      }
    ]
  }
}
Property name Value Description Notes
HTMLSnippet string The HTML snippet that displays the ad when inserted in the web page. If set, videoURL should not be set. writable
accountId integer Account ID.
advertiserId[] list Detected advertiser ID, if any. Read-only. This field should not be set in requests.
advertiserName string The name of the company being advertised in the creative.
agencyId long The agency id for this creative. writable
apiUploadTimestamp datetime The last upload timestamp of this creative if it was uploaded via API. Read-only. The value of this field is generated, and will be ignored for uploads. (formatted RFC 3339 timestamp).
attribute[] list List of buyer selectable attributes for the ads that may be shown from this snippet. Each attribute is represented by an integer as defined in the buyer-declarable-creative-attributes.txt file. writable
buyerCreativeId string A buyer-specific ID identifying the creative in this ad.
clickThroughUrl[] list The set of destination URLs for the snippet.
corrections[] list Shows any corrections that were applied to this creative. Read-only. This field should not be set in requests.
corrections[].details[] list Additional details about the correction.
corrections[].reason string The type of correction that was applied to the creative.

Acceptable values are:
  • "FLASHLESS_ATTRIBUTE"
  • "FLASH_ATTRIBUTE"
  • "FLASH_ATTRIBUTE_REMOVED"
  • "IN_BANNER_VIDEO_ATTRIBUTE_ADDED"
  • "MRAID_ATTRIBUTE_ADDED"
  • "REQUIRED_ATTRIBUTE"
  • "REQUIRED_VENDOR"
  • "SSL_ATTRIBUTE"
  • "SSL_ATTRIBUTE_ADDED"
  • "VENDOR_IDS"
disapprovalReasons[] list The reasons for disapproval, if any. Note that not all disapproval reasons may be categorized, so it is possible for the creative to have a status of DISAPPROVED with an empty list for disapproval_reasons. In this case, please reach out to your TAM to help debug the issue. Read-only. This field should not be set in requests.
disapprovalReasons[].details[] list Additional details about the reason for disapproval.
disapprovalReasons[].reason string The categorized reason for disapproval.

Acceptable values are:
  • "ADULT_IMAGE_OR_VIDEO"
  • "AD_SIZE_DOES_NOT_MATCH_AD_SLOT"
  • "AUTOMATED_AD_CLICKING"
  • "BAD_URL_LEGAL_DISAPPROVAL"
  • "BLANK_CREATIVE"
  • "BROKEN_URL"
  • "CLICK_TO_DOWNLOAD_NOT_AN_APP"
  • "COUNTERFEIT_DESIGNER_GOODS"
  • "DANGEROUS_PRODUCTS_DRUGS"
  • "DANGEROUS_PRODUCTS_EXPLOSIVES"
  • "DANGEROUS_PRODUCTS_GUNS"
  • "DANGEROUS_PRODUCTS_KNIVES"
  • "DANGEROUS_PRODUCTS_TOBACCO"
  • "DANGEROUS_PRODUCTS_WEAPONS"
  • "DESTINATION_SITE_DOES_NOT_ALLOW_GOING_BACK"
  • "DESTINATION_SITE_NOT_CRAWLABLE_ROBOTS_TXT"
  • "DESTINATION_URLS_UNDECLARED"
  • "DESTINATION_URL_SITE_NOT_CRAWLABLE"
  • "DIRECT_DOWNLOAD_IN_AD"
  • "DYNAMIC_DNS_AT_DESTINATION_URL"
  • "DYSFUNCTIONAL_PROMOTION"
  • "ENABLING_DISHONEST_BEHAVIOR"
  • "EXPANDABLE_DIRECTION_NOT_SUPPORTED"
  • "EXPANDABLE_FUNCTIONALITY"
  • "EXPANDABLE_INCORRECT_DIRECTION"
  • "EXPANDABLE_INVALID_VENDOR"
  • "FOURTH_PARTY_BROWSER_COOKIES"
  • "GAINING_AN_UNFAIR_ADVANTAGE"
  • "GAMING_THE_GOOGLE_NETWORK"
  • "INACCURATE_AD_TEXT"
  • "INACCURATE_REVIEW_EXTENSION"
  • "INAPPROPRIATE_CONTENT"
  • "INCORRECT_AD_TECHNOLOGY_DECLARATION"
  • "INCORRECT_DESTINATION_URL_DECLARATION"
  • "INCORRECT_IMAGE_LAYOUT"
  • "INCORRECT_REMARKETING_DECLARATION"
  • "INVALID_BIDDING_METHOD"
  • "INVALID_CREATIVE_DOWNLOAD_SIZE"
  • "INVALID_FOURTH_PARTY_CALL"
  • "INVALID_INTEREST_BASED_AD"
  • "INVALID_REMARKETING_LIST_USAGE"
  • "INVALID_RTB_PROTOCOL_USAGE"
  • "INVALID_SSL_DECLARATION"
  • "INVALID_URL_PROTOCOL"
  • "IRRELEVANT_IMAGE_OR_VIDEO"
  • "LANDING_PAGE_DISABLED"
  • "LANDING_PAGE_ERROR"
  • "LENGTH_OF_IMAGE_ANIMATION"
  • "LSO_OBJECTS"
  • "MALWARE_SUSPECTED"
  • "MEDIA_NOT_FUNCTIONAL"
  • "MISLEADING_CLAIMS_IN_AD"
  • "MISLEADING_PROMOTIONS"
  • "MISUSE_OF_PERSONAL_INFORMATION"
  • "NO_BORDER"
  • "OMISSION_OF_RELEVANT_INFORMATION"
  • "PHARMA_GAMBLING_ALCOHOL_NOT_ALLOWED"
  • "POOR_IMAGE_OR_VIDEO_QUALITY"
  • "POP_UP"
  • "PROBLEM_WITH_CLICK_MACRO"
  • "PROFESSIONAL_STANDARDS"
  • "RAW_IP_ADDRESS_IN_SNIPPET"
  • "RESTRICTED_POLITICAL_CONTENT"
  • "RESTRICTED_PRODUCTS"
  • "SENSITIVE_EVENTS"
  • "SEXUALLY_EXPLICIT_CONTENT"
  • "SHOCKING_CONTENT"
  • "TECHNICAL_REQUIREMENTS"
  • "UNACCEPTABLE_CONTENT"
  • "UNACCEPTABLE_CONTENT_SOFTWARE"
  • "UNACCEPTABLE_IMAGE_CONTENT"
  • "UNAUTHORIZED_COOKIE_ON_GOOGLE_DOMAIN"
  • "UNAVAILABLE_PROMOTIONS"
  • "UNCLEAR_OR_IRRELEVANT_AD"
  • "UNDECLARED_FLASH_OBJECTS"
  • "UNDECLARED_RESTRICTED_CONTENT"
  • "UNSUPPORTED_CONTENT"
  • "VIDEO_FUNCTIONALITY"
  • "VIDEO_INVALID_VENDOR"
  • "VIDEO_UNSUPPORTED_FORMAT"
  • "VIDEO_UNSUPPORTED_LENGTH"
filteringReasons object The filtering reasons for the creative. Read-only. This field should not be set in requests.
filteringReasons.date string The date in ISO 8601 format for the data. The data is collected from 00:00:00 to 23:59:59 in PST.
filteringReasons.reasons[] list The filtering reasons.
filteringReasons.reasons[].filteringCount long The number of times the creative was filtered for the status. The count is aggregated across all publishers on the exchange.
filteringReasons.reasons[].filteringStatus integer The filtering status code. Please refer to the creative-status-codes.txt file for different statuses.
height integer Ad height in pixels.
impressionTrackingUrl[] list The set of urls to be called to record an impression. writable
kind string Resource type. This is always "adexchangebuyer#creative".
nativeAd object If nativeAd is set, HTMLSnippet and videoURL should not be set. writable
nativeAd.advertiser string
nativeAd.appIcon object The app icon, for app download ads.
nativeAd.appIcon.height integer
nativeAd.appIcon.url string
nativeAd.appIcon.width integer
nativeAd.body string A long description of the ad.
nativeAd.callToAction string A label for the button that the user is supposed to click.
nativeAd.clickTrackingUrl string The URL to use for click tracking.
nativeAd.headline string A short title for the ad.
nativeAd.image object A large image.
nativeAd.image.height integer
nativeAd.image.url string
nativeAd.image.width integer
nativeAd.impressionTrackingUrl[] list The URLs are called when the impression is rendered.
nativeAd.logo.height integer
nativeAd.logo.url string
nativeAd.logo.width integer
nativeAd.price string The price of the promoted app including the currency info.
nativeAd.starRating double The app rating in the app store. Must be in the range [0-5].
nativeAd.store string The URL to the app store to purchase/download the promoted app.
productCategories[] list Detected product categories, if any. Read-only. Each category is represented by an integer as defined in the ad-product-categories.txt file. This field should not be set in requests.
restrictedCategories[] list All restricted categories for the ads that may be shown from this snippet. Each category is represented by an integer as defined in the ad-restricted-categories.txt file. writable
sensitiveCategories[] list Detected sensitive categories, if any. Read-only. Each category is represented by an integer as defined in the ad-sensitive-categories.txt file. This field should not be set in requests.
status string Creative serving status. Read-only. This field should not be set in requests.

Acceptable values are:
  • "APPROVED"
  • "DISAPPROVED"
  • "NOT_CHECKED"
  • "UNKNOWN"
vendorType[] list List of vendor types for the ads that may be shown from this snippet. Each vendor type is represented by an integer as defined in the vendors.txt file. writable
version integer The version for this creative. Read-only. This field should not be set in requests.
videoURL string The URL from which a video ad loads; that is, the URL to use to fetch that video ad. The resource at this URL is usually an XML document that contains a standard format for loading the video, plus tracking information. This is not the same as an HTML snippet, which is only for non-video ads. If set, HTMLSnippet should not be set. writable
width integer Ad width in pixels.

Methods

get
Gets the status for a single creative. A creative will be available 30-40 minutes after submission.
insert
Inserts a new creative into Google's creative verification pipeline.
list
Retrieves a list of the authenticated user's active creatives. A creative will be available 30-40 minutes after submission.

Send feedback about...

Buyer REST API
Buyer REST API