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

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

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

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

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

כדי שקידומי המכירות שלכם יוצגו, עליכם לספק ל-Google מידע ספציפי על העסק ועל המוצרים שלכם. נדרש:

• פיד מוצרים פעיל ב-Google Merchant Center.
• פיד מבצעים פעיל ב-Google Merchant Center.
• חשבון Google Ads לקמפיינים של שופינג.

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

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

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

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

משתמשים ב-API‏ datasource.create כדי ליצור פיד קידום מכירות. אם יש פיד קידום מכירות קיים, משתמשים בשיטה accounts.dataSources.get כדי לאחזר את השם של מקור הנתונים.

טופס הבקשה הוא:

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

דוגמה

בדוגמה מוצגות בקשה ותגובה אופייניות.

בקשה:

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

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

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

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

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

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"
      },
      "minimumPurchaseQuantity": 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 ואת המזהה של קידום המכירות. ה-method ‏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"
   },
   "minimumPurchaseQuantity": 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}"
}

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

אפשר להשתמש ב-method‏ 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.