مرور کلی کدهای تخفیف و پیشنهادات ویژه

این راهنما نحوه مدیریت کدهای تبلیغاتی و تخفیف‌ها را در جریان پرداخت پروتکل تجارت جهانی (UCP) توضیح می‌دهد.

وقتی کاربری مرحله پرداخت را آغاز می‌کند، گوگل داده‌های تبلیغاتی را از منابع مختلف ارائه می‌دهد. ادغام شما باید این تبلیغات را در لحظه تأیید کند و جزئیات جزئی تخفیف‌ها را به تفکیک هر کالا ارائه دهد. برای دریافت کدهای تخفیف، باید پشتیبانی از تخفیف را در پروفایل UCP خود تبلیغ کنید.

منابع تبلیغاتی

گوگل داده‌های تبلیغاتی را از دو منبع اصلی ارائه می‌دهد:

  • تبلیغات خودکار اعمال شده: پیشنهادهایی که مستقیماً از فیدهای مرکز فروشندگان گوگل شما دریافت می‌شوند. گوگل به‌طور خودکار این پیشنهادها را در سبد خرید اعمال می‌کند.
  • تبلیغات اعمال‌شده توسط کاربر: کدهای تبلیغاتی که کاربران به‌صورت دستی هنگام پرداخت وارد می‌کنند، مانند کدهای تخفیف عمومی یا پیشنهادات ایمیلی شخصی‌سازی‌شده. رابط کاربری پرداخت حداکثر از 10 کد تبلیغاتی اعمال‌شده در هر جلسه پشتیبانی می‌کند.

پیاده‌سازی API پرداخت

وقتی کاربری یک جلسه پرداخت ایجاد می‌کند یا یک کد تبلیغاتی را تغییر می‌دهد، گوگل درخواستی را به نقاط انتهایی POST /checkout-sessions یا PUT /checkout-sessions/{id} شما ارسال می‌کند.

ادغام شما برای مدیریت تخفیف‌ها به سه آرایه اصلی متکی است:

  • کدهای درخواستی ( discounts.codes ): گوگل کدهای تخفیف کاربر را در این آرایه ارسال می‌کند. برای حفظ وضعیت، باید این آرایه را در پاسخ خود تکرار کنید. اندیس آرایه پاسخ، هشدارهای اعتبارسنجی را به کدهای خاص نگاشت می‌کند.
    • معنای جایگزینی: ارسال این آرایه جایگزین کدهای ارسال شده قبلی می‌شود.
    • پاک کردن کدها: ارسال یک آرایه خالی ( [] ) تمام کدهای تخفیف را حذف می‌کند.
    • عدم حساسیت به حروف بزرگ و کوچک: منطق کسب‌وکار شما باید کدها را بدون حساسیت به حروف بزرگ و کوچک مطابقت دهد.
  • تخفیف‌های اعمال‌شده ( discounts.applied ): اگر کدی معتبر است، آن را به همراه یک title خوانا برای انسان، amount مثبت تخفیف و method محاسبه در این آرایه قرار دهید.
  • رد شدن‌ها ( messages ): اگر کدی نامعتبر است، آن را از آرایه applied حذف کنید و دلیل عدم موفقیت را با استفاده از یک هشدار متعارف در آرایه messages اطلاع دهید.

متغیرهای ریاضی

برای اطمینان از یکپارچگی داده‌ها و پردازش صحیح رسید، ادغام شما باید در تمام نسخه‌های UCP از قوانین ریاضی زیر پیروی کند:

  • مجموع تخصیص: مجموع allocations[].amount باید برابر با applied_discount.amount باشد.
  • مجموع کل اقلام خطی: totals[type=items_discount].amount باید برابر با مجموع line_items[].totals[type=items_discount].amount .

مدیریت خطا و بازخورد کاربر

اگر یک کد تخفیف یا پیشنهاد کارت هدیه قابل اجرا نباشد، یا اگر پیشنهادی که قبلاً اعمال شده حذف شده باشد، API شما باید کدهای دلیل واضح را برگرداند. این تضمین می‌کند که گوگل بازخورد مناسب را به کاربر نمایش می‌دهد.

عملیاتی که بر مجموع سفارش یا انتظار کاربر از مجموع تأثیر می‌گذارند، باید type: "warning" استفاده کنند. این امر تضمین می‌کند که خطاها به کاربر گزارش می‌شوند و توسط پلتفرم به صورت مخفیانه مدیریت نمی‌شوند. به عنوان مثال، اگر کاربری انتظار تخفیف دارد اما به دلیل منقضی شدن کد، آن را دریافت نمی‌کند، باید به او اطلاع دهید.

مرجع کد خطا

کدهای خطای متعارف زیر را در آرایه messages پاسخ خود برگردانید. "type": "warning" برای اعلام واجد شرایط بودن برای ارتقاء استفاده کنید:

کد خطا توضیحات
discount_code_expired کد منقضی شده است.
discount_code_invalid کد پیدا نشد یا ناقص است.
discount_code_already_applied کد از قبل اعمال شده است.
discount_code_combination_disallowed این کد را نمی‌توان با تخفیف فعال دیگری ترکیب کرد، یا به محدودیت خاص فروشگاه رسیده است.
discount_code_user_not_logged_in این کد به یک کاربر احراز هویت شده نیاز دارد.
discount_code_user_ineligible کاربر معیارهای واجد شرایط بودن را ندارد.

مراحل بعدی

مشاهده‌ی بارهای داده‌ی API و جزئیات پیاده‌سازی فنی برای نسخه UCP شما:

