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

اگر در درخواست 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 منبع داده تبلیغاتی که در درخواست accounts.promotions.insert خود استفاده می‌کنید یکسان نباشد، پیام خطای زیر را مشاهده خواهید کرد:

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

برای رفع این خطا، مطمئن شوید که مقدار فیلد contentLanguage با مقدار فیلد contentLanguage منبع داده تبلیغاتی که استفاده می‌کنید یکسان باشد.

همچنین اگر مقدار targetCountry با مقدار targetCountry منبع داده تبلیغاتی که استفاده می‌کنید یکسان نباشد، این خطا را مشاهده خواهید کرد.

بیشتر بدانید

• درباره سیاست های تبلیغاتی بیاموزید.
• درباره بهترین شیوه ها برای تبلیغات بیاموزید.

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

اگر در درخواست 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 منبع داده تبلیغاتی که در درخواست accounts.promotions.insert خود استفاده می‌کنید یکسان نباشد، پیام خطای زیر را مشاهده خواهید کرد:

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

برای رفع این خطا، مطمئن شوید که مقدار فیلد contentLanguage با مقدار فیلد contentLanguage منبع داده تبلیغاتی که استفاده می‌کنید یکسان باشد.

همچنین اگر مقدار targetCountry با مقدار targetCountry منبع داده تبلیغاتی که استفاده می‌کنید یکسان نباشد، این خطا را مشاهده خواهید کرد.

بیشتر بدانید

• درباره سیاست های تبلیغاتی بیاموزید.
• درباره بهترین شیوه ها برای تبلیغات بیاموزید.