این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

پاسخ را بسازید

پس از اینکه درخواست شما درخواست پیشنهاد از طرف Google را پردازش کرد، باید پاسخی بسازد و ارسال کند. این راهنما توضیح می دهد که چگونه برنامه خود را برای ایجاد پاسخ کدنویسی کنید.

پیام Protobuf BidResponse ایجاد کنید

خریداران مجاز BidRequest به عنوان متن پیام یک HTTP POST ارسال می کنند. اگر نقطه پایان مناقصه شما برای استفاده از فرمت Protobuf پیکربندی شده است، برنامه شما باید پاسخی را با هدر Content-Type تنظیم شده روی application/octet-stream و یک متن پیام متشکل از یک بافر پروتکل سریالی ارسال کند. بافر پروتکل یک پیام BidResponse است که در openrtb.proto تعریف شده است. درخواست شما باید یک BidResponse قابل تجزیه را در پاسخ به هر BidRequest برگرداند. زمان‌بندی‌ها و پاسخ‌هایی که قابل تجزیه نیستند، خطا در نظر گرفته می‌شوند و Google پیشنهاد دهندگان را با نرخ خطای بالا کاهش می‌دهد.

اگر نمی‌خواهید برای یک نمایش پیشنهاد قیمت بدهید، می‌توانید فیلد BidResponse.ext.processing_time_ms را به تنهایی تنظیم کنید و همه فیلدهای دیگر را خالی بگذارید. می توانید openrtb.proto از صفحه داده های مرجع دریافت کنید.

شناسه خلاق

BidResponse شما یک خلاقیت را از طریق فیلد BidResponse.seatbid.bid.crid (محدودیت 64 بایت) مشخص می کند. حتی خلاقیت‌های مشابه باید مقادیر منحصر به فردی برای این فیلد داشته باشند، اگر از نظر ویژگی‌های قابل‌توجهی متفاوت باشند، از جمله: اندازه، URL اعلام‌شده، ویژگی‌های خلاقانه، و انواع فروشنده. به عبارت دیگر، شما باید به هر دو آگهی که:

متفاوت نگاه کنید یا رفتار کنید.
رندر به تصاویر مختلف
رندر با ابزارهای مختلف (به عنوان مثال، یک تبلیغ از یک تصویر تشکیل شده است، در حالی که دیگری یک ویدیو است).

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

ویژگی های آگهی

Google توصیه می‌کند که ویژگی‌های خلاقانه را برای توصیف ویژگی‌های تبلیغ و هدف‌یابی آن با استفاده از ترکیبی از BidResponse.seatbid.bid.apis و BidResponse.seatbid.bid.attr یا پسوند BidResponse.seatbid.bid.ext.attribute اعلام کنید. موارد زیر نحوه بیان ویژگی ها را توضیح می دهد:

VPAID
BidResponse.seatbid.bid.apis روی VPAID_1 یا VPAID_2 تنظیم کنید. برای فرمت JSON، این می تواند به ترتیب روی 1 یا 2 تنظیم شود.
MRAID
BidResponse.seatbid.bid.apis روی MRAID_1 یا 3 برای قالب JSON تنظیم کنید.
SIZELESS
BidResponse.seatbid.bid.attr روی RESPONSIVE یا 18 برای قالب JSON تنظیم کنید.
PLAYABLE
این با تنظیم BidResponse.seatbid.bid.attr روی USER_INTERACTIVE یا 13 برای قالب JSON نشان داده می شود.

توجه: اگر از پسوند BidResponse.seatbid.bid.ext.attribute استفاده می کنید، می توانید از مقادیر موجود در buyer-declarable-creative-attributes.txt برای اعلام این ویژگی ها استفاده کنید.

برای توضیح نحوه دریافت بازخورد در مورد ویژگی‌های شناسایی شده خلاقیت‌هایتان، به منبع Creatives مراجعه کنید.

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

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

OpenRTB	خریداران مجاز	جزئیات
`BidResponse.imp[].pmp.deals[].id`	`BidResponse.ad[].adslot[].exchange_deal_id`	شناسه معامله از فضای نام صرافی که با این پیشنهاد مرتبط است و به ناشران گزارش می‌شود. توجه: این فیلد فقط برای شرکت کنندگان بتا بسته ارسال می شود.
`BidResponse.seatbid[].bid[].ext.exchange_deal_type`	`BidResponse.ad[].adslot[].exchange_deal_type`	نوع معامله گزارش شده به ناشران که بر نحوه برخورد با معامله در حراج تأثیر می گذارد. توجه: این فیلد فقط برای شرکت کنندگان بتا بسته ارسال می شود.
`BidResponse.seatbid[].bid[].ext.third_party_buyer_token`	`BidResponse.ad[].adslot[].third_party_buyer_token`	اگر صرافی به عنوان یک مناقصه آزاد یک واسطه باشد، رمز برای شناسایی اطلاعات خریدار شخص ثالث نهایی استفاده می شود. این مورد از خریدار شخص ثالث دریافت می‌شود و باید بدون تغییر در پاسخ پیشنهاد به Google ارسال شود.

توصیه ها

