Google'da sattığınız ürünlerle ilgili özel teklifleri göstermek için promosyonları kullanın. Promosyonlar; Google Arama, Alışveriş ve Chrome dahil olmak üzere farklı Google mülklerinde gösterilir.
Ürünlerinize Promosyonlar'ı eklediğinizde, tüketiciler "%15 indirim" veya "Ücretsiz kargo" gibi bir özel teklif bağlantısı görür. Fırsat bağlantıları, ürünlerinizin daha çok ilgi çekmesini sağlar ve tüketicileri satın almaya teşvik eder.
Daha fazla bilgi için Tanıtımla ilgili temel bilgiler konusuna bakın.
Ön koşullar
Google, promosyonlarınızı göstermeden önce işletmeniz ve ürünleriniz hakkında belirli bilgiler sağlamanızı gerektirir. Aşağıdakilere sahip olmanız gerekir:
- Google Merchant Center'da etkin bir ürün feed'i olmalıdır.
- Google Merchant Center'da etkin bir promosyon feed'i.
- Alışveriş kampanyaları için bir Google Ads hesabı.
Ayrıca, satıcı hesabınızı Promosyonlar programına kaydetmeniz gerekir. Daha önce kaydolup kaydolmadığınızdan emin değilseniz Merchant Center'a göz atın.
Kaydolmadıysanız istek formunu doldurun. Uygulamaya başlamaya hazır olduğunuzda tanıtımlar ekibi sizi bilgilendirir.
Daha fazla bilgi için Katılım kriterleri ve politikaları bölümüne bakın.
Veri kaynağı oluşturma
Promosyon feed'i oluşturmak için datasource.create API'sini kullanın. Mevcut bir Tanıtım feed'i varsa datasource.name öğesini getirmek için datasource.get kullanın
Talep formu 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
Promosyon oluşturmak veya güncellemek için accounts.promotions.insert
yöntemini kullanabilirsiniz. accounts.promotions.insert
yöntemi, giriş olarak bir promotions
kaynağı ve veri kaynağı adını alır. Başarılı olursa yeni veya güncellenmiş promosyonu döndürür.
Promosyon oluşturmak için datasource.name gereklidir.
Google, dağıtmadan önce promosyonlarınızı inceleyip onaylar. Daha fazla bilgi için Promosyon onay süreci bölümüne bakın.
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: Tüm ürünler ve tüm mağazalar için geçerli olan bir yerel promosyon
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: Teklif kullanma kodu bulunan seçili ürünlere uygulanan online promosyon
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 özellikleri ekleme bölümüne bakın.
Promosyonları oluşturmadan ve yönetmeden önce Promosyonlarla İlgili En İyi Uygulamalar'ı inceleyin.
Promosyonları göster
Bir promosyonu görüntülemek için accounts.promotions.get
simgesini kullanın.
Bu alma salt okunurdur. merchantId
ve promosyonun kimliği gereklidir. 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
Oluşturulan tüm promosyonları görüntülemek için promotions.list
yöntemini kullanabilirsiniz.
GET https://merchantapi.googleapis.com/promotions/v1beta/{parent=accounts/*}/promotions
Promosyon durumu
Bir promosyonun durumunu görmek için promotions.get
ve promotions.list
tarafından döndürülen promotionStatus özelliğini görüntüleyebilirsiniz.
Onay sürecini anlamak için Promosyon onay süreci bölümüne göz atın.
Örnek promosyon durumu
Aşağıdaki örnekler, başarılı ve başarısız istekler arasındaki farkı göstermektedir.
Örnek 1. Aşağıdaki yanıt gövdesinde, ürün eşlemenin eksik olması nedeniyle reddedilecek online bir promosyon gösterilmektedir.
"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 Merkezi'ne bakın.
Content API for Shopping'den geçiş hakkında bilgi edinmek için Promosyon yönetimini taşıma bölümünü inceleyin.