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.
App engagement ad
Show app data alongside text to encourage app reengagment.
templateId
|
445 |
dimensions
|
|
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
|
|
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
|
|
Item 0 - Call-to-action button
|
product_0_buttonText
|
TEXT
20 char max
|
product_0_buttonTextColor
|
ENUM
#rrggbb
|
|
product_0_buttonColor
|
ENUM
#rrggbb
|
|
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
|
|
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)
|
|
|
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
|
|
Content
|
content
|
TEXT
1024 char max
|
Call-to-action button
|
callToActionButton1
Required
|
TEXT
20 char max
|
callToActionButton1TextColor
|
ENUM
#rrggbb
|
|
callToActionButton1ButtonColor
|
ENUM
#rrggbb
|
|
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
|
|
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.
|
|
|
TrueView in-search video ad
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