Mit Angeboten können Sie Sonderangebote für Produkte präsentieren, die Sie auf Google verkaufen. Angebote werden in verschiedenen Google-Produkten wie der Google Suche, Shopping und Chrome.
Wenn Sie Ihren Produkten Angebote hinzufügen, sehen Käufer einen Link zu einem Sonderangebot, Beispiel: „15% Rabatt“ oder „Kostenloser Versand“. Angebotslinks können die Attraktivität von und Nutzer zum Kauf bewegen.
Weitere Informationen finden Sie unter Promotion Grundlegende Informationen.
Vorbereitung
Google benötigt von Ihnen bestimmte Informationen zu Ihrem Unternehmen und bevor Sie Angebote präsentieren. Sie benötigen Folgendes:
- Ein aktives Produkt im Google- Merchant Center
- Eine aktive Werbung im Google- Merchant Center
- Google Ads-Konto für Shopping-Kampagnen Kampagnen
Außerdem müssen Sie Ihr Händlerkonto für das Merchant Promotions-Programm anmelden. Wenn Sie nicht sicher sind, ob Sie bereits registriert sind, prüfen Sie die Händlerseite .
Wenn Sie nicht registriert sind, füllen Sie die Anfrage . Die Promotions-Team informiert Sie, wenn Sie mit der Implementierung beginnen können.
Weitere Informationen finden Sie unter Teilnahmekriterien und Richtlinien.
Datenquelle erstellen
Verwenden Sie die datasource.create API, um einen Angebotsfeed zu erstellen. Wenn eine vorhandene Angebotsfeed ist verfügbar. Verwenden Sie datasource.get, um die datasource.name
Das Ersuchen sieht so aus:
POST https://merchantapi.googleapis.com/promotions/v1beta/accounts/{account}/dataSources/{datasource}
Beispiel
Das Beispiel zeigt eine typische Anfrage und Antwort.
Anfrage:
POST https://merchantapi.googleapis.com/datasources/v1beta/accounts/123/dataSources {"displayName": "test api feed", "promotionDataSource":{"targetCountry":"US", "contentLanguage":"en"}}
Antwort:
{
"name": "accounts/123/dataSources/1000000573361824",
"dataSourceId": "1000000573361824",
"displayName": "test api feed",
"promotionDataSource": {
"targetCountry": "US",
"contentLanguage": "en"
},
"input": "API"
}
Werbeaktionen erstellen
Sie können die
accounts.promotions.insert
zum Erstellen oder Aktualisieren eines Angebots. Die Methode accounts.promotions.insert
verwendet eine promotions-Ressource und einen Datenquellennamen als Eingabe. Sie gibt den Fehlerwert
neue oder aktualisierte Promotion, wenn sie erfolgreich war.
Zum Erstellen eines Angebots müssen datasource.name:
Google überprüft und genehmigt Ihre Angebote, bevor sie veröffentlicht werden. Weitere Informationen erhalten Sie unter Angebotsgenehmigung
Das Formular des Antrags:
POST https://merchantapi.googleapis.com/promotions/v1beta/{parent=accounts/*/}promotions:insert
Sehen Sie sich die folgenden Beispielwerbeaktionen zu Referenzzwecken an.
Beispiel 1: Eine lokale Angebot gilt für alle Produkte und alle Geschäfte
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"
}
Beispiel 2: Ein Online-Angebot, das für ausgewählte Produkte gilt und eingelöst wird Code
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"
}
Besondere Hinweise
Nachdem die Werbung erstellt wurde, kann es einige Minuten dauern, bis sie erstellt ist.
Eine Liste der angebotsbezogenen Attribute finden Sie unter Strukturierte Daten hinzufügen Attribute enthalten.
Lesen Sie vor dem Erstellen und Verwalten von Angeboten den Abschnitt Beste Angebote für Werbeaktionen Best Practices.
Werbeaktionen ansehen
Um ein Angebot anzuzeigen, verwenden Sie
accounts.promotions.get
Dieses get ist schreibgeschützt. Hierfür sind Ihre merchantId und die ID des
Werbung. Die Methode get gibt die entsprechende Ressource für Angebote zurück.
Beispiel:
GET https://merchantapi.googleapis.com/promotions/v1beta/{name=accounts/*/promotions/*}
Sehen Sie sich diese Beispiele genau an.
Beispiel 1: Lokales Angebot
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"
}
Beispiel 2. Eine Online-Werbeaktion
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}"
}
Werbeaktionen auflisten
Sie können die
promotions.list
können Sie alle erstellten Werbeaktionen anzeigen.
GET https://merchantapi.googleapis.com/promotions/v1beta/{parent=accounts/*}/promotions
Angebotsstatus
Den Status eines Angebots können Sie anhand des Attributs promotionStatus abrufen.
zurückgegeben von
promotions.get
und
promotions.list
Weitere Informationen zum Freigabeprozess finden Sie unter Genehmigung von Angeboten
Beispiel für Angebotsstatus
Die folgenden Beispiele veranschaulichen den Unterschied zwischen erfolgreichen und fehlgeschlagenen Tests. -Anfragen.
Beispiel 1. Der folgende Antworttext zeigt eine Online-Werbung, die abgelehnt wegen fehlender Produktzuordnung.
"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"
]
}
]
}
Beispiel 2. Der folgende Antworttext zeigt ein genehmigtes Angebot.
"promotionStatus": {
"destinationStatuses": [
{
"reportingContext": "FREE_LISTINGS",
"status": "PENDING"
},
{
"destination": "SHOPPING_ADS",
"status": "PENDING"
}
],
"itemLevelIssues": []
}
Beispiel 3. Ein genehmigtes und aktives Angebot
"promotionStatus": {
"destinationStatuses": [
{
"reportingContext": "FREE_LISTINGS",
"status": "LIVE"
},
{
"destination": "SHOPPING_ADS",
"status": "LIVE"
} ],
"itemLevelIssues": []
}
Weitere Informationen
Weitere Informationen finden Sie in der Promotions-Hilfe. .
Weitere Informationen zur Migration von der Content API for Shopping finden Sie unter Angebote migrieren Verwaltung von Google-Produkten.