AdWords API
Hide

Template Ads

This appendix 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 custom HTML upload
    7. Gmail image template
    8. Gmail multi-product template
    9. Gmail single promotion template
    10. Image app engagement ad
    11. Image app install ad
    12. In-stream video ad
    13. In-video static image
    14. TrueView in-search video ad
    15. Video app install ad
    16. YouTube promoted videos template
    17. 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 (4)
      1. Gmail custom HTML upload
      2. Gmail image template
      3. Gmail multi-product template
      4. Gmail single promotion template
    4. specialized (1)
      1. Expandable video v. 1.0
    5. video (5)
      1. Expandable video v. 1.0
      2. In-stream video ad
      3. In-video static image
      4. YouTube promoted videos template
      5. YouTube promoted videos template on Google search
  2. format
    1. flash (2)
      1. Expandable video v. 1.0
      2. In-video static image
    2. html5 (2)
      1. App engagement ad
      2. Custom HTML5 app install
    3. image (2)
      1. Image app engagement ad
      2. Image app install ad
    4. partialSlot (4)
      1. Gmail custom HTML upload
      2. Gmail image template
      3. Gmail multi-product template
      4. Gmail single promotion template
    5. text (5)
      1. App install ad
      2. App reengagement ad
      3. TrueView in-search video ad
      4. YouTube promoted videos template
      5. YouTube promoted videos template on Google search
    6. video (2)
      1. In-stream video ad
      2. Video app install ad
  3. interaction
    1. mouseover (5)
      1. Expandable video v. 1.0
      2. Gmail custom HTML upload
      3. Gmail image template
      4. Gmail multi-product template
      5. 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
  4. size
    1. 1024x768 (2)
      1. Image app engagement ad
      2. Image app install ad
    2. 1024x90 (2)
      1. Image app engagement ad
      2. Image app install ad
    3. 120x600 (3)
      1. Expandable video v. 1.0
      2. Image app engagement ad
      3. Image app install ad
    4. 160x600 (3)
      1. Expandable video v. 1.0
      2. Image app engagement ad
      3. Image app install ad
    5. 200x200 (2)
      1. Image app engagement ad
      2. Image app install ad
    6. 240x400 (2)
      1. Image app engagement ad
      2. Image app install ad
    7. 250x250 (2)
      1. Image app engagement ad
      2. Image app install ad
    8. 250x360 (2)
      1. Image app engagement ad
      2. Image app install ad
    9. 300x1050 (2)
      1. Image app engagement ad
      2. Image app install ad
    10. 300x250 (3)
      1. Expandable video v. 1.0
      2. Image app engagement ad
      3. Image app install ad
    11. 300x50 (2)
      1. Image app engagement ad
      2. Image app install ad
    12. 300x600 (2)
      1. Image app engagement ad
      2. Image app install ad
    13. 320x100 (2)
      1. Image app engagement ad
      2. Image app install ad
    14. 320x480 (4)
      1. App engagement ad
      2. Custom HTML5 app install
      3. Image app engagement ad
      4. Image app install ad
    15. 320x50 (4)
      1. App engagement ad
      2. Custom HTML5 app install
      3. Image app engagement ad
      4. Image app install ad
    16. 336x280 (3)
      1. Expandable video v. 1.0
      2. Image app engagement ad
      3. Image app install ad
    17. 425x600 (2)
      1. Image app engagement ad
      2. Image app install ad
    18. 468x60 (3)
      1. Expandable video v. 1.0
      2. Image app engagement ad
      3. Image app install ad
    19. 480x32 (2)
      1. Image app engagement ad
      2. Image app install ad
    20. 480x320 (2)
      1. Image app engagement ad
      2. Image app install ad
    21. 480x70 (1)
      1. In-video static image
    22. 580x400 (2)
      1. Image app engagement ad
      2. Image app install ad
    23. 728x90 (3)
      1. Expandable video v. 1.0
      2. Image app engagement ad
      3. Image app install ad
    24. 768x1024 (2)
      1. Image app engagement ad
      2. Image app install ad
    25. 930x180 (2)
      1. Image app engagement ad
      2. Image app install ad
    26. 970x250 (2)
      1. Image app engagement ad
      2. Image app install ad
    27. 970x90 (2)
      1. Image app engagement ad
      2. Image app install ad
    28. 980x120 (2)
      1. Image app engagement ad
      2. Image app install ad
  5. urlType
    1. COMPLETE_BEACON_URL (3)
      1. TrueView in-search video ad
      2. YouTube promoted videos template
      3. YouTube promoted videos template on Google search
    2. ENGAGED_VIEW_BEACON_URL (3)
      1. TrueView in-search video ad
      2. YouTube promoted videos template
      3. YouTube promoted videos template on Google search
    3. FIRST_QUARTILE_BEACON_URL (3)
      1. TrueView in-search video ad
      2. YouTube promoted videos template
      3. YouTube promoted videos template on Google search
    4. IMPRESSION_BEACON_URL (3)
      1. TrueView in-search video ad
      2. YouTube promoted videos template
      3. YouTube promoted videos template on Google search
    5. MIDPOINT_BEACON_URL (3)
      1. TrueView in-search video ad
      2. YouTube promoted videos template
      3. YouTube promoted videos template on Google search
    6. THIRD_QUARTILE_BEACON_URL (3)
      1. TrueView in-search video ad
      2. YouTube promoted videos template
      3. YouTube promoted videos template on Google search
    7. VAST2_TRACKING_XML_URL (1)
      1. In-stream video ad

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 ENUM
1, 2
  • : Select an app store (default)
  • 1: Apple App Store
  • 2: Google Play
App ID
appId 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

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 custom HTML upload

templateId 486
templateElements
uniqueName adData
fields
name type Description
Custom HTML uploader
Custom_layout
Required
 IMAGE
1250KB max
gmailadzip

Gmail image template

templateId 459
templateElements
uniqueName adData
fields
name type Description
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

templateId 466
templateElements
uniqueName adData
fields
name type Description
Item
Item
Item
Item
Item
Item
Advanced customization
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
Advanced customization
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
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
Advanced fields

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

Note: This template is going away soon, and will be replaced by TrueView In-Search and In-Display ad templates.

templateId 13
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
Advanced fields

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
Advanced fields

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

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 3.0 License, and code samples are licensed under the Apache 2.0 License. For details, see our Site Policies.

Send feedback about...

This page
Documentation feedback
AdWords API
Product feedback