تحديد المشاكل وحلّها في ما يتعلّق بواجهة برمجة التطبيقات الفرعية للعروض الترويجية

توضّح هذه الصفحة كيفية تحديد المشاكل وحلّها في ما يتعلّق بواجهة 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 في مصدر بيانات العروض الترويجية الذي تستخدمه.

مزيد من المعلومات

السابق
Overview