Bu kılavuzda, reklam öğelerinizi yüklemek ve görüntülemek için Google Mobile Ads SDK'sının nasıl Meta Audience Network'teki reklamları uyumlulaştırma (teklifi kapsayan) inceleyebilirsiniz. Bir reklam biriminin uyumlulaştırma yapılandırması ve Meta Kitle Ağı'nın ve bağdaştırıcıyı bir uygulamaya Unity dönüştürün.
Desteklenen entegrasyonlar ve reklam biçimleri
Meta Kitle için uyumlulaştırma bağdaştırıcısı AdMob Ağ aşağıdaki özelliklere sahiptir:
Entegrasyon | |
---|---|
Teklif verme | |
Şelale 1 | |
Formatlar | |
Banner | |
Geçiş reklamı | |
Ödüllü | |
Ödüllü geçiş reklamı |
1 Meta Kitle Ağı haline geldi yalnızca teklif verme artış oldu.
Şartlar
- 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 sonraki bir iOS dağıtım hedefi
- En son Meta Audience Network SDK'sı genellikle Xcode sürümü var.
- Şu özelliklere sahip, çalışan bir Unity proje: Google Mobile Ads SDK'sı. Görüntüleyin Ayrıntılı bilgi için Başlarken.
- 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
2. Adım: Kullanıcı arayüzünde Meta Audience Network talebini AdMob 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.
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
OpenUPM-CLI
OpenUPM-CLI kullanıyorsanız Google Mobile Ads Meta Kitle Ağı'nı yükleyebilirsiniz. Aşağıdaki komutu çalıştırarak Unity için Uyumlulaştırma Eklentisi şu dosyayı projenizin kök dizininden kaldırın:
openupm add com.google.ads.mobile.mediation.metaaudiencenetwork
OpenUPM
Unity proje düzenleyicinizde Düzenle'yi seçin > Proje Ayarları > Paket Yöneticisi'ni açın ve Unity Paket Yöneticisi Ayarları.
Kapsamlı Kayıtlar sekmesinde OpenUPM'yi kapsamlı bir kayıt defteri olarak ekleyin ve şu ayrıntıları bulabilirsiniz:
- Ad:
OpenUPM
- URL:
https://package.openupm.com
- Kapsamlar:
com.google
Ardından Pencere'ye gidin > Paket Yöneticisi'ni açın ve Unity Paket Yöneticisi ve açılır menüden Kayıt Defterlerim'i seçin.
Google Mobile Ads Meta Kitle Ağı Uyumlulaştırma paketini seçin ve Yükle'yi tıklayın.
Unity Paketi
Şu hesap için Google Mobile Ads uyumlulaştırma eklentisinin en son sürümünü indirin:
İndirme bağlantısından elde edilen Meta Audience Network
"the"
Değişiklik günlüğü
ve
Posta kodundan GoogleMobileAdsMetaAudienceNetworkMediation.unitypackage
uzaklıkta
dosyası olarak kaydedebilirsiniz.
Unity proje düzenleyicinizde Öğeler > Paketi İçe Aktar >
Özel Paket'e göz atın ve
GoogleMobileAdsMetaAudienceNetworkMediation.unitypackage
dosyanız olabilir. Tüm dosyaların seçildiğinden emin olun ve
İçe aktar.
Ardından Öğeler > Play Hizmetleri Çözücü >
Android Çözücü > Zorla Çöz'e dokunun. Unity Play Hizmetleri Çözümleyici
bağımlılık çözümünü sıfırdan çözer ve
sitenizin Assets/Plugins/Android
dizinine bağımlıları bildirdiğinizden emin olun.
Unity uygulaması.
4. Adım: Meta Audience Network SDK'sında gizlilik ayarlarını uygulayın
AB kullanıcı rızası ve GDPR
Google AB Kullanıcı İzni kapsamında Politika uyarınca, belirli bilgilerin ifşa edildiğinden emin olmalısınız. Avrupa Ekonomik Alanı'ndaki (AEA) kullanıcıların cihaz tanımlayıcılarının ve kişisel verilerin kullanımı. Bu politika AB eGizlilik Yönergesi ve Genel Veri Koruma şartları Düzenleme (GDPR). Rıza isterken her reklam ağını tanımlamanız gerekir kişisel verileri toplayabilecek, alabilecek veya kullanabilen uyumlulaştırma zincirinizde her ağın kullanımıyla ilgili bilgi sağlar. Google şu anda Kullanıcının izin seçimini bu tür ağlara otomatik olarak iletmelidir.
Daha fazla bilgi için Meta'nın rehberliğini inceleyin GDPR ve meta reklamcılık.
ABD eyalet gizlilik yasaları
. ABD eyalet gizlilik yasaları kullanıcılara, doğru zamanda "indirimi" devre dışı bırakmak "kişisel bilgilerinin” (kanunların bu konudaki hariç tutmanın, öne çıkan bir "Do Not Sell My Personal My Personal (Kişisel Bilgilerimi Kesinlikle Satmayın) Bilgiler" bağlantısını ile başlar. İlgili içeriği oluşturmak için kullanılan ABD eyalet gizliliği yasalara uygunluk rehberi, yasalarca belirlenen kısıtlanmış veri işleme kullanılabilir ancak Google, bu ayarı her reklama uygulayamaz. ağda yer alır. Bu nedenle, reklam ağlarının her birini kişisel satışlarına katılabilecek uyumlulaştırma zincirinizde ağlarla ilgili bilgileri takip edin ve bu ağların yönlendirmelerini izleyerek uygunluk açısından önemlidir.
Kaliforniya'daki kullanıcılar için Meta'nın veri işlemeyi inceleyin ve seçenekleri bulabilirsiniz.
5. Adım: Gerekli kodu ekleyin
Android
Meta Audience Network entegrasyonu için ek kod gerekmez.
iOS
SKAdNetwork entegrasyonu
Meta Audience Network belgelerindeki talimatları uygulayın.
kullanarak projenizin Info.plist
dosyasına SKAdNetwork tanımlayıcılarını ekleyin.
Reklam izleme etkin
iOS 14 veya sonraki bir sürüm oluşturuyorsanız Meta Audience Network'ün Reklamcılık İzlemeyi nasıl ayarlayacaklarına ilişkin talimatlar İşaretle.
6. Adım: Uygulamanızı test edin
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.
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 (API düzeyi 28) sürümünden itibaren, cleartext desteği Google tarafından varsayılan olarak Bu işlem, Meta Kitlenin medya önbelleğine alma işlevselliğini etkileyecektir Ağ SDK'sı, kullanıcı deneyimini ve reklam gelirini etkileyebilir. Meta'nın belgeleri kullanarak uygulamanızdaki ağ güvenliği yapılandırmasını güncelleyin.
iOS
iOS entegrasyonları için geçerli değildir.
Hata kodları
Bağdaştırıcı, Kitle Ağı'ndan bir reklam alamazsa
kullanarak reklam yanıtından gelen temel hata
ResponseInfo
(aşağıdaki sınıflarda):
Android
com.google.ads.mediation.facebook.FacebookAdapter
com.google.ads.mediation.facebook.FacebookMediationAdapter
iOS
GADMAdapterFacebook
GADMediationAdapterFacebook
Meta kitle tarafından gönderilen kodlar ve beraberindeki mesajlar Reklam yüklenemediğinde ağ bağdaştırıcısı:
Android
Hata kodu | Neden |
---|---|
101 | Geçersiz sunucu parametreleri (ör. eksik Yerleşim Kimliği). |
102 | İstenen reklam boyutu, Meta Kitle Ağı 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 eksik. |
109 | Teklif yükünden doğal 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ıldı. |
1000-9999 | Meta Audience Network, SDK'ya özel bir hata döndürdü. Görüntüleyin Meta Audience Network belgeleri inceleyebilirsiniz. |
iOS
Hata kodu | Neden |
---|---|
101 | Geçersiz sunucu parametreleri (ör. eksik Yerleşim Kimliği). |
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ş/ödüllü reklamını gösteremedi. |
105 | Banner reklamın kök görüntüleme denetleyicisi nil . |
106 | Meta Audience Network SDK'sı başlatılamadı. |
1000-9999 | Meta Audience Network, SDK'ya özel bir hata döndürdü. Görüntüleyin Meta Audience Network belgeleri inceleyebilirsiniz. |
Meta Audience Network Unity Uyumlulaştırma Eklentisi Değişiklik Günlüğü
Sürüm 3.12.1
- 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.1.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 9.1.0 sürümüyle geliştirilip test edilmiştir.
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 9.0.0 sürümüyle 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 8.5.1 sürümüyle geliştirilip test edilmiştir.
Sürüm 3.10.0
- Bağdaştırıcı içeriği
GoogleMobileAds/Mediation/MetaAudienceNetwork/
hedefine 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 8.1.0 sürümüyle 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 7.4.1 sürümüyle 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 7.3.0 sürümüyle geliştirilip test edilmiştir.
Sürüm 3.8.0
- Unity uyumlulaştırma eklentisi 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 7.0.2 sürümüyle 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 7.0.0 sürümüyle geliştirilip test edilmiştir.
Sürüm 3.6.1
- Meta Audience Network Android bağdaştırıcısının 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 7.0.0 sürümüyle geliştirilip test edilmiştir.
Sürüm 3.6.0
- Meta Audience Network Android bağdaştırıcısının 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ının 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ının 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ının 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ının 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ının 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ının 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ının 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ının 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ının 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ının 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 bağdaştırıcısı 5.5.0.0 sürümünü destekler.
- Facebook iOS bağdaştırıcının 5.5.1.0 sürümünü destekler.
Sürüm 2.5.0
- Facebook Android bağdaştırıcısı 5.5.0.0 sürümünü destekler.
- Facebook iOS adaptör 5.5.0.0 sürümünü destekler.
Sürüm 2.4.1
- Facebook Android bağdaştırıcısı 5.4.1.1 sürümünü destekler.
- Facebook iOS adaptör 5.4.0.0 sürümünü destekler.
Sürüm 2.4.0
- Facebook Android bağdaştırıcısı 5.4.0.0 sürümünü destekler.
- Facebook iOS adaptör 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 bağdaştırıcısı 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 bağdaştırıcısı 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 bağdaştırıcısı 5.2.0.1 sürümünü destekler.
- Facebook iOS bağdaştırıcının 5.2.0.1 sürümünü destekler.
Sürüm 2.1.1
- Facebook Android bağdaştırıcısı 5.1.0.1 sürümünü destekler.
- Facebook iOS adaptör 5.1.0.0 sürümünü destekler.
Sürüm 2.1.0
- Facebook Android bağdaştırıcısı 5.1.0.0 sürümünü destekler.
- Facebook iOS adaptör 5.1.0.0 sürümünü destekler.
Sürüm 2.0.0
- Facebook Android bağdaştırıcısı 5.0.1.0 sürümünü destekler.
- Facebook iOS adaptör 5.0.1.0 sürümünü destekler.
Sürüm 1.2.1
- Facebook Android bağdaştırıcısı 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 bağdaştırıcısı 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 adaptör 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 düzeltildi.
Sürüm 1.1.1
- 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.
Sürüm 1.1.0
- 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ının 4.27.1 sürümünü destekler.