این صفحه نحوه عیبیابی مشکلات مربوط به زیر-API مربوط به Promotions را شرح میدهد.
ایجاد یک پروموشن
هنگام استفاده از درخواست 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 خود ارائه دهید.
اگر در درخواست accounts.promotions.insert خود، مقداری برای فیلد attributes.minimumPurchaseQuantity ارائه ندهید، پیام خطای زیر را مشاهده خواهید کرد:
[minimumPurchaseQuantity] Missing benefit or restriction attributes for its type
برای رفع این خطا، مطمئن شوید که در درخواست خود برای فیلد minimumPurchaseQuantity مقداری ارائه میدهید.
مبلغ تخفیف مشخص نشده است
اگر مقدار فیلد attributes.couponValueType شما MONEY_OFF است، باید مقداری برای فیلد attributes.moneyOffAmount در درخواست accounts.promotions.insert خود ارائه دهید.
اگر در درخواست accounts.promotions.insert خود، مقداری برای فیلد attributes.moneyOffAmount ارائه ندهید، پیام خطای زیر را مشاهده خواهید کرد:
[moneyOffAmount] Missing benefit or restriction attributes for its type
برای رفع این خطا، مطمئن شوید که در درخواست خود برای فیلد attributes.moneyOffAmount مقداری ارائه میدهید. مقدار باید به صورت میکرو باشد.
شرح هدیه رایگان مشخص نشده است
اگر مقدار فیلد attributes.couponValueType شما FREE_GIFT است، باید مقداری برای فیلد attributes.freeGiftDescription در درخواست accounts.promotions.insert خود ارائه دهید.
اگر در درخواست accounts.promotions.insert خود، مقداری برای فیلد attributes.freeGiftDescription ارائه ندهید، پیام خطای زیر را مشاهده خواهید کرد:
[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 منبع داده promotions که در درخواست accounts.promotions.insert خود استفاده میکنید، یکسان نباشد، پیام خطای زیر را مشاهده خواهید کرد:
[promotion] Could not find the proper data target for the provided feedLabel and contentLanguage
برای رفع این خطا، مطمئن شوید که مقدار فیلد contentLanguage با مقدار فیلد contentLanguage منبع داده promotions که استفاده میکنید، یکسان باشد.
همچنین اگر مقدار targetCountry با مقدار فیلد targetCountry منبع داده promotions که استفاده میکنید یکسان نباشد، این خطا را مشاهده خواهید کرد.
بیشتر بدانید
- درباره سیاستهای مربوط به تبلیغات اطلاعات کسب کنید.
- با بهترین شیوههای تبلیغات آشنا شوید.