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 arabuluculuk yapılandırmasına ekleme ve Meta Audience Network ile bağdaştırıcıyı Unity 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ı
  • Unity 5.6 veya daha yeni bir sürüm
  • Meta Audience Network için Google Mobile Ads aracılık eklentisi 2.11.0 (en son sürüm önerilir)
  • 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 Unity 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

OpenUPM-CLI

OpenUPM-CLI yüklüyse projenizin kök dizininden aşağıdaki komutu çalıştırarak projenize Unity için Google Mobil Reklamlar Meta Audience Network Aracılık Eklentisi'ni yükleyebilirsiniz:

openupm add com.google.ads.mobile.mediation.metaaudiencenetwork

OpenUPM

Unity proje düzenleyicinizde Düzenle > Proje Ayarları > Paket Yöneticisi'ni seçerek Unity Paket Yöneticisi Ayarları'nı açın.

Scoped Registries (Kapsamlı Kayıtlar) sekmesinde, aşağıdaki ayrıntıları kullanarak OpenUPM'yi kapsamlı kayıt olarak ekleyin:

  • Ad: OpenUPM
  • URL: https://package.openupm.com
  • Kapsamlar: com.google

OpenUPM Ayrıntıları

Ardından, Pencere > Paket Yöneticisi'ne giderek Unity Paket Yöneticisi'ni açın ve açılır menüden Kayıtlarım'ı seçin.

Unity Registries

Google Mobile Ads MetaAudienceNetwork Mediation paketini seçip Yükle'yi tıklayın.

OpenUPM'den yükleme

Unity paketi

Değişiklik günlüğündeki indirme bağlantısını kullanarak Meta Audience Network için Google Mobil Reklamlar uyumlulaştırma eklentisinin en son sürümünü indirin ve zip dosyasından GoogleMobileAdsMetaAudienceNetworkMediation.unitypackage dosyasını çıkarın.

Unity proje düzenleyicinizde Assets (Öğeler) > Import Package (Paket İçe Aktar) > Custom Package'ı (Özel Paket) seçin ve indirdiğiniz GoogleMobileAdsMetaAudienceNetworkMediation.unitypackage dosyasını bulun. Tüm dosyaların seçili olduğundan emin olun ve İçe aktar'ı tıklayın.

Unity'den içe aktarma

Ardından Assets (Öğeler) > External Dependency Manager (Harici Bağımlılık Yöneticisi) > Android Resolver (Android Çözücü) > Force Resolve'u (Çözümü Zorla) seçin. External Dependency Manager kitaplığı, bağımlılık çözümlemesini sıfırdan gerçekleştirir ve bildirilen bağımlılıkları Unity uygulamanızın Assets/Plugins/Android dizinine kopyalar.

Çözüme Zorla

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 Unity Uyumlulaştırma Eklentisi Değişiklik Günlüğü

Sürüm 3.17.0

Sürüm 3.16.0

Sürüm 3.15.0

Sürüm 3.14.0

Sürüm 3.13.1

Sürüm 3.13.0

Sürüm 3.12.2

Sürüm 3.12.1

Sürüm 3.12.0

Sürüm 3.11.0

Sürüm 3.10.0

Sürüm 3.9.1

Sürüm 3.9.0

Sürüm 3.8.0

Sürüm 3.7.0

Sürüm 3.6.1

Sürüm 3.6.0

Sürüm 3.5.0

Sürüm 3.4.0

Sürüm 3.3.2

Sürüm 3.3.1

Sürüm 3.3.0

Sürüm 3.2.0

Sürüm 3.1.0

Sürüm 3.0.0

Sürüm 2.12.0

Sürüm 2.11.1

Sürüm 2.11.0

Sürüm 2.10.0

Sürüm 2.9.2

2.9.1 sürümü

Sürüm 2.9.0

Sürüm 2.8.1

Sürüm 2.8.0

2.7.1 sürümü (Desteklenmiyor, 2.8.0 veya daha yeni bir sürüm kullanın)

