Geçiş Reklamları

Geçiş reklamı (veya tam ekran reklam), çoğunlukla ekranı kaplayan bir reklam türüdür. Bu nedenle, geçiş reklamı gösterildiğinde yayıncı içerikleri ekranda görünmez.

Teklif isteğinin BidRequest.imp.instl alanının Protobuf'ta true veya JSON'da 1 olarak ayarlandığını doğrulayarak teklif isteğinde geçiş reklamı fırsatını tanımlayabilirsiniz.

Reklam alanı boyutu

Geçiş reklamları için reklam alanı boyutu, reklam öğelerini oluşturmak için kullanılabilecek alanı belirtir ve belirli biçimler ve ekran boyutları gibi çeşitli faktörlere bağlıdır.

OpenRTB'nin BidRequest.imp.banner.format alanındaki ilk genişlik ve yükseklik çifti, gerçek reklam alanı boyutunu temsil eder. Kalan çiftler ise alanın koşullarına uygun kabul edilebilir reklam boyutlarının listesini temsil eder.

Reklam öğeleri, teklif isteğinde önerilen boyutlarla kısıtlanmaz ancak teklif isteğinde önerilen tüm boyutların kabul edilebilir boyut aralığında olduğu garanti edilir.

Genişliği ve yüksekliği aşağıdaki ölçütleri karşılayan tüm reklam öğeleriyle teklif verebilirsiniz:

  • Reklam alanı genişliği ve yüksekliğinden küçük veya bunlara eşit
  • Reklam alanı genişliğinin% 50'sinden büyük veya bu değere eşit
  • Reklam alanı yüksekliğinin% 40'ından büyük veya ona eşit

Reklam boyutu çok büyük veya çok küçükse teklif yanıtı, INTERSTITIAL_SIZE_MISMATCH ret nedeniyle filtrelenir.

Teklif yanıtında reklam boyutunu belirtmezseniz yanıt, MISSING_AD_SIZE ret nedeniyle filtrelenir.

Örnek teklif istekleri

Aşağıda, geçiş reklamları için bazı örnek teklif istekleri verilmiştir.

OpenRTB Protobuf

Örneği göster

[Serialized request](/authorized-buyers/rtb/data/request-response/openrtb_protobuf_mobile_app_interstitial_ad_request.bin){: .download}
id: "27q8F4ja125b5Ay5Lg5I8Y"
imp {
  id: "1"
  banner {
    w: 368
    h: 740
    pos: AD_POSITION_FULLSCREEN
    api: MRAID_1
    api: MRAID_2
    format {
      w: 368
      h: 740
    }
    format {
      w: 300
      h: 600
    }
  }
  displaymanager: "GoogleMobileAds-Android"
  displaymanagerver: "21.5.0"
  instl: true
  tagid: "7072441745"
  bidfloor: 0.01
  bidfloorcur: "USD"
  secure: true
  exp: 14400
  clickbrowser: true
  metric {
    type: "click_through_rate"
    value: 0.026930272579193115
    vendor: "EXCHANGE"
  }
  metric {
    type: "viewability"
    value: 0.82
    vendor: "EXCHANGE"
  }
  [com.google.doubleclick.imp] {
    billing_id: 14443955188
    publisher_settings_list_id: 7634109184153514733
    publisher_settings_list_id: 4552400977800686866
    allowed_vendor_type: 4374
    allowed_vendor_type: 4651
    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
    is_app_open_ad: true
    ae: SERVER_SIDE_AUCTION
  }
}
app {
  name: "Test App"
  ver: "9.1.6"
  bundle: "com.google.testapp"
  publisher {
    id: "pub-8897222327395144"
    [com.google.doubleclick.publisher] {
      country: "TH"
    }
  }
  content {
    url: "https://www.google.com"
    userrating: "4.7"
    livestream: false
    language: "en"
  }
  storeurl: "https://www.google.com"
  [com.google.doubleclick.app] {
    inventorypartnerdomain: "OMITTED"
  }
}
device {
  ua: "OMITTED"
  geo {
    lat: 0.0
    lon: 0.0
    country: "IND"
    region: "IN-OR"
    zip: "751024"
    type: IP
    utcoffset: 330
    accuracy: 5126
    [com.google.doubleclick.geo] {
      geo_criteria_id: 9149991
    }
  }
  ipv6: "2401:4900:3da4::"
  carrier: "70210"
  make: "Samsung"
  model: "SM-A705GM"
  os: "android"
  osv: "11"
  connectiontype: WIFI
  devicetype: HIGHEND_PHONE
  lmt: true
  w: 384
  h: 812
  pxratio: 2.813
  sua {
    browsers {
      brand: "Mozilla"
      version: "5"
      version: "0"
    }
    browsers {
      brand: "AppleWebKit"
      version: "537"
      version: "36"
    }
    platform {
      brand: "Android"
      version: "11"
    }
    mobile: true
    model: "SM-A705GM"
    source: USER_AGENT_STRING
  }
  [com.google.doubleclick.device] {
    session_id: "LFcNok-qRI2ea_Z5FPgRiA"
  }
}
user {
  [com.google.doubleclick.user] {
    session {
      duration: 89
    }
  }
}
at: FIRST_PRICE
tmax: 300
cur: "USD"
bcat: "IAB23-3"
bcat: "IAB23-4"
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-v243220999.224400000.1"
    schain {
      complete: 1
      nodes {
        asi: "testssp.com"
        sid: "pub-1111111111111111"
        hp: 1
      }
      ver: "1.0"
    }
  }
}
[com.google.doubleclick.bid_request] {
  google_query_id: "ANy-z7C179-E2Rj2VZOiHt5vMyI25Z3W94Lk71Tbz95m005IfNm8OP88j46C27ovLV5yV57m"
  fcap_scope: FREQUENCY_CAPPING_SCOPE_APP
  privacy_treatments {
    allow_user_data_collection: true
  }
}