اتصالات HTTPS دائمی (همچنین به عنوان "keep-alive" یا "connection reuse" شناخته می شود) را در سرورهای خود فعال کنید. حداقل تایم اوت را روی 10 ثانیه تنظیم کنید—مقادیر بالاتر در بسیاری از موارد مفید هستند. Google این مورد را در طول آزمایش‌های تاخیر اولیه برنامه شما تأیید می‌کند، زیرا خریداران مجاز درخواست‌ها را با نرخ بالایی ارسال می‌کنند و باید از سربار تأخیر ایجاد یک اتصال TCP جداگانه برای هر درخواست اجتناب کنند.
نشانی وب اختیاری ردیابی نمایش را برای ردیابی زمان نمایش نمایش به جای زمانی که پیشنهاد دهنده برنده می شود، اضافه کنید. به دلیل افت بین بردها و رندرها، این آمار ردیابی دقیق تری را به همراه دارد.
توجه: هنگام استفاده از OpenRTB، فیلد استاندارد برای آن BidResponse.seatbid.bid.burl است.
کد پیشنهادی خود را بدون وابستگی به فیلدهای منسوخ نگه دارید، که می تواند باعث شکست پیشنهادات شما با خطا شود.
BidResponse.seatbid.bid.w و BidResponse.seatbid.bid.h در BidResponse خود قرار دهید. یک BidResponse به درخواستی که شامل چندین اندازه تبلیغات است باید شامل این فیلدها باشد در غیر این صورت از حراج حذف خواهد شد.
اندازه پاسخ خود را به کمتر از 8K محدود کنید. پاسخ های بسیار بزرگ ممکن است تأخیر شبکه را افزایش داده و باعث وقفه شود.
دستورالعمل‌های پیشنهادات موجودی iOS را که به ذکر منبع SKAdNetwork نیاز دارند، دنبال کنید.

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

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

OpenRTB Protobuf

مثال را به من نشان بده

id: "q745y3S4jz5Qg43A6izy2V"
seatbid {
  bid {
    id: "Fi366E0I1RN4Ofm8Ug5"
    impid: "1"
    price: 0.02
    adm: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
    adomain: "google.com"
    cid: "51570472186"
    crid: "test_creative_id_520474"
    w: 468
    h: 60
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      impression_tracking_url: "https://test.com/impression?id=123456"
      event_notification_token {
        payload: "token"
      }
      billing_id: 51570472186
    }
  }
  seat: "1608:1311:489067"
}
bidid: "6930l9D4-1A9090lR-451S-01g3xTZv8382"
[com.google.doubleclick.bid_response] {
  processing_time_ms: 100
}

OpenRTB JSON

مثال را به من نشان بده

{
  "id": "sW2R7543D2w77f0542uu0F",
  "seatbid": [
    {
      "bid": [
        {
          "id": "U4495qveIO2A83s1iOs",
          "impid": "1",
          "price": 0.10701,
          "adid": "test_creative_id_323125",
          "adm": "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>",
          "adomain": [
            "google.com"
          ],
          "cid": "54460865479",
          "crid": "test_creative_id_323125",
          "w": 300,
          "h": 250,
          "ext": {
            "app_promotion_type": "INSTALLS",
            "impression_tracking_url": [
              "https://test.com/impression?id=123456",
              "https://test.com/impression?id=123456"
            ]
          }
        }
      ],
      "seat": "1506:2993:976791"
    }
  ],
  "bidid": "WN7415ff-hN7R6080-3txk-r0J45ckY5970"
}

گوگل

مثال را به من نشان بده

ad {
  html_snippet: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
  adslot {
    id: 1
    max_cpm_micros: 10100
    billing_id: 30279159795
  }
  click_through_url: "google.com"
  attribute: 47
  buyer_creative_id: "test_creative_id_766108"
  advertiser_name: "Google"
  width: 320
  height: 50
  impression_tracking_url: "https://test.com/imp?id=123456"
  event_notification_token: "token"
}
processing_time_ms: 8

مهم: پیام های Protobuf نشان داده شده در نمونه ها در اینجا به عنوان متن قابل خواندن توسط انسان نشان داده می شوند. با این حال، پیام ها به این صورت از طریق سیم ارسال نمی شوند. هنگام استفاده از قالب Google یا OpenRTB Protobuf، فقط پیام‌های BidResponse سریال پذیرفته می‌شوند.

می توانید با استفاده از کد C++ زیر یک پیام BidResponse ایجاد و سریال کنید:

BidResponse bid_response;
// fill in bid response with bid information
string post_response;
if (bid_response.SerializeToString(&post_response)) {
  // respond to the POST with post_response as the content
} else {
  // return an error to the POST
}

خلاقیت را مشخص کنید

پاسخ پیشنهادی شما، خلاقیتی را که در صورت برنده شدن پیشنهاد شما ارائه می شود، مشخص می کند. پیشنهاد شما باید شامل یکی از قالب های تبلیغاتی پشتیبانی شده (AMP، ویدئو، بومی) باشد. در این مثال، ما خلاقیت را با استفاده از فیلد html_snippet مشخص می کنیم.

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

