Facebook Audience Network'ü teklifli sistemle entegre etme

Bu kılavuz, Facebook Audience Network'ten teklif vererek reklam yüklemek ve görüntülemek için Google Mobile Ads SDK'sını kullanmak isteyen yayıncılar için hazırlanmıştır. Facebook Audience Network SDK'sının ve bağdaştırıcısının Unity uygulamasına nasıl entegre edileceğini ele alıyor.

Desteklenen entegrasyonlar ve reklam biçimleri

Facebook Audience Network için AdMob uyumlulaştırma adaptörü aşağıdaki özelliklere sahiptir:

Entegrasyon
Teklif
Şelale
Biçimler
Banner
Geçiş
Ödül olarak verildi
Ödüllü Geçiş Reklamı

Şartlar

  • Unity 5.6 veya sonraki sürümler
  • En son Google Mobile Ads SDK'sı
  • Facebook 2.11.0 veya sonraki sürümler için Google Mobile Ads uyumlulaştırma eklentisi
  • Android'de dağıtmak için
    • Android API düzeyi 16 veya üstü
  • iOS'te dağıtmak için
    • iOS dağıtım hedefi 10.0 veya üstü
    • En son Facebook Audience Network SDK'sı genellikle Xcode'un en son sürümünü gerektirir.
  • Google Mobile Ads SDK'sı ile yapılandırılmış ve çalışır durumda olan bir Unity projesi. Ayrıntılar için Başlayın bölümüne bakın.

1. Adım: Facebook Audience Network'ü kurun

Kaydolun ve İşletme Yöneticisi Başlangıç sayfasına giriş yapın.

Yeni bir İşletme Yöneticisi hesabı oluştur'u tıklayın ve gerekli alanları işletme bilgilerinizle doldurun.

Facebook mülkü oluşturma

Gerekli bilgileri doldurduktan sonra uygulamanız için bir mülk oluşturmanız istenir. Uygulamanız için mülk adını girin ve Para Kazanma Yöneticisi'ne git'i tıklayın.

Ardından, para kazanmak istediğiniz platformu seçin.

Uygulamanızın yayında olup olmadığını belirtin ve Gönder'i tıklayın.

Android

iOS

Uygulamanız için bir reklam yerleşimi oluşturmanız istenir. Bir biçim seçin, formu doldurun ve İleri'yi tıklayın.

300x250 dahil tüm banner boyutları için Banner seçin. Facebook, teklif vermede Medium Rectangle görüntülü reklam biçimini desteklemez ancak Banner görüntülü reklam biçimini kullanırken 50, 90 veya 250 yüksekliğindeki esnek genişlikli banner'ı destekler.

Ödüllü geçiş reklamı biçimini entegre etmeyi planlıyorsanız karşılık gelen Facebook biçimi Rewarded Video şeklindedir.

Sonraki adımda, oluşturduğunuz yerleşime genel bir bakış sunulur. Yerleşim kimliği ekle bölümünün altındaki Yerleşim kimliği'ne dikkat edin.

2. Adım: AdMob reklam biriminiz için uyumlulaştırma ayarlarını yapılandırın

Facebook'u reklam biriminizin uyumlulaştırma yapılandırmasına eklemeniz gerekir. Öncelikle, AdMob hesabınızda oturum açın.

Android

Uyumlulaştırma sekmesine gidin. Düzenlemek istediğiniz mevcut bir uyumlulaştırma grubunuz varsa düzenlemek istediğiniz uyumlulaştırma grubunun adını tıklayın ve Reklam kaynağı olarak Facebook Audience Network'ü ekleme bölümüne geçin.

Yeni bir uyumlulaştırma grubu oluşturmak için Uyumlulaştırma Grubu oluştur'u seçin.

Reklam biçiminizi ve platformunuzu girip Devam'ı tıklayın.

Uyumlulaştırma grubunuza bir ad verin ve hedeflenecek konumları seçin. Ardından, uyumlulaştırma grubu durumunu Etkin olarak ayarlayın. Ardından, reklam birimi seçim yer paylaşımını açan Reklam Birimleri Ekle'yi tıklayın.

Bu uyumlulaştırma grubunu mevcut AdMob reklam biriminizle ilişkilendirin. Daha sonra, Bitti'yi tıklayın. Artık reklam birimleri kartını, seçtiğiniz reklam birimleriyle doldurduğunuzu görmeniz gerekir.

Facebook Audience Network'ü reklam kaynağı olarak ekleme

Reklam Kaynakları kartında Reklam Ağı Ekle'yi seçin. Facebook Audience Network (Teklif Verme) seçeneğini belirleyin. Önceki bölümde elde ettiğiniz Yerleşim kimliği'ni girin ve Bitti'yi tıklayın.

Son olarak Kaydet'i tıklayın.

