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 ve bağdaştırıcının bir Unity uygulamasına nasıl entegre edileceği ele alınmaktadır.
Desteklenen entegrasyonlar ve reklam biçimleri
Meta Kitle Ağı için Ad Manager 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ı |
1 Meta Audience Network, 2021'de yalnızca teklifli sistem olarak değişti.
Koşullar
- En son Google Mobile Ads SDK'sı
- Unity 5.6 veya sonraki sürümler
- Meta Audience Network 2.11.0 için Google Mobile Ads uyumlulaştırma eklentisi (en son sürüm önerilir)
- 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 Unity 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.
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 Ad Manager oluşturun
Reklam biriminiz için uyumlulaştırma ayarlarını yapılandırma
GDPR ve ABD eyalet düzenlemeleri reklam iş ortakları listesine Facebook ekle
GDPR ayarları ve ABD eyalet yönetmelikleri ayarları bölümündeki adımları uygulayarak Ad Manager 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
Changelog'daki indirme bağlantısından Meta Audience Network için Google Mobile Ads uyumlulaştırma eklentisinin en son sürümünü indirin ve zip dosyasından GoogleMobileAdsFacebookMediation.unitypackage
dosyasını çıkarın.
Unity proje düzenleyicinizde Öğeler > Paketi İçe Aktar > Özel Paket'i seçin ve indirdiğiniz GoogleMobileAdsFacebookMediation.unitypackage
dosyasını bulun. Tüm dosyaların seçili olduğundan emin olun ve İçe aktar'ı tıklayın.
Öğeler > Play Hizmetleri Çözümleyici > Android Çözümleyici > Çözücüye Zorla'yı seçin.
Daha sonra Unity Play Hizmetleri Çözümleyici kitaplığı sıfırdan bağımlılık çözümlemesi gerçekleştirir ve bildirilen bağımlılıkları Unity uygulamanızın Assets/Plugins/Android
dizinine kopyalar.
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
Ad Manager 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 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 Unity Uyumlulaştırma Eklentisi Değişiklik Günlüğü
Sürüm 3.12.0
- Meta Audience Network Android bağdaştırıcısı 6.17.0.0 sürümünü destekler.
- Meta Audience Network iOS bağdaştırıcısı 6.15.0.0 sürümünü destekler.
- Google Mobil Reklamlar Unity Eklentisi sürüm 9.0.0 ile geliştirilip test edilmiştir.
Sürüm 3.11.0
- Meta Audience Network Android bağdaştırıcısı 6.15.0.0 sürümünü destekler.
- Meta Audience Network iOS bağdaştırıcısı 6.14.0.0 sürümünü destekler.
- Google Mobil Reklamlar Unity Eklentisi sürüm 8.5.1 ile geliştirildi ve test edildi.
Sürüm 3.10.0
- Bağdaştırıcı içeriği
GoogleMobileAds/Mediation/MetaAudienceNetwork/
klasörüne taşındı. - Meta Audience Network Android bağdaştırıcısı 6.14.0.0 sürümünü destekler.
- Meta Audience Network iOS bağdaştırıcısı 6.12.0.1 sürümünü destekler.
- Google Mobil Reklamlar Unity Eklentisi sürüm 8.1.0 ile geliştirilip test edilmiştir.
Sürüm 3.9.1
- Meta Audience Network Android bağdaştırıcısı 6.12.0.0 sürümünü destekler.
- Meta Audience Network iOS bağdaştırıcısı 6.12.0.1 sürümünü destekler.
- Google Mobil Reklamlar Unity Eklentisi sürüm 7.4.1 ile geliştirilip test edilmiştir.
Sürüm 3.9.0
- Meta Audience Network Android bağdaştırıcısı 6.12.0.0 sürümünü destekler.
- Meta Audience Network iOS bağdaştırıcısı 6.12.0.0 sürümünü destekler.
- Google Mobil Reklamlar Unity Eklentisi sürüm 7.3.0 ile geliştirilip test edilmiştir.
Sürüm 3.8.0
- Unity uyumlulaştırma eklentisinin adı "Meta Audience Network" olarak yeniden adlandırıldı.
- Meta Audience Network Android bağdaştırıcısı 6.11.0.1 sürümünü destekler.
- Meta Audience Network iOS bağdaştırıcısı 6.11.1.0 sürümünü destekler.
- Google Mobil Reklamlar Unity Eklentisi sürüm 7.0.2 ile geliştirilip test edilmiştir.
Sürüm 3.7.0
- Meta Audience Network Android bağdaştırıcısı 6.10.0.0 sürümünü destekler.
- Meta Audience Network iOS bağdaştırıcısı 6.10.0.0 sürümünü destekler.
- Google Mobil Reklamlar Unity Eklentisi sürüm 7.0.0 ile geliştirilip test edilmiştir.
Sürüm 3.6.1
- Meta Audience Network Android bağdaştırıcısı 6.8.0.0 sürümünü destekler.
- Meta Audience Network iOS bağdaştırıcısı 6.9.0.1 sürümünü destekler.
- Google Mobil Reklamlar Unity Eklentisi sürüm 7.0.0 ile geliştirilip test edilmiştir.
Sürüm 3.6.0
- Meta Audience Network Android bağdaştırıcısı 6.8.0.0 sürümünü destekler.
- Meta Audience Network iOS bağdaştırıcısı 6.8.0.0 sürümünü destekler.
Sürüm 3.5.0
- Meta Audience Network Android bağdaştırıcısı 6.7.0.0 sürümünü destekler.
- Meta Audience Network iOS bağdaştırıcısı 6.7.0.0 sürümünü destekler.
Sürüm 3.4.0
- Meta Audience Network Android bağdaştırıcısı 6.6.0.0 sürümünü destekler.
- Meta Audience Network iOS bağdaştırıcısı 6.6.0.0 sürümünü destekler.
Sürüm 3.3.2
- Meta Audience Network Android bağdaştırıcısı 6.5.1.1 sürümünü destekler.
- Meta Audience Network iOS bağdaştırıcısı 6.5.1.0 sürümünü destekler.
Sürüm 3.3.1
- Meta Audience Network Android bağdaştırıcısı 6.5.1.0 sürümünü destekler.
- Meta Audience Network iOS bağdaştırıcısı 6.5.1.0 sürümünü destekler.
Sürüm 3.3.0
- Meta Audience Network Android bağdaştırıcısı 6.4.0.0 sürümünü destekler.
- Meta Audience Network iOS bağdaştırıcısı 6.4.1.0 sürümünü destekler.
Sürüm 3.2.0
- Meta Audience Network Android bağdaştırıcısı 6.2.0.1 sürümünü destekler.
- Meta Audience Network iOS bağdaştırıcısı 6.2.1.0 sürümünü destekler.
Sürüm 3.1.0
- Meta Audience Network Android bağdaştırıcısı 6.2.0.0 sürümünü destekler.
- Meta Audience Network iOS bağdaştırıcısı 6.2.0.0 sürümünü destekler.
Sürüm 3.0.0
- Meta Audience Network Android bağdaştırıcısı 6.1.0.0 sürümünü destekler.
- Meta Audience Network iOS bağdaştırıcısı 6.0.0.0 sürümünü destekler.
Sürüm 2.12.0
- Meta Audience Network Android bağdaştırıcısı 5.11.0.0 sürümünü destekler.
- Meta Audience Network iOS bağdaştırıcısı 5.10.1.0 sürümünü destekler.
Sürüm 2.11.1
- Meta Audience Network Android bağdaştırıcısı 5.10.1.0 sürümünü destekler.
- Meta Audience Network iOS bağdaştırıcısı 5.10.1.0 sürümünü destekler.
Sürüm 2.11.0
- Meta Audience Network Android bağdaştırıcısı 5.10.0.0 sürümünü destekler.
- Meta Audience Network iOS bağdaştırıcısı 5.10.0.0 sürümünü destekler.
Sürüm 2.10.0
- Meta Audience Network Android bağdaştırıcısı 5.9.1.0 sürümünü destekler.
- Meta Audience Network iOS bağdaştırıcısı 5.9.0.1 sürümünü destekler.
Sürüm 2.9.2
- Meta Audience Network Android bağdaştırıcısı 5.9.0.2 sürümünü destekler.
- Meta Audience Network iOS bağdaştırıcısı 5.9.0.1 sürümünü destekler.
Sürüm 2.9.1
- Meta Audience Network Android bağdaştırıcısı 5.9.0.1 sürümünü destekler.
- Meta Audience Network iOS bağdaştırıcısı 5.9.0.1 sürümünü destekler.
Sürüm 2.9.0
- Meta Audience Network Android bağdaştırıcısı 5.9.0.0 sürümünü destekler.
- Meta Audience Network iOS bağdaştırıcısı 5.9.0.0 sürümünü destekler.
Sürüm 2.8.1
- Meta Audience Network Android bağdaştırıcısı 5.8.0.1 sürümünü destekler.
- Meta Audience Network iOS bağdaştırıcısı 5.8.0.2 sürümünü destekler.
Sürüm 2.8.0
- Meta Audience Network Android bağdaştırıcısı 5.8.0.0 sürümünü destekler.
- Meta Audience Network iOS bağdaştırıcısı 5.8.0.1 sürümünü destekler.
Sürüm 2.7.1 (Kullanımdan kaldırıldı, 2.8.0 veya daha yeni bir sürümü kullanın)
- Meta Audience Network Android bağdaştırıcısı 5.7.1.0 sürümünü destekler.
- Meta Audience Network iOS bağdaştırıcısı 5.7.1.1 sürümünü destekler.
Sürüm 2.7.0 (Kullanımdan kaldırıldı, 2.8.0 veya daha yeni bir sürümü kullanın)
- Meta Audience Network Android bağdaştırıcısı 5.7.0.0 sürümünü destekler.
- Meta Audience Network iOS bağdaştırıcısı 5.7.0.0 sürümünü destekler.
Sürüm 2.6.1 (Kullanımdan kaldırıldı, 2.8.0 veya daha yeni bir sürümü kullanın)
- Meta Audience Network Android bağdaştırıcısı 5.6.1.0 sürümünü destekler.
- Meta Audience Network iOS bağdaştırıcısı 5.6.1.0 sürümünü destekler.
Sürüm 2.6.0
- Meta Audience Network Android bağdaştırıcısı 5.6.0.0 sürümünü destekler.
- Meta Audience Network iOS bağdaştırıcısı 5.6.0.0 sürümünü destekler.
Sürüm 2.5.1
- Facebook Android adaptörü 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.
Sürüm 2.5.0
- Facebook Android adaptörü 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ü 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 adaptörü 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ü 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 Ödüllü API'yi destekleyecek şekilde güncellendi.
- Facebook Android adaptörü 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.
Sürüm 2.1.0
- 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ü 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ü 4.99.3.0 sürümünü destekler.
- Facebook iOS bağdaştırıcısı 4.99.3.0 sürümünü destekler.
Sürüm 1.2.0
- Facebook Android adaptörü 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 adaptörü 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 ilgili olası bir çakışma sorunu giderildi.
Sürüm 1.1.1
- Facebook Android adaptörü 4.28.2.0 sürümünü destekler.
- Facebook iOS bağdaştırıcısı 4.28.1.1 sürümünü destekler.
Sürüm 1.1.0
- Facebook Android SDK'sı 4.28.1 sürümünü destekler.
- Facebook iOS SDK 4.28.1 sürümünü destekler.
Sürüm 1.0.0
- İlk sürüm!
- Facebook Android SDK'sı 4.27.0 sürümünü destekler.
- Facebook iOS SDK'sı 4.27.1 sürümünü destekler.