DPA Templates

Use DPA templates if you wish to customize your product ad fields with macros. By using macros, you can enhance the look of your product ad and extend its functionality.


Operations to retrieve data for product ads are the same as for the Ad Object. The DPA template is an Ad with special rules, and is intended for shopping campaigns only. Bulk operations for DPA templates are the same as for the Ad object.


DPA templates contain the following fields:

Field name Description
title The title of the Product Ad template. For example, you can use macros, like {title} with {price}. When the ad displays on the device, the macros will be replaced with the actual product ad title and price.
description The description of the Product Ad template, using a macro to customize the description of the product ad.
sponsoredBy The sponsorBy of the Product Ad template, using a macro to customize the sponsorBy of the product ad.
landingUrl The landing page URL of the Product Ad template, using a macro to customize the landing page URL of the product ad.
customParameters A list of key-value pairs that are appended one by one to your landingUrl. For example:
    "key": "src_param",
    "value": "gemini_dpa"
    "key": "trackingid",
    "value": "123"
    "key": "cid",
    "value": "556677"


You can only create a single DPA template under one DPA ad group.


When you create a DPA template, you must specify at least one field. Leave all the fields that you don’t want to customize as empty. Note that if you’re using the template for landingUrl, custom parameters won’t be applied. In other words, if you want to use custom parameters, don’t use the landingUrl template.

Supported Macros

The following list includes the supported macros for DPA templates:

  • {title}
  • {description}
  • {price}
  • {availability}
  • {brand}
  • {id}
  • {link}
  • {adgroupid}
  • {campaignid}
  • {advertiserid}
  • {sponsoredBy}


Resource URI


DPA Example Template

The following is an example of a DPA template with the landingUrl and impressionTrackingUrls fields specified.

  "adGroupId": 9583202006,
  "campaignId": 361307005,
  "advertiserId": 88922,
  "sponsoredBy": "Sandboxes Inc",
  "status": "ACTIVE",
  "landingUrl": "https://www.clicktrackingredirectdomain.com/?{link}",
  "impressionTrackingUrls": {

Use impressionTrackingUrls

To set third-party impression tracking for your ads, use impressionTrackingUrls. Ensure that the impression parameter adheres to the requirements specified in the field description table below.

For example:

"impressionTrackingUrls": {
      "impression": ["https: //www.impression.com"], // maximum 3 comma-separated impression URLs

impressionTrackingUrls Fields

Field Description Required?

Supported third-party impression tracking URLs:

  • Must be an image tag
  • Must be secure (SSL)
  • Cannot include redirect
  • Cannot include macros other than [timestamp]

Up to 3 impression URLs are supported per ad.



You’ll need to add square brackets [ ] around the impression URL because you have the option of adding up to 3 impression URLs, each separated by commas.


When an ad is displayed, a Pixel/URL in the impressionTrackingUrl field’s impression are fired. This allows 3rd parties to track when an ad is served and to track post-impression conversions. If you fire your own 3rd party impression pixel, it should line up closely with the impressions column in reporting. Post-impressions conversions are provided as a column in reports, but not in the UI.

Click Tracking

If you wish to insert impression tracking and click tracking, you’ll need to apply click tracking with the redirect domain specified in the landingURL field. You can apply impression tracking in the impressionTrackingURLs field shown below.

For example:

"landingUrl": "https://www.clicktrackingredirectdomain.com/?{link}",
"impressionTrackingUrls": {