شكل الإعلان في حزمة تطوير البرامج (SDK) للمشتري

تستخدِم إعلانات حِزم تطوير البرامج (SDK) للمشترين تصميمات إعلانات تعرِضها حزمة SDK الخاصة بك.

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

يمكنك تقديم عرض سعر يتضمّن إعلانًا معروضًا من خلال حزمة تطوير برامج (SDK) للمشتري أو أي تنسيق إعلان آخر متوافق مع حزمة SDK لإعلانات Google على الأجهزة الجوّالة، ولكن يتمّ فلترة أي عروض أسعار تتضمّن كليهما.

المتطلبات

تتوفّر إعلانات حِزم تطوير البرامج (SDK) للمشترين للمشترين الموافَق عليهم. يتطلّب هذا التنسيق جهدًا إضافيًا منك ومن الناشر. تواصَل مع المدير الفني لحسابك لتحديد إعدادات حسابك لعرض إعلانات حِزم تطوير البرامج (SDK) للمشترين. يمكنك بعد ذلك تنفيذ محوِّل عروض الأسعار الذي يتيح لحزمة SDK التحدث مع حزمة "SDK لإعلانات Google على الأجهزة الجوّالة". على الناشر دمج حزمة SDK والمحوّل في تطبيقاته للأجهزة الجوّالة.

ننصحك بإرسال تصميمات الإعلانات لأجل مراجعتها قبل تضمينها في ردّ على عرض سعر. يُرجى التواصل مع المدير الفني للحساب إذا لم تكن تعرف نوع تصميم الإعلان في وقت تقديم عروض الأسعار.

إذا كان طلب عرض السعر يتيح استخدام شكل الإعلان هذا، يمكنك تحديد إعلان يتم عرضه باستخدام حزمة SDK من خلال ضبط الحقل sdk_rendered_ad في استجابة عرض السعر.

طلب عرض السعر

تتضمّن طلبات عروض الأسعار للمستودع الإعلاني على تطبيقات الأجهزة الجوّالة تفاصيل عن حِزم تطوير البرامج (SDK) ومقدّمات برمجية في تطبيق الناشر يمكنك استخدامها للعرض في الحقول التالية:

رقم تعريف حزمة تطوير البرامج (SDK)

يمكنك استخدام طلب عروض الأسعار للعثور على معرّف حزمة SDK الذي يجب تقديمه في استجابة عرض السعر باستخدام الحقل BidRequest.app.ext.installed_sdk.id.

يمكنك الاطّلاع على مزيد من المعلومات حول هذا الموضوع في InstalledSdk المستندات المرجعية.

ربط الوحدات الإعلانية

يمكنك استخدام طلب عروض الأسعار للعثور على تعيينات الوحدات الإعلانية التي تتطابق مع خانة BidRequest.imp.ext.ad_unit_mapping لعرض السعر.

يمكنك الاطّلاع على مزيد من المعلومات حول هذا الموضوع في AdUnitMapping المستندات المرجعية.

الإشارات الآمنة

يمكن للناشرين مشاركة الإشارات الآمنة مع مقدّمي عروض الأسعار. يمكنك العثور على هذه الإعدادات في BidRequest.imp.ext.buyer_generated_request_data.data.

يمكنك الاطّلاع على مزيد من المعلومات حول كيفية تمثيل الإشارات الآمنة في ملف BuyerGeneratedRequestData المرجعي.

طلبات الاختبار

يمكنك استخدام الحقل BidRequest.test للتحقّق مما إذا كان طلب عرض السعر اختبارًا.

يمكنك الاطّلاع على مزيد من المعلومات عن هذا الحقل في BidRequest المستندات المرجعية.

مثال على طلب عرض السعر

id: "<bid_request_id>"
imp {
  id: "1"
  banner {
    w: 320
    h: 50
    ...
  }
...
  adx_ext {
   ...
    ad_unit_mapping {
      keyvals {
        key: "key_1"
        value: "value_1"
      }
      keyvals {
        key: "key_2"
        value: "value_2"
      }
      ...
      format: FORMAT_BANNER
    }
  }
}
app {
 ...
  adx_ext {
    installed_sdk {
      id: "com.google.ads.mediation.partner.PartnerMediationAdapter"
      sdk_version {
        major: 1
        minor: 2
        micro: 30
      }
      adapter_version {
        major: 1
        minor: 2
        micro: 3000
      }
    }
    installed_sdk {
    ...
    }
    ...
  }
}
device {
  ...
}
user {
  ...
  }
  adx_ext {
    eids {
      source: "com.google.ads.mediation.partner.PartnerMediationAdapter"
      uids {
        id: "<partner_signal_string>"
      }
    }
  }
}
at: 1
tmax: 1000
cur: "USD"
test: 1
...
adx_ext {
  google_query_id: "<query_string>"
  ...
}

