Ad Assets

You can create and manage additional ad assets, like carousel cards, using these fields.

Fields

The following fields are available for creating and managing ad assets:

Name Description Type Add Update
Ad ID The ID of the ad associated with the asset. long required optional
Object ID The ID of the ad asset. long N/A required
Title Title text used for the ad asset. Maximum limit is 50 characters. Use {city}, {state}, {state_abbr}, {country} and {country_abbr} macros to add geo locations for user personalized ads. Use the {time} macro for flash sale ads. string required for carousel card assets optional
Description Description text displayed when your ad asset appears in content streams or in the other eligible native ad positions. Maximum 150 characters. Use {city}, {state}, {state_abbr}, {country} and {country_abbr} macros to add geo locations for user personalized ads. Use the {time} macro for flash sale ads. string required for carousel card assets optional
Ad Image URL For carousel card asset, a valid URL for a square image that will be displayed when your ad appears in content streams or in the other eligible native ad positions. The ideal image size is 627x627. The maximum size is 2MB. string required for carousel card assets optional
Ad HQ Image URL For a carousel card asset, a valid URL to a high resolution image that will be used. The ideal image size is 1200x627; smaller images will not be accepted. Larger images with either the same aspect ratio or with a height and width that are off the ideal dimensions by up to a combined 10% will be accepted as well as will be automatically cropped at the center. The maximum file size is 2MB. string required for carousel card assets optional
Status
The status of the ad asset. Valid values are:
  • Active

Ad assets are defaulted to Active if no status is provided upon creation.

enum optional optional
Ad Primary Video URL
For carousel card asset, a valid video URL.
  • Format: .mp4, .mp4v or .mov
  • Max File Size: 1GB
  • Min video length: 5sec
  • Max video length: 30sec (for App Install), 5min otherwise.
  • Min video quality: 480p 500kbps.
  • Min audio quality: If the video has audio, then it must have 2 channel stereo 64kbps.
string optional optional
Video Caption URL
Optional video caption file url to accompany the video url provided for carousel card asset. Maximum url length is 1024 characters. The technical requirements for captions are:
  • Format: .vtt or .srt
    • Maximum File Size: 1MB
    • Maximum 3 lines of text per caption time entry/stamp in the file.
string optional optional
Video Autoloop Optional video autoloop flag to accompany the video url provided for carousel card asset. If set to true, the video will autoloop continuously. boolean optional. Default:false optional
Call To Action Text Call to action buttons used to help drive users to take specific actions. The supported call-to-action text values are same as ones defined for Ads enum optional optional
Match Type
The type of ad asset. Valid values are:
  • MULTI_IMAGE (for carousel card asset with required image, required HQ image, and optional video)
enum required optional
Index Horizontal index ordering of assets. For carousel card assets (type=MULTI_IMAGE) the values must be unique for every active asset and must be between 0 and 4. Minimum 3 assets are required for carousel ads. Maximum 5 total assets. integer required for carousel card assets optional
Landing URL The landing URL associated with the asset. The landing URL is the web address that a user is sent to after clicking on the ad. Maximum limit is 2048 characters. The landing URL should include the tracking params provided by the tracking partner that was specified at the campaign level for app installs. Use {city}, {state}, {state_abbr}, {country} and {country_abbr} macros to add geo locations for user personalized ads. string required for carousal card assets optional