Reklam inceleyici

Reklam inceleyici, yetkili cihazların test reklam isteklerini doğrudan bir mobil uygulama içinde anlık olarak analiz etmesine olanak tanıyan bir uygulama içi yer paylaşımıdır. Google Mobile Ads SDK'sı 20.0.0 ve sonraki sürümlere dahildir ve kodlama gerektirmeden etkinleştirilebilir.

Mobile Ads SDK'sı 20.2.0'dan düşük sürümlerinde reklam inceleyiciyi kullanarak şunları yapabilirsiniz:

• Reklam birimlerinizi inceleme
• Üçüncü taraf bağdaştırıcılarınızı inceleme
• Reklamlarınızın beklendiği gibi doldurulup doldurulmadığını kontrol etme
• Hataları belirleme ve bunların çözümüyle ilgili ayrıntıları görüntüleme
• İstek başına her reklam ağı için uyumlulaştırma ayrıntılarını görüntüleme
• Bağımsız üçüncü taraf uyumlulaştırma reklam kaynaklarını test etme
• Her reklam birimini şelale uyumlulaştırma için doğru şekilde yapılandırdığınızı doğrulama
• Özel etkinlik entegrasyonlarını test etme

Mobile Ads SDK'sı 20.2.0 ve sonraki sürümlerde şunları da yapabilirsiniz:

• İstek başına her reklam ağının teklif ayrıntılarını görüntüleme
• İstek başına her reklam ağı için teklifli sistem ve şelale uyumlulaştırma ayrıntılarını birlikte görüntüleme
• Bağımsız üçüncü taraf teklifli sistem veya şelale uyumlulaştırma reklam kaynaklarını test etme

• Teklif verme ve şelale uyumlulaştırma için her reklam birimini doğru şekilde yapılandırdığınızı doğrulayın

Bu kılavuzda, reklam denetleyicideki farklı özelliklerin nasıl başlatılacağı ve kullanılacağı gösterilmektedir.

Ön koşullar

Reklam inceleyiciyi kullanmak için:

• Bir AdMob hesabı oluşturun ve bir uygulama oluşturun.

• Başlangıç kılavuzunu tamamlayın.

• Google Mobile Ads SDK'sı 20.0.0 veya daha yeni bir sürüm kullanın.

• Cihazınızı test cihazı olarak ekleyin. Reklam inceleyici yalnızca test cihazlarında başlatılır.

Reklam inceleyiciyi başlat

Reklam inceleyici, uygulamanızın herhangi bir yerinde aşağıdaki yöntemlerle başlatılabilir:

1. Test cihazı kaydederken AdMob kullanıcı arayüzünde seçilen hareketi kullanın.
2. Sağlanan API'yi programatik olarak kullanın.
3. Hata ayıklama menüsündeki başlat düğmesini kullanın.

Hareketleri kullanarak başlatma

Reklam inceleyiciyi hareketle başlatmak için uygulamanızda herhangi bir değişiklik yapmanız gerekmez. Bunun için, ilgili test cihazı için AdMob'da yapılandırdığınız hareketi (çift dokunma veya sallama) yapmanız yeterlidir. Daha fazla bilgi

AdMob kullanıcı arayüzünde bir hareket ayarladıktan (ve uygulanması için 15 dakika bekledikten) sonra, uygulamanızın, hareket ayarınız hakkında bilgi edinmesi için Google Mobile Ads SDK'sına reklam isteğinde bulunması gerekir. Belirttiğiniz hareket çalışmıyorsa reklam yüklemeyi, uygulamanızı yeniden başlatmayı ve hareketi tekrar test etmeyi deneyin.

Programatik olarak başlatma

Reklam inceleyici programatik olarak da başlatılabilir:

Java

MobileAds.openAdInspector(context, new OnAdInspectorClosedListener() {
  public void onAdInspectorClosed(@Nullable AdInspectorError error) {
    // Error will be non-null if ad inspector closed due to an error.
  }
});

Kotlin

MobileAds.openAdInspector(context) { error ->
  // Error will be non-null if ad inspector closed due to an error.
}

Bu API, programatik olarak veya AdMob kullanıcı arayüzünde kaydedilen test cihazlarında çalışır.

