API بازار

بررسی اجمالی

Authorized Buyers Marketplace API مجموعه ای از منابعی است که خریداران می توانند از آنها برای مدیریت برنامه نویسی موارد زیر استفاده کنند:

  • مذاکره با ناشران
  • بسته های حراج
  • دسترسی مشتری به رابط کاربری مجاز خریداران بازار

این راهنما API Marketplace را معرفی می‌کند و توضیح می‌دهد که چگونه منابع API Marketplace به ویژگی‌های Marketplace در رابط کاربری مجاز خریداران نگاشت می‌شود.

مناقصه گران و خریداران

API Marketplace با ساختار API پیشنهادی بیدرنگ سازگار است. هر دو API bidders و buyers به عنوان منابع سطح ریشه برای عملیات پیشنهاد دهنده و خریدار استفاده می کنند. می‌توانید از همان نام‌های پیشنهاد دهنده و خریدار در مسیرهای منابع برای APIهای بیدرنگ Bidding و Marketplace استفاده کنید.

مشتریان و کاربران مشتری

می‌توانید از API Marketplace برای ایجاد و مدیریت مشتریان و کاربران مشتری استفاده کنید و به آژانس‌ها یا تبلیغ‌کنندگان به صورت برنامه‌ریزی اجازه دسترسی به برگه Marketplace خود را در رابط کاربری مجاز خریداران بدهید.

Client نماینده یک مشتری، آژانس یا تبلیغ کننده مرتبط با حساب خریداران مجاز شما است.

ClientUser نشان دهنده یک فرد خاص است که تحت یک Client به UI دسترسی دارد. کاربران کلاینت نمی توانند به API Marketplace دسترسی داشته باشند. کاربران مشتری دسترسی محدودی به برگه بازار حساب شما دارند. مجوزهای کاربر مشتری با role مشخص شده در Client اصلی آنها تعیین می شود.

سایر منابع در API Marketplace به مشتریان با نام مشخص شده در منبع Clients اشاره می کنند.

برای کسب اطلاعات بیشتر در مورد مشتریان و کاربران مشتری در رابط کاربری بازار مجاز خریداران، به مقالات مرکز راهنمایی زیر مراجعه کنید:

برنامه ریزان رسانه

برنامه ریز رسانه یک آژانس یا نهاد دیگری است که به طور مستقل با ناشران در مورد معاملات مذاکره می کند و به یک یا چند مناقصه دهنده اجازه می دهد تا به نمایندگی از معاملات نهایی شده خود مناقصه ارائه دهند. این معاملات یا حراج خصوصی یا معاملات ترجیحی هستند، و تا زمانی که نهایی نشده باشند، نمی‌توانید آنها را ببینید یا با آنها تعامل داشته باشید – پس از آن، در پاسخ bidders.finalizedDeals.list ظاهر می‌شوند.

برای تعیین اینکه آیا یک معامله نهایی شده توسط یک برنامه ریز رسانه مذاکره شده است یا خیر، می توانید بررسی کنید که آیا قسمت mediaPlanner معامله پر شده است یا خیر. برنامه‌ریزان رسانه فهرستی از شناسه‌های صندلی مخصوص DSP را تنظیم می‌کنند که واجد شرایط معامله در معامله هستند، که می‌توان آن را با قسمت eligibleSeatIds مشاهده کرد. در درخواست‌های مناقصه بی‌درنگ، این شناسه‌های صندلی ممکن است در لیست‌های مجاز یا فهرست‌های مسدودی که توسط ناشر تنظیم شده است ظاهر شوند، که تعیین می‌کند آیا پیشنهادات از حراج فیلتر شده‌اند یا خیر. آنها می توانند در فیلدهای BidRequest زیر ظاهر شوند:

  • پروتکل OpenRTB
    • BidRequest.wseat
    • BidRequest.bseat
    • BidRequest.imp.pmp.deals.wseat
  • پروتکل RTB گوگل
    • BidRequest.adslot.allowed_seat_ids
    • BidRequest.adslot.blocked_seat_ids
    • BidRequest.adslot.matching_ad_data.direct_deal.allowed_seat_ids

بسته های حراج

می‌توانید از API بازار برای اشتراک و لغو اشتراک خریداران و مشتریان از بسته‌های حراج ، و مشاهده بسته‌های حراجی که در آنها مشترک هستید استفاده کنید.

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

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

می‌توانید بسته‌های حراج را با سایر خریداران و مشتریان به اشتراک بگذارید، و می‌توانید بسته‌های حراج ایجاد شده توسط Google یا سایر خریداران را با شما به اشتراک بگذارند.

برای اطلاعات بیشتر به بسته های حراج مراجعه کنید.

نمایه های ناشر

می‌توانید از API Marketplace برای مشاهده نمایه‌های ناشرانی که می‌توانید با آنها مذاکره کنید، استفاده کنید.

یک PublisherProfile یک ناشر را در API Marketplace نشان می دهد. سایر منابع موجود در Marketplace API به ناشران با نام مشخص شده در PublisherProfile آنها اشاره دارد.

نمایه‌های ناشر دارای اطلاعات مشابهی با ناشران در برگه Discovery در رابط کاربر بازار خریداران مجاز است.

برای اطلاعات بیشتر به نحوه کشف ناشران مراجعه کنید.

پیشنهادات و معاملات

می‌توانید از API Marketplace برای مذاکره با ناشران استفاده کنید. در اینجا چند راه وجود دارد که می توانید از API Marketplace برای مدیریت معاملات استفاده کنید:

پیشنهادها آخرین وضعیت مذاکره یک یا چند معامله بین یک خریدار یا مشتری و یک ناشر را نشان می‌دهند و شبیه به برگه مذاکره‌های رابط کاربری بازار خریداران مجاز هستند.

معاملات نشان‌دهنده آخرین شرایط معامله‌ای است که تحت یک پیشنهاد معین مذاکره می‌شود و با فهرست معاملات مجاز بازار UI بازار خریداران با برچسب CURRENT NEGOTIATION برای یک پیشنهاد قابل مقایسه است.

معاملات نهایی نشان دهنده معاملاتی است که مرحله مذاکره را تکمیل کرده و آماده ارائه هستند. این شامل معاملاتی است که در حال حاضر ارائه می شوند. معاملات نهایی شبیه به برگه معاملات UI بازار خریداران مجاز است.

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

برای کسب اطلاعات بیشتر در مورد مذاکرات در رابط کاربری مجاز خریداران بازار، به موارد زیر مراجعه کنید: