Hướng dẫn này trình bày các yêu cầu, đề xuất về mô hình hoá dữ liệu và các phương pháp hay nhất để triển khai thẻ quà tặng (còn gọi là phiếu mua hàng) trong nguồn cấp dữ liệu ưu đãi. Những đề xuất này bổ sung cho tài liệu tiêu chuẩn của Trung tâm hành động và đề cập đến các khía cạnh tích hợp cụ thể của thẻ quà tặng.
Chế độ và danh mục ưu đãi
Khi gửi khoảng không quảng cáo thẻ quà tặng, hãy đảm bảo bạn đã định cấu hình chính xác các thuộc tính cốt lõi sau:
Chế độ ưu đãi:
offer_modesphải luôn được đặt làm một mảng singleton chứa"OFFER_MODE_GIFT_CARD_PURCHASE":"offer_modes": ["OFFER_MODE_GIFT_CARD_PURCHASE"]Phiếu mua hàng có giá trị được lưu trữ so với chiết khấu tức thì khi đến trực tiếp:
gift_card_infochỉ dành riêng cho các phiếu mua hàng có giá trị được lưu trữ và thẻ quà tặng đã mua trước (OFFER_MODE_GIFT_CARD_PURCHASE).- Nếu khách hàng thanh toán trực tiếp tại quầy của cửa hàng thực tế ngay tại chỗ để được chiết khấu tức thì mà không mua mã phiếu mua hàng để yêu cầu hoặc sử dụng sau này, hãy mô hình hoá ưu đãi đó dưới dạng chiết khấu tiêu chuẩn khi đến trực tiếp (
OFFER_MODE_WALK_IN) và bỏ qua hoàn toàn thông báogift_card_info.
Mô hình hoá mệnh giá: Mệnh giá thẻ quà tặng phải thể hiện giá trị của phiếu mua hàng (giá trị mà phiếu mua hàng có thể được sử dụng), không phải số tiền mà người dùng thanh toán (người dùng thanh toán giá chiết khấu).
Hợp nhất nhiều mệnh giá: Nhiều phiếu mua hàng có cùng tỷ lệ chiết khấu và điều khoản, nhưng khác nhau về mệnh giá, phải được nhóm thành một mục ưu đãi duy nhất. Vì
denomination_typehoạt động dưới dạngoneof, đối tác phải chọn đặtfixed_denominationshoặccustom_range:- Mệnh giá cố định: Sử dụng khi bạn cung cấp các số tiền riêng biệt, được đặt trước cho thẻ quà tặng được cung cấp (ví dụ: 500 INR, 1.000 INR và 2.000 INR, tất cả đều được chiết khấu cố định 10%). Đảm bảo rằng mọi mệnh giá cố định đã bán hết hoặc không có trên trang đích đều được loại trừ rõ ràng khỏi các lượt gửi nguồn cấp dữ liệu.
- Phạm vi tuỳ chỉnh: Chỉ sử dụng khi người dùng có thể tự do nhập bất kỳ
mệnh giá nào trong phạm vi đã xác định trên trang mua hàng (ví dụ: bất kỳ giá trị nào
từ 100 INR đến 5.000 INR với mức chiết khấu 5%). Nếu trang đích cung cấp các số tiền riêng biệt, được đặt trước, hãy mô hình hoá khoảng không quảng cáo theo đúng
fixed_denominations. Ngoài ra, nếu cả mệnh giá cố định và mệnh giá tuỳ chỉnh đều có sẵn cho một ưu đãi, thì đối tác nên đặt phạm vi tuỳ chỉnh linh hoạt.
Xử lý chuỗi nhiều địa điểm
Đối với các phiếu mua hàng áp dụng cho các chuỗi bán lẻ hoặc ăn uống lớn mà các điều khoản giống nhau ở nhiều điểm đến (POI), đừng cung cấp một đối tượng Ưu đãi riêng cho từng địa điểm cửa hàng. Thay vào đó, hãy sử dụng phương pháp cung cấp nguồn cấp dữ liệu tổng hợp bằng cách cung cấp một đối tượng Ưu đãi duy nhất chứa danh sách tất cả các mã nhận dạng thực thể cửa hàng tham gia (entity_ids).
Thương hiệu trên cổng thông tin (brand_id)
Một số phiếu mua hàng được cung cấp thông qua các cổng thông tin cụ thể của ngân hàng hoặc chương trình khách hàng thân thiết (ví dụ: chương trình khách hàng thân thiết của ngân hàng hoặc nền tảng đối tác) thay vì trang web chính của người bán. Để đảm bảo thương hiệu chính xác cho các cổng thông tin này, đối tác phải điền vào trường brand_id trên các đối tượng Ưu đãi cấp cao nhất.
Mặc dù việc bỏ qua brand_id sẽ mặc định là thương hiệu chính của tài khoản (và brand_id không bắt buộc khi sử dụng thương hiệu mặc định của tài khoản), nhưng việc điền rõ ràng brand_id sẽ liên kết chính xác khoảng không quảng cáo với cổng thông tin có thương hiệu tương ứng, đảm bảo rằng người dùng nhìn thấy đúng biểu trưng và tên dành riêng cho đối tác. Bạn có thể xem thêm hướng dẫn về cách định cấu hình thương hiệu trong phần
Định cấu hình thương hiệu.
Cấu trúc thời gian có hiệu lực (ValidityScope)
Thẻ quà tặng có cấu trúc thời gian có hiệu lực riêng biệt, phân biệt khoảng thời gian mua ưu đãi với khoảng thời gian sử dụng thẻ. Đối tác phải luôn sử dụng các giá trị enum ValidityScope có liên quan:
VALIDITY_SCOPE_CLAIM: Xác định khoảng thời gian mà ưu đãi thẻ quà tặng có thể được mua trên nền tảng đối tác. Bạn phải luôn cung cấp mục này. Khi gửi nguồn cấp dữ liệu, hãy điền khoảng thời gian có hiệu lực của yêu cầu bắt đầu từ ngày gửi nguồn cấp dữ liệu chính xác. Ngoài ra, đừng bao giờ để khoảng thời gian yêu cầu không có ngày kết thúc nếu trang đích quảng cáo rõ ràng ngày kết thúc chiến dịch; hãy khớpvalid_through_timevới ngày hết hạn được quảng cáo.VALIDITY_SCOPE_REDEEM: Xác định khoảng thời gian sử dụng sau khi mua (khoảng thời gian mà người dùng phải sử dụng phiếu mua hàng tại cửa hàng sau khi mua, có thể được chỉ định là khoảng thời gian hoặc khoảng thời gian).
Liên kết loại hành động
Đối tác thường phân loại phiếu mua hàng bằng các cấu trúc như "có thể sử dụng trực tuyến/ngoại tuyến", "trực tuyến/cửa hàng" hoặc "tại cửa hàng". Trong các lượt gửi nguồn cấp dữ liệu, bạn phải liên kết cấu trúc này với enum ActionType để xác định chính xác cách sử dụng sản phẩm:
- Ngành dọc về ăn uống / thực phẩm: Liên kết thẻ quà tặng "Ăn tại chỗ" với
ACTION_TYPE_DINING. Liên kết thẻ quà tặng "Giao hàng" vớiACTION_TYPE_FOOD_DELIVERY. Liên kết thẻ quà tặng "Mua mang về" vớiACTION_TYPE_FOOD_TAKEOUT. - Ngành dọc về bán lẻ mua sắm: Liên kết thẻ quà tặng "Tại cửa hàng" với
ACTION_TYPE_SHOPPING_IN_STORE. (Lưu ý: Chúng tôi không hỗ trợ phiếu mua hàng bán lẻ chỉ trực tuyến). - Liên kết một kênh: Mỗi
offer_idchỉ có thể thuộc mộtActionType. Nếu một mặt hàng trong khoảng không quảng cáo hỗ trợ nhiều kênh thực hiện (ví dụ: cả giao đồ ăn và mua mang về), hãy tạo các đối tượng Ưu đãi riêng biệt có mã nhận dạng riêng cho từng chế độ.
Chiết khấu theo bậc và ưu đãi bổ sung
- Chiết khấu theo bậc trên các phương thức thanh toán: Nếu bạn cung cấp các tỷ lệ chiết khấu khác nhau dựa trên công cụ thanh toán cụ thể được sử dụng (ví dụ: chiết khấu cao hơn cho ví điện tử so với Thẻ tín dụng), thì bạn phải mô hình hoá các tỷ lệ này dưới dạng các đối tượng Ưu đãi riêng biệt. Đối tác nên cung cấp phạm vi khuyến mãi đầy đủ trên tất cả các công cụ thanh toán được hỗ trợ (ví dụ: ví điện tử, Thẻ tín dụng, Thẻ ghi nợ, Ngân hàng trực tuyến) để đảm bảo trải nghiệm tiết kiệm đáng tin cậy. Nếu một ưu đãi áp dụng chung cho tất cả các phương thức thanh toán được chấp nhận trên nền tảng, thì bạn không nên đặt trường công cụ thanh toán.
- Cấu trúc ưu đãi bổ sung: Để thể hiện các lợi ích được cộng dồn, chẳng hạn như điểm phần thưởng dành riêng cho ngân hàng hoặc ưu đãi hoàn tiền bổ sung áp dụng cho giao dịch mua thẻ quà tặng, hãy gửi các lợi ích đó dưới dạng các ưu đãi bổ sung hoàn toàn riêng biệt bằng cách sử dụng enum
OfferCategorythích hợp –OFFER_CATEGORY_ADD_ON_PAYMENT_OFFER. Mô tả phần thưởng trongOfferDetails.other_offer_details_text(ví dụ: "Nhận điểm thưởng tối đa gấp 5 lần") và liên kết phần thưởng đó với ưu đãi thẻ quà tặng cơ bản bằng cách điềnOfferRestrictions.combinable_offer_idsbằngoffer_idcủa thẻ quà tặng cơ bản.
Điều khoản và điều kiện đặc biệt
Đối tác nên dựa vào terms.terms_and_conditions để cung cấp đầy đủ Điều khoản và điều kiện pháp lý của thẻ quà tặng hoặc phiếu mua hàng. Hợp nhất tất cả hướng dẫn dành cho người dùng và nguyên tắc sử dụng vào trường này.
Nếu các hạn chế quan trọng yêu cầu giao diện người dùng nổi bật riêng (chẳng hạn như thời gian hết hạn số dư sử dụng một lần
, không hoàn tiền hoặc giới hạn kết hợp giao dịch như
"Bạn có thể kết hợp tối đa 2 phiếu mua hàng cho mỗi hoá đơn"), hãy làm nổi bật các hạn chế đó trong
offer_restrictions.special_conditions.
Đề xuất về tiêu đề ưu đãi
Độ dài tiêu đề ưu đãi phải luôn dưới 40 ký tự. Xoá tên thương hiệu của người bán khỏi offer_display_text, vì các ưu đãi xuất hiện trực tiếp trên trang thông tin dành riêng cho người bán. Bạn nên sử dụng các định dạng tiêu đề sau:
| Trường hợp sử dụng | Tiêu đề đề xuất |
|---|---|
| Chiết khấu cố định trên phiếu mua hàng | X% off on Gift Cards |
| Chiết khấu thay đổi dựa trên phương thức thanh toán | X% off on Gift Cards using {e-wallet}
|
| Chiết khấu thay đổi trên các mệnh giá khác nhau | X% off on Gift Cards (Gửi các mức chiết khấu khác nhau dưới dạng các ưu đãi riêng biệt) |
| Thẻ quà tặng B2B2C | X% off on Gift Cards (Thương hiệu xuất hiện thông qua hình thu nhỏ bằng
brand_id) |
| Ưu đãi bổ sung | Flat/Up to 5X reward points/
<Platform> coins |
Yêu cầu về trang đích
Mọi offer_url được quảng cáo phải trả về HTTP 200 OK trực tiếp mà không có lệnh chuyển hướng trung gian và chuyển đến một trang đích đang hoạt động để chứng minh ưu đãi.
Nguồn cấp dữ liệu không được chứa các mệnh giá đã bán hết hoặc không có. Duy trì quá trình đồng bộ hoá khoảng không quảng cáo nghiêm ngặt giữa các trường mệnh giá trong nguồn cấp dữ liệu và các lựa chọn mua hàng trực tiếp trên trang đích.
Trang đích phải đề cập rõ ràng rằng ưu đãi áp dụng riêng cho thẻ quà tặng hoặc phiếu mua hàng.
Ví dụ: nếu trang đích của đối tác chỉ hiển thị các lời kêu gọi hành động thanh toán chung chung như "Thanh toán hoá đơn" mà không nêu rõ trước rằng việc hoàn tất giao dịch sẽ phát hành phiếu mua hàng có giá trị được lưu trữ, thì người dùng được chuyển hướng từ Google và mong muốn mua thẻ quà tặng có thể cảm thấy bối rối hoặc bỏ qua. Ngay cả khi thông báo về phiếu mua hàng xuất hiện ở bước thanh toán tiếp theo, bạn vẫn phải nêu rõ thông tin trên trang đích ban đầu.
Ưu đãi có mã phiếu giảm giá
Một số ưu đãi yêu cầu người dùng nhập mã phiếu giảm giá, chẳng hạn như "Áp dụng mã SAVE20 để được giảm 20% trên tổng hoá đơn". Bạn cần lưu ý rằng Google không hiển thị mã phiếu giảm giá từ định nghĩa phiếu giảm giá. Đối tác có thể đưa thông tin này vào OfferDetails.offer_display_text để hiển thị cho người dùng. Các ưu đãi dựa trên phiếu giảm giá thường thuộc 2 danh mục:
- Ưu đãi mà phiếu giảm giá tự động xuất hiện khi thanh toán cho bất kỳ người dùng nào đến từ Google. Những ưu đãi này được cho phép.
- Những ưu đãi yêu cầu người dùng nhập mã phiếu giảm giá khi thanh toán nhưng không cung cấp hướng dẫn về cách áp dụng mã phiếu giảm giá trên trang đích của URL ưu đãi hoặc không tự động áp dụng phiếu giảm giá khi người dùng truy cập URL ưu đãi sẽ không được cho phép.
Ví dụ về JSON ưu đãi thẻ quà tặng
{
"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"
}
]
}