Gunakan promosi untuk menampilkan penawaran spesial produk yang Anda jual di Google. Promosi ditampilkan di berbagai properti Google, termasuk Google Penelusuran, Shopping, dan Chrome.
Saat Anda menambahkan Promosi ke produk Anda, pembeli akan melihat link penawaran spesial untuk contoh "diskon 15%" atau "Gratis ongkos kirim". Link penawaran dapat meningkatkan daya tarik produk Anda dan mendorong pembeli untuk melakukan pembelian.
Untuk informasi selengkapnya, lihat Promosi dasar-dasar.
Prasyarat
Google meminta Anda memberikan informasi spesifik tentang bisnis Anda dan sebelum menampilkan promosi Anda. Anda harus memiliki hal berikut:
- Produk aktif feed di Google Merchant Center.
- Promosi aktif feed di Google Merchant Center.
- Akun Google Ads untuk Shopping kampanye.
Selain itu, Anda harus mendaftarkan akun penjual Anda dalam program Promosi. Jika jika tidak yakin apakah Anda sudah terdaftar, periksa Google.
Jika Anda tidak terdaftar, lengkapi permintaan formulir ini. Tujuan tim promosi akan memberi tahu kapan Anda siap untuk memulai implementasi.
Untuk informasi selengkapnya, lihat Kriteria partisipasi dan kebijakan yang relevan.
Membuat sumber data
Gunakan API datasource.create untuk membuat feed promo. Jika pelanggan Feed promo tersedia, gunakan datasource.get untuk mengambil datasource.name
Bentuk permintaannya adalah sebagai berikut:
POST https://merchantapi.googleapis.com/promotions/v1beta/accounts/{account}/dataSources/{datasource}
Contoh
Contoh ini menunjukkan permintaan dan respons yang umum.
Permintaan:
POST https://merchantapi.googleapis.com/datasources/v1beta/accounts/123/dataSources {"displayName": "test api feed", "promotionDataSource":{"targetCountry":"US", "contentLanguage":"en"}}
Respons:
{
"name": "accounts/123/dataSources/1000000573361824",
"dataSourceId": "1000000573361824",
"displayName": "test api feed",
"promotionDataSource": {
"targetCountry": "US",
"contentLanguage": "en"
},
"input": "API"
}
Buat promosi
Anda dapat menggunakan
accounts.promotions.insert
untuk membuat atau memperbarui promosi. Metode accounts.promotions.insert
menggunakan resource promotions
dan nama sumber data sebagai input. Metode ini mengembalikan
promosi baru atau yang diperbarui
jika berhasil.
Membuat promosi memerlukan datasource.name.
Google meninjau dan menyetujui promosi Anda sebelum mendistribusikannya. Untuk selengkapnya informasi, lihat Persetujuan promosi {i>checkout<i}.
Bentuk permintaan:
POST https://merchantapi.googleapis.com/promotions/v1beta/{parent=accounts/*/}promotions:insert
Pelajari contoh promosi berikut sebagai referensi.
Contoh 1: Lokal promosi berlaku untuk semua produk dan semua toko
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"
}
Contoh 2: Promosi online yang diterapkan untuk produk yang dipilih dengan penukaran kode
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"
}
Catatan khusus
Setelah pembuatan promosi, mungkin perlu waktu beberapa menit untuk membuat promosi.
Untuk mengetahui daftar atribut terkait promosi, lihat Menambahkan data terstruktur atribut.
Sebelum membuat dan mengelola promosi, lihat Promosi Terbaik Praktik.
Lihat promosi
Untuk melihat promosi, gunakan
accounts.promotions.get
Get ini bersifat hanya baca. Proses ini memerlukan merchantId
Anda dan ID
promosi. Metode get
akan menampilkan resource promosi yang sesuai.
Contoh:
GET https://merchantapi.googleapis.com/promotions/v1beta/{name=accounts/*/promotions/*}
Pelajari contoh-contoh ini.
Contoh 1: Promosi lokal
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"
}
Contoh 2. Promosi online
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}"
}
Menampilkan daftar promosi
Anda dapat menggunakan
promotions.list
untuk melihat semua promosi yang dibuat.
GET https://merchantapi.googleapis.com/promotions/v1beta/{parent=accounts/*}/promotions
Status promosi
Untuk melihat status promosi, Anda dapat melihat atribut promotionStatus
dikembalikan oleh
promotions.get
dan
promotions.list
Untuk memahami proses persetujuan, lihat Persetujuan promosi {i>checkout<i}.
Contoh status promosi
Contoh berikut menunjukkan perbedaan antara keberhasilan dan kegagalan permintaan.
Contoh 1. Isi respons berikut menunjukkan promosi online yang ditolak karena pemetaan produk tidak ada.
"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"
]
}
]
}
Contoh 2. Isi respons berikut menunjukkan promosi yang disetujui.
"promotionStatus": {
"destinationStatuses": [
{
"reportingContext": "FREE_LISTINGS",
"status": "PENDING"
},
{
"destination": "SHOPPING_ADS",
"status": "PENDING"
}
],
"itemLevelIssues": []
}
Contoh 3. Promosi aktif yang disetujui
"promotionStatus": {
"destinationStatuses": [
{
"reportingContext": "FREE_LISTINGS",
"status": "LIVE"
},
{
"destination": "SHOPPING_ADS",
"status": "LIVE"
} ],
"itemLevelIssues": []
}
Pelajari lebih lanjut
Untuk mengetahui detail selengkapnya, lihat Bantuan Promosi Google.
Untuk mempelajari cara bermigrasi dari Content API for Shopping, lihat Memigrasikan promosi Google Workspace.