تستخدم Google تكنولوجيا الذكاء الاصطناعي لترجمة المحتوى إلى لغتك المفضّلة، وقد تتضمّن بعض الأخطاء.

بناء الرد

بعد أن يعالج تطبيقك طلب عرض السعر من Google، يجب أن ينشئ ردًا ويرسله. يشرح هذا الدليل كيفية ترميز تطبيقك لإنشاء الردّ.

إنشاء رسالة BidResponse

لإرسال عرض سعر، يجب أن يستجيب تطبيق عروض الأسعار لطلب عرض سعر باستخدام BidResponse يحتوي على Bid بالتنسيق الذي تم ضبطه. إذا كنت تستخدم تنسيق JSON، يجب أن يضبط ردّك عنوان Content-Type على application/json; charset=utf-8 وأن يتضمّن BidResponse بتنسيق JSON في النص. إذا كنت تستخدم تنسيق Protobuf، يجب أن يضبط تطبيقك عنوان Content-Type على application/octet-stream وأن يتضمّن BidResponse المتسلسل في النص.

لإنشاء BidResponse وتسلسله لتنسيق Protobuf، يجب إنشاء مكتبات Protobuf واستخدامها استنادًا إلى openrtb.proto وopenrtb-adx.proto، اللذين ينفّذان حقول BidResponse العادية في OpenRTB وإضافات Google في Protobuf على التوالي. ويمكن العثور عليها في النماذج الأولية والبيانات المرجعية.

إذا كنت لا تريد تقديم عرض سعر لظهور إعلان، عليك عرض استجابة HTTP 204 فارغة. يجب أن يعرض تطبيقك ردًا على كل BidRequest. تُعتبر المهلات والردود التي لا يمكن تحليلها أخطاءً، وتحدّ Google من مقدّمي عروض الأسعار الذين لديهم معدلات خطأ عالية.

الرقم التعريفي لتصميم الإعلان

يحدّد BidResponse تصميم إعلان من خلال الحقل BidResponse.seatbid.bid.crid (الحدّ الأقصى 128 بايت). حتى تصاميم الإعلانات المتشابهة يجب أن تتضمّن قيمًا فريدة لهذا الحقل إذا كانت تختلف في أي خصائص ملحوظة، بما في ذلك على سبيل المثال لا الحصر: الحجم وعنوان 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 للإفصاح عن هذه السمات.

يمكنك الاطّلاع على مورد تصاميم الإعلانات للحصول على شرح حول كيفية تلقّي ملاحظات بشأن السمات التي تم رصدها في تصاميم إعلاناتك.

حقول "عرض الأسعار المفتوح"

تتشابه الاستجابات لعروض الأسعار التي يرسلها مقدّمو عروض الأسعار في الشبكات وسوق الإعلانات المشاركون في "عرض الأسعار المفتوح" مع ردود "الشراة المعتمَدون" المشاركين في "عرض الأسعار في الوقت الفعلي" العادي. يمكن لعملاء "عرض الأسعار المفتوح" تحديد عدد صغير من الحقول الإضافية، وقد يكون لبعض الحقول الحالية استخدامات بديلة. وتشمل هذه الميزات ما يلي:

الحقل	التفاصيل
`BidResponse.imp.pmp.deals.id`	رقم تعريف الصفقة من مساحة الاسم في سوق الإعلانات المرتبط بعرض السعر هذا والذي يتم إبلاغ الناشرين به ملاحظة: لا يتم إرسال هذا الحقل إلا إلى المشاركين في الإصدار التجريبي المغلق.
`BidResponse.seatbid.bid.ext.exchange_deal_type`	نوع الصفقة التي يتم إبلاغ الناشرين بها، ما يؤثر في كيفية التعامل مع الصفقة في المزاد ملاحظة: لا يتم إرسال هذا الحقل إلا إلى المشاركين في الإصدار التجريبي المغلق.
`BidResponse.seatbid.bid.ext.third_party_buyer_token`	الرمز المميّز المستخدَم لتحديد معلومات المشتري الخارجي النهائي إذا كان التبادل بصفته مقدّم عرض سعر مفتوح هو وسيط. يتم الحصول على هذه القيمة من المشتري التابع لجهة خارجية، ويجب تمريرها إلى Google بدون تغيير في الاستجابة لعرض السعر.

الاقتراحات

