מודעות מבוססות SDK של קונים משתמשות בנכסי קריאייטיב שעוברים עיבוד על ידי ה-SDK שלכם.
מלאי שטחי פרסום באפליקציות לנייד של בעלי תוכן דיגיטלי שמטמיעים את מתאם הבידינג שלכם באפליקציה יכול לקבל הצעות מחיר בפורמט המודעה שעובד על ידי ה-SDK של הקונה. אופן העיבוד שלהם מבוסס על הטמעת ה-SDK ועל SDKRenderedAd שאתם שולחים בתגובה לבקשה להצעת מחיר.
אפשר להגיש הצעת מחיר שכוללת מודעה שעברה עיבוד באמצעות SDK של קונה או כל פורמט מודעה אחר שנתמך על ידי Google Mobile Ads SDK, אבל כל הצעות המחיר שמכילות את שניהם מסוננות.
דרישות
מודעות שנוצרו באמצעות SDK לקונים זמינות לקונים מאושרים. הפורמט הזה דורש מאמץ נוסף מצדכם ומצד בעל התוכן הדיגיטלי. כדי להגדיר את החשבון שלכם להצגת מודעות באמצעות ה-SDK לקונים, אתם צריכים לפנות למנהל הטכני של החשבון שלכם. לאחר מכן תוכלו להטמיע מתאם בידינג שיאפשר ל-SDK שלכם לתקשר עם Google Mobile Ads SDK. בעל התוכן הדיגיטלי צריך לשלב את ה-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.adomainBidResponse.seatbid.bid.ext.billing_idBidResponse.seatbid.bid.cridBidResponse.seatbid.bid.wBidResponse.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 הקונה ישתמש בהם לעיבוד המודעה.בהצעות מחיר להצגת מודעה של קונה שמשתמש ב-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>", } }
מומלץ להשתמש ב-API לבידינג בזמן אמת כדי לשלוח קריאייטיבים לבדיקה לפני שכוללים אותם בתגובה לבקשה להצעת מחיר.
לפרטים נוספים על השדות SdkRenderedAd, אפשר לעיין במדריך בנושא OpenRTB.
דוגמה לתגובה להצעת מחיר
דוגמאות לתגובות להצעות מחיר לכל פורמט של מודעה:
מודעת באנר
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 (מומלץ)
אפשר להשתמש ב-method
buyers.creatives.createשל Real-time Bidding API כדי לשלוח נכסי קריאייטיב לבדיקה.ה-API דורש שליחה אחת בלבד לכל קריאייטיב, ומאפשר לכם לבדוק את סטטוס הבדיקה של הקריאייטיב.
- תגובה לבקשה להצעת מחיר
אפשר לשלוח קריאייטיבים חדשים ישירות בתגובה לבקשה להצעת מחיר.
כדי לשלוח תגובה לבקשה להצעת מחיר עם קריאייטיב של SDK של קונה לבדיקה, צריך להשתמש בשדה
declared_adשל האובייקטSdkRenderedAd.קריאייטיבים שנשלחים בתגובה לבקשה להצעת מחיר נבדקים רק אחרי הרבה הצעות מחיר. כל הצעות המחיר שמוגשות לפני שהבדיקה מסתיימת מסוננות מהמכרז. אפשר להשתמש בממשק של בידינג בזמן אמת או ב-Real-time Bidding API כדי לבדוק את הסטטוס של קריאייטיב אחרי שהבדיקה מתחילה.
פרטים נוספים זמינים במדריך בנושא קריאייטיב.
שילובים אחרים של Google Mobile Ads SDK
למשתתפים בתוכנית הקונים המורשים יש כמה אפשרויות לשילוב ישיר עם Google Mobile Ads SDK, כולל ניהול מלאי שטחי פרסום, מתאמי משתתפי מכרז ואותות מאובטחים. למידע נוסף על נקודות השילוב האלה, או כדי לדון בשילובים אחרים של אותות או עיבוד במכשיר עם Google Mobile Ads SDK כדי לשפר את הרלוונטיות של המודעות או את המדידה, אפשר לפנות למנהל הטכני של החשבון.