Use conversion tracking to validate your shipping data

This feature is currently only available to merchants that target products to the United States.

How it works

Before you can show free and fast shipping annotations on eligible products, Merchant Center must validate your site’s data to ensure that the shipping information shown in your ads is accurate. After your data has initially been validated, Merchant Center will continue to validate it to make sure your free and fast annotation stays up to date.

Currently, the default method Google uses to validate your shipping data for free and fast annotations is to crawl your website. For free and fast annotations on ads, you can also provide accurate and up-to-date validation data with Google Ads conversion tracking. If conversion tracking is connected to your store’s conversion data, Merchant Center can automatically validate your free and fast shipping data, potentially minimizing the need for it to crawl your store’s site.

Requirements

In order to use conversion tracking to validate your shipping data:

Instructions

Note: These steps are technically complex. If you’re not very familiar with code, consider contacting a web developer or someone with similar skills before starting this process.

There are 2 ways to use conversion tracking to validate your shipping data. You can either use Google Tag Manager or update your gtag.js.

Install with Google Tag Manager

Step 1: Install Google Tag Manager

Note: If you’re already using Google Tag Manager, move to Step 2.
  1. Sign in to your Google Ads account.
  2. In the upper right corner, click the tools icon Google Ads | tools [Icon].
  3. From the “Measurement” drop-down menu, click Conversions.
  4. Click the conversion action that you want to use, or create a new conversion action.
  5. Install Google Tag Manager on your site. Learn how to set up your conversion tracking tag.

Step 2: Add shipping data to your Google Ads conversion tracking tag

To add shipping data to your Google Ads conversion tracking tag, follow these steps:

  1. Select the conversion tag you would like to pass the cart information to in Google Tag Manager.
  2. Check the "Provide product-level sales data" box and select either "Data Layer" or "Custom Fields". If you select "Custom Fields", fill out the required fields.
  3. Check the "Provide shipping data" box and fill out the required fields.
  4. The variables below must be added on the checkout page to be referenced.
Required Parameters Definition
Delivery date (per order) “estimated_delivery_date”

The latest (or “max”) promised delivery date for an order in a customer’s cart data. For orders with products that are under consideration for free and fast (new or maintain status), Google uses this date to validate shipping speed.

Note: This parameter uses the international date format (YYYY-MM-DD). The date you submit here should be based on the date and time zone of the location you submitted for the delivery_postal_code.
Delivery date (per item) “items[].estminated_delivery_date”

The latest (or “max”) promised delivery date for an item. Use this parameter if you want to override the estimated delivery date for a particular item within an order. For products that are under consideration for free and fast (new or maintain status), Google uses this date to validate shipping speed.

Note: This parameter uses the international date format (YYYY-MM-DD).

Postal code (per order) “delivery_postal_code”

The regional prefix, or designation portion, of a postal code for an order’s shipping address. The regional prefix is used to determine the merchant’s on-time performance.

Currently, this attribute will only work with US zip codes. When submitting this data, we recommend only including the first 3 digits of a zip code.

Shipping “shipping”

The shipping cost of an order.

Delivery country “country”

