Method: creativeAssets.insert

Inserts a new creative asset.

HTTP request

  • Upload URI, for media upload requests:
    POST https://dfareporting.googleapis.com/upload/dfareporting/v3.5/userprofiles/{profileId}/creativeAssets/{advertiserId}/creativeAssets
  • Metadata URI, for metadata-only requests:
    POST https://dfareporting.googleapis.com/dfareporting/v3.5/userprofiles/{profileId}/creativeAssets/{advertiserId}/creativeAssets

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
profileId

string (int64 format)

User profile ID associated with this request.

advertiserId

string (int64 format)

Advertiser ID of this creative. This is a required field.

Request body

The request body contains an instance of CreativeAssetMetadata.

Response body

If successful, the response body contains data with the following structure:

CreativeAssets contains properties of a creative asset file which will be uploaded or has already been uploaded. Refer to the creative sample code for how to upload assets and insert a creative.

JSON representation
{
  "assetIdentifier": {
    object (CreativeAssetId)
  },
  "detectedFeatures": [
    enum (DetectedFeatures)
  ],
  "warnedValidationRules": [
    enum (WarnedValidationRules)
  ],
  "clickTags": [
    {
      object (ClickTag)
    }
  ],
  "id": string,
  "idDimensionValue": {
    object (DimensionValue)
  },
  "richMedia": boolean,
  "counterCustomEvents": [
    {
      object (CreativeCustomEvent)
    }
  ],
  "exitCustomEvents": [
    {
      object (CreativeCustomEvent)
    }
  ],
  "timerCustomEvents": [
    {
      object (CreativeCustomEvent)
    }
  ],
  "kind": string
}
Fields
assetIdentifier

object (CreativeAssetId)

ID of the creative asset. This is a required field.

detectedFeatures[]

enum (DetectedFeatures)

accountPermissionGroups.list of feature dependencies for the creative asset that are detected by Campaign Manager. Feature dependencies are features that a browser must be able to support in order to render your HTML5 creative correctly. This is a read-only, auto-generated field.

warnedValidationRules[]

enum (WarnedValidationRules)

Rules validated during code generation that generated a warning. This is a read-only, auto-generated field.

Possible values are:

  • "

    ADMOB_REFERENCED

    "

  • "

    ASSET_FORMAT_UNSUPPORTED_DCM

    "

  • "

    ASSET_INVALID

    "

  • "

    CLICK_TAG_HARD_CODED

    "

  • "

    CLICK_TAG_INVALID

    "

  • "

    CLICK_TAG_IN_GWD

    "

  • "

    CLICK_TAG_MISSING

    "

  • "

    CLICK_TAG_MORE_THAN_ONE

    "

  • "

    CLICK_TAG_NON_TOP_LEVEL

    "

  • "

    COMPONENT_UNSUPPORTED_DCM

    "

  • "

    ENABLER_UNSUPPORTED_METHOD_DCM

    "

  • "

    EXTERNAL_FILE_REFERENCED

    "

  • "

    FILE_DETAIL_EMPTY

    "

  • "

    FILE_TYPE_INVALID

    "

  • "

    GWD_PROPERTIES_INVALID

    "

  • "

    HTML5_FEATURE_UNSUPPORTED

    "

  • "

    LINKED_FILE_NOT_FOUND

    "

  • "

    MAX_FLASH_VERSION_11

    "

  • "

    MRAID_REFERENCED

    "

  • "

    NOT_SSL_COMPLIANT

    "

  • "

    ORPHANED_ASSET

    "

  • "

    PRIMARY_HTML_MISSING

    "

  • "

    SVG_INVALID

    "

  • "

    ZIP_INVALID

    "

clickTags[]

object (ClickTag)

accountPermissionGroups.list of detected click tags for assets. This is a read-only, auto-generated field. This field is empty for a rich media asset.

id

string (int64 format)

Numeric ID of the asset. This is a read-only, auto-generated field.

idDimensionValue

object (DimensionValue)

Dimension value for the numeric ID of the asset. This is a read-only, auto-generated field.

richMedia

boolean

