Ad Assets

You can create and manage additional ad assets, like carousel image 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. string required for carousel image 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. string required optional
Ad Image URL A valid URL for a thumbnail 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 image assets optional
Ad HQ Image URL A valid URL to a high resolution image that will be used in eligible native ad positions. 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 image 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 required optional
Call To Action Text Call to action buttons used to help drive users to take specific actions. enum optional optional
Match Type
The type of ad asset. Valid values are:
  • MULTI_IMAGE (for carousel ad image cards)
enum required optional
Index Index ordering of assets. For carousel image 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 image ad. integer required for carousel image assets optional
Landing URL The landing URL associated with the ad. 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. string required optional

Create an Ad Asset

The following example contains the fields required for creating an ad asset. All other fields in this spreadsheet are blank and are not shown:

Action Object Type Ad ID Title Description Ad Image URL Ad HQ Image URL Match Type Index Landing Url
Add Ad Asset 75614 Your Title Your asset’s description www.imageurl.com www.imagehqurl.com MULTI_IMAGE 0 www.landingurl.com

Update an Ad Asset

When updating an ad asset, the only required fields are Action, Object Type, Object ID and the fields you would like to update. The following example shows updating the title for an ad asset with an ID of 4201 under ad with ID 111. Other fields in this spreadsheet are blank and are not shown:

Action Object Type Object ID Ad ID Title
Update Ad Asset 4201 111 The new title for your ad asset.