Meta Audience Network'ü teklifli sistemle entegre etme

Bu kılavuzda, teklif verme entegrasyonlarını kapsayan uyumlulaştırma kullanarak Meta Audience Network'ten reklamları yüklemek ve göstermek için Google Mobile Ads SDK'sını nasıl kullanacağınız açıklanmaktadır. Meta Audience Network'ü bir reklam biriminin aracılık yapılandırmasına ekleme ve Meta Audience Network ile bağdaştırıcıyı bir Flutter uygulamasına entegre etme konularını kapsar.

Desteklenen entegrasyonlar ve reklam biçimleri

Meta Audience Network için AdMob 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 teklif verme modeline geçti.

Şartlar

  • En yeni Google Mobile Ads SDK'sı
  • Flutter 3.7.0 veya sonraki sürümler
  • Android'de dağıtmak için
    • Android API düzeyi 23 veya üstü
  • iOS'te dağıtmak için
    • iOS 10.0 veya sonraki bir sürümün dağıtım hedefi
    • En yeni Meta Audience Network SDK'sı genellikle Xcode'un en yeni sürümünü gerektirir.
  • Google Mobile Ads SDK'sı ile yapılandırılmış çalışan bir Flutter projesi. Ayrıntılar için Başlangıç bölümüne bakın.
  • Uyumlulaştırma Başlangıç Kılavuzu'nu tamamlayın.

1. adım: Meta Audience Network kullanıcı arayüzünde yapılandırmaları ayarlayın

İşletme Yöneticisi Başlangıç Sayfası'na kaydolun ve giriş yapın.

Başlayın'ı ve ardından Yeni hesap oluştur'u tıklayın.

Zorunlu alanları işletme bilgilerinizle doldurun ve Sonraki'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 istediğiniz mülk adını girin ve Sonraki'yi tıklayın.

Ardından, para kazanmak için platformunuzu seçin.

Uygulama ayrıntılarınızı ekleyin ve Sonraki'yi tıklayın.

Android

iOS

Yeni ödeme hesabı ekle'yi tıklayarak ödeme hesabınızı oluşturun. Ödeme bilgilerinizi girmek için yeni bir sayfaya yönlendirilirsiniz. Gerekli bilgileri doldurun ve Sonraki'yi tıklayın.

Aracılık platformu olarak Google AdMob'u seçin ve Yerleşim oluştur'u tıklayın.

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

Yerleşim kimliğini not edin.

Bitti'yi tıklayın.

app-ads.txt dosyanızı güncelleme

Uygulamalar İçin Yetkili Satıcılar app-ads.txt, uygulama reklamı envanterinizin yalnızca yetkili olarak tanımladığınız kanallar üzerinden satılmasını sağlamaya yardımcı olan bir IAB Tech Lab girişimidir. Reklam gelirinde önemli ölçüde kayıp yaşanmasını önlemek için bir app-ads.txt dosyası uygulamanız gerekir. Henüz yapmadıysanız uygulamanız için bir app-ads.txt dosyası oluşturun.

Meta Audience Network için app-ads.txt'yı uygulamak üzere app-ads.txt ile yetkili satıcıları belirleme başlıklı makaleyi inceleyin.

Test modunu etkinleştirme

Meta Audience Network test reklamlarını etkinleştirme hakkında ayrıntılı talimatlar için Audience Network Uygulamasını Test Etme Rehberi'ne bakın.

2. adım: AdMob kullanıcı arayüzünde Meta Audience Network talebini ayarlayın

Reklam biriminiz için aracılık ayarlarını yapılandırma

Android

Talimatlar için Android kılavuzundaki 2. adıma bakın.

iOS

Talimatlar için iOS kılavuzundaki 2. adıma bakın.

Meta'yı GDPR ve ABD eyalet yönetmelikleri reklam iş ortakları listesine ekleme

AdMob kullanıcı arayüzünde Meta'yı AB ve ABD eyalet tüzükleri reklam iş ortakları listesine eklemek için AB tüzükleri ayarları ve ABD eyalet tüzükleri ayarları bölümlerindeki 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 üzerinden entegrasyon

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

dependencies:
  gma_mediation_meta: ^

Manuel Entegrasyon

Meta Audience Network için Google Mobil Reklamlar uyumlulaştırma eklentisinin en son sürümünü indirin, indirilen dosyayı çıkarın ve çıkarılan eklenti klasörünü (ve içeriğini) Flutter projenize ekleyin. Ardından, aşağıdaki bağımlılığı ekleyerek pubspec.yaml dosyanızda eklentiye referans verin:

