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çeriği ekranda görünmez. Google protokolünün BidRequest.mobile.is_interstitial_request alanının true olarak ayarlandığını doğrulayarak teklif isteğinde bir geçiş reklamı fırsatı tanımlayabilirsiniz. OpenRTB için BidRequest.imp.instl alanı, Protobuf'ta true veya JSON'de 1 olarak ayarlanır.

Reklam alanı boyutu

Geçiş reklamları için reklam alanının boyutu, reklam öğelerini oluşturmak için kullanılabilecek alanı gösterir ve belirli biçimler ile ekran boyutları gibi çeşitli faktörlere bağlıdır. İlk reklam alanı genişliği ve yüksekliği çifti (Google GZT'deki BidRequest.adslot.width ve BidRequest.adslot.height alanları veya OpenRTB'deki BidRequest.imp.banner.format alanı) reklam alanı boyutunu temsil eder. Kalan genişlik ve yükseklik ise önerilen reklam boyutları listesini temsil eder.

Reklam öğeleri, teklif isteğinde önerilen boyutlarla sınırlı değildir, ancak teklif isteğinde önerilen tüm boyutların kabul edilebilir boyut aralığında olması garanti edilir.

Genişliği ve yüksekliği aşağıdaki ölçütleri karşılayan herhangi bir reklam öğesiyle teklif verebilirsiniz:

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

Reklam boyutu çok büyük veya çok küçükse teklif yanıtı, INTERSTITIAL_SIZE_MISMATCH reddetme nedeni ile filtrelenir.

Teklif yanıtında reklam boyutunu belirtmezseniz yanıt, MISSING_AD_SIZE reddetme nedeni ile filtrelenir.

Örnek teklif istekleri

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

Google

Örneği göster

id: "p\340\224\364\251I\301\221\357\302\363\311\326\321\311\203\0325iY\036$\363"
ip: "\300\250"
user_agent: "Mozilla/5.0 (Linux; Android 9; vivo 1906 Build/PKQ1.190616.001; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/74.0.3729.136 Mobile Safari/537.36 (Mobile; afma-sdk-a-v223616029.223616029.0)"
url: "https://www.google.com"
detected_language: "en"
adslot {
  id: 1
  width: 344
  width: 320
  height: 566
  height: 480
  excluded_attribute: 17
  excluded_attribute: 70
  allowed_vendor_type: 342
  allowed_vendor_type: 767
  matching_ad_data {
    billing_id: 70362152071
    billing_id: 21403803968
    minimum_cpm_micros: 10000
  }
  matching_ad_data {
    billing_id: 47992615927
    minimum_cpm_micros: 40000
  }
  slot_visibility: ABOVE_THE_FOLD
  ad_block_key: 2015797598
  publisher_settings_list_id: 9769388807110493568
  excluded_creatives {
    buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
  }
  excluded_creatives {
    buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
  }
  viewability: 75
  click_through_rate: 0.008278628
  renderer: GOOGLE
  allowed_ad_types: ALLOWED_AD_TYPE_BANNER
  is_amp_page: DIALECT_HTML
  amp_ad_requirement_type: AMP_AD_NOT_ALLOWED
  session_depth: 1
  api: MRAID_1
  api: MRAID_2
  creative_enforcement_settings {
    policy_enforcement: POLICY_ENFORCEMENT_NETWORK_AND_PLATFORM_POLICY
    publisher_blocks_enforcement: PUBLISHER_BLOCKS_ENFORCEMENT_APPLIES
  }
  auction_environment: SERVER_SIDE_AUCTION
  impression_expiration_seconds: 14400
}
is_test: false
cookie_version: 1
google_user_id: "4693b7L1N462wk3063e5A0lFRR6"
mobile {
  app_id: "com.google.testapp"
  is_app: true
  is_interstitial_request: true
  encrypted_advertising_id: "j\313B\254\024\213\261B\253\363\227\262\336\246\357\267C\005R)\370\020&\357\314\232\025\245w\253g\214\r\242R\363"
  app_name: "Test App"
  app_rating: 4.232468
  advertising_id: "\253\0133f\310\301W\312\251\241ws\370\016ab"
  is_app_open_ad: true
}
cookie_age_seconds: 31104000
geo_criteria_id: 1007768
seller_network_id: 1
publisher_settings_list_id: 4929293432301356848
publisher_type: PUBLISHER_OWNED_AND_OPERATED
partner_id: 5835779567832270445
device {
  device_type: HIGHEND_PHONE
  platform: "android"
  brand: "vivo"
  model: "1906"
  os_version {
    major: 9
  }
  carrier_id: 70210
  screen_width: 344
  screen_height: 566
  screen_pixel_ratio_millis: 2000
  screen_orientation: PORTRAIT
  limit_ad_tracking: false
}
publisher_country: "IN"
publisher_id: "pub-1111111111111111"
response_deadline_ms: 1000
google_query_id: "ANy-z9QuEQ-Z3o2P79uIqUl3J6j3i708170JO6N7o7b4QN8388crqu6J3jnF9lScdX9hDIL6"
auction_type: FIRST_PRICE
geo {
  lat: 12.97
  lon: 77.59
  country: "IND"
  region: "IN-KA"
  city: "Bangalore"
  accuracy: 25585
}
user_agent_data {
  platform {
    brand: "Android"
    version: "9"
  }
  mobile: true
  model: "vivo 1906"
  browsers {
    brand: "Mozilla"
    version: "5"
    version: "0"
  }
  browsers {
    brand: "AppleWebKit"
    version: "537"
    version: "36"
  }
}
supply_chain {
  complete: true
  nodes {
    advertising_system_identifier: "google.com"
    seller_identifier: "pub-1111111111111111"
    handles_payment: true
  }
  version: "1.0"
}
frequency_capping_scope: FREQUENCY_CAPPING_SCOPE_DEVICE
privacy_treatments {
  allow_user_data_collection: true
}
inventory_partner_domain: "OMITTED"