فعِّل اتصالات HTTPS المستمرة (المعروفة أيضًا باسم "keep-alive" أو "إعادة استخدام الاتصال") على خوادمك. اضبط المهلة على 10 ثوانٍ كحد أدنى، علمًا بأنّ القيم الأعلى تكون مفيدة في كثير من الحالات. تتحقّق Google من ذلك أثناء اختبارات وقت الاستجابة الأولية لتطبيقك، لأنّ "الشراة المعتمَدون" يرسلون الطلبات بمعدّل مرتفع ويحتاجون إلى تجنُّب وقت الاستجابة الإضافي لإنشاء اتصال TCP منفصل لكل طلب.
أدرِج عنوان URL الاختياري لتتبُّع مرّات الظهور من أجل تتبُّع وقت عرض مرّة الظهور بدلاً من وقت فوز مقدِّم عرض السعر. بسبب الانخفاض بين مرات الفوز ومرات العرض، يؤدي ذلك إلى الحصول على إحصاءات تتبُّع أكثر دقة.

ملاحظة: عند استخدام OpenRTB، يكون الحقل العادي لذلك هو BidResponse.seatbid.bid.burl.
احرص على أن يكون رمز مقدِّم عرض السعر خاليًا من الاعتماد على الحقول المتوقّفة نهائيًا، والتي يمكن أن تؤدي إلى تعذُّر تقديم عروض أسعارك بسبب حدوث أخطاء.
أدرِج BidResponse.seatbid.bid.w وBidResponse.seatbid.bid.h في BidResponse. يجب أن يتضمّن أي BidResponse لطلب يحتوي على أحجام إعلانات متعددة هذه الحقول، وإلا سيتم استبعاده من المزاد.
يجب ألا يتجاوز حجم الردّ 8 كيلوبايت. قد تؤدي الردود الكبيرة جدًا إلى زيادة وقت استجابة الشبكة وحدوث مهلات.
اتّبِع الإرشادات المتعلّقة بعروض الأسعار على المساحات الإعلانية المتاحة في iOS التي تتطلّب تحديد المصدر في SKAdNetwork.

مثال على الاستجابة لعرض السعر

تمثّل الأمثلة التالية نماذج يمكن لشخص عادي قراءتها لطلبات Protobuf وJSON.

OpenRTB Protobuf

عرض المثال

Serialized response

id: "Z40x0v53721142nd3J1E07"
seatbid {
  bid {
    id: "25lvG8gXKV0GEcaQE67"
    impid: "1"
    price: 0.01176087612355106
    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_656889"
    w: 395
    h: 62
    burl: "https://test.com/imp?id=123456"
    [com.google.doubleclick.bid] {
      exchange_deal_type: OPEN_AUCTION
      attribute: 21
      event_notification_token {
        payload: "token"
      }
      billing_id: 40355106859
      clickurl: "google.com"
    }
  }
  seat: "7877:1572:891547"
}
bidid: "A7j5NZRS-vA5H1033-4084-459j7H7Gn614"
[com.google.doubleclick.bid_response] {
  processing_time_ms: 54
}

OpenRTB JSON

عرض المثال

{
  "id": "Z40x0v53721142nd3J1E07",
  "seatbid": [
    {
      "bid": [
        {
          "id": "25lvG8gXKV0GEcaQE67",
          "impid": "1",
          "price": 0.01176087612355106,
          "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_656889",
          "w": 395,
          "h": 62,
          "burl": "https://test.com/imp?id=123456",
          "ext": {
            "exchange_deal_type": 0,
            "attribute": [
              21
            ],
            "event_notification_token": {
              "payload": "token"
            },
            "billing_id": "40355106859",
            "clickurl": [
              "google.com"
            ]
          }
        }
      ],
      "seat": "7877:1572:891547"
    }
  ],
  "bidid": "A7j5NZRS-vA5H1033-4084-459j7H7Gn614",
  "ext": {
    "processing_time_ms": 54
  }
}

ملاحظة مهمة: يتم تمثيل رسائل Protobuf الموضّحة في النماذج هنا كنص يمكن لشخص عادي قراءته. ومع ذلك، ليست هذه هي الطريقة التي يتم بها إرسال الرسائل عبر السلك. عند استخدام تنسيق OpenRTB Protobuf، سيتم قبول رسائل BidResponse المتسلسلة فقط.

يمكنك إنشاء رسالة BidResponse وتسلسلها باستخدام رمز C++‎ التالي:

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 في قسم إنشاء رسالة BidResponse. ومن بين استخدامات هذه الميزة وضع معلومات إضافية في وسيطات عناوين URL التي يتم جلبها من خوادمك كجزء من عرض الإعلان. يتيح لك ذلك تمرير بيانات عشوائية حول مرّة الظهور إلى خوادمك.

