Ce guide présente les exigences et des exemples d'offres de commande de repas.
Éligibilité et règles
Cette section met en évidence les critères d'éligibilité importants que les partenaires doivent respecter lorsqu'ils proposent des offres. Il est important de tester tous les types d'offres que vous prévoyez de lancer lors des tests de flux dans le bac à sable. Si vous n'êtes pas sûr qu'une offre soit éligible, veuillez contacter votre contact Google.
Exclure les offres personnalisées et à usage unique
Pour garantir une expérience utilisateur cohérente et de haute qualité, les partenaires ne doivent pas inclure d'offres réservées à des sous-ensembles d'utilisateurs spécifiques (par exemple, des offres de première inscription ou des offres générées de manière algorithmique en fonction de l'utilisateur). Les offres à l'échelle de la plate-forme éligibles pour tous les utilisateurs ou pour tous les utilisateurs passant une première commande dans un restaurant donné sont autorisées, à condition que l'offre soit affichée sur la page de destination de l'offre pour tous les utilisateurs. Les offres disponibles pour tous les utilisateurs, mais nécessitant un abonnement, sont également autorisées.
Les conditions de l'offre doivent être clairement indiquées dans les flux d'offres et sur la page de destination de l'URL de l'offre. Les offres doivent être visibles sur la page de destination de l'offre pour tous les utilisateurs, qu'ils soient connectés ou non à votre site ou à votre application.
Offres avec codes promotionnels
Certaines offres nécessitent la saisie d'un code promotionnel par l'utilisateur, par exemple "Appliquez le code SAVE20 pour obtenir 20 % de réduction sur le montant total de la facture". Il est important de noter que Google n'affiche pas les codes promotionnels de la définition coupon. Les partenaires peuvent inclure ces informations dans OfferDetails.offer_display_text pour qu'elles soient présentées aux utilisateurs. Si le bon de réduction est inclus dans le champ offer_display_text ou coupon, il doit également être affiché sur la page de destination de l'offre. Les offres basées sur des coupons se répartissent généralement en deux catégories :
- Offres pour lesquelles le bon de réduction est automatiquement présenté lors du règlement à tout utilisateur provenant de Google. Ces pratiques sont autorisées.
- Les offres qui exigent que l'utilisateur saisisse le code promotionnel au moment du règlement, mais qui ne fournissent pas d'instructions sur la façon d'appliquer le code promotionnel sur la page de destination de l'URL de l'offre, ou qui n'appliquent pas automatiquement le code promotionnel lorsque l'utilisateur suit l'URL de l'offre, ne sont pas autorisées.
Contenu et structure de l'offre
Cette section détaille les exigences concernant le contenu et la structure des offres fournies dans le flux, y compris des exemples de métadonnées structurées.
Texte à afficher de l'offre et spécification de l'offre
Le champ OfferDetails.offer_display_text est obligatoire. Il sert de titre concis pour une visibilité immédiate dans la section des offres de la recherche Google, par exemple "10 € de remise" ou "Économisez 15 %".
OfferDetails.offer_specification est un champ obligatoire "one of" dans OfferDetails. Cela signifie que vous devez fournir exactement l'un des trois champs suivants pour spécifier l'accord :
discount_valuediscount_percentother_offer_detail_text
Le champ OfferDetails.other_offer_detail_text est un champ de texte libre utilisé pour compléter offer_display_text lorsque l'offre ne peut pas être exprimée sous la forme d'une valeur ou d'un pourcentage de remise fixe. Si le champ offer_display_text suffit déjà à transmettre toutes les informations nécessaires sur l'offre, le champ other_offer_detail_text doit être renseigné avec le même texte que le champ offer_display_text. Toutefois, pour les offres complexes, ce champ doit fournir une description spécifique de la récompense.
Champs de métadonnées structurées
Pour améliorer la clarté des offres et permettre un meilleur classement et un meilleur filtrage, les partenaires doivent fournir les métadonnées des offres dans les champs structurés correspondants. Vous devez spécifier les termes. Il est recommandé de définir le champ terms.terms_and_conditions avec les conditions détaillées qui sont présentées aux utilisateurs sur la page de destination de l'offre.
Offres spécifiques à la commande totale et à l'article
Les offres spécifiques à des sous-ensembles d'articles doivent utiliser les champs offer_restrictions.inclusions et offer_restrictions.exclusions pour définir les articles éligibles. Si l'offre concerne un article spécifique, le nom de l'article doit être inclus dans l'attribut offer_display_text. Lorsque le nom de l'élément est inclus dans offer_display_text, il n'est pas nécessaire de définir offer_restrictions.inclusions.
Si l'attribut offer_restrictions.inclusions n'est pas défini ou si le nom de l'article n'est pas inclus dans l'attribut offer_display_text, l'offre est considérée comme s'appliquant au montant total de la commande.
Offres d'abonnement
Les offres d'abonnement sont autorisées à condition qu'elles soient affichées sur la page de destination de l'offre pour tous les utilisateurs, qu'ils soient connectés ou non à votre site ou à votre application. Si l'offre nécessite un abonnement, vous devez inclure le champ OfferDetails.subscription avec les détails de l'abonnement. L'offre d'abonnement doit être présentée aux utilisateurs s'ils s'inscrivent ou s'ils ont un abonnement actif.
Offres sur les frais de livraison
Les offres de frais de livraison doivent utiliser offer_category
OFFER_CATEGORY_ADD_ON_FEE_REDUCTION_OFFER. Cela permet d'afficher l'offre uniquement lorsqu'elle est combinée à une autre offre de base pour l'emplacement. Une offre de frais de livraison ne sera pas affichée en tant qu'offre de base.
Exemples d'offres au format JSON
Remise fixe de 20 $
Exemple : 20 € de remise fixe sur le montant total de la commande le mardi, avec un seuil minimal de dépenses de 15 €
{ "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" }
Offres de remise en pourcentage
Deux exemples d'offres : une offre de 50 % de remise au niveau de l'article et une remise de 5 % sur le montant total de la commande.
[ { "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", "discount_percent": 50.0 }, "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" } ]
Offre "Un acheté, un inclus"
Exemple : "Un apéritif acheté, un inclus", offre valable du lundi au jeudi
{ "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" }
Offre de livraison gratuite
Exemple : Livraison gratuite en tant que module complémentaire d'une offre de base. L'offre de livraison à 0 € s'affichera avec l'offre de base de 10 % de remise pour l'établissement.
[ { "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" } ]
Offres par abonnement
Exemple : 10 % de remise sur toutes les commandes lorsque l'utilisateur s'inscrit ou dispose d'un abonnement actif.
{ "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" }
Fulfillment et contraintes
Cette section détaille les exigences et les bonnes pratiques liées aux spécifications de traitement des offres et aux contraintes qui leur sont associées.
Mode de traitement (livraison et vente à emporter)
Si une même offre s'applique à la fois à la livraison et à la vente à emporter, elle doit comporter deux offres dans le flux. Chaque entrée doit avoir un ActionType dédié :
ACTION_TYPE_FOOD_DELIVERYACTION_TYPE_FOOD_TAKEOUT
Cela permet de s'assurer que les utilisateurs qui accèdent au site du partenaire voient le contexte de traitement approprié.
Périodes
Les offres doivent être affichées sur la page de destination de l'offre pour tous les utilisateurs, qu'ils soient connectés ou non à votre site ou application. Si l'offre est valide pendant une période spécifique, vous devez inclure le champ validity_periods.valid_period pour spécifier la période de validité. Cela empêche l'affichage de l'offre en dehors de la période définie. La période doit également être définie si l'offre est affichée sur l'URL de l'offre à certaines heures de la journée. Par exemple, si la page de destination n'affiche pas d'offres lorsque le restaurant est fermé, vous devez inclure les heures d'ouverture et de fermeture de TimeOfDayWindow.
Gérer les périodes qui se chevauchent à minuit
Les offres qui s'étendent au-delà de minuit (par exemple, valables du mardi à 22h au mercredi à 2h) doivent être segmentées pour être traitées correctement par le pipeline d'ingestion. Exigence : Utilisez le champ TimeOfDayWindow pour diviser la fenêtre en deux segments distincts :
- Segment 1 : de 22h00 à 23h59m59s le jour de début (par exemple, le mardi).
- Segment 2 : de minuit à 2h le jour suivant (par exemple, le mercredi).
Cela permet de s'assurer que la validité de l'offre est reflétée avec précision tout au long de la période.
Spécifications des frais
Les frais de livraison et de vente à emporter peuvent être spécifiés à l'aide du champ OfferDetails.additional_fees. Les frais de commodité doivent être spécifiés à l'aide de OfferDetails.convenience_fee.