OpenRTB JSON

Örneği göster

{
  "id": "jQoM5h247369CR720E8pX7",
  "imp": [
    {
      "id": "1",
      "banner": {
        "w": 414,
        "h": 816,
        "pos": 1,
        "api": [
          3,
          5
        ],
        "format": [
          {
            "w": 414,
            "h": 816
          },
          {
            "w": 414,
            "h": 736
          }
        ]
      },
      "displaymanager": "GOOGLE",
      "instl": 1,
      "tagid": "2429833703",
      "bidfloor": 0.01,
      "bidfloorcur": "USD",
      "secure": 1,
      "exp": 3600,
      "metric": [
        {
          "type": "click_through_rate",
          "value": 0.06219178065657616,
          "vendor": "EXCHANGE"
        },
        {
          "type": "viewability",
          "value": 0.93,
          "vendor": "EXCHANGE"
        }
      ],
      "ext": {
        "billing_id": [
          42824952399
        ],
        "publisher_settings_list_id": [
          1718616986721376572,
          3393897066214924933
        ],
        "allowed_vendor_type": [
          474,
          828
        ],
        "ampad": 2,
        "excluded_creatives": [
          {
            "buyer_creative_id": "EXCLUDED_BUYER_CREATIVE_ID"
          },
          {
            "buyer_creative_id": "EXCLUDED_BUYER_CREATIVE_ID"
          }
        ],
        "skadn": {
          "sourceapp": "240782188",
          "skadnetids": [
            "QyYKoxm0",
            "1hTUJW9s"
          ],
          "versions": [
            "2.0",
            "2.1"
          ],
          "fidelities": [
            1,
            0
          ]
        },
        "creative_enforcement_settings": {
          "policy_enforcement": 2,
          "publisher_blocks_enforcement": 1
        },
        "auction_environment": 0
      }
    }
  ],
  "app": {
    "name": "Test App",
    "bundle": "240782188",
    "publisher": {
      "id": "pub-3015069731015948",
      "ext": {
        "country": "IN"
      }
    },
    "content": {
      "url": "https://www.google.com",
      "livestream": 0,
      "language": "ar"
    },
    "storeurl": "https://www.google.com",
    "ext": {
      "inventorypartnerdomain": "OMITTED"
    }
  },
  "device": {
    "ua": "Mozilla/5.0 (iPhone; CPU iPhone OS 15_4_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148",
    "geo": {
      "lat": 0.0,
      "lon": 0.0,
      "country": "SAU",
      "region": "SA-01",
      "city": "Riyadh",
      "type": 2,
      "accuracy": 51325
    },
    "ipv6": "2a02:9b0::",
    "carrier": "71681",
    "make": "apple",
    "model": "iphone",
    "os": "iOS",
    "osv": "15.4.4",
    "devicetype": 4,
    "lmt": 1,
    "hwv": "11",
    "w": 414,
    "h": 896,
    "pxratio": 2,
    "sua": {
      "browsers": [
        {
          "brand": "Mozilla",
          "version": [
            "5",
            "0"
          ]
        },
        {
          "brand": "AppleWebKit",
          "version": [
            "605",
            "1"
          ]
        }
      ],
      "platform": {
        "brand": "iPhone",
        "version": [
          "15",
          "4"
        ]
      },
      "mobile": 1,
      "bitness": "64",
      "model": "iPhone",
      "source": 3
    },
    "ext": {
      "user_agent_data": {
        "platform": {
          "brand": "iPhone",
          "version": [
            "15",
            "4"
          ]
        },
        "mobile": 1,
        "model": "iPhone",
        "browsers": [
          {
            "brand": "Mozilla",
            "version": [
              "5",
              "0"
            ]
          },
          {
            "brand": "AppleWebKit",
            "version": [
              "605",
              "1"
            ]
          }
        ],
        "bitness": "64"
      },
      "atts": 2
    }
  },
  "at": 1,
  "tmax": 1000,
  "cur": [
    "USD"
  ],
  "bcat": [
    "IAB23",
    "IAB23-8"
  ],
  "source": {
    "ext": {
      "omidpn": "Google",
      "omidpv": "afma-sdk-i-v9.11.0",
      "schain": {
        "complete": 1,
        "nodes": [
          {
            "asi": "google.com",
            "sid": "pub-2179124855984389",
            "hp": 1
          }
        ],
        "ver": "1.0"
      }
    }
  },
  "ext": {
    "google_query_id": "ANy-z3yuYe-1zH42iRs4q13HL3qubj73w89q7m7u4294c9HO3O9p337394C1o49qslN10Azf",
    "fcap_scope": 4,
    "privacy_treatments": {
      "non_personalized_ads_reason": [
        3
      ],
      "allow_user_data_collection": 0
    }
  }
}

