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

בדף הזה מוסבר איך לפתור בעיות שקשורות ל-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 צריכים להיות בפורמט RFC3339 UTC, כלומר 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 במקור נתוני המבצעים שבו אתם משתמשים.

מידע נוסף

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