פורמט מודעת 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.

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

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