Meta Audience Network'ü teklifli sistemle entegre etme

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

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 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

.

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

Meta için Google Mobile Ads uyumlulaştırma eklentisinin en son sürümünü indirin Kitle Ağı'ndaki indirme bağlantısından Değişiklik günlüğü'nü açın ve GoogleMobileAdsFacebookMediation.unitypackage.

Unity proje düzenleyicinizde Öğeler > Paketi İçe Aktar > Özel Paket'e göz atın ve GoogleMobileAdsFacebookMediation.unitypackage dosyanız olabilir. Tüm dosyaların seçildiğinden emin olun ve İçe aktar.

Öğeler > Play Hizmetleri Çözümleyici > Android Çözümleyici > Zorla Çöz'e dokunun. Ardından Unity Play Hizmetleri Çözümleyici kitaplığı bağımlılık çözümü gerçekleştirir ve beyan edilen bağımlılıkları Unity uygulamanızın Assets/Plugins/Android dizini.

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

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

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

Sürüm 2.9.1

Sürüm 2.9.0

Sürüm 2.8.1

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)

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

Sürüm 2.6.1 (Kullanımdan kaldırıldı, 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 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 adaptör 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.