dependencies:
  gma_mediation_meta:
    path: path/to/local/package

4. adım: Meta Audience Network SDK'sında gizlilik ayarlarını uygulayın

Google AB Kullanıcı Rızası Politikası uyarınca, Avrupa Ekonomik Alanı'ndaki (AEA) kullanıcılara cihaz tanımlayıcılarının ve kişisel verilerin kullanımıyla ilgili belirli açıklamaların yapıldığından ve bu kullanıcılardan izin alındığından emin olmanız gerekir. Bu politika, AB eGizlilik Yönergesi ve Genel Veri Koruma Yönetmeliği (GDPR) şartlarını yansıtmaktadır. İzin isterken uyumlulaştırma zincirinizdeki kişisel verileri toplayabilen, alabilen veya kullanabilen 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 rehberini inceleyin.

ABD eyalet gizlilik yasaları

ABD eyaletlerindeki gizlilik yasaları, kullanıcılara "kişisel bilgilerinin" "satışının" (yasaların bu terimleri tanımladığı biçimiyle) kapsamı dışında kalma hakkı tanınmasını zorunlu kılar. Kapsam dışında kalma seçeneği, "satan" tarafın ana sayfasında belirgin bir şekilde gösterilen "Kişisel Bilgilerimi Satma" bağlantısıyla sunulur. ABD eyalet gizlilik yasalarına uygunluk rehberi, Google reklam sunma 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, uyumluluğu sağlamak için uyumlulaştırma zincirinizde kişisel bilgilerin satışına katılabilecek her reklam ağını tanımlamanız ve bu ağların her birinden gelen yönergeleri 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

Android

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'ün dokümanlarını inceleyin.

Reklam izleme etkin

iOS 14 veya sonraki sürümler için geliştirme yapıyorsanız Meta Audience Network'ün Advertising Tracking Flag'i nasıl ayarlayacağınızla ilgili 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.

Test reklamlarını doğrulama

Meta Audience Network'ten test reklamları aldığınızı doğrulamak için reklam inceleyicide Meta Audience Network (Teklifli Sistem) reklam kaynaklarını kullanarak tek reklam kaynağı testini etkinleştirin.

İsteğe bağlı adımlar

Android 9'da önbelleğe alma

Android

Android 9 (API düzeyi 28) sürümünden itibaren düz metin desteği varsayılan olarak devre dışı bırakılır. Bu durum, Meta Audience Network SDK'sının medya önbelleğe alma işlevini etkiler ve kullanıcı deneyiminin yanı sıra reklam gelirini de 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:

Android

com.google.ads.mediation.facebook.FacebookAdapter
com.google.ads.mediation.facebook.FacebookMediationAdapter

iOS

GADMAdapterFacebook
GADMediationAdapterFacebook

Bir reklam yüklenemediğinde Meta Audience Network bağdaştırıcısı tarafından oluşturulan kodlar ve ilgili mesajlar aşağıda verilmiştir:

Android

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ında reklam isteğinde bulunmalıdır.
104 Meta Audience Network SDK'sı başlatılamadı.
105 Yayıncı, birleştirilmiş yerel reklamlar için istekte 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 yerel reklam oluşturulamadı.
110 Meta Audience Network SDK, geçiş reklamını/ödüllü reklamını sunamadı.
111 Meta Audience Network AdView nesnesi oluşturulurken istisna oluştu.
1000-9999 Meta Audience Network, SDK'ya özgü bir hata döndürdü. Daha fazla bilgi için Meta Audience Network'ün belgelerini 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, geçiş reklamını/ödüllü reklamını sunamadı.
105 Banner reklamın kök görünüm denetleyicisi nil.
106 Meta Audience Network SDK'sı başlatılamadı.
1000-9999 Meta Audience Network, SDK'ya özgü bir hata döndürdü. Daha fazla bilgi için Meta Audience Network'ün belgelerini inceleyin.

Meta Audience Network Flutter Uyumlulaştırma Bağdaştırıcısı Değişiklik Günlüğü

Sürüm 1.4.0

Sürüm 1.3.0

Sürüm 1.2.0

Sürüm 1.1.0

Sürüm 1.0.1

  • Ana makine platformlarıyla doğru uyumluluk analizine olanak tanımak için dart sınıfı eklendi.
  • Google Mobile Ads Flutter eklentisi 5.1.0 sürümüyle oluşturulup test edilmiştir.

Sürüm 1.0.0

  • İlk sürüm.
  • Google Mobile Ads Flutter eklentisinin 5.0.0 sürümüyle oluşturulmuş ve test edilmiştir.