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

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

כדי לזהות הזדמנות לחשיפה של מודעת מעברון בבקשה להצעת מחיר, צריך לוודא שהשדה 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: "D3x8RPLO96R6T137tQ6168"
imp {
  id: "1"
  banner {
    w: 360
    h: 715
    pos: AD_POSITION_FULLSCREEN
    api: MRAID_1
    api: MRAID_2
    format {
      w: 360
      h: 715
    }
    format {
      w: 320
      h: 568
    }
  }
  displaymanager: "GoogleMobileAds-Android"
  displaymanagerver: "22.3.0"
  instl: true
  tagid: "5771994185"
  bidfloor: 2764.414643547123
  bidfloorcur: "JPY"
  secure: true
  exp: 3600
  clickbrowser: true
  metric {
    type: "click_through_rate"
    value: 0.03971313312649727
    vendor: "EXCHANGE"
  }
  metric {
    type: "viewability"
    value: 0.91
    vendor: "EXCHANGE"
  }
  [com.google.doubleclick.imp] {
    billing_id: 68640308112
    billing_id: 56606437068
    publisher_settings_list_id: 1984414516100776281
    publisher_settings_list_id: 5846951473307279661
    allowed_vendor_type: 0
    allowed_vendor_type: 57823
    ampad: AMP_AD_NOT_ALLOWED
    excluded_creatives {
      buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
    }
    excluded_creatives {
      buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
    }
    creative_enforcement_settings {
      policy_enforcement: POLICY_ENFORCEMENT_NETWORK_AND_PLATFORM_POLICY
      publisher_blocks_enforcement: PUBLISHER_BLOCKS_ENFORCEMENT_APPLIES
    }
    auction_environment: SERVER_SIDE_AUCTION
    ae: SERVER_SIDE_AUCTION
    jsver: "test-sdk_123456789"
  }
}
app {
  name: "Test App"
  bundle: "com.google.testapp"
  publisher {
    id: "pub-7405557148270612"
    [com.google.doubleclick.publisher] {
      country: "HK"
    }
  }
  content {
    url: "https://www.google.com"
    userrating: "4.7"
    livestream: false
    language: "en"
  }
  storeurl: "https://www.google.com"
}
device {
  ua: "OMITTED"
  geo {
    lat: 0.0
    lon: 0.0
    country: "GBR"
    region: "GB-ENG"
    zip: "RH20"
    type: IP
    utcoffset: 60
    accuracy: 2312
    [com.google.doubleclick.geo] {
      geo_criteria_id: 9191103
    }
  }
  ipv6: "2a02:c7c:7c25::"
  make: "Huawei"
  model: "LYA-L09"
  os: "android"
  osv: "10"
  connectiontype: WIFI
  devicetype: HIGHEND_PHONE
  ifa: "0f0f33d1-fa18-4a2c-bc47-79ef855b5c16"
  w: 360
  h: 715
  pxratio: 3.0
  sua {
    browsers {
      brand: "Mozilla"
      version: "5"
      version: "0"
    }
    browsers {
      brand: "AppleWebKit"
      version: "537"
      version: "36"
    }
    platform {
      brand: "Android"
      version: "10"
    }
    mobile: true
    model: "LYA-L09"
    source: USER_AGENT_STRING
  }
  [com.google.doubleclick.device] {
    metereddata: false
    chargelevel: 0.93
    charging: false
    diskspace: 2100
    audioout: AUDIO_SILENT
  }
}
user {
  id: "D17oNZQUJqB4Rt4n4Ec61AC9tee"
  consent: "OMITTED"
  [com.google.doubleclick.user] {
    consented_providers_settings {
      consented_providers: 1205
      consented_providers: 415
      additional_consent: "OMITTED"
    }
    consent: "OMITTED"
    session {
      duration: 6
      depth: 12
      requestssinceappopen: 12
      priorclicks: 0
    }
    idage: 44064000
  }
}
at: FIRST_PRICE
tmax: 1500
cur: "EUR"
cur: "JPY"
bcat: "32"
bcat: "33"
regs {
  [com.google.doubleclick.regs] {
    gdpr: true
  }
}
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-a-v251815999.232400000.1"
  }
}
cattax: GOOGLE_CATEGORIES
[com.google.doubleclick.bid_request] {
  google_query_id: "ANy-zc395b-x973i1113tK7P9K633CKoo3Pl45uz8D40mz3v48s9Zp604a8FsGL3893PT15M"
  fcap_scope: FREQUENCY_CAPPING_SCOPE_DEVICE
  privacy_treatments {
    allow_user_data_collection: true
  }
}

‫JSON של OpenRTB

הצגת דוגמה