OpenRTB Protokol Arabelleği

Örneği göster

id: "4o7h7Q4d4g7j5AE3V5P50P"
imp {
  id: "1"
  banner {
    w: 360
    h: 640
    pos: ABOVE_THE_FOLD
    api: MRAID_1
    api: MRAID_2
    format {
      w: 360
      h: 640
    }
    format {
      w: 360
      h: 604
    }
  }
  displaymanager: "GOOGLE"
  instl: true
  tagid: "8739319040"
  bidfloor: 0.01
  bidfloorcur: "USD"
  secure: true
  exp: 3600
  metric {
    type: "click_through_rate"
    value: 0.027179887518286705
    vendor: "EXCHANGE"
  }
  metric {
    type: "viewability"
    value: 0.55
    vendor: "EXCHANGE"
  }
  [com.google.doubleclick.imp] {
    billing_id: 43834715105
    billing_id: 50168315928
    publisher_settings_list_id: 9560899702685587079
    publisher_settings_list_id: 2918911787042761476
    allowed_vendor_type: 237
    allowed_vendor_type: 445
    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
  }
}
app {
  name: "Test App"
  bundle: "com.google.testapp"
  publisher {
    id: "pub-5553540914412173"
    [com.google.doubleclick.publisher] {
      country: "NG"
    }
  }
  content {
    url: "https://www.google.com"
    userrating: "4.3"
    livestream: false
    language: "id"
  }
  storeurl: "https://www.google.com"
  [com.google.doubleclick.app] {
    inventorypartnerdomain: "OMITTED"
  }
}
device {
  ua: "Mozilla/5.0 (Linux; Android 6.0.1; SM-G532G Build/MMB29T; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/55.0.2883.91 Mobile Safari/537.36 (Mobile; afma-sdk-a-v223616016.223616016.0)"
  ip: "192.168.1.0"
  geo {
    lat: 0.0
    lon: 0.0
    country: "USA"
    region: "NY"
    metro: "501"
    city: "New York"
    type: IP
    accuracy: 6201
  }
  carrier: "70089"
  make: "samsung"
  model: "sm-g532g"
  os: "android"
  osv: "6.0.0"
  devicetype: HIGHEND_PHONE
  ifa: "b\'aq\\xd9*\\x12\\xcd\\xae\\x0f\\x01\\x18b\\x8a|\\x95*\\x06\'"
  lmt: false
  w: 360
  h: 640
  pxratio: 1.5
  sua {
    platform {
      brand: "Mobile Safari"
      version: "5"
      version: "0"
    }
  }
}
user {
  id: "47fm86fQX97m1CfUPjMu7oJ5go8"
}
at: FIRST_PRICE
tmax: 1000
cur: "USD"
source {
  [com.google.doubleclick.source] {
    omidpn: "Google"
    omidpv: "afma-sdk-a-v224400999.223104000.1"
    schain {
      complete: 1
      nodes {
        asi: "google.com"
        sid: "pub-5640609611628446"
        hp: 1
      }
      ver: "1.0"
    }
  }
}
[com.google.doubleclick.bid_request] {
  google_query_id: "ANy-z68ELw-u700Du3Sv503Q08SMcMjR07THKNnl0ylqF72357ZD1N67Pw9R82TO6expd062"
  fcap_scope: FREQUENCY_CAPPING_SCOPE_DEVICE
  privacy_treatments {
    allow_user_data_collection: true
  }
}

