Meta Audience Network'ü teklifli sistemle entegre etme

Daha fazla bilgi için Meta'nın duyurusuna göz atın.

Bu kılavuzda, teklifli sistem entegrasyonlarını kapsayan uyumlulaştırma özelliğini kullanarak 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. Flutter

Desteklenen entegrasyonlar ve reklam biçimleri

Meta Audience Network Ad Manager 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ı

¹ Meta Audience Network, 2021'de yalnızca teklif verme olarak değişti.

Şartlar

• En son Google Mobile Ads SDK'sı
• Flutter 3.7.0 veya üzeri
• Android'de dağıtmak için
  • Android API düzeyi 21 veya sonraki sürümler
• iOS'te dağıtmak 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şlayın 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 kazanacağınız platformu 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 doldurun ve ardından Sonraki'yi tıklayın.

Uyumlulaştırma platformu olarak Google AdMob'u seçin ve ardından Yerleşim oluştur'u tıklayın.

Bir biçim seçin, formu doldurun ve Oluştur'u tıklayın.

Not: Meta Audience Network'in Banner biçimi, orta dikdörtgen görüntü biçimini ve 50, 90 veya 250 yüksekliğindeki esnek genişlikli banner'ları destekler.

Yerleşim kimliğini not edin.

Bitti'yi tıklayın.

Test modunu etkinleştirme

Meta Audience Network test reklamlarını etkinleştirmeyle ilgili ayrıntılı talimatlar için Audience Network Uygulamasını Test Etme kılavuzuna bakın.

2. adım: Meta Kitle Ağı talebini Ad Manager kullanıcı arayüzünde ayarlayın

Reklam biriminiz için uyumlulaştırma ayarlarını yapılandırma

Yapay Zeka

Talimatlar için Android.

iOS

Talimatlar için iOS.

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

Not: Uyumlu Meta Audience Network ve Google Mobile Ads SDK sürümlerinin entegre edilmemesi derleme sorunlarına neden olabilir.

pub.dev üzerinden entegrasyon

Paketinizin pubspec.yaml dosyasına, SDK ve bağdaştırıcının en son sürümleriyle birlikte aşağıdaki bağımlılığı ekleyin:Meta Audience Network

dependencies:
  gma_mediation_meta: ^1.0.0

Manuel Entegrasyon

Meta Audience Network için Google Mobil Reklamlar uyumlulaştırma eklentisinin en son sürümünü indirin, indirilen dosyayı ayıklayın ve ayıklanan eklenti klasörünü (ve içeriğini) 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, Avrupa Ekonomik Alanı (AEA)'ndaki kullanıcılara cihaz tanımlayıcıları ve kişisel verilerin kullanımıyla ilgili 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) şartlarını yansıtmaktadır. İzin alırken, uyumlulaştırma zincirinizde kişisel veri toplayabilecek, alabilecek veya kullanabilecek her reklam ağını tanımlamanız ve her ağın kullanımı hakkında bilgi vermeniz gerekir. 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 edinmek için Meta'nın kılavuzunu inceleyin.

ABD eyalet gizlilik yasaları

ABD eyalet gizlilik yasaları kullanıcılara, kişisel bilgilerinin "satışının" (bu terimlerin yasalardaki tanımına uygun şekilde) kapsamı dışında kalma seçeneği sunmayı zorunlu kılar. 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 bir sürüm 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ştirme

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.

Önemli Nokta: Test yaparken test cihazında Facebook uygulamasının yüklü olduğundan ve geçerli bir Facebook girişiyle giriş yaptığınızdan emin olun. Daha fazla ayrıntı için Meta'nın belgelerine göz atın.

Önemli: Uygulamanızı yayınlamadan önce AdMob ve Meta Audience Network için test modunu devre dışı bırakın.

Test reklamlarını doğrulama

Meta Audience Network'ten test reklamları aldığınızı doğrulamak için Meta Audience Network (Teklifli Sistem) 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'dan (API düzeyi 28) itibaren net metin desteği varsayılan olarak devre dışıdır. Bu durum, Meta Audience Network SDK'sının medya önbelleğe alma işlevini etkileyecek ve 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 Audience Network 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 bulunmamıştır.
106	Yüklenen yerel reklam, beklenen nesneden farklı.
107	Kullanılan Context nesnesi geçersiz.
108	Yüklenen reklamda gerekli doğal reklam öğeleri eksik.
109	Teklif yükü kullanılarak yerel reklam oluşturulamadı.
110	Meta Audience Network SDK'sı geçiş reklamını/ödüllü reklamı gösteremedi.
111	Meta Audience Network AdView nesnesi oluşturulurken istisna atıldı.
1000-9999	Meta Audience Network, SDK'ya özgü bir hata döndürmüştür. 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 Audience Network 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ş reklamını/ödüllü reklamı 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 özgü bir hata döndürmüştür. 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ü ile oluşturulup 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 adaptörünün 6.17.0.0 sürümüyle uyumluluğu doğrulandı
• Meta iOS adaptörü 6.15.0.0 sürümü ile uyumluluğu 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 adaptörü 6.15.0.0 sürümü ile uyumluluğu doğrulandı
• Google Mobile Ads Flutter eklentisi 5.0.0 sürümü ile oluşturulup test edilmiştir.