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 promotion ad
    2. App promotion image ad
    3. Click to play video
    4. Expandable video v1.0
    5. In-stream video ad
    6. In-video static image
    7. TrueView in-display video ad
    8. YouTube promoted videos template
  1. category
    1. app_digital_content (2)
      1. App promotion ad
      2. App promotion image ad
    2. expandable (1)
      1. Expandable video v1.0
    3. specialized (1)
      1. Expandable video v1.0
    4. video (6)
      1. Click to play video
      2. Expandable video v1.0
      3. In-stream video ad
      4. In-video static image
      5. TrueView in-display video ad
      6. YouTube promoted videos template
  2. format
    1. flash (3)
      1. Click to play video
      2. Expandable video v1.0
      3. In-video static image
    2. image (1)
      1. App promotion image ad
    3. text (3)
      1. App promotion ad
      2. TrueView in-display video ad
      3. YouTube promoted videos template
    4. video (1)
      1. In-stream video ad
  3. interaction
    1. mouseover (2)
      1. Click to play video
      2. Expandable video v1.0
    2. percentPlayed (4)
      1. Click to play video
      2. Expandable video v1.0
      3. In-stream video ad
      4. In-video static image
    3. play (1)
      1. Click to play video
    4. viewDetail (2)
      1. Click to play video
      2. Expandable video v1.0
  4. size
    1. 1024x768 (1)
      1. App promotion image ad
    2. 1024x90 (1)
      1. App promotion image ad
    3. 120x600 (2)
      1. App promotion image ad
      2. Expandable video v1.0
    4. 160x600 (2)
      1. App promotion image ad
      2. Expandable video v1.0
    5. 200x200 (1)
      1. App promotion image ad
    6. 240x400 (1)
      1. App promotion image ad
    7. 250x250 (1)
      1. App promotion image ad
    8. 250x360 (1)
      1. App promotion image ad
    9. 300x1050 (1)
      1. App promotion image ad
    10. 300x250 (3)
      1. App promotion image ad
      2. Click to play video
      3. Expandable video v1.0
    11. 300x50 (1)
      1. App promotion image ad
    12. 300x600 (1)
      1. App promotion image ad
    13. 320x480 (1)
      1. App promotion image ad
    14. 320x50 (1)
      1. App promotion image ad
    15. 336x280 (3)
      1. App promotion image ad
      2. Click to play video
      3. Expandable video v1.0
    16. 425x600 (1)
      1. App promotion image ad
    17. 468x60 (2)
      1. App promotion image ad
      2. Expandable video v1.0
    18. 480x32 (1)
      1. App promotion image ad
    19. 480x320 (1)
      1. App promotion image ad
    20. 480x70 (1)
      1. In-video static image
    21. 580x400 (1)
      1. App promotion image ad
    22. 728x90 (2)
      1. App promotion image ad
      2. Expandable video v1.0
    23. 768x1024 (1)
      1. App promotion image ad
    24. 930x180 (1)
      1. App promotion image ad
    25. 970x250 (1)
      1. App promotion image ad
    26. 970x90 (1)
      1. App promotion image ad
    27. 980x120 (1)
      1. App promotion image ad
  5. urlType
    1. COMPLETE_BEACON_URL (2)
      1. TrueView in-display video ad
      2. YouTube promoted videos template
    2. ENGAGED_VIEW_BEACON_URL (2)
      1. TrueView in-display video ad
      2. YouTube promoted videos template
    3. FIRST_QUARTILE_BEACON_URL (2)
      1. TrueView in-display video ad
      2. YouTube promoted videos template
    4. IMPRESSION_BEACON_URL (2)
      1. TrueView in-display video ad
      2. YouTube promoted videos template
    5. MIDPOINT_BEACON_URL (2)
      1. TrueView in-display video ad
      2. YouTube promoted videos template
    6. THIRD_QUARTILE_BEACON_URL (2)
      1. TrueView in-display video ad
      2. YouTube promoted videos template
    7. VAST2_TRACKING_XML_URL (1)
      1. In-stream video ad

App promotion 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: iTunes 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 promotion image 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
  • 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: iTunes App Store
  • 2: Google Play
  • 3: Windows store
  • 4: Windows Phone store
App ID
appId TEXT

Back to top

Click to play video

Use this template to create a click to play video creative.

templateId 9
dimensions
  • 300x250
  • 336x280
templateElements
uniqueName adData
fields
name type Description
Starting image
startImage
Required
IMAGE
336x255 max
50KB max
jpg, png, gif
This image will be displayed before the video plays.
Ending image
endImage IMAGE
336x255 max
50KB max
jpg, png, gif
This image will be displayed after the video ends. If no image is provided, the starting image will be used.
Video
video
Required
VIDEO This video will play when the starting image is clicked.

Back to top

Expandable video v1.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

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

TrueView in-display video ad

Promote your YouTube videos on YouTube, non-search content pages and on the Google Display Network. Currently available in selected countries.

templateId 232
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

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

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

Authentication required

You need to be signed in with Google+ to do that.

Signing you in...

Google Developers needs your permission to do that.