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 Flutter 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 ile bağdaştırıcısının bir Flutter 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ı
Yerel biçim

1 Meta Audience Network, 2021'de yalnızca teklifli sistem kullanmaya başladı.

Ön koşullar

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

  • En yeni Google Mobile Ads Flutter Plugin sürümü.
  • Flutter çerçevesi 3.7.0 veya sonraki sürümler
  • 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üm dağıtım hedefi
    • En yeni Meta Audience Network SDK'sı genellikle Xcode'un en yeni sürümünü gerektirir.
  • Google Mobile Ads Flutter Plugin ile yapılandırılmış çalışan bir Flutter projesi. Ayrıntılar için Google Mobile Ads Flutter 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

    İşletme Yöneticisi Başlangıç Sayfası'na kaydolup giriş yapın.

    Başlayın'ı, 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 mülkün istediğiniz adını girin ve İleri'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. Bunu 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ılavuzu'na göz atı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ımı inceleyin.

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

    Ad Manager kullanıcı arayüzünde Meta'yı AB ve ABD eyalet düzenlemeleri reklam iş ortakları listesine eklemek için AB tüzükleri ayarları ve ABD eyalet düzenlemeleri ayarları bölümlerindeki 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

    pub.dev üzerinden entegrasyon

    Paketinizin pubspec.yaml dosyasına Meta Audience Network SDK'sının ve bağdaştırıcısının en yeni sürümleriyle birlikte aşağıdaki bağımlılığı ekleyin:

    dependencies:
  gma_mediation_meta: ^1.7.1

    Manuel Entegrasyon

    Meta Audience Network için Google Mobil Reklamlar uyumlulaştırma eklentisinin en yeni sürümünü indirin, indirilen dosyayı ayıklayın ve ayıklanan eklenti klasörünü (ve içeriğini) Flutter projenize ekleyin. Ardından, aşağıdaki bağımlılığı ekleyerek pubspec.yaml dosyanızda eklentiye referans verin:

    dependencies:
  gma_mediation_meta:
    path: path/to/local/package

    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, yasal olarak gerekli olduğu durumlarda çerezlerin veya diğer yerel depolama alanlarının kullanımı ve reklam kişiselleştirme için kişisel verilerin toplanması, paylaşılması ve kullanılması konusunda kullanıcılarınızın rızasını 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ılır. Bu durum, Meta Audience Network SDK'sının medya önbelleğe alma işlevini etkiler ve kullanıcı deneyiminin yanı sıra reklam gelirini de etkileyebilir. Uygulamanızdaki ağ güvenliği yapılandırmasını güncellemek için Meta'nın belgelerini 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 nesne.
    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 Flutter Uyumlulaştırma Adaptörü Değişiklik Günlüğü

    Sürüm 1.7.1

    Sürüm 1.7.0

    Sürüm 1.6.0

    Sürüm 1.5.4

    Sürüm 1.5.3

    Sürüm 1.5.2

    Sürüm 1.5.1

    Sürüm 1.5.0

    Sürüm 1.4.3

    Sürüm 1.4.2

    Sürüm 1.4.1

    Sürüm 1.4.0

    Sürüm 1.3.0

    Sürüm 1.2.0

    Sürüm 1.1.0

    Sürüm 1.0.1

    Sürüm 1.0.0