iOS

Uyumlulaştırma sekmesine gidin. Düzenlemek istediğiniz mevcut bir uyumlulaştırma grubunuz varsa düzenlemek istediğiniz uyumlulaştırma grubunun adını tıklayın ve Reklam kaynağı olarak Facebook Audience Network'ü ekleme bölümüne geçin.

Yeni bir uyumlulaştırma grubu oluşturmak için Uyumlulaştırma Grubu oluştur'u seçin.

Reklam biçiminizi ve platformunuzu girip Devam'ı tıklayın.

Uyumlulaştırma grubunuza bir ad verin ve hedeflenecek konumları seçin. Ardından, uyumlulaştırma grubu durumunu Etkin olarak ayarlayın. Ardından, reklam birimi seçim yer paylaşımını açan Reklam Birimleri Ekle'yi tıklayın.

Bu uyumlulaştırma grubunu mevcut AdMob reklam biriminizle ilişkilendirin. Daha sonra, Bitti'yi tıklayın.

Reklam birimleri kartını seçtiğiniz reklam birimleriyle doldurduğunuzu göreceksiniz.

Facebook Audience Network'ü reklam kaynağı olarak ekleme

Reklam Kaynakları kartında Reklam Ağı Ekle'yi seçin. Facebook Audience Network (Teklif Verme) seçeneğini belirleyin. Önceki bölümde elde ettiğiniz Yerleşim kimliği'ni girin ve Bitti'yi tıklayın.

Son olarak Kaydet'i tıklayın.

Ödüllü reklamları kullanma

Ödüllü reklam biriminizin ayarlarında, ödül tutarının ve ödül türünün değerlerini girin. Ardından, hangi reklam ağının yayınlandığına bakılmaksızın kullanıcıya aynı ödülü sağladığınızdan emin olmak için Uyumlulaştırma gruplarındaki tüm ağlara uygula kutusunu işaretleyin.

Bu ayarı uygulamazsanız Facebook adaptörü varsayılan olarak 1 değerine sahip "" (boş dize) ödülünü kullanır. Facebook SDK'sı ödüllü reklamları için belirli ödül değerleri sağlamaz.

AdMob reklam birimleri için ödül değerlerini belirleme hakkında daha fazla bilgi için Reklam birimi oluşturma konusuna bakın.

3. Adım: Facebook Audience Network SDK'sını ve bağdaştırıcısını içe aktarın

Facebook için Google Mobile Ads uyumlulaştırma eklentisinin en son sürümünü Changelog'daki indirme bağlantısından indirin ve GoogleMobileAdsFacebookMediation.unitypackage dosyasını zip dosyasından çıkarın.

Unity proje düzenleyicinizde > Öğeleri İç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.

Ardından Öğeler > Play Hizmetleri Çözümleyicisi > Android Çözümleyici > Çözümlemeyi Zorla'yı seçin. Unity Play Hizmetleri Çözümleyici kitaplığı, sıfırdan ayrılık çözümünden yararlanır ve beyan edilen bağımlılıkları Unity uygulamanızın Assets/Plugins/Android dizinine kopyalar.

4. Adım: Ek kod gerekir

Android

Facebook entegrasyonu için ek kod gerekmez.

iOS

SKAdNetwork entegrasyonu

Facebook, projenizin SKAdNetwork tanımlayıcılarını Info.plist dosyanıza eklemenizi ister:

<array>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>v9wttpbfk9.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>n38lu8286q.skadnetwork</string>
    </dict>
</array>

Reklam izleme etkin

iOS 14 veya sonraki bir sürümü oluşturuyorsanız Facebook İzleme İşaretini ayarlamayla ilgili Facebook Facebook talimatlarını inceleyin.

5. Adım: Uygulamanızı test edin

Facebook test reklamlarını etkinleştirmeyle ilgili ayrıntılı talimatlar için Kitle Ağı Uygulama Kılavuzu kılavuzuna bakın. Daha sonra, uygulamanızın doğru olup olmadığını doğrulamak için Uyumlulaştırma Test Paketi'ni kullanabilirsiniz.

İşte oldu. Artık Facebook & Audience Network ile uyumlu bir uyumlulaştırma entegrasyonunuz var.

İsteğe bağlı adımlar

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ı konusunda belirli açıklamaların yapıldığından ve bu kullanıcılardan alınan izinlerden emin olmanız gerekir. Bu politika AB eGizlilik Yönergesi ve Genel Veri Koruma Yönetmeliği (GDPR) kapsamındaki gereksinimleri yansıtmaktadır. İzin isterken uyumlulaştırma zincirinizde kişisel verileri toplayabilecek, alabilecek veya kullanabilecek tüm reklam ağlarını belirtmeniz 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 aktaramamaktadır.