The country the items are delivered to. Use ISO 3166-1 alpha-2 format. (For example, “US” for “United States").
Merchant Center ID “aw_merchant_id” The Merchant Center ID where your items are uploaded.
Feed target country “aw_country_id”

The country associated with the feed where your items are uploaded.

Note: This parameter uses CLDR territory codes.
Feed language “aw_language_id”

The language associated with the feed where your items are uploaded.

Note: This parameter uses ISO 639-1 language codes.

The data layer

The data layer is used to temporarily hold data. It is a structured format that is understood by Tag Manager to make it easy for you to move that data from your web page or mobile app to tags, triggers, and other variables in Tag Manager.

You don't necessarily need to set up a data layer in order for variables to retrieve information. Tag Manager Variables can also be configured to retrieve values directly from JavaScript variables, first-party cookies, and from the DOM. However, the best practice is to have your variables retrieve information directly from a well-organized data layer object. A data layer implementation can minimize the likelihood of data loss from inadvertent code changes, encourage a well organized and accessible data model, and simplify troubleshooting.

Example implementation with Data Layer (new parameters highlighted)

Note: If you’re using Google Tag Manager, the purchase-detail fields should be specified as elements in a JSON.

<!-- Sample Code datalayer push -->

  1.  dataLayer.push({  
  2.      "event": 'purchase',
  3.     "transaction_id": "1545c34e-691e-4726-aeda-b798df255e9c",
  4.     "affiliation": "Google online store",
  5.     "value": 23.07,
  6.     "currency": "USD",
  7.     "tax": 1.24,
  8.   "shipping": 0.00,
  9.   "discount": 1.50,
  10.        "delivery_postal_code": "94043",
  11.        "estimated_delivery_date": "2020-07-31",
  12.        "aw_merchant_id": 12345,
  13.        "aw_feed_country": "US",
  14.        "aw_feed_language": "EN",
  15.        "items": [
  16.            {
  17.                "id": "P12345",
  18.                "quantity": 2,
  19.                "price": 2,
  20.                "estimated_delivery_date": "2020-07-31",
  21.          },
  22.          {
  23.              "id": "P123456",
  24.              "quantity": 2,
  25.              "price": 2,
  26.         "estimated_delivery_date": "2020-07-29",
  27.          ...
  28.        ]
  29.      });

Example implementation with JavaScript variables (new parameters highlighted)

<!-- Sample Code JavaScript Variables→

  1. <script type="text/javascript">
  2. "transaction_id": "1545c34e-691e-4726-aeda-b798df255e9c",
  3. "affiliation": "Google online store",
  4. "value": 23.07,
  5. "currency": "USD",
  6. "tax": 1.24,
  7. "shipping": 0.00,
  8. "discount": 1.50,
  9. "delivery_postal_code": "94043",
  10. "estimated_delivery_date": "2020-07-31",
  11. "aw_merchant_id": 12345,
  12. "aw_feed_country": "US",
  13. "aw_feed_language": "EN",
  14. "items": [
  15.     {
  16.       "id": "P12345",
  17.       "quantity": 2,
  18.       "price": 2,
  19.       "estimated_delivery_date": "2020-07-31",
  20.    
  21.    },
  22.      {
  23.         "id": "P123456",
  24.          "quantity": 2,
  25.           "price": 2,
  26.           "estimated_delivery_date": "2020-07-29",
  27.      ...
  28.    ]
  29. });
  30. /* ]]> */
  31. </script>

Install with global site tag

Step 1: Install global site tag

Note: If you’re already using the global site tag conversion tracking code, move to Step 2.
  1. Sign in to your Google Ads Account.
  2. In the upper right corner, click the tools icon Google Ads | tools [Icon].
  3. From the “Measurement” drop-down menu, click Conversions.
  4. Click the conversion action that you want to use, or create a new conversion action.
  5. Install the global site tag on your site. Learn how to set up your conversion tracking tag.

Step 2: Install additional parameters into the code

To submit cart information, you will need to install these additional parameters into the code:

Required parameters Definition
Delivery date (per order) “estimated_delivery_date”

The latest (or “max”) promised delivery date for an order in a customer’s cart data. For orders with products that are under consideration for free and fast (new or maintain status), Google uses this date to validate shipping speed.

Note: This parameter uses the international date format (YYYY-MM-DD).
Delivery date (per item) “items[].estminated_delivery_date”

The latest (or “max”) promised delivery date for an item. For products that are under consideration for free and fast (new or maintain status), Google uses this date to validate shipping speed.

Note: This parameter uses the international date format (YYYY-MM-DD).
Postal code (per order) “delivery_postal_code”

The regional prefix, or designation portion, of a postal code for an order’s shipping address. The regional prefix is used to determine the merchant’s on-time performance.

Currently, this attribute will only work with US zip codes. When submitting this data, we recommend only including the first 3 digits of a zip code.

Shipping “shipping” The shipping cost of an order.
Delivery country “country” The country the items are delivered to.
Merchant Center ID “aw_merchant_id” The Merchant Center ID where your items are uploaded.
Feed target country “aw_country_id”

The country associated with the feed where your items are uploaded.

Note: This parameter uses CLDR territory codes.
Feed language “aw_language_id”

The language associated with the feed where your items are uploaded.

Note: This parameter uses ISO 639-1 language codes.

Example of a configured Global Site Tag (new parameters highlighted)

<!-- Sample Code Conversion -->

  1. <script type="text/javascript">
  2. gtag('event', 'purchase', {
  3.   "transaction_id": "1545c34e-691e-4726-aeda-b798df255e9c",
  4.   "value": 23.07,
  5.   "currency": "USD",
  6.   "country": "US",
  7.   "tax": 1.24,
  8.   "shipping": 0.00,
  9.   "delivery_postal_code": "94043",
  10.   "estimated_delivery_date": "2020-07-31",
  11.   "aw_merchant_id": 12345,
  12.   "aw_feed_country": "US",
  13.   "aw_feed_language": "EN",
  14.   "items": [
  15.     {
  16.       "id": "P12345",
  17.       "name": "Android Warhol T-Shirt",
  18.       "quantity": 2,
  19.       "price": 2,
  20.       "estimated_delivery_date": "2020-07-31",
  21.  
  22.  
  23.     },
  24.     {
  25.       "name": "Android New Artist T-Shirt",
  26.       "brand": "Google",
  27.       "category": "Apparel/T-Shirts",
  28.       "variant": "Black",
  29.       "list_name": "Search Results",
  30.       "list_position": 2,
  31.       "quantity": 2,
  32.       "price": 2,
  33.       "estimated_delivery_date": "2020-07-29",
  34.     ...
  35.   ]
  36. });
  37. /* ]]> */
  38. </script>
Was this helpful?
How can we improve it?

Need more help?

Sign in for additional support options to quickly solve your issue

Search
Clear search
Close search
Google apps
Main menu
Search Help Center
false
false
true
71525
false
false