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 bestimmte, 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.
Ketten mit mehreren Standorten verwalten
Bei Geschenkgutscheinen, die für große Einzelhandels- oder Restaurantketten gelten, bei denen die Bedingungen für mehrere 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 das Branding dieser Portale korrekt ist, 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 verwendet wird:
- Restaurants / Lebensmittel: Ordnen Sie Geschenkkarten für „Essen vor Ort“
ACTION_TYPE_DININGzu. Ordnen Sie Geschenkkarten für die LieferungACTION_TYPE_FOOD_DELIVERYzu. Ordne Geschenkkarten für „Essen zum Mitnehmen“ der KategorieACTION_TYPE_FOOD_TAKEOUTzu. - 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 für einen Inventarartikel mehrere Fulfillment-Channels unterstützt werden (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 besondere Hervorhebung in der Benutzeroberfläche erforderlich ist (z. B. Ablauf von Guthaben, das nur einmal verwendet werden kann, Ausschluss von Erstattungen 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 speziellen Ortsseite 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 jede beworbene offer_url muss direkt der HTTP-Statuscode „200 OK“ zurückgegeben werden, ohne dass Zwischenweiterleitungen erfolgen. Außerdem muss die offer_url zu einer aktiven Landingpage 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 angezeigt wird, muss er auf der ursprünglichen Landingpage deutlich zu sehen sein.
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 coupon-Definition 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 an der Kasse automatisch allen Nutzern präsentiert wird, die von Google kommen. 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"
}
]
}