{
  "id": "D3x8RPLO96R6T137tQ6168",
  "imp": [
    {
      "id": "1",
      "banner": {
        "w": 360,
        "h": 715,
        "pos": 7,
        "api": [
          3,
          5
        ],
        "format": [
          {
            "w": 360,
            "h": 715
          },
          {
            "w": 320,
            "h": 568
          }
        ]
      },
      "displaymanager": "GoogleMobileAds-Android",
      "displaymanagerver": "22.3.0",
      "instl": 1,
      "tagid": "5771994185",
      "bidfloor": 2764.414643547123,
      "bidfloorcur": "JPY",
      "secure": 1,
      "exp": 3600,
      "clickbrowser": 1,
      "metric": [
        {
          "type": "click_through_rate",
          "value": 0.03971313312649727,
          "vendor": "EXCHANGE"
        },
        {
          "type": "viewability",
          "value": 0.91,
          "vendor": "EXCHANGE"
        }
      ],
      "ext": {
        "billing_id": [
          "68640308112",
          "56606437068"
        ],
        "publisher_settings_list_id": [
          "1984414516100776281",
          "5846951473307279661"
        ],
        "allowed_vendor_type": [
          0,
          57823
        ],
        "ampad": 2,
        "excluded_creatives": [
          {
            "buyer_creative_id": "EXCLUDED_BUYER_CREATIVE_ID"
          },
          {
            "buyer_creative_id": "EXCLUDED_BUYER_CREATIVE_ID"
          }
        ],
        "creative_enforcement_settings": {
          "policy_enforcement": 2,
          "publisher_blocks_enforcement": 1
        },
        "auction_environment": 0,
        "ae": 0,
        "jsver": "test-sdk_123456789"
      }
    }
  ],
  "app": {
    "name": "Test App",
    "bundle": "com.google.testapp",
    "publisher": {
      "id": "pub-7405557148270612",
      "ext": {
        "country": "HK"
      }
    },
    "content": {
      "url": "https://www.google.com",
      "userrating": "4.7",
      "livestream": 0,
      "language": "en"
    },
    "storeurl": "https://www.google.com"
  },
  "device": {
    "ua": "OMITTED",
    "geo": {
      "lat": 0.0,
      "lon": 0.0,
      "country": "GBR",
      "region": "GB-ENG",
      "zip": "RH20",
      "type": 2,
      "utcoffset": 60,
      "accuracy": 2312,
      "ext": {
        "geo_criteria_id": 9191103
      }
    },
    "ipv6": "2a02:c7c:7c25::",
    "make": "Huawei",
    "model": "LYA-L09",
    "os": "android",
    "osv": "10",
    "connectiontype": 2,
    "devicetype": 4,
    "ifa": "0f0f33d1-fa18-4a2c-bc47-79ef855b5c16",
    "w": 360,
    "h": 715,
    "pxratio": 3.0,
    "sua": {
      "browsers": [
        {
          "brand": "Mozilla",
          "version": [
            "5",
            "0"
          ]
        },
        {
          "brand": "AppleWebKit",
          "version": [
            "537",
            "36"
          ]
        }
      ],
      "platform": {
        "brand": "Android",
        "version": [
          "10"
        ]
      },
      "mobile": 1,
      "model": "LYA-L09",
      "source": 3
    },
    "ext": {
      "metereddata": 0,
      "chargelevel": 0.93,
      "charging": 0,
      "diskspace": 2100,
      "audioout": 3
    }
  },
  "user": {
    "id": "D17oNZQUJqB4Rt4n4Ec61AC9tee",
    "consent": "OMITTED",
    "ext": {
      "consented_providers_settings": {
        "consented_providers": [
          "1205",
          "415"
        ],
        "additional_consent": "OMITTED"
      },
      "consent": "OMITTED",
      "session": {
        "duration": 6,
        "depth": 12,
        "requestssinceappopen": 12,
        "priorclicks": 0
      },
      "idage": 44064000
    }
  },
  "at": 1,
  "tmax": 1500,
  "cur": [
    "EUR",
    "JPY"
  ],
  "bcat": [
    "32",
    "33"
  ],
  "regs": {
    "ext": {
      "gdpr": 1
    }
  },
  "source": {
    "schain": {
      "complete": 1,
      "nodes": [
        {
          "asi": "testssp.com",
          "sid": "pub-1111111111111111",
          "hp": 1
        }
      ],
      "ver": "1.0"
    },
    "ext": {
      "omidpn": "Google",
      "omidpv": "afma-sdk-a-v251815999.232400000.1"
    }
  },
  "cattax": 500,
  "ext": {
    "google_query_id": "ANy-zc395b-x973i1113tK7P9K633CKoo3Pl45uz8D40mz3v48s9Zp604a8FsGL3893PT15M",
    "fcap_scope": 3,
    "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 זמין במדריך למיפוי.
• שולחים את הקריאייטיב בגודל שבו רוצים להציג אותו, כלומר בגודל נפוץ של קריאייטיבים למודעות מעברון. הקריאייטיב עדיין יכול להופיע בגדלים אחרים.
• כל קריאייטיב ללא גודל נספר רק פעם אחת במכסת הקריאייטיבים, גם אם הוא מוצג בכמה גדלים.