מודעות מעברון

מודעת מעברון (או מודעה במסך מלא) היא סוג של מודעה שמכסה את רוב המסך. לכן, התוכן של בעל האפליקציה לא מופיע במסך כשמודעת מעברון מוצגת.

כדי לזהות הזדמנות לחשיפה של מודעת מעברון בבקשה להצעת מחיר, צריך לוודא שהשדה BidRequest.imp.instl בבקשה להצעת מחיר מוגדר לערך true ב-Protobuf או לערך 1 ב-JSON.

גודל של מיקום מודעה בדף

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

הזוג הראשון של רוחב וגובה בשדה BidRequest.imp.banner.format, של OpenRTB מייצג את הגודל בפועל של מיקום מודעה בדף, והזוגות הנותרים מייצגים רשימה של גדלי מודעות מקובלים שנמצאים בטווח הדרישות של מיקום מודעה בדף.

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

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

  • קטן מהרוחב והגובה של מיקום מודעה בדף או שווה להם
  • גדול מ-50% מרוחב מיקום המודעה בדף או שווה לו
  • גדול מ-40% מגובה מיקום המודעה בדף או שווה לו

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

אם לא מציינים את גודל המודעה בתגובה להצעת המחיר, התגובה מסוננת עם סיבת הדחייה MISSING_AD_SIZE.

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

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

OpenRTB Protobuf

הצגת דוגמה

[Serialized request](/authorized-buyers/rtb/data/request-response/openrtb_protobuf_mobile_app_interstitial_ad_request.bin){: .download}
id: "iPwd6qWwe759U5389nKgZ2"
imp {
  id: "1"
  banner {
    w: 390
    h: 764
    pos: AD_POSITION_FULLSCREEN
    api: MRAID_1
    api: MRAID_2
    format {
      w: 390
      h: 764
    }
    format {
      w: 160
      h: 600
    }
  }
  displaymanager: "GoogleMobileAds-iOS"
  displaymanagerver: "12.1.0"
  instl: true
  tagid: "6515547538"
  bidfloor: 0.01
  bidfloorcur: "USD"
  secure: true
  exp: 3600
  clickbrowser: true
  metric {
    type: "click_through_rate"
    value: 0.071259871125221252
    vendor: "EXCHANGE"
  }
  metric {
    type: "viewability"
    value: 0.93
    vendor: "EXCHANGE"
  }
  [com.google.doubleclick.imp] {
    billing_id: 20458168637
    publisher_settings_list_id: 7415902580159294065
    publisher_settings_list_id: 3858265210976003530
    allowed_vendor_type: 0
    allowed_vendor_type: 4513
    ampad: AMP_AD_NOT_ALLOWED
    excluded_creatives {
      buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
    }
    excluded_creatives {
      buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
    }
    skadn {
      sourceapp: "com.google.testapp"
      skadnetids: "jLL135hf"
      versions: "2.0"
      versions: "2.1"
      fidelities: STOREKIT_RENDERED_ADS
      fidelities: VIEW_THROUGH_ADS
    }
    creative_enforcement_settings {
      policy_enforcement: POLICY_ENFORCEMENT_NETWORK_AND_PLATFORM_POLICY
      publisher_blocks_enforcement: PUBLISHER_BLOCKS_ENFORCEMENT_APPLIES
    }
    jsver: "test-sdk_123456789"
    highengagement: true
  }
}
app {
  name: "Test App"
  ver: "18.6.0"
  bundle: "com.google.testapp"
  publisher {
    id: "pub-5899129488172801"
    [com.google.doubleclick.publisher] {
      country: "IL"
    }
  }
  content {
    url: "https://www.google.com"
    language: "en"
  }
  storeurl: "https://www.google.com"
}
device {
  ua: "OMITTED"
  geo {
    lat: 0
    lon: 0
    country: "COL"
    region: "CO-DC"
    city: "Bogota"
    zip: "110851"
    type: IP
    utcoffset: -300
    accuracy: 1236
    [com.google.doubleclick.geo] {
      geo_criteria_id: 9216139
    }
  }
  ipv6: "2800:e2:5780::"
  language: "es"
  make: "Apple"
  model: "iPhone14,7"
  os: "iOS"
  osv: "18.7"
  connectiontype: WIFI
  devicetype: HIGHEND_PHONE
  hwv: "iPhone14,7"
  w: 390
  h: 844
  pxratio: 3
  sua {
    browsers {
      brand: "Mozilla"
      version: "5"
      version: "0"
    }
    browsers {
      brand: "AppleWebKit"
      version: "605"
      version: "1"
    }
    platform {
      brand: "iPhone"
      version: "18"
      version: "7"
    }
    mobile: true
    bitness: "64"
    model: "iPhone"
    source: USER_AGENT_STRING
  }
  [com.google.doubleclick.device] {
    atts: 2
    audioout: AUDIO_SPEAKER
    ifv: "5fcebf5e-462f-47fe-a528-e982d9512348"
  }
}
user {
  [com.google.doubleclick.user] {
    session {
      depth: 0
      requestssinceappopen: 5
      priorclicks: 0
    }
  }
}
at: FIRST_PRICE
tmax: 700
cur: "USD"
bcat: "32"
bcat: "33"
source {
  schain {
    complete: true
    nodes {
      asi: "testssp.com"
      sid: "pub-1111111111111111"
      hp: true
    }
    ver: "1.0"
  }
  [com.google.doubleclick.source] {
    omidpn: "Google"
    omidpv: "afma-sdk-i-v12.1.0"
  }
}
cattax: GOOGLE_CATEGORIES
[com.google.doubleclick.bid_request] {
  google_query_id: "ANy-z7CT2R-7uB8g5aR7v8neLD9N5p9e04ON1C2ob93u7SZlV346yw69237l5d6p2bZ43x62"
  fcap_scope: FREQUENCY_CAPPING_SCOPE_APP
  privacy_treatments {
    allow_user_data_collection: true
  }
}

