Meta Audience Network'ü teklifli sistemle entegre etme

Bu kılavuzda, teklif entegrasyonlarını kapsayan uyumlulaştırma aracılığıyla Meta Audience Network'ten reklam yüklemek ve görüntülemek için Google Mobile Ads SDK'sının nasıl kullanılacağı gösterilmektedir. Bu makalede, bir reklam biriminin uyumlulaştırma yapılandırmasına Meta Audience Network'ün nasıl ekleneceği ve Meta Audience Network'ün bir uygulamaya entegre Flutter edilmesi ele alınmaktadır.

Desteklenen entegrasyonlar ve reklam biçimleri

Meta Audience Network Ad Manager uyumlulaştırma bağdaştırıcısı aşağıdaki özelliklere sahiptir:

Entegrasyon
Teklif
Şelale  1
Formatlar
Banner
Geçişli
Ödül olarak verildi
Ödüllü geçiş reklamı

1 Meta Audience Network, 2021'de yalnızca teklifli sistem olarak kullanılmaya başlandı.

Koşullar

  • En son Google Mobile Ads SDK'sı
  • Flutter 3.7.0 veya sonraki sürümler
  • Android'de dağıtım yapmak için
    • Android API düzeyi 21 veya üstü
  • iOS'te dağıtım yapmak için
    • 10.0 veya sonraki bir iOS dağıtım hedefi
    • En yeni Meta Audience Network SDK'sı genellikle Xcode'un en yeni sürümünü gerektirir.
  • Google Mobile Ads SDK'sı ile yapılandırılmış, çalışan bir Flutter proje. Ayrıntılar için Başlarken bölümüne bakın.
  • 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 Ad Manager ayarlayın

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

Android

Talimatlar için Android Android.

iOS

Talimatlar için iOS rehberinin 2. adımına göz atın. iOS.

GDPR ve ABD eyalet düzenlemeleri reklam iş ortakları listesine Facebook ekleyin

GDPR ayarları ve ABD eyalet yönetmelikleri ayarları bölümündeki adımları uygulayarak Ad Manager 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

pub.dev üzerinden entegrasyon

Aşağıdaki bağımlılığı paketinizin pubspec.yaml dosyasınaMeta Audience Network SDK ve bağdaştırıcının en son sürümleriyle ekleyin:

dependencies:
  gma_mediation_meta: ^1.0.0

Manuel Entegrasyon

Meta Audience Network için Google Mobile Ads uyumlulaştırma eklentisinin en son sürümünü indirin, indirilen dosyayı çıkarı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ızdaki eklentiye başvurun:

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

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

Google AB Kullanıcı Rızası Politikası uyarınca, cihaz tanımlayıcıların ve kişisel verilerin kullanımıyla ilgili olarak Avrupa Ekonomik Alanı'ndaki (AEA) kullanıcılara belirli açıklamaların yapıldığından ve bu kullanıcılardan alınan izinlerin alındığından emin olmanız gerekir. Bu politika AB eGizlilik Yönergesi ve Genel Veri Koruma Yönetmeliği (GDPR) gereksinimlerini yansıtmaktadır. İzin isterken uyumlulaştırma zincirinizde kişisel verileri toplayabilecek, alabilecek veya kullanabilecek tüm reklam ağlarını tanımlamalı ve her ağın kullanımı hakkında bilgi sağlamalısınız. Google şu anda kullanıcının izin seçimini bu tür ağlara otomatik olarak aktaramamaktadır.

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

ABD eyalet gizlilik yasaları

ABD eyalet gizlilik yasaları kullanıcılara, "kişisel bilgilerinin" "satılmasını" (yasaların bu terimlerin tanımladığı şekilde) devre dışı bırakma seçeneği sunmasını gerektirir. Bu seçenek, "satan" tarafın ana sayfasında belirgin bir şekilde görünen "Kişisel Bilgilerimi Kesinlikle Satmayın" bağlantısıyla sunulur. ABD eyalet gizlilik yasalarına uygunluk kılavuzu, Google reklam sunumu için kısıtlanmış veri işlemeyi etkinleştirme olanağı sunar. Ancak Google, bu ayarı uyumlulaştırma zincirinizdeki tüm reklam ağlarına uygulayamaz. Bu nedenle, uyumlulaştırma zincirinizde kişisel bilgi satışına katılabilecek her bir reklam ağını belirlemeli ve uygunluğu sağlamak için bu ağların her birinin talimatlarını takip etmelisiniz.

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 belgelerindeki talimatları uygulayın.

Reklam izleme etkin

iOS 14 veya sonraki bir sürüm için derliyorsanız Meta Audience Network'ün Reklam İzleme İşaretini nasıl ayarlayacağınızla ilgili talimatlarını kontrol edin.

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

Test reklamlarını etkinleştir

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 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 varsayılan olarak devre dışıdır. Bu durum, Meta Audience Network SDK'sının medya önbelleğe alma işlevini etkileyecektir. Ayrıca, kullanıcı deneyimini ve reklam gelirini etkileyebilir. Uygulamanızdaki ağ güvenliği yapılandırmasını güncellemek için Meta'nın belgelerini uygulayın.

iOS

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

Hata kodları

Bağdaştırıcı, Kitle Ağı'ndan bir reklam alamazsa reklam yanıtında altta yatan hatayı ResponseInfo kullanarak aşağıdaki sınıflarda 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 gönderilen kodlar ve beraberindeki mesajlar şunlardır:

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ü. Daha fazla ayrıntı için Meta Audience Network'ün belgelerine bakın.

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ü. Daha fazla ayrıntı için Meta Audience Network'ün belgelerine bakın.

Meta Audience Network Flutter Uyumlulaştırma Bağdaştırıcısı Değişiklik Günlüğü

1.0.1

  • Ana makine platformlarıyla doğru uyumluluk analizine olanak tanımak için dart sınıfı eklendi.
  • Meta Android bağdaştırıcısı sürüm 6.17.0.0 ile uyumluluk doğrulandı
  • Meta iOS bağdaştırıcısı sürüm 6.15.0.0 ile uyumluluk doğrulandı
  • Google Mobile Ads Flutter Eklentisi sürüm 5.1.0 ile geliştirilmiş ve test edilmiştir.

1.0.0

  • İlk sürüm.
  • Meta Android bağdaştırıcısı sürüm 6.17.0.0 ile uyumluluk doğrulandı
  • Meta iOS bağdaştırıcısı sürüm 6.15.0.0 ile uyumluluk doğrulandı
  • Google Mobile Ads Flutter eklentisi 5.0.0 sürümü ile geliştirilmiş ve test edilmiştir.