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 quà tặ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à giải quyết các khía cạnh tích hợp cụ thể của thẻ quà tặng.
Chế độ và danh mục sản phẩm
Khi gửi kho hàng thẻ quà tặng, hãy đảm bảo rằng bạn đã định cấu hình chính xác các thuộc tính cốt lõi sau:
Offer Mode (Chế độ ưu đãi):
offer_modesphải luôn được đặt làm một mảng đơn chứa"OFFER_MODE_GIFT_CARD_PURCHASE":"offer_modes": ["OFFER_MODE_GIFT_CARD_PURCHASE"]Phiếu giảm giá có giá trị lưu trữ so với Chiết khấu tức thì cho khách hàng trực tiếp đến mua hàng:
gift_card_infochỉ dành riêng cho phiếu giảm giá và thẻ quà tặng có giá trị lưu trữ đã 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 hàng thực tế ngay tại chỗ để được chiết khấu ngay mà không mua mã giảm giá để nhận hoặc sử dụng sau, hãy mô hình hoá ưu đãi này dưới dạng chiết khấu tiêu chuẩn cho khách hàng đến trực tiếp (
OFFER_MODE_WALK_IN) và hoàn toàn bỏ qua thông báogift_card_info.
Mô hình mệnh giá: Mệnh giá của thẻ quà tặng phải thể hiện giá trị của phiếu giảm giá (giá trị mà người dùng có thể sử dụng), không phải giá trị 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á: Bạn phải nhóm nhiều phiếu giảm giá có cùng tỷ lệ chiết khấu và điều khoản nhưng khác nhau về giá trị danh nghĩa thành một mục nhập ưu đãi duy nhất. Vì
denomination_typehoạt động như mộtoneof, nên các đối tác phải chọn giữa việc đặtfixed_denominationshoặccustom_range:- Mệnh giá cố định: Sử dụng khi bạn cung cấp các khoản tiền riêng biệt, được đặt trước cho thẻ quà tặng (ví dụ: 500 INR, 1.000 INR và 2.000 INR, tất cả đều được chiết khấu 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 bị loại trừ rõ ràng khỏi nội dung bạn gửi trong 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ỳ giá trị danh nghĩa 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 ₹ đến 5.000 ₹ với mức chiết khấu 5%). Nếu trang đích cung cấp số tiền riêng biệt, đặt trước, hãy mô hình hoá kho hàng một cách nghiêm ngặt theo
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.
Các tính năng không được hỗ trợ: Ngưỡng mua hàng tối thiểu / Ngưỡng hoá đơn tối thiểu (min_spend_value)
Lý do không hỗ trợ phiếu giảm giá cho hoá đơn tối thiểu
Những ưu đãi yêu cầu số tiền giao dịch tối thiểu để sử dụng một phiếu quà tặng có giá trị lưu trữ (ví dụ: "Mua một phiếu quà tặng trị giá 800 INR với giá 150 INR và chỉ có thể sử dụng khi hoá đơn tối thiểu là 5.000 INR trở lên") nằm ngoài phạm vi tích hợp Ưu đãi của Trung tâm hành động hiện tại vì những lý do sau:
- Trải nghiệm người dùng gây hiểu lầm và không trực quan: Việc tính toán tỷ lệ phần trăm chiết khấu (
discount_percent) bằng cách kết hợp giá mua phiếu giảm giá trả trước với một hoá đơn thanh toán tối thiểu giả định sẽ tạo ra những tuyên bố gây hiểu lầm và không trực quan về khoản tiết kiệm cho người dùng cuối. - Cấu trúc nguồn cấp dữ liệu không tương thích: Nguồn cấp dữ liệu thẻ quà tặng tiêu chuẩn giả định rằng giá trị ghi trên thẻ (
fixed_denominationshoặccustom_range) có thể sử dụng đầy đủ cho mọi giao dịch mua tại cửa hàng mà không có hạn chế về hoá đơn có điều kiện. - Số lượng thấp trong ngành: Những ưu đãi phiếu giảm giá có điều kiện về số tiền tối thiểu này có tổng số lượng thấp và cần được xử lý theo cách chuyên biệt khác với thẻ quà tặng tiêu chuẩn có giá trị lưu trữ.
Việc cần làm đối với Đối tác
Nếu khoảng không quảng cáo của bạn có chương trình khuyến mãi phiếu giảm giá có điều kiện về giá trị đơn hàng tối thiểu:
- Xoá khỏi nguồn cấp dữ liệu: Đừng gửi phiếu quà tặng có điều kiện về số tiền tối thiểu của hoá đơn bằng cách sử dụng
OFFER_MODE_GIFT_CARD_PURCHASE(hoặc cố gắng bỏ qua điều này bằng cách gửi phiếu quà tặng đó trongOFFER_MODE_WALK_IN). Hãy xoá hoàn toàn những chương trình khuyến mãi cụ thể này khỏi tệp xuất nguồn cấp dữ liệu. - Yêu cầu xem xét lại tính năng: Nếu cho rằng những phiếu giảm giá có điều kiện về số tiền tối thiểu này mang lại giá trị kinh doanh đáng kể, bạn có thể chia sẻ dữ liệu chi tiết về mức độ ảnh hưởng đến phạm vi của người bán, tỷ lệ chuyển đổi giao dịch và tổng số lượng với Đầu mối liên hệ (POC) của bạn tại Google. Nhóm kỹ thuật của chúng tôi có thể xem xét các chỉ số này để đánh giá khả năng hỗ trợ trong tương lai. Tuy nhiên, xin lưu ý rằng việc cung cấp dữ liệu không đảm bảo rằng tính năng này sẽ được ưu tiên hoặc hỗ trợ.
Xử lý chuỗi nhiều vị trí
Đối với phiếu quà tặng áp dụng cho các chuỗi bán lẻ hoặc chuỗi nhà hàng lớn mà các điều khoản giống nhau ở nhiều địa điểm yêu thích (POI), bạn không cung cấp một đối tượng Ưu đãi riêng cho từng vị trí cửa hàng. Thay vào đó, hãy sử dụng phương pháp cung cấp dữ liệu tổng hợp bằng cách cung cấp một đối tượng Offer duy nhất chứa danh sách tất cả mã nhận dạng thực thể cửa hàng tham gia (entity_ids).
Xây dựng thương hiệu cho cổng thông tin (brand_id)
Một số phiếu giảm giá đượ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 này, đối tác phải điền trường brand_id vào các đối tượng Cung cấp 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à bạn không bắt buộc phải dùng brand_id khi sử dụng thương hiệu mặc định của tài khoản), nhưng việc điền sẵn brand_id một cách rõ ràng sẽ liên kết chính xác khoảng không quảng cáo với cổng 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 tính hợp lệ (ValidityScope)
Thẻ quà tặng có cấu trúc hiệu lực riêng biệt, phân biệt khoảng thời gian mua ưu đãi với thời hạn 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 khung thời gian mà người dùng có thể mua thẻ quà tặng trên nền tảng của đối tác. Mục này phải luôn xuất hiện. 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 thông tin xác nhận quyền sở hữ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 của chiến dịch; hãy điều chỉnhvalid_through_timecho phù hợp vớ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 giảm giá tại cửa hàng sau khi mua, có thể được chỉ định là khoảng thời gian hoặc khung thời gian).
Ánh xạ loại hành động
Các đối tác thường phân loại phiếu giảm giá bằng cách sử dụng các cấu trúc như "có thể đổi trực tuyến/ngoại tuyến", "trực tuyến/tại cửa hàng" hoặc "tại cửa hàng". Trong các lần gửi nguồn cấp dữ liệu, bạn phải liên kết thuộc tính này với enum ActionType để xác định chính xác cách sản phẩm được tiêu thụ:
- Danh mục Ăn uống / Thực phẩm: Liên kết thẻ quà tặng "Ăn tại chỗ" với
ACTION_TYPE_DINING. Ánh xạ thẻ quà tặng "Giao hàng" đếnACTION_TYPE_FOOD_DELIVERY. Ánh xạ thẻ quà tặng "Takeout" sangACTION_TYPE_FOOD_TAKEOUT. - Ngành 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 ý: Phiếu giảm giá bán lẻ chỉ trực tuyến không được hỗ trợ). - Liên kết một kênh: Mỗi
offer_idchỉ có thể thuộc về mộtActionType. Nếu một mặt hàng trong kho hỗ trợ nhiều kênh thực hiện đơn hàng (ví dụ: cả giao đồ ăn và mang đi), hãy tạo các đối tượng riêng biệt với 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 cấp cho các phương thức thanh toán: Nếu bạn đưa ra các tỷ lệ phần trăm 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. Các đối tác phải cung cấp thông tin khuyến mãi đầy đủ cho tất cả các phương thứ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 ưu đãi áp dụng 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 xếp chồng, chẳng hạn như điểm 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 ư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 bên trongOfferDetails.other_offer_details_text(ví dụ: "Nhận tối đa gấp 5 lần điểm thưởng") 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 toàn bộ Điều khoản và điều kiện pháp lý của thẻ quà tặng hoặc phiếu giảm giá. Hợp nhất tất cả hướng dẫn cho người dùng và nguyên tắc sử dụng vào trường này.
Nếu các quy định hạn chế quan trọng yêu cầu giao diện người dùng chuyên biệt nổi bật (chẳng hạn như 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 chỉ có thể kết hợp tối đa 2 phiếu giảm giá cho mỗi hoá đơn"), hãy làm nổi bật các quy định hạn chế đó trong offer_restrictions.special_conditions.
Đề xuất về tiêu đề của ưu đãi
Độ dài tiêu đề của sản phẩm phải 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 mặt hàng được hiển thị trực tiếp trên trang thông tin dành riêng của 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 | Đối tượng khách hàng nên liên hệ |
|---|---|
| Chiết khấu cố định cho phiếu giảm giá | X% off on Gift Cards |
| Chiết khấu linh hoạt dựa trên phương thức thanh toán | X% off on Gift Cards using {e-wallet}
|
| Chiết khấu linh hoạt cho 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 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à phân giải thành 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ó sẵn. Duy trì việc đồng bộ hoá kho hàng chặt chẽ 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 nêu rõ rằng ưu đãi này chỉ áp dụng cho thẻ quà tặng hoặc phiếu thưởng.
Ví dụ: nếu trang đích của đối tác chỉ hiển thị các lời kêu gọi chung để thanh toán như "Thanh toán hoá đơn" mà không nêu rõ ngay từ đầu rằng việc hoàn tất giao dịch sẽ phát hành một phiếu quà tặng có giá trị lưu trữ, thì những người dùng được chuyển hướng từ Google và đang muốn mua thẻ quà tặng có thể cảm thấy bối rối hoặc bỏ ngang. Ngay cả khi thông báo về phiếu giảm giá xuất hiện ở bước thanh toán tiếp theo, bạn vẫn phải nêu rõ ràng ngay từ đầu trên trang đích ban đầu.
Sản phẩm có mã giảm giá
Một số ưu đãi yêu cầu người dùng nhập mã giảm giá, chẳng hạn như "Áp dụng mã TIETKIEM20 để được giảm 20% tổng hoá đơn". Bạn cần lưu ý rằng Google không hiển thị mã giảm giá từ định nghĩa coupon (phiếu giảm giá). Các đối tác có thể thêm thông tin này vào OfferDetails.offer_display_text để hiển thị cho người dùng. Ư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á được tự động xuất hiện trong quá trình thanh toán cho bất kỳ người dùng nào truy cập từ Google. Những trường hợp này được phép.
- Bạn không được phép đăng những mặt hàng yêu cầu người dùng nhập mã 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ã giảm giá trên trang đích của URL mặt hàng hoặc không tự động áp dụng mã giảm giá khi truy cập vào URL mặt hàng.
Ví dụ về JSON của ư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"
}
]
}