The AdWords API will sunset on April 27, 2022. Migrate to the Google Ads API to take advantage of the latest Google Ads features.

Template Ads

This page lists the Display Ad Builder templates you can use to create ads using AdGroupAdService and the TemplateAd data type. Each of the listings below provides the template's ID, available dimensions, required template elements, and each element's required fields. Color fields must use #rrggbb format, and font fields are restricted to the list of supported fonts.

  1. name
    1. App engagement ad
    2. App install ad
    3. App reengagement ad
    4. Custom HTML5 app install
    5. Expandable video v. 1.0
    6. Gmail image template
    7. Gmail multi-product template
    8. Gmail single promotion template
    9. Image app engagement ad
    10. Image app install ad
    11. In-stream video ad
    12. In-video static image
    13. TrueView in-search video ad
    14. Uploaded HTML5 bundle
    15. Video app install ad
    16. YouTube promoted videos template on Google search
  1. category
    1. app_digital_content (8)
      1. App engagement ad
      2. App install ad
      3. App reengagement ad
      4. Custom HTML5 app install
      5. Image app engagement ad
      6. Image app install ad
      7. TrueView in-search video ad
      8. Video app install ad
    2. expandable (1)
      1. Expandable video v. 1.0
    3. gmail (3)
      1. Gmail image template
      2. Gmail multi-product template
      3. Gmail single promotion template
    4. specialized (1)
      1. Expandable video v. 1.0
    5. video (4)
      1. Expandable video v. 1.0
      2. In-stream video ad
      3. In-video static image
      4. YouTube promoted videos template on Google search
  2. format
    1. html5 (3)
      1. App engagement ad
      2. Custom HTML5 app install
      3. Uploaded HTML5 bundle
    2. image (2)
      1. Image app engagement ad
      2. Image app install ad
    3. partialSlot (3)
      1. Gmail image template
      2. Gmail multi-product template
      3. Gmail single promotion template
    4. text (4)
      1. App install ad
      2. App reengagement ad
      3. TrueView in-search video ad
      4. YouTube promoted videos template on Google search
    5. video (2)
      1. In-stream video ad
      2. Video app install ad
  3. interaction
    1. mouseover (4)
      1. Expandable video v. 1.0
      2. Gmail image template
      3. Gmail multi-product template
      4. Gmail single promotion template
    2. percentPlayed (3)
      1. Expandable video v. 1.0
      2. In-stream video ad
      3. In-video static image
    3. viewDetail (1)
      1. Expandable video v. 1.0

App engagement ad

Show app data alongside text to encourage app reengagment.

templateId 445
dimensions
  • 320x480
  • 320x50
templateElements
uniqueName adData
fields
name type Description
Layout
layout
Required
 ENUM
Optimized, dark, light, Custom
 Different layout options for app promotion.
  • Optimized: Optimized (default)
  • dark: Dark
  • light: Light
  • Custom: Custom layout
App store
appStore
Required
 ENUM
1, 2
  • : Select an app store (default)
  • 1: Apple App Store
  • 2: Google Play
App ID
appId
Required
 TEXT
Headline and description
promoHeadline
Required
 TEXT
promoDescription
Required
 TEXT
Call-to-action
callToActionOpen
Required
 TEXT The text shown on a button inviting the user to open the app.

App install ad

Show your app icon alongside ad text to encourage downloads.

templateId 353
templateElements
uniqueName adData
fields
name type Description
App store
appStore ENUM
1, 2, 3, 4
  • : Select an app store (default)
  • 1: Apple App Store
  • 2: Google Play
  • 3: Windows store
  • 4: Windows Phone store
App ID
appId TEXT
Headline and description
headline TEXT
description1 TEXT
description2 TEXT
App image icons
appIconStandard IMAGE
50KB max
jpg, png
 Standard app image icon from Google Play or App Store or uploaded by app promoters
appIconHighRes IMAGE
500KB max
jpg, png
 High resolution app image icon from Google Play or App Store or uploaded by app promoters
App name
appName TEXT
Promotion text
creativeText TEXT
Landscape image
landscapeImage IMAGE
1.91:1
600x314 min
1024KB max
jpg, png
 Supported image sizes, width by height: Aspect ratio 1.91:1, Min. 600px by 314px.

