פורמט מודעת SDK של הקונה

מודעות שמבוססות על SDK של קונים משתמשות בנכסי קריאייטיב שעברו עיבוד על ידי ה-SDK שלכם.

מלאי שטחי פרסום באפליקציות לנייד של בעלי תוכן דיגיטלי שמטמיעים את מתאם הבידינג שלכם באפליקציה יכול לקבל הצעות מחיר בפורמט המודעה שעובד על ידי ה-SDK של הקונה. אופן העיבוד שלהם מבוסס על הטמעת ה-SDK ועל SDKRenderedAd שאתם שולחים בתגובה להצעת המחיר.

אפשר להגיש הצעת מחיר שכוללת מודעה שעברה עיבוד באמצעות SDK של קונה או כל פורמט מודעה אחר שנתמך על ידי Google Mobile Ads SDK, אבל כל הצעות המחיר שמכילות את שניהם מסוננות.

דרישות

מודעות שנוצרו באמצעות SDK לקונים זמינות לקונים שאושרו. אפשר לשלב ישירות את Authorized Buyers עם Google Mobile Ads SDK, כולל גישור, מתאמי משתתפי מכרז ואותות מאובטחים. בעל התוכן הדיגיטלי צריך לשלב את ה-SDK והמתאם שלכם באפליקציות שלו לנייד.

למידע נוסף על נקודות השילוב האלה, או כדי לדון בשילובים אחרים של אותות או עיבודים במכשיר עם Google Mobile Ads 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 הקונה ישתמש בהם לעיבוד המודעה.

בהצעות מחיר להצגת מודעה של קונה שמשתמש ב-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.

קריאייטיבים שנשלחים בתגובה להצעת מחיר נבדקים רק אחרי הרבה הצעות מחיר. כל הצעות המחיר שמוגשות לפני שהבדיקה מסתיימת מסוננות מהמכרז. אפשר להשתמש בממשק של בידינג בזמן אמת או ב-API של בידינג בזמן אמת כדי לבדוק את הסטטוס של קריאייטיב אחרי שהבדיקה מתחילה.

פרטים נוספים זמינים במדריך בנושא קריאייטיב.