عیب‌یابی کردن مشکلات مربوط به میانای برنامه‌سازی کاربردی فرعی «تبلیغات»

این صفحه نحوه عیب‌یابی مشکلات مربوط به زیرمیانای برنامه‌سازی کاربردی «تبلیغات» را شرح می‌دهد.

ایجاد یک تبلیغ ویژه

هنگام استفاده از درخواست 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 منبع داده عرضه‌های ترویجی که استفاده می‌کنید یکسان نباشد، این خطا را نیز خواهید دید.

بیشتر بدانید

قبلی
Overview