واجهة برمجة تطبيقات Marketplace

نظرة عامة

واجهة برمجة التطبيقات الشراة المعتمَدون في السوق عبارة عن مجموعة من الموارد التي يمكن للمشترين استخدامها لإدارة ما يلي آليًا:

  • المفاوضات مع الناشرين
  • حزم المزادات
  • وصول العميل إلى واجهة مستخدم سوق "الشراة المعتمَدون"

يقدّم هذا الدليل واجهة برمجة تطبيقات Marketplace ويوضّح كيفية ربط موارد Marketplace API بميزات Marketplace في واجهة مستخدم "الشراة المعتمَدون".

مقدِّمو عروض الأسعار والمشترون

تتوافق واجهة برمجة التطبيقات Marketplace مع بنية واجهة برمجة التطبيقات لعرض الأسعار في الوقت الفعلي. تستخدم كلتا الواجهات برمجة التطبيقات bidders وbuyers كموارد على مستوى الجذر لعمليات عروض الأسعار والمشترين. يمكنك استخدام اسمَي عروض الأسعار والمشترين نفسهما في مسارات الموارد لكلٍّ من "عروض الأسعار في الوقت الفعلي" و"واجهات برمجة التطبيقات للسوق".

العملاء والمستخدمون

يمكنك استخدام Marketplace API لإنشاء وإدارة العملاء والعملاء، ومنح الوكالات أو المعلنين بشكل آلي إمكانية الوصول إلى علامة التبويب Marketplace في واجهة مستخدم "الشراة المعتمَدون".

يمثّل Client عميلاً أو وكالة أو معلِنًا مرتبطًا بحسابك على "الشراة المعتمَدون".

تمثّل السمة ClientUser فردًا معيّنًا لديه إذن الوصول إلى واجهة المستخدم ضمن Client. لا يمكن لمستخدمي العملاء الوصول إلى واجهة برمجة تطبيقات Marketplace. لدى المستخدمين العملاء إمكانية وصول محدودة إلى علامة التبويب السوق في حسابك. يتم تحديد أذونات مستخدم البرنامج من خلال role المحدّدة في Client الرئيسية.

تشير الموارد الأخرى في Marketplace API إلى العملاء حسب الاسم المحدد في مورد Clients.

لمزيد من المعلومات عن العملاء والمستخدمين في واجهة مستخدم سوق "الشراة المعتمَدون"، يمكنك الاطّلاع على مقالات مركز المساعدة التالية:

منسقو وسائط الإعلام

المخطِّط الإعلامي هو وكالة أو كيان آخر يتفاوض بشكل مستقل بشأن الصفقات مع الناشرين، ويسمح لمقدّم عروض أسعار واحد أو أكثر بتقديم عروض أسعار بالنيابة عن صفقاتهم النهائية. تكون هذه الصفقات إما مزادًا خاصًا أو صفقات مفضّلة، ولن تتمكّن من الاطّلاع عليها أو التفاعل معها إلى أن يتم الانتهاء منها، وستظهر بعد ذلك في ردّ bidders.finalizedDeals.list.

لتحديد ما إذا تم التفاوض على صفقة نهائية معيّنة من خلال مخطّط وسائط، يمكنك التحقّق مما إذا كان حقل mediaPlanner للصفقة قد تمت تعبئته. يضع منسّقو وسائل الإعلام قائمة بأرقام تعريف المقاعد الخاصة بـ DSP المؤهلة لإجراء معاملات من خلال الصفقة، والتي يمكن الاطّلاع عليها باستخدام الحقل eligibleSeatIds. في طلبات عروض الأسعار في "عروض الأسعار في الوقت الفعلي"، قد تظهر أرقام تعريف المقاعد هذه في القوائم المسموح بها أو القوائم المحظورة التي يحدّدها الناشر، ما سيحدّد ما إذا كانت ستتم فلترة عروض الأسعار من المزاد. ويمكن أن تظهر في حقول BidRequest التالية:

  • بروتوكول OpenRTB
    • BidRequest.wseat
    • BidRequest.bseat
    • BidRequest.imp.pmp.deals.wseat
  • بروتوكول عرض الأسعار في الوقت الفعلي من Google
    • BidRequest.adslot.allowed_seat_ids
    • BidRequest.adslot.blocked_seat_ids
    • BidRequest.adslot.matching_ad_data.direct_deal.allowed_seat_ids