2.7.0 sürümü (Desteklenmiyor, 2.8.0 veya daha yeni bir sürüm kullanın)

2.6.1 sürümü (Desteklenmiyor, 2.8.0 veya daha yeni bir sürüm kullanın)

Sürüm 2.6.0

Sürüm 2.5.1

  • Facebook Android adaptörünün 5.5.0.0 sürümünü destekler.
  • Facebook iOS bağdaştırıcısı sürüm 5.5.1.0'ı destekler.

Sürüm 2.5.0

  • Facebook Android adaptörünün 5.5.0.0 sürümünü destekler.
  • Facebook iOS bağdaştırıcısı sürüm 5.5.0.0'ı destekler.

Sürüm 2.4.1

  • Facebook Android bağdaştırıcısı sürüm 5.4.1.1'i destekler.
  • Facebook iOS bağdaştırıcısı sürüm 5.4.0.0'ı destekler.

Sürüm 2.4.0

  • Facebook Android adaptörünün 5.4.0.0 sürümünü destekler.
  • Facebook iOS bağdaştırıcısı sürüm 5.4.0.0'ı destekler.

Sürüm 2.3.2

  • Facebook Android bağdaştırıcısı 5.3.1.2 sürümünü destekler.
  • Facebook iOS bağdaştırıcısı 5.3.2.0 sürümünü destekler.

Sürüm 2.3.1

  • Facebook Android adaptörü 5.3.1.0 sürümünü destekler.
  • Facebook iOS bağdaştırıcısı 5.3.2.0 sürümünü destekler.

Sürüm 2.3.0

  • Facebook Android adaptörünün 5.3.0.0 sürümünü destekler.
  • Facebook iOS bağdaştırıcısı sürüm 5.3.0.0'ı destekler.

Sürüm 2.2.0

  • Yeni açık beta ödüllü API'sini desteklemek için eklenti güncellendi.
  • Facebook Android bağdaştırıcısı sürüm 5.2.0.1'i destekler.
  • Facebook iOS bağdaştırıcısı sürüm 5.2.0.1'i destekler.

Sürüm 2.1.1

  • Facebook Android adaptörünün 5.1.0.1 sürümünü destekler.
  • Facebook iOS bağdaştırıcısı sürüm 5.1.0.0'ı destekler.

Sürüm 2.1.0

  • Facebook Android adaptörünün 5.1.0.0 sürümünü destekler.
  • Facebook iOS bağdaştırıcısı sürüm 5.1.0.0'ı destekler.

Sürüm 2.0.0

  • Facebook Android adaptörünün 5.0.1.0 sürümünü destekler.
  • Facebook iOS bağdaştırıcısı 5.0.1.0 sürümünü destekler.

Sürüm 1.2.1

  • Facebook Android adaptörünün 4.99.3.0 sürümünü destekler.
  • Facebook iOS adaptörünün 4.99.3.0 sürümünü destekler.

Sürüm 1.2.0

  • Facebook Android adaptör sürümü 4.99.1.1'i destekler.
  • Facebook iOS bağdaştırıcısı sürüm 4.99.2.0'ı destekler.

Sürüm 1.1.3

  • Facebook Android bağdaştırıcısı sürüm 4.28.2.1'i destekler.
  • Facebook iOS bağdaştırıcısı sürüm 4.28.1.2'yi destekler.

Sürüm 1.1.2

  • Unity Ads Unity uyumlulaştırma eklentisiyle olası bir çakışma düzeltildi.

Sürüm 1.1.1

  • Facebook Android bağdaştırıcısı sürüm 4.28.2.0'ı destekler.
  • Facebook iOS bağdaştırıcı sürümü 4.28.1.1'i destekler.

Sürüm 1.1.0

  • Facebook Android SDK'sının 4.28.1 sürümünü destekler.
  • Facebook iOS SDK'sının 4.28.1 sürümünü destekler.

Sürüm 1.0.0

  • İlk sürüm!
  • Facebook Android SDK sürüm 4.27.0'ı destekler.
  • Facebook iOS SDK'sının 4.27.1 sürümünü destekler.