Sử dụng chương trình khuyến mãi để giới thiệu các ưu đãi đặc biệt cho các sản phẩm bạn bán trên Google. Chương trình khuyến mãi hiển thị trên nhiều sản phẩm của Google, bao gồm cả Google Tìm kiếm, Google 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 ưu đãi đặc biệt, ví dụ: "Giảm giá 15%" hoặc "Giao hàng miễn phí". Đường liên kết của ưu đãi có thể giúp tăng sức hút 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ề quảng cáo.
Điều kiện tiên quyết
Google cần bạn cung cấp thông tin cụ thể về doanh nghiệp và sản phẩm của bạn trước khi hiển thị chương trình khuyến mãi. 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.
- Một nguồn cấp dữ liệu 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ý cho 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 mình đã đăng ký hay chưa, hãy kiểm tra Merchant Center.
Nếu bạn chưa đăng ký, hãy hoàn thành biểu mẫu yêu cầu. Nhóm khuyến mãi sẽ thông báo cho bạn khi nào bạn đã sẵn sàng bắt đầu triển khai.
Để biết thêm thông tin, vui lòng 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 khuyến mãi hiện có, hãy sử dụng datasource.get để tìm nạp datasource.name
Biểu mẫu của yêu cầu này như sau:
POST https://merchantapi.googleapis.com/promotions/v1beta/accounts/{account}/dataSources/{datasource}
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 đầu vào. Phương thức này sẽ trả về chương trình khuyến mãi mới hoặc đã cập nhật nếu thành công.
Bạn cần có datasource.name để tạo chương trình khuyến mãi.
Google 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 bài viết Quy trình phê duyệt chương trình khuyến mãi.
Biểu mẫu của yêu cầu:
POST https://merchantapi.googleapis.com/promotions/v1beta/{parent=accounts/*/}promotions:insert
Nghiên cứu các chương trình khuyến mãi mẫu sau để tham khảo.
Mẫu 1: Một Chương trình khuyến mãi tại đị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"
},
"minimum_purchase_quantity": 2,
"storeApplicability": "ALL_STORES",
"promotionUrl": "http://promotionnew4url.com/",
"promotionDestinations": [
"LOCAL_INVENTORY_ADS"
],
}
},
"dataSource": "accounts/123/dataSources/1000000573361824"
}
Mẫu 2: Một chương trình khuyến mãi trực tuyến áp dụng cho các sản phẩm đã chọn có mã sử dụng ưu đãi
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 tạo chiến dịch quảng bá, có thể mất vài phút để tạo chiến dịch quảng bá.
Để 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 chương trình khuyến mãi, hãy sử dụng accounts.promotions.get.
Hàm get này ở chế độ chỉ đọc. Phương thức này yêu cầu bạn sử dụng merchantId và mã nhận dạng 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 những mẫu này.
Mẫu 1: Chương trình 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"
},
"minimum_purchase_quantity": 2,
"storeApplicability": "ALL_STORES",
"promotionUrl": "http://promotionnew4url.com/",
"promotionDestinations": [
"LOCAL_INVENTORY_ADS"
],
}
"dataSource": "accounts/123/dataSources/1000000573361824"
}
Mẫu 2. Quảng cáo 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ả cá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 khuyến mãi
Để xem trạng thái của một 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ề.
Để tìm hiểu 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 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 biết 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 đã được phê duyệt.
"promotionStatus": {
"destinationStatuses": [
{
"reportingContext": "FREE_LISTINGS",
"status": "PENDING"
},
{
"destination": "SHOPPING_ADS",
"status": "PENDING"
}
],
"itemLevelIssues": []
}
Mẫu 3. Quảng cáo đang hoạt động và đã được phê duyệt
"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 cho Mua sắm, hãy xem phần Di chuyển hoạt động quản lý chương trình khuyến mãi.