Bu kılavuzda, teklif entegrasyonlarını kapsayan uyumlulaştırma aracılığıyla Meta Audience Network'ten reklam yüklemek ve görüntülemek için Google Mobile Ads SDK'sının nasıl kullanılacağı gösterilmektedir. Meta Audience Network'in bir reklam biriminin uyumlulaştırma yapılandırmasına nasıl ekleneceğini ve Meta Audience Network ile bağdaştırıcının bir uygulamaya nasıl entegre edileceğini kapsar.
Desteklenen entegrasyonlar ve reklam biçimleri
Meta Audience Network AdMob için uyumlulaştırma bağdaştırıcısı aşağıdaki özelliklere sahiptir:
| Entegrasyon | |
|---|---|
| Teklif verme | |
| Şelale 1 | |
| Formatlar | |
| Banner | |
| Geçiş reklamı | |
| Ödüllü | |
| Ödüllü geçiş reklamı | |
1 Meta Audience Network, 2021'de yalnızca teklifli sistem olarak kullanıma sunuldu.
Şartlar
- En son Google Mobile Ads SDK'sı
- Flutter 3.7.0 veya sonraki sürümler
- Android'de dağıtım yapmak için
- Android API düzeyi 21 veya üstü
- iOS'te dağıtım yapmak için
- 10.0 veya sonraki bir iOS dağıtım hedefi
- En son Meta Audience Network SDK'sı genellikle Xcode'un en son sürümünü gerektirir.
- Google Mobile Ads SDK'sı ile yapılandırılmış Flutter çalışan bir proje. Ayrıntılar için Başlarken bölümüne bakın.
- Uyumlulaştırma Başlangıç kılavuzunu tamamlayın.
1. adım: Meta Audience Network kullanıcı arayüzünde yapılandırmaları ayarlayın
Kaydolup İşletme Yöneticisi Başlangıç sayfasına giriş yapın.
Başlayın'ı ve ardından Yeni hesap oluştur'u tıklayın.
Zorunlu alanları işletme ayrıntılarınızla doldurun ve İleri'yi tıklayın.
Bir mülk oluşturun
Gerekli bilgileri doldurduktan sonra uygulamanız için bir mülk oluşturmanız istenir. Uygulamanız için mülkün istediğiniz adını girin ve İleri'yi tıklayın.
Ardından para kazanmak için platformunuzu seçin.
Uygulama ayrıntılarınızı ekleyin ve İleri'yi tıklayın.
Yapay Zeka
iOS
Yeni ödeme hesabı ekle'yi tıklayarak ödeme hesabınızı oluşturun. Ödeme bilgilerinizi girmeniz için yeni bir sayfaya yönlendirilirsiniz. Gerekli bilgileri girip İleri'yi tıklayın.
Uyumlulaştırma platformu olarak Google AdMob'u seçin, ardından Yerleşim oluştur'u tıklayın.
Biçim seçin, formu doldurun ve Oluştur'u tıklayın.
Yerleşim kimliğini not edin.
Bitti'yi tıklayın.
Test modunu etkinleştirme
Meta Audience Network test reklamlarını nasıl etkinleştireceğinizle ilgili ayrıntılı talimatlar için Kitle Ağı Uygulama Kılavuzunu Test Etme kılavuzuna bakın.
2. adım: Meta Kitle Ağı talebini AdMob kullanıcı arayüzünde ayarlayın
Reklam biriminiz için uyumlulaştırma ayarlarını yapılandırma
Android
Talimatlar için Android kılavuzunun 2. adımına bakın.
iOS
Talimatlar için iOS rehberinin 2. adımına göz atın.
Facebook 'i GDPR ve ABD eyalet düzenlemeleri reklam iş ortakları listesine ekleme
AdMob kullanıcı arayüzündeki GDPR ve ABD eyalet düzenlemeleri reklam iş ortakları listesine Meta'yı eklemek için GDPR ayarlarındaki ve ABD eyalet düzenlemeleri ayarlarındaki adımları uygulayın.
3. Adım: Meta Audience Network SDK'sını ve bağdaştırıcısını içe aktarın
pub.dev aracılığıyla entegrasyon
Aşağıdaki bağımlılığı
Meta Audience Network Paketinizdeki SDK ve bağdaştırıcı
pubspec.yaml dosyası:
dependencies:
gma_mediation_meta: ^1.0.0
Manuel Entegrasyon
Şu hesap için Google Mobile Ads uyumlulaştırma eklentisinin en son sürümünü indirin:
Meta Audience Network,
indirilen dosyayı çıkarın ve ayıklanan eklenti klasörünü ekleyin.
(ve içeriklerini) Flutter projenize ekleyin. Ardından, aşağıdaki bağımlılığı ekleyerek pubspec.yaml dosyanızdaki eklentiye referans verin:
dependencies:
gma_mediation_meta:
path: path/to/local/package
4. Adım: Meta Audience Network SDK'sına gizlilik ayarlarını uygulayın
AB kullanıcı rızası ve GDPR
Google AB Kullanıcı Rızası Politikası uyarınca, cihaz tanımlayıcıları ve kişisel verilerin kullanımıyla ilgili olarak Avrupa Ekonomik Alanı (AEA)'daki kullanıcılara belirli açıklamaların yapılmasını ve izinlerin alınmasını sağlamanız gerekir. Bu politika AB eGizlilik Yönergesi ve Genel Veri Koruma Yönetmeliği (GDPR) gereksinimlerini yansıtmaktadır. İzin isterken uyumlulaştırma zincirinizde kişisel verileri toplayabilecek, alabilecek veya kullanabilecek tüm reklam ağlarını tanımlamalı ve her bir ağın kullanımı hakkında bilgi sağlamalısınız. Google şu anda kullanıcının izin seçimini bu tür ağlara otomatik olarak iletememektedir.
GDPR ve Meta reklamcılığı hakkında bilgi için Meta'nın rehberliğini inceleyin.
ABD eyalet gizlilik yasaları
ABD eyalet gizlilik yasaları kullanıcılara, kişisel bilgilerinin "satışının" (bu terimlerin yasalardaki tanımlarına uygun şekilde) kapsamı dışında kalma seçeneği sunmayı zorunlu kılıyor. Kapsam dışında kalma seçeneği, "satan" tarafın ana sayfasında belirgin bir şekilde görünen "Kişisel Bilgilerimi Kesinlikle Satmayın" gibi bir bağlantıyla sunulur. ABD eyalet gizlilik yasaları uygunluk kılavuzu, Google reklam sunumu için kısıtlanmış veri işlemeyi etkinleştirme olanağı sunar ancak Google bu ayarı uyumlulaştırma zincirinizdeki her reklam ağına uygulayamaz. Bu nedenle, uyumlulaştırma zincirinizde kişisel bilgilerin satışına katılabilir her reklam ağını tanımlamanız ve uyumluluğu sağlamak için bu ağların her birinin talimatlarını uygulamanız gerekir.
Kaliforniya'daki kullanıcılar için Meta'nın veri işleme seçeneklerini inceleyin.
5. Adım: Gerekli kodu ekleyin
Yapay Zeka
Meta Audience Network entegrasyonu için ek kod gerekmez.
iOS
SKAdNetwork entegrasyonu
SKAdNetwork tanımlayıcılarını projenizin Info.plist dosyasına eklemek için Meta Audience Network'in dokümanlarını inceleyin.
Reklam izleme etkin
iOS 14 veya sonraki sürümler için uygulama geliştiriyorsanız Meta Audience Network'in Reklam İzleme İşareti'ni ayarlama talimatlarını inceleyin.
6. adım: Uygulamanızı test edin
Test reklamlarını etkinleştir
AdMob için test cihazınızı kaydettiğinizden ve Meta Audience Network kullanıcı arayüzünde test modunu etkinleştirdiğinizden emin olun.
Test reklamlarını doğrulama
Meta Audience Networkreklam kaynağından test reklamları aldığınızı doğrulamak için Meta Audience Network (Bidding) reklam kaynaklarını kullanarak reklam inceleyicide tek reklam kaynağı testini etkinleştirin.
İsteğe bağlı adımlar
Android 9'da önbelleğe alma
Yapay Zeka
Android 9 (API düzeyi 28) sürümünden itibaren, cleartext desteği varsayılan olarak devre dışıdır. Bu durum, Meta Audience Network SDK'sının medya önbelleğe alma işlevini etkileyecektir. Ayrıca, kullanıcı deneyimini ve reklam gelirini etkileyebilir. Uygulamanızdaki ağ güvenliği yapılandırmasını güncellemek için Meta'nın dokümanlarını inceleyin.
iOS
iOS entegrasyonları için geçerli değildir.
Hata kodları
Adaptör Kitle Ağı'ndan reklam alamıyorsa aşağıdaki sınıflar altında ResponseInfo kullanarak reklam yanıtındaki temel hatayı kontrol edebilirsiniz:
Yapay Zeka
com.google.ads.mediation.facebook.FacebookAdapter
com.google.ads.mediation.facebook.FacebookMediationAdapter
iOS
GADMAdapterFacebook
GADMediationAdapterFacebook
Bir reklam yüklenemezse Meta Audience Network bağdaştırıcısı tarafından oluşturulan kodlar ve bunlarla birlikte gönderilen mesajlar aşağıda verilmiştir:
Yapay Zeka
| Hata kodu | Neden |
|---|---|
| 101 | Geçersiz sunucu parametreleri (ör. yerleşim kimliği eksik). |
| 102 | İstenen reklam boyutu, Meta Kitle Ağı tarafından desteklenen bir banner boyutuyla eşleşmiyor. |
| 103 | Yayıncı, Activity bağlamına sahip reklamları istemelidir. |
| 104 | Meta Audience Network SDK'sı başlatılamadı. |
| 105 | Yayıncı, birleşik doğal reklam isteğinde bulunmadı. |
| 106 | Yüklenen yerel reklam, beklenenden farklı bir nesne. |
| 107 | Kullanılan Context nesnesi geçersiz. |
| 108 | Yüklenen reklamda gerekli yerel reklam öğeleri eksik. |
| 109 | Teklif yükünden doğal reklam oluşturulamadı. |
| 110 | Meta Audience Network SDK'sı, geçiş/ödüllü reklamını gösteremedi. |
| 111 | Meta Audience Network AdView nesnesi oluşturulurken istisna atıldı. |
| 1000-9999 | Meta Audience Network, SDK'ya özel bir hata döndürdü. Daha fazla bilgi için Meta Audience Network'in dokümanlarını inceleyin. |
iOS
| Hata kodu | Neden |
|---|---|
| 101 | Geçersiz sunucu parametreleri (ör. yerleşim kimliği eksik). |
| 102 | İstenen reklam boyutu, Meta Kitle Ağı tarafından desteklenen bir banner boyutuyla eşleşmiyor. |
| 103 | Meta Audience Network reklam nesnesi başlatılamadı. |
| 104 | Meta Audience Network SDK'sı, geçiş/ödüllü reklamını gösteremedi. |
| 105 | Banner reklamın kök görüntü kontrolörü nil. |
| 106 | Meta Audience Network SDK'sı başlatılamadı. |
| 1000-9999 | Meta Audience Network, SDK'ya özel bir hata döndürdü. Daha fazla bilgi için Meta Audience Network'in dokümanlarını inceleyin. |
Meta Audience Network Flutter Uyumlulaştırma Bağdaştırıcısı Değişiklik Günlüğü
Sonraki Sürüm
- Google Mobile Ads Flutter eklentisi 5.2.0 sürümü ile oluşturulup test edilmiştir.
1.1.0
- Meta Android adaptörünün 6.17.0.0 sürümüyle uyumluluğu doğrulandı
- Meta iOS adaptörünün 6.15.2.0 sürümüyle uyumluluğu doğrulandı
- Google Mobile Ads Flutter eklentisi 5.1.0 sürümüyle geliştirilip test edilmiştir.
1.0.1
- Barındırma platformlarıyla doğru uyumluluk analizine izin vermek için dart sınıfı eklendi
- Meta Android bağdaştırıcısı sürüm 6.17.0.0 ile uyumluluk doğrulandı
- Meta iOS bağdaştırıcısı sürüm 6.15.0.0 ile uyumluluk doğrulandı
- Google Mobile Ads Flutter eklentisi 5.1.0 sürümü ile oluşturulup test edilmiştir.
1.0.0
- İlk sürüm.
- Meta Android adaptörünün 6.17.0.0 sürümüyle uyumluluğu doğrulandı
- Meta iOS bağdaştırıcısı sürüm 6.15.0.0 ile uyumluluk doğrulandı
- Google Mobile Ads Flutter eklentisi 5.0.0 sürümü ile oluşturulup test edilmiştir.