،

این راهنما نحوه مدیریت کدهای تبلیغاتی و تخفیف‌ها را در جریان پرداخت پروتکل تجارت جهانی (UCP) توضیح می‌دهد.

وقتی کاربری مرحله پرداخت را آغاز می‌کند، گوگل داده‌های تبلیغاتی را از منابع مختلف ارائه می‌دهد. ادغام شما باید این تبلیغات را در لحظه تأیید کند و جزئیات جزئی تخفیف‌ها را به تفکیک هر کالا ارائه دهد. برای دریافت کدهای تخفیف، باید پشتیبانی از تخفیف را در پروفایل UCP خود تبلیغ کنید.

منابع تبلیغاتی

گوگل داده‌های تبلیغاتی را از دو منبع اصلی ارائه می‌دهد:

  • تبلیغات خودکار اعمال شده: پیشنهادهایی که مستقیماً از فیدهای مرکز فروشندگان گوگل شما دریافت می‌شوند. گوگل به‌طور خودکار این پیشنهادها را در سبد خرید اعمال می‌کند.
  • تبلیغات اعمال‌شده توسط کاربر: کدهای تبلیغاتی که کاربران به‌صورت دستی هنگام پرداخت وارد می‌کنند، مانند کدهای تخفیف عمومی یا پیشنهادات ایمیلی شخصی‌سازی‌شده. رابط کاربری پرداخت حداکثر از 10 کد تبلیغاتی اعمال‌شده در هر جلسه پشتیبانی می‌کند.

پیاده‌سازی API پرداخت

وقتی کاربری یک جلسه پرداخت ایجاد می‌کند یا یک کد تبلیغاتی را تغییر می‌دهد، گوگل درخواستی را به نقاط انتهایی POST /checkout-sessions یا PUT /checkout-sessions/{id} شما ارسال می‌کند.

ادغام شما برای مدیریت تخفیف‌ها به سه آرایه اصلی متکی است:

  • کدهای درخواستی ( discounts.codes ): گوگل کدهای تخفیف کاربر را در این آرایه ارسال می‌کند. برای حفظ وضعیت، باید این آرایه را در پاسخ خود تکرار کنید. اندیس آرایه پاسخ، هشدارهای اعتبارسنجی را به کدهای خاص نگاشت می‌کند.
    • معنای جایگزینی: ارسال این آرایه جایگزین کدهای ارسال شده قبلی می‌شود.
    • پاک کردن کدها: ارسال یک آرایه خالی ( [] ) تمام کدهای تخفیف را حذف می‌کند.
    • عدم حساسیت به حروف بزرگ و کوچک: منطق کسب‌وکار شما باید کدها را بدون حساسیت به حروف بزرگ و کوچک مطابقت دهد.
  • تخفیف‌های اعمال‌شده ( discounts.applied ): اگر کدی معتبر است، آن را به همراه یک title خوانا برای انسان، amount مثبت تخفیف و method محاسبه در این آرایه قرار دهید.
  • رد شدن‌ها ( messages ): اگر کدی نامعتبر است، آن را از آرایه applied حذف کنید و دلیل عدم موفقیت را با استفاده از یک هشدار متعارف در آرایه messages اطلاع دهید.

متغیرهای ریاضی

برای اطمینان از یکپارچگی داده‌ها و پردازش صحیح رسید، ادغام شما باید در تمام نسخه‌های UCP از قوانین ریاضی زیر پیروی کند:

  • مجموع تخصیص: مجموع allocations[].amount باید برابر با applied_discount.amount باشد.
  • مجموع کل اقلام خطی: totals[type=items_discount].amount باید برابر با مجموع line_items[].totals[type=items_discount].amount .

مدیریت خطا و بازخورد کاربر

اگر یک کد تخفیف یا پیشنهاد کارت هدیه قابل اجرا نباشد، یا اگر پیشنهادی که قبلاً اعمال شده حذف شده باشد، API شما باید کدهای دلیل واضح را برگرداند. این تضمین می‌کند که گوگل بازخورد مناسب را به کاربر نمایش می‌دهد.

عملیاتی که بر مجموع سفارش یا انتظار کاربر از مجموع تأثیر می‌گذارند، باید type: "warning" استفاده کنند. این امر تضمین می‌کند که خطاها به کاربر گزارش می‌شوند و توسط پلتفرم به صورت مخفیانه مدیریت نمی‌شوند. به عنوان مثال، اگر کاربری انتظار تخفیف دارد اما به دلیل منقضی شدن کد، آن را دریافت نمی‌کند، باید به او اطلاع دهید.

مرجع کد خطا

کدهای خطای متعارف زیر را در آرایه messages پاسخ خود برگردانید. "type": "warning" برای اعلام واجد شرایط بودن برای ارتقاء استفاده کنید:

کد خطا توضیحات
discount_code_expired کد منقضی شده است.
discount_code_invalid کد پیدا نشد یا ناقص است.
discount_code_already_applied کد از قبل اعمال شده است.
discount_code_combination_disallowed این کد را نمی‌توان با تخفیف فعال دیگری ترکیب کرد، یا به محدودیت خاص فروشگاه رسیده است.
discount_code_user_not_logged_in این کد به یک کاربر احراز هویت شده نیاز دارد.
discount_code_user_ineligible کاربر معیارهای واجد شرایط بودن را ندارد.

مراحل بعدی

مشاهده‌ی بارهای داده‌ی API و جزئیات پیاده‌سازی فنی برای نسخه UCP شما:

قبلی
مرور کلی سبد خرید