‫JSON של OpenRTB

הצגת דוגמה

{
  "id": "iPwd6qWwe759U5389nKgZ2",
  "imp": [
    {
      "id": "1",
      "banner": {
        "w": 390,
        "h": 764,
        "pos": 7,
        "api": [
          3,
          5
        ],
        "format": [
          {
            "w": 390,
            "h": 764
          },
          {
            "w": 160,
            "h": 600
          }
        ]
      },
      "displaymanager": "GoogleMobileAds-iOS",
      "displaymanagerver": "12.1.0",
      "instl": 1,
      "tagid": "6515547538",
      "bidfloor": 0.01,
      "bidfloorcur": "USD",
      "secure": 1,
      "exp": 3600,
      "clickbrowser": 1,
      "metric": [
        {
          "type": "click_through_rate",
          "value": 0.07125987112522125,
          "vendor": "EXCHANGE"
        },
        {
          "type": "viewability",
          "value": 0.93,
          "vendor": "EXCHANGE"
        }
      ],
      "ext": {
        "billing_id": [
          "20458168637"
        ],
        "publisher_settings_list_id": [
          "7415902580159294065",
          "3858265210976003530"
        ],
        "allowed_vendor_type": [
          0,
          4513
        ],
        "ampad": 2,
        "excluded_creatives": [
          {
            "buyer_creative_id": "EXCLUDED_BUYER_CREATIVE_ID"
          },
          {
            "buyer_creative_id": "EXCLUDED_BUYER_CREATIVE_ID"
          }
        ],
        "skadn": {
          "sourceapp": "com.google.testapp",
          "skadnetids": [
            "jLL135hf"
          ],
          "versions": [
            "2.0",
            "2.1"
          ],
          "fidelities": [
            1,
            0
          ]
        },
        "creative_enforcement_settings": {
          "policy_enforcement": 2,
          "publisher_blocks_enforcement": 1
        },
        "jsver": "test-sdk_123456789",
        "highengagement": 1
      }
    }
  ],
  "app": {
    "name": "Test App",
    "ver": "18.6.0",
    "bundle": "com.google.testapp",
    "publisher": {
      "id": "pub-5899129488172801",
      "ext": {
        "country": "IL"
      }
    },
    "content": {
      "url": "https://www.google.com",
      "language": "en"
    },
    "storeurl": "https://www.google.com"
  },
  "device": {
    "ua": "OMITTED",
    "geo": {
      "lat": 0.0,
      "lon": 0.0,
      "country": "COL",
      "region": "CO-DC",
      "city": "Bogota",
      "zip": "110851",
      "type": 2,
      "utcoffset": -300,
      "accuracy": 1236,
      "ext": {
        "geo_criteria_id": 9216139
      }
    },
    "ipv6": "2800:e2:5780::",
    "language": "es",
    "make": "Apple",
    "model": "iPhone14,7",
    "os": "iOS",
    "osv": "18.7",
    "connectiontype": 2,
    "devicetype": 4,
    "hwv": "iPhone14,7",
    "w": 390,
    "h": 844,
    "pxratio": 3.0,
    "sua": {
      "browsers": [
        {
          "brand": "Mozilla",
          "version": [
            "5",
            "0"
          ]
        },
        {
          "brand": "AppleWebKit",
          "version": [
            "605",
            "1"
          ]
        }
      ],
      "platform": {
        "brand": "iPhone",
        "version": [
          "18",
          "7"
        ]
      },
      "mobile": 1,
      "bitness": "64",
      "model": "iPhone",
      "source": 3
    },
    "ext": {
      "atts": 2,
      "audioout": 1,
      "ifv": "5fcebf5e-462f-47fe-a528-e982d9512348"
    }
  },
  "user": {
    "ext": {
      "session": {
        "depth": 0,
        "requestssinceappopen": 5,
        "priorclicks": 0
      }
    }
  },
  "at": 1,
  "tmax": 700,
  "cur": [
    "USD"
  ],
  "bcat": [
    "32",
    "33"
  ],
  "source": {
    "schain": {
      "complete": 1,
      "nodes": [
        {
          "asi": "testssp.com",
          "sid": "pub-1111111111111111",
          "hp": 1
        }
      ],
      "ver": "1.0"
    },
    "ext": {
      "omidpn": "Google",
      "omidpv": "afma-sdk-i-v12.1.0"
    }
  },
  "cattax": 500,
  "ext": {
    "google_query_id": "ANy-z7CT2R-7uB8g5aR7v8neLD9N5p9e04ON1C2ob93u7SZlV346yw69237l5d6p2bZ43x62",
    "fcap_scope": 4,
    "privacy_treatments": {
      "allow_user_data_collection": 1
    }
  }
}

