OpenRTB Video Reklamlar

Bu kılavuzda, OpenRTB protokolü kullanılarak GZT satın alma için entegrasyon gereksinimleri açıklanmaktadır. Bu kılavuz, burada açıklanan alanların ayrıntılı olarak açıklandığı OpenRTB Integration kılavuzu ile birlikte kullanılmalıdır.

<video> etiketleri içeren HTML snippet'leri olan iOS uygulamalarında ürün satın alırsanız video etiketine playsinline özelliğini eklemeniz gerekir. Aksi takdirde kullanıcılar, reklam öğesinde oynatılması gereken video reklamların tam ekran olarak açıldığı çok kötü bir deneyim yaşar. Buna uymayan reklamlar engellenir.

Alıcı şartları

Yeni GZT alıcıları, en son protokol arabelleğini ve aşağıdaki bölümlerde açıklanan bilgileri kullanarak teklif verenlerini geliştirmelidir. Protokolü indirmek için referans verileri sayfasına bakın. Teklif veren geliştirme hakkında bilgi için İsteği İşleme ve Yanıtı Oluşturma konularına bakın.

Desteklenen makrolar

Aşağıdaki makrolar yayın içi video reklam öğelerinde desteklenir:

• %%CACHEBUSTER%%
• %%WINNING_PRICE%%

Makro değiştirme işlemine video URL'sinde izin verildiğini, ancak gerçek VAST XML'de izin verilmediğini unutmayın.

Authorized Buyers, tıklama izleyicilerini bir VAST sarmalayıcıya eklediğinden tıklama makroları (CLICK_URL_ESC gibi) gerekli değildir. Bu nedenle, tıklama makroları yayın içi video reklamlarda desteklenmez. Desteklenen makrolar hakkında daha fazla bilgi için Yanıtı Oluşturma başlığı altındaki Makroları belirtme bölümüne bakın.

Video nesnesi ayrıntıları

OpenRTB protokolü, video isteklerini tanımlamak ve istek hakkında videoya özgü ek bilgiler sağlamak için openrtb-proto.txt dosyasında tanımlanan bir Video mesajı kullanır.

Ayrıntılı açıklamalar ve örnekler için OpenRTB Entegrasyon kılavuzundaki Video mesajı alanları listesine bakın.

Diğer video teklif isteği alanları

Aşağıdaki sinyallerin tümü video reklam öğelerine özel değildir ancak teklif isteğinin önemli parçalarıdır.

Göst. nesnesi alanları

Bu nesne, açık artırmaya yapılan bir reklam yerleşimini veya gösterimi tanımlar.

banner	Banner nesnesi; gösterim banner reklam fırsatı olarak sunuluyorsa gereklidir.
video	Sunulan gösterimin türünü belirtir (bu örnekte video). imp nesnesi hem banner hem de video nesneleri içeriyorsa banner içi videoya izin verildiğini unutmayın.
tagid	Açık artırmayı başlatmak için kullanılan belirli bir reklam yerleşiminin veya reklam etiketinin tanımlayıcısı. Bu, herhangi bir sorunun giderilmesi veya alıcı tarafından optimizasyon yapılması için yararlı olabilir.
bidfloor	Bu gösterim için BGBM olarak ifade edilen minimum teklif.
bidfloorcur	Dahil edilen billing_id. öğesinden alınan tek bir para birimi

Daha fazla ayrıntı için OpenRTB kılavuzundaki Imp nesnesi bölümüne bakın.

Cihaz nesne alanları

Device nesnesindeki alanlar, hedeflenen cihaz hakkında bilgi sağlar.

ua	Tarayıcı kullanıcı aracısı dizesi.
ip	Cihaza en yakın IPv4 adresi.
geo	Bir Geo nesnesi tarafından tanımlanan, kullanıcının geçerli konumu olduğu varsayılan cihazın konumu.
devicetype	Genel cihaz türü.
ifa	Açık alanda reklamveren kullanımı için zorunlu tutulan kimlik (ör. karma oluşturma işlemi uygulanmamış). ifa; Roku, Apple TV, Fire TV, Xbox gibi bağlı TV cihazlarında desteklenir.

Daha ayrıntılı bilgi için OpenRTB kılavuzundaki Cihaz nesnesi bölümüne bakın.

Site nesnesi

Site nesnesindeki alanlar, reklam destekli içeriğe sahip site hakkında bilgi sağlar.

page	Gösterimin gösterileceği sayfanın URL'si.
publisher	Sitenin Publisher nesnesiyle ilgili ayrıntılar.
content	Sitedeki Content ile ilgili ayrıntılar.

Daha fazla ayrıntı için OpenRTB kılavuzundaki Site nesnesi bölümüne bakın.

Kullanıcı nesnesi

User nesnesindeki alanlar, reklam destekli içeriğe sahip site hakkında bilgi sağlar.

id	Kullanıcının Exchange'e özel kimliği. En az bir id veya buyerid önerilir.
data	Sitenin Publisher nesnesiyle ilgili ayrıntılar.

Ek ayrıntılar için OpenRTB kılavuzundaki Kullanıcı nesnesi bölümüne bakın.

Teklif isteği envanter alanları

Video teklif isteği, içerik türleri ve belirtilen tamamlayıcı reklamlarla ilgili bilgileri de içerir.

mimes

Desteklenen içerik MIME türlerinin izin verilenler listesi.

companionad

Tamamlayıcı reklamlar varsa Banner nesneleri dizisi.

Teklif yanıtı alanları

Video teklif yanıtındaki önemli alanlar şunlardır:

id