App reengagement ad

Encourage users who have downloaded your app to reengage with your app.

templateId 453
templateElements
uniqueName adData
fields
name type Description
App store
appStore ENUM
1, 2
  • : Select an app store (default)
  • 1: iTunes App Store
  • 2: Google Play
App ID
appId TEXT
Headline and description
headline TEXT
description1 TEXT
description2 TEXT

Custom HTML5 app install

Show app data alongside text to encourage users to install an app.

templateId 442
dimensions
  • 320x480
  • 320x50
templateElements
uniqueName adData
fields
name type Description
Layout
layout
Required
 ENUM
Custom
 Different layout options for app promotion.
  • Custom: Custom layout (default)
App store
appStore ENUM
1, 2
  • : Select an app store (default)
  • 1: Apple App Store
  • 2: Google Play
App ID
appId TEXT
Headline and description
promoHeadline TEXT
promoDescription TEXT
Call-to-action
callToAction
Required
 TEXT The text shown on a button inviting the user to install the app.

Expandable video v. 1.0

templateId 247
dimensions
  • 120x600
  • 160x600
  • 300x250
  • 336x280
  • 468x60
  • 728x90
templateElements
uniqueName adData
fields
name type Description
Poster image
poster
Required
 BACKGROUND_IMAGE
200KB max
jpg, png, gif
Note: The play button will click to start the video after it is saved and deployed.
Play button
playBtn IMAGE
140x112 max
50KB max
jpg, png, gif
Video
video
Required
 VIDEO

Gmail image template

templateId 459
templateElements
uniqueName adData
fields
name type Description
Logo
logo
Required
 IMAGE
150KB max
jpg, png, gif
 Upload up to 144px x 144px
Advertiser
advertiser
Required
 TEXT
15 char max
Subject
subject
Required
 TEXT
25 char max
Description
description
Required
 TEXT
100 char max
Image
image
Required
 IMAGE
650x1000 max
800KB max
jpg, png, gif
 Upload 650px x [300px to 1000px]
Layout
layout ENUM
gmail_image_ad_v1
  • gmail_image_ad_v1: Gmail image ad v. 1.0 (default)

Gmail multi-product template

To specify button upgraded URLs, populate the urlData of the TemplateAd and use the following urlId values:

  • product_0_buttonUrl
  • product_1_buttonUrl
  • product_2_buttonUrl
  • product_3_buttonUrl
  • product_4_buttonUrl
  • product_5_buttonUrl
templateId 466
templateElements
uniqueName adData
fields
name type Description
Logo
logo
Required
 IMAGE
150KB max
jpg, png, gif
 Upload up to 144px x 144px
Advertiser
advertiser
Required
 TEXT
15 char max
Subject
subject
Required
 TEXT
25 char max
Description
description
Required
 TEXT
100 char max
Item 0 - Image
product_0_image IMAGE
180x180 max
150KB max
jpg, png, gif
 Upload 180px x 180px
Item 0 - Title
product_0_title TEXT
40 char max
product_0_titleColor ENUM
#rrggbb
  • #000000 (default)
Item 0 - Call-to-action button
product_0_buttonText TEXT
20 char max
product_0_buttonTextColor ENUM
#rrggbb
  • #FFFFFF (default)
product_0_buttonColor ENUM
#rrggbb
  • #4486F8 (default)
Item 1
Item 2
Item 3
Item 4
Item 5
Header
header IMAGE
630x200 max
150KB max
jpg, png, gif
 Upload 630px x [50px to 200px]
Headline
headline TEXT
25 char max
headlineTextColor ENUM
#rrggbb
  • #4486F9 (default)
Content
content TEXT
1024 char max
Layout
layout ENUM
gmail_multi_product_ad_v1
  • gmail_multi_product_ad_v1: Gmail multi-product ad v. 1.0 (default)

Gmail single promotion template

templateId 464
templateElements
uniqueName adData
fields
name type Description
Logo
logo
Required
 IMAGE
150KB max
jpg, png, gif
 Upload up to 144px x 144px
