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

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

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

ایجاد پیام BidResponse

برای ارسال پیشنهاد، برنامه پیشنهاد شما باید به درخواست پیشنهاد با یک BidResponse حاوی یک Bid در قالب پیکربندی شده شما پاسخ دهد. اگر از قالب JSON استفاده می‌کنید، پاسخ شما باید هدر Content-Type را روی application/json; charset=utf-8 تنظیم کند و JSON BidResponse در بدنه قرار دهد. اگر از قالب Protobuf استفاده می‌کنید، برنامه شما باید هدر Content-Type را روی application/octet-stream تنظیم کند و BidResponse سریالی شده را در بدنه قرار دهد.

برای ساخت و سریالایز کردن یک BidResponse برای فرمت Protobuf، باید کتابخانه‌های Protobuf را بر اساس openrtb.proto و openrtb-adx.proto تولید و استفاده کنید، که به ترتیب فیلدهای استاندارد OpenRTB BidResponse و افزونه‌های گوگل را در Protobuf پیاده‌سازی می‌کنند. این موارد را می‌توانید در Protos & Reference Data پیدا کنید.

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

شناسه خلاق

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

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

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

ویژگی‌های تبلیغ

گوگل توصیه می‌کند برای توصیف ویژگی‌های تبلیغ و هدف‌گیری آن، ویژگی‌های خلاقانه را با استفاده از ترکیبی از 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 یا برای فرمت JSON 3 تنظیم کنید.
SIZELESS
BidResponse.seatbid.bid.attr روی RESPONSIVE یا برای فرمت JSON 18 تنظیم کنید.
PLAYABLE
این با تنظیم BidResponse.seatbid.bid.attr روی USER_INTERACTIVE یا 13 برای فرمت JSON نشان داده می‌شود.

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

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

زمینه‌های مناقصه آزاد

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

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

توصیه‌ها

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

مثال پاسخ به پیشنهاد

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

پروتوباف OpenRTB

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

پاسخ سریالی

id: "1lY5z94y6Bz404R9H0ZN38"
seatbid {
  bid {
    id: "n1KLe2Q26Xyu431W1PU"
    impid: "1"
    price: 1.0575798749923706
    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>"
    crid: "test_creative_id_666097"
    dealid: "0"
    w: 339
    h: 53
    burl: "https://test.com/imp?id=123456"
    [com.google.doubleclick.bid] {
      event_notification_token {
        payload: "token"
      }
      billing_id: 86548870602
      dsa {
        adrender: true
      }
      clickurl: "google.com"
    }
  }
}
cur: "JPY"
[com.google.doubleclick.bid_response] {
  processing_time_ms: 7
}

OpenRTB JSON

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

{
  "id": "1lY5z94y6Bz404R9H0ZN38",
  "seatbid": [
    {
      "bid": [
        {
          "id": "n1KLe2Q26Xyu431W1PU",
          "impid": "1",
          "price": 1.0575798749923706,
          "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>",
          "crid": "test_creative_id_666097",
          "dealid": "0",
          "w": 339,
          "h": 53,
          "burl": "https://test.com/imp?id=123456",
          "ext": {
            "event_notification_token": {
              "payload": "token"
            },
            "billing_id": "86548870602",
            "dsa": {
              "adrender": 1
            },
            "clickurl": [
              "google.com"
            ]
          }
        }
      ]
    }
  ],
  "cur": "JPY",
  "ext": {
    "processing_time_ms": 7
  }
}

مهم: پیام‌های Protobuf که در نمونه‌ها نشان داده شده‌اند، در اینجا به صورت متن قابل خواندن توسط انسان نمایش داده می‌شوند. با این حال، این نحوه ارسال پیام‌ها از طریق سیم نیست. هنگام استفاده از فرمت 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
آمپر
- BidResponse.seatbid.bid.amp_ad_url
ویدئو
- BidResponse.seatbid.bid.adm
بومی
- BidResponse.seatbid.bid.adm_native

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

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

منظور از تبلیغ، یک بنر معمولی است (نه ویدیویی، بومی یا بینابینی).
پیشنهاد دهنده اندازه را در پاسخ پیشنهاد اعلام کرده است. هر زمان که بیش از یک اندازه در درخواست وجود داشته باشد، اعلام اندازه الزامی است.
برای تبلیغات بینابینی یک استثنا وجود دارد. برای تبلیغات بینابینی، عرض باید حداقل ۵۰٪ عرض صفحه نمایش و ارتفاع آن حداقل ۴۰٪ ارتفاع صفحه نمایش باشد.

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

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

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

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

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

BidResponse.seatbid.bid.adm
ماکروها برای قالب‌های HTML snippet، native، video URL و video 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 مخصوص گوگل برای تبلیغات AMP پشتیبانی می‌شوند.
BidResponse.seatbid.bid.burl
BidResponse.seatbid.bid.ext.impression_tracking_url
اگر به بیش از یک آدرس اینترنتی پرداخت نیاز دارید، از این به جای BidResponse.seatbid.bid.burl استفاده کنید.

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

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

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

ماکرو	توضیحات
`ADVERTISING_IDENTIFIER`	به خریداران اجازه می‌دهد تا شناسه تبلیغات iOS IDFA یا Android را در هنگام نمایش تبلیغات دریافت کنند. برای جزئیات بیشتر به رمزگشایی شناسه‌های تبلیغ‌کننده مراجعه کنید.
`CACHEBUSTER`	نمایش رشته‌ای از یک عدد صحیح تصادفی، بدون علامت و چهار بایتی.
`CLICK_URL_UNESC`	آدرس کلیک بدون اسکیپ برای تبلیغ. در قطعه کد، یک نسخه اسکیپ شده از آدرس کلیک شخص ثالث باید مستقیماً پس از ماکرو قرار گیرد. برای مثال، اگر آدرس کلیک شخص ثالث `http://my.adserver.com/some/path/handleclick?click=clk` باشد، می‌توان از کد زیر با نسخه single-escaped آدرس کلیک شخص ثالث پس از فراخوانی ماکرو استفاده کرد: <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 ابتدا کلیک را در گوگل ثبت می‌کند و سپس به URL کلیک شخص ثالث هدایت می‌شود.
`CLICK_URL_ESC`	آدرس کلیکِ escape شده برای تبلیغ. اگر نیاز دارید که ابتدا مقدار را از طریق سرور دیگری ارسال کنید که سپس یک ریدایرکت را برمی‌گرداند، از این به جای `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` از حالت فشرده خارج می‌کند. می‌توانید یک URL با دوبار escape شدن بعد از `%%CLICK_URL_ESC%%` اضافه کنید. پس از اینکه unescaping توسط `my.adserver.com` انجام شد، یک نسخه single-escaped از URL باقی می‌ماند که به `google_click_url` اضافه شده است. وقتی `google_click_url` دریافت می‌شود، یک بار دیگر unscape شده و سپس تغییر مسیر می‌دهد.
`CLICK_URL_ESC_ESC`	آدرس اینترنتی (URL) تبلیغ که با دو بار escape شدن نمایش داده می‌شود. اگر نیاز دارید که ابتدا مقدار را از طریق سرور دیگری ارسال کنید که سپس یک ریدایرکت را برمی‌گرداند، از این به جای `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:` و اگر به `https:` گسترش می‌یابد.
`SITE`	دامنه‌ی url-escaped مربوط به 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 برنده ۵ دلار آمریکا معادل ۵،۰۰۰،۰۰۰ میکرو CPM یا ۵،۰۰۰ میکرو CPI است. مقدار رمزگشایی شده `WINNING_PRICE` در این مورد ۵،۰۰۰ خواهد بود. قیمت برنده بر حسب CPI مشخص شده است. برای تجزیه این ماکرو، باید برنامه‌ای پیاده‌سازی کنید که تأییدیه‌های قیمت را رمزگشایی کند. برای اطلاعات بیشتر به صفحه رمزگشایی تأییدیه‌های قیمت مراجعه کنید.
`WINNING_PRICE_ESC`	`WINNING_PRICE` با URL اسکیپ شده.

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

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

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

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

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

BidRequest.bcat
- شما می‌توانید دسته‌های مسدود شده مشخص شده توسط این فیلد را با دسته‌های شناسایی شده برای آگهی‌های تبلیغاتی ارسالی خود با استفاده از فیلد detectedCategories در API پیشنهاد قیمت لحظه‌ای مقایسه کنید.
BidRequest.imp.ext.allowed_vendor_type
BidRequest.imp.secure
- در عمل، این همیشه true تنظیم می‌شود زیرا گوگل برای همه آگهی‌های تبلیغاتی به پشتیبانی 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 هستید. اگر یک تبلیغ چندین مقدار قابل اجرا برای این فیلدها دارد، باید هر مقدار را وارد کنید. برای جزئیات بیشتر به توضیحات مربوط به این فیلدها در تعریف بافر پروتکل BidResponse مراجعه کنید. پاسخ‌هایی که این فیلدها را تنظیم نکرده باشند، نادیده گرفته می‌شوند.

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

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

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

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

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

پروتوباف OpenRTB

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

پاسخ سریالی

id: "4308k26S0C36XQ2z1dIo99"
seatbid {
  bid {
    id: "y2OcJw5j213rO95Gz78"
    impid: "1"
    price: 18.360865389304116
    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>"
    crid: "test_creative_id_391487"
    dealid: "1"
    w: 390
    h: 60
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      ad_choices_destination_url: "https://test.com/preferences"
      billing_id: 82364411103
      skadn {
        version: "4.0"
        network: "cF58w81X"
        itunesitem: "788729094"
        sourceapp: "1422994973"
        fidelities {
          fidelity: VIEW_THROUGH_ADS
          nonce: "017e597c-3c7d-4a44-afeb-41cd9a17066f"
          timestamp: "1757235407882"
          signature: "11iF1L96q2cw8tu790p301c10530ogr7h250k1P9pLxqcJ2qe37klG8xB3M592YbpafQ9861493838C521XA6AEF4A40DK8X"
        }
        fidelities {
          fidelity: STOREKIT_RENDERED_ADS
          nonce: "017e597c-3c7d-4a44-afeb-41cd9a17066f"
          timestamp: "1757235407882"
          signature: "f67L3C138Y6XB7940141011Pd58AZbdBk9Xo1Mlf1973706DsB5808ILLKumU2ic9fr72b9bSs3CD25CCZo8DJB65JB0615L"
        }
        sourceidentifier: "5507"
      }
      app_promotion_type: INSTALLS
      clickurl: "google.com"
      clickurl: "example.com"
    }
  }
  seat: "2542:1534:245840"
}
[com.google.doubleclick.bid_response] {
  processing_time_ms: 3
}

OpenRTB JSON

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

{
  "id": "4308k26S0C36XQ2z1dIo99",
  "seatbid": [
    {
      "bid": [
        {
          "id": "y2OcJw5j213rO95Gz78",
          "impid": "1",
          "price": 18.360865389304116,
          "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>",
          "crid": "test_creative_id_391487",
          "dealid": "1",
          "w": 390,
          "h": 60,
          "ext": {
            "impression_tracking_url": [
              "https://test.com/impression?id=123456"
            ],
            "ad_choices_destination_url": "https://test.com/preferences",
            "billing_id": "82364411103",
            "skadn": {
              "version": "4.0",
              "network": "cF58w81X",
              "itunesitem": "788729094",
              "sourceapp": "1422994973",
              "fidelities": [
                {
                  "fidelity": 0,
                  "nonce": "017e597c-3c7d-4a44-afeb-41cd9a17066f",
                  "timestamp": "1757235407882",
                  "signature": "11iF1L96q2cw8tu790p301c10530ogr7h250k1P9pLxqcJ2qe37klG8xB3M592YbpafQ9861493838C521XA6AEF4A40DK8X"
                },
                {
                  "fidelity": 1,
                  "nonce": "017e597c-3c7d-4a44-afeb-41cd9a17066f",
                  "timestamp": "1757235407882",
                  "signature": "f67L3C138Y6XB7940141011Pd58AZbdBk9Xo1Mlf1973706DsB5808ILLKumU2ic9fr72b9bSs3CD25CCZo8DJB65JB0615L"
                }
              ],
              "sourceidentifier": "5507"
            },
            "app_promotion_type": 1,
            "clickurl": [
              "google.com",
              "example.com"
            ]
          }
        }
      ],
      "seat": "2542:1534:245840"
    }
  ],
  "ext": {
    "processing_time_ms": 3
  }
}

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

پروتوباف OpenRTB

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

پاسخ سریالی

id: "U0t6Une80802A28Mi98o1t"
seatbid {
  bid {
    id: "300z78I726nCP7u4sFp"
    impid: "1"
    price: 149.83914184570312
    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>"
    crid: "test_creative_id_732353"
    dealid: "0"
    w: 360
    h: 715
    burl: "https://test.com/imp?id=123456"
    [com.google.doubleclick.bid] {
      event_notification_token {
        payload: "token"
      }
      billing_id: 68640308112
      dsa {
        adrender: true
      }
      clickurl: "google.com"
    }
  }
}
cur: "JPY"
[com.google.doubleclick.bid_response] {
  processing_time_ms: 10
}

OpenRTB JSON

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