آگهی ارائه شده SDK
- BidResponse.seatbid.bid.ext.sdk_rendered_ad
AMP
- BidResponse.seatbid.bid.amp_ad_url
ویدئو
- BidResponse.seatbid.bid.adm
بومی
- BidResponse.seatbid.bid.adm_native

تبلیغی را مشخص کنید که با استفاده از یک قطعه HTML در قسمت BidResponse.seatbid.bid.adm روی سرور(های) خود میزبانی می شود. این قطعه در یک iFrame درج شده در صفحه وب محصور می شود و در نتیجه آگهی بازیابی و هنگام بارگذاری صفحه نمایش داده می شود. شما باید قطعه HTML را طوری بسازید که تبلیغ (بنر یا بینابینی) به درستی در iFrame و در اندازه مناسب برای جایگاه تبلیغاتی که در آن مناقصه می‌دهید ارائه شود.

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

یک آگهی یک بنر معمولی است (نه ویدیو، بومی یا بینابینی).
مناقصه گزار اندازه را در پاسخ مناقصه اعلام کرده است. هر زمان که بیش از یک اندازه در درخواست وجود داشته باشد، اعلام اندازه لازم است.
یک استثنا برای تبلیغات بینابینی ایجاد شده است. برای موارد بینابینی، عرض باید حداقل 50 درصد عرض صفحه و ارتفاع حداقل 40 درصد از ارتفاع صفحه باشد.

می‌توانید با استفاده از هر کد HTML معتبری که به درستی رندر می‌شود، یک خلاقیت قطعه HTML را مشخص کنید، اما محدودیت‌های تعیین فیلد crid را در بخش Create BidResponse پیام در نظر داشته باشید. یکی از کاربردهای این کار قرار دادن اطلاعات اضافی در آرگومان های URL هایی است که به عنوان بخشی از رندر آگهی از سرورهای شما واکشی می شوند. این به شما امکان می‌دهد داده‌های دلخواه مربوط به نمایش را به سرورهای خود ارسال کنید.

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

ماکروها را مشخص کنید

ماکروها متن قالب‌بندی‌شده‌ای هستند که در برخی از فیلدهای پاسخ پیشنهادی حاوی URL‌هایی هستند که در زمان ارائه آگهی با یک مقدار مرتبط جایگزین می‌شوند. برای مثال، اگر پیشنهاد برنده شما شامل ماکرو AUCTION_PRICE در خلاقیت قطعه HTML همراه با پیشنهاد شما باشد، ماکرو با مقداری جایگزین می‌شود که می‌توانید آن را رمزگشایی کنید تا مبلغی را که برای نمایش در حراج پرداخت کرده‌اید تعیین کنید.

می توانید ماکروها را در فیلدهای زیر قرار دهید:

BidResponse.seatbid.bid.adm
ماکروها برای قالب‌های قطعه HTML، بومی، URL ویدیو، و فرمت‌های VAST XML ویدیویی پشتیبانی می‌شوند.
BidResponse.seatbid.bid.adm_native.eventtrackers.url
BidResponse.seatbid.bid.adm_native.imptrackers
BidResponse.seatbid.bid.ext.amp_ad_url
فقط ماکروهای WINNING_PRICE و WINNING_PRICE_ESC مخصوص Google برای خلاقیت‌های AMP پشتیبانی می‌شوند.
BidResponse.seatbid.bid.burl
BidResponse.seatbid.bid.ext.impression_tracking_url
اگر به بیش از یک URL صدور صورت حساب نیاز دارید، از این به جای BidResponse.seatbid.bid.burl استفاده کنید.

به عنوان مثال، می‌توانید با قرار دادن ${MACRO} در URL مورد استفاده برای واکشی خلاقیت، یک ماکرو را به‌عنوان بخشی از یک قطعه HTML بگنجانید، جایی که MACRO یکی از ماکروهای پشتیبانی شده است که در مشخصات OpenRTB توضیح داده شده است.

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

گوگل از ماکروهای اضافی به غیر از مواردی که در مشخصات OpenRTB یافت می شود، پشتیبانی می کند. اینها قالب بندی متفاوتی دارند و اگر در URL جاسازی شوند به صورت %%MACRO%% ظاهر می شوند. جدول زیر این ماکروها را توضیح می دهد:

