Bu kılavuzda, reklam inceleyici'deki farklı özelliklerin nasıl başlatılacağı ve kullanılacağı gösterilmektedir.
Ön koşullar
Reklam inceleyiciyi kullanmak için:
- Başlangıç kılavuzunu tamamlayın.
- Google Mobile Ads SDK'sının 9.1.0 veya daha yeni bir sürümünü 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 şekillerde başlatılabilir:
- Test cihazı kaydederken AdMob kullanıcı arayüzünde seçilen hareketi kullanın.
- Sağlanan API kullanılarak programatik olarak.
- Hata ayıklama menüsündeki başlatma 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. Yalnızca AdMob'da bu test cihazı için yapılandırdığınız hareketi (çift çevirme veya sallama) yapmanız yeterlidir. Daha fazla bilgi
AdMob kullanıcı arayüzünde bir hareket ayarladıktan (ve bu hareketin yayılması için 15 dakika bekledikten) sonra, uygulamanızın Google Mobile Ads SDK'sının hareket ayarınızı öğrenmesi için bir 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:
Bu API, programatik olarak veya AdMob kullanıcı arayüzünde kaydedilen test cihazlarında çalışır.
Reklam birimlerini görüntüleme ve sorunlarını giderme
Başlatıldıktan sonra, AdMob kullanıcı arayüzünde AdMob uygulama kimliğinizle ilişkili olan ve teklifli sistem ya da uyumlulaştırma yapılandırmaları içeren tüm reklam birimlerinin listesini içeren ana reklam inceleyici ekranı görünür:
Reklam inceleyiciyi kullanmadan önce Google Mobile Ads SDK'sını başlatmanızı öneririz.
Bir reklam birimi için 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 doldurulana kadar (veya doluluk olmadan şelale sona erene kadar) uyumlulaştırma şelalesiyle ilgili ayrıntılar sağlar.
Her istek, açıklama göstergesi kullanılarak genişletilebilir. Böylece, bu istekle ilgili uyumlulaştırma şelalesi sonuçları, bu istek için geçerli olan tüm hata ve gecikme süreleriyle birlikte gösterilir.
Üçü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 vermede 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ı, üzerinde işlem yapılabilecek öğeleri listenin üst kısmına yakınlaştırmak için sıralanır:
En üstte, açık artırmayı kazanan reklam ağı yer alır.
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ı gelir. Bu durum, reklam kaynağının kurulumu veya karar mekanizması nedeniyle teklif vermemiş olabileceğinden, reklam kaynağıyla ilgili birçok farklı soruna işaret edebilecek bir gösterge olabilir. Reklam kaynağının kurulum kılavuzuna başvurabilir 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 çalışma şekli hakkında daha fazla bilgi edinmek için uyumlulaştırma grubundaki teklifli sistem ve şelale reklam kaynaklarının 2. örneğini ve 3. örneğini inceleyin.
Gelişmiş reklam birimi hata ayıklama
Reklam birimlerinde sorun giderirken bir şeyin nerede başarısız olduğunu belirlemek için reklam isteği ve yanıtını incelemek veya hata ayıklamaya yardımcı olması için Google Destek Ekibi ile paylaşmak faydalı olabilir. Şelale zincirinin üst kısmındaki menü simgesine dokunun ve tam reklam isteğini ve yanıtını dışa aktarmak için Reklam isteğini ve yanıtı paylaş'ı seçin. Bu sayede, kendi uygulamanızda ağ izlemeleri çalıştırmanız gerekmez.
Ayrıca, istek dizesiyle aynı menüde Üçüncü taraf teklifli sistem parametresi seçeneğine dokunarak kod çözümü yapılmış üçüncü taraf teklifli sistem parametrelerini görüntüleyebilirsiniz. Bu, hangi üçüncü taraf teklifli sistem parametrelerinin sorun yaşayabileceği hakkında ayrıntılar sunarak 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ü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, başlatma durumlarını ve SDK sürümlerini görüntülemek için kartları genişletin. 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, bağdaştırıcı listesinde benzersiz sınıf adlarıyla standart üçüncü taraf bağdaştırıcılarından ayırt edilebilir. Reklam inceleyici, sınıf adı ve durum bilgilerini sağlamanın 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.
Reklam birimlerinizi test etme
Reklam biriminizi uygulamanızın kullanıcı arayüzünde 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.
Reklam testi
Bu bölümde özetlenen 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ı onaylamak için harika 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ı, SDK istek günlüğünde Reklam inceleyiciden istendi başlığının altında gösterilir.
Tek reklam kaynağı testi
Reklam inceleyicide, uygulamanızdaki reklam isteklerini yalnızca tek bir teklifli sistem veya şelale uyumlulaştırma reklam kaynağından reklam yayınlayacak şekilde kısıtlamanıza olanak tanıyan bir özellik bulunur. Böylece üçüncü taraf bağdaştırıcısını düzgün 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 önce Google Mobile Ads SDK'sını başlatmanız gerekir.
Ardından, test edilecek tek bir reklam kaynağı seçebilirsiniz. Bir reklam kaynağı seçildikten sonra aşağıdaki ekran görünür:
Tek reklam kaynağı testi ayarı, aynı oturumda yaptığınız tüm gelecekteki reklam istekleri için geçerlidir. Ancak bu durum, söz konusu oturumda daha önce önbelleğe alınmış ve henüz gösterilmemiş reklamlar için geçerli değildir. Uygulamanızı zorla yeniden başlatmanız, tek reklam kaynağı testi uygularken önerilir. Bu sayede, istek alan seçtiğiniz reklam kaynağı yerine yayınlanabilecek önbelleğe alınmış reklamlar geçersiz kılınır.
Uygulamanızı yeniden başlattıktan sonra tüm reklam birimi yerleşimleri yalnızca seçili ağdan bir reklam göstermeye çalışır. Tek reklam kaynağı testi etkin olduğunda reklam inceleyiciyi başlatmak, etkin test reklam kaynağını gösterir:
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ı gösterilir.
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ükleyemezse 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 bir 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ünür:
Testi durdurduktan sonra, test edilen reklam kaynağı için önbelleğe alınmış reklamları geçersiz kılmak amacıyla uygulamanızı zorla yeniden başlatmanızı öneririz.
Gizlilik ayarlarında hata ayıklama
Ön koşullar: Google Mobile Ads SDK'sı 9.6.0 veya daha yeni 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 yükledikten veya reklam inceleyicide reklam testi gerçekleştirdikten sonra SDK istek günlüğü bölümündeki isteğin menü simgesine dokunun. Ardından, Gizlilik sinyalleri seçeneğini belirleyin.
Gizlilik sinyalleri ekranında, reklam isteğinde iletilen gizlilik sinyalleri gösterilir.
Eİ dizesi hakkında daha fazla bilgi edinmek için Google'ın Ek İzin için teknik spesifikasyonuna bakın. TC dizesindeki ayrıntılı izin bilgilerini (ör. CMP kimliği ve IAB ile ilişkili izin verilen satıcı tanımlayıcılarının listesi) görüntülemek için Decode'u (Kod Çöz) tıklayarak IAB GPP Encoder / Decoder'ı (IAB GPP Kodlayıcı/Kod Çözücü) açın.
Hata ile karşılaşırsanız sorun giderme için Gizlilik sorunlarını anlama başlıklı makaledeki adımları uygulayın.
Tüm hata ayıklama çıkışlarını kopyalama
Reklam inceleyici, AdMob uygulamanızın ayrıntıları, bağdaştırıcı başlatma durumları ve tüm reklam birimlerinin test sonuçları da dahil olmak üzere, araçtan tüm hata ayıklama çıkışlarını içeren bir JSON dizesinin kopyalanmasını destekler.
Bunu yapmak için Copied ad inspector JSON to clipboard (Reklam inceleyici JSON'u panoya kopyalandı) mesajını görene kadar uygulama simgesine yedi kez dokunun.