{
  "id": "U0t6Une80802A28Mi98o1t",
  "seatbid": [
    {
      "bid": [
        {
          "id": "300z78I726nCP7u4sFp",
          "impid": "1",
          "price": 149.83914184570312,
          "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>",
          "crid": "test_creative_id_732353",
          "dealid": "0",
          "w": 360,
          "h": 715,
          "burl": "https://test.com/imp?id=123456",
          "ext": {
            "event_notification_token": {
              "payload": "token"
            },
            "billing_id": "68640308112",
            "dsa": {
              "adrender": 1
            },
            "clickurl": [
              "google.com"
            ]
          }
        }
      ]
    }
  ],
  "cur": "JPY",
  "ext": {
    "processing_time_ms": 10
  }
}

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

پروتوباف OpenRTB

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

پاسخ سریالی

id: "n40G42d551UX18627ao8lt"
seatbid {
  bid {
    id: "17u6BnD62h88r5q7066"
    impid: "1"
    price: 0.797848
    adm: "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%"
    adomain: "google.com"
    crid: "test_creative_id_987914"
    w: 320
    h: 480
    cattax: GOOGLE_CATEGORIES
    [com.google.doubleclick.bid] {
      attribute: 47
      attribute: 50
      billing_id: 55383762512
      skadn {
        version: "4.0"
        network: "306el65O"
        itunesitem: "832461214"
        sourceapp: "977150768"
        fidelities {
          fidelity: VIEW_THROUGH_ADS
          nonce: "0054e0b9-0b53-4426-99dd-a1eefeb45565"
          timestamp: "1757329316673"
          signature: "oE3Ek8347oZV1Yl1J42G2c88BSKr2dqEbiOK2S4ni7NVDh3v128NN0hlzWK5aX96ecV1504E9k288i0t0wGX73P317812WE7"
        }
        fidelities {
          fidelity: STOREKIT_RENDERED_ADS
          nonce: "0054e0b9-0b53-4426-99dd-a1eefeb45565"
          timestamp: "1757329316673"
          signature: "b1GqXA4v889p842512GQ1p3249q5VmPt1335f1H1zdK92fq24j7a7ml419W7u8B7rhhH97s507f2251923oWi89XF1voZv4b"
        }
        sourceidentifier: "8396"
      }
      app_promotion_type: INSTALLS
      clickurl: "google.com"
    }
  }
}
[com.google.doubleclick.bid_response] {
  processing_time_ms: 20
}

OpenRTB JSON

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

{
  "id": "n40G42d551UX18627ao8lt",
  "seatbid": [
    {
      "bid": [
        {
          "id": "17u6BnD62h88r5q7066",
          "impid": "1",
          "price": 0.797848,
          "adm": "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%",
          "adomain": [
            "google.com"
          ],
          "crid": "test_creative_id_987914",
          "w": 320,
          "h": 480,
          "cattax": 500,
          "ext": {
            "attribute": [
              47,
              50
            ],
            "billing_id": "55383762512",
            "skadn": {
              "version": "4.0",
              "network": "306el65O",
              "itunesitem": "832461214",
              "sourceapp": "977150768",
              "fidelities": [
                {
                  "fidelity": 0,
                  "nonce": "0054e0b9-0b53-4426-99dd-a1eefeb45565",
                  "timestamp": "1757329316673",
                  "signature": "oE3Ek8347oZV1Yl1J42G2c88BSKr2dqEbiOK2S4ni7NVDh3v128NN0hlzWK5aX96ecV1504E9k288i0t0wGX73P317812WE7"
                },
                {
                  "fidelity": 1,
                  "nonce": "0054e0b9-0b53-4426-99dd-a1eefeb45565",
                  "timestamp": "1757329316673",
                  "signature": "b1GqXA4v889p842512GQ1p3249q5VmPt1335f1H1zdK92fq24j7a7ml419W7u8B7rhhH97s507f2251923oWi89XF1voZv4b"
                }
              ],
              "sourceidentifier": "8396"
            },
            "app_promotion_type": 1,
            "clickurl": [
              "google.com"
            ]
          }
        }
      ]
    }
  ],
  "ext": {
    "processing_time_ms": 20
  }
}

برنامه بومی

پروتوباف OpenRTB

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

پاسخ سریالی