Bunun yanıt olduğu teklif isteğinin kimliği.

seatbid

Seatbid nesne dizisi; teklif yapılacaksa bir veya daha fazlası gereklidir.

seat

Seatbid nesnesi; bu teklifin adına oluşturulduğu alıcı lisansının kimliği (örneğin reklamveren, ajans).

bid

Her biri bir gösterimle ilişkili olan bir veya daha fazla Bid nesnesinden oluşan dizi.

Ön hedefleme

Video envanteri almak için OpenRTB alıcılarının video envanterini içeren bir ön hedefleme yapılandırmasına sahip olması gerekir.

Örnek teklif isteği ve yanıtı

Teklif isteği

Göster

{
  id: "XIsz9QAHfAYKj3oDMQ3QOg",
  imp: [{
    id: "1",
    banner: {
      w: 300,
      h: 250,
      format:     [{
        w: 300,
        h: 250
      },{
        w: 250,
        h: 250
      }],
      battr:     [5]
    },
    video: {
      mimes:     [video/mp4],
      linearity: 1,
      protocols:     [2,3,5,6],
      w: 300,
      h: 250,
      skip: 1,
      battr:     [5],
      playbackmethod:     [6],
      plcmt: 3
    },
    displaymanager: "GOOGLE",
    tagid: "2111189154",
    bidfloor: 0.01,
    bidfloorcur: "USD",
    secure: 1,
    native: {
      request_native: {
        ver: "1.2",
        assets:       [{
          id: 1,
          required: 1,
          title: {
            len: 25
          }
        },{
          id: 2,
          data: {
            type: 2,
            len: 90
          }
        },{
          id: 3,
          data: {
            type: 12,
            len: 15
          }
        },{
          id: 4,
          data: {
            type: 1,
            len: 25
          }
        },{
          id: 5,
          img: {
            type: 3,
            wmin: 1200,
            hmin: 627
          }
        },{
          id: 6,
          img: {
            type: 2,
            wmin: 100,
            hmin: 100
          }
        },{
          id: 7,
          img: {
            type: 1,
            wmin: 100,
            hmin: 100
          }
        },{
          id: 8,
          data: {
            type: 3,
            len: 5
          }
        },{
          id: 9,
          video: {
            mimes:           [video/mp4]
          }
        }],
        eventtrackers:       [{
          event: 1,
          methods:         [1]
        }],
        adx_ext: {
          style_id: 188961,
          style_height: 250,
          style_width: 300
        }
      },
      ver: "1.2",
      battr:     [5]
    },
    metric:   [{
      type: "click_through_rate",
      value: 0.0006341254338622093,
      vendor: "EXCHANGE"
    },{
      type: "video_completion_rate",
      value: 0.017279919236898422,
      vendor: "EXCHANGE"
    },{
      type: "viewability",
      value: 0.7,
      vendor: "EXCHANGE"
    },{
      type: "session_depth",
      value: 1,
      vendor: "EXCHANGE"
    }],
    adx_ext: {
      billing_id:     [12345567890],
      publisher_settings_list_id:     [5509324247698256194,14109776396365339331],
      allowed_vendor_type:     [3,42,79,4463,4513,4538,4625],
      ampad: "AMP_AD_ALLOWED_AND_NOT_EARLY_RENDERED"
    }
  }],
  site: {
    page: "https:/example.com/school",
    publisher: {
      id: "pub-783270600012345",
      adx_ext: {
        country: "IN"
      }
    },
    content: {
      contentrating: "DV-G",
      language: "en"
    },
    mobile: 1,
    adx_ext: {
      amp: "DIALECT_HTML"
    }
  },
  device: {
    ua: "Mozilla/5.0 (iPad; CPU OS 12_1_4 like Mac OS X) FBOP/5;FBRV/0]",
    ip: "121.222.242.0",
    geo: {
      lat: -26.487831115722656,
      lon: 153.0424346923828,
      country: "AUS",
      region: "AU-QLD",
      zip: "4562",
      utcoffset: 600
    },
    make: "apple",
    model: "ipad",
    os: "iOS",
    osv: "12.1.1",
    w: 768,
    h: 1024,
    pxratio: 2,
    devicetype: 5
  },
  user: {
    id: "CAESEK6jGeddIeo_opp-WrY",
    buyeruid: "anFTbmRJMVF3VXy0",
    customdata: "anFTbmRJMVVXy0",
    data:   [{
      id: "DetectedVerticals",
      name: "DoubleClick",
      segment:     [{
        id: "1263",
        value: "0.5"
      },{
        id: "625",
        value: "0.1"
      }]
    }]
  },
  at: 2,
  tmax: 122,
  cur: [USD],
  bcat: [IAB7-39],
  adx_ext: {
    google_query_id: "ANy-zJFcyG8sUO0_hYbujPqNXbB3bPA"
  }
}

Teklif yanıtı

Göster

{
  "id": "AB1abcDEfghijklMno2pqr",
  "seatbid": [
    {
      "seat": "Example Seat",
      "bid": [
        {
          "id": "12345678901234567890",
          "impid": "1",
          "price": 15,
          "adid": "AB1234-1234",
          "adm": "https://example.com/AdX/win?tag=AbcdEfGhIJ0kLMN2OPQ2RST3UVXyZAB2Cde114eF
          "cid": "12345678901",
          "crid": "1234",
          "adomain": [
            "www.example.com"
          ]
        }
      ]
    }
  ],
  "cur": "USD",
  "bidid": "1234567890123456789"
}

Sözlük

Authorized Buyers video sözlüğüne bakın.