Hide
AdWords API

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. Expandable video v. 1.0
    5. HTML5 app promo ad
    6. Image app engagement ad
    7. Image app install ad
    8. In-stream video ad
    9. In-video static image
    10. TrueView in-search video ad
    11. Video app install ad
    12. YouTube promoted videos template
    13. 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. HTML5 app promo ad
      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. specialized (1)
      1. Expandable video v. 1.0
    4. 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. HTML5 app promo ad
    3. image (2)
      1. Image app engagement ad
      2. Image app install ad
    4. 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
    5. video (2)
      1. In-stream video ad
      2. Video app install ad
  3. interaction
    1. mouseover (1)
      1. Expandable video v. 1.0
    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. HTML5 app promo ad
      3. Image app engagement ad
      4. Image app install ad
    15. 320x50 (4)
      1. App engagement ad
      2. HTML5 app promo ad
      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. Whitelist sign up.

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 TEXT
promoDescription TEXT
Call-to-action
callToActionOpen
Required
TEXT The text shown on a button inviting the user to open the app.

Back to top

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

Back to top

App reengagement ad

Encourage users who have downloaded your app to reengage with your app. Whitelist sign up.

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

Back to top

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

Back to top

HTML5 app promo ad

Show app data alongside text to encourage users to install an app. Whitelist sign up.

templateId 442
dimensions
  • 320x480
  • 320x50
templateElements
uniqueName adData
fields
name type Description
Layout
layout
Required
ENUM
Optimized, dark, Custom
Different layout options for app promotion.
  • Optimized: Optimized layout
  • dark: Dark layout (default)
  • 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 TEXT
promoDescription TEXT
Call-to-action
callToAction
Required
TEXT The text shown on a button inviting the user to install the app.

Back to top

Image app engagement ad

Promote your app with an image banner to encourage app reengagement. Whitelist sign up.

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

Back to top

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

Back to top

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.

Back to top

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.

Back to top

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

Back to top

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

Back to top

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

Back to top

YouTube promoted videos template on Google search

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

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

Back to top

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

Back to top