Advertiser
advertiser
Required
 TEXT
15 char max
Subject
subject
Required
 TEXT
25 char max
Description
description
Required
 TEXT
100 char max
Image
image IMAGE
300x500 max
150KB max
jpg, png, gif
 Upload 300px [200px to 500px]
Headline
headline TEXT
25 char max
headlineTextColor ENUM
#rrggbb
  • #4486F9 (default)
Content
content TEXT
1024 char max
Call-to-action button
callToActionButton1
Required
 TEXT
20 char max
callToActionButton1TextColor ENUM
#rrggbb
  • #FFFFFF (default)
callToActionButton1ButtonColor ENUM
#rrggbb
  • #4486F8 (default)
Call-to-action button URL
callToActionUrl1
Required
 URL
1024 char max
Header
header IMAGE
630x200 max
150KB max
jpg, png, gif
 Upload 630px x [50px to 200px]
Layout
layout ENUM
gmail_single_promotion_ad_v1
  • gmail_single_promotion_ad_v1: Gmail single promotion ad v. 1.0 (default)

Image app engagement ad

Promote your app with an image banner to encourage app reengagement.

templateId 455
dimensions
  • 1024x768
  • 1024x90
  • 120x600
  • 160x600
  • 200x200
  • 240x400
  • 250x250
  • 250x360
  • 300x1050
  • 300x250
  • 300x50
  • 300x600
  • 320x100
  • 320x480
  • 320x50
  • 336x280
  • 425x600
  • 468x60
  • 480x32
  • 480x320
  • 580x400
  • 728x90
  • 768x1024
  • 930x180
  • 970x250
  • 970x90
  • 980x120
templateElements
uniqueName adData
fields
name type Description
App store
appStore ENUM
1, 2, 3, 4
  • : Select an app store (default)
  • 1: Apple App Store
  • 2: Google Play
  • 3: Windows store
  • 4: Windows Phone store
App ID
appId TEXT

Image app install ad

Promote your app with an image banner to encourage downloads.

templateId 432
dimensions
  • 1024x768
  • 1024x90
  • 120x600
  • 160x600
  • 200x200
  • 240x400
  • 250x250
  • 250x360
  • 300x1050
  • 300x250
  • 300x50
  • 300x600
  • 320x100
  • 320x480
  • 320x50
  • 336x280
  • 425x600
  • 468x60
  • 480x32
  • 480x320
  • 580x400
  • 728x90
  • 768x1024
  • 930x180
  • 970x250
  • 970x90
  • 980x120
templateElements
uniqueName adData
fields
name type Description
App store
appStore ENUM
1, 2, 3, 4
  • : Select an app store (default)
  • 1: Apple App Store
  • 2: Google Play
  • 3: Windows store
  • 4: Windows Phone store
App ID
appId TEXT

In-stream video ad

Non-skippable 15 or 20 second video ad within video publisher content.

templateId 49
templateElements
uniqueName adData
fields
name type Description
Video
video
Required
 VIDEO This video ad will appear inside a video player, within video content on Display Network sites. Standard video ad slot play lengths are 15 and 20 seconds long, so your videos should be shorter in playing time than 15 or 20 seconds, respectively.
Companion banner
companionBanner IMAGE
50KB max
jpg, png, gif, swf
 This is a banner image size of 300x60 (YouTube) and 300x250 (other video sites). It may appear with your video ad where publishers allow companion banner images.

In-video static image

Place an InVideo image overlay with an image companion on YouTube and sites on the Google Video Network.

templateId 178
dimensions
  • 480x70
templateElements
uniqueName adData
fields
name type Description
In-video overlay
teaserImage
Required
 IMAGE
480x70 max
50KB max
jpg, png, gif
 This will render as a banner ad overlaid on the bottom of the video.
Companion banner
companionBanner250 IMAGE
300x250 max
50KB max
jpg, png, gif, swf
 This is a 300x250 banner image. It may accompany your video ad on sites that allow companion banner images of this size to appear with videos.

Promote your YouTube videos on the YouTube search network.

templateId 231
templateElements
uniqueName adData
fields
name type Description
Headline and description
headline
Required
 TEXT
