پیکربندی یکپارچگی مناقصه باز

پیشنهاد قیمت باز (Open Bidding) به صرافی‌ها و سایر خریداران این امکان را می‌دهد که از زیرساخت پیشنهاد قیمت آنی گوگل برای پیشنهاد قیمت در موجودی گوگل اد منیجر (Google Ad Manager) و ادموب (AdMob) استفاده کنند.

برای شرکت در مناقصه آزاد، یک یکپارچه‌سازی مناقصه بلادرنگ که برای مورد استفاده مناقصه آزاد شما سفارشی شده است را پیکربندی کنید و نقاط پایانی پیشنهاد دهنده را برای آزمایش به مدیر حساب گوگل خود ارسال کنید تا تأیید شود که ادغام به درستی کار می‌کند. این یک فرآیند یک‌باره است.

ادغام خود را به ناشران منتخب محدود کنید

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

پروتکل‌ها و کدگذاری‌های پشتیبانی‌شده

می‌توانید از OpenRTB در قالب‌های JSON یا Protobuf استفاده کنید. اطلاعات بیشتر .

پیاده‌سازی Google OpenRTB

پیاده‌سازی OpenRTB گوگل از تمام ویژگی‌های موجود در مشخصات OpenRTB پشتیبانی نمی‌کند و افزونه‌هایی برای خریداران مجاز و قابلیت‌های خاص مناقصه آزاد اضافه می‌کند. برای کسب اطلاعات بیشتر، به راهنمای OpenRTB مراجعه کنید.

رسیدگی به درخواست‌های پیشنهاد ورودی

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

با پیشنهاد قیمت پاسخ دهید

مناقصه آزاد همچنین از ساختار BidResponse مشابه خریداران مجاز استفاده می‌کند، با برخی فیلدهای اختصاصی که برای شرکت‌کنندگان در مناقصه آزاد ارسال می‌شود. برای کسب اطلاعات بیشتر در مورد فیلدهای خاص مناقصه آزاد که می‌توانید با آنها پاسخ دهید، به راهنمای پاسخ مراجعه کنید.

توجه: درخواست‌های پیشنهاد ارسال شده به شرکت‌کنندگان در مناقصه عمومی، بسته به قالب موجودی، باید ظرف 300 تا 1000 میلی‌ثانیه پاسخ دریافت کنند. برای تعیین الزامات خاص برای یک درخواست مشخص، فیلد BidRequest.tmax را بررسی کنید.

بسته به قالب تبلیغاتی که قصد دارید با آن پیشنهاد دهید، ساختار پاسخ می‌تواند به طرق قابل توجهی متفاوت باشد. برای کمک به شما در پیکربندی برنامه پیشنهاد دهنده خود برای پاسخ به پیشنهادات برای قالب‌های تبلیغاتی رایج، راهنماهای زیر را بررسی کنید:

• تبلیغات بینابینی
• تبلیغات ویدیویی
• تبلیغات ویدیویی OpenRTB
• تبلیغات بومی
• تبلیغات ویدیویی بومی
• تبلیغات SDK خریدار

پیگیری نمایش‌ها برای کاهش مغایرت‌ها

اکیداً توصیه می‌شود که از فیلد اختیاری BidResponse.seatbid.bid.ext.impression_tracking_url برای بازیابی داده‌های سطح نمایش آگهی در زمانی که گوگل رویدادهای قابل پرداخت را ثبت می‌کند و برای آنها از شما هزینه دریافت می‌شود، استفاده کنید.

رفع مغایرت درخواستی گوگل (نسخه بتا)

این ویژگی با هدف اطمینان از این است که تعداد نمایش‌هایی که برای یک مبادله هزینه دریافت می‌شود، با تعداد نمایش‌هایی که توسط Google Display & Video 360 (DV360) پرداخت می‌شود، همسو باشد.

با شناسایی دقیق نمایش‌های DV360 که توسط پیشنهاد قیمت باز ارائه شده‌اند، گوگل می‌تواند هرزنامه‌های تبلیغاتی و مغایرت‌های رویدادهای قابل پرداخت را تنظیم کند تا مطمئن شود که برای نمایش‌هایی که برای آنها پولی دریافت نکرده‌اید، هزینه‌ای دریافت نمی‌کنید.

google_query_id را در درخواست‌های پیشنهاد قیمت منتشر کنید

برای اطمینان از اینکه تعداد نمایش‌های معتبر با تقاضای گوگل مطابقت دارد، google_query_id باید همانطور که از درخواست‌های مناقصه باز به پلتفرم‌های تقاضای گوگل منتشر می‌شود، منتشر شود. این پیش‌نیاز حل اختلاف مناقصه باز است. طول مورد انتظار فعلی google_query_id حدود ۶۴ بایت است.