ماکرو	توضیحات
`ADVERTISING_IDENTIFIER`	به خریداران این امکان را می دهد که IDFA iOS یا شناسه تبلیغاتی Android را در نمایش نمایش دریافت کنند. برای جزئیات بیشتر به رمزگشایی شناسه‌های تبلیغ‌کننده مراجعه کنید.
`CACHEBUSTER`	نمایش رشته ای از یک عدد صحیح تصادفی، بدون علامت، چهار بایتی.
`CLICK_URL_UNESC`	نشانی وب کلیک بدون فرار برای آگهی. در قطعه، یک نسخه فرار از URL کلیک شخص ثالث باید مستقیماً از ماکرو پیروی کند. به عنوان مثال، اگر نشانی اینترنتی کلیک شخص ثالث `http://my.adserver.com/some/path/handleclick?click=clk` باشد، کد زیر می تواند با نسخه تکی از URL کلیک شخص ثالث استفاده شود. به دنبال فراخوانی کلان: <a href="%%CLICK_URL_UNESC%%http%3A%2F%2Fmy.adserver.com%2Fsome%2Fpath%2Fhandleclick%3Fclick%3Dclk"></a> در زمان ارائه آگهی، این به موارد زیر گسترش می یابد: <a href="http://google-click-url?...&ad_url=http%3A%2F%2Fmy.adserver.com%2Fsome%2Fpath%2Fhandleclick%3Fclick%3Dclk"></a> URL ابتدا کلیک را در Google ثبت می کند و سپس به URL کلیک شخص ثالث هدایت می شود.
`CLICK_URL_ESC`	نشانی اینترنتی کلیک فرار شده برای آگهی. اگر لازم است ابتدا مقدار را از طریق سرور دیگری که سپس یک تغییر مسیر را برمی گرداند، از این به جای `CLICK_URL_UNESC` استفاده کنید. به عنوان مثال، کد زیر را می توان در یک قطعه HTML استفاده کرد: <a href="http://my.adserver.com/click?google_click_url=%%CLICK_URL_ESC%%"></a> در زمان ارائه آگهی، این به موارد زیر گسترش می یابد: <a href="http://my.adserver.com/click?google_click_url=http://google-click- url%3F...%26ad_url%3D"></a> این کلیک را در `my.adserver.com` ثبت می‌کند که سپس مسئول هدایت مجدد به URL ارسال شده در پارامتر `google_click_url` خواهد بود. این فرض می‌کند که `my.adserver.com` از پارامتر `google_click_url` خارج می‌شود. می‌توانید پس از `%%CLICK_URL_ESC%%` یک نشانی وب دوبار فرار اضافه کنید. پس از انجام unescaping توسط `my.adserver.com` ، یک نسخه تکی از URL به `google_click_url` اضافه می شود. وقتی `google_click_url` واکشی شد، یک بار دیگر از حالت Escape خارج می شود و سپس هدایت می شود.
`CLICK_URL_ESC_ESC`	نشانی اینترنتی دوگانه برای آگهی. اگر لازم است ابتدا مقدار را از طریق سرور دیگری که سپس یک تغییر مسیر را برمی گرداند، از این به جای `CLICK_URL_UNESC` استفاده کنید. به عنوان مثال، کد زیر را می توان در یک قطعه HTML استفاده کرد: <a href="http://my.adserver.com/click?google_click_url=%%CLICK_URL_ESC_ESC%%"></a> در زمان ارائه آگهی، این به موارد زیر گسترش می یابد: <a href="http://my.otheradserver.com/click?google_click_url=http%3A%2F%2Fmy.adserver.com%2Fclick%3Fgoogle_click_url%3Dhttp%3A%2F%2Fgoogle-click-%20url%253F...%2526ad_url%253D"></a>
`SCHEME`	اگر درخواست پیشنهاد به SSL نیاز ندارد به `http:` گسترش می یابد یا اگر درخواست پیشنهاد به SSL نیاز دارد به `https:` گسترش می یابد.
`SITE`	دامنه URL محتوا یا شناسه ناشناس موجودی ناشناس.
`SITE_URL`	منسوخ شده است. ماکرو SITE جایگزین شده است که عملکرد یکسانی را ارائه می دهد.
`TZ_OFFSET`	افست منطقه زمانی
`VERIFICATION`	مقادیر مختلف برای تولید و زمانی که خلاقیت در خط لوله تأیید اسکن می شود. قالب این است: `%%?VERIFICATION:true-val:false-val%%` که در آن هر مقدار به جز ماکروها را می توان برای `true-val` و `false-val` استفاده کرد، از جمله رشته های خالی. برای مناقصه باز، توصیه می کنیم صرافی ها از این ماکرو استفاده کنند. پس از انجام این کار، پلتفرم های سمت تقاضا نیازی به ایجاد تغییرات ندارند. به عنوان مثال، اگر قرار باشد یک خلاق `%%?VERIFICATION:-1:5000%%` را شامل شود، جایگزینی متن `5000` در هنگام ارائه و `-1` در خط لوله تأیید خواهد بود. این برای کمک به تمایز بین این دو مجموعه پینگ است.
`WINNING_PRICE`	هزینه نمایش رمزگذاری شده (یعنی CPI به جای CPM) در میکرو ارز حساب. به عنوان مثال، CPM برنده 5 دلار آمریکا معادل 5000000 میکرو CPM یا 5000 میکرو CPI است. مقدار رمزگشایی شده `WINNING_PRICE` در این مورد 5000 خواهد بود. قیمت برنده در CPI مشخص شده است. برای تجزیه این ماکرو، باید برنامه‌ای را پیاده‌سازی کنید که تأییدیه‌های قیمت را رمزگشایی می‌کند. برای اطلاعات بیشتر به صفحه تایید قیمت رمزگشایی مراجعه کنید.
`WINNING_PRICE_ESC`	`WINNING_PRICE` از URL فرار کرد.

Google از شما می‌خواهد که از ماکرو CLICK_URL_UNESC یا CLICK_URL_ESC در خلاقیت تبلیغ ارائه‌شده توسط شخص ثالث استفاده کنید. Google از ماکروهای CLICK_URL برای ردیابی کلیک استفاده می کند.

