Meta Audience Network'ü teklifli sistemle entegre etme

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. Bu makalede, bir reklam biriminin uyumlulaştırma yapılandırmasına Meta Audience Network'ün nasıl ekleneceği ve Meta Audience Network'ün bir Unity uygulamaya nasıl entegre edileceği ele alınmaktadır.

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ı
  • Unity 5.6 veya sonraki sürümler
  • Meta Audience Network için Google Mobile Ads uyumlulaştırma eklentisi 2.11.0 (en son sürüm önerilir)
  • 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ış Unity ç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 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ı 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 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

OpenUPM-CLI

OpenUPM-CLI yüklüyse projenizin kök dizininden aşağıdaki komutu çalıştırarak Unity için Google Mobile Ads Meta Audience Network Uyumlulaştırma Eklentisini projenize yükleyebilirsiniz:

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

OpenUPM

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

Kapsamlı Kayıt Defterleri sekmesinde, OpenUPM'yi aşağıdaki ayrıntılarla kapsamlı bir kayıt defteri olarak ekleyin:

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

OpenUPM Ayrıntıları

Ardından, Unity Paket Yöneticisi'ni açmak için pencere > Paket Yöneticisi'ne gidin ve açılır menüden Kayıt Dairelerim'i seçin.

Unity Kayıt Daireleri

Google Mobil Reklamlar Meta Audience Network Uyumlulaştırması paketini seçin ve Yükle'yi tıklayın.

OpenUPM'den yükleme

Unity Paketi

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

Unity proje düzenleyicinizde Öğeler > Paket İçe Aktar > Özel Paket'i 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 Öğeler > Harici Bağımlılık Yöneticisi > Android Çözücü > Çözümü Zorla'yı 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.

Çözmeye Zorla

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

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) ş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ı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ına 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 tüm reklam ağları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

Test cihazınızı AdMob'a 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 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 Kitle Ağı tarafından desteklenen bir banner boyutuyla eşleşmiyor.
103 Yayıncı, Activity bağlamında reklam 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, 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 ayrıntı için Meta Audience Network belgelerine bakın.

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

3.14.0 sürümü

Sürüm 3.13.1

3.13.0 sürümü

Sürüm 3.12.2

3.12.1 sürümü

3.12.0 sürümü

3.11.0 sürümü

3.10.0 sürümü

Sürüm 3.9.1

3.9.0 sürümü

Sürüm 3.8.0

3.7.0 sürümü

Sürüm 3.6.1

3.6.0 sürümü

Sürüm 3.5.0

3.4.0 sürümü

3.3.2 sürümü

Sürüm 3.3.1

3.3.0 sürümü

Sürüm 3.2.0

3.1.0 sürümü

3.0.0 sürümü

2.12.0 sürümü

Sürüm 2.11.1

2.11.0 sürümü

Sürüm 2.10.0

Sürüm 2.9.2

2.9.1 sürümü

2.9.0 sürümü

2.8.1 sürümü

Sürüm 2.8.0

Sürüm 2.7.1 (Kullanımdan kaldırıldı, 2.8.0 veya daha yeni bir sürüm kullanın)

2.7.0 sürümü (Desteği sonlandırıldı, 2.8.0 veya daha yeni sürümleri kullanın)

2.6.1 sürümü (Desteği sonlandırıldı, 2.8.0 veya daha yeni bir sürümü kullanın)

2.6.0 sürümü

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ı 5.5.1.0 sürümünü destekler.

2.5.0 sürümü

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

Sürüm 2.4.1

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

Sürüm 2.4.0

  • Facebook Android adaptörü 5.4.0.0 sürümünü destekler.
  • Facebook iOS bağdaştırıcısı 5.4.0.0 sürümünü 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ünün 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ı 5.3.0.0 sürümünü destekler.

Sürüm 2.2.0

  • Eklenti, yeni açık beta Rewarded API'yi destekleyecek şekilde güncellendi.
  • Facebook Android bağdaştırıcısı 5.2.0.1 sürümünü destekler.
  • Facebook iOS bağdaştırıcısı 5.2.0.1 sürümünü destekler.

Sürüm 2.1.1

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

2.1.0 sürümü

  • Facebook Android adaptörü 5.1.0.0 sürümünü destekler.
  • Facebook iOS bağdaştırıcısı 5.1.0.0 sürümünü 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ünün 4.99.1.1 sürümünü destekler.
  • Facebook iOS bağdaştırıcısı 4.99.2.0 sürümünü destekler.

Sürüm 1.1.3

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

Sürüm 1.1.2

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

1.1.1 sürümü

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

1.1.0 sürümü

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

Sürüm 1.0.0

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