Bu sayfa, Cloud Translation API ile çevrilmiştir.

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: "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
  }
}

OpenRTB JSON

Örneği göster

{
  "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
    }
  }
}

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.

Geçiş Reklamları Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

Reklam alanı boyutu

Örnek teklif istekleri

OpenRTB Protobuf

Örneği göster

OpenRTB JSON

Örneği göster

En iyi uygulamalar

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

Teklif yanıtı

Reklam öğesi ön onayı

Geçiş Reklamları