Bu kılavuzda, teklifler feed'inizde hediye kartlarını (kupon olarak da bilinir) uygulama ile ilgili koşullar, veri modelleme önerileri ve en iyi uygulamalar özetlenmektedir. Bu öneriler, standart İşlemler Merkezi belgelerini tamamlar ve hediye kartına özgü entegrasyon yönlerini ele alır.
Fırsat modu ve kategorizasyon
Hediye kartı envanteri gönderirken aşağıdaki temel özelliklerin doğru şekilde yapılandırıldığından emin olun:
Offer Mode:
offer_modesher zaman"OFFER_MODE_GIFT_CARD_PURCHASE"içeren tek öğeli bir dizi olarak ayarlanmalıdır:"offer_modes": ["OFFER_MODE_GIFT_CARD_PURCHASE"]Değer saklanan kuponlar ve anında indirimler:
gift_card_info, önceden satın alınmış saklanmış değer kuponları ve hediye kartları (OFFER_MODE_GIFT_CARD_PURCHASE) için kesinlikle ayrılmıştır.- Bir müşteri, daha sonra talep etmek veya kullanmak üzere kupon kodu satın almadan anında indirim için doğrudan fiziksel mağaza kasasında ödeme yaparsa teklifi standart bir müşteri indirimi (
OFFER_MODE_WALK_IN) olarak modelleyin vegift_card_infomesajını tamamen çıkarın.
Değer modelleme: Hediye kartı değeri, kuponun değerini (ne için kullanılabileceğini) temsil etmelidir. Kullanıcının ödediği tutarı (kullanıcı indirimli fiyatı öder) temsil etmemelidir.
Birden Fazla Değeri Birleştirme: Tamamen aynı indirim yüzdesine ve şartlara sahip ancak nominal değerleri farklı olan birden fazla kupon tek bir teklif girişinde gruplandırılmalıdır.
denomination_type,oneofolarak çalıştığından iş ortaklarıfixed_denominationsveyacustom_rangeayarlamayı seçmelidir:- Sabit Değerler: Ayrı, önceden ayarlanmış hediye kartı tutarları sunulduğunda kullanılır (ör. 500, 1.000 ve 2.000 Hindistan rupisi, hepsi% 10 sabit indirimli). Açılış sayfasında satışı durdurulan veya kullanılamayan sabit değerlerin feed gönderimlerinin dışında tutulduğundan emin olun.
- Özel Aralık: Yalnızca kullanıcılar satın alma sayfasında tanımlanmış sınırlar içinde herhangi bir rastgele nominal değeri serbestçe girebildiğinde kullanın (ör. %5 indirimle 100 ₹ ile 5.000 ₹ arasındaki herhangi bir değer). Hedef açılış sayfasında ayrı ve önceden belirlenmiş tutarlar sunuluyorsa envanteri kesinlikle
fixed_denominationsaltında modelleyin. Ayrıca, bir teklif için hem sabit hem de özel değerler kullanılabiliyorsa iş ortakları esnek özel aralığı ayarlamalıdır.
Birden Çok Konumlu Zincirleri İşleme
Şartların birden fazla ilgi çekici noktada (İÇN) aynı olduğu büyük perakende veya yemek zincirlerinde geçerli olan hediye çekleri için her bir mağaza konumu için ayrı bir teklif nesnesi sağlamayın. Bunun yerine, tüm katılımcı mağaza öğesi kimliklerinin (entity_ids) listesini içeren tek bir Offer nesnesi sağlayarak toplu feed yaklaşımını kullanın.
Portal Markalama (brand_id)
Bazı kuponlar, ana satıcı sitesi yerine belirli banka veya bağlılık programı portalları (ör. banka bağlılık programları veya iş ortağı platformları) üzerinden sunulur. Bu portallarda doğru markalama yapılmasını sağlamak için iş ortakları, üst düzey teklif nesnelerindeki brand_id alanını doldurmalıdır.
brand_id öğesinin atlanması varsayılan olarak hesabın birincil markasını kullanır (hesabın varsayılan markası kullanılırken brand_id gerekli değildir). brand_id öğesinin açıkça doldurulması ise envanterin ilgili markalı portal ile doğru şekilde ilişkilendirilmesini sağlar ve kullanıcılara doğru iş ortağına özel logoların ve adların gösterilmesini sağlar. Markaları yapılandırma hakkında daha fazla bilgiyi Marka Yapılandırması başlıklı makalede bulabilirsiniz.
Geçerlilik Yapısı (ValidityScope)
Hediye kartlarının, fırsatın satın alınabileceği zaman aralığını kartın kullanılabileceği süreden ayıran benzersiz bir geçerlilik yapısı vardır. İş ortakları her zaman ilgili ValidityScope enum değerlerini kullanmalıdır:
VALIDITY_SCOPE_CLAIM: Hediye kartı teklifinin iş ortağı platformunda satın alınabileceği zaman aralığını tanımlar. Bu giriş her zaman mevcut olmalıdır. Feed'leri gönderirken hak talebi geçerlilik dönemini, feed'in gönderildiği tam tarihten itibaren doldurun. Ayrıca, açılış sayfasında kampanya bitiş tarihi açıkça belirtiliyorsa hiçbir zaman hak talebi dönemlerini açık uçlu bırakmayın.valid_through_time, reklamı yapılan son kullanma tarihiyle eşleşmelidir.VALIDITY_SCOPE_REDEEM: Satın alma sonrası kupon kullanma süresini (kullanıcıların kuponu satın aldıktan sonra mağazada kullanması gereken süre; süre veya zaman aralığı olarak belirtilebilir) tanımlar.
İşlem Türü Eşleme
İş ortakları genellikle "online/offline kullanılabilir", "online/mağaza" veya "mağazada" gibi yapılar kullanarak kuponları kategorize eder. Feed gönderimlerinde, ürünün nasıl tüketildiğini doğru şekilde tanımlamak için bu değerin ActionType enum'ı ile eşlenmesi gerekir:
- Yemek / Gıda Sektörü: "Restoranda yemek" hediye kartlarını
ACTION_TYPE_DININGile eşleyin. "Teslimat" hediye kartlarınıACTION_TYPE_FOOD_DELIVERYile eşleyin. "Paket servisi" hediye kartlarınıACTION_TYPE_FOOD_TAKEOUTile eşleyin. - Alışveriş Perakende Sektörü: "Mağazada" hediye kartlarını
ACTION_TYPE_SHOPPING_IN_STOREile eşleyin. (Not: Yalnızca online olarak kullanılabilen perakende kuponları desteklenmez.) - Tek Kanal Eşlemesi: Her
offer_idyalnızca birActionType'e ait olabilir. Bir envanter öğesi birden fazla karşılama kanalını destekliyorsa (ör. hem yemek teslimatı hem de paket servis), her mod için benzersiz kimliklere sahip farklı Fırsat nesneleri oluşturun.
Katmanlı İndirimler ve Ek Teklifler
- Ödeme Yöntemlerine Göre Katmanlı İndirimler: Kullanılan ödeme aracına göre farklı indirim yüzdeleri sunuluyorsa (ör. kredi kartlarına kıyasla e-cüzdan için daha yüksek indirim) bunlar ayrı Fırsat nesneleri olarak modellenmelidir. İş ortakları, güvenilir bir tasarruf deneyimi sağlamak için desteklenen tüm ödeme araçlarında (ör. e-cüzdanlar, kredi kartları, banka kartları, internet bankacılığı) kapsamlı promosyon kapsamı sunmalıdır. Bir teklif, platformda kabul edilen tüm ödeme yöntemleri için geçerliyse ödeme aracı alanı ayarlanmamalıdır.
- Eklenti Teklifleri Yapısı: Bankaya özel ödül puanları veya hediye kartı satın alımında geçerli ekstra nakit iadesi gibi birleştirilmiş avantajları temsil etmek için bunları uygun
OfferCategoryenum'unuOFFER_CATEGORY_ADD_ON_PAYMENT_OFFERkullanarak tamamen ayrı Eklenti Teklifleri olarak gönderin. ÖdülüOfferDetails.other_offer_details_textiçinde açıklayın (ör. "5 kata kadar ödül puanı") veOfferRestrictions.combinable_offer_idsalanını temel hediye kartınınoffer_idile doldurarak ödülü temel hediye kartı fırsatına bağlayın.
Hükümler ve Özel Koşullar
İş ortakları, hediye kartı veya kuponun yasal şartlar ve koşullarını eksiksiz olarak sağlamak için terms.terms_and_conditions simgesini kullanmalıdır. Kullanıcıya yönelik tüm talimatları ve kullanım yönergelerini bu alanda birleştirin.
Önemli kısıtlamalar özel kullanıcı arayüzü görünürlüğü gerektiriyorsa (ör. tek kullanımlık bakiye geçerlilik süresi, geri ödeme yapılmaması veya "Fatura başına en fazla 2 kupon birleştirilebilir" gibi işlem birleştirme sınırları) bunları offer_restrictions.special_conditions içinde vurgulayın.
Teklif başlığı önerileri
Fırsat başlığı uzunluğu kesinlikle 40 karakterden kısa olmalıdır. Teklifler doğrudan satıcının özel yer sayfasında gösterildiğinden offer_display_text öğesinden satıcı marka adlarını kaldırın. Aşağıdaki başlık biçimlerini kullanmanızı öneririz:
| Kullanım alanı | Önerilen Başlık |
|---|---|
| Kuponlarda sabit indirim | X% off on Gift Cards |
| Ödeme yöntemine göre değişken indirim | X% off on Gift Cards using {e-wallet}
|
| Farklı değerlerde değişken indirimler | X% off on Gift Cards (Farklı indirimleri ayrı teklifler olarak gönderin) |
| B2B2C hediye kartları | X% off on Gift Cards (Markalama, brand_id kullanılarak küçük resim aracılığıyla gösterilir) |
| Ek teklifler | Flat/Up to 5X reward points/
<Platform> coins |
Açılış sayfası şartı
Reklamı yapılan her offer_url, aracı yönlendirmeler olmadan doğrudan HTTP 200 OK döndürmeli ve teklifi doğrulayan etkin bir hedef sayfaya yönlendirmelidir.
Feed, tüm biletleri satılan veya müsait olmayan mezhepleri içermemelidir. Feed'deki para birimi alanları ile hedef açılış sayfasındaki canlı satın alma seçenekleri arasında sıkı bir envanter senkronizasyonu sağlayın.
Hedef açılış sayfasında, teklifin özellikle hediye kartları veya kuponlar için geçerli olduğu açıkça belirtilmelidir.
Örneğin, bir iş ortağı açılış sayfasında, işlemin tamamlanmasıyla birlikte kayıtlı değer içeren bir hediye kartı kuponu verileceği önceden açıkça belirtilmeden yalnızca "Faturayı öde" gibi genel ödeme işlemleriyle ilgili harekete geçirici mesajlar gösteriliyorsa Google'dan hediye kartı satın almak için yönlendirilen kullanıcılar kafa karışıklığı yaşayabilir veya satın alma işlemini yarıda bırakabilir. Sonraki bir ödeme adımında kupon bildirimi görünse bile ilk açılış sayfasında net bir şekilde belirtilmesi gerekir.
Kupon kodlu teklifler
Bazı teklifler için kullanıcının kupon kodu girmesi gerekir. Örneğin, "Toplam faturada% 20 indirim almak için SAVE20 kodunu uygulayın". Google'ın kupon tanımındaki kupon kodlarını göstermediğini unutmayın. İş ortakları, bu bilgileri kullanıcılara gösterilecek OfferDetails.offer_display_text içine ekleyebilir. Kupon tabanlı teklifler genellikle iki kategoriye ayrılır:
- Google'dan gelen tüm kullanıcılara ödeme sırasında kuponun otomatik olarak sunulduğu teklifler. Bunlara izin verilir.
- Kullanıcının ödeme sırasında kupon kodunu girmesini gerektiren ancak teklif URL'si açılış sayfasında kupon kodunun nasıl uygulanacağıyla ilgili talimatlar sağlamayan veya teklif URL'si takip edildiğinde kuponu otomatik olarak uygulamayan tekliflere izin verilmez.
Örnek hediye kartı teklifi JSON'u
{
"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"
}
]
}