דף זה תורגם על ידי 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 של קונה.

בודקים את השדות הבאים:

OpenRTB: BidRequest.app.ext.installed_sdk
פרוטוקול RTB של Google (הוצא משימוש): BidRequest.mobile.installed_sdk

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

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

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

בודקים את השדות הבאים:

OpenRTB: BidRequest.imp.ext.ad_unit_mapping
פרוטוקול RTB של Google (הוצא משימוש): BidRequest.AdSlot.ad_unit_mapping

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

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

בעלי תוכן דיגיטלי יכולים לשתף אותות מאובטחים עם מגישי הצעות המחיר. אפשר לקרוא אותן מ: אובייקט BuyerGeneratedRequestData של OpenRTB או מ-Google שהוצא משימוש האובייקט SecureSignal של פרוטוקול RTB.

בודקים את השדות הבאים:

OpenRTB: BidRequest.imp.ext.buyer_generated_request_data.data
פרוטוקול RTB של Google (הוצא משימוש): BidRequest.AdSlot.SecureSignal.data

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

בקשות בדיקה

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

בודקים את השדות הבאים:

OpenRTB: BidRequest.test
פרוטוקול RTB של Google (הוצא משימוש): BidRequest.is_test

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

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

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>"
  ...
}

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

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

OpenRTB:
- BidResponse.seatbid.bid.adomain
- BidResponse.seatbid.bid.ext.billing_id
- BidResponse.seatbid.bid.crid
- BidResponse.seatbid.bid.w
- BidResponse.seatbid.bid.h
פרוטוקול RTB של Google (הוצא משימוש):
- BidResponse.Ad.click_through_url
- BidResponse.Ad.AdSlot.billing_id
- BidResponse.Ad.buyer_creative_id
- BidResponse.Ad.width
- BidResponse.Ad.height

בנוסף, התגובה להצעת המחיר חייבת לכלול SdkRenderedAd עם הבאים:

מזהה SDK

משתמשים בשדה id כדי לציין את המזהה ל-SDK לצורך עיבוד המודעה.

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

OpenRTB: BidRequest.app.ext.installed_sdk
פרוטוקול RTB של Google (הוצא משימוש): BidRequest.mobile.installed_sdk

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

מודעה מוצהרת

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

OpenRTB: BidResponse.seatbid.bid.ext.sdk_rendered_ad.declared_ad
פרוטוקול RTB של Google (הוצא משימוש): BidResponse.ad.sdk_rendered_ad.declared_ad

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

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

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

OpenRTB: BidResponse.seatbid.bid.ext.sdk_rendered_ad.rendering_data
פרוטוקול RTB של Google (הוצא משימוש): BidResponse.ad.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 כדי לשלוח נכסי קריאייטיב ביקורת לפני שכללתם אותם בתגובה להצעת מחיר.

לצפייה Google ו- מדריכי פרוטוקולים של 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"

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

הקריאייטיבים נבדקים לפני שהם מוצגים, כדי לוודא שהם עומדים בדרישות policies (מדיניות) ובעלי תוכן דיגיטלי הגדרות.

הנה שתי דרכים לשליחת נכסי קריאייטיב לבדיקה:

Real-time Bidding API (מומלץ)

אפשר להשתמש buyers.creatives.create של ה-Real-time Bidding API שליחת נכסי קריאייטיב לבדיקה.

ה-API מחייב שליחה אחת בלבד לכל קריאייטיב ומאפשר לכם לבדוק סטטוס הבדיקה של הקריאייטיב שלך.

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

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

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

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

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

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

דרישות

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

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

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

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

כרזה

מעברון

סרטון מתגמל

מותאם

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