توکن خریدار شخص ثالث را در پاسخ‌های پیشنهاد قیمت منتشر کنید

در صورتی که پلتفرم Google demand در مزایده داخلی یک صرافی برنده شود، فیلد third_party_buyer_token باید همانطور که در پاسخ پیشنهاد وجود دارد، از طریق نمایش پیشنهاد باز (Open Bidding) منتشر شود. این به پلتفرم‌های ناشر گوگل اجازه می‌دهد تا تشخیص دهند که پیشنهاد برنده از یک شریک پیشنهاد باز، پیشنهادی از طرف Google demand برای همان فرصت نمایش است. انتظار می‌رود حداکثر طول فعلی این فیلد ۱۵۰ بایت باشد.

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

برای اطمینان از اینکه راهکار رفع اختلاف برای پیشنهادهای Google demand اعمال می‌شود، یک صرافی لازم است تا نشانه‌گذاری خلاقانه گوگل را بدون هیچ پوششی (برچسب‌های اسکریپت، iframeها یا پوشش‌های VAST) منتشر کند. به دلیل راهکار رفع اختلاف، گوگل ممکن است آن دسته از نمایش‌های پیشنهاد باز را که توسط پلتفرم‌های Google demand شمارش نشده‌اند، باطل کند و برای آنها فاکتور صادر نکند. گوگل به صورت دوره‌ای نشانه‌گذاری خلاقانه را بررسی می‌کند تا تأیید کند که پیشنهادهای دارای third_party_buyer_token از طرف Google demand ارسال شده‌اند و نه از طرف هیچ خریدار دیگری.

خلاقیت‌های HTML5

یک صرافی موظف است نشانه‌گذاری گوگل HTML را به همان شکلی که هست ، به همراه ماکروهای توسعه‌یافته مخصوص صرافی که معمولاً اعمال می‌شوند، و به صورت اختیاری، پیکسل‌ها یا اسکریپت‌های ردیاب اضافی که یک صرافی معمولاً اضافه می‌کند، ارسال کند.

اگر یک تبادل، محتوای HTML گوگل را در یک تگ ( script ، iframe یا سایر تکنیک‌ها) قرار دهد که متعاقباً کد HTML گوگل را بارگذاری یا رندر کند، گوگل قادر به اعمال حل اختلاف نخواهد بود.

مطابق با الزامات فنی

در این مثال، کد HTML خلاقانه گوگل (DV360) از پاسخ پیشنهاد قیمت، کلمه به کلمه ارسال می‌شود ، به آن یک کد HTML مخصوص صرافی اضافه و ضمیمه آن می‌شود.

<!-- START exchange-specific HTML header -->
<iframe src="https://exchange.example.com/impression?…" width="0" height="0" frameborder="0" scrolling="no" style="display:none;" marginheight="0" marginwidth="0"></iframe>
<!-- END exchange-specific HTML header -->
<!-- START HTML code as returned by Google in the bid response -->
<DIV STYLE="position: absolute; left: 0px; top: 0px; visibility: hidden;"><IMG SRC="https://pagead2.googlesyndication.com/pagead/gen_204?id=xbid&dbm_b=…" BORDER=0 WIDTH=1 HEIGHT=1 ALT="" STYLE="display:none"></DIV><iframe title="Blank" src="https://googleads.g.doubleclick.net/xbbe/pixel?d=…" style="display:none" aria-hidden="true"></iframe><div><div style="position:relative; display:inline-block;"><div class="GoogleActiveViewClass" id="DfaVisibilityIdentifier_…"><script>var url = 'https://googleads.g.doubleclick.net/dbm/ad?…';document.write('<script src="' + (window.rfl ? window.rfl(url) : url) + '"></s' + 'cript>');</script>…
<!-- END HTML code as returned by Google in the bid response -->
<!-- START exchange-specific HTML footer -->
<img src='https://exchange.example.com/track?…' width='0' height='0' style='display:none;'>
<!-- END exchange-specific HTML footer -->

الزامات فنی را برآورده نمی‌کند

در این مثال، کد HTML خلاقانه‌ای که توسط گوگل برگردانده می‌شود، در پاسخ پیشنهادی ارائه شده توسط یک صرافی مبهم‌سازی شده و به صورت کلمه به کلمه در پاسخ پیشنهادی ظاهر نمی‌شود . کد HTML ارائه شده توسط گوگل ممکن است توسط یک بسته‌بندی ارائه شده توسط صرافی در مرورگر رندر شود.

<!-- START exchange ad tag that encodes / renders Google creative in the browser -->
<!-- Google creatives markup from the bid response (adm) is not present verbatim -->
<span class="ad"><script type='text/javascript' src='https://exchange.example.com/ad?p=%%WINNING_PRICE%%&m=n_ybbRoVpsLlXSo8gVHRn-W0tynBt-Hoe8t8m0qwKhLFiaF-0gB0U4w-5pjeB8IMIkg7PcRri5iCIjBMMKDqg
…'></script></span>
<!-- END exchange ad tag that encodes / renders Google creative in the browser -->