Reklam birimlerini görüntüleme ve ilgili sorunları giderme

Başlatıldığında, ana reklam inceleyici ekranı görüntülenir. Bu ekranda, AdMob kullanıcı arayüzündeki AdMob uygulama kimliğinizle ilişkilendirilmiş ve teklifli sistem veya uyumlulaştırma yapılandırmaları olan tüm reklam birimlerinin listesi yer alır.

Reklam inceleyiciyi kullanmadan önce Google Mobile Ads SDK'sını başlatmanızı öneririz.

Bir reklam biriminin uyumlulaştırma şelalesi ayrıntılarını görüntüleme

Bir reklam birimine dokunarak reklam biriminin SDK istek günlüğünü görebilirsiniz. Bu günlük, en son reklam istekleri için reklamın doldurulduğu (veya doluluk olmadan şelalenin sonlandırıldığı) ana kadarki uyumlulaştırma şelalesi ile ilgili ayrıntıları gösterir.

Açıklama göstergesi kullanılarak her istek, söz konusu istek için geçerli olan hata ve gecikmeyle birlikte uyumlulaştırma şelalesinin sonuçlarını gösterecek şekilde genişletilebilir.

Üçüncü taraf reklam kaynakları için hata mesajları doğrudan reklam kaynağından gönderilir. Daha fazla bilgiye ihtiyacınız varsa üçüncü taraf reklam kaynağınıza danışın.

Bir reklam biriminin teklif ayrıntılarını görüntüleme

Ön koşullar: Google Mobile Ads SDK'sı 20.2.0 veya üzeri

Teklif verme konusunda yeniyseniz genel bakış bölümünü okuyun.

SDK istek günlüğünde, reklam isteğinde çağrılan teklifli sistem reklam kaynaklarını görebilirsiniz. Teklifli sistem açık artırmasındaki her reklam kaynağının ayrıntılarını görüntülemek için SDK istek günlüğünde bir reklam birimine dokunun.

Teklifli sistem sonuçları, işlem yapılabilir öğeleri listenin en üstüne yaklaştıracak şekilde sıralanır:

• En üstte, açık artırmayı kazanan reklam ağı gösterilir.

• Sırada sorunlu reklam ağları var. Sorunlarla ilgili sorun giderme adımlarını uygulayabilirsiniz.

• Bunlar arasında, reklam döndürmeyen veya teklif vermemiş reklam ağları bulunur. Bu durum, kurulumu veya karar mekanizması nedeniyle teklif vermemiş olabileceğinden reklam kaynağıyla ilgili birçok farklı soruna işaret edebilir. Reklam kaynağının kurulum kılavuzuna bakabilir veya destek için doğrudan reklam kaynağıyla iletişime geçebilirsiniz.

• Son olarak, listenin en altında teklifli sistem açık artırmasını kaybeden reklam ağları yer alır.

  

Uyumlulaştırma şelalesi, teklifli sistem açık artırmasını kazanan reklam kaynağını eBGBM değerine göre yerleştirebilir.

Bir reklam kaynağı, uyumlulaştırma şelalesinde çağrıldığında reklam yayınlayabilir. Teklifli sistemin uyumlulaştırma şelalesiyle nasıl çalıştığı hakkında daha fazla bilgi edinmek için uyumlulaştırma grubundaki teklifli sistem ve şelale reklam kaynaklarına ait 2. örneği ve 3. örneği inceleyin.

Gelişmiş reklam birimi hata ayıklama

Reklam birimleriyle ilgili sorunları giderirken, nerede sorun olduğunu belirlemek için reklam isteğine ve yanıtına bakmak veya hata ayıklama işlemine yardımcı olması için Google Destek Ekibi ile paylaşmak yararlı olabilir. Reklam isteğinin ve yanıtın tamamını dışa aktarmak için şelale zincirinin üst kısmındaki menü simgesine dokunup Reklam isteğini ve yanıtını paylaş'ı seçin. Böylece kendi uygulamanızda ağ izlemesi yapma zahmetinden kurtulursunuz.