URL فرار در ماکروها از طرح زیر استفاده می کند:

کاراکتر فاصله با علامت مثبت ( + ) جایگزین می شود.
کاراکترهای الفبایی (0-9، az، AZ) و کاراکترهای مجموعه !()*،-./:_~ بدون تغییر باقی می مانند.
همه نویسه‌های دیگر با %XX جایگزین می‌شوند، که در آن XX عدد هگزادسیمال نشان‌دهنده کاراکتر است.

محدودیت ها و الزامات ناشر

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

BidRequest.bcat
- می‌توانید دسته‌های مسدودشده مشخص‌شده توسط این فیلد را با دسته‌های شناسایی شده برای خلاقیت‌های ارسالی‌تان با استفاده از فیلد detectedCategories API Bidding در زمان واقعی مقایسه کنید.
BidRequest.imp.ext.allowed_vendor_type
BidRequest.imp.secure
- در عمل این همیشه true است زیرا Google برای همه خلاقیت ها به پشتیبانی SSL نیاز دارد.
BidRequest.imp.{audio/banner/native/video}
BidRequest.imp.{audio/banner/native/video}.api
BidRequest.imp.{audio/banner/native/video}.battr
BidRequest.imp.{audio/banner/video}.mimes

هرگز با تبلیغاتی که دارای یک ویژگی محدود است، پیشنهاد قیمت ندهید. برای ویژگی‌های مجاز مانند نوع فروشنده، آگهی را فقط در صورتی برگردانید که نوع فروشنده آن در لیست allowed_vendor_type در BidRequest باشد. فقط قالب‌های تبلیغاتی که در درخواست مناقصه با پر کردن فیلدهایی مانند BidRequest.imp.banner مشخص شده‌اند باید در پیشنهاد شما گنجانده شوند. برای جزئیات بیشتر به نظرات این فیلدها در تعریف بافر پروتکل BidRequest مراجعه کنید.

اگر تبلیغی در BidResponse برگردانده شد، باید BidResponse.seatbid.bid.attr ، BidResponse.seatbid.bid.cat ، و BidResponse.seatbid.bid.adomain یا BidResponse.seatbid.bid.adm_native.link.url فیلدهای BidResponse.seatbid.bid.adm_native.link.url در BidResponse . اگر یک تبلیغ دارای چندین مقدار قابل اجرا برای این فیلدها باشد، باید هر مقدار را درج کنید. برای جزئیات بیشتر به نظرات این فیلدها در تعریف بافر پروتکل BidResponse مراجعه کنید. پاسخ‌هایی که این فیلدها را تنظیم نکرده‌اند، کنار گذاشته می‌شوند.

باز کردن اندازه‌گیری

Open Measurement به شما امکان می‌دهد فروشنده‌های شخص ثالثی را مشخص کنید که خدمات اندازه‌گیری و تأیید مستقلی را برای تبلیغات ارائه‌شده در محیط‌های برنامه تلفن همراه ارائه می‌کنند.

فرمت های تبلیغاتی پشتیبانی شده شامل ویدئو، بنر و تبلیغات بینابینی است. برای اطلاعات بیشتر در مورد نحوه استفاده از Open Measurement در یک پاسخ پیشنهادی حاوی این قالب‌ها، به مقاله Open Measurement SDK Help Center مراجعه کنید.

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

بخش های زیر نمونه پاسخ های پیشنهادی را برای انواع مختلف تبلیغات نشان می دهد.

OpenRTB Protobuf

مثال را به من نشان بده

id: "m7T91l3qg177P4b39N26W1"
seatbid {
  bid {
    id: "5viGQ43x3HI44d22DW3"
    impid: "1"
    price: 0.040404
    adid: "test_creative_id_566440"
    adm: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
    adomain: "google.com"
    cid: "67427969102"
    crid: "test_creative_id_566440"
    cat: "IAB3"
    cat: "IAB13"
    w: 320
    h: 50
    burl: "https://test.com/imp?id=123456"
    [com.google.doubleclick.bid] {
      billing_id: 67427969102
    }
  }
  seat: "1912:1424:626226"
  group: false
}
bidid: "38508qU5-957YGflD-M2rg-7B19HjXU00n2"
cur: "USD"

OpenRTB JSON

مثال را به من نشان بده