שיטות מומלצות

‫Google ממליצה על השיטות המומלצות הבאות:

  • כדי למרכז את המודעות במיקום מודעה בדף, צריך לכלול מאפייני עיצוב בקטעי הקוד של הקריאייטיב ב-HTML. אחרת, המודעות מוצגות בפינה הימנית העליונה של מיקום מודעה בדף.

  • להגיב עם מודעת מעברון שתופסת כמה שיותר מקום במיקום המודעה בדף. אל תציבו מודעה קטנה בהרבה במיקום מודעה בדף של מודעת מעברון. לדוגמה, מודעה בגודל 320x480 קטנה מדי למשבצת של מודעת מעברון בגודל 420x800.

  • לא להוסיף כפתור סגירה:

    • ה-SDK שלנו מציג באופן אוטומטי כפתור סגירה (במקרים הרלוונטיים) כדי לוודא שהמשתמשים יכולים ללחוץ על הכפתור.
    • אין תמיכה ב-MRAID useCustomClose().
  • כדי לבחור גדלים מקובלים של מודעות לתגובה להצעת המחיר, כדאי להשתמש בגדלים המומלצים מתוך הבקשה להצעת מחיר.

  • משווים בין השדות BidRequest.device.w ו-BidRequest.device.h כדי לבחור קריאייטיבים עם אוריינטציה מתאימה.

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

מודעות מעברון ללא גודל (גמישות)

מודעות אינטרסטיטיאל ללא גודל (שנקראות גם מודעות אינטרסטיטיאל רספונסיביות או גמישות) משנות את הגודל באופן דינמי כדי לתפוס את כל הרוחב והגובה של מיקום המודעה בדף. ‫Authorized Buyers לא משנה את הגודל של נכסי הקריאייטיב בשבילכם. חובה לספק קריאייטיב שגודלו משתנה באופן דינמי.

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

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

  • משתמשים ב-BidResponse.seatbid.bid.ext.attribute כדי להצהיר על Rendering: Sizeless AdX (מאפיין 105) בתגובה לבקשה להצעת מחיר. מאפייני קריאייטיב שאפשר להצהיר עליהם מפורטים בקובץ הנתונים buyer-declarable-creative-attributes.txt.

  • מאכלסים את התגים BidResponse.seatbid.bid.w ו-BidResponse.seatbid.bid.h בגודל שבו רוצים שהקריאייטיב יוצג בהתאם לדרישות הגודל של המודעה. לדוגמה, 360x480 למשבצת מודעה בגודל 360x480. יכול להיות שהקריאייטיב עדיין יוצג בגדלים אחרים. בפרוטוקול RTB של Google שיצא משימוש, צריך למלא את הערכים BidResponse.Ad.width ו-BidResponse.Ad.height.

אם מוסיפים את מאפיין Rendering: Sizeless AdX לקריאייטיב קיים, הקריאייטיב צריך לעבור בדיקה מחדש.

אישור מראש של קריאייטיב

  • כששולחים קריאייטיב לבדיקה, צריך לכלול את מאפיין RENDERING_SIZELESS_ADX בשדה declaredAttributes. ב-API של בידינג בזמן אמת, מאפייני קריאייטיב מיוצגים באמצעות ערך enum מסוג מחרוזת. מידע נוסף על ההתאמה בין הערכים האלה לבין מזהים מספריים מתוך buyer-declarable-creative-attributes.txt זמין במדריך למיפוי.
  • שולחים את הקריאייטיב בגודל שבו רוצים להציג אותו, כלומר בגודל נפוץ של קריאייטיבים למודעות מעברון. הקריאייטיב עדיין יכול להופיע בגדלים אחרים.
  • כל קריאייטיב ללא גודל נספר רק פעם אחת במכסת הקריאייטיבים, גם אם הוא מוצג בכמה גדלים.