معظم السياسات المتعلقة بمقتطفات HTML التي يتم عرضها في الاستجابات لعروض الأسعار هي نفسها السياسات المتعلقة بإعلانات الجهات الخارجية. لمزيد من المعلومات، يُرجى الاطّلاع على إرشادات برنامج "الشراة المعتمَدون" ومتطلبات عرض إعلانات الجهات الخارجية والإفصاح عن عناوين URL للنقرات في الإعلانات.

استخدام عناوين URL متّسقة للنقرات

يجب أن يكون عنوان URL للنقرة الذي تحدّده في حقل BidResponse.seatbid.bid.ext.clickurl مطابقًا لعنوان URL للصفحة المقصودة المحدّد في تصميم إعلانك. في ما يلي أمثلة على تصميمات الإعلانات بالتنسيقات المتوافقة التي تتوافق مع الحقل clickurl الذي تم ضبطه على https://play.google.com/store/apps/details?id=com.example.myawesomeapp&referrer=utm_source%3Dgoogle_ab%26utm_medium%3Dcpc%26utm_campaign%3Dinstall_campaign_1:

HTML

<div id="my-app-install-ad"
     style="font-family: sans-serif; border: 1px solid #ddd; padding: 10px;
            display: flex; align-items: center; width: 100%; height: 100%;
            box-sizing: border-box; cursor: pointer;"
     onclick="window.open('https://play.google.com/store/apps/details?id=com.example.myawesomeapp&referrer=utm_source%3Dgoogle_ab%26utm_medium%3Dcpc%26utm_campaign%3Dinstall_campaign_1', '_blank')">
  <img src="https://example.com/path/to/app_icon.png" alt="App Icon"
       style="width: 60px; height: 60px; margin-right: 10px;
              border-radius: 8px;">
  <div style="flex-grow: 1;">
    <h4 style="margin: 0 0 5px 0; font-size: 16px; color: #1a73e8;">
      My Awesome App
    </h4>
    <p style="margin: 0 0 10px 0; font-size: 14px; color: #5f6368;">
      The best app for doing awesome things! Download now and get started!
    </p>
    <span style="background-color: #1a73e8; color: white; padding: 8px 12px;
                 text-align: center; text-decoration: none;
                 display: inline-block; border-radius: 4px; font-size: 14px;
                 font-weight: bold;">Install</span>
  </div>
</div>

VAST XML