الاستجابة لعرض السعر

يجب إدخال الحقول التالية في استجابة عروض الأسعار:

  • BidResponse.seatbid.bid.adomain
  • BidResponse.seatbid.bid.ext.billing_id
  • BidResponse.seatbid.bid.crid
  • BidResponse.seatbid.bid.w
  • BidResponse.seatbid.bid.h

بالإضافة إلى ذلك، يجب أن تملأ استجابة عروض الأسعار BidResponse.seatbid.bid.ext.sdk_rendered_ad بالقيم التالية:

رقم تعريف حزمة تطوير البرامج (SDK)

استخدِم الحقل id لتقديم معرّف حزمة تطوير البرامج (SDK) لعرض الإعلان.

يمكنك العثور على المعرّف في BidRequest.app.ext.installed_sdk.

الإعلان الذي تم الإفصاح عنه

استخدِم BidResponse.seatbid.bid.ext.sdk_rendered_ad.declared_ad لتقديم ملف إبداعي يستوفي المتطلبات الواردة في BidRequest.imp.ext.creative_enforcement_settings ويمثّل بيانات عرض الإعلان. يجب تعبئة قيمة واحدة فقط من html_snippet أو video_url أو video_vast_xml أو native_response.

في حال عدم تعبئة declared_ad، لن نتمكّن من مراجعة تصميم الإعلان، و ستتم إزالة جميع عروض الأسعار التي تتضمّن تصميم الإعلان من المزاد.

يمكنك الاطّلاع على مزيد من المعلومات عن الإعلان الذي تمّ الإبلاغ عنه في DeclaredAd المستندات المرجعية.

عرض البيانات

استخدِم الحقل BidResponse.seatbid.bid.ext.sdk_rendered_ad.rendering_data ل تقديم البيانات لحزمة تطوير البرامج (SDK) الخاصة بالمشتري لاستخدامها في عرض إعلانك.

يجب أن تحدّد عروض الأسعار لعرض إعلان حزمة تطوير برامج للمشتري تصميم إعلان في الحقل declared_ad. يجب أن يمثّل الإعلان الذي تم الإبلاغ عنه rendering_data بدقة.

في ما يلي نموذج لعنصر SdkRenderedAd:

{
  "id": "1234567",
  "rendering_data": "\xd58...,\xd4\x89\xd\xf9",
  "declared_ad": {
    "html_snippet": "<iframe src=\"https://example.com/ads?id=123&
      curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>",
  }
}

ننصحك باستخدام واجهة برمجة التطبيقات Real-time Bidding API من أجل إرسال تصميمات الإعلانات بهدف مراجعتها قبل تضمينها في ردّ عرض سعر.

اطّلِع على دليل OpenRTB للحصول على مزيد من التفاصيل حول حقول SdkRenderedAd.

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

في ما يلي نماذج من ردود عروض الأسعار لكل شكل إعلان:

id: "<bid_request_id>"
seatbid {
  bid {
    id: "<bidder_generated_response_id>"
    impid: "1"
    price: 99
    adomain: "https://play.google.com/store/apps/details?id=com.test.app"
    cid: "<billing_id>"
    crid: "<creative_id>"
    w: 320
    h: 50
    burl: "https://abc.com/billing?td=fn&win_price=${AUCTION_PRICE}"
    adx_ext {
      sdk_rendered_ad {
        id: "com.google.ads.mediation.partner.PartnerMediationAdapter"
        rendering_data: "<rendering_data_string>"
        declared_ad {
          click_through_url: "https://play.google.com/store/apps/details?id=com.test.app"
          html_snippet: "<!doctype html> <html> ... </html>"
        }
      }
      event_notification_token {
        payload: "<payload_string>"
      }
      billing_id: 141763360450
    }
  }
}
bidid: "<bidder_generated_response_id>"
cur: "USD"

إعلان بيني