{
  "id": "SwkWZ9w3I3gJ803j84253U",
  "seatbid": [
    {
      "bid": [
        {
          "id": "ro22H780p349mF6oe0h",
          "impid": "1",
          "price": 0.04001,
          "adid": "test_creative_id_978541",
          "adm": "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>",
          "adomain": [
            "google.com"
          ],
          "cid": "82346236545",
          "crid": "test_creative_id_978541",
          "w": 390,
          "h": 61,
          "ext": {
            "skadn": {
              "version": "3.0",
              "network": "5c39728P",
              "campaign": "10199716",
              "itunesitem": "640052147",
              "sourceapp": "com.google.testapp",
              "fidelities": [
                {
                  "fidelity": 1,
                  "nonce": "9b05b355-a526-4f7c-9925-ab5c91b9dbef",
                  "signature": "0HY71438fqxkY2tqD14kV9DY1q3Fi77sc99e0D97Qo833M266T75c28Y5NM23wiL61WyNCe0277ER5eM32UxaKGf99GUM1jI",
                  "timestamp": "1714079463090"
                },
                {
                  "fidelity": 0,
                  "nonce": "9b05b355-a526-4f7c-9925-ab5c91b9dbef",
                  "signature": "J6RVg1KI31q1lB68f6F16fA07kY93DAYU2IL5ETDuvczR48oMr3S3X9tIohWi4L2VcE0w4mi42o0Mqa174U7o65951z44ru4",
                  "timestamp": "1714079463090"
                }
              ]
            },
            "app_promotion_type": "INSTALLS",
            "impression_tracking_url": [
              "https://test.com/impression?id=123456",
              "https://test.com/impression?id=123456"
            ]
          }
        }
      ],
      "seat": "4372:2283:725828"
    }
  ],
  "bidid": "Z8aZJEk4-r2e3z85n-je52-q0E586r76K4T"
}

گوگل

مثال را به من نشان بده

ad {
  html_snippet: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
  adslot {
    id: 1
    max_cpm_micros: 31014
    billing_id: 16751333146
  }
  click_through_url: "google.com"
  attribute: 47
  attribute: 50
  category: 0
  buyer_creative_id: "test_creative_id_173035"
  advertiser_name: "Google"
  width: 300
  height: 250
  impression_tracking_url: "https://test.com/imp?id=123456"
  event_notification_token: "token"
  advertised_app_id: "APP_ID_OMITTED"
  app_promotion_type: INSTALLS
}
processing_time_ms: 10

برنامه بینابینی

OpenRTB Protobuf

مثال را به من نشان بده

id: "wqZn032336g5U2Saroj8Lc"
seatbid {
  bid {
    id: "mTD7EYxAyF6n763v7pJ"
    impid: "1"
    price: 0.033932000398635864
    adid: "test_creative_id_237493"
    adm: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
    adomain: "google.com"
    adomain: "google.com"
    cid: "42834631855"
    crid: "test_creative_id_237493"
    cat: "IAB2-18"
    cat: "IAB20"
    w: 360
    h: 711
    burl: "https://test.com/imp?id=123456"
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      attribute: 8
      event_notification_token {
        payload: "token"
      }
      billing_id: 42834631855
    }
  }
}
bidid: "62i6224k-ada8764U-y4Fi-2z760VkR3s35"
cur: "USD"

OpenRTB JSON

مثال را به من نشان بده

{
  "id": "BQig8glrLj2K7p818w3s0S",
  "seatbid": [
    {
      "bid": [
        {
          "id": "v0x1j4q0B388Z5lv600",
          "impid": "1",
          "price": 0.25109,
          "adid": "test_creative_id_654733",
          "adm": "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>",
          "adomain": [
            "google.com"
          ],
          "cid": "73848702501",
          "crid": "test_creative_id_654733",
          "w": 428,
          "h": 846,
          "ext": {
            "skadn": {
              "version": "4.0",
              "network": "43D4r5x9",
              "sourceidentifier": "6217",
              "itunesitem": "950280085",
              "sourceapp": "com.google.testapp",
              "fidelities": [
                {
                  "fidelity": 0,
                  "nonce": "0d223af6-1847-43aa-9f4f-963de4468b68",
                  "signature": "8fZn83e3d0742gU7E8Ra7Vif4v1vK61X899f7G7q9Dl998035Gq81Zd4r3032814bQ03HP49709yf38n6U35YY29D0w2Ac5B",
                  "timestamp": "1714058970102"
                },
                {
                  "fidelity": 1,
                  "nonce": "0d223af6-1847-43aa-9f4f-963de4468b68",
                  "signature": "zs0k0e335UoH9M6mp1V228I8JAl2526LCKF0dc2l8x7o4270lsQ37B12Cf91a770RcNqSG7Kl667xsw97Eo4nA23o41h3c0H",
                  "timestamp": "1714058970102"
                }
              ]
            },
            "app_promotion_type": "INSTALLS",
            "impression_tracking_url": [
              "https://test.com/impression?id=123456",
              "https://test.com/impression?id=123456"
            ]
          }
        }
      ],
      "seat": "9150:1636:894279"
    }
  ],
  "bidid": "taiup4HY-42ggR62I-120u-3kyZ4831M9Yt"
}

گوگل

مثال را به من نشان بده

