These guide highlights requirements and examples of Food Ordering offers.

## Eligibility and Policies

This section highlights important eligibility criteria that partners must adhere
to when providing offers. It is important to test all offer types types that you
plan to launch during sandbox feed testing. If you are unsure if an offer is
eligible, please reach out to your Google POC.

### Exclude personalized and single-use offers

To ensure a high-quality and consistent user experience, partners must **not**
include offers that are restricted to specific subsets of users (for example,
first-time sign up offers, or user-based algorithmically generated offers).
Platform-wide offers eligible for all users or for all users placing a
a first time order at a particular restaurant **are** allowed given that the
offer is displayed on the offer landing page for all users. Offers available to
all users, but requiring a subscription, are also allowed.

The offer conditions must be clearly stated in
the offer feeds and on the offer URL landing page. Offers must be visible on the
offer landing page for all users when logged-out or logged-in to your site or
app.

### Offers with coupon codes

Certain offers require the entry of a coupon code by the user, such as "Apply
code SAVE20 to get 20% off on the total bill". It is important to note that
Google doesn't display coupon codes from the [coupon](https://developers.google.com/actions-center/verticals/offers/integration-steps/offers-feed.md.txt#coupon)
definition. Partners may include this information within the
[OfferDetails.offer_display_text](https://developers.google.com/actions-center/verticals/offers/integration-steps/offers-feed.md.txt#offerdetails)
to be displayed to users. If the coupon is included in the `offer_display_text` or `coupon` field, it must be displayed on
the offer landing page as well. Coupon-based offers generally fall into two categories:

- Offers where the coupon is automatically presented at checkout to any user arriving from Google. These are permitted.
- Offers that require the user to enter the coupon code at checkout but don't provide instructions on how to apply the coupon code on the offer url landing page, or don't automatically apply the coupon when following the offer url, are not permitted.

## Offer Content and Structure

This section details the requirements for the content and structure of the
offers provided in the feed, including examples of the structured metadata.

### Offer display text and Offer specification

The [OfferDetails.offer_display_text](https://developers.google.com/actions-center/verticals/offers/integration-steps/offers-feed.md.txt#offerdetails)
is a **required** field that serves as the concise headline for immediate
visibility in the offers section on Google Search, such as "$10 off" or "Save 15%".

The [OfferDetails.offer_specification](https://developers.google.com/actions-center/verticals/offers/integration-steps/offers-feed.md.txt#offerdetails)
is a **required "one of"** field within the `OfferDetails`. This means that
exactly one of the following three fields must be provided to specify the deal:

- `discount_value`
- `discount_percent`
- `other_offer_detail_text`

The [OfferDetails.other_offer_detail_text](https://developers.google.com/actions-center/verticals/offers/integration-steps/offers-feed.md.txt#offerdetails)
field is a free-form text field used to supplement the `offer_display_text`
when the offer cannot be expressed as a flat discount value or percentage. If the
`offer_display_text` is already sufficient to convey all necessary information
about the offer, the `other_offer_detail_text` field should be populated with
the same text as the `offer_display_text`. However, for complex deals, this
field should provide a specific description of the reward.

### Structured metadata fields

To improve offer clarity and enable better ranking and filtering, partners must
provide offer metadata in the respective structured fields. Specifying the
[terms](https://developers.google.com/actions-center/verticals/offers/integration-steps/offers-feed.md.txt#terms)
is required. It is recommended to set the `terms.terms_and_conditions`
field with the detailed terms that are displayed to users on the offer landing
page.

#### Total Order and Item Specific Offers

Offers specific to subsets of items must use the
[offer_restrictions.inclusions](https://developers.google.com/actions-center/verticals/offers/integration-steps/offers-feed.md.txt#description-table-madden.ingestion.offer.OfferCondition)
and
[offer_restrictions.exclusions](https://developers.google.com/actions-center/verticals/offers/integration-steps/offers-feed.md.txt#description-table-madden.ingestion.offer.OfferCondition)
fields to define the eligible items. If the offer is for a specific item,
the item name should be included in the `offer_display_text`. When the item
name is included in the `offer_display_text`, setting the
`offer_restrictions.inclusions` is not required.

If the `offer_restrictions.inclusions` are not set, or if the item name is not
included in the `offer_display_text`, the offer is considered to apply to the
total order amount.

Item specific offers shouldn't use the `discount_percent` or `discount_value`
fields to specify the amount of the discount, and should use
`other_offer_detail_text` instead. The `discount_percent` and `discount_value`
fields are for total order offers.

#### Subscription Offers

Subscription offers are allowed provided that the offers are displayed on the
offer landing page for all users when logged-out or logged-in to your site or
app. If the offer requires a subscription, you must include the
[OfferDetails.subscription](https://developers.google.com/actions-center/verticals/offers/integration-steps/offers-feed.md.txt#offerdetails)
field with the subscription details. The subscription offer should be displayed
to users if they sign up or have an active subscription.

#### Delivery Fee Offers

Delivery fee offers must use [offer_category](https://developers.google.com/actions-center/verticals/offers//integration-steps/offers-feed#description-table-madden.ingestion.offer.OfferCategory)
`OFFER_CATEGORY_ADD_ON_FEE_REDUCTION_OFFER`. This allows the offer to be
displayed only when combined with another base offer for the location. A
delivery fee offer won't be displayed as a base offer.

## Offer JSON Examples

#### Flat $20 off

Example: Flat $20 off total order on Tuesdays with $15 minimum spend

```
{
  "offer_id": "offer-example-1-takeout",
  "offer_source": "OFFER_SOURCE_AGGREGATOR",
  "action_type": "ACTION_TYPE_FOOD_TAKEOUT",
  "offer_modes": ["OFFER_MODE_ONLINE_ORDER"],
  "offer_category": "OFFER_CATEGORY_BASE_OFFER",
  "offer_details": {
    "offer_display_text": "$20 off on Tuesdays",
    "discount_value": {
      "currency_code": "USD",
      "units": 20
    },
    "min_spend_value": {
      "currency_code": "USD",
      "units": 15
    }
  },
  "validity_periods": [
    {
      "valid_period": {
        "valid_from_time": { "seconds": 1768953600 },
        "valid_through_time": { "seconds": 1795219200 }
      },
      "time_of_day": [
        {
          "time_windows": {
            "open_time": { "hours": 9 },
            "close_time": { "hours": 20, "minutes": 59, "seconds": 59 }
          },
          "day_of_week": ["TUESDAY"]
        }
      ]
    }
  ],
  "offer_restrictions": {
    "combinable_with_other_offers": false
  },
  "terms": {
    "terms_and_conditions": "For use only at the participating restaurant location on qualifying delivery or takeout orders with $15 minimum spend. Single use per order. Offer may not be combined with any other offers, discounts, or promotions. Valid only on Tuesdays."
  },
  "entity_ids": ["dining-1"],
  "offer_url": "https://www.example-restaurant.com/offer/base_offer_1"
}
```

#### Percentage discount offers

Two example offers: 50% off item level offer and 5% off total order amount.

```
[
  {
    "offer_id": "offer-example-1-takeout",
    "offer_source": "OFFER_SOURCE_AGGREGATOR",
    "action_type": "ACTION_TYPE_FOOD_TAKEOUT",
    "offer_modes": ["OFFER_MODE_ONLINE_ORDER"],
    "offer_category": "OFFER_CATEGORY_BASE_OFFER",
    "offer_details": {
      "offer_display_text": "50% off on Berry Smoothie",
      "other_offer_detail_text": "50% off on Berry Smoothie"
    },
    "validity_periods": [
      {
        "valid_period": {
          "valid_from_time": { "seconds": 1768953600 },
          "valid_through_time": { "seconds": 1795219200 }
        }
      }
    ],
    "offer_restrictions": {
      "combinable_with_other_offers": true,
      "inclusions": [
        {"description":"Berry Smoothie"}
      ]
    },
    "terms": {
      "terms_and_conditions": "For use only at the participating restaurant location on qualifying delivery or takeout orders. Single use per order."
    },
    "entity_ids": ["dining-1"],
    "offer_url": "https://www.example-restaurant.com/offer/base_offer_1"
  },
  {
    "offer_id": "offer-example-2-takeout",
    "offer_source": "OFFER_SOURCE_AGGREGATOR",
    "action_type": "ACTION_TYPE_FOOD_TAKEOUT",
    "offer_modes": ["OFFER_MODE_ONLINE_ORDER"],
    "offer_category": "OFFER_CATEGORY_BASE_OFFER",
    "offer_details": {
      "offer_display_text": "5% off on all orders",
      "discount_percent": 5.0
    },
    "validity_periods": [
      {
        "valid_period": {
          "valid_from_time": { "seconds": 1768953600 },
          "valid_through_time": { "seconds": 1795219200 }
        }
      }
    ],
    "offer_restrictions": {
      "combinable_with_other_offers": false
    },
    "terms": {
      "terms_and_conditions": "For use only at the participating restaurant location on qualifying delivery or takeout orders. Single use per order."
    },
    "entity_ids": ["dining-1"],
    "offer_url": "https://www.example-restaurant.com/offer/base_offer_1"
  }
]
```

#### Buy One Get One Free offer

Example: Buy one appetizer, get one free offer, valid Monday through Thursday

```
{
  "offer_id": "offer-example-2-delivery",
  "offer_source": "OFFER_SOURCE_AGGREGATOR",
  "action_type": "ACTION_TYPE_FOOD_DELIVERY",
  "offer_modes": ["OFFER_MODE_ONLINE_ORDER"],
  "offer_category": "OFFER_CATEGORY_BASE_OFFER",
  "offer_details": {
    "offer_display_text": "Buy one appetizer, get one free",
    "other_offer_detail_text": "Buy one appetizer, get one free"
  },
  "validity_periods": [
    {
      "valid_period": {
        "valid_from_time": { "seconds": 1768953600 },
        "valid_through_time": { "seconds": 1795219200 }
      },
      "time_of_day": [
        {
          "time_windows": {
            "open_time": { "hours": 10 },
            "close_time": { "hours": 23, "minutes": 59, "seconds": 59 }
          },
          "day_of_week": ["MONDAY", "TUESDAY", "WEDNESDAY", "THURSDAY"]
        }
      ]
    }
  ],
  "offer_restrictions": {
    "combinable_with_other_offers": true,
    "inclusions": [
      {
        "description": "appetizers"
      }
    ]
  },
  "terms": {
    "terms_and_conditions": "For use only at the participating restaurant location on qualifying delivery or takeout orders. Single use per order. Valid on all menu appetizers. Offer may be combined with any other offers, discounts, or promotions. Valid Monday through Thursday."
  },
  "entity_ids": ["dining-1"],
  "offer_url": "https://www.example-restaurant.com/offer/base_offer_4"
}
```

#### Free Delivery offer

Example: Free delivery as an add-on to a base offer. The $0 Delivery Fees offer will be displayed with the 10% off base offer for the location.

```
[
  {
    "offer_id": "offerId1",
    "offer_source": "OFFER_SOURCE_AGGREGATOR",
    "action_type": "ACTION_TYPE_FOOD_DELIVERY",
    "offer_modes": ["OFFER_MODE_ONLINE_ORDER"],
    "offer_category": "OFFER_CATEGORY_BASE_OFFER",
    "offer_details": {
      "offer_display_text": "10% off on all orders",
      "discount_percent": 10.0
    },
    "validity_periods": [
      {
        "valid_period": {
          "valid_from_time": { "seconds": 1768953600 },
          "valid_through_time": { "seconds": 1795219200 }
        },
        "time_of_day": [
          {
            "day_of_week": ["MONDAY", "TUESDAY", "WEDNESDAY", "THURSDAY"]
          }
        ]
      }
    ],
    "offer_restrictions": {
      "combinable_with_other_offers": true,
      "combinable_offer_categories": ["OFFER_CATEGORY_ADD_ON_PAYMENT_OFFER"]
    },
    "terms": {
      "terms_and_conditions": "For use only at the participating restaurant location on qualifying delivery or takeout orders. Single use per order. Offer may be combined with any other offers, discounts, or promotions."
    },
    "entity_ids": ["dining-1"],
    "offer_url": "https://www.example-restaurant.com/offer/base_offer_5"
  },
  {
    "offer_id": "offerId2",
    "offer_source": "OFFER_SOURCE_AGGREGATOR",
    "action_type": "ACTION_TYPE_FOOD_DELIVERY",
    "offer_modes": ["OFFER_MODE_ONLINE_ORDER"],
    "offer_category": "OFFER_CATEGORY_ADD_ON_FEE_REDUCTION_OFFER",
    "offer_details": {
      "offer_display_text": "$0 Delivery Fee",
      "other_offer_detail_text": "Free Delivery"
    },
    "validity_periods": [
      {
        "valid_period": {
          "valid_from_time": { "seconds": 1768953600 },
          "valid_through_time": { "seconds": 1795219200 }
        }
      }
    ],
    "offer_restrictions": {
      "combinable_with_other_offers": true
    },
    "terms": {
      "terms_and_conditions": "Delivery is free at the participating restaurant location on qualifying delivery or takeout orders. Single use per order. Offer may be combined with any other offers, discounts, or promotions."
    },
    "entity_ids": ["dining-1"],
    "offer_url": "https://www.example-restaurant.com/offer/addon_offer_1"
  }
]
```

#### Subscription based offers

Example: 10% off all orders when the user signs up or has an active subscription.

```
{
  "offer_id": "offer-example-1-takeout",
  "offer_source": "OFFER_SOURCE_AGGREGATOR",
  "action_type": "ACTION_TYPE_FOOD_TAKEOUT",
  "offer_modes": ["OFFER_MODE_ONLINE_ORDER"],
  "offer_category": "OFFER_CATEGORY_BASE_OFFER",
  "offer_details": {
    "offer_display_text": "10% off on all orders",
    "discount_percent": 10.0
  },
  "subscription": {
    "name": "My Provider Subscription",
    "subscription_duration": {
      "seconds": 31536000
    },
    "cost": {
      "units": 50,
      "currency_code": "USD"
    }
  },
  "validity_periods": [
    {
      "valid_period": {
        "valid_from_time": { "seconds": 1768953600 },
        "valid_through_time": { "seconds": 1795219200 }
      }
    }
  ],
  "offer_restrictions": {
    "combinable_with_other_offers": false
  },
  "terms": {
    "terms_and_conditions": "For use only at the participating restaurant location on qualifying delivery or takeout orders with a subscription. Single use per order."
  },
  "entity_ids": ["dining-1"],
  "offer_url": "https://www.example-restaurant.com/offer/subscription_offer_1"
}
```

> [!IMPORTANT]
> **Important:** You may use the [Offer
> validator](https://developers.google.com/actions-center/verticals/offers/reference/feeds/offer-feed-validator) to test a JSON feed example. It is recommended to create models for the feed schema objects. This reduces issues related to invalid field names and enum values when creating the feed. See [How to Build an Offers
> Feed](https://developers.google.com/actions-center/verticals/offers/reference/feeds/how-to-build-offer-feed) for a tutorial on how to generate the model code from the schema.

## Fulfillment and Constraints

This section details requirements and best practices related to offer
fulfillment specification and constraints associated with them.

### Fulfillment mode (Delivery and Takeout)

If a single deal applies to both delivery and takeout, it must have two offers
in the feed. Each entry must have a dedicated
[ActionType](https://developers.google.com/actions-center/verticals/offers/integration-steps/offers-feed.md.txt#description-table-madden.ingestion.offer.ActionType):

- `ACTION_TYPE_FOOD_DELIVERY`
- `ACTION_TYPE_FOOD_TAKEOUT`

This ensures that users landing on the partner site are presented with the
correct fulfillment context.

### Time windows

Offers are expected to be displayed on the offer landing page for all users when
logged-out or logged-in to your site or app. If the offer is valid during a
specific time period, you must include the
[validity_periods.valid_period](https://developers.google.com/actions-center/verticals/offers/integration-steps/offers-feed.md.txt#validperiod)
field to specify the valid period. This prevents the offer from being displayed
outside of the time period. The time window must also be set if the offer is
displayed on the offer url during certain hours of the day. For example, if the
landing page does not display offers when the restaurant is closed, you must
include the [TimeOfDayWindow](https://developers.google.com/actions-center/verticals/offers/integration-steps/offers-feed.md.txt#timeofdaywindow)
open and close times.

### Handle timeframes crossing midnight

Offers that span across midnight (e.g., valid from 10:00 PM Tuesday to 2:00 AM
Wednesday) must be segmented to be processed correctly by the ingestion
pipeline.
**Requirement:** Use the [TimeOfDayWindow](https://developers.google.com/actions-center/verticals/offers/integration-steps/offers-feed.md.txt#timeofdaywindow)
field to break the window into two distinct segments:

- **Segment 1:** 10:00 PM to 11:59:59 PM on the starting day (e.g., Tuesday).
- **Segment 2:** 12:00 AM to 2:00 AM on the following day (e.g., Wednesday).

This ensures the offer's validity is accurately reflected throughout the entire
period.

### Fee specifications

Fees for delivery and takeout can be specified using the
[OfferDetails.additional_fees](https://developers.google.com/actions-center/verticals/offers/integration-steps/offers-feed.md.txt#offerdetails)
field. A convenience fee should be specified using the
[OfferDetails.convenience_fee](https://developers.google.com/actions-center/verticals/offers/integration-steps/offers-feed.md.txt#offerdetails).