In diesem Leitfaden finden Sie die Anforderungen, Empfehlungen zur Datenmodellierung und Best Practices für die Implementierung von Geschenkkarten (auch als Gutscheine bezeichnet) in Ihrem Angebotsfeed. Diese Empfehlungen ergänzen die Standarddokumentation für das Actions Center und beziehen sich auf integrationsspezifische Aspekte von Geschenkkarten.
Angebotsmodus und Kategorisierung
Achten Sie beim Einreichen von Geschenkkartendaten darauf, dass die folgenden Kernattribute richtig konfiguriert sind:
Offer Mode (Angebotsmodus):
offer_modesmuss immer als Singleton-Array mit"OFFER_MODE_GIFT_CARD_PURCHASE"festgelegt werden:"offer_modes": ["OFFER_MODE_GIFT_CARD_PURCHASE"]Guthaben-Gutscheine im Vergleich zu Sofortrabatten für Laufkundschaft:
gift_card_infoist ausschließlich für im Voraus gekaufte Gutscheine und Geschenkkarten (OFFER_MODE_GIFT_CARD_PURCHASE) reserviert.- Wenn ein Kunde direkt an der Kasse im Geschäft bezahlt, um einen sofortigen Rabatt zu erhalten, ohne einen Gutscheincode zu kaufen, der später eingelöst werden kann, modellieren Sie das Angebot als Standardrabatt für Laufkundschaft (
OFFER_MODE_WALK_IN) und lassen Sie diegift_card_info-Mitteilung ganz weg.
Modellierung des Nennwerts: Der Nennwert der Geschenkkarte sollte dem Wert des Gutscheins entsprechen (wofür er eingelöst werden kann), nicht dem, was der Nutzer bezahlt (der Nutzer bezahlt den ermäßigten Preis).
Mehrere Nennwerte zusammenfassen: Mehrere Gutscheine mit genau demselben Rabattprozentsatz und denselben Bedingungen, aber unterschiedlichem Nennwert, müssen in einem einzigen Angebots-Eintrag zusammengefasst werden. Da
denomination_typealsoneoffungiert, müssen Partner zwischen der Einstellung vonfixed_denominationsoder einemcustom_rangewählen:- Feste Beträge: Verwenden Sie diese Option, wenn separate, voreingestellte Geschenkkartenbeträge angeboten werden (z. B. 500 INR, 1.000 INR und 2.000 INR, alle mit einem pauschalen Rabatt von 10 %). Achten Sie darauf, dass alle festen Beträge, die auf der Landingpage ausverkauft oder nicht verfügbar sind, explizit aus Feed-Einreichungen ausgeschlossen werden.
- Benutzerdefinierter Bereich: Nur verwenden, wenn Nutzer auf der Kaufseite einen beliebigen Nennwert innerhalb definierter Grenzen eingeben können (z. B. einen beliebigen Wert zwischen 100 € und 5.000 € mit einem Rabatt von 5 %). Wenn auf der Ziellandeseite diskrete, voreingestellte Beträge angeboten werden, modellieren Sie das Inventar ausschließlich unter
fixed_denominations. Wenn für ein Angebot sowohl feste als auch benutzerdefinierte Beträge verfügbar sind, sollten Partner den flexiblen benutzerdefinierten Bereich festlegen.
Nicht unterstützte Funktionen: Mindestbestellwert / Mindestbetrag für Rechnung (min_spend_value)
Warum Gutscheine für Mindestrechnungen nicht unterstützt werden
Angebote, für die ein Mindesttransaktionsbetrag erforderlich ist, um einen Gutschein mit gespeichertem Wert einzulösen (z. B. „Kaufen Sie einen Gutschein im Wert von 800 INR für 150 INR, der nur bei einer Rechnung von mindestens 5.000 INR eingelöst werden kann“), fallen aus folgenden Gründen nicht in den aktuellen Umfang der Integration von Angeboten in das Aktionscenter:
- Irreführende und nicht intuitive Nutzererfahrung:Die Berechnung von Rabattprozentsätzen (
discount_percent) durch die Kombination des Vorabkaufpreises des Gutscheins mit einer hypothetischen Mindestabrechnung an der Kasse führt zu irreführenden und nicht intuitiven Angaben zu Einsparungen für Endnutzer. - Inkompatible Feedstruktur:Bei Standardfeeds für Geschenkkarten wird davon ausgegangen, dass der Nennwert (
fixed_denominationsodercustom_range) ohne Einschränkungen für alle Einkäufe im Geschäft verwendet werden kann. - Geringes Branchenvolumen:Diese Gutscheine mit bedingtem Mindestumsatz haben ein geringes Gesamtvolumen und erfordern eine spezielle Bearbeitung, die sich von Standardgeschenkkarten mit gespeichertem Wert unterscheidet.
Erforderliche Maßnahmen für Partner
Wenn Ihr Inventar Gutscheinangebote mit Mindestumsatz enthält:
- Aus Feed entfernen:Senden Sie keine Geschenkgutscheine mit Mindestumsatzbedingungen über
OFFER_MODE_GIFT_CARD_PURCHASEein und versuchen Sie auch nicht, diese Einschränkung zu umgehen, indem Sie die Gutscheine überOFFER_MODE_WALK_INeinreichen. Entfernen Sie diese Angebote vollständig aus Ihren Feeds. - Antrag auf erneute Prüfung der Funktion:Wenn Sie der Meinung sind, dass diese Gutscheine mit Mindestausgabe einen erheblichen Geschäftswert darstellen, können Sie Ihrem Google-Ansprechpartner Daten zur Verfügung stellen, aus denen die Auswirkungen auf die Händlerabdeckung, die Transaktions-Conversion-Raten und das Gesamtvolumen hervorgehen. Unser Entwicklungsteam kann sich diese Messwerte ansehen, um eine mögliche zukünftige Unterstützung zu prüfen. Das Bereitstellen von Daten ist jedoch keine Garantie dafür, dass diese Funktion priorisiert oder unterstützt wird.
Ketten mit mehreren Standorten verwalten
Bei Geschenkgutscheinen, die für große Einzelhandels- oder Restaurantketten gelten, bei denen die Bedingungen an mehreren Points of Interest (POIs) identisch sind, darf kein separates Offer-Objekt für jeden einzelnen Standort angegeben werden. Verwenden Sie stattdessen einen aggregierten Feedansatz, indem Sie ein einzelnes Offer-Objekt mit einer Liste aller teilnehmenden Store-Entitäts-IDs (entity_ids) bereitstellen.
Portal-Branding (brand_id)
Einige Gutscheine werden nicht über die Hauptwebsite des Händlers, sondern über bestimmte Bank- oder Treuepunkteportale (z.B. Bank-Treuepunkteprogramme oder Partnerplattformen) angeboten. Damit die Marke für diese Portale korrekt dargestellt wird, müssen Partner das Feld brand_id in Angebotsobjekten der obersten Ebene ausfüllen.
Wenn brand_id weggelassen wird, wird standardmäßig die primäre Marke des Kontos verwendet. brand_id ist also nicht erforderlich, wenn die Standardmarke des Kontos verwendet wird. Wenn Sie brand_id jedoch explizit angeben, wird das Inventar der entsprechenden Markenportal zugeordnet. So wird sichergestellt, dass Nutzern die richtigen partnerspezifischen Logos und Namen angezeigt werden. Weitere Informationen zum Konfigurieren von Marken finden Sie unter Markenkonfiguration.
Gültigkeitsstruktur (ValidityScope)
Geschenkkarten haben eine eindeutige Gültigkeitsstruktur, die den Zeitraum für den Kauf des Angebots von der Dauer für das Einlösen der Karte unterscheidet. Partner müssen immer die relevanten ValidityScope-Enum-Werte verwenden:
VALIDITY_SCOPE_CLAIM: Definiert den Zeitraum, in dem das Geschenkkartenangebot auf der Partnerplattform gekauft werden kann. Dieser Eintrag muss immer vorhanden sein. Geben Sie beim Einreichen von Feeds den Gültigkeitszeitraum des Anspruchs ab dem genauen Datum der Feedeinreichung an. Außerdem dürfen Sie nie einen unbegrenzten Anspruchszeitraum angeben, wenn auf der Landingpage ein Enddatum für die Kampagne beworben wird. Dasvalid_through_timemuss mit dem beworbenen Ablaufdatum übereinstimmen.VALIDITY_SCOPE_REDEEM: Definiert den Zeitraum nach dem Kauf, in dem Nutzer den Gutschein im Geschäft einlösen können. Er kann als Dauer oder Zeitraum angegeben werden.
Zuordnung von Aktionstypen
Partner kategorisieren Gutscheine häufig mit Begriffen wie „online/offline einlösbar“, „online/Outlet“ oder „im Geschäft“. Bei Feed-Einreichungen muss dieses Attribut der ActionType-Enumeration zugeordnet werden, um genau zu definieren, wie das Produkt konsumiert wird:
- Restaurants / Lebensmittel: Ordnen Sie Geschenkkarten für „Essen vor Ort“
ACTION_TYPE_DININGzu. Ordnen Sie Geschenkkarten für die LieferungACTION_TYPE_FOOD_DELIVERYzu. Geschenkkarten für „Essen zum Mitnehmen“ACTION_TYPE_FOOD_TAKEOUTzuordnen. - Einzelhandel: Ordnen Sie Geschenkkarten für das Geschäft
ACTION_TYPE_SHOPPING_IN_STOREzu. Hinweis: Gutscheine für den reinen Onlinehandel werden nicht unterstützt. - Single Channel Mapping: Jede
offer_idkann nur zu einerActionTypegehören. Wenn ein Inventarartikel mehrere Fulfillment-Kanäle unterstützt (z.B. sowohl Essenslieferung als auch Abholung), erstellen Sie für jeden Modus separate Offer-Objekte mit eindeutigen IDs.
Gestaffelte Rabatte und Add-on-Angebote
- Rabatte je nach Zahlungsmethode: Wenn je nach verwendetem Zahlungsmittel unterschiedliche Rabattprozentsätze angeboten werden (z.B. ein höherer Rabatt für eine E-Wallet als für Kreditkarten), müssen diese als separate Offer-Objekte modelliert werden. Partner sollten für alle unterstützten Zahlungsmittel (z.B. E-Wallets, Kreditkarten, Debitkarten, Net Banking) umfassende Werbeaktionen anbieten, um zuverlässige Einsparungen zu ermöglichen. Wenn ein Angebot universell für alle auf der Plattform akzeptierten Zahlungsmethoden gilt, sollte das Feld für das Zahlungsmittel nicht festgelegt werden.
- Add-on-Angebote: Wenn Sie gestapelte Vorteile wie bankspezifische Prämienpunkte oder zusätzliches Cashback für den Kauf einer Geschenkkarte darstellen möchten, senden Sie sie als separate Add-on-Angebote mit dem entsprechenden
OfferCategory-Enum ein:OFFER_CATEGORY_ADD_ON_PAYMENT_OFFER. Beschreiben Sie die Prämie inOfferDetails.other_offer_details_text(z.B. „Bis zu 5-fache Prämienpunkte“) und verknüpfen Sie sie mit dem Basisangebot für Geschenkkarten, indem SieOfferRestrictions.combinable_offer_idsmit deroffer_idder Basisgeschenkkarte füllen.
Bedingungen und besondere Bedingungen
Partner sollten sich auf terms.terms_and_conditions verlassen, um die vollständigen rechtlichen Nutzungsbedingungen der Geschenkkarte oder des Gutscheins zu erhalten. Fassen Sie alle nutzerorientierten Anleitungen und Nutzungsrichtlinien in diesem Feld zusammen.
Wenn für wichtige Einschränkungen eine spezielle UI-Präsenz erforderlich ist (z. B. Ablauf von Guthaben für die einmalige Verwendung, Nicht erstattungsfähig oder Obergrenzen für die Kombination von Transaktionen wie „Maximal 2 Gutscheine können pro Rechnung kombiniert werden“), heben Sie diese in offer_restrictions.special_conditions hervor.
Empfehlungen für Angebotstitel
Der Angebotstitel darf maximal 40 Zeichen lang sein. Entfernen Sie Markennamen aus offer_display_text, da Angebote direkt auf der Unternehmensseite des Händlers angezeigt werden. Wir empfehlen die folgenden Titelformate:
| Anwendungsfall | Empfohlener Titel |
|---|---|
| Pauschalrabatt auf Gutscheine | X% off on Gift Cards |
| Variabler Rabatt je nach Zahlungsmethode | X% off on Gift Cards using {e-wallet}
|
| Variable Rabatte auf verschiedene Stückelungen | X% off on Gift Cards (Verschiedene Rabatte als separate Angebote senden) |
| B2B2C-Geschenkkarten | X% off on Gift Cards (Branding wird über das Thumbnail mit brand_id angezeigt) |
| Zusatzangebote | Flat/Up to 5X reward points/
<Platform> coins |
Anforderungen an Landingpages
Für jedes beworbene offer_url muss direkt der HTTP-Code 200 OK zurückgegeben werden, ohne dass Zwischenweiterleitungen erfolgen. Außerdem muss die URL zu einer aktiven Zielseite führen, auf der das Angebot belegt wird.
Der Feed darf keine ausverkauften oder nicht verfügbaren Beträge enthalten. Sorgen Sie für eine strikte Inventarsynchronisierung zwischen den Feldern für die Stückelung im Feed und den Live-Kaufoptionen auf der Ziel-Landingpage.
Auf der Ziel-Landingpage muss deutlich darauf hingewiesen werden, dass sich das Angebot speziell auf Geschenkkarten oder Gutscheine bezieht.
Wenn auf der Landingpage eines Partners beispielsweise nur allgemeine Zahlungs-CTAs wie „Rechnung bezahlen“ angezeigt werden, ohne dass im Voraus ausdrücklich angegeben wird, dass durch den Abschluss der Transaktion ein Gutschein für eine Wertkarte ausgestellt wird, kann es bei Nutzern, die von Google weitergeleitet werden und eine Geschenkkarte kaufen möchten, zu Verwirrung oder Kaufabbrüchen kommen. Auch wenn ein Gutscheinhinweis in einem späteren Schritt des Bezahlvorgangs erscheint, ist eine klare Angabe auf der ursprünglichen Landingpage erforderlich.
Angebote mit Gutscheincodes
Bei bestimmten Angeboten muss der Nutzer einen Gutscheincode eingeben, z. B. „Mit dem Code SAVE20 erhalten Sie 20% Rabatt auf die Gesamtrechnung“. Gutscheincodes aus der Gutscheindefinition werden von Google nicht angezeigt. Partner können diese Informationen in OfferDetails.offer_display_text einfügen, damit sie Nutzern angezeigt werden. Gutscheinbasierte Angebote lassen sich in der Regel in zwei Kategorien einteilen:
- Angebote, bei denen der Gutschein allen Nutzern, die von Google kommen, automatisch an der Kasse präsentiert wird. Diese sind zulässig.
- Angebote, bei denen der Nutzer den Gutscheincode an der Kasse eingeben muss, aber keine Anleitung zum Einlösen des Gutscheincodes auf der Landingpage der Angebots-URL enthalten ist oder der Gutschein nicht automatisch angewendet wird, wenn der Nutzer der Angebots-URL folgt, sind nicht zulässig.
Beispiel für JSON-Code für ein Geschenkkartenangebot
{
"data": [
{
"offer_id": "example-dining-gift-card-10off",
"entity_ids": [
"dining-1",
"dining-2"
],
"offer_modes": [
"OFFER_MODE_GIFT_CARD_PURCHASE"
],
"action_type": "ACTION_TYPE_DINING",
"offer_source": "OFFER_SOURCE_AGGREGATOR",
"offer_category": "OFFER_CATEGORY_BASE_OFFER",
"offer_details": {
"offer_display_text": "10% off on Gift Cards",
"discount_percent": 10.0,
"gift_card_info": {
"fixed_denominations": {
"amounts": [
{
"units": 500,
"currency_code": "INR"
},
{
"units": 1000,
"currency_code": "INR"
},
{
"units": 2000,
"currency_code": "INR"
}
]
}
}
},
"offer_restrictions": {
"combinable_with_other_offers": false,
"special_conditions": [
"Single-use balance expiration applies",
"Maximum 2 gift card vouchers can be combined per bill",
"No cash refund will be provided against this voucher"
]
},
"terms": {
"restricted_to_certain_users": false,
"terms_and_conditions": "1. Redeemable exclusively at participating dining outlets.\n2. Single-use balance expiration applies.\n3. Maximum 2 gift card vouchers can be combined per bill.\n4. No cash refund will be provided against this voucher."
},
"validity_periods": [
{
"valid_period": {
"valid_from_time": {
"seconds": "1774934350"
},
"valid_through_time": {
"seconds": "1806470350"
}
},
"validity_scope": "VALIDITY_SCOPE_CLAIM"
},
{
"validity_duration_in_days": 365,
"validity_scope": "VALIDITY_SCOPE_REDEEM"
}
],
"offer_url": "https://www.example-portal.com/dining-gift-cards/buy"
}
]
}