True if the uploaded asset is a rich media asset. This is a read-only, auto-generated field.

counterCustomEvents[]

object (CreativeCustomEvent)

accountPermissionGroups.list of counter events configured for the asset. This is a read-only, auto-generated field and only applicable to a rich media asset.

exitCustomEvents[]

object (CreativeCustomEvent)

accountPermissionGroups.list of exit events configured for the asset. This is a read-only, auto-generated field and only applicable to a rich media asset.

timerCustomEvents[]

object (CreativeCustomEvent)

accountPermissionGroups.list of timer events configured for the asset. This is a read-only, auto-generated field and only applicable to a rich media asset.

kind

string

Identifies what kind of resource this is. Value: the fixed string

"dfareporting#creativeAssetMetadata"

.

Authorization Scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/dfatrafficking

DetectedFeatures

Enums
CSS_FONT_FACE
CSS_BACKGROUND_SIZE
CSS_BORDER_IMAGE
CSS_BORDER_RADIUS
CSS_BOX_SHADOW
CSS_FLEX_BOX
CSS_HSLA
CSS_MULTIPLE_BGS
CSS_OPACITY
CSS_RGBA
CSS_TEXT_SHADOW
CSS_ANIMATIONS
CSS_COLUMNS
CSS_GENERATED_CONTENT
CSS_GRADIENTS
CSS_REFLECTIONS
CSS_TRANSFORMS
CSS_TRANSFORMS3D
CSS_TRANSITIONS
APPLICATION_CACHE
CANVAS
CANVAS_TEXT
DRAG_AND_DROP
HASH_CHANGE
HISTORY
AUDIO
VIDEO
INDEXED_DB
INPUT_ATTR_AUTOCOMPLETE
INPUT_ATTR_AUTOFOCUS
INPUT_ATTR_LIST
INPUT_ATTR_PLACEHOLDER
INPUT_ATTR_MAX
INPUT_ATTR_MIN
INPUT_ATTR_MULTIPLE
INPUT_ATTR_PATTERN
INPUT_ATTR_REQUIRED
INPUT_ATTR_STEP
INPUT_TYPE_TEL
INPUT_TYPE_URL
INPUT_TYPE_EMAIL
INPUT_TYPE_DATETIME
INPUT_TYPE_DATE
INPUT_TYPE_MONTH
INPUT_TYPE_WEEK
INPUT_TYPE_TIME
INPUT_TYPE_DATETIME_LOCAL
INPUT_TYPE_NUMBER
INPUT_TYPE_RANGE
INPUT_TYPE_COLOR
LOCAL_STORAGE
POST_MESSAGE
SESSION_STORAGE
WEB_SOCKETS
WEB_SQL_DATABASE
WEB_WORKERS
GEO_LOCATION
INLINE_SVG
SMIL
SVG_HREF
SVG_CLIP_PATHS
TOUCH
WEBGL
SVG_FILTERS
SVG_FE_IMAGE

WarnedValidationRules

Enums
CLICK_TAG_NON_TOP_LEVEL
CLICK_TAG_MISSING
CLICK_TAG_MORE_THAN_ONE
CLICK_TAG_INVALID
ORPHANED_ASSET
PRIMARY_HTML_MISSING
EXTERNAL_FILE_REFERENCED
MRAID_REFERENCED
ADMOB_REFERENCED
FILE_TYPE_INVALID
ZIP_INVALID
LINKED_FILE_NOT_FOUND
MAX_FLASH_VERSION_11
NOT_SSL_COMPLIANT
FILE_DETAIL_EMPTY
ASSET_INVALID
GWD_PROPERTIES_INVALID
ENABLER_UNSUPPORTED_METHOD_DCM
ASSET_FORMAT_UNSUPPORTED_DCM
COMPONENT_UNSUPPORTED_DCM
HTML5_FEATURE_UNSUPPORTED
CLICK_TAG_IN_GWD
CLICK_TAG_HARD_CODED
SVG_INVALID
CLICK_TAG_IN_RICH_MEDIA
MISSING_ENABLER_REFERENCE