Giới thiệu các lợi ích của cửa hàng trên Google bằng chương trình khách hàng thân thiết. Bạn có thể gửi nhiều lợi ích, chẳng hạn như ưu đãi vận chuyển miễn phí, đổi điểm và giá dành riêng cho thành viên. Các lợi ích của chương trình khách hàng thân thiết có thể xuất hiện trong trang thông tin miễn phí, quảng cáo Mua sắm và quảng cáo kho hàng tại địa phương trên các nền tảng của Google, bao gồm cả Google Tìm kiếm, thẻ Mua sắm và Google Wallet.
Với Merchant API, người bán và nhà cung cấp chương trình khách hàng thân thiết bên thứ ba thay mặt cho người bán có thể định cấu hình và duy trì chương trình khách hàng thân thiết theo phương thức lập trình bằng cách sử dụng LoyaltyProgramService. Dịch vụ này cho phép bạn tạo, truy xuất, liệt kê, cập nhật và xoá các chương trình khách hàng thân thiết.
Để biết thêm thông tin về các yêu cầu đối với doanh nghiệp và nguyên tắc chính sách, hãy xem bài viết Giới thiệu về chương trình khách hàng thân thiết của người bán trong Trung tâm trợ giúp của Merchant Center.
Khái niệm chính
Hãy lưu ý các khái niệm và giới hạn sau đây khi sử dụng chương trình khách hàng thân thiết:
- Giá trị nhận dạng ở cấp tài khoản: Merchant API xác định chương trình khách hàng thân thiết theo mã nhận dạng tài khoản Merchant Center sở hữu.
- Giới hạn về một chương trình: Merchant API chỉ hỗ trợ một chương trình khách hàng thân thiết cho mỗi tài khoản nhà bán hàng.
- Quyền sở hữu trực tiếp tài khoản: Bạn phải định cấu hình chương trình khách hàng thân thiết trực tiếp trên tài khoản nhà bán hàng mục tiêu (
accounts/{ACCOUNT_ID}). Dịch vụ này không hỗ trợ việc quản lý chương trình khách hàng thân thiết ở cấp tài khoản nâng cao cho tài khoản phụ. Các nhà cung cấp chương trình khách hàng thân thiết bên thứ ba có quyền truy cập được uỷ quyền vào tài khoản của người bán có thể quản lý chương trình thay cho người bán. - Đánh giá biên tập: Sau khi bạn tạo hoặc cập nhật một chương trình khách hàng thân thiết, chương trình đó sẽ được xem xét. Trường
review_result.review_statuscho biết chương trình có phải làUNDER_REVIEW,APPROVEDhayREJECTEDhay không. - Khu vực được hỗ trợ: Chương trình khách hàng thân thiết của người bán được cung cấp ở các quốc gia được hỗ trợ, bao gồm Úc, Brazil, Canada, Pháp, Đức, Ấn Độ, Ý, Mexico, Hà Lan, Hàn Quốc, Tây Ban Nha, Vương quốc Anh và Hoa Kỳ.
- Yêu cầu về cấp: Các cấp có thể không mất phí tham gia, yêu cầu phí thành viên, yêu cầu ngưỡng chi tiêu hoặc yêu cầu thẻ tín dụng mang thương hiệu của người bán. Chúng tôi không hỗ trợ các cấp dựa trên nghề nghiệp (chẳng hạn như cấp dành cho sinh viên hoặc quân nhân).
- Đặc quyền và lợi ích: Chương trình hỗ trợ phí vận chuyển miễn phí, điểm có thể sử dụng và giá dành cho thành viên. Trong quảng cáo, giá dành cho thành viên yêu cầu mức chiết khấu ít nhất là 5% hoặc 5 đơn vị tiền tệ so với giá thông thường hoặc giá ưu đãi.
Điều kiện tiên quyết
Trước khi quản lý chương trình khách hàng thân thiết bằng Merchant API, hãy đảm bảo bạn đáp ứng các yêu cầu sau:
- Bạn phải có một tài khoản Merchant Center đang hoạt động (hoặc có quyền truy cập được uỷ quyền vào tài khoản của người bán nếu bạn là nhà cung cấp chương trình khách hàng thân thiết bên thứ ba).
- Bật tiện ích bổ sung chương trình Khách hàng thân thiết cho tài khoản của bạn. Bạn có thể bật tiện ích bổ sung bằng một trong hai cách sau:
- Giao diện người dùng Merchant Center: Làm theo hướng dẫn trong bài viết Thiết lập chương trình khách hàng thân thiết trong phần Trợ giúp của Merchant Center.
- API phụ về chương trình: Bật chương trình theo phương thức lập trình như mô tả trong phần Bật chương trình trong API phụ về chương trình.
Sau đây là yêu cầu mẫu để bật tiện ích bổ sung Chương trình khách hàng thân thiết bằng cách sử dụng API phụ Chương trình:
HTTP
POST https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/loyalty:enable
cURL
curl --request POST \
'https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/loyalty:enable?key={YOUR_API_KEY}' \
--header 'Authorization: Bearer {YOUR_ACCESS_TOKEN}' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{}' \
--compressed
Phương thức
Quản lý chương trình khách hàng thân thiết bằng các phương thức sau:
loyaltyPrograms.createloyaltyPrograms.getloyaltyPrograms.listloyaltyPrograms.updateloyaltyPrograms.delete
Tạo chương trình khách hàng thân thiết
Để tạo một chương trình khách hàng thân thiết mới cho một tài khoản, hãy sử dụng phương thức loyaltyPrograms.create. Nêu rõ các thông tin chi tiết như nội dung mô tả chương trình, URL đăng ký và các cấp của chương trình cùng với các lợi ích và yêu cầu riêng biệt.
program_label bắt buộc đặt giá trị nhận dạng riêng biệt cho chương trình khách hàng thân thiết. Ví dụ: việc cung cấp nhãn my-rewards sẽ tạo ra một tài nguyên name của accounts/{ACCOUNT_ID}/programs/loyalty/loyaltyPrograms/my-rewards.
Sau đây là một yêu cầu mẫu:
HTTP
POST https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/loyalty/loyaltyPrograms
{
"programLabel": "my-rewards",
"loyaltyProgram": {
"programName": "my rewards",
"tiers": [
{
"tierName": "gold",
"tierLabel": "gold",
"tierBenefits": [
{
"otherBenefit": "free gift on your birthday"
},
{
"structuredBenefit": {
"pointsEarningBenefit": {
"minimumMoneySpent": {
"currencyCode": "USD",
"units": "25"
},
"pointsEarningBenefitAnnotation": {
"pointsEarned": 1.0,
"amountSpent": {
"currencyCode": "USD",
"units": "1"
}
}
}
}
}
],
"requirements": {
"freeToJoin": true
}
}
],
"programDescriptions": [
"earn rewards buying products you love"
],
"signupUrl": "https://www.example.com/my_rewards_signup",
"regionCodes": [
"US"
]
}
}
Thay thế {ACCOUNT_ID} bằng giá trị nhận dạng duy nhất của tài khoản Merchant Center.
Sau đây là một phản hồi mẫu cho yêu cầu thành công:
{
"name": "accounts/{ACCOUNT_ID}/programs/loyalty/loyaltyPrograms/my-rewards",
"programName": "my rewards",
"tiers": [
{
"tierName": "gold",
"tierLabel": "gold",
"tierBenefits": [
{
"otherBenefit": "free gift on your birthday"
},
{
"structuredBenefit": {
"pointsEarningBenefit": {
"minimumMoneySpent": {
"currencyCode": "USD",
"units": "25"
},
"pointsEarningBenefitAnnotation": {
"pointsEarned": 1.0,
"amountSpent": {
"currencyCode": "USD",
"units": "1"
}
}
}
}
}
],
"requirements": {
"freeToJoin": true
},
"signupUrl": "https://www.example.com/my-rewards/gold"
}
],
"programDescriptions": [
"earn rewards buying products you love"
],
"signupUrl": "https://www.example.com/my_rewards_signup",
"reviewResult": {
"reviewStatus": "UNDER_REVIEW"
},
"regionCodes": [
"US"
]
}
Truy xuất chương trình khách hàng thân thiết
Để truy xuất thông tin chi tiết về một chương trình khách hàng thân thiết cụ thể do bạn tự sở hữu, hãy sử dụng phương thức loyaltyPrograms.get.
Sau đây là một yêu cầu mẫu:
HTTP
GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/loyalty/loyaltyPrograms/{PROGRAM_LABEL}
Thay thế {ACCOUNT_ID} bằng mã tài khoản của bạn và {PROGRAM_LABEL} bằng nhãn riêng biệt của chương trình khách hàng thân thiết (ví dụ: my-rewards).
Sau đây là một phản hồi mẫu cho yêu cầu thành công:
{
"name": "accounts/{ACCOUNT_ID}/programs/loyalty/loyaltyPrograms/my-rewards",
"programName": "my rewards",
"tiers": [
{
"tierName": "gold",
"tierLabel": "gold",
"tierBenefits": [
{
"otherBenefit": "free gift on your birthday"
},
{
"structuredBenefit": {
"pointsEarningBenefit": {
"minimumMoneySpent": {
"currencyCode": "USD",
"units": "25"
},
"pointsEarningBenefitAnnotation": {
"pointsEarned": 1.0,
"amountSpent": {
"currencyCode": "USD",
"units": "1"
}
}
}
}
}
],
"requirements": {
"freeToJoin": true
},
"signupUrl": "https://www.example.com/my-rewards/gold"
}
],
"programDescriptions": [
"earn rewards buying products you love"
],
"signupUrl": "https://www.example.com/my_rewards_signup",
"reviewResult": {
"reviewStatus": "UNDER_REVIEW"
},
"regionCodes": [
"US"
]
}
Liệt kê chương trình khách hàng thân thiết
Để liệt kê tất cả chương trình khách hàng thân thiết thuộc sở hữu của bạn được liên kết với tài khoản của bạn, hãy sử dụng phương thức loyaltyPrograms.list.
Sau đây là một yêu cầu mẫu:
HTTP
GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/loyalty/loyaltyPrograms
Sau đây là một phản hồi mẫu cho yêu cầu thành công:
{
"loyaltyPrograms": [
{
"name": "accounts/{ACCOUNT_ID}/programs/loyalty/loyaltyPrograms/my-rewards",
"programName": "my rewards",
"tiers": [
{
"tierName": "gold",
"tierLabel": "gold",
"tierBenefits": [
{
"otherBenefit": "free gift on your birthday"
},
{
"structuredBenefit": {
"pointsEarningBenefit": {
"minimumMoneySpent": {
"currencyCode": "USD",
"units": "25"
},
"pointsEarningBenefitAnnotation": {
"pointsEarned": 1.0,
"amountSpent": {
"currencyCode": "USD",
"units": "1"
}
}
}
}
}
],
"requirements": {
"freeToJoin": true
},
"signupUrl": "https://www.example.com/my-rewards/gold"
}
],
"programDescriptions": [
"earn rewards buying products you love"
],
"signupUrl": "https://www.example.com/my_rewards_signup",
"reviewResult": {
"reviewStatus": "UNDER_REVIEW"
},
"regionCodes": [
"US"
]
}
]
}
Cập nhật chương trình khách hàng thân thiết
Để cập nhật một chương trình khách hàng thân thiết hiện có, hãy sử dụng phương thức loyaltyPrograms.update. Thực hiện một bản cập nhật một phần bằng cách sử dụng update_mask hoặc thực hiện thay thế hoàn toàn bằng cách bỏ qua mặt nạ.
Cập nhật một phần bằng mặt nạ cập nhật
update_mask cho phép bạn chỉ định chính xác các trường cần cập nhật. Chỉ những trường có trong mặt nạ mới được sửa đổi, còn những trường không có trong mặt nạ sẽ không thay đổi. Mọi trường bị bỏ qua trong mặt nạ cập nhật đều bị bỏ qua, ngay cả khi được cung cấp trong phần nội dung yêu cầu.
Yêu cầu mẫu sau đây chỉ cập nhật programDescriptions và advancedSettings:
HTTP
PATCH https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/loyalty/loyaltyPrograms/{PROGRAM_LABEL}?update_mask=program_descriptions,advanced_settings
{
"programDescriptions": [
"a new description of the program"
],
"advancedSettings": {
"hideDisplayFromNonMembers": true
},
"signupUrl": "https://www.example.com"
}
Trong ví dụ này, dịch vụ sẽ bỏ qua signupUrl vì không có trong update_mask. Trường programDescriptions sẽ thay thế hoàn toàn mọi nội dung mô tả đã định cấu hình trước đó.
Sau đây là một phản hồi mẫu từ một yêu cầu thành công:
{
"name": "accounts/{ACCOUNT_ID}/programs/loyalty/loyaltyPrograms/my-rewards",
"programName": "my rewards",
"tiers": [
{
"tierName": "gold",
"tierLabel": "gold",
"tierBenefits": [
{
"otherBenefit": "free gift on your birthday"
},
{
"structuredBenefit": {
"pointsEarningBenefit": {
"minimumMoneySpent": {
"currencyCode": "USD",
"units": "25"
},
"pointsEarningBenefitAnnotation": {
"pointsEarned": 1.0,
"amountSpent": {
"currencyCode": "USD",
"units": "1"
}
}
}
}
}
],
"requirements": {
"freeToJoin": true
},
"signupUrl": "https://www.example.com/my-rewards/gold"
}
],
"programDescriptions": [
"a new description of the program"
],
"signupUrl": "https://www.example.com/my_rewards_signup",
"reviewResult": {
"reviewStatus": "UNDER_REVIEW"
},
"regionCodes": [
"US"
],
"advancedSettings": {
"hideDisplayFromNonMembers": true
}
}
Thay thế hoàn toàn mà không có mặt nạ cập nhật
Khi bạn bỏ qua tham số update_mask, yêu cầu sẽ thực hiện việc thay thế hoàn toàn cấu hình chương trình khách hàng thân thiết.
Sau đây là một yêu cầu mẫu:
HTTP
PATCH https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/loyalty/loyaltyPrograms/{PROGRAM_LABEL}
{
"programName": "Updated Program",
"signupUrl": "https://example.com/updated",
"programDescriptions": [
"Updated description"
],
"regionCodes": [
"US"
],
"tiers": [
{
"tierName": "Gold Tier",
"tierLabel": "gold",
"tierBenefits": [
{
"otherBenefit": "Free shipping"
}
],
"requirements": {
"freeToJoin": true
}
}
]
}
Sau đây là một phản hồi mẫu từ một yêu cầu thành công:
{
"name": "accounts/{ACCOUNT_ID}/programs/loyalty/loyaltyPrograms/my-rewards",
"programName": "Updated Program",
"tiers": [
{
"tierName": "Gold Tier",
"tierLabel": "gold",
"tierBenefits": [
{
"otherBenefit": "Free shipping"
}
],
"requirements": {
"freeToJoin": true
}
}
],
"programDescriptions": [
"Updated description"
],
"signupUrl": "https://example.com/updated",
"reviewResult": {
"reviewStatus": "UNDER_REVIEW"
},
"regionCodes": [
"US"
]
}
Xoá chương trình khách hàng thân thiết
Để xoá một chương trình khách hàng thân thiết khỏi tài khoản của bạn, hãy sử dụng phương thức loyaltyPrograms.delete.
Sau đây là một yêu cầu mẫu:
HTTP
DELETE https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/loyalty/loyaltyPrograms/{PROGRAM_LABEL}
Nếu thành công, phần nội dung phản hồi sẽ trống.
Các bước tiếp theo
- Để liên kết từng người mua sắm với các cấp của chương trình khách hàng thân thiết để cá nhân hoá tự nhiên trên Google Tìm kiếm, hãy xem hướng dẫn về Dịch vụ so khớp khách hàng thân thiết.
- Để bật hoặc tắt các chương trình mua sắm cho tài khoản của bạn, hãy xem Hướng dẫn về API phụ của chương trình.
- Để biết thông tin chi tiết về chế độ thiết lập doanh nghiệp, chính sách biên tập và báo cáo, hãy xem phần Giới thiệu về chương trình khách hàng thân thiết của người bán trong Trung tâm trợ giúp của Merchant Center.
- Để khám phá các phương thức API và định nghĩa tài nguyên, hãy xem tài liệu tham khảo về Merchant API.