حزم المزادات

يمكنك استخدام واجهة برمجة التطبيقات Marketplace API لشراء الاشتراكات والعملاء من حزم المزادات وإلغاء الاشتراك فيها، وعرض حزم المزادات التي اشتركت فيها.

إنّ AuctionPackage مشابه لحزمة الاستهداف الخاصة بمستودع Marketplace. على سبيل المثال، قد تستهدف حزمة المزاد مجموعة من عناوين URL ومعرّفات تطبيقات الأجهزة الجوّالة ذات الصلة بالاهتمامات التجارية للمشتري.

لا يمكنك إنشاء حزم مزاد جديدة باستخدام واجهة برمجة تطبيقات Marketplace. يمكنك استخدام واجهة مستخدم سوق "الشراة المعتمَدون" لإنشاء حزم المزادات. لا تتضمن واجهة برمجة تطبيقات Marketplace معلومات استهداف محددة مرتبطة بحزم المزادات.

يمكنك مشاركة حزم المزادات مع مشترين وعملاء آخرين، ويمكنك الحصول على حزم مزادات من إنشاء Google أو مشترين آخرين تتم مشاركتها معك.

راجع حزم المزادات للحصول على مزيد من المعلومات.

الملفات الشخصية للناشر

يمكنك استخدام Marketplace API لعرض الملفات الشخصية للناشرين الذين يمكنك التفاوض معهم.

تمثّل PublisherProfile ناشرًا في Marketplace API. وتشير الموارد الأخرى في Marketplace API إلى الناشرين بالاسم المذكور في PublisherProfile.

تحتوي الملفات الشخصية للناشرين على معلومات مشابهة لمعلومات الناشرين في علامة التبويب اكتشاف في واجهة مستخدم سوق "الشراة المعتمَدون".

اطّلِع على كيفية اكتشاف الناشرين للحصول على مزيد من المعلومات.

العروض والصفقات

يمكنك استخدام Marketplace API للتفاوض بشأن الصفقات مع الناشرين. في ما يلي بعض الطرق التي يمكنك من خلالها استخدام Marketplace API لإدارة الصفقات:

تمثّل العروض أحدث حالة مفاوضات حول صفقة واحدة أو أكثر بين المشتري أو العميل والناشر، وهي تشبه علامة تبويب المفاوضات في واجهة مستخدم "الشراة المعتمَدون" في السوق.

تمثّل الصفقات أحدث بنود صفقة يتم التفاوض عليها بموجب عرض محدّد، ويمكن مقارنتها بقائمة الصفقات في واجهة مستخدم "الشراة المعتمَدون" التي تحمل تصنيف التفاوض الحالي لعرض معيّن.

تمثل الصفقات النهائية الصفقات التي اكتملت مرحلة التفاوض وجاهزة للعرض. ويشمل ذلك الصفقات التي يتم عرضها حاليًا. تشبه الصفقات النهائية علامة تبويب الصفقات في واجهة مستخدم "الشراة المعتمَدون".

اعتمادًا على نوع الصفقة التي تتفاوض بشأنها، قد يختلف السلوك بين موارد واجهة برمجة التطبيقات Marketplace. على سبيل المثال، لا يمكن للمشترين بدء مفاوضات لجميع أنواع الصفقات. لمعرفة المزيد حول تنفيذ Marketplace API للمفاوضات، راجع الموارد التالية:

لمزيد من المعلومات حول المفاوضات في واجهة مستخدم سوق "الشراة المعتمَدون"، راجع ما يلي: