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

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

إنشاء حملة ترويجية

عند استخدام طلب 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 في مصدر البيانات

إذا لم تكن قيمة الح0/} الحقل هي نفسها قيمة الحقل contentLanguage في مصدر بيانات العروض الترويجية الذي تستخدمه في طلب accounts.promotions.insert، ستظهر لك رسالة الخطأ التالية:contentLanguage

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

لحلّ هذا الخطأ، تأكَّد من أنّ قيمة الحقل contentLanguage هي نفسها قيمة الحقل contentLanguage في مصدر بيانات العروض الترويجية الذي تستخدمه.

سيظهر لك هذا الخطأ أيضًا إذا لم تكن قيمة الحقل targetCountry هي نفسها قيمة الحقل targetCountry في مصدر بيانات العروض الترويجية الذي تستخدمه.

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