id: "<bid_request_id>"
seatbid {
  bid {
    id: "<bidder_generated_response_id>"
    impid: "1"
    price: 400
    adomain: "https://play.google.com/store/apps/details?id=com.test.app"
    cid: "<billing_id>"
    crid: "<creative_id>"
    w: 412
    h: 775
    adx_ext {
      sdk_rendered_ad {
        id: "com.google.ads.mediation.partner.PartnerMediationAdapter"
        rendering_data: "<rendering_data_string>"
        declared_ad {
          click_through_url: "https://play.google.com/store/apps/details?id=com.test.app"
          video_vast_xml: "<VAST version=\"2.0\"><Ad>...</Ad></VAST>"
        }
      }
      event_notification_token {
        payload: "<payload_string>"
      }
    }
  }
}
bidid: "<bidder_generated_response_id>"
cur: "USD"

فيديو بمكافأة

id: "<bid_request_id>"
seatbid {
  bid {
    id: "<bidder_generated_response_id>"
    impid: "1"
    price: 400
    adomain: "https://play.google.com/store/apps/details?id=com.test.app"
    cid: "<billing_id>"
    crid: "<creative_id>"
    w: 412
    h: 775
    adx_ext {
      sdk_rendered_ad {
        id: "com.google.ads.mediation.partner.PartnerMediationAdapter"
        rendering_data: "<rendering_data_string>"
        declared_ad {
          click_through_url: "https://play.google.com/store/apps/details?id=com.test.app"
          video_vast_xml: "<VAST version=\"2.0\"><Ad>...</Ad></VAST>"
        }
      }
      event_notification_token {
        payload: "<payload_string>"
      }
    }
  }
}
bidid: "<bidder_generated_response_id>"
cur: "USD"

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

id: "<bid_request_id>"
seatbid {
  bid {
    id: "<bidder_generated_response_id>"
    impid: "1"
    price: 400
    adomain: "https://play.google.com/store/apps/details?id=com.test.app"
    cid: "<billing_id>"
    crid: "<creative_id>"
    w: 1200
    h: 627
    adx_ext {
      sdk_rendered_ad {
        id: "com.google.ads.mediation.partner.PartnerMediationAdapter"
        rendering_data: "<rendering_data_string>"
        declared_ad {
          click_through_url: "https://play.google.com/store/apps/details?id=com.test.app"
          native_response {
            ...
            assets {
              id: 1
              title {
                text: ""
              }
            }
            assets {
              id: 2
              data {
                value: "<some_string>"
              }
            }
            assets {
              id: 3
              data {
                value: "View now"
              }
            }
            assets {
              id: 4
              img {
                url: "<valid_image_url>"
                w: 1200
                h: 627
                type: 3
              }
            }
            assets {
              id: 5
              img {
                url: "<valid_image_url>"
                w: 100
                h: 100
                type: 1
              }
            }
            assets {
              id: 6
              data {
                value: ""
              }
            }
            assets {
              id: 7
              data {
                value: "<some_string>"
              }
            }
            link {
              url: "<destination_link>"
            }
          }
        }
      }
      event_notification_token {
        payload: "<payload_string>"
      }
    }
  }
}
bidid: "<bidder_generated_response_id>"
cur: "USD"

مراجعة المواد الإبداعية

تتم مراجعة تصميمات الإعلانات قبل عرضها للتأكّد من توافقها مع سياساتنا وإعدادات الناشر.

في ما يلي طريقتان لإرسال تصميمات الإعلانات للمراجعة:

واجهة برمجة التطبيقات Real-time Bidding API (مُستحسَن)

يمكنك استخدام الإجراء buyers.creatives.create في واجهة برمجة التطبيقات Real-time Bidding API من أجل إرسال مواد إبداعية للمراجعة.

لا تتطلّب واجهة برمجة التطبيقات سوى إرسال طلب واحد لكل تصميم إعلان، وتتيح لك التحقّق من حالة مراجعة تصميم الإعلان.

الاستجابة لعرض السعر

يمكنك إرسال تصميمات إعلانات جديدة مباشرةً في استجابة عرض السعر.

يجب استخدام حقل declared_ad في عنصر SdkRenderedAd لإرسال ردّ عرض سعر يتضمّن تصميم إعلان حزمة تطوير برامج (SDK) للمشتري لمراجعته.

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

اطّلِع على دليل تصميمات الإعلانات للحصول على مزيد من التفاصيل.