דף זה תורגם על ידי Cloud Translation API.

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

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

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

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

דרישות

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

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

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

בקשה להצעת מחיר

בקשות להצעות מחיר למלאי של אפליקציות לנייד כוללות פרטים על ערכות ה-SDK והמתאמים באפליקציה של בעל האפליקציה, שבהם אפשר להשתמש לעיבוד בשדות הבאים:

מזהה SDK

תוכלו להשתמש בבקשת הצעת המחיר כדי למצוא את id שעליכם לציין בתגובה להצעת מחיר של מודעה שמעובדת באמצעות SDK של קונה.

עליכם לעיין בשדות הבאים:

Authorized Buyers: BidRequest.mobile.installed_sdk
OpenRTB: BidRequest.app.ext.installed_sdk

למידע נוסף על ההודעה InstalledSdk, אפשר לקרוא את המדריכים בנושא הפרוטוקולים Google ו-OpenRTB.

מיפוי יחידות של מודעות

אפשר להשתמש בבקשה להצעת מחיר כדי לקרוא מיפויים של יחידות מודעות שתואמים למיקום הצעת המחיר.

עליכם לעיין בשדות הבאים:

Authorized Buyers: BidRequest.AdSlot.ad_unit_mapping
OpenRTB: BidRequest.imp.ext.ad_unit_mapping

מידע נוסף על האובייקט AdUnitMapping זמין במדריכי הפרוטוקולים Google ו-OpenRTB.

אותות מאובטחים

עליכם לקרוא את האובייקט Extended Id שהוא התוסף הרגיל שמשמש להעברת אותות מאובטחים שנבחרו על ידי בעל התוכן הדיגיטלי.

עליכם לעיין בשדות הבאים:

Authorized Buyers: BidRequest.AdSlot.SecureSignal.data
OpenRTB: BidRequest.user.ext.eids.uids.id

מידע נוסף על האובייקט Extended Id זמין במדריכי הפרוטוקולים Google ו-OpenRTB.

בקשות בדיקה

אפשר לקרוא את השדה 'בקשה לבדיקה' כדי להבין אם הבקשה להצעת מחיר היא בדיקה.

עליכם לעיין בשדות הבאים:

Authorized Buyers: BidRequest.is_test
OpenRTB: BidRequest.test

מידע נוסף על השדה Test מופיע במדריכי הפרוטוקולים Google ו-OpenRTB.

דוגמה לבקשה להצעת מחיר

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:

Authorized Buyers:
- BidResponse.Ad.click_through_url
- BidResponse.Ad.AdSlot.billing_id
- BidResponse.Ad.buyer_creative_id
- BidResponse.Ad.width
- BidResponse.Ad.height
OpenRTB:
- BidResponse.seatbid.bid.adomain
- BidResponse.seatbid.bid.cid
- BidResponse.seatbid.bid.crid
- BidResponse.seatbid.bid.w
- BidResponse.seatbid.bid.h

למידע נוסף על ההודעה SeatBid, אפשר לקרוא את המדריכים בנושא הפרוטוקולים Google ו-OpenRTB.

התגובה שלך להצעת מחיר חייבת לכלול SdkRenderedAd עם הפרטים הבאים:

מזהה SDK

בשדה id מציינים את המזהה של ה-SDK לעיבוד המודעה.

המזהה מופיע בבקשה להצעת המחיר בשדות הבאים:

Authorized Buyers: BidRequest.mobile.installed_sdk
OpenRTB: BidRequest.app.ext.installed_sdk

למידע נוסף על ההודעה InstalledSdk, אפשר לקרוא את המדריכים בנושא הפרוטוקולים Google ו-OpenRTB.

מודעה מוצהרת

השדה declared_ad מספק קריאייטיב שעומד בדרישות CreativeEnforcementSettings של הבקשה להצעת מחיר ומייצג את נתוני עיבוד המודעה. בפורמטים של מודעות שאינן מותאמות, יש להציג רק אחד מהערכים html_snippet, video_url או video_vast_xml. לפורמט של מודעות מותאמות, יש להציג רק native_response.

Authorized Buyers: BidResponse.ad.sdk_rendered_ad.declared_ad
OpenRTB: BidResponse.seatbid.bid.ext.sdk_rendered_ad.declared_ad

אם לא תמלאו את השדה declared_ad, לא נוכל לבדוק את הקריאייטיב וכל הצעות המחיר עם הקריאייטיב מסוננות מהמכרז.

רינדור נתונים

בשדה rendering_data יש לספק את הנתונים ל-SDK של הקונה שישמשו להצגת המודעה.

Authorized Buyers: BidResponse.ad.sdk_rendered_ad.rendering_data
OpenRTB: 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 כדי לשלוח קריאייטיבים לבדיקה לפני שתכללו אותם בתגובה להצעת מחיר.

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

תגובה להצעת מחיר

אפשר לשלוח קריאייטיבים חדשים ישירות דרך התגובה להצעת המחיר.

עליך להשתמש בשדה declared_ad של האובייקט SdkRenderedAd כדי לשלוח לבדיקה תגובה להצעת מחיר עם קריאייטיב SDK של קונה.

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

לפרטים נוספים, קראו את מדריך הקריאייטיב.

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

דרישות

בקשה להצעת מחיר

דוגמה לבקשה להצעת מחיר

תגובה להצעת מחיר

דוגמה לתשובה להצעת מחיר

כרזה

פרסומת מרווח ביניים

סרטון מתגמל

מותאם

ביקורת קריאייטיב