GDPR ve Facebook reklamcılığı hakkında bilgi için lütfen Facebook'un yönergelerini inceleyin.

Facebook'u GDPR reklam iş ortakları listesine ekle

Facebook ayarları'ndaki adımları uygulayarak Facebook'u AdMob kullanıcı arayüzündeki GDPR reklam iş ortakları listesine ekleyin.

CCPA

Kaliforniya Tüketici Gizliliği Yasası (CCPA) Kaliforniya eyaletinde yaşayan kullanıcılara, "kişisel bilgilerini satma" (yasaların bu terimleri tanımlandığı şekilde) kapsamı dışında kalmayı seçme ve "Kişisel" bilgisi CCPA hazırlık kılavuzu, Google reklam yayını için kısıtlanmış veri işlemeyi etkinleştirmenizi sağlar ancak Google bu ayarı uyumlulaştırma zincirinizdeki her reklam ağına uygulayamaz. Bu nedenle, kişisel bilgilerin satılmasına katkıda bulunabilecek tüm reklam ağlarını uyumlulaştırma zincirinizde tanımlamanız ve bu ağların her birinde verilen talimatları uygulayarak CCPA'ya uygunluğu sağlamanız gerekir.

Kaliforniya'da yaşayan kullanıcılar için Facebook'un veri işleme seçeneklerini inceleyin.

Facebook'u CCPA reklam iş ortakları listesine ekle

Facebook'u AdMob kullanıcı arayüzündeki CCPA reklam iş ortakları listesine eklemek için CCPA ayarları bölümündeki adımları uygulayın.

Hata kodları

Bağdaştırıcı Facebook Audience Network'ten bir reklam alamazsa yayıncılar aşağıdaki sınıflarda ResponseInfo kullanarak reklam yanıtındaki temel hatayı kontrol edebilir:

Android

com.google.ads.mediation.facebook.FacebookAdapter
com.google.ads.mediation.facebook.FacebookMediationAdapter

iOS

GADMAdapterFacebook
GADMediationAdapterFacebook

Aşağıda, bir reklam yüklenemediğinde Facebook Audience Network adaptörü tarafından gönderilen kodlar ve ilgili mesajlar verilmiştir:

Android

Hata kodu Nedeni
101 Sunucu parametreleri geçersiz (ör. Yerleşim Kimliği eksik).
102) İstenen reklam boyutu, Facebook Kitle Ağı'nın desteklediği banner boyutuyla eşleşmiyor.
103 Yayıncı, Activity bağlamına sahip reklamlar istemelidir.
104 Facebook 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) Facebook Audience Network SDK'sı geçiş reklamlarını/ödüllü reklamlarını sunamadı.
111) Facebook Audience Network AdView nesnesi oluşturulurken istisna oluştu.
1000-9999 Facebook Audience Network, SDK'ya özgü bir hata döndürdü. Daha fazla bilgi için Facebook’un dokümanlarına bakın.

iOS

Hata kodu Nedeni
101 Sunucu parametreleri geçersiz (ör. Yerleşim Kimliği eksik).
102) İstenen reklam boyutu, Facebook Kitle Ağı'nın desteklediği banner boyutuyla eşleşmiyor.
103 Facebook Audience Network reklam nesnesi başlatılamadı.
104 Facebook Audience Network SDK'sı geçiş reklamlarını/ödüllü reklamlarını sunamadı.
105) Banner reklamın kök görüntüleme denetleyicisi nil.
106) Facebook Audience Network SDK'sı başlatılamadı.
1000-9999 Facebook Audience Network, SDK'ya özgü bir hata döndürdü. Daha fazla bilgi için Facebook’un dokümanlarına bakın.

Facebook Unity Uyumlulaştırması Eklentisi Değişiklik Günlüğü

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ü

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 adaptör 5.5.0.0 sürümünü destekler.
  • Facebook iOS adaptör 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 adaptör 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 adaptör 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 adaptör 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 adaptör 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 adaptör 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 adaptör 5.3.0.0 sürümünü destekler.

Sürüm 2.2.0

  • Eklenti, yeni açık beta Ödüllü API'sini destekleyecek şekilde güncellendi.
  • Facebook Android adaptör 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 adaptör 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 adaptör 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 adaptör 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 adaptör 4.99.3.0 sürümünü destekler.
  • Facebook iOS adaptör 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 adaptör 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 adaptör 4.28.1.2 sürümünü destekler.

Sürüm 1.1.2

  • Unity Ads Unity uyumlulaştırma eklentisiyle yaşanabilecek çakışmalar düzeltildi.

Sürüm 1.1.1

  • Facebook Android adaptör 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 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 yayın.
  • Facebook Android SDK 4.27.0 sürümünü destekler.
  • Facebook iOS SDK 4.27.1 sürümünü destekler.