گردش کار API، گردش کار API

این راهنما، گردش‌های کاری رایج API برای ایجاد، لغو، بازیابی، به‌روزرسانی و مذاکره در مورد معاملات با استفاده از Deal Sync API را شرح می‌دهد.

ایجاد یک معامله

1. با فراخوانی LIST products با فیلتر externalDealId ، بررسی کنید که آیا محصولی قبلاً ایجاد شده است یا خیر. توجه داشته باشید که هر دو نوع camelCase externalDealId و snake_case external_deal_id در رشته فیلتر پشتیبانی می‌شوند. external_deal_id باید در همه محصولات منحصر به فرد باشد.

   GET https://dv360seller.googleapis.com/v1beta1/{parent=exchanges/*/orders/*}/products?filter=externalDealId="{external_deal_id}"
   

2. ایجاد سفارش . نام سفارش توسط DV360 تولید می‌شود و توصیه می‌کنیم این شناسه را برای بازیابی‌های بعدی در سیستم خود ذخیره کنید.

3. ایجاد محصول در بخش سفارش . نام محصول توسط DV360 تولید می‌شود و توصیه می‌کنیم این شناسه را برای بازیابی‌های بعدی در سیستم خود ذخیره کنید.

به عنوان یک روش جایگزین، می‌توانید LIST را با external_deal_id فراخوانی کنید. نام منبع شامل هر دو شناسه سفارش و شناسه محصول است، بنابراین می‌توانید سفارش والد را شناسایی کنید.

لغو معامله

1. وضعیت سفارش را به CANCELED به‌روزرسانی کنید . لغو فقط در صورتی پشتیبانی می‌شود که سفارش هنوز پذیرفته نشده باشد. لغو شده یک وضعیت پایانی است؛ یک سفارش پس از لغو نمی‌تواند دوباره فعال شود. اگر سفارش حاوی محصولی باشد، external_deal_id آن قابل استفاده مجدد نیست.

جزئیات یک معامله را دریافت کنید

1. دریافت جزئیات یک سفارش . وضعیت سفارش پس از پذیرش، بایگانی یا لغو سفارش توسط کاربر، به‌روزرسانی می‌شود.
2. جزئیات یک محصول را دریافت کنید .

دریافت لیست تخفیف‌ها

1. سفارشات را با فیلتر وضعیت فهرست کنید تا همه سفارشات پذیرفته شده یا در انتظار پذیرش را دریافت کنید.
2. محصولات را با فیلتر external_deal_id فهرست کنید .
3. تمام محصولات موجود در یک سفارش را فهرست کنید .

به‌روزرسانی یک معامله

1. به‌روزرسانی سفارش اطلاعات تماس ناشر.
   1. name قابل به‌روزرسانی نیست (نمی‌توان آن را در updateMask تنظیم کرد). وضعیت فقط با استفاده از API می‌تواند روی CANCELED تنظیم شود.
   2. partner_id قابل به‌روزرسانی نیست.
2. برای به‌روزرسانی مدت زمان معامله خاص، محصول را به‌روزرسانی کنید .
   1. name ، externalDealId ، transactionType ، pricingType و updateTime قابل به‌روزرسانی نیستند .
   2. به‌روزرسانی displayName نیازی به پذیرش مجدد کاربر ندارد.
   3. به‌روزرسانی rateDetails یا creativeConfig وضعیت سفارش والد را به PENDING_ACCEPTANCE تغییر می‌دهد. از تبلیغ‌کنندگان DV360 خواسته می‌شود که شرایط جدید را در صفحه مذاکرات بپذیرند، صرف نظر از اینکه سفارش قبلی قبلاً پذیرفته شده باشد یا خیر.

بررسی کنید که آیا کاربر معامله را پذیرفته است یا خیر

1. اگر نام سفارش مربوطه را می‌دانید ، آن را دریافت کنید . فیلد status را بررسی کنید.
2. اگر نام سفارش ردیابی نشده بود: محصولات را با فیلتر external_deal_id فهرست کنید ، نام سفارش را از نام محصول شناسایی کنید و سپس Get Order را فراخوانی کنید. فیلد status را بررسی کنید.

