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

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

1. ببینید آیا محصولی قبلاً توسط محصولات LIST با فیلتر 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 انجام دهید. فیلد نام شامل شناسه سفارش و شناسه محصول است، بنابراین به راحتی می توانید والد را از این طریق شناسایی کنید.

یک معامله را لغو کنید

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

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

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

لیستی از معاملات را دریافت کنید

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

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

1. به‌روزرسانی سفارش برای اطلاعات تماس ناشر.
   1. نام، اجازه به روز رسانی را نمی دهد (نمی توان در فیلد_ماسک تنظیم کرد). وضعیت فقط اجازه می دهد تا روی لغو از طریق API تنظیم شود.
   2. partner_id اجازه به روز رسانی را نمی دهد.
2. به‌روزرسانی محصول برای یک به‌روزرسانی مدت معامله خاص.
   1. name، externalDealId،transactionType، pricingType، updateTime را نمی توان به روز کرد.
   2. به روز رسانی displayName نیازی به پذیرش کاربر ندارد.
   3. به‌روزرسانی rateDetails، 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. مکث/لغو مکث بر ارائه معامله تأثیری ندارد. فروشنده در حال توقف معامله فقط یک پیام رشته ای را به عنوان FYI به تبلیغ کنندگان نشان می دهد. این به تبلیغ‌کننده کمک می‌کند تا یک معامله بدون هزینه را عیب‌یابی کند.

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

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

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

ما تغییرات را در همه فیلدها به جز برخی از فیلدهای حیاتی مانند: startTime ، endTime ، rateDetails ، creativeConfig و غیره مجاز می‌دانیم. ما اعتبارسنجی‌هایی در اطراف این فیلدهای حیاتی داریم. به طور کلی، اگر زمان شروع معامله حداقل 1 روز بعد در آینده باشد، به‌روزرسانی این فیلدها به جز creativeConfig مجاز است. فقط به‌روزرسانی‌های افزایشی در معاملات پرواز مجاز است، که زمان شروع آن در گذشته است اما زمان پایان در آینده است. برای معاملات تکمیل شده، که زمان پایان آن در گذشته است، هیچ تغییری مجاز نیست. برای مثال، به‌روزرسانی rateDetails معامله‌ای که یک سال پیش انجام شده است، مجاز نیست. در مواردی مانند این، DV3 Update Product خطای اعتبارسنجی را ایجاد می کند.