Sử dụng chương trình khuyến mãi để giới thiệu ưu đãi đặc biệt cho các sản phẩm mà bạn bán trên Google. Chương trình khuyến mãi xuất hiện trên nhiều sản phẩm của Google, bao gồm cả Google Tìm kiếm, Mua sắm và Chrome.
Khi bạn thêm Chương trình khuyến mãi vào sản phẩm, người mua sắm sẽ thấy một đường liên kết đến ưu đãi đặc biệt, ví dụ: "Giảm 15%" hoặc "Miễn phí vận chuyển". Đường liên kết đến ưu đãi có thể tăng sức hấp dẫn cho các sản phẩm của bạn và khuyến khích người mua sắm mua hàng.
Để biết thêm thông tin, hãy xem bài viết Kiến thức cơ bản về chương trình khuyến mãi.
Điều kiện tiên quyết
Trước khi hiển thị chương trình khuyến mãi của bạn, Google cần bạn cung cấp thông tin cụ thể về doanh nghiệp và sản phẩm. Bạn phải có:
- Một nguồn cấp dữ liệu sản phẩm đang hoạt động trong Google Merchant Center.
- Nguồn cấp dữ liệu chương trình khuyến mãi đang hoạt động trong Google Merchant Center.
- Tài khoản Google Ads cho chiến dịch Mua sắm.
Ngoài ra, bạn phải đăng ký tài khoản người bán của mình tham gia chương trình Khuyến mãi. Nếu bạn không chắc chắn liệu mình đã đăng ký hay chưa, hãy kiểm tra trong Merchant Center.
Nếu bạn chưa đăng ký, hãy hoàn tất biểu mẫu yêu cầu. Nhóm khuyến mãi sẽ thông báo cho bạn khi bạn đã chuẩn bị đầy đủ để bắt đầu triển khai.
Để biết thêm thông tin, hãy xem Chính sách và tiêu chí tham gia.
Tạo một nguồn dữ liệu
Sử dụng API datasource.create để tạo nguồn cấp dữ liệu khuyến mãi. Nếu có nguồn cấp dữ liệu Chương trình khuyến mãi hiện có, hãy sử dụng phương thức accounts.dataSources.get để tìm nạp tên của nguồn dữ liệu.
Dạng của yêu cầu như sau:
POST https://merchantapi.googleapis.com/datasources/v1beta/accounts/{ACCOUNT}/dataSources
Ví dụ:
Ví dụ này cho thấy một yêu cầu và phản hồi thông thường.
Yêu cầu:
POST https://merchantapi.googleapis.com/datasources/v1beta/accounts/123/dataSources {"displayName": "test api feed", "promotionDataSource":{"targetCountry":"US", "contentLanguage":"en"}}
Phản hồi:
{
"name": "accounts/123/dataSources/1000000573361824",
"dataSourceId": "1000000573361824",
"displayName": "test api feed",
"promotionDataSource": {
"targetCountry": "US",
"contentLanguage": "en"
},
"input": "API"
}
Tạo quảng cáo
Bạn có thể sử dụng phương thức accounts.promotions.insert để tạo hoặc cập nhật chương trình khuyến mãi. Phương thức accounts.promotions.insert lấy tài nguyên promotions và tên nguồn dữ liệu làm dữ liệu đầu vào. Phương thức này trả về chương trình khuyến mãi mới hoặc đã cập nhật nếu thành công.
Khi tạo chương trình khuyến mãi, bạn cần có tên của nguồn dữ liệu.
Google sẽ xem xét và phê duyệt chương trình khuyến mãi của bạn trước khi phân phối. Để biết thêm thông tin, hãy xem Quy trình phê duyệt chương trình khuyến mãi.
Hình thức của yêu cầu:
POST https://merchantapi.googleapis.com/promotions/v1beta/{parent=accounts/*/}promotions:insert
Hãy nghiên cứu các chương trình khuyến mãi mẫu sau đây để tham khảo.
Mẫu 1: Chương trình khuyến mãi tại cửa hàng địa phương áp dụng cho tất cả sản phẩm và tất cả cửa hàng
POST https://merchantapi.googleapis.com/promotions/v1beta/accounts/123/promotions:insert
{
"promotion": {
"promotionId": "buy_2_get_10_off",
"contentLanguage": "en",
"targetCountry": "US",
"redemptionChannel": [
"IN_STORE"
],
"attributes": {
"longTitle": "Buy 2 and get 10$ OFF purchase",
"productApplicability": "ALL_PRODUCTS",
"offerType": "NO_CODE",
"couponValueType": "BUY_M_GET_MONEY_OFF",
"promotionDisplayTimePeriod": {
"startTime": "2024-2-06T00:47:44Z",
"endTime": "2024-5-06T00:47:44Z"
},
"promotionEffectiveTimePeriod": {
"startTime": "2024-2-06T00:47:44Z",
"endTime": "2024-5-06T00:47:44Z"
},
"moneyOffAmount": {
"amountMicros": "1000000",
"currencyCode": "USD"
},
"minimumPurchaseQuantity": 2,
"storeApplicability": "ALL_STORES",
"promotionUrl": "http://promotionnew4url.com/",
"promotionDestinations": [
"LOCAL_INVENTORY_ADS"
],
}
},
"dataSource": "accounts/123/dataSources/1000000573361824"
}
Mẫu 2: Chương trình khuyến mãi trực tuyến áp dụng cho một số sản phẩm được chọn bằng mã sử dụng
POST https://merchantapi.googleapis.com/promotions/v1beta/accounts/123/promotions:insert
{
"promotion": {
"promotionId": "25_pct_off",
"contentLanguage": "en",
"targetCountry": "US",
"redemptionChannel": [
"ONLINE"
],
"attributes": {
"longTitle": "10% off on selected items",
"productApplicability": "SPECIFIC_PRODUCTS",
"offerType": "GENERIC_CODE",
"genericRedemptionCode": "SPRINGSALE",
"couponValueType": "PERCENT_OFF",
"promotionDisplayTimePeriod": {
"startTime": "2024-2-06T00:47:44Z",
"endTime": "2024-5-06T00:47:44Z"
},
"promotionEffectiveTimePeriod": {
"startTime": "2024-2-06T00:47:44Z",
"endTime": "2024-5-06T00:47:44Z"
},
"percentOff": 25,
"promotionDestinations": [
"FREE_LISTINGS"
],
"itemIdInclusion": [
"1499860100",
"1499860101",
"1499860102",
"1499860103",
"1499860104"
],
}
},
"dataSource": "accounts/123/dataSources/1000000573361824"
}
Ghi chú đặc biệt
Sau khi bạn tạo chương trình khuyến mãi, có thể mất vài phút thì chương trình khuyến mãi mới xuất hiện trong cơ sở dữ liệu Mua sắm.
Để biết danh sách các thuộc tính liên quan đến chương trình khuyến mãi, hãy xem bài viết Thêm thuộc tính dữ liệu có cấu trúc.
Trước khi tạo và quản lý chương trình khuyến mãi, hãy xem Các phương pháp hay nhất cho chương trình khuyến mãi.
Xem quảng cáo
Để xem một chương trình khuyến mãi, hãy sử dụng accounts.promotions.get.
Lệnh get này chỉ có thể đọc. Phương thức này yêu cầu merchantId và mã của chương trình khuyến mãi. Phương thức get trả về tài nguyên chương trình khuyến mãi tương ứng.
Ví dụ:
GET https://merchantapi.googleapis.com/promotions/v1beta/{name=accounts/*/promotions/*}
Hãy nghiên cứu các mẫu này.
Mẫu 1: Khuyến mãi tại địa phương
GET https://merchantapi.googleapis.com/promotions/v1beta/accounts/123/promotions/in_store~en~US~buy_2_get_10_off
{
"name": "accounts/123/promotions/in_store~en~US~buy_2_get_10_off",
"promotionId": "buy_2_get_10_off",
"contentLanguage": "en",
"targetCountry": "US",
"redemptionChannel": [
"IN_STORE"
],
"attributes": {
"longTitle": "Buy 2 and get 10$ OFF purchase",
"productApplicability": "ALL_PRODUCTS",
"offerType": "NO_CODE",
"couponValueType": "BUY_M_GET_MONEY_OFF",
"promotionDisplayTimePeriod": {
"startTime": "2024-2-06T00:47:44Z",
"endTime": "2024-5-06T00:47:44Z"
},
"promotionEffectiveTimePeriod": {
"startTime": "2024-2-06T00:47:44Z",
"endTime": "2024-5-06T00:47:44Z"
},
"moneyOffAmount": {
"amountMicros": "1000000",
"currencyCode": "USD"
},
"minimumPurchaseQuantity": 2,
"storeApplicability": "ALL_STORES",
"promotionUrl": "http://promotionnew4url.com/",
"promotionDestinations": [
"LOCAL_INVENTORY_ADS"
],
}
"dataSource": "accounts/123/dataSources/1000000573361824"
}
Mẫu 2. Chương trình khuyến mãi trực tuyến
GET https://merchantapi.googleapis.com/promotions/v1beta/accounts/123/promotions/online~en~US~25_pct_off
{
"name": "accounts/123/promotions/online~en~US~25_pct_off",
"promotionId": "25_pct_off",
"contentLanguage": "en",
"targetCountry": "US",
"redemptionChannel": [
"ONLINE"
],
"attributes": {
"longTitle": "10% off on selected items",
"productApplicability": "SPECIFIC_PRODUCTS",
"offerType": "GENERIC_CODE",
"genericRedemptionCode": "WINTERGIFT",
"couponValueType": "PERCENT_OFF",
"promotionDisplayTimePeriod": {
"startTime": "2024-2-06T00:47:44Z",
"endTime": "2024-5-06T00:47:44Z"
},
"promotionEffectiveTimePeriod": {
"startTime": "2024-2-06T00:47:44Z",
"endTime": "2024-5-06T00:47:44Z"
},
"percentOff": 25,
"promotionDestinations": [
"FREE_LISTINGS"
],
"itemIdInclusion": [
"1499860100",
"1499860101",
"1499860102",
"1499860103",
"1499860104"
],
}
"dataSource": "accounts/{account}/dataSources/{dataSource}"
}
Liệt kê chương trình khuyến mãi
Bạn có thể sử dụng phương thức promotions.list để xem tất cả chương trình khuyến mãi đã tạo.
GET https://merchantapi.googleapis.com/promotions/v1beta/{parent=accounts/*}/promotions
Trạng thái chương trình khuyến mãi
Để xem trạng thái của chương trình khuyến mãi, bạn có thể xem thuộc tính promotionStatus do promotions.get và promotions.list trả về.
Để hiểu rõ quy trình phê duyệt, hãy xem bài viết Quy trình phê duyệt chương trình khuyến mãi.
Trạng thái chương trình khuyến mãi mẫu
Các mẫu sau đây minh hoạ sự khác biệt giữa các yêu cầu thành công và không thành công.
Mẫu 1. Nội dung phản hồi sau đây cho thấy một chương trình khuyến mãi trực tuyến sẽ bị từ chối do thiếu liên kết sản phẩm.
"promotionStatus": {
"destinationStatuses": [
{
"reportingContext": "FREE_LISTINGS",
"status": "REJECTED"
}
],
"itemLevelIssues": [
{
"code": "promotion_sku_unmapped",
"severity": "DISAPPROVED",
"resolution": "merchant_action",
"reportingContext": "FREE_LISTINGS",
"description": "Unmapped",
"detail": "This promotion couldn't be tested during review because it doesn't apply to any products that are currently in your Products feed",
"documentation": "https://support.google.com/merchants/answer/2906014",
"applicableCountries": [
"US"
]
},
{
"code": "promotion_sku_additional_requirements",
"severity": "DISAPPROVED",
"resolution": "merchant_action",
"reportingContext": "FREE_LISTINGS",
"description": "Promotion conditions not allowed",
"detail": "This promotion has additional requirements that are not allowed such as requiring customers to verify additional details like phone number or ID before showing the promotion details",
"documentation": "https://support.google.com/merchants/answer/2906014",
"applicableCountries": [
"US"
]
}
]
}
Mẫu 2. Nội dung phản hồi sau đây cho thấy một chương trình khuyến mãi vẫn đang được đánh giá.
"promotionStatus": {
"destinationStatuses": [
{
"reportingContext": "FREE_LISTINGS",
"status": "PENDING"
},
{
"destination": "SHOPPING_ADS",
"status": "PENDING"
}
],
"itemLevelIssues": []
}
Mẫu 3. Chương trình khuyến mãi đã được phê duyệt và đang hoạt động
"promotionStatus": {
"destinationStatuses": [
{
"reportingContext": "FREE_LISTINGS",
"status": "LIVE"
},
{
"destination": "SHOPPING_ADS",
"status": "LIVE"
} ],
"itemLevelIssues": []
}
Tìm hiểu thêm
Để biết thêm thông tin, hãy xem Trung tâm trợ giúp về chương trình khuyến mãi.
Để tìm hiểu về cách di chuyển từ Content API for Shopping, hãy xem bài viết Di chuyển tính năng quản lý chương trình khuyến mãi.