خلاقیت‌های ویدیویی گسترده

برای واجد شرایط بودن برای حل اختلاف، یک صرافی باید از یکی از رویکردهای زیر برای پر کردن VASTTagURI در پاسخ‌های VAST XML استفاده کند:

1. یک تبادل می‌تواند مقدار عنصر VASTTagURI را به عنوان بخشی از سند VAST XML که توسط گوگل در فیلد BidResponse.seatbid.bid.adm برگردانده می‌شود، به همان شکلی که هست ، حفظ کند، به همراه بسط‌های ماکروی مختص تبادل که معمولاً اعمال می‌شوند.
2. DV360 می‌تواند فیلد BidResponse.seatbid.bid.adm.nurl را با یک URL سند VAST در پاسخ‌های پیشنهاد به یک تبادل پر کند. سپس یک تبادل می‌تواند آن مقدار را با برچسب VASTTagURI ارسال کند، و ماکروهای مخصوص تبادل در صورت نیاز به طور معمول گسترش می‌یابند.

یک تبادل می‌تواند در صورت لزوم، ردیاب‌های رویداد و خطای VAST اضافی را در سند XML VAST مشخص کند.

مطابق با الزامات فنی

در این مثال، آدرس اینترنتی VAST گوگل (DV360) از پاسخ پیشنهاد، کلمه به کلمه ارسال می‌شود و یک صرافی، رویداد VAST خاص و ردیاب‌های خطا را به آن اضافه می‌کند.

<!-- START exchange VAST tag referencing Google creative -->

<?xml version="1.0" encoding="UTF-8"?><VAST version="2.0"><Ad id="123456789"><Wrapper>

