פתרון בעיות שקשורות ל-API המשני של קידומי מכירות

בדף הזה מוסבר איך לפתור בעיות שקשורות ל-Promotions sub-API.

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

כשמשתמשים בבקשה accounts.promotions.insert כדי להוסיף מבצע, צריך לוודא שכללתם את כל שדות החובה בגוף הבקשה. חובה למלא את השדות הבאים:

• promotion.promotionId
• promotion.contentLanguage
• promotion.redemptionChannel
• promotion.targetCountry
• promotion.attributes.longTitle
• promotion.attributes.promotionEffectiveTimePeriod.startTime
• promotion.attributes.promotionEffectiveTimePeriod.endTime
• promotion.attributes.promotionDestinations
• promotion.attributes.couponValueType
• promotion.attributes.offerType
• promotion.attributes.productApplicability
• promotion.attributes.promotionUrl

תקופת התוקף של המבצע לא תקינה

אם תציינו תאריכים לא תקינים של תקופת המבצע בבקשת accounts.promotions.insert, תוצג לכם הודעת השגיאה הבאה:

Invalid value at 'promotion.attributes.promotion_effective_time_period.start_time'

כדי לפתור את השגיאה, צריך לוודא שהערך שצוין בשדה promotionDisplayTimePeriod.startTime זהה לערך שצוין בשדה promotionEffectiveTimePeriod.startTime או מוקדם ממנו. בנוסף, חשוב לוודא שהערך שצוין בשדה promotionDisplayTimePeriod.endTime זהה לערך שצוין בשדה promotionEffectiveTimePeriod.endTime או קודם לו.

הערכים בשדות startTime ו-endTime צריכים להיות בפורמט UTC‏ RFC3339, כלומר yyyy-mm-ddThh:mm:ssZ. לדוגמה, 2024-08-15T18:20:20Z.

לא צוינה כמות רכישה מינימלית

אם הערך של attributes.couponValueType הוא BUY_M_GET_N_PERCENT_OFF או BUY_M_GET_N_MONEY_OFF, צריך לספק ערך לשדה attributes.minimumPurchaseQuantity בבקשת accounts.promotions.insert.

אם לא תציינו ערך בשדה attributes.minimumPurchaseQuantity בבקשת accounts.promotions.insert, תוצג הודעת השגיאה הבאה:

[minimumPurchaseQuantity] Missing benefit or restriction attributes for its type

כדי לפתור את השגיאה הזו, צריך לוודא שציינתם ערך בשדה minimumPurchaseQuantity בבקשה.

לא צוין סכום הנחה

אם הערך בשדה attributes.couponValueType הוא MONEY_OFF, צריך לספק ערך לשדה attributes.moneyOffAmount בבקשת accounts.promotions.insert.

אם לא תציינו ערך בשדה attributes.moneyOffAmount בבקשת accounts.promotions.insert, תוצג הודעת השגיאה הבאה:

[moneyOffAmount] Missing benefit or restriction attributes for its type

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

לא צוין תיאור של המתנה

אם הערך של השדה attributes.couponValueType הוא FREE_GIFT, צריך לספק ערך לשדה attributes.freeGiftDescription בבקשה accounts.promotions.insert.

אם לא תציינו ערך בשדה attributes.freeGiftDescription בבקשת accounts.promotions.insert, תוצג לכם הודעת השגיאה הבאה:

[freeGiftDescription] Missing benefit or restriction attributes for its type

כדי לפתור את השגיאה הזו, צריך לוודא שציינתם ערך בשדה attributes.freeGiftDescription בבקשה.

משלוח חינם לא אפשרי בקידום של מוצרים בחנויות מקומיות

אם הערך של השדה redemptionChannel הוא IN_STORE והערך של השדה attributes.couponValueType הוא FREE_SHIPPING_STANDARD,‏ FREE_SHIPPING_OVERNIGHT או FREE_SHIPPING_TWO_DAY, תוצג הודעת השגיאה הבאה:

[shippingServiceNames] Free shipping types are not supported for local promotions

כדי לפתור את השגיאה, צריך לוודא שהערך של השדה redemptionChannel הוא ONLINE.

לא צוין ערוץ למימוש

אם לא מציינים את הערך של השדה redemptionChannel בבקשת accounts.promotions.insert, תוצג הודעת השגיאה הבאה:

[redemptionChannel] Required parameter: redemptionChannel

כדי לפתור את השגיאה הזו, צריך לוודא שציינתם ערך בשדה redemptionChannel בבקשה.

השדה contentLanguage של המבצע לא תואם למקור הנתונים

אם הערך בשדה contentLanguage לא זהה לערך בשדה contentLanguage של מקור נתוני המבצעים שבו אתם משתמשים בבקשת accounts.promotions.insert, תוצג הודעת השגיאה הבאה:

[promotion] Could not find the proper data target for the provided feedLabel and contentLanguage

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

השגיאה הזו תוצג גם אם הערך של targetCountry לא זהה לערך של השדה targetCountry במקור נתוני המבצעים שבו אתם משתמשים.

מידע נוסף

• מידע על מדיניות בנושא מבצעים
• שיטות מומלצות לשימוש במבצעים