En iyi uygulamalar

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

Reklamları reklam alanı içinde ortalamak için HTML reklam öğesi snippet'lerinize biçimlendirme özellikleri ekleyin. Aksi takdirde reklamlar, reklam alanının sol üst tarafı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 boyutundaki bir reklam, 420x800 geçiş reklamı alanı için çok küçüktür.
Herhangi bir kapat düğmesi ekleme:
- SDK'mız, kullanıcıların düğmeyi tıklayabilmeleri için otomatik olarak bir kapatma düğmesi (geçerli olduğunda) gösterir.
- MRAID useCustomClose() desteklenmiyor.
Teklif yanıtınızda kabul edilebilir reklam boyutları seçmek için teklif isteğinde önerilen boyutları kullanın.
Uygun yöne sahip reklam öğelerini seçmek için screen_orientation sinyaline bakın.
- screen_orientation sinyaline göre uygun yönle teklif verebilmeniz 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.

Birden fazla boyutta yayınlanabilseler bile boyutsuz geçiş reklamlarını incelemeye yalnızca bir kez göndermeniz gerekir. Reklam öğenizin her bir reklam alanı boyutu için yeniden incelenmemesini sağlamak amacıyla aşağıdakileri yapmanız önerilir:

Teklif yanıtı

Teklif yanıtınızda reklam öğesi özelliklerinden SIZELESS_ADX özelliği 105 bilgisini tanımlayın.
BidResponse.Ad.width ve BidResponse.Ad.height alanlarını, (#reklam boyutu)[reklam boyutu şartları] doğrultusunda reklam öğesinin oluşturulmasını istediğiniz boyutla (örneğin, 360x480 boyutundaki bir reklam alanı için 360x480) doldurun. Reklam öğesi diğer boyutlarda yayınlanmaya devam edebilir.

SIZELESS_ADX özelliğini mevcut bir reklam öğesine eklerseniz reklam öğesinin yeniden incelenmesi gerekir.

Reklam öğesi ön onayı

Bir reklam öğesini incelemeye gönderirken attribute alanına SIZELESS_ADX özelliğini ekleyin.
Reklam öğesini, sunmayı beklediğiniz bir boyut (geçiş reklamları için sık kullanılan bir boyut) kullanarak gönderin. Reklam öğesi diğer boyutlarda yayınlanmaya devam edebilir.
Her boyutsuz reklam öğesi, birden fazla boyutta yayınlansa bile reklam öğesi sınırınızda yalnızca bir kez sayılır.