<!-- Google VAST URI from the bid response is present verbatim -->
<AdSystem>XBid</AdSystem><VASTAdTagURI><![CDATA[https://bid.g.doubleclick.net/dbm/vast?…]]></VASTAdTagURI>

<!-- START Exchange-specific event trackers -->

<Error><![CDATA[https://video.exchange.example.com/vast_error?error=[ERRORCODE]&…]]></Error><Impression><![CDATA[https://video.exchange.example.com/impression?price=%%WINNING_PRICE%%&…]]></Impression><Creatives><Creative id="1234567890" sequence="1"><Linear><TrackingEvents><Tracking event="creativeView"><![CDATA[https://video.exchange.example.com/track/view?…]]></Tracking><Tracking event="start"><![CDATA[https://video.exchange.example.com/track/start?…]]></Tracking><Tracking event="midpoint"><![CDATA[https://video.exchange.example.com/track/midpoint?…]]></Tracking></TrackingEvents><VideoClicks><ClickTracking><![CDATA[https://video.exchange.example.com/click?…]]></ClickTracking></VideoClicks>

<!-- END Exchange-specific event trackers -->

</Linear></Creative></Creatives></Wrapper></Ad></VAST>

<!-- END exchange VAST tag referencing Google creative -->

الزامات فنی را برآورده نمی‌کند

در این مثال، کد VAST خلاقانه یا URI که توسط گوگل برگردانده می‌شود، کلمه به کلمه در پاسخ پیشنهاد ظاهر نمی‌شود و در عوض، از یک بسته‌بندی VAST مخصوص صرافی استفاده می‌شود. کد VAST ارائه شده توسط گوگل ممکن است توسط یک بسته‌بندی VAST ارائه شده توسط صرافی (همانطور که در عنصر VASTAdTagURI ، https://video.exchange.example.com/creative?… تعریف شده است) هنگام بارگیری یک تبلیغ توسط SDK بارگیری شود.

<!-- START exchange VAST tag that encodes or loads Google VAST creative subsequently -->
<!-- Google VAST URI or VAST document from the bid response is not present verbatim -->

<?xml version="1.0" encoding="UTF-8"?><VAST version="2.0"><Ad id="1234567890"><Wrapper><AdSystem version="0.1">VideoExchange</AdSystem><VASTAdTagURI><![CDATA[https://video.exchange.example.com/creative?…]]></VASTAdTagURI><Error><![CDATA[https://video.exchange.example.com/error?ec=[ERRORCODE]]]></Error><Impression><![CDATA[https://video.exchange.example.com/imp?…]]></Impression><Creatives><Creative></Creative></Creatives></Wrapper></Ad></VAST>
<!-- END exchange VAST tag that encodes or loads Google VAST creative subsequently -->

معاملات

صرافی‌هایی که در مناقصه آزاد شرکت می‌کنند می‌توانند از معاملات ترجیحی (PD) و حراج‌های خصوصی (PA) با مناقصه آزاد استفاده کنند. شناسه و نوع معامله باید به شرح زیر مشخص شود:

میدان	توضیحات
BidResponse.seatbid.bid.dealid	شناسه معامله از فضای نام صرافی که با پیشنهاد مرتبط شده و به ناشران گزارش شده است. این یک متن UTF8 دلخواه است و نباید بیش از ۶۴ بایت باشد.
BidResponse.seatbid.bid.ext.exchange_deal_type	یک enum که نوع معامله را مشخص می‌کند. این به ناشران گزارش می‌شود و بر نحوه برخورد با معامله در حراج تأثیر می‌گذارد. مقادیر ممکن عبارتند از: OPEN_AUCTION = 0; PRIVATE_AUCTION = 1; PREFERRED_DEAL = 2; EXCHANGE_AUCTION_PACKAGE = 3;

در زیر نمونه‌ای از پاسخ پیشنهاد برای PD/PA آمده است.

id: "ECHO_BIDREQUEST_ID"
seatbid {
  bid {
    id: "BID_ID"
    impid: "1"
    price: 1.23
    adm: "AD_TAG"
    adomain: "DECLARED_LANDING_PAGE_URL"
    cid: "BILLING_ID"
    crid: "CREATIVE_ID"
    dealid: "DEAL_ID"
    w: 300
    h: 250
    [com.google.doubleclick.bid] {
      impression_tracking_url: "IMPRESSION_TRACKING_URL"
      exchange_deal_type: "DEAL_TYPE"
    }
  }
}

تطبیق کوکی

برای پر کردن جداول تطابق میزبانی شده توسط گوگل، شرکت‌کنندگان در مناقصه آزاد می‌توانند از هر یک از گزینه‌های زیر که به بهترین وجه با نیازهایشان مطابقت دارد، استفاده کنند:

• تطبیق کوکی: تطبیق آغاز شده توسط خریدار یا مبادله اطلاعات بیشتر .
• تطبیق پیکسل: تطبیق آغاز شده توسط گوگل اطلاعات بیشتر .
• دستیار تطبیق کوکی: تطبیق آغاز شده توسط صرافی با پیشنهاد دهندگان آنها اطلاعات بیشتر .

توجه: شرکت‌کنندگان در مناقصه آزاد در حال حاضر قادر به ایجاد، تکمیل یا هدف‌گیری فهرست‌های کاربران نیستند.

مدیریت تأخیر

شما باید از مکان‌های معاملاتی موجود در راهنمای Peering برای تخمین میزان تأخیر نقاط پایانی پیشنهاددهنده خود هنگام پاسخ به درخواست‌های پیشنهاد ورودی استفاده کنید.

موجودی کالا معمولاً از طریق نزدیکترین محل معاملات ارسال می‌شود، اما این تضمین شده نیست. تنها راه برای تضمین دسترسی به همه نمایش‌ها، داشتن نقاط پایانی پیشنهاد دهنده در تمام مکان‌های معاملاتی است.

صرافی‌های بزرگی که حجم بالایی از درخواست‌های پیشنهاد قیمت دریافت می‌کنند، باید برای کاهش تأخیر و نوسانات تأخیر، انعقاد قرارداد همتاسازی با گوگل را در نظر بگیرند. درباره همتاسازی بیشتر بدانید .

کلیک روی ماکروها

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

رابط‌های برنامه‌نویسی کاربردی (API)

مشتریان پیشنهاد قیمت آزاد می‌توانند از APIهای REST خریداران مجاز برای دسترسی به داده‌هایی که ممکن است برای اهداف عیب‌یابی مفید باشند، استفاده کنند. در حال حاضر فقط منابع API زیر قابل دسترسی هستند:

• گزارش عملکرد نسخه ۱.۴
• عیب‌یابی نسخه ۲ بتا ۱ RTB

شما می‌توانید برای پیکربندی حساب کاربری خود جهت دسترسی به این APIها و بازیابی شناسه حساب مورد نیاز برای برقراری تماس‌های API با مدیر فنی حساب خود تماس بگیرید. برای پشتیبانی فنی در استفاده از این APIها، می‌توانید با نام مستعار پشتیبانی [e-mail] تماس بگیرید.

منابع اضافی

• بهترین شیوه‌ها برای مدیریت اتصالات
• استفاده از ماکروهای URL پیشنهاد قیمت
• رمزگشایی تاییدیه‌های قیمت در صورت استفاده از ماکروی WINNING_PRICE
• توصیه‌های آزمایش و بهترین شیوه‌ها

نمونه درخواست‌ها و پاسخ‌های پیشنهاد قیمت

نمونه‌های درخواست و پاسخ پیشنهاد برای همه پروتکل‌های پشتیبانی‌شده را می‌توانید در راهنماهای درخواست و پاسخ بیابید.