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

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

1. بررسی کنید که آیا محصولی قبلاً توسط لیست محصولات با فیلتر external_deal_id ایجاد شده است یا خیر. External_deal_id باید در همه محصولات منحصر به فرد باشد.

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

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

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

   به عنوان یک روش جایگزین، همیشه می‌توانید از دستور LIST با external_deal_id استفاده کنید. فیلد نام شامل هر دو شناسه سفارش (Order Id) و شناسه محصول (Product Id) است، بنابراین می‌توانید به راحتی والد را از این طریق شناسایی کنید.

لغو معامله

1. وضعیت سفارش را به «فقط لغو شده» تغییر دهید. در صورتی که سفارش پذیرفته نشده باشد، از «لغو» پشتیبانی می‌کند. «لغو شده» آخرین وضعیت است. پس از لغو، امکان فعال‌سازی مجدد سفارش وجود ندارد.

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

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

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

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

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

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

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

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

ببینید آیا کاربر (فقط برای PG) معامله را پیکربندی کرده است یا خیر

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

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

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

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

مذاکره مجدد به به‌روزرسانی‌هایی اشاره دارد که پس از پذیرش یک معامله توسط خریدار، در آن اعمال می‌شود. این می‌تواند برای صرافی‌ها و خریداران بسیار مفید باشد تا تغییرات جدید را در معاملات پذیرفته‌شده اعمال کنند. به عنوان مثال، صرافی ممکن است متوجه شود که زمان پایان معامله برای یک معامله پذیرفته‌شده صحیح نیست و صرافی می‌تواند از محصول به‌روزرسانی DV3 برای ارسال به‌روزرسانی‌ها به خریداران DV3 استفاده کند، اگر معامله هنوز شروع نشده باشد.

چه تغییراتی مجاز و چه تغییراتی غیرمجاز هستند.

برای تغییرات مجاز و غیرمجاز در مراحل مختلف معامله، به اینجا مراجعه کنید.