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

אפשר להשתמש בבקשה להצעת מחיר כדי למצוא את מזהה ה-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 של בידינג בזמן אמת כדי לבדוק את הסטטוס של קריאייטיב אחרי שהבדיקה מתחילה.

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