<VAST version="3.0">
  <Ad id="creative_id_789">
    <InLine>
      <AdSystem>MyBidderSystem</AdSystem>
      <AdTitle>My Awesome App Install Video</AdTitle>
      <Description>Install My Awesome App now!</Description>
      <Error>
        <![CDATA[https://tracking.example.com/vast_error?errorcode=[ERRORCODE]]]>
      </Error>
      <Impression>
        <![CDATA[https://tracking.example.com/vast_impression]]>
      </Impression>
      <Creatives>
        <!-- Main Video Creative -->
        <Creative>
          <Linear>
            <Duration>00:00:15</Duration>
            <TrackingEvents>
              <Tracking event="start">
                <![CDATA[https://tracking.example.com/vast_event?label=start]]>
              </Tracking>
              <Tracking event="firstQuartile">
                <![CDATA[https://tracking.example.com/vast_event?label=firstQuartile]]>
              </Tracking>
              <Tracking event="midpoint">
                <![CDATA[https://tracking.example.com/vast_event?label=midpoint]]>
              </Tracking>
              <Tracking event="thirdQuartile">
                <![CDATA[https://tracking.example.com/vast_event?label=thirdQuartile]]>
              </Tracking>
              <Tracking event="complete">
                <![CDATA[https://tracking.example.com/vast_event?label=complete]]>
              </Tracking>
            </TrackingEvents>
            <VideoClicks>
              <ClickThrough id="gplay-video">
                <![CDATA[https://play.google.com/store/apps/details?id=com.example.myawesomeapp&referrer=utm_source%3Dgoogle_ab%26utm_medium%3Dcpc%26utm_campaign%3Dinstall_campaign_1]]>
              </ClickThrough>
              <ClickTracking id="bidder-tracker-video">
                <![CDATA[https://tracking.example.com/vast_click]]>
              </ClickTracking>
            </VideoClicks>
            <MediaFiles>
              <MediaFile delivery="progressive" type="video/mp4" width="640"
                         height="360" bitrate="800" scalable="true"
                         maintainAspectRatio="true">
                <![CDATA[https://cdn.example.com/myawesomeapp_video.mp4]]>
              </MediaFile>
            </MediaFiles>
          </Linear>
        </Creative>
        <!-- Companion Ad Creative -->
        <Creative>
          <CompanionAds>
            <Companion id="companion1" width="300" height="250"
                       assetWidth="300" assetHeight="250">
              <StaticResource creativeType="image/png">
                <![CDATA[https://cdn.example.com/companion_banner_300x250.png]]>
              </StaticResource>
              <TrackingEvents>
                <Tracking event="creativeView">
                  <![CDATA[https://tracking.example.com/vast_companion_view]]>
                </Tracking>
              </TrackingEvents>
              <CompanionClickThrough>
                <![CDATA[https://play.google.com/store/apps/details?id=com.example.myawesomeapp&referrer=utm_source%3Dgoogle_ab%26utm_medium%3Dcpc%26utm_campaign%3Dinstall_campaign_1]]>
              </CompanionClickThrough>
              <CompanionClickTracking>
                <![CDATA[https://tracking.example.com/vast_companion_click]]>
              </CompanionClickTracking>
            </Companion>
          </CompanionAds>
        </Creative>
      </Creatives>
    </InLine>
  </Ad>
</VAST>

مدمج مع المحتوى

{
  "ver": "1.2",
  "assets": [
    {
      "id": 1,
      "title": {
        "text": "My Awesome App"
      }
    },
    {
      "id": 2,
      "img": {
        "url": "https://example.com/path/to/app_icon.png",
        "w": 60,
        "h": 60
      }
    },
    {
      "id": 3,
      "data": {
        "value":
          "The best app for doing awesome things! Download now and get started!"
      }
    },
    {
      "id": 4,
      "data": {
        "value": "Install"
      }
    }
  ],
  "link": {
    "url": "https://play.google.com/store/apps/details?id=com.example.myawesomeapp&referrer=utm_source%3Dgoogle_ab%26utm_medium%3Dcpc%26utm_campaign%3Dinstall_campaign_1",
    "clicktrackers": [
      "https://tracking.example.com/native_click"
    ]
  },
  "imptrackers": [
    "https://tracking.example.com/native_impression"
  ]
}

تحديد وحدات الماكرو

وحدات الماكرو هي نص منسَّق مضمَّن في بعض حقول الاستجابة لعرض السعر التي تحتوي على عناوين URL يتم استبدالها بقيمة ذات صلة في وقت عرض الإعلان. على سبيل المثال، إذا كان عرض السعر الفائز يتضمّن وحدة الماكرو AUCTION_PRICE في مقتطف HTML الخاص بتصميم الإعلان المضمّن في عرض السعر، سيتم استبدال وحدة الماكرو بقيمة يمكنك فك تشفيرها لتحديد المبلغ الذي دفعته مقابل ظهور الإعلان في المزاد.

يمكنك تضمين وحدات ماكرو في الحقول التالية:

BidResponse.seatbid.bid.adm

تتوفّر وحدات الماكرو لمقتطفات HTML وتنسيقات XML الأصلية وعناوين URL للفيديو وتنسيقات XML لعلامات VAST للفيديو.
BidResponse.seatbid.bid.adm_native.eventtrackers.url
BidResponse.seatbid.bid.adm_native.imptrackers
BidResponse.seatbid.bid.ext.amp_ad_url

لا تتوافق تصاميم إعلانات AMP إلا مع وحدتَي الماكرو WINNING_PRICE وWINNING_PRICE_ESC الخاصتَين بـ Google.
BidResponse.seatbid.bid.burl
BidResponse.seatbid.bid.ext.impression_tracking_url

يمكنك استخدام هذه السمة بدلاً من BidResponse.seatbid.bid.burl إذا كنت بحاجة إلى أكثر من عنوان URL واحد للفوترة.

على سبيل المثال، يمكنك تضمين ماكرو كجزء من مقتطف HTML من خلال تضمين ${MACRO} ضمن عنوان URL المستخدَم لجلب تصميم الإعلان، حيث يكون MACRO أحد وحدات الماكرو المتوافقة الموضّحة في مواصفات OpenRTB.

وحدات ماكرو Google

تتيح Google وحدات ماكرو إضافية إلى جانب تلك المتوفّرة في مواصفات OpenRTB. وتكون هذه الوحدات منسَّقة بشكل مختلف، وستظهر على النحو التالي: %%MACRO%% إذا كانت مضمَّنة في عنوان URL. يوضّح الجدول التالي وحدات الماكرو هذه:

ماكرو	الوصف
`ADVERTISING_IDENTIFIER`	يسمح هذا الإعداد للمشترين بتلقّي معرّف المعلِنين (IDFA) على iOS أو المعرّف الإعلاني على Android عند عرض الإعلان. لمزيد من التفاصيل، يُرجى الاطّلاع على مقالة فك تشفير معرّفات المعلِنين.
`CACHEBUSTER`	تمثيل سلسلة لعدد صحيح عشوائي غير موقَّع يتألف من أربعة بايت.
`CLICK_URL_UNESC`	عنوان URL للنقرة غير المهرَّب للإعلان في المقتطف، يجب أن تتبع نسخة من عنوان URL للنقرة التابع لجهة خارجية مباشرةً وحدة الماكرو. على سبيل المثال، إذا كان عنوان 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`	عنوان URL للنقرة الذي تم إلغاء ترميزه للإعلان استخدِم هذه السمة بدلاً من `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 مزدوج الإلغاء بعد `%%CLICK_URL_ESC%%`. بعد أن يزيل `my.adserver.com` الترميز، يتبقى إصدار من عنوان URL تم ترميزه مرة واحدة، ويتم إلحاقه بـ `google_click_url`. وعند جلب `google_click_url`، سيتم إلغاء ترميزه مرة أخرى ثم إعادة التوجيه.
`CLICK_URL_ESC_ESC`	عنوان URL الذي تم تخطّيه مرّتين للإعلان استخدِم هذه السمة بدلاً من `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`	يتم توسيعها إلى `http:` إذا كان طلب عرض السعر لا يتطلب طبقة المقابس الآمنة (SSL) أو إلى `https:` إذا كان طلب عرض السعر يتطلب طبقة المقابس الآمنة (SSL).
`SITE`	النطاق الذي تم إلغاء ترميز عنوان URL له والخاص بعنوان URL للمحتوى أو المعرّف المجهول للمساحة الإعلانية المجهولة
`SITE_URL`	تمّ الإيقاف. تم استبدالها بوحدة ماكرو SITE التي توفّر وظائف مماثلة.
`TZ_OFFSET`	فرق التوقيت في المنطقة الزمنية
`VERIFICATION`	القيم المختلفة للإنتاج ووقت فحص تصميم الإعلان في مسار التحقّق التنسيق هو: `%%?VERIFICATION:true-val:false-val%%` حيث يمكن استخدام أي قيم باستثناء وحدات الماكرو لكل من `true-val` و`false-val`، بما في ذلك السلاسل الفارغة. بالنسبة إلى "عرض الأسعار المفتوح"، ننصح بأن تستخدم منصات التبادل الإعلاني هذا الماكرو، وبعد ذلك، لن تحتاج منصات إدارة الطلب إلى إجراء أي تغييرات. على سبيل المثال، إذا كان تصميم الإعلان يتضمّن `%%?VERIFICATION:-1:5000%%`، سيكون النص البديل هو `5000` عند العرض و`-1` في مسار التحقّق. يساعد ذلك في التمييز بين هاتين المجموعتين من إشعارات الاتصال.
`WINNING_PRICE`	تكلفة الظهور المشفّرة (أي التكلفة لكل تثبيت بدلاً من التكلفة لكل ألف ظهور) بالمايكرو من عملة الحساب على سبيل المثال، إذا كانت التكلفة لكل ألف ظهور الفائزة هي 5 دولار أمريكي، ستكون التكلفة لكل ألف ظهور بالوحدات الصغيرة هي 5,000,000، أو التكلفة لكل تثبيت بالوحدات الصغيرة هي 5,000. وستكون القيمة التي تم فك ترميزها لسمة `WINNING_PRICE` في هذه الحالة 5,000. يتم تحديد السعر الفائز في التكلفة لكل تثبيت. لتحليل هذا الماكرو، عليك تنفيذ تطبيق يفك تشفير تأكيدات الأسعار. لمزيد من المعلومات، يُرجى الاطّلاع على صفحة فك تشفير تأكيدات الأسعار.
`WINNING_PRICE_ESC`	‫`WINNING_PRICE` معرَّف باستخدام ترميز URL

تتطلّب Google استخدام وحدة الماكرو CLICK_URL_UNESC أو CLICK_URL_ESC ضمن تصميم الإعلان الذي يتم عرضه من خلال جهة خارجية. تستخدم Google وحدات ماكرو CLICK_URL لتتبُّع النقرات.

يستخدم إلغاء عنوان URL في وحدات الماكرو المخطط التالي:

يتم استبدال حرف المسافة بعلامة زائد (+).
تبقى الأحرف الأبجدية الرقمية (0-9 وa-z وA-Z) والأحرف من المجموعة !()*,-./:_~ بدون تغيير.
يتم استبدال جميع الأحرف الأخرى بـ %XX، حيث يمثّل XX الرقم الست عشري الذي يمثّل الحرف.

القيود والمتطلبات الخاصة بالناشرين

يتضمّن طلب عرض السعر معلومات عن أنواع القيود والمتطلبات التي يفرضها الناشرون على تصاميم الإعلانات في المزاد.

BidRequest.bcat
- يمكنك مقارنة الفئات المحظورة المحدّدة في هذا الحقل بتلك التي تم رصدها لتصاميم الإعلانات التي أرسلتها باستخدام حقل detectedCategories في Real-time Bidding API.
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. لمزيد من التفاصيل، يُرجى الاطّلاع على التعليقات الخاصة بهذه الحقول في تعريف Protocol Buffers لبروتوكول BidRequest.

إذا تم عرض إعلان في BidResponse، عليك ضبط حقول BidResponse.seatbid.bid.attr وBidResponse.seatbid.bid.cat وBidResponse.seatbid.bid.adomain أو BidResponse.seatbid.bid.adm_native.link.url بدقة في BidResponse. إذا كان الإعلان يحتوي على قيم متعددة سارية لهذه الحقول، يجب تضمين كل قيمة. يمكنك الاطّلاع على التعليقات الخاصة بهذه الحقول في تعريف Protocol Buffers BidResponse لمزيد من التفاصيل. ويتم تجاهل الردود التي لم يتم ضبط هذه الحقول فيها.

القياس المفتوح

يتيح لك "القياس المفتوح" تحديد مقدّمي الخدمات الخارجيين الذين يقدّمون خدمات قياس وتحقّق مستقلة للإعلانات التي يتم عرضها في بيئات التطبيقات المتوافقة مع الأجهزة الجوّالة.

وتشمل أشكال الإعلانات المتوافقة إعلانات الفيديو وإعلانات البانر والإعلانات البينية. لمزيد من المعلومات حول كيفية استخدام Open Measurement في استجابة لعرض سعر تحتوي على هذه الأشكال، يُرجى الرجوع إلى مقالة "مركز المساعدة" حول حزمة تطوير البرامج (SDK) لخدمة Open Measurement.

نماذج الاستجابات لعروض الأسعار

تعرض الأقسام التالية نماذج لاستجابات عروض الأسعار لأنواع الإعلانات المختلفة.

OpenRTB Protobuf

عرض المثال

Serialized response

id: "1i4fAl37oW6u51H59WmQdF"
seatbid {
  bid {
    id: "F5660t9N52c4972XV8n"
    impid: "1"
    price: 0.037953998893499374
    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_257354"
    w: 390
    h: 60
    burl: "https://test.com/imp?id=123456"
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      billing_id: 61131625086
      app_promotion_type: INSTALLS
    }
  }
  seat: "7091:5573:967460"
}
cur: "USD"
[com.google.doubleclick.bid_response] {
  processing_time_ms: 35
}

OpenRTB JSON

عرض المثال

{
  "id": "1i4fAl37oW6u51H59WmQdF",
  "seatbid": [
    {
      "bid": [
        {
          "id": "F5660t9N52c4972XV8n",
          "impid": "1",
          "price": 0.037953998893499374,
          "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_257354",
          "w": 390,
          "h": 60,
          "burl": "https://test.com/imp?id=123456",
          "ext": {
            "impression_tracking_url": [
              "https://test.com/impression?id=123456"
            ],
            "billing_id": "61131625086",
            "app_promotion_type": 1
          }
        }
      ],
      "seat": "7091:5573:967460"
    }
  ],
  "cur": "USD",
  "ext": {
    "processing_time_ms": 35
  }
}

إعلان بيني داخل التطبيق

OpenRTB Protobuf

عرض المثال

Serialized response

id: "dg1TCUK23g082jPm629jR4"
seatbid {
  bid {
    id: "20zw8j0dszO6vCpE92e"
    impid: "1"
    price: 0.058042
    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_372958"
    w: 375
    h: 667
    cattax: GOOGLE_CATEGORIES
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      attribute: 47
      attribute: 50
      billing_id: 20458168637
      skadn {
        version: "4.0"
        network: "jLL135hf"
        itunesitem: "139608598"
        sourceapp: "1457468797"
        fidelities {
          fidelity: STOREKIT_RENDERED_ADS
          nonce: "7a865cdd-b631-4922-bc32-602bb21f6174"
          timestamp: "1779161129271"
          signature: "X0EjfovnY011fF0EV07i2ZonI3vLDkY0t19jN6812iz434D2fh4296m8AB637t1W1K61Uo933l1o6l76Wua644r3034c5284"
        }
        fidelities {
          fidelity: VIEW_THROUGH_ADS
          nonce: "c5dc78b7-e4ad-45c2-96da-f8f5d77c4488"
          timestamp: "1779161129271"
          signature: "RN05E0A663CzUNgI33EK9O1CG19473uvp1b8Lh740keuvhb2vj01e4F7x60L2br3C1rtFczp75E7718O7974i98800o8in61"
        }
        sourceidentifier: "5945"
      }
      app_promotion_type: INSTALLS
      clickurl: "google.com"
    }
  }
}
[com.google.doubleclick.bid_response] {
  processing_time_ms: 26
}

OpenRTB JSON

عرض المثال

{
  "id": "dg1TCUK23g082jPm629jR4",
  "seatbid": [
    {
      "bid": [
        {
          "id": "20zw8j0dszO6vCpE92e",
          "impid": "1",
          "price": 0.058042,
          "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_372958",
          "w": 375,
          "h": 667,
          "cattax": 500,
          "ext": {
            "impression_tracking_url": [
              "https://test.com/impression?id=123456"
            ],
            "attribute": [
              47,
              50
            ],
            "billing_id": "20458168637",
            "skadn": {
              "version": "4.0",
              "network": "jLL135hf",
              "itunesitem": "139608598",
              "sourceapp": "1457468797",
              "fidelities": [
                {
                  "fidelity": 1,
                  "nonce": "7a865cdd-b631-4922-bc32-602bb21f6174",
                  "timestamp": "1779161129271",
                  "signature": "X0EjfovnY011fF0EV07i2ZonI3vLDkY0t19jN6812iz434D2fh4296m8AB637t1W1K61Uo933l1o6l76Wua644r3034c5284"
                },
                {
                  "fidelity": 0,
                  "nonce": "c5dc78b7-e4ad-45c2-96da-f8f5d77c4488",
                  "timestamp": "1779161129271",
                  "signature": "RN05E0A663CzUNgI33EK9O1CG19473uvp1b8Lh740keuvhb2vj01e4F7x60L2br3C1rtFczp75E7718O7974i98800o8in61"
                }
              ],
              "sourceidentifier": "5945"
            },
            "app_promotion_type": 1,
            "clickurl": [
              "google.com"
            ]
          }
        }
      ]
    }
  ],
  "ext": {
    "processing_time_ms": 26
  }
}

فيديو إعلان بيني داخل التطبيق

OpenRTB Protobuf

عرض المثال

Serialized response

id: "c5O4y6lyCLLKU23XV8b5e5"
seatbid {
  bid {
    id: "5d38D03G3z7ma294161"
    impid: "1"
    price: 1.131101
    adm: "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%"
    adomain: "google.com"
    crid: "test_creative_id_269770"
    dealid: "93662870"
    cat: "7"
    w: 320
    h: 480
    cattax: GOOGLE_CATEGORIES
    [com.google.doubleclick.bid] {
      attribute: 47
      attribute: 50
      billing_id: 35842063629
      skadn {
        version: "4.0"
        network: "4YP85S89"
        itunesitem: "621364301"
        sourceapp: "1607122287"
        fidelities {
          fidelity: VIEW_THROUGH_ADS
          nonce: "0d713fa7-5aa7-466b-a1f5-2384fc67edf9"
          timestamp: "1779187565467"
          signature: "Acbp89t4i6Bi4t338T1Xe1OmSL00X40qR90Y8c13ffxhH981p746qZl4794e480y73FBAajr4G6bvn6Uo1Q6H5y29g10f7V2"
        }
        fidelities {
          fidelity: STOREKIT_RENDERED_ADS
          nonce: "5163dcc6-c6dd-4081-bfc6-31d0eb14c27b"
          timestamp: "1779187565467"
          signature: "391M4720wn4SQ33SN3Z0TSy965Q4Bz00ISq4KL5319xB958hqi1E43UWvn9n1V8d6305XJLBnF0pMwB0Jq897d2i4rZ544lb"
        }
        sourceidentifier: "1698"
        productpageid: "d7b7360d-19e1-4454-8adf-c9208beb653b"
      }
      app_promotion_type: INSTALLS
      clickurl: "google.com"
    }
  }
}
[com.google.doubleclick.bid_response] {
  processing_time_ms: 16
}

OpenRTB JSON

عرض المثال

{
  "id": "c5O4y6lyCLLKU23XV8b5e5",
  "seatbid": [
    {
      "bid": [
        {
          "id": "5d38D03G3z7ma294161",
          "impid": "1",
          "price": 1.131101,
          "adm": "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%",
          "adomain": [
            "google.com"
          ],
          "crid": "test_creative_id_269770",
          "dealid": "93662870",
          "cat": [
            "7"
          ],
          "w": 320,
          "h": 480,
          "cattax": 500,
          "ext": {
            "attribute": [
              47,
              50
            ],
            "billing_id": "35842063629",
            "skadn": {
              "version": "4.0",
              "network": "4YP85S89",
              "itunesitem": "621364301",
              "sourceapp": "1607122287",
              "fidelities": [
                {
                  "fidelity": 0,
                  "nonce": "0d713fa7-5aa7-466b-a1f5-2384fc67edf9",
                  "timestamp": "1779187565467",
                  "signature": "Acbp89t4i6Bi4t338T1Xe1OmSL00X40qR90Y8c13ffxhH981p746qZl4794e480y73FBAajr4G6bvn6Uo1Q6H5y29g10f7V2"
                },
                {
                  "fidelity": 1,
                  "nonce": "5163dcc6-c6dd-4081-bfc6-31d0eb14c27b",
                  "timestamp": "1779187565467",
                  "signature": "391M4720wn4SQ33SN3Z0TSy965Q4Bz00ISq4KL5319xB958hqi1E43UWvn9n1V8d6305XJLBnF0pMwB0Jq897d2i4rZ544lb"
                }
              ],
              "sourceidentifier": "1698",
              "productpageid": "d7b7360d-19e1-4454-8adf-c9208beb653b"
            },
            "app_promotion_type": 1,
            "clickurl": [
              "google.com"
            ]
          }
        }
      ]
    }
  ],
  "ext": {
    "processing_time_ms": 16
  }
}

إعلان مدمج مع المحتوى في التطبيق

OpenRTB Protobuf

عرض المثال

Serialized response

id: "2Xyp32pgy9ICf67e281xna"
seatbid {
  bid {
    id: "AD4H6GV27kR26b38yWm"
    impid: "1"
    price: 1.3779237270355225
    crid: "test_creative_id_533657"
    dealid: "0"
    adm_native {
      ver: "1.2"
      assets {
        id: 2
        img {
          url: "https://native.test.com/icon?id=123456"
          w: 1200
          h: 1200
          type: ICON
        }
      }
      assets {
        id: 1
        title {
          text: "Luxury Mars Cruises"
        }
      }
      link {
        url: "https://www.google.com"
        clicktrackers: "https://native.test.com/click?id=123456"
      }
    }
    [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: 92863611773
      dsa {
        adrender: true
      }
      clickurl: "google.com"
    }
  }
}
cur: "JPY"
[com.google.doubleclick.bid_response] {
  processing_time_ms: 13
}

OpenRTB JSON

عرض المثال

{
  "id": "2Xyp32pgy9ICf67e281xna",
  "seatbid": [
    {
      "bid": [
        {
          "id": "AD4H6GV27kR26b38yWm",
          "impid": "1",
          "price": 1.3779237270355225,
          "crid": "test_creative_id_533657",
          "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": "92863611773",
            "dsa": {
              "adrender": 1
            },
            "clickurl": [
              "google.com"
            ]
          },
          "adm": "{\"ver\":\"1.2\",\"assets\":[{\"id\":2,\"img\":{\"url\":\"https://native.test.com/icon?id=123456\",\"w\":1200,\"h\":1200,\"type\":1}},{\"id\":1,\"title\":{\"text\":\"Luxury Mars Cruises\"}}],\"link\":{\"url\":\"https://www.google.com\",\"clicktrackers\":[\"https://native.test.com/click?id=123456\"]}}"
        }
      ]
    }
  ],
  "cur": "JPY",
  "ext": {
    "processing_time_ms": 13
  }
}

فيديو ويب

OpenRTB Protobuf

عرض المثال

Serialized response

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 Protobuf

عرض المثال

Serialized response

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 Protobuf

عرض المثال

OpenRTB JSON

عرض المثال

تحديد تصميم الإعلان

استخدام عناوين URL متّسقة للنقرات

HTML

VAST XML

مدمج مع المحتوى

تحديد وحدات الماكرو

وحدات ماكرو Google

القيود والمتطلبات الخاصة بالناشرين

القياس المفتوح

نماذج الاستجابات لعروض الأسعار

بانر التطبيق

OpenRTB Protobuf

عرض المثال

OpenRTB JSON

عرض المثال

إعلان بيني داخل التطبيق

OpenRTB Protobuf

عرض المثال

OpenRTB JSON

عرض المثال

فيديو إعلان بيني داخل التطبيق

OpenRTB Protobuf

عرض المثال

OpenRTB JSON

عرض المثال

إعلان مدمج مع المحتوى في التطبيق

OpenRTB Protobuf

عرض المثال

OpenRTB JSON

عرض المثال

فيديو ويب

OpenRTB Protobuf

عرض المثال

OpenRTB JSON

عرض المثال

إعلان بانر على الويب للأجهزة الجوّالة لمقدّم عرض سعر في Ad Exchange

OpenRTB Protobuf

عرض المثال

OpenRTB JSON

عرض المثال

بناء الرد