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

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

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

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

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

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

توصیه می کنیم از پیاده سازی OpenRTB گوگل استفاده کنید. پروتکل Google RTB منسوخ شده است. بیشتر بدانید .

پیاده سازی Google OpenRTB

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

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

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

با پیشنهاد پاسخ دهید

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

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

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

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

برای کاهش اختلاف، برداشت‌ها را ردیابی کنید

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

حل اختلاف تقاضای Google (بتا)

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

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

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

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

در پاسخ‌های پیشنهادی، third_party_buyer_token را منتشر کنید

در صورتی که پلتفرم تقاضای Google در حراج داخلی یک صرافی برنده شود، فیلد third_party_buyer_token باید همانطور که در پاسخ پیشنهادی وجود دارد از طریق نمایش مناقصه باز منتشر شود. این به پلتفرم‌های ناشر Google اجازه می‌دهد تا مشخص کنند که پیشنهاد برنده از طرف شریک مناقصه باز پیشنهادی از طرف تقاضای Google برای همان فرصت نمایش است. انتظار می رود حداکثر طول فعلی این فیلد 150 بایت باشد.

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

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

خلاقیت های HTML5

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

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

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

در این مثال، کد HTML خلاق Google (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 خلاقی که توسط Google برگردانده شده است در پاسخ پیشنهادی ارائه شده توسط یک صرافی مبهم است و به طور کلمه در پاسخ پیشنهاد ظاهر نمی شود . کد HTML ارائه شده توسط Google ممکن است توسط یک بسته بندی ارائه شده توسط تبادل در مرورگر ارائه شود.

<!-- 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 -->

خلاقیت های ویدیویی VAST

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

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

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

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

در این مثال، Google (DV360) VAST URI خلاقانه از پاسخ پیشنهاد به کلمه ارسال می‌شود ، با یک صرافی که رویداد 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 بازگردانده شده توسط Google به طور کلمه در پاسخ پیشنهاد ظاهر نمی‌شود و در عوض، از یک بسته‌بندی VAST ویژه تبادل استفاده می‌شود. کد VAST ارائه‌شده توسط Google ممکن است توسط یک بسته‌بندی 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) با مناقصه آزاد استفاده کنند. شناسه معامله و نوع آن باید به صورت زیر مشخص شود:

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

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

نمونه زیر از فیلدهای OpenRTB برای PD/PA استفاده می کند ( dealid , exchange_deal_type ); در صورت استفاده از پروتکل خریداران مجاز، فیلدهای پاسخ پیشنهادی برای PD/PA به صورت exchange_deal_id و exchange_deal_type خواهند بود.

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"
    }
  }
}

تطبیق کوکی

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

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

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

مدیریت تاخیر

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

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

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

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

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

API ها

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

• نسخه 1.4 گزارش عملکرد
• عیب یابی v2beta1 RTB

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

منابع اضافی

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

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

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