ad {
  html_snippet: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
  adslot {
    id: 1
    max_cpm_micros: 1079285
    billing_id: 37034094959
    currency: "TWD"
  }
  click_through_url: "google.com"
  attribute: 105
  attribute: 47
  category: 7
  buyer_creative_id: "test_creative_id_903208"
  advertiser_name: "Google"
  width: 398
  height: 744
  impression_tracking_url: "https://test.com/imp?id=123456"
  impression_tracking_url: "https://test.com/imp?id=123456"
  event_notification_token: "token"
  skadn {
    version: "4.0"
    network: "41dEOEaD"
    itunesitem: "151251861"
    sourceapp: "500811620"
    fidelities {
      fidelity_type: VIEW_THROUGH_ADS
      nonce: "0c9020f9-14c4-4dcd-8944-23ab140556a8"
      timestamp: 1714094838257
      signature: "p1f6bi578Q0jX163o5ws6n630p142H1v75rziXPtoak952g0Be18230732OkYu7epL9elCJ25078L09G5Mi6u7s7MyO2j5sI"
    }
    fidelities {
      fidelity_type: STOREKIT_RENDERED_ADS
      nonce: "0c9020f9-14c4-4dcd-8944-23ab140556a8"
      timestamp: 1714094838257
      signature: "JFtn495ab0EX97ci69Ru9c39ot9TWn5T0052F4439Y2a9u7zN2do7Q9AH4N584irpJmS8K877980K14iQgO74I33vgx231Cf"
    }
    skadn_options {
      always_open_appstore: true
    }
    source_identifier: 72
  }
}
processing_time_ms: 70

ویدیوی بینابینی برنامه

OpenRTB Protobuf

مثال را به من نشان بده

id: "cRPF1960K8WH788KM8ZT5k"
seatbid {
  bid {
    id: "99862J52T2r9f8n6hzY"
    impid: "1"
    price: 0.2873480215418293
    adid: "test_creative_id_958969"
    adm: "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%"
    adomain: "google.com"
    cid: "80831705186"
    crid: "test_creative_id_958969"
    w: 480
    h: 854
  }
  seat: "5731:4728:218110"
}
bidid: "dR2wx766-444e907U-Xpv0-634m58Wa5V73"
cur: "USD"

گوگل

مثال را به من نشان بده

ad {
  adslot {
    id: 1
    max_cpm_micros: 5037989
    billing_id: 82632801525
    currency: "TWD"
  }
  click_through_url: "google.com"
  attribute: 47
  category: 7
  buyer_creative_id: "test_creative_id_497252"
  advertiser_name: "Google"
  width: 720
  height: 1280
  video_vast_xml: "OMITTED_VAST_XML"
  event_notification_token: "token"
  advertised_app_id: "APP_ID_OMITTED"
  app_promotion_type: INSTALLS
}
processing_time_ms: 70

بومی برنامه

OpenRTB Protobuf

مثال را به من نشان بده

id: "P3mh232944yQx803R73ayZ"
seatbid {
  bid {
    id: "79B1S3h454910R471JL"
    impid: "1"
    price: 0.044748470187187195
    adomain: "google.com"
    cid: "52078759229"
    crid: "test_creative_id_537521"
    cat: "IAB20"
    burl: "https://test.com/imp?id=123456"
    adm_native {
      ver: "1.2"
      assets {
        id: 1
        required: true
        title {
          text: "Luxury Mars Cruises"
        }
      }
      assets {
        id: 5
        required: true
        img {
          url: "https://native.test.com/image?id=123456"
          w: 1200
          h: 627
          type: MAIN
        }
      }
      assets {
        id: 6
        required: false
        img {
          url: "https://native.test.com/logo?id=123456"
          w: 100
          h: 100
          type: LOGO
        }
      }
      assets {
        id: 2
        required: true
        data {
          value: "Visit the planet in a luxury spaceship."
          type: DESC
        }
      }
      assets {
        id: 3
        required: false
        data {
          value: "Book today"
          type: CTATEXT
        }
      }
      assets {
        id: 4
        required: true
        data {
          value: "Galactic Luxury Cruises"
          type: SPONSORED
        }
      }
      link {
        url: "https://www.google.com"
        clicktrackers: "https://native.test.com/click?id=123456"
      }
      eventtrackers {
        event: IMPRESSION
        method: IMG
        url: "https://test.com/event?id=123456"
      }
    }
    [com.google.doubleclick.bid] {
      event_notification_token {
        payload: "token"
      }
      billing_id: 52078759229
    }
  }
  seat: "2237:7356:617887"
}
cur: "USD"

OpenRTB JSON

مثال را به من نشان بده