Not: Reklam yanıtını yalnızca test cihazınızı AdMob kullanıcı arayüzüne ekledikten sonra dışa aktarabilirsiniz.

Ayrıca, istek dizesiyle aynı menüde Üçüncü taraf teklifli sistem parametresi seçeneğine dokunarak kodunun çözüldüğü üçüncü taraf teklifli sistem parametrelerini görüntüleyebilirsiniz. Bu rapor, hangi üçüncü taraf teklifli sistem parametrelerinde sorun olabileceğiyle ilgili ayrıntılar sağlar. Böylece uygulamanızda hata ayıklamanıza veya bir ağın sinyallerini başarıyla topladığını doğrulamanıza yardımcı olur.

Kullanılabilir bağdaştırıcıları görüntüle

Uygulamanızdaki teklifli sistem veya uyumlulaştırma yapılandırmalarındaki reklam kaynaklarıyla ilişkili tüm üçüncü taraf bağdaştırıcıların listesini görmek için Bağdaştırıcılar sekmesini tıklayın. Ardından, kartları genişleterek bunların başlatma durumlarını ve SDK sürümlerini görüntüleyin. Desteklenen üçüncü taraf bağdaştırıcıların yanı sıra özel etkinlik bağdaştırıcılarını da görüntüleyebilirsiniz. Özel etkinlikler, yayıncıların AdMob'un desteklemediği reklam ağlarını kullanmasına olanak tanır. Özel etkinlikler, benzersiz sınıf adlarıyla adaptör listesindeki standart üçüncü taraf adaptörlerden ayırt edilebilir. Reklam inceleyici, AdMob web arayüzünde sınıf adı ve durum bilgilerinin yanı sıra bu özel etkinliklere atanan etiketleri de görüntüler.

Bağdaştırıcının bulunamaması veya başlatılmaması durumunda daha fazla bilgi için Reklam inceleyici kullanılarak bulunan sorunları giderme bölümüne bakın.

Not: Özel etkinliklerin daha önce, API v20.0.0 sürümünden önceki uygulamalarda, kullanımdan kaldırılan alt sınıf API'lerinin başlatılmasını desteklemediği ve reklam inceleyicide Sorun bulundu olarak görünmesi. Özel etkinlik entegrasyonunuz çalışıyor gibi görünmesine rağmen bu uyarıyı reklam inceleyicide görürseniz uygulamanızın CustomEventBanner gibi desteği sonlandırılmış arayüzler kullanıp kullanmadığını kontrol edin ve bunları yeni Adapter sınıfıyla değiştirin.

Reklam birimlerinizi test etme

Reklam biriminizi uygulamanızın kullanıcı arayüzünde ilgili birime gitmek zorunda kalmadan test etmek istiyorsanız reklam inceleyici, bunu doğrudan reklam birimi ayrıntıları ekranından destekler. Ayrıca, birden çok reklam birimini aynı anda test edebilir, test reklam isteklerinizi eşzamansız olarak yükleyip görüntüleyebilir ve hatta tek reklam kaynağı testleri yapabilirsiniz.

Önemli: Bu reklam denetleyici testlerinden birini çalıştırdığınızda isteklerinizde, çocuklara yönelik değerlendirme yapılandırması, özel hedefleme, ağ ekstraları, farklı boyutlar ve daha fazlası dahil olmak üzere uygulamanızın kullanıcı arayüzünde tetiklendiğinde içereceği bazı parametreler bulunmaz. Bu isteklerin daha sınırlı olması nedeniyle, mümkün olduğunda uygulamanızın kullanıcı arayüzünü kullanarak test etmenizi öneririz.

Reklam testi

Bu bölümde açıklanan reklam inceleyici reklam testleri, temel reklam deneyiminizi ve tek reklam kaynağı testinde kullanıldığında uyumlulaştırma yapılandırmanızı doğrulamak için mükemmel bir araçtır.

Reklam biriminizi test etmeye hazır olduğunuzda reklam inceleyici reklam testinizi tetiklemek için reklam inceleyici ekranınızın üst kısmındaki Test reklamı iste düğmesine dokunun. Daha sonra test sonuçları, SDK istek günlüğünde Reklam inceleyiciden istendi başlığının altında görünür.

