Meta Audience Network'ü teklifli sistemle entegre etme

Platform seçin: Android iOS Unity Flutter Android (Eski)

Bu kılavuzda, teklifli sistem entegrasyonlarını kapsayan uyumlulaştırma özelliğini kullanarak Meta Audience Network'ten reklam yüklemek ve göstermek için Google Mobile Ads Unity Plugin aracını nasıl kullanacağınız açıklanmaktadır. Bu açıklamalar, Meta Audience Network'ün bir reklam biriminin uyumlulaştırma yapılandırmasına nasıl ekleneceğini ve Meta Audience Network'ün ve bağdaştırıcısının bir Unity uygulamasına nasıl entegre edileceğini kapsar.

Desteklenen entegrasyonlar ve reklam biçimleri

Meta Audience Network için Ad Manager uyumlulaştırma adaptörünün özellikleri şöyledir:

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 teklif verme modeline geçti.

Ön koşullar

Devam etmeden önce aşağıdakileri doğrulayın:

  • En yeni Google Mobile Ads Unity Plugin sürümü.
  • Unity Editor 5.6 veya sonraki sürümleri
  • Meta Audience Network 2.11.0 için Google Mobile Ads uyumlulaştırma eklentisi (en yeni sürüm önerilir).
  • Android'de dağıtmak için
    • Android API düzeyi 24 veya sonraki sürümler
  • iOS'te dağıtmak için
    • iOS 15.0 veya sonraki sürümlerin dağıtım hedefi
    • En yeni Meta Audience Network SDK'sı genellikle Xcode'un en yeni sürümünü gerektirir.
  • Google Mobile Ads Unity Plugin ile yapılandırılmış çalışan bir Unity projesi. Ayrıntılar için Google Mobile Ads Unity Plugin hizmetini kurma başlıklı makaleyi inceleyin.
  • Uyumlulaştırmayı ayarlayı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ında oturum açın.

    Başlayın'ı ve ardından Yeni hesap oluştur'u tıklayın.

    Zorunlu alanları işletme bilgilerinizle doldurun ve Sonraki'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 Sonraki'yi tıklayın.

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

    Uygulama ayrıntılarınızı ekleyip Sonraki'yi tıklayın.

    Android

    iOS

    Yeni bir ödeme hesabı ekle'yi tıklayarak ödeme hesabınızı oluşturun. Ödeme bilgilerinizi girmek için yeni bir sayfaya yönlendirilirsiniz. Gerekli bilgileri doldurup Sonraki'yi tıklayın.

    Uyumlulaştırma platformu olarak Google Ad Manager'ı seçin, ardından 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.

    Bitti'yi tıklayın.

    app-ads.txt dosyanızı güncelleme

    Uygulamalar İçin Yetkili Satıcılar app-ads.txt, uygulama reklamı envanterinizin yalnızca yetkili olarak tanımladığınız kanallar üzerinden satılmasını sağlamaya yardımcı olan bir IAB Tech Lab girişimidir. Reklam gelirinde önemli ölçüde kayıp yaşanmasını önlemek için bir app-ads.txt dosyası uygulamanız gerekir. Henüz yapmadıysanız Ad Manager için bir app-ads.txt dosyası oluşturun.

    Meta Audience Network için app-ads.txt uygulamasını kullanmak istiyorsanız app-ads.txt ile Yetkili Satıcıları Tanımlama başlıklı makaleyi inceleyin.

    Test modunu etkinleştirme

    Meta Audience Network test reklamlarını etkinleştirme hakkında ayrıntılı talimatlar için Audience Network Uygulamasını Test Etme kılavuzuna bakın.

    2. adım: Ad Manager kullanıcı arayüzünde Meta Audience Network talebini ayarlayın

    Reklam biriminiz için uyumlulaştırma ayarlarını yapılandırma

    Android

    Talimatlar için Android kılavuzundaki 2. adıma bakın.

    iOS

    Talimatlar için iOS kılavuzundaki 2. adıma bakın.

    Meta'yı GDPR ve ABD eyalet tüzükleri reklam iş ortakları listesine ekleme

    Meta'yı Ad Manager kullanıcı arayüzündeki AB ve ABD eyalet tüzükleri reklam iş ortakları listesine eklemek için AB tüzükleri ayarları ve ABD eyalet tüzükleri ayarları bölümündeki 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 Google Mobile Ads Meta Audience Network Mediation Plugin for Unity'yi projenize yükleyebilirsiniz:

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

    OpenUPM

    Unity proje düzenleyicinizde Edit (Düzenle) > Project Settings (Proje Ayarları) > Package Manager'ı (Paket Yöneticisi) seçerek Unity Package Manager Settings'i (Unity Paket Yöneticisi Ayarları) açın.

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

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

    OpenUPM Ayrıntıları

    Ardından, Pencere > Paket Yöneticisi'ne giderek Unity Paket Yöneticisi'ni açın ve açılır menüden Kayıtlarım'ı seçin.

    Unity Registries

    Google Mobile Ads MetaAudienceNetwork Mediation 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 Eklentisi'nin en yeni sürümünü Değişiklik günlüğü'ndeki indirme bağlantısından indirin ve ZIP dosyasından GoogleMobileAdsMetaAudienceNetworkMediation.unitypackage dosyasını çıkarın.

    Unity proje düzenleyicinizde Assets (Öğeler) > Import Package (Paketi İçe Aktar) > Custom Package'ı (Özel Paket) seçin ve indirdiğiniz GoogleMobileAdsMetaAudienceNetworkMediation.unitypackage dosyasını bulun. Tüm dosyaların seçildiğinden emin olun ve İçe aktar'ı tıklayın.

    Unity'den içe aktarma

    Ardından Assets (Öğeler) > External Dependency Manager (Harici Bağımlılık Yöneticisi) > Android Resolver (Android Çözümleyici) > Force Resolve'u (Zorla Çözümle) 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.

    Çözüme Zorla

    4. adım: Meta Audience Network SDK'sındaki gizlilik ayarlarını uygulayın

    Google AB Kullanıcı Rızası Politikası'na uymak için Avrupa Ekonomik Alanı (AEA), Birleşik Krallık ve İsviçre'deki kullanıcılarınıza belirli açıklamalar yapmanız ve yasal olarak gerekli olduğu durumlarda çerez veya başka yerel depolama bilgilerinin kullanılmasının yanı sıra, kişisel verilerin reklam kişiselleştirme amacıyla toplanması, paylaşılması ve kullanılması için kullanıcıların iznini almanız gerekir. Bu politika, AB eGizlilik Yönergesi ve Genel Veri Koruma Yönetmeliği (GDPR) şartlarını yansıtmaktadır. Uyumlulaştırma zincirinizdeki her reklam kaynağına rıza bilgisinin iletildiğini doğrulamak sizin sorumluluğunuzdadır.

    GDPR ve Meta reklamcılığı hakkında bilgi edinmek için Meta'nın rehberliğini inceleyin.

    ABD eyalet gizlilik yasaları

    ABD eyaletlerindeki gizlilik yasaları, kullanıcılara "kişisel bilgilerinin" "satışının" (yasaların bu terimleri tanımladığı biçimiyle) kapsamı dışında kalma hakkı tanınmasını zorunlu kılar. Kapsam dışında kalma seçeneği, "satan" tarafın ana sayfasında belirgin bir şekilde gösterilen "Kişisel Bilgilerimi Satma" bağlantısıyla sunulur. ABD eyalet gizlilik yasalarına uygunluk rehberi, Google reklamları sunmak 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, uyumluluğu sağlamak için, uyumlulaştırma zincirinizde kişisel bilgilerin satışına katılabilecek tüm reklam ağlarını belirlemeli ve bu ağların her birinden gelen yönergeleri 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ını inceleyin.

    Reklam izleme etkin

    iOS 14 veya sonraki sürümler için geliştirme yapıyorsanız Meta Audience Network'ün Reklam İzleme İşareti'ni nasıl ayarlayacağınızla ilgili talimatlarını inceleyin.

    6. adım: Uygulamanızı test edin

    Test reklamlarını etkinleştirme

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

    Android

    Android 9'dan (API düzeyi 28) itibaren şifresiz metin desteği varsayılan olarak devre dışı bırakılmıştır. Bu durum, Meta Audience Network SDK'sı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 dokümanlarını inceleyin.

    iOS

    iOS entegrasyonları için geçerli değildir.

    Hata kodları

    Adaptör Audience Network'ten reklam alamıyorsa aşağıdaki sınıflarda 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

    Bir reklam yüklenemediğinde Meta Audience Network bağdaştırıcısı tarafından verilen kodlar ve ilgili mesajlar şöyledir:

    Android

    Hata kodu Neden
    101 Sunucu parametreleri geçersiz (ör. yerleşim kimliği eksik).
    102 İstenen reklam boyutu, Meta Audience Network tarafından desteklenen bir banner boyutuyla eşleşmiyor.
    103 Yayıncı, Activity bağlamıyla reklam isteğinde bulunmalıdır.
    104 Meta Audience Network SDK'sı başlatılamadı.
    105 Yayıncı, birleştirilmiş doğal reklamlar için istekte bulunmadı.
    106 Yüklenen doğal reklam, beklenenden farklı bir nesnedir.
    107 Kullanılan Context nesnesi geçersiz.
    108 Yüklenen reklamda gerekli doğal reklam öğeleri eksik.
    109 Teklif yükünden doğal reklam oluşturulamadı.
    110 Meta Audience Network SDK'sı, geçiş reklamını/ödüllü reklamını sunamadı.
    111 Meta Audience Network AdView nesnesi oluşturulurken istisna oluştu.
    1000-9999 Meta Audience Network, SDK'ya özgü bir hata döndürdü. Daha fazla ayrıntı için Meta Audience Network'ün belgelerini inceleyin.

    iOS

    Hata kodu Neden
    101 Sunucu parametreleri geçersiz (ör. yerleşim kimliği eksik).
    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ş reklamını/ödüllü reklamını sunamadı.
    105 Banner reklamın kök görünüm denetleyicisi nil.
    106 Meta Audience Network SDK'sı başlatılamadı.
    1000-9999 Meta Audience Network, SDK'ya özgü bir hata döndürdü. Daha fazla ayrıntı 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.20.1

    Sürüm 3.20.0

    Sürüm 3.19.0

    Sürüm 3.18.7

    Sürüm 3.18.6

    Sürüm 3.18.5

    3.18.4 sürümü

    3.18.3 sürümü

    3.18.2 sürümü

    Sürüm 3.18.1

    3.18.0 sürümü

    3.17.3 sürümü

    Sürüm 3.17.2

    Sürüm 3.17.1

    3.17.0 sürümü

    Sürüm 3.16.0

    Sürüm 3.15.0

    3.14.0 sürümü

    3.13.1 sürümü

    3.13.0 sürümü

    Sürüm 3.12.2

    Sürüm 3.12.1

    3.12.0 sürümü

    3.11.0 sürümü

    Sürüm 3.10.0

    Sürüm 3.9.1

    Sürüm 3.9.0

    3.8.0 sürümü

    3.7.0 sürümü

    3.6.1 sürümü

    Sürüm 3.6.0

    3.5.0 sürümü

    3.4.0 sürümü

    Sürüm 3.3.2

    Sürüm 3.3.1

    3.3.0 sürümü

    3.2.0 sürümü

    Sürüm 3.1.0

    3.0.0 sürümü

    2.12.0 sürümü

    Sürüm 2.11.1

    Sürüm 2.11.0

    2.10.0 sürümü

    2.9.2 sürümü

    2.9.1 sürümü

    Sürüm 2.9.0

    Sürüm 2.8.1

    2.8.0 sürümü

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

    2.7.0 sürümü (Desteklenmiyor, 2.8.0 veya daha yeni bir sürüm kullanın)

    Sürüm 2.6.1 (Desteği sonlandı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ısı 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 bağdaştırıcısı sürüm 5.5.0.0'ı destekler.

    Sürüm 2.4.1

    • Facebook Android bağdaştırıcısı sürüm 5.4.1.1'i 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 bağdaştırıcısı 5.4.0.0 sürümünü destekler.
    • Facebook iOS bağdaştırıcısı sürüm 5.4.0.0'ı 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ı sürüm 5.3.0.0'ı 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ı sürüm 5.2.0.1'i 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 bağdaştırıcısı sürüm 5.1.0.1'i 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 bağdaştırıcısı sürüm 5.1.0.0'ı destekler.
    • Facebook iOS bağdaştırıcısı sürüm 5.1.0.0'ı 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 bağdaştırıcısı 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 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ı sürüm 4.28.2.1'i 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.

    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 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ı sürüm 4.28.1'i destekler.
    • Facebook iOS SDK'sı 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.