description1 TEXT
description2 TEXT
YouTube video
videoId
Required
 VIDEO Select the video you want to promote.
Video thumbnail
videoThumbnail ENUM
0, 1, 2, 3
 Choose which video thumbnail you want to appear with the ad. This is an alternate means to select the image url.
  • 0: Default (default)
  • 1: Thumbnail 1
  • 2: Thumbnail 2
  • 3: Thumbnail 3
Destination page
destinationPage ENUM
1, 2
 Your ad can take users either to a standard YouTube video watch page or to your YouTube channel page to view the selected video.
  • 1: Play on watch page (default)
  • 2: Play on channel page
Channel name
channelName
Required
 TEXT
24 char max
 This is the name of the YouTube channel, for example 'Google' for the youtube.com/Google channel.
Image URL
imageUrl
Required
 URL The url of a thumbnail to display alongside the ad text.

Uploaded HTML5 bundle

You must apply for HTML5 access for each account before it can use this template ad type.

templateId 419
dimensions
  • 1024x768
  • 1024x90
  • 120x600
  • 160x600
  • 200x200
  • 240x400
  • 250x250
  • 250x360
  • 300x1050
  • 300x250
  • 300x50
  • 300x600
  • 320x100
  • 320x480
  • 320x50
  • 336x280
  • 425x600
  • 468x60
  • 480x32
  • 480x320
  • 580x400
  • 728x90
  • 750x100
  • 750x200
  • 750x300
  • 768x1024
  • 930x180
  • 970x250
  • 970x90
  • 980x120
templateElements
uniqueName adData
fields
name type Description
Upload bundle
Custom_layout
Required
 MEDIA_BUNDLE
150KB max
html5adzip
Template layout
layout
Required
 ENUM
Custom

Video app install ad

Show your video to encourage app downloads.

templateId 433
templateElements
uniqueName adData
fields
name type Description
App store
appStore ENUM
1, 2
  • : Select an app store (default)
  • 1: Apple App Store
  • 2: Google Play
App ID
appId TEXT
Headline and description
headline
Required
 TEXT
description
Required
 TEXT
Close button delay (seconds)
skippableSeconds NUMBER
Video
video
Required
 VIDEO This video will be auto-played

YouTube promoted videos template on Google search

Use this template to promote your YouTube videos on google.com.

templateId 266
templateElements
uniqueName adData
fields
name type Description
YouTube video
videoId
Required
 VIDEO Select the video you want to promote.
Video thumbnail
videoThumbnail ENUM
0, 1, 2, 3
 Choose which video thumbnail you want to appear with the ad. This is an alternate means to select the image url.
  • 0: Default (default)
  • 1: Thumbnail 1
  • 2: Thumbnail 2
  • 3: Thumbnail 3
Destination page
destinationPage ENUM
1, 2
 Your ad can take users either to a standard YouTube video watch page or to your YouTube channel page to view the selected video.
  • 1: Play on watch page (default)
  • 2: Play on channel page

Supported Fonts

  • amasisblack
  • arial
  • arialblack
  • arialn
  • arialuni
  • arialuni_t
  • ascenderserif
  • baskerville
  • batang_Batang
  • batang_BatangChe
  • bod_r
  • comic
  • corps_l
  • courier
  • eurostyle_m
  • felttiproman_b
  • franklingothic_h
  • franklingothic_m
  • futura_b
  • futura_m
  • futurabc
  • futurabooc
  • gautami
  • georgia
  • gill
  • gill_b
  • gulim_Dotum
  • gulim_DotumChe
  • gulim_Gulim
  • gulim_GulimChe
  • impact
  • kartika
  • latha
  • mangal
  • mingliu_MingLiU
  • mingliu_PMingLiU
  • msgothic_MS_Gothic
  • msgothic_MS_PGothic
  • msmincho_MS_Mincho
  • msmincho_MS_PMincho
  • newsgothic
  • nimbus_b
  • nimbus_l
  • raavi
  • shruti
  • simhei
  • simsun
  • simsunb
  • tahoma
  • times
  • trebuc
  • tunga
  • verdana
  • vrinda