Not: Test reklam iste özelliğini kullanmak için Activity bağlamıyla Google Mobile Ads SDK'sını başlatın.

Uygulamanızda Reklam İnceleyici'yi nasıl kullanacağınızı öğrenin.

Tek reklam kaynağı testi

Reklam inceleyici, uygulamanızdaki reklam isteklerini yalnızca tek bir teklifli sistem veya şelale uyumlulaştırma reklam kaynağından reklam yayınlayacak şekilde kısıtlayan bir özelliğe sahiptir. Böylece üçüncü taraf bağdaştırıcıyı doğru bir şekilde uyguladığınızı ve reklam kaynağının beklendiği gibi reklam sunduğunu doğrulayabilirsiniz.

Bu özelliği etkinleştirmek için ekranın alt kısmındaki Tek reklam kaynağı testi anahtarını açın. Aşağıdaki reklam kaynağı seçimi iletişim kutusu gösterilir:

Tek reklam kaynağı testini kullanabilmeniz için Google Mobile Ads SDK'sını başlatmanız gerekir.

Ardından, test etmek için tek bir reklam kaynağı seçebilirsiniz. Bir reklam kaynağı seçildiğinde aşağıdaki ekran görünür:

Tek reklam kaynağı test ayarı, aynı oturumda gelecekte yapacağınız tüm reklam istekleri için geçerli olur. Ancak söz konusu oturumda daha önce önbelleğe alınmış ve henüz gösterilmemiş reklamlar için geçerli değildir. Seçtiğiniz reklam kaynağının istek alması yerine sunulabilecek önbelleğe alınmış reklamları geçersiz kılmak için tek bir reklam kaynağı testi uygularken uygulamanızı zorla yeniden başlatmanız önerilir.

Uygulamanızı yeniden başlattıktan sonra tüm reklam birimi yerleşimleri yalnızca seçili ağdan reklam göstermeye çalışır. Tek bir reklam kaynağı testi etkinken reklam inceleyici başlatılırken etkin test reklam kaynağı gösterilir:

Tek reklam kaynağı test modunda, reklam kaynağının istenen reklam birimi için teklifli sistem veya uyumlulaştırma amacıyla yapılandırılmış olmasından bağımsız olarak tüm reklam istekleri, seçilen reklam kaynağıyla doldurulmaya çalışılır. Test ettiğiniz reklam kaynağı bir reklam biriminin uyumlulaştırma şelalesinde değilse "Dolgu yok" hata mesajı alırsınız.

Tek reklam kaynağı testinde, bir reklam birimine dokunarak reklam biriminin SDK istek günlüğünü görebilirsiniz. Böylece reklam kaynağının, tek reklam kaynağı testi etkinleştirildikten sonra yapılan reklam isteklerini doldurup doldurmadığını öğrenebilirsiniz. Reklam kaynağı bir reklamı yükleyemediyse hatayı açıklayan bir hata mesajı görüntülenir.

Seçilen reklam kaynağının birden fazla örneğini bir uyumlulaştırma şelalesine eklediyseniz reklam doldurulana veya şelale doldurma olmadan sona erene kadar şelaledeki reklam kaynağına yapılan her çağrı örneğini görürsünüz.

Tek reklam kaynağı testini durdurma

Testi durdurmak için düğmeyi kapalı konuma getirin:

Ardından, aşağıdaki yeniden başlatma ekranında bir onay mesajı görüntülenir:

Test edilen reklam kaynağının önbelleğe alınan reklamlarını geçersiz kılmak için testi durdurduktan sonra uygulamanızı zorla yeniden başlatmanızı öneririz.

Hata ayıklama çıkışlarının tamamını kopyalama

Reklam inceleyici, araçtan AdMob uygulamanızın ayrıntıları, adaptör başlatma durumları ve tüm reklam birimlerinin test sonuçları da dahil olmak üzere hata ayıklama çıkışlarının tamamını içeren bir JSON dizesinin kopyalanmasını destekler.

Bunun için Reklam Denetleyici JSON'u panoya kopyalandı mesajını görene kadar uygulama simgesine yedi kez dokunun.