id: "550102L8So5v6gi4C00T36"
seatbid {
  bid {
    id: "U796oSA426V3U666ue8"
    impid: "1"
    price: 1.057860016822815
    crid: "test_creative_id_395811"
    dealid: "0"
    adm_native {
      ver: "1.2"
      assets {
        id: 6
        img {
          url: "https://native.test.com/logo?id=123456"
          w: 200
          h: 200
          type: LOGO
        }
      }
      assets {
        id: 5
        img {
          url: "https://native.test.com/image?id=123456"
          w: 800
          h: 800
          type: MAIN
        }
      }
      assets {
        id: 4
        data {
          value: "Galactic Luxury Cruises"
          type: SPONSORED
        }
      }
      assets {
        id: 3
        data {
          value: "Book today"
          type: CTATEXT
        }
      }
      assets {
        id: 1
        title {
          text: "Luxury Mars Cruises"
        }
      }
      assets {
        id: 2
        data {
          value: "Visit the planet in a luxury spaceship."
          type: DESC
        }
      }
      link {
        url: "https://www.google.com"
      }
    }
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      impression_tracking_url: "https://test.com/impression?id=123456"
      ad_choices_destination_url: "https://test.com/preferences"
      event_notification_token {
        payload: "token"
      }
      billing_id: 73917825312
      dsa {
        adrender: true
      }
      clickurl: "google.com"
    }
  }
}
cur: "JPY"
[com.google.doubleclick.bid_response] {
  processing_time_ms: 17
}

OpenRTB JSON

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

{
  "id": "550102L8So5v6gi4C00T36",
  "seatbid": [
    {
      "bid": [
        {
          "id": "U796oSA426V3U666ue8",
          "impid": "1",
          "price": 1.057860016822815,
          "crid": "test_creative_id_395811",
          "dealid": "0",
          "ext": {
            "impression_tracking_url": [
              "https://test.com/impression?id=123456",
              "https://test.com/impression?id=123456"
            ],
            "ad_choices_destination_url": "https://test.com/preferences",
            "event_notification_token": {
              "payload": "token"
            },
            "billing_id": "73917825312",
            "dsa": {
              "adrender": 1
            },
            "clickurl": [
              "google.com"
            ]
          },
          "adm": "{\"ver\":\"1.2\",\"assets\":[{\"id\":6,\"img\":{\"url\":\"https://native.test.com/logo?id=123456\",\"w\":200,\"h\":200,\"type\":2}},{\"id\":5,\"img\":{\"url\":\"https://native.test.com/image?id=123456\",\"w\":800,\"h\":800,\"type\":3}},{\"id\":4,\"data\":{\"value\":\"Galactic Luxury Cruises\",\"type\":1}},{\"id\":3,\"data\":{\"value\":\"Book today\",\"type\":12}},{\"id\":1,\"title\":{\"text\":\"Luxury Mars Cruises\"}},{\"id\":2,\"data\":{\"value\":\"Visit the planet in a luxury spaceship.\",\"type\":2}}],\"link\":{\"url\":\"https://www.google.com\"}}"
        }
      ]
    }
  ],
  "cur": "JPY",
  "ext": {
    "processing_time_ms": 17
  }
}

ویدیوی وب

پروتوباف OpenRTB

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

پاسخ سریالی

id: "04XK8XoQI227314y42h0LL"
seatbid {
  bid {
    id: "R9TtHE88cGu48FA4DuG"
    impid: "1"
    price: 1.0523000955581665
    adm: "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%"
    crid: "test_creative_id_400281"
    dealid: "45957820"
    [com.google.doubleclick.bid] {
      event_notification_token {
        payload: "token"
      }
      billing_id: 63495119434
      dsa {
        adrender: true
      }
      clickurl: "google.com"
    }
  }
}
cur: "JPY"
[com.google.doubleclick.bid_response] {
  processing_time_ms: 11
}

OpenRTB JSON

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

{
  "id": "04XK8XoQI227314y42h0LL",
  "seatbid": [
    {
      "bid": [
        {
          "id": "R9TtHE88cGu48FA4DuG",
          "impid": "1",
          "price": 1.0523000955581665,
          "adm": "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%",
          "crid": "test_creative_id_400281",
          "dealid": "45957820",
          "ext": {
            "event_notification_token": {
              "payload": "token"
            },
            "billing_id": "63495119434",
            "dsa": {
              "adrender": 1
            },
            "clickurl": [
              "google.com"
            ]
          }
        }
      ]
    }
  ],
  "cur": "JPY",
  "ext": {
    "processing_time_ms": 11
  }
}

پروتوباف OpenRTB

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

پاسخ سریالی

