Teknik hızlı başlangıç kılavuzu (OİA)

AdSense ile HTML 5 tarayıcı oyunlarında reklam yayınlamak için Google IMA HTML5 SDK ile nasıl entegrasyon yapacağınızı öğrenmek için bu kılavuzu kullanın. 

Teknik kuruluma genel bakış

Oyunlar için AdSense, Google Etkileşimli Medya Reklamları Yazılım Geliştirme Kiti'ni (IMA HTML5 SDK) kullanarak çalışır. Bu SDK, içerik ve reklamları daha yakından birleştirmek amacıyla AdSense reklamlarını JavaScript üzerinden istemenize izin verir.

Not: Bu ürünler AdSense Şartlar ve Koşulları, AdSense program politikaları ve ürüne özgü kullanım talimatlarına tabidir. Aşırı zorlayıcı veya hatalı uygulamalardan kaynaklanan istemeden yapılmış tıklamaların, hesabın kapatılmasına kadar giden (ve bunu da içeren) sonuçlara yol açabileceğini unutmayın.

IMA HTML5 SDK yoluyla reklam istemek ve oluşturmak için bir reklam isteği hazırlayın, sonuçta alınan reklamı yükleyin ve bu reklamı doğru zamanda oynatın. Entegrasyonu, varsayılan ca-games-pub-4968145218643279 yayıncı kimliğini kullanarak test edin.

Site veya sitelerinize reklam dağıtmanıza izin verilmesi için ilk olarak hesap yöneticinize yaptığınız entegrasyonun bir örneğini sağlamanız gerekir.

İki entegrasyon seçeneği vardır; basit veya gelişmiş. 

Basit entegrasyon

Basit entegrasyon seçeneği, Oyunlar için AdSense'i HTML5 oyunlarınızla entegre etmenin en kolay yoludur. Bu seçenek, Oyunlar için AdSense'te sunulan tüm özellikleri ve reklam biçimlerini sağlayan hızlı bir uygulama çözümü sunar.

Bu basit entegrasyon seçeneğini kullanmayı düşünen yayıncılar programla ilgilendiğini bildirebilir.

Gelişmiş entegrasyon

Daha gelişmiş ve özel bir entegrasyon arayan bir yayıncıysanız HTML5 oyununuza tam IMA HTML5 SDK'yı uygulamanız gerekir. Google Ad Manager aracılığıyla sunulan belirli özellikler gibi ek esneklik sağlayan bu seçeneğin karmaşıklığı artırdığını da unutmamak gerekir.

Gelişmiş entegrasyonu kullanmaya başlama

Başlamak için, IMA HTML5 SDK'sını oyununuza entegre edin.

1. IMA HTML5 SDK entegrasyonunu kurun

   Oyununuzla bir IMA HTML5 SDK entegrasyonu oluşturmak için Google Geliştirici sitesindeki talimatları uygulayın. Sitede verilen başlarken izlemeniz gereken adımlar, indirilebilir örnek kod ve tam API referansı kaynaklarından yararlanabilirsiniz.

2. Reklam kapsayıcısını kurun (AdDisplayContainer)

   IMA HTML5 SDK hem video hem de oyun yayıncılarına hizmet verdiği için, AdDisplayContainer nesnesi farklı şekillerde yapılandırılabilir.

   Oyunlar için AdSense'te kullanılmak üzere AdDisplayContainer nesnesini yapılandırırken referansı, reklamı içeren div'e aktarmanız yeterlidir.

   Örnek:

   var adDisplayContainer = new google.ima.AdDisplayContainer(document.getElementById('adContainer'));

3. Reklam isteğini yapılandırın (AdsRequest)

   AdsRequest nesnesini oluştururken, reklamların uygun şekilde döndürülmesi ve oluşturulması için ilgili parametre ile mülklerin düzgün yapılandırıldığından emin olmalısınız.

   Örnek:

   // Oyunlar için AdSense reklamları için istek yapın.
var adsRequest = new google.ima.AdsRequest();
 
// Setup AdSense for games ad tag
adsRequest.adTagUrl = 'https://googleads.g.doubleclick.net/pagead/ads?ad_type=video_image_text&client=ca-games-pub-4968145218643279&videoad_start_delay=0&description_url=http%3A%2F%2Fwww.google.com&max_ad_duration=20000&adtest=on';
 
// Force image/text ads to render with Full-Slot UI
adsRequest.forceNonLinearFullSlot = true;
 
// Specify the linear and nonlinear slot sizes.
adsRequest.linearAdSlotWidth = {your_game_width};
adsRequest.linearAdSlotHeight = {your_game_height};
adsRequest.nonLinearAdSlotWidth = {your_game_width};
adsRequest.nonLinearAdSlotHeight = {your_game_height};

4. Alakalı etkinlikleri izleyin ve geri arama oluşturun

   Ne zaman reklamı göstermeyi durdurarak kullanıcılarınızın oyuna devam etmesini sağlayacağınızı anlamak için IMA SDK içinde tetiklenen etkinlikleri izlemeniz önemlidir.

   Aşağıda, reklamların oyun içeriğinizdeki yerleşimini belirlemek için sıklıkla kullanılan reklam etkinliklerinden bazıları verilmiştir. Örneğin, oynatılan bir reklamın ne zaman sona erdiğini öğrenmek ve ardından kullanıcıya oyun içeriğinizi sunmak için COMPLETE etkinliğini izleyebilirsiniz. Reklam etkinliklerin tam listesi API referansında mevcuttur.

   Etkinlik adı	Açıklama
   AdEvent.Type.CLICK	Reklam tıklandığında tetiklenir.
   AdEvent.Type.COMPLETE	Reklamın oynatılması tamamlandığında tetiklenir.
   AdEvent.Type.LOADED	Reklam verileri kullanılabildiğinde tetiklenir.
   AdEvent.Type.SKIPPED	Kullanıcı reklamı atladığında tetiklenir.
   AdEvent.Type.START	Reklam oynatılmaya başladığında tetiklenir.
   AdEvent.Type.USER_CLOSE	Kullanıcı reklamı kapattığında tetiklenir.
   AdErrorEvent.Type.AD_ERROR	Bir reklam hatası etkinliği meydana geldiğinde tetiklenir. Birçok farklı türde reklam hatası meydana gelebilir. Reklam medyası öğesinin yüklenememesi veya reklam isteklerinde döndürülen boş reklam yanıtları, örnekler arasında gösterilebilir. Olası hataların bir listesi API referansında mevcuttur.