A Creative
that contains an arbitrary HTML snippet and file assets.
- Namespace
-
https://www.google.com/apis/ads/publisher/v202405
Field
Creative
(inherited) advertiserId
xsd:
long
The ID of the advertiser that owns the creative. This attribute is required.
id
xsd:
long
Uniquely identifies the Creative
. This value is read-only and is assigned by Google
when the creative is created. This attribute is required for updates.
name
xsd:
string
The name of the creative. This attribute is required and has a maximum length of 255 characters.
previewUrl
xsd:
string
The URL of the creative for previewing the media. This attribute is read-only and is assigned by Google when a creative is created.
policyLabels
Set of policy labels detected for this creative. This attribute is read-only.
Enumerations
-
MALWARE_IN_CREATIVE
- Malware was found in the creative.
For more information see here .
-
MALWARE_IN_LANDING_PAGE
- Malware was found in the landing page.
For more information see here .
-
LEGALLY_BLOCKED_REDIRECT_URL
- The redirect url contains legally objectionable content.
-
MISREPRESENTATION_OF_PRODUCT
- The creative misrepresents the product or service being advertised.
For more information see here .
-
SELF_CLICKING_CREATIVE
- The creative has been determined to be self clicking.
-
GAMING_GOOGLE_NETWORK
- The creative has been determined as attempting to game the Google
network.
For more information see here .
-
DYNAMIC_DNS
- The landing page for the creative uses a dynamic DNS.
For more information see here .
-
CIRCUMVENTING_SYSTEMS
- The creative has been determined as attempting to circumvent Google advertising systems.
-
PHISHING
- Phishing found in creative or landing page.
For more information see here .
-
DOWNLOAD_PROMPT_IN_CREATIVE
- The creative prompts the user to download a file.
For more information see here
-
UNAUTHORIZED_COOKIE_DETECTED
- The creative sets an unauthorized cookie on a Google domain.
For more information see here
-
TEMPORARY_PAUSE_FOR_VENDOR_INVESTIGATION
- The creative has been temporarily paused while we investigate.
-
ABUSIVE_EXPERIENCE
- The landing page contains an abusive experience.
For more information see here .
-
TRICK_TO_CLICK
- The creative is designed to mislead or trick the user into
interacting with it.
For more information see here .
-
USE_OF_NON_ALLOWLISTED_OMID_VERIFICATION_SCRIPT
- Non-allowlisted OMID verification script.
For more information see here .
-
MISUSE_OF_OMID_API
- OMID sdk injected by creative. < p>For more information see here .
-
UNACCEPTABLE_HTML_AD
- Unacceptable HTML5 ad.
For more information see here .
-
UNKNOWN
- The value returned if the actual value is not exposed by the requested API version.
appliedLabels
AppliedLabel
[]
The set of labels applied to this creative.
lastModifiedDateTime
The date and time this creative was last modified.
customFieldValues
The values of the custom fields associated with this creative.
thirdPartyDataDeclaration
The third party companies associated with this creative.
This is distinct from any associated companies that Google may detect programmatically.
HasDestinationUrlCreative
(inherited) destinationUrl
xsd:
string
The URL that the user is directed to if they click on the creative. This attribute is required
unless the destinationUrlType
is DestinationUrlType.NONE
, and has a maximum
length of 1024 characters.
destinationUrlType
The action that should be performed if the user clicks on the creative. This attribute is optional and defaults to DestinationUrlType.CLICK_TO_WEB .
Enumerations
-
UNKNOWN
- The value returned if the actual value is not exposed by the requested API version.
-
CLICK_TO_WEB
- Navigate to a web page. (a.k.a. "Click-through URL").
-
CLICK_TO_APP
- Start an application.
-
CLICK_TO_CALL
- Make a phone call.
-
NONE
- Destination URL not present. Useful for video creatives where a landing page or a product isn't necessarily applicable.
CustomCreative
htmlSnippet
xsd:
string
The HTML snippet that this creative delivers. This attribute is required.
customCreativeAssets
A list of file assets that are associated with this creative, and can be referenced in the snippet.
isInterstitial
xsd:
boolean
true
if this custom creative is interstitial. An interstitial creative will not
consider an impression served until it is fully rendered in the browser.
lockedOrientation
A locked orientation for this creative to be displayed in.
Enumerations
-
UNKNOWN
- The value returned if the actual value is not exposed by the requested API version.
-
FREE_ORIENTATION
-
PORTRAIT_ONLY
-
LANDSCAPE_ONLY
sslScanResult
The SSL compatibility scan result of this creative.
This attribute is read-only and determined by Google.
Enumerations
-
UNKNOWN
- The value returned if the actual value is not exposed by the requested API version.
-
UNSCANNED
-
SCANNED_SSL
-
SCANNED_NON_SSL
sslManualOverride
The manual override for the SSL compatibility of this creative.
This attribute is optional and defaults to SslManualOverride.NO_OVERRIDE .
Enumerations
-
UNKNOWN
- The value returned if the actual value is not exposed by the requested API version.
-
NO_OVERRIDE
-
SSL_COMPATIBLE
-
NOT_SSL_COMPATIBLE
isSafeFrameCompatible
xsd:
boolean
Whether the Creative is compatible for SafeFrame rendering.
This attribute is optional and defaults to true
.
thirdPartyImpressionTrackingUrls
xsd:
string[]
A list of impression tracking URLs to ping when this creative is displayed. This field is optional.