סקירה כללית של Merchant promotion API

כדאי להשתמש במבצעים כדי להציג מבצעים מיוחדים על מוצרים שאתם מוכרים ב-Google. מבצעים מוצגים במוצרים שונים של Google, כולל חיפוש Google, שופינג ו-Chrome.

כשמוסיפים מבצעים למוצרים, הקונים רואים קישור למבצעים מיוחדים לדוגמה: '15% הנחה' או 'משלוח חינם'. קישורים למבצעים יכולים להגביר את האטרקטיביות של את המוצרים שלכם ולעודד את הקונים לבצע רכישה.

מידע נוסף זמין בקטע קידום מכירות של Google.

דרישות מוקדמות

Google צריכה לספק לך מידע ספציפי על העסק ועל המוצרים לפני הצגת המבצעים. אתם צריכים:

בנוסף, אתם צריכים לרשום את חשבון המוכר שלכם לתוכנית המבצעים. אם המיקום אתה לא בטוח אם כבר נרשמת, בדוק את המוכר מרכז.

אם אתם לא רשומים, צריך למלא את הבקשה הטופס הזה. יודיעו לכם כשאתם מוכנים להתחיל בהטמעה.

מידע נוסף זמין בקריטריונים להשתתפות .

יצירת מקור נתונים

משתמשים ב-API datasource.create כדי ליצור פיד מבצעים. אם חשבון קיים פיד מבצעים זמין. צריך להשתמש ב-datasource.get כדי לאחזר את datasource.name

צורת הבקשה היא:

POST https://merchantapi.googleapis.com/promotions/v1beta/accounts/{account}/dataSources/{datasource}

דוגמה

בדוגמה אפשר לראות בקשה ותגובה אופייניים.

בקשה:

POST https://merchantapi.googleapis.com/datasources/v1beta/accounts/123/dataSources {"displayName": "test api feed", "promotionDataSource":{"targetCountry":"US", "contentLanguage":"en"}}

תשובה:

{
  "name": "accounts/123/dataSources/1000000573361824",
  "dataSourceId": "1000000573361824",
  "displayName": "test api feed",
  "promotionDataSource": {
    "targetCountry": "US",
    "contentLanguage": "en"
  },
  "input": "API"
}

קידומי מכירות

אפשר להשתמש accounts.promotions.insert כדי ליצור או לעדכן מבצע. השיטה accounts.promotions.insert הפונקציה מקבלת משאב promotions ושם של מקור נתונים כקלט. היא מחזירה את קידום מכירות חדש או מעודכן, אם הוא הושלם בהצלחה.

כדי ליצור מבצע datasource.name.

Google בודקת ומאשרת את המבצעים שלכם לפני ההפצה שלהם. לקבלת מידע נוסף מידע נוסף בקטע אישור מבצעים התהליך.

צורת הבקשה:

POST https://merchantapi.googleapis.com/promotions/v1beta/{parent=accounts/*/}promotions:insert

כדאי לעיין בדוגמאות הבאות לקידומי מכירות לדוגמה.

דוגמה 1: מבצע שחל על כל המוצרים וכל החנויות

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: מבצע באינטרנט שחל על מוצרים נבחרים עם מימוש קוד

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"
}

הערות מיוחדות

אחרי שיוצרים את המבצע, יכול להיות שיצירת המבצע תימשך כמה דקות.

רשימת מאפיינים שקשורים למבצעים זמינה במאמר הוספת נתונים מובְנים: .

לפני שיוצרים ומנהלים מבצעים, מומלץ לעיין במאמר קידומי מכירות הטובים ביותר. שיטות עבודה.

להצגת נתוני המבצעים

כדי לצפות במבצע, צריך להשתמש ב accounts.promotions.get קבלת הפריט הזה היא לקריאה בלבד. כדי להשתמש בה צריך את merchantId ואת המזהה של במבצע. השיטה get מחזירה את משאב המבצעים המתאים.

לדוגמה:

GET https://merchantapi.googleapis.com/promotions/v1beta/{name=accounts/*/promotions/*}

עיון בדוגמאות האלה.

דוגמה 1: קידום מקומי

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"
}

דוגמה 2. קידום מכירות אונליין

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}"
}

הצגת רשימה של מבצעים

אפשר להשתמש promotions.list שיטה להצגת כל המבצעים שנוצרו.

GET https://merchantapi.googleapis.com/promotions/v1beta/{parent=accounts/*}/promotions

סטטוס מבצע

כדי לראות את סטטוס המבצע, אפשר לעיין במאפיין promotionStatus הוחזר על ידי promotions.get וגם promotions.list.

מידע על תהליך האישור זמין במאמר אישורים של מבצעים התהליך.

סטטוס מבצע לדוגמה

הדוגמאות הבאות ממחישות את ההבדל בין הצלחה לבין כישלון בקשות.

דוגמה 1. גוף התגובה הבא מציג קידום מכירות באינטרנט שיהיה נדחה כי חסר מיפוי של המוצרים.

  "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"
        ]
      }
    ]
  }

דוגמה 2. בגוף התגובה הבא מוצג קידום מכירות שאושר.

  "promotionStatus": {
    "destinationStatuses": [
      {
        "reportingContext": "FREE_LISTINGS",
        "status": "PENDING"
      },
      {
        "destination": "SHOPPING_ADS",
        "status": "PENDING"
      }
    ],
    "itemLevelIssues": []
  }

דוגמה 3. קידום מכירות מאושר ופעיל

  "promotionStatus": {
    "destinationStatuses": [
      {
        "reportingContext": "FREE_LISTINGS",
        "status": "LIVE"
      },
      {
        "destination": "SHOPPING_ADS",
        "status": "LIVE"
 }  ],
    "itemLevelIssues": []
  }

מידע נוסף

לפרטים נוספים, אפשר לעיין בעזרה בנושא מבצעים מרכז.

מידע נוסף על המעבר מ-Content API for Shopping זמין במאמר העברת מבצעים ניהול.