Meta Audience Network'ü teklifli sistemle entegre etme

Not: Facebook Audience Network, Meta Audience Network olarak yeniden adlandırıldı. Daha fazla bilgi için Meta'nın duyurusuna bakın.

Bu kılavuzda, teklif verme entegrasyonlarını kapsayan uyumlulaştırma yöntemini kullanarak Meta Audience Network'ten reklam yüklemek ve reklam göstermek için Google Mobile Ads SDK'sının nasıl kullanılacağı gösterilmektedir. Meta Audience Network'ün reklam biriminin uyumlulaştırma yapılandırmasına nasıl ekleneceği ve Meta Audience Network ile bağdaştırıcının bir uygulamaya nasıl Flutter entegre edileceği ele alınmaktadır.

Desteklenen entegrasyonlar ve reklam biçimleri

Meta Kitle Ağı için AdMob uyumlulaştırma bağdaştırıcısının özellikleri aşağıdaki gibidir:

Entegrasyon
Teklif
Şelale  ^1
Formatlar
Banner
Geçişli
Ödül olarak verildi
Ödüllü Geçiş Reklamı

¹ Meta Audience Network, 2021'de yalnızca teklifli sistem olarak değiştirildi.

Koşullar

• 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 21 veya üstü
• iOS'te dağıtmak için
  • 10.0 veya üzeri iOS dağıtım hedefi
  • En son Meta Audience Network SDK genellikle Xcode'un en son sürümünü gerektirir.
• Google Mobile Ads SDK'sı ile yapılandırılmış, çalışan bir Flutter 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ı ayarlama

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

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

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

Ardından para kazanacağınız platformunuzu seçin.

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

Android

iOS

Yeni ödeme hesabı ekle'yi tıklayarak ödeme hesabınızı ayarlayın. Ödeme bilgilerinizi girmeniz için yeni bir sayfaya yönlendirilirsiniz. Gerekli ayrıntıları doldurun ve İleri'yi tıklayın.

Uyumlulaştırma 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.

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

Yerleşim Kimliğini not edin.

Done'ı (Bitti) tıklayın.

Test modunu aç

Meta Audience Network test reklamlarının nasıl etkinleştirileceğiyle ilgili ayrıntılı talimatlar için Testing Audience Network Implementation (Kitle Ağ Uygulamasını Test Etme) kılavuzuna bakın.

2. Adım: Kullanıcı arayüzünde Meta Audience Network talebi AdMob oluşturun

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.

GDPR ve ABD eyalet düzenlemeleri reklam iş ortakları listesine Facebook ekle

Önemli: AB Rıza ve GDPR, CPRA ve Kullanıcı Mesajlaşma Platformu yapılandırmasını tamamlamak için Hesap Yönetimi izniniz olduğunu doğrulayın. Ayrıntılar için Hesabınıza kullanıcı erişimini yönetme sayfasına göz atın.

GDPR ayarları ve ABD eyalet düzenlemeleri ayarları bölümündeki adımları uygulayarak AdMob kullanıcı arayüzünde GDPR ve ABD eyalet düzenlemeleri reklam iş ortakları listesine Facebook ekleyin.

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 yol açabilir.

pub.dev üzerinden entegrasyon

Aşağıdaki bağımlılığı paketinizin pubspec.yaml dosyasınaMeta Audience Network SDK ve bağdaştırıcının en son sürümleriyle ekleyin:

dependencies:
  gma_mediation_meta: ^1.0.0

Manuel Entegrasyon

Meta Audience Network için Google Mobile Ads uyumlulaştırma eklentisinin en son sürümünü indirin, indirilen dosyayı çıkarı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 başvurun:

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

4. Adım: Meta Audience Network SDK'da gizlilik ayarlarını uygulayın

AB kullanıcı rızası alma ve GDPR

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 yapılması ve bu kullanıcılardan izin alınması 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 toplayabilen, alabilen veya kullanabilen ve her bir ağın kullanımı hakkında bilgi verebilecek her bir reklam ağını tanımlamanız gerekir. Google şu anda kullanıcının izin seçimini bu tür ağlara otomatik olarak aktaramamaktadır.

GDPR ve Meta reklamcılık hakkında bilgi için Meta'nın rehberliğini inceleyin.

ABD eyalet gizlilik yasaları

ABD eyalet gizlilik yasaları kullanıcılara, "kişisel bilgilerini" "satma" (yasaların bu terimleri tanımladığı şekilde) özelliğinin kapsamı dışında kalma hakkı sunmayı zorunlu kılıyor. Bu seçenek, "satan" tarafın ana sayfasında belirgin bir şekilde görünen "Kişisel Bilgilerimi Satma" bağlantısıyla sunuluyor. ABD eyalet gizlilik yasalarına uygunluk kılavuzu, Google reklam yayını 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 bilgi satışına dahil olabilecek tüm reklam ağlarını belirlemeniz 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

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ındaki talimatları uygulayın.

Reklam izleme etkin

iOS 14 veya sonraki sürümler için oluşturuyorsanız, Meta Audience Network'ün Reklam İzleme İşaretinin nasıl ayarlanacağına ilişkin talimatlarını inceleyin.

6. Adım: Uygulamanızı test etme

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.

Önemli Bilgi: Test ederken, test cihazına Facebook uygulamasının yüklü olduğundan ve geçerli bir Facebook giriş bilgisiyle giriş yaptığınızdan emin olun. Daha fazla bilgi için Meta'nın dokümanlarına bakı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 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

Android

Android 9'dan (API düzeyi 28) itibaren cleartext desteği varsayılan olarak devre dışıdır. Bu durum, Meta Audience Network SDK'nın medya önbelleğe alma işlevini etkiler ve kullanıcı deneyimi ile reklam gelirini etkileyebilir. Uygulamanızdaki ağ güvenliği yapılandırmasını güncellemek için Meta'nın belgelerini takip edin.

iOS

iOS entegrasyonları için geçerli değildir.

Hata kodları

Bağdaştırıcı, Audience Network'ten reklam alamazsa aşağıdaki sınıfların 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

Aşağıda, bir reklam yüklenemediğinde Meta Kitle Ağ bağdaştırıcısı tarafından atılan kodlar ve eşlik eden mesajlar verilmiştir:

Android

Hata kodu	Neden
101	Geçersiz sunucu parametreleri (ör. eksik Yerleşim Kimliği).
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ş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 yok.
109	Teklif yükünden yerel 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ılır.
1000-9999	Meta Audience Network SDK'ya özel 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. eksik Yerleşim Kimliği).
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ş/ödüllü reklamını gösteremedi.
105	Banner reklamın kök görüntüleme denetleyicisi nil şeklindedir.
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'ün belgelerini inceleyin.

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

1.0.1

• Ana makine platformlarıyla doğru uyumluluk analizine olanak tanımak için dart sınıfı eklendi
• Meta Android bağdaştırıcısı 6.17.0.0 sürümü ile doğrulanmış uyumluluk
• Meta iOS bağdaştırıcısı 6.15.0.0 sürümü ile doğrulanmış uyumluluk
• Google Mobile Ads Flutter Eklentisi sürüm 5.1.0 ile geliştirildi ve test edilmiştir.

1.0.0

• İlk sürüm.
• Meta Android bağdaştırıcısı 6.17.0.0 sürümü ile doğrulanmış uyumluluk
• Meta iOS bağdaştırıcısı 6.15.0.0 sürümü ile doğrulanmış uyumluluk
• Google Mobile Ads Flutter Eklentisi sürüm 5.0.0 ile geliştirildi ve test edilmiştir.