بررسی کنید که آیا کاربر معامله را پیکربندی کرده است یا خیر (فقط تضمین شده از نظر برنامه‌نویسی)

1. منبع موجودی را دریافت کنید . نام منبع exchanges/{exchangeId}/inventorysources/{external_deal_id} است. وضعیت خریدار را بررسی کنید.
   1. پیشنهادهای رزرو:
      1. BUYER_STATUS_ACTIVE : معامله پذیرفته و پیکربندی شده است. معامله زمانی شروع به پرداخت خواهد کرد که DV360 درخواست‌های پیشنهادی مطابق با شرایط معامله دریافت کند. یک ردیف به طور خودکار در طول پیکربندی معامله ایجاد می‌شود. برای جزئیات بیشتر به پیکربندی معامله مراجعه کنید.
      2. BUYER_STATUS_PENDING ): سفارش پذیرفته شده است، اما معامله هنوز پیکربندی نشده است. در این حالت هیچ هزینه‌ای انجام نمی‌شود.
      3. BUYER_STATUS_PAUSED ): معامله توسط تبلیغ‌کننده متوقف شده است. در این حالت هیچ خریدی انجام نمی‌شود.
   2. معاملات بدون رزرو:
      1. BUYER_STATUS_ACTIVE : معامله پذیرفته شده است. هزینه کردن معامله زمانی شروع می‌شود که DV360 درخواست‌های پیشنهاد مطابق با آن را دریافت کند، یک ردیف فعال، معامله را هدف قرار دهد و درخواست‌های پیشنهاد با معیارهای هدف‌گذاری ردیف مطابقت داشته باشند. برای جزئیات بیشتر به ردیف‌ها مراجعه کنید. (توجه: هیچ API فروشنده‌ای برای بررسی اینکه آیا یک معامله توسط ردیف‌ها هدف قرار گرفته است یا خیر، وجود ندارد).
      2. BUYER_STATUS_PENDING : برای معاملات بدون رزرو قابل استفاده نیست.
      3. BUYER_STATUS_PAUSED ): این معامله به صراحت توسط تبلیغ‌کننده متوقف شده است. در این حالت هیچ خریدی انجام نمی‌شود.

مکث و لغو مکث یک معامله پس از پذیرش

1. به‌روزرسانی وضعیت فروشنده منبع موجودی.
   1. توقف یا لغو توقف، ارائه پیشنهاد را متوقف نمی‌کند. فروشنده‌ای که پیشنهاد را متوقف می‌کند، یک پیام اطلاع‌رسانی به تبلیغ‌کنندگان در رابط کاربری DV360 نمایش می‌دهد تا به آنها در عیب‌یابی پیشنهادهای بدون هزینه کمک کند.

مذاکره مجدد (به‌روزرسانی یک معامله پس از پذیرش)

مذاکره مجدد به به‌روزرسانی‌هایی اشاره دارد که پس از پذیرش یک معامله توسط خریدار، در آن اعمال می‌شود. این امر به صرافی‌ها و خریداران اجازه می‌دهد تا شرایط معاملات موجود را تنظیم کنند. به عنوان مثال، یک صرافی ممکن است متوجه شود که زمان پایان پرواز برای یک معامله پذیرفته شده نادرست است؛ صرافی می‌تواند از وصله محصول برای ارسال به‌روزرسانی‌ها به خریداران DV360 قبل از شروع ارائه معامله استفاده کند.

تغییرات مجاز و غیرمجاز

برای مشاهده جزئیات کامل مذاکرات معامله و قوانین مذاکره مجدد، به مقالات مرکز راهنمای Display & Video 360 مراجعه کنید:

• مذاکره مجدد برای یک معامله تضمین‌شده برنامه‌ریزی‌شده
• در Display & Video 360 برای معامله مذاکره کنید