ממשק API של Marketplace

סקירה כללית

ה-API של Authorized Buyers Marketplace הוא אוסף של משאבים שקונים יכולים להשתמש בהם כדי לנהל באופן פרוגרמטי את הדברים הבאים:

• משא ומתן עם בעלי תוכן דיגיטלי
• חבילות למכירות פומביות
• גישת לקוח לממשק המשתמש של Authorized Buyers Marketplace

במדריך הזה מוסבר איך משתמשים ב-Marketplace API, ומוסבר איך המשאבים של Marketplace API ממופים לתכונות של Marketplace בממשק המשתמש של Authorized Buyers.

מגישי הצעות מחיר וקונים

ה-API של Marketplace תואם למבנה של Real-time Bidding API. שני ממשקי ה-API משתמשים ב-bidders וב-buyers כמשאבים ברמה הבסיסית (root) לפעולות של מגישי הצעות מחיר וקונים. אפשר להשתמש באותו שם של מגיש הצעות מחיר וקונים בנתיבי המשאבים בממשק ה-API של 'בידינג בזמן אמת' ו-Marketplace.

הערה: למרות ש-bidders ו-buyers הם משאבים ברמה הבסיסית (root), אי אפשר לקרוא להם ב-Marketplace API. משתמשים ב-Real-time Bidding API כדי לגשת אל bidders או אל buyers באמצעות פרטי הכניסה של OAuth 2.0.

לקוחות ומשתמשי לקוח

ניתן לך להשתמש ב-Marketplace API כדי ליצור ולנהל לקוחות ומשתמשים של לקוחות, וכדי להעניק לסוכנויות ולמפרסמים באופן פרוגרמטי גישה לכרטיסייה Marketplace דרך ממשק המשתמש של Authorized Buyers.

Client מייצג לקוח, סוכנות או מפרסם שמשויכים לחשבון Authorized Buyers.

ClientUser מייצג אדם ספציפי שיש לו גישה לממשק המשתמש במסגרת Client. משתמשי לקוח לא יכולים לגשת ל-Marketplace API. למשתמשים של לקוחות יש גישה מוגבלת לכרטיסייה Marketplace של החשבון. הרשאות המשתמשים של הלקוחות נקבעות לפי role שצוין ב-Client של ההורה.

משאבים אחרים ב-Marketplace API מפנים ללקוחות לפי השם שצוין במשאב Clients.

למידע נוסף על לקוחות ומשתמשי לקוח בממשק המשתמש של Authorized Buyers Marketplace, ראו את המאמרים הבאים במרכז העזרה:

• יצירה וניהול של לקוחות ומשתמשי לקוח
• סוגים של הרשאות גישה ללקוחות.

מתכנני מדיה

תכנון מדיה הוא סוכנות או ישות אחרת שמנהלות משא ומתן על עסקאות עם בעלי תוכן דיגיטלי, ומאפשרים למגיש הצעות מחיר אחד או יותר להגיש הצעות מחיר בשם העסקאות הסופיות שלהם. מדובר במכרזים פרטיים או במבצעים מועדפים, ואי אפשר לראות אותם או לקיים איתם אינטראקציה עד שהם סופיים. לאחר מכן הם יופיעו בתגובה bidders.finalizedDeals.list.

כדי לבדוק אם עסקה סופית מסוימת כבר נדונה על ידי כלי לתכנון מדיה, תוכלו לבדוק אם השדה mediaPlanner של העסקה אוכלס. הכלי לתכנון מדיה מגדיר רשימה של מזהי עמדות ספציפיים ל-DSP שעומדים בדרישות לביצוע עסקה ומוצגים בשדה eligibleSeatIds. בבקשות להצעת מחיר בזמן אמת, מזהי העמדות עשויים להופיע ברשימות היתרים או ברשימות חסימה שהוגדרו על ידי בעל התוכן הדיגיטלי, והן יקבעו אם הצעות המחיר יסוננו מהמכרז. הם יכולים להופיע בשדות BidRequest הבאים:

