Reklam inceleyici

Reklam inceleyici, yetkili cihazların test reklam isteklerini doğrudan bir mobil uygulama içinde gerçek zamanlı olarak analiz etmesine olanak tanıyan bir uygulama içi yer paylaşımıdır. Kodlama gerektirmeden etkinleştirilebilir.

Google Mobile Ads Flutter eklentisinin 1.3.0 ve sonraki sürümlerinde şunları yapabilirsiniz:

• Reklam birimlerinizi inceleme
• Üçüncü taraf bağdaştırıcılarınızı inceleme
• Reklamlarınızın beklenen şekilde doldurulup doldurulmadığını kontrol etme
• Hataları belirleme ve hata çözümüyle ilgili ayrıntıları 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 ve 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

• Özel etkinlik entegrasyonlarını test etme

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:

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

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

• Google Mobile Ads Flutter eklentisi 1.3.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şlatma

Reklam inceleyici, uygulamanızın herhangi bir yerinden 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 bu ayarın dağıtılması 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ği göndermesi gerekir. Belirttiğiniz hareket çalışmıyorsa bir 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:

MobileAds.instance.openAdInspector(
  (AdInspectorError? 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, AdMob uygulama kimliğinizle ilişkili AdMob kullanıcı arayüzünde teklifli sistem veya uyumlulaştırma yapılandırmaları olan tüm reklam birimlerinin listesini içeren ana reklam incelemeci ekranı gösterilir:

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üğü görebilirsiniz. Günlük, son reklam istekleri için reklam doldurulana (veya doluluk olmadan şelale sona erene) kadarki uyumlulaştırma şelalesi ayrıntılarını içerir.

Her istek, ilgili istek için geçerli olan hata ve gecikmenin yanı sıra ilgili istek için uyumlulaştırma şelalesinin sonuçlarını göstermek üzere açıklama göstergesi kullanılarak 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

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 üst kısmına getirmek için sıralanır:

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

• Ardından, sorunlu reklam ağları gösterilir. Sorunlarla ilgili sorun giderme adımlarını uygulayabilirsiniz.

• Ardından, reklam döndürmeyen veya teklif vermeyen reklam ağları vardır. 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ılavuzunu inceleyebilir 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 şelalesinde nasıl çalıştığı hakkında daha fazla bilgi edinmek için bir uyumlulaştırma grubundaki teklifli sistem ve şelale reklam kaynaklarıyla ilgili 2. örnek 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ği ve yanıtının tamamını dışa aktarmak için şelale zincirinin üst kısmındaki menü simgesine dokunup Reklam isteğini ve yanıtı 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.

Android

iOS

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

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 denetleyici, sınıf adı ve durum bilgilerinin yanı sıra AdMob web arayüzünde bu özel etkinliklere atanan etiketleri de gösterir.

Adaptör bulunamazsa veya başlatılamazsa daha fazla bilgi için Reklam inceleyici kullanılarak bulunan sorunları giderme başlıklı makaleyi inceleyin.

Android

iOS

Not: API sürüm 20.0.0 (Android) ve 9.0.0 (iOS) öncesindeki, desteği sonlandırılan API'leri alt sınıflandıran özel etkinliklerin önceki uygulamaları, başlatmayı desteklemez ve reklam denetleyicisinde Sorun bulundu olarak görünür. Özel etkinlik entegrasyonunuz çalışıyor gibi görünse bile Reklam İnceleyici'de bu uyarıyı görüyorsanız uygulamanızın CustomEventBanner (Android) | GADCustomEventBanner (iOS) gibi desteği sonlandırılmış arayüzleri kullanıp kullanmadığını kontrol edin ve bunları yeni Adapter (Android) | GADMediationAdapter (iOS) 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 fazla 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 gerçekleştirebilirsiniz.

Ö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, tek reklam kaynağı testiyle birlikte kullanıldığında temel reklam deneyiminizi doğrulamak ve 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. Test sonuçları, Reklam denetçisinden istendi başlığının altındaki SDK istek günlüğünde görünür.

Uygulamanızda reklam inceleyiciyi 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. Bu işlem, aşağıdaki reklam kaynağı seçim iletişim kutusunu görüntüler:

Android

iOS

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ğı testi ayarı, aynı oturumda yapacağınız gelecekteki tüm reklam istekleri için geçerlidir. Ancak bu durum, oturumda daha önce önbelleğe alınmış ancak henüz gösterilmemiş reklamlar için geçerli değildir. Tek reklam kaynağı testi uygularken, seçtiğiniz reklam kaynağının istek alması yerine yayınlanabilecek önbelleğe alınmış reklamları geçersiz kılmak için 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 reklam kaynağı testi etkinken reklam inceleyiciyi başlattığınızda etkin test reklam kaynağı gösterilir:

Tek reklam kaynağı test modunda tüm reklam istekleri, söz konusu reklam kaynağının istenen reklam birimi için teklifli sistem veya uyumlulaştırma için yapılandırılıp yapılandırılmadığına bakılmaksızın seçili 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österilir.

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

Tek reklam kaynağı testini durdurma

Testi durdurmak için anahtarı kapalı konuma getirin:

Ardından, aşağıdaki yeniden başlatma ekranında bir onay mesajı gösterilir:

Testi durdurduktan sonra, test edilen reklam kaynağıyla ilgili önbelleğe alınmış tüm reklamları geçersiz kılmak için uygulamanızı zorla yeniden başlatmanızı öneririz.

Gizlilik ayarlarında hata ayıklama

Ön koşullar: Google Mobile Ads Flutter eklentisi 2.1.0 veya daha sonraki bir sürüm

IAB Europe TCF ile yayıncı entegrasyonu kapsamında reklam isteğinde iletilen aşağıdaki gizlilik sinyallerini görüntülemek için reklam inceleyiciyi kullanabilirsiniz:

• GDPR geçerlidir (IABTCF_gdprApplies)
• Eİ dizesi (IABTCF_AddtlConsent)
• TC dizesi (IABTCF_TCString)

Reklam inceleyicide bir reklam yükledikten veya reklam testi yaptıktan sonra SDK istek günlüğü altındaki istekteki menü simgesine dokunun. Ardından Gizlilik sinyalleri seçeneğini belirleyin.

Gizlilik sinyalleri ekranında, reklam isteğinde iletilen gizlilik sinyalleri gösterilir.

AC dizesi hakkında daha fazla bilgi edinmek için Google'ın Ek İzin için teknik spesifikasyonunu inceleyin. TC dizesindeki ayrıntılı kullanıcı rızası ayrıntılarını (ör. CMP kimliği ve IAB ile ilişkili izin verilen tedarikçi kimlikleri listesi) görüntülemek için Kod çöz'ü tıklayarak IAB GPP Kodlayıcı / Kod Çözücü'yü açın.

Hatayla karşılaşırsanız Gizlilik sorunlarını anlama başlıklı makaledeki adımları uygulayarak sorunu giderin.

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

Reklam denetleyici, AdMob uygulamanızın ayrıntıları, bağdaştırıcının başlatma durumları ve tüm reklam birimlerinin test sonuçları da dahil olmak üzere araçtaki 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.