Ads

You can create and manage ads, using these fields.

Fields

The following fields are available for creating and managing ads:

Name Description Type Add Update
Campaign ID The ID of the campaign associated with the ad. long required optional
Ad Group ID The ID of the ad group associated with the ad. long required optional
Object ID The ID of the ad. long N/A required
Description Description text displayed when your ad appears in content streams or in the other eligible native ad positions. Maximum 150 characters. string required optional
Ad Name An optional name or tag given to the ad. Maximum limit of 255 characters. string optional optional
Title Title text when your ad appears in content streams or in the other eligible native ad positions. Maximum limit is 50 characters. string required optional
Title 2 Additional title text for search and search on native ads. If you use Title + Title 2, the maximum limit is 30 characters for each line. Title 2 for standard Native only campaigns is not supported at this time. string required optional
Display URL The user-friendly URL displayed to the user. Maximum limit is 35 characters. long required 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
Impression Tracking URL Supported third-party impression tracking URL. string optional optional
Mail Asset URL A URL to a high-resolution image for a mail sponsored ad. This can only run on VISIT_WEB and CPC price type. Note also that the image can only be a 2MB JPEG, PNG or GIF image. string Optional Optional
Ad Thumbnail Image Url A URL to a high-resolution image for an ad. The original image will be scaled to 180 x 180 pixels and can only be a JPEG, PNG or GIF image. string Optional Optional
Sponsored By The string shown against the sponsored by label in the ad. This field is not shown for ads that run on mobile search, but is still a required input when creating any text ad. Maximum limit is 35 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 82x82. The maximum size is 2MB. Note: This is required for Video Ads running as PromoteBrand or AppInstall campaigns. For video ads, the image size should be large image (627 x 627). string optional 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. Note: This is required for app installs. string optional optional
Ad Primary Video URL

A valid URL for video ads that will be used in eligible native ad positions. This can be directly uploaded via Bulk by passing the URL location which Gemini will parse and upload to the Gemini ad system. Note: This is required for Video Ads running as PromoteBrand or AppInstall campaigns. The technical requirements for video are:

  • Formats: .mp4 .m4v or .mov
  • File Size: 1GB maximum
  • Duration: 5 seconds minimum, 30 seconds maximum for App Install campaigns, 5 minutes maximum for Promote Brand campaigns
  • Aspect Ratio: Minimum 480x360p (4:3) or 480x270 (16:9). Recommended 640x480 (4:3) or 640x360 (16:9)
  • Video Bitrate: 300kbps. Recommended 500kbps.
  • Audio Quality: If the video has audio, then it must have 2 channel stereo and minimum 32kbps. Recommended 64kbps.
string optional optional
Status

The status of the ad. Valid values are:

  • Active
  • Paused

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

enum optional optional
         
Call To Action Text

Call to action buttons used to help drive users to take specific actions. Currently only English language campaigns are supported from bulk. The following are the supported call-to-action text values:

  • Apply Now
  • Bet Now
  • Book Now
  • Buy Now
  • Compare
  • Contact Us
  • Directions
  • Donate Now
  • Download
  • Enroll Now
  • Follow Now
  • Get App
  • Get Coupon
  • Get Now
  • Get Offer
  • Get Quote
  • Get Rates
  • Get Sample
  • Install
  • Join Now
  • Launch
  • Learn More
  • Listen Now
  • Play Now
  • Play Game
  • Read More
  • Record Now
  • Register
  • Remind Me
  • Save Now
  • Sell Now
  • Shop Now
  • Sign Up
  • Subscribe
  • Try Now
  • Use App
  • Vote Now
  • Watch Now
  • Watch More
enum optional optional
Video Completed View Tracking URL Applies only to INSTALL_APP video ads and tracks when your video was played to 100% of its length. Only one Video Completed View Tracking URL is supported per ad. string optional optional
Video Click Tracking URL Applies only to INSTALL_APP video ads and tracks when the install button was clicked. Only one Video Click Tracking URL is supported per ad. string optional optional
Ad Thumbnail Image URL A URL to a high-resolution image for an ad. The original image will be scaled to 180 x 180 pixels and can only be a JPEG, PNG or GIF image. string optional optional
Video Caption URL

Optional video caption file url to accompany the video url provided for video ads. Maximum url length is 1024 characters. The technical requirements for captions are:

  • Formats: .vtt or .srt
  • Maximum File Size: 1MB
  • Maximum 3 lines of text per caption time entry/stamp in the file.
string optional optional
Tumblr Post URL If you have a Tumblr post you would like to associate with your ad, you can provide a valid post URL using this field. Doing this will make your ad eligible to run on Tumblr. string optional optional

Create an Ad

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

Action Object Type Campaign ID Ad Group ID Title Description Display URL Landing URL Sponsored By
Add Ad 75614 564 Your Title Your ad’s description www.displayurl.com www.landingurl.com Company Name

Update an Ad

When updating an ad, 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 with an ID of 4201 other fields in this spreadsheet are blank and are not shown:

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