• פרוטוקול OpenRTB
  • BidRequest.wseat
  • BidRequest.bseat
  • BidRequest.imp.pmp.deals.wseat
• פרוטוקול Google RTB
  • 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 ומזהי אפליקציות לנייד שרלוונטיים לתחומי העניין העסקיים של הקונה.

לא ניתן ליצור חבילות חדשות של מכרזים באמצעות ה-API של Marketplace. תוכלו להשתמש בממשק המשתמש של Authorized Buyers Marketplace כדי ליצור חבילות של מכרזים. ה-API של Marketplace לא כולל מידע ספציפי על המיקוד המשויך לחבילות של מכרזים.

ניתן לשתף חבילות של מכרזים עם קונים ולקוחות אחרים, או חבילות של מכרזים שנוצרו על ידי Google או קונים אחרים שישותפו איתכם.

למידע נוסף, ראו חבילות של מכירות פומביות.

פרופילים של בעלי תוכן דיגיטלי

תוכלו להשתמש ב-Marketplace API על מנת להציג פרופילים של בעלי תוכן דיגיטלי שאתם יכולים לנהל משא ומתן איתם.

PublisherProfile מייצג בעל תוכן דיגיטלי ב-Marketplace API. משאבים אחרים ב-Marketplace API מתייחסים לבעלי תוכן דיגיטלי שהשם שמופיע ב-PublisherProfile שלהם.

לפרופילים של בעלי תוכן דיגיטלי יש מידע דומה לזה של בעלי תוכן דיגיטלי בכרטיסייה Discovery בממשק המשתמש של Authorized Buyers Marketplace.

למידע נוסף, ראו איך לגלות בעלי אתרים.

הצעות ומבצעים

ניתן להשתמש ב-Marketplace API כדי לנהל משא ומתן על עסקאות עם בעלי תוכן דיגיטלי. הנה כמה דרכים שבהן תוכלו להשתמש ב-Marketplace API כדי לנהל עסקאות:

• שלח הצעות חדשות.
• ניהול משא ומתן עם בעלי התוכן הדיגיטלי.
• לסיים את המבצעים.
• להציג את העסקאות הסופיות.
• להתחיל משא ומתן מחדש על העסקאות הסופיות.

הצעות מייצגות את סטטוס המשא ומתן האחרון של עסקה אחת או יותר בין קונה או לקוח לבין בעל אתר, ודומות למשא ומתן בממשק המשתמש של Authorized Buyers Marketplace.

השדה Deals מייצג את התנאים האחרונים של העסקה שעליה התנהל משא ומתן בכפוף להצעה נתונה, והם דומים לרשימת העסקאות בממשק המשתמש של Authorized Buyers Marketplace שמסומנת בתווית CURRENT NEGOTIATION לגבי הצעה נתונה.

העסקאות הסופיות מייצגות עסקאות שהשלימו את שלב המשא ומתן ומוכנות להצגה. כולל עסקאות שכבר מוצגות. העסקאות הסופיות דומות לאלה שמופיעות בכרטיסייה Deals בממשק המשתמש של Authorized Buyers.

אופן הפעולה של משאבי Marketplace API עשוי להשתנות בהתאם לסוג העסקה. לדוגמה, קונים לא יכולים ליזום משא ומתן לגבי כל סוגי העסקאות. ניתן למצוא מידע נוסף על ההטמעה של Marketplace API למשא ומתן במשאבים הבאים:

• buyers.proposals
• buyers.proposals.deals
• buyers.finalizedDeals

למידע נוסף על משא ומתן בממשק המשתמש של Authorized Buyers Marketplace:

• נהל משא ומתן על עסקה.
• בקשת הצעה למלאי של בעלי אתרים.
• ניהול המבצעים שלך.