OpenRTB JSON

Örneği göster

{
  "id": "27q8F4ja125b5Ay5Lg5I8Y",
  "imp": [
    {
      "id": "1",
      "banner": {
        "w": 368,
        "h": 740,
        "pos": 7,
        "api": [
          3,
          5
        ],
        "format": [
          {
            "w": 368,
            "h": 740
          },
          {
            "w": 300,
            "h": 600
          }
        ]
      },
      "displaymanager": "GoogleMobileAds-Android",
      "displaymanagerver": "21.5.0",
      "instl": 1,
      "tagid": "7072441745",
      "bidfloor": 0.01,
      "bidfloorcur": "USD",
      "secure": 1,
      "exp": 14400,
      "clickbrowser": 1,
      "metric": [
        {
          "type": "click_through_rate",
          "value": 0.026930272579193115,
          "vendor": "EXCHANGE"
        },
        {
          "type": "viewability",
          "value": 0.82,
          "vendor": "EXCHANGE"
        }
      ],
      "ext": {
        "billing_id": [
          "14443955188"
        ],
        "publisher_settings_list_id": [
          "7634109184153514733",
          "4552400977800686866"
        ],
        "allowed_vendor_type": [
          4374,
          4651
        ],
        "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,
        "is_app_open_ad": 1,
        "ae": 0
      }
    }
  ],
  "app": {
    "name": "Test App",
    "ver": "9.1.6",
    "bundle": "com.google.testapp",
    "publisher": {
      "id": "pub-8897222327395144",
      "ext": {
        "country": "TH"
      }
    },
    "content": {
      "url": "https://www.google.com",
      "userrating": "4.7",
      "livestream": 0,
      "language": "en"
    },
    "storeurl": "https://www.google.com",
    "ext": {
      "inventorypartnerdomain": "OMITTED"
    }
  },
  "device": {
    "ua": "OMITTED",
    "geo": {
      "lat": 0.0,
      "lon": 0.0,
      "country": "IND",
      "region": "IN-OR",
      "zip": "751024",
      "type": 2,
      "utcoffset": 330,
      "accuracy": 5126,
      "ext": {
        "geo_criteria_id": 9149991
      }
    },
    "ipv6": "2401:4900:3da4::",
    "carrier": "70210",
    "make": "Samsung",
    "model": "SM-A705GM",
    "os": "android",
    "osv": "11",
    "connectiontype": 2,
    "devicetype": 4,
    "lmt": 1,
    "w": 384,
    "h": 812,
    "pxratio": 2.813,
    "sua": {
      "browsers": [
        {
          "brand": "Mozilla",
          "version": [
            "5",
            "0"
          ]
        },
        {
          "brand": "AppleWebKit",
          "version": [
            "537",
            "36"
          ]
        }
      ],
      "platform": {
        "brand": "Android",
        "version": [
          "11"
        ]
      },
      "mobile": 1,
      "model": "SM-A705GM",
      "source": 3
    },
    "ext": {
      "session_id": "LFcNok-qRI2ea_Z5FPgRiA"
    }
  },
  "user": {
    "ext": {
      "session": {
        "duration": 89
      }
    }
  },
  "at": 1,
  "tmax": 300,
  "cur": [
    "USD"
  ],
  "bcat": [
    "IAB23-3",
    "IAB23-4"
  ],
  "source": {
    "schain": {
      "complete": 1,
      "nodes": [
        {
          "asi": "testssp.com",
          "sid": "pub-1111111111111111",
          "hp": 1
        }
      ],
      "ver": "1.0"
    },
    "ext": {
      "omidpn": "Google",
      "omidpv": "afma-sdk-a-v243220999.224400000.1",
      "schain": {
        "complete": 1,
        "nodes": [
          {
            "asi": "testssp.com",
            "sid": "pub-1111111111111111",
            "hp": 1
          }
        ],
        "ver": "1.0"
      }
    }
  },
  "ext": {
    "google_query_id": "ANy-z7C179-E2Rj2VZOiHt5vMyI25Z3W94Lk71Tbz95m005IfNm8OP88j46C27ovLV5yV57m",
    "fcap_scope": 4,
    "privacy_treatments": {
      "allow_user_data_collection": 1
    }
  }
}