id: "C379209h9u3tvIMwToq9PW"
seatbid {
  bid {
    id: "l36729l7aMo7WO801t9"
    impid: "1"
    price: 0.2
    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"
    crid: "test_creative_id_465923"
    w: 320
    h: 50
    mtype: CREATIVE_MARKUP_BANNER
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      event_notification_token {
        payload: "token"
      }
      billing_id: 98128982291
      third_party_buyer_token: "dl5c45g43kEO9Ie04cn6b4tG674R212W3pCNE7xew665149V0R600SJQR3OClz2KeJ8aGTWi4UnZsd6UnrNW8UU4EZ6w7mD32fI4EdIqi3fq7T88936L7hpA7Uz43451508HVp0Y47Pq"
    }
  }
  seat: "1433:4310:708345"
}
seatbid {
  bid {
    id: "Uod3V6V129YHu2g8V0p"
    impid: "1"
    price: 0.15
    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"
    crid: "test_creative_id_465923"
    w: 320
    h: 50
    mtype: CREATIVE_MARKUP_BANNER
    [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"
      }
    }
  }
  bid {
    id: "63V17Ip8VwlE60G90qV"
    impid: "1"
    price: 0.09
    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"
    crid: "test_creative_id_465923"
    w: 320
    h: 50
    mtype: CREATIVE_MARKUP_BANNER
    [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"
      }
    }
  }
  seat: "1433:4310:708345"
}
bidid: "918c2X56-F1CeU3fl-289U-4mm9263RC66m"
[com.google.doubleclick.bid_response] {
  processing_time_ms: 130
}

OpenRTB JSON

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

{
  "id": "C379209h9u3tvIMwToq9PW",
  "seatbid": [
    {
      "bid": [
        {
          "id": "l36729l7aMo7WO801t9",
          "impid": "1",
          "price": 0.2,
          "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"
          ],
          "crid": "test_creative_id_465923",
          "w": 320,
          "h": 50,
          "mtype": 1,
          "ext": {
            "impression_tracking_url": [
              "https://test.com/impression?id=123456"
            ],
            "event_notification_token": {
              "payload": "token"
            },
            "billing_id": "98128982291",
            "third_party_buyer_token": "dl5c45g43kEO9Ie04cn6b4tG674R212W3pCNE7xew665149V0R600SJQR3OClz2KeJ8aGTWi4UnZsd6UnrNW8UU4EZ6w7mD32fI4EdIqi3fq7T88936L7hpA7Uz43451508HVp0Y47Pq"
          }
        }
      ],
      "seat": "1433:4310:708345"
    },
    {
      "bid": [
        {
          "id": "Uod3V6V129YHu2g8V0p",
          "impid": "1",
          "price": 0.15,
          "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"
          ],
          "crid": "test_creative_id_465923",
          "w": 320,
          "h": 50,
          "mtype": 1,
          "ext": {
            "impression_tracking_url": [
              "https://test.com/impression?id=123456",
              "https://test.com/impression?id=123456"
            ],
            "event_notification_token": {
              "payload": "token"
            }
          }
        },
        {
          "id": "63V17Ip8VwlE60G90qV",
          "impid": "1",
          "price": 0.09,
          "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"
          ],
          "crid": "test_creative_id_465923",
          "w": 320,
          "h": 50,
          "mtype": 1,
          "ext": {
            "impression_tracking_url": [
              "https://test.com/impression?id=123456",
              "https://test.com/impression?id=123456"
            ],
            "event_notification_token": {
              "payload": "token"
            }
          }
        }
      ],
      "seat": "1433:4310:708345"
    }
  ],
  "bidid": "918c2X56-F1CeU3fl-289U-4mm9263RC66m",
  "ext": {
    "processing_time_ms": 130
  }
}

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

ایجاد پیام BidResponse

شناسه خلاق

ویژگی‌های تبلیغ

زمینه‌های مناقصه آزاد

توصیه‌ها

مثال پاسخ به پیشنهاد

پروتوباف OpenRTB

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

OpenRTB JSON

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

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

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

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

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

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

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

بنر برنامه

پروتوباف OpenRTB

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

OpenRTB JSON

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

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

پروتوباف OpenRTB

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

OpenRTB JSON

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

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

پروتوباف OpenRTB

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

OpenRTB JSON

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

برنامه بومی

پروتوباف OpenRTB

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

OpenRTB JSON

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

ویدیوی وب

پروتوباف OpenRTB

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

OpenRTB JSON

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

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

پروتوباف OpenRTB

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

OpenRTB JSON

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

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