Google'da sattığınız ürünlerle ilgili özel teklifleri göstermek için promosyonları kullanın. Promosyonlar, Google Arama, Google Arama, Alışveriş ve Chrome.
Ürünlerinize Promosyonlar'ı eklediğinizde, tüketiciler örnek "%15 indirim" veya "Ücretsiz kargo". Teklif bağlantıları, kampanyanın daha çok ilgi çekmesini ve alışveriş yapan kullanıcıları satın almaya teşvik edebilir.
Daha fazla bilgi için bkz. Tanıtım temel bilgileri inceleyin.
Ön koşullar
Google'ın sizden işletmeniz ve daha fazlası hakkında her şeyi kontrol edin. Aşağıdakilere sahip olmanız gerekir:
- Etkin bir ürün feed'i Google Merchant Center.
- Etkin promosyonlar feed'i Google Merchant Center.
- Bir Google Ads hesabı Alışveriş için kampanyalar.
Ayrıca, satıcı hesabınızı Promosyonlar programına kaydetmeniz gerekir. Eğer daha önce kaydolmadığınızdan emin değilseniz Satıcı Merkezi.
Kaydolmadıysanız isteği tamamlayın formunu doldurun. İlgili içeriği oluşturmak için kullanılan Uygulamaya başlamaya hazır olduğunuzda promosyonlar ekibi sizi bilgilendirir.
Daha fazla bilgi için Katılım kriterleri ve politikalar hakkında daha fazla bilgi edinin.
Veri kaynağı oluşturma
Promosyon feed'i oluşturmak için datasource.create API'sini kullanın. Mevcut bir Promosyon feed'i mevcut. Şunu getirmek için datasource.get kullanın: datasource.name
Talebin biçimi aşağıdaki gibidir:
POST https://merchantapi.googleapis.com/promotions/v1beta/accounts/{account}/dataSources/{datasource}
Örnek
Örnekte tipik bir istek ve yanıt gösterilmektedir.
İstek:
POST https://merchantapi.googleapis.com/datasources/v1beta/accounts/123/dataSources {"displayName": "test api feed", "promotionDataSource":{"targetCountry":"US", "contentLanguage":"en"}}
Yanıt:
{
"name": "accounts/123/dataSources/1000000573361824",
"dataSourceId": "1000000573361824",
"displayName": "test api feed",
"promotionDataSource": {
"targetCountry": "US",
"contentLanguage": "en"
},
"input": "API"
}
Promosyon oluşturma
URL parametrelerinin Google tarafından nasıl ele alınmasını istediğinizi belirtmek için
accounts.promotions.insert
promosyon oluşturma veya güncelleme yöntemini kullanabilirsiniz. accounts.promotions.insert yöntemi
giriş olarak bir promotions kaynağı ve bir veri kaynağı adı alır. Şunu döndürür:
başarılı olursa yeni veya güncellenmiş promosyonu
Promosyon oluşturmak için gerekenler datasource.name.
Google, dağıtmadan önce promosyonlarınızı inceleyip onaylar. Daha fazla Promosyon onayı işlemi hakkında daha fazla bilgi edinin.
Talebin biçimi:
POST https://merchantapi.googleapis.com/promotions/v1beta/{parent=accounts/*/}promotions:insert
Referans olması amacıyla aşağıdaki örnek promosyonları inceleyin.
1. Örnek: Yerel promosyon tüm ürünlerin ve tüm mağazaların
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"
}
2. Örnek: Tekliften yararlanılan seçili ürünlere uygulanan online promosyon kod
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"
}
Özel notlar
Promosyon oluşturulduktan sonra promosyonun oluşturulması birkaç dakika sürebilir.
Promosyonlarla ilgili özelliklerin listesi için Yapılandırılmış veri ekleme başlıklı makaleyi inceleyin. özellikleri ile birlikte kullanılamaz.
Promosyon oluşturup yönetmeden önce En İyi Promosyonlar Promosyonları Uygulamalar.
Promosyonları göster
Bir promosyonu görüntülemek için şunu kullanın:
accounts.promotions.get.
Bu alma salt okunurdur. merchantId ve
promosyon'a dokunun. get yöntemi, ilgili promosyon kaynağını döndürür.
Örneğin:
GET https://merchantapi.googleapis.com/promotions/v1beta/{name=accounts/*/promotions/*}
Bu örnekleri inceleyin.
1. Örnek: Yerel bir promosyon
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"
}
Örnek 2. Online tanıtım
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}"
}
Tanıtımları listele
URL parametrelerinin Google tarafından nasıl ele alınmasını istediğinizi belirtmek için
promotions.list
yöntemini kullanın.
GET https://merchantapi.googleapis.com/promotions/v1beta/{parent=accounts/*}/promotions
Promosyon durumu
Bir promosyonun durumunu görmek için promotionStatus özelliğini görüntüleyebilirsiniz
iade eden:
promotions.get
ve
promotions.list.
Onay sürecini anlamak için Promosyon onayı işlemi hakkında daha fazla bilgi edinin.
Örnek promosyon durumu
Aşağıdaki örnekler başarılı ve başarısız arasındaki farkı göstermektedir kabul edersiniz.
Örnek 1. Aşağıdaki yanıt gövdesinde, eksik ürün eşleme nedeniyle reddedildi.
"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"
]
}
]
}
Örnek 2. Aşağıdaki yanıt gövdesinde onaylanmış bir promosyon gösteriliyor.
"promotionStatus": {
"destinationStatuses": [
{
"reportingContext": "FREE_LISTINGS",
"status": "PENDING"
},
{
"destination": "SHOPPING_ADS",
"status": "PENDING"
}
],
"itemLevelIssues": []
}
Örnek 3. Onaylanmış ve yayında olan bir promosyon
"promotionStatus": {
"destinationStatuses": [
{
"reportingContext": "FREE_LISTINGS",
"status": "LIVE"
},
{
"destination": "SHOPPING_ADS",
"status": "LIVE"
} ],
"itemLevelIssues": []
}
Daha fazla bilgi
Daha fazla bilgi için Tanıtımlar Yardımı'na bakın Merkezi.
Content API for Shopping'den geçiş hakkında bilgi edinmek için Promosyonları taşıma başlıklı makaleyi inceleyin. yönetimi hakkında daha fazla bilgi edinin.