En iyi uygulamalar

Google aşağıdaki en iyi uygulamaları önerir:

  • Reklamları reklam alanında ortalamanız için HTML reklam öğesi snippet'lerinize biçimlendirme özellikleri ekleyin. Aksi takdirde reklamlar, reklam yuvasının sol üst kısmında oluşturulur.

  • Reklam alanında mümkün olduğunca fazla yer kaplayan bir geçiş reklamıyla yanıt verin. Geçiş reklamı alanını çok daha küçük bir reklamla doldurmayın. Örneğin, 320x480 boyutunda bir reklam, 420x800 boyutunda bir geçiş reklamı alanı için çok küçüktür.

  • Kapat düğmesi eklemeyin:

    • SDK'mız, kullanıcıların düğmeyi tıklayabilmesini sağlamak için otomatik olarak bir kapat düğmesi gösterir (geçerli olduğu durumlarda).
    • MRAID useCustomClose() desteklenmiyor.
  • Teklif yanıtınız için kabul edilebilir reklam boyutlarını seçmek üzere teklif isteğinde önerilen boyutları kullanın.

  • Uygun yöne sahip reklam öğeleri seçmek için BidRequest.device.w ve BidRequest.device.h alanlarını karşılaştırın.

    • Uygun yönde teklif verebilmek için dikey ve yatay reklam öğelerinizin olmasını öneririz.

Boyutsuz (değişken) geçiş reklamları

Boyutsuz geçiş reklamları (duyarlı veya değişken geçiş reklamları olarak da bilinir), reklam alanı genişliğinin ve yüksekliğinin tamamını kaplayacak şekilde dinamik olarak yeniden boyutlandırılır. Authorized Buyers, reklam öğelerini sizin için yeniden boyutlandırmaz. Dinamik olarak yeniden boyutlandırılan bir reklam öğesi sağlamanız gerekir.

Boyutsuz geçiş reklamları birden fazla boyutta yayınlanabilse de inceleme için yalnızca bir kez göndermeniz gerekir. Reklam öğenizin her bir reklam alanı boyutu için yeniden incelenmediğinden emin olmak üzere aşağıdakileri yapmanızı öneririz:

Teklif yanıtı

  • Teklif yanıtınızda Rendering: Sizeless AdX (özellik 105) özelliğini belirtmek için BidResponse.seatbid.bid.ext.attribute kullanın. Tanımlanabilir reklam öğesi özelliklerini buyer-declarable-creative-attributes.txt veri dosyasında bulabilirsiniz.

  • BidResponse.seatbid.bid.w ve BidResponse.seatbid.bid.h'yi, reklam boyutu koşullarına göre reklam öğesinin oluşturulmasını istediğiniz boyutla doldurun. Örneğin, 360x480 reklam alanı için 360x480. Reklam öğesi diğer boyutlarda yayınlanmaya devam edebilir. Desteği sonlandırılan Google GZT protokolü için BidResponse.Ad.width ve BidResponse.Ad.height değerlerini doldurursunuz.

Rendering: Sizeless AdX özelliğini mevcut bir reklam öğesine eklerseniz reklam öğesi yeniden incelenmelidir.

Reklam öğesi ön onayı

  • Reklam öğesini incelemeye gönderirken declaredAttributes alanına RENDERING_SIZELESS_ADX özelliğini ekleyin. Gerçek Zamanlı Teklif Verme API'sinde reklam öğesi özellikleri, dize bir enum değeri kullanılarak temsil edilir. Bunların buyer-declarable-creative-attributes.txt dosyasında yer alan sayısal kimliklerle nasıl eşleştiği hakkında daha fazla bilgi edinmek için eşleme kılavuzunu inceleyin.
  • Reklam öğesini, yayınlamayı beklediğiniz bir boyutu (yani geçiş reklamı reklam öğeleri için yaygın bir boyutu) kullanarak gönderin. Reklam öğesi diğer boyutlarda yayınlanmaya devam edebilir.
  • Boyutsuz her reklam öğesi, birden fazla boyutta yayınlansa bile reklam öğesi sınırınıza yalnızca bir kez dahil edilir.