{
  "id": "3u95d40fy46B0y3CEL73uy",
  "seatbid": [
    {
      "bid": [
        {
          "id": "d501820Aa099K69Ia64",
          "impid": "1",
          "price": 1.63,
          "burl": "https://test.com/imp?id=123456",
          "adm": "{\"assets\": [{\"id\": 1, \"required\": 1, \"title\": {\"text\": \"Luxury Mars Cruises\"}}, {\"id\": 2, \"required\": 1, \"data\": {\"value\": \"Visit the planet in a luxury spaceship.\", \"label\": \"\"}}, {\"id\": 3, \"data\": {\"value\": \"Book today\", \"label\": \"\"}}, {\"id\": 4, \"required\": 1, \"data\": {\"value\": \"Galactic Luxury Cruises\", \"label\": \"\"}}, {\"id\": 5, \"required\": 1, \"img\": {\"url\": \"https://native.test.com/image?id=123456\", \"h\": 628, \"w\": 1200}}, {\"id\": 6, \"img\": {\"url\": \"https://native.test.com/logo?id=123456\", \"h\": 640, \"w\": 640}}], \"link\": {\"url\": \"https://www.google.com\", \"clicktrackers\": [\"https://native.test.com/click?id=123456\"]}, \"imptrackers\": [\"https://test.com/impression?id=123456&amt=${AUCTION_PRICE}\"], \"privacy\": \"\"}",
          "adid": "test_creative_id_237765",
          "adomain": [
            "google.com"
          ],
          "cid": "30567639040",
          "crid": "test_creative_id_237765",
          "cat": [
            "IAB8"
          ],
          "ext": {
            "skadn": {
              "version": "3.0",
              "network": "345vh5bv",
              "campaign": "62744790",
              "itunesitem": "608550422",
              "sourceapp": "com.google.testapp",
              "fidelities": [
                {
                  "fidelity": 0,
                  "nonce": "88db095e-1022-48bb-ad38-54a1075886aa",
                  "timestamp": "1714430552729",
                  "signature": "4063Vhn5W7oGEcJ202oj6k990Y3H7f9sJ6luK3O65RbQ3S9kp45VK84le4a424c6SU79384DTdXS1cHWcxl9SB98563Y38K9"
                },
                {
                  "fidelity": 1,
                  "nonce": "88db095e-1022-48bb-ad38-54a1075886aa",
                  "timestamp": "1714430552729",
                  "signature": "r1852LY7j0f25q2s868j1Ub7r07S16e607BC5909O272F8i528732r22W7D138t3706205Ez139N73Iho3vJKp257Pp4vmet"
                }
              ]
            },
            "app_promotion_type": 1,
            "event_notification_token": {
              "payload": "token"
            }
          }
        }
      ],
      "seat": "3512:7802:295531"
    }
  ],
  "cur": "USD"
}

گوگل

مثال را به من نشان بده

ad {
  adslot {
    id: 1
    max_cpm_micros: 1581987
    billing_id: 32132054378
  }
  click_through_url: "google.com"
  attribute: 47
  attribute: 8
  buyer_creative_id: "test_creative_id_285893"
  advertiser_name: "Google"
  native_ad {
    headline: "Luxury Mars Cruises"
    body: "Visit the planet in a luxury spaceship."
    call_to_action: "Book today"
    advertiser: "Galactic Luxury Cruises"
    image {
      url: "https://native.test.com/image?id=123456"
      width: 800
      height: 800
    }
    logo {
      url: "https://native.test.com/logo?id=123456"
      width: 200
      height: 200
    }
    price: "\342\202\254106.40"
    click_link_url: "https://www.google.com"
  }
  impression_tracking_url: "https://test.com/imp?id=123456"
  impression_tracking_url: "https://test.com/imp?id=123456"
  ad_choices_destination_url: "https://test.com/preferences"
  event_notification_token: "token"
}
processing_time_ms: 20

ویدئوی وب

گوگل

مثال را به من نشان بده

ad {
  adslot {
    id: 1
    max_cpm_micros: 16000000
    billing_id: 34223090460
    deal_id: 17775265
  }
  click_through_url: "google.com"
  attribute: 47
  attribute: 8
  video_url: "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%"
  buyer_creative_id: "test_creative_id_551392"
  advertiser_name: "Google"
  event_notification_token: "token"
}
processing_time_ms: 7

OpenRTB Protobuf

مثال را به من نشان بده

id: "878w58e050dSf05LS9l424"
seatbid {
  bid {
    id: "478u6K990C990n7FPTX"
    impid: "1"
    price: 0.03
    adm: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
    adomain: "google.com"
    cid: "46483683815"
    crid: "test_creative_id_527097"
    w: 320
    h: 50
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      impression_tracking_url: "https://test.com/impression?id=123456"
      event_notification_token {
        payload: "token"
      }
      billing_id: 46483683815
    }
  }
  seat: "6954:3639:781296"
}
bidid: "7a2CAWgt-IKR8mp06-0E3d-TPNq4zO9l767"
[com.google.doubleclick.bid_response] {
  processing_time_ms: 120
}

پاسخ را بسازید

پیام Protobuf BidResponse ایجاد کنید

شناسه خلاق

ویژگی های آگهی

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

توصیه ها

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

OpenRTB Protobuf

مثال را به من نشان بده

OpenRTB JSON

مثال را به من نشان بده

گوگل

مثال را به من نشان بده

خلاقیت را مشخص کنید

ماکروها را مشخص کنید

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

محدودیت ها و الزامات ناشر

باز کردن اندازه‌گیری

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

بنر اپلیکیشن

OpenRTB Protobuf

مثال را به من نشان بده

OpenRTB JSON

مثال را به من نشان بده

گوگل

مثال را به من نشان بده

برنامه بینابینی

OpenRTB Protobuf

مثال را به من نشان بده

OpenRTB JSON

مثال را به من نشان بده

گوگل

مثال را به من نشان بده

ویدیوی بینابینی برنامه

OpenRTB Protobuf

مثال را به من نشان بده

گوگل

مثال را به من نشان بده

بومی برنامه

OpenRTB Protobuf

مثال را به من نشان بده

OpenRTB JSON

مثال را به من نشان بده

گوگل

مثال را به من نشان بده

ویدئوی وب

گوگل

مثال را به من نشان بده

بنر وب موبایل برای پیشنهاد دهنده مبادله

OpenRTB Protobuf

مثال را به من نشان بده