Bu sayfa, Cloud Translation API ile çevrilmiştir.

Meta Audience Network'ü teklifli sistemle entegre etme

Bu kılavuzda, teklif verme entegrasyonlarını kapsayan uyumlulaştırma yöntemini kullanarak Meta Audience Network'ten reklam yüklemek ve reklam göstermek için Google Mobile Ads SDK'sının nasıl kullanılacağı gösterilmektedir. Bu makalede, reklam biriminin uyumlulaştırma yapılandırmasına Meta Audience Network'ün nasıl ekleneceği ve Meta Audience Network SDK ile bağdaştırıcının bir uygulamaya nasıl Android entegre edileceği ele alınmaktadır.

Desteklenen entegrasyonlar ve reklam biçimleri

Meta Kitle Ağı için AdMob uyumlulaştırma bağdaştırıcısının özellikleri aşağıdaki gibidir:

Entegrasyon
Teklif
Şelale ¹
Formatlar
Banner
Geçişli
Ödül olarak verildi
Ödüllü Geçiş Reklamı
Yerel biçim

¹ Meta Audience Network, 2021'de yalnızca teklifli sistem olarak değişti.

Koşullar

En son Google Mobile Ads SDK'sı
Uyumlulaştırmayı tamamlayın Başlangıç kılavuzu

Android API düzeyi 21 veya üstü

Meta Audience Network bağdaştırıcısı 5.10.0.0 veya sonraki sürümleri (en son sürüm önerilir)

1. Adım: Meta Audience Network kullanıcı arayüzünde yapılandırmaları ayarlama

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.

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 talebi AdMob oluşturun

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

Reklam biriminizin uyumlulaştırma yapılandırmasına Meta Audience Network 'ı eklemeniz gerekiyor.

İlk olarak, AdMob hesabınızda oturum açın. Ardından Uyumlulaştırma sekmesine gidin. Değiştirmek istediğiniz mevcut bir uyumlulaştırma grubunuz varsa bu uyumlulaştırma grubunu düzenlemek için grubun adını tıklayın ve Reklam kaynağı olarak Meta Audience Network ekle bölümüne atlayın.

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

Reklam biçimini 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 ve Reklam Birimleri Ekle'yi tıklayın.

Bu uyumlulaştırma grubunu mevcut bir veya daha fazla AdMob reklam biriminizle ilişkilendirin. Ardından Bitti'yi tıklayın.

Şimdi, seçtiğiniz reklam birimleriyle doldurulmuş reklam birimleri kartını görmeniz gerekir:

Reklam kaynağı olarak Meta Audience Network ekleyin

Reklam Kaynakları bölümündeki Teklif Verme kartının altında Reklam Kaynağı Ekle'yi seçin. Ardından Meta Audience Network simgesini seçin.

İş ortaklığı sözleşmesi imzalama'yı tıklayın veMeta Audience Networkile teklifli sistem iş ortaklığı kurun.

Onayla ve kabul et'i, ardından Devam'ı tıklayın.

Meta Audience Networkiçin zaten bir eşlemeniz varsa bunu seçebilirsiniz. Aksi takdirde, Eşleme ekle'yi tıklayın.

Sonra, önceki bölümde aldığınız Placement ID kodunu girin. Ardından Bitti'yi tıklayın.

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

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

Android Studio entegrasyonu (önerilir)

Uygulama düzeyindeki build.gradle.kts dosyanıza aşağıdaki uygulama bağımlılıklarını ve yapılandırmaları ekleyin. Meta Audience Network SDK'sının ve bağdaştırıcının en son sürümlerini kullanın:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.0.0")
    implementation("com.google.ads.mediation:facebook:6.17.0.0")
}

Manuel entegrasyon

Android için Meta Audience Network SDK'nın en son sürümünü indirin. AudienceNetwork.aar klasörünü AudienceNetwork/bin klasörü altından çıkarıp projenize ekleyin.
Google'ın Maven deposunda Meta Audience Network bağdaştırıcısı yapılarına gidin. En son sürümü seçin, Meta Audience Network bağdaştırıcısının .aar dosyasını indirin ve projenize ekleyin.

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

AB kullanıcı rızası alma ve GDPR

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ıyla ilgili belirli açıklamalar yapılması ve bu kullanıcılardan izin alınması 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 toplayabilen, alabilen veya kullanabilen ve her bir ağın kullanımı hakkında bilgi verebilecek her bir reklam ağını tanımlamanız gerekir. Google şu anda kullanıcının izin seçimini bu tür ağlara otomatik olarak aktaramamaktadır.

GDPR ve Meta reklamcılık için Meta belgelerindeki yönergeleri uygulayın.

ABD eyalet gizlilik yasaları

ABD eyalet gizlilik yasaları kullanıcılara, "kişisel bilgilerini" "satma" (yasaların bu terimleri tanımladığı şekilde) özelliğinin kapsamı dışında kalma hakkı sunmayı zorunlu kılıyor. Bu seçenek, "satan" tarafın ana sayfasında belirgin bir şekilde görünen "Kişisel Bilgilerimi Satma" bağlantısıyla sunuluyor. ABD eyalet gizlilik yasalarına uygunluk kılavuzu, Google reklam yayını 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, uyumlulaştırma zincirinizde kişisel bilgi satışına dahil olabilecek tüm reklam ağlarını belirlemeniz ve uyumluluğu sağlamak için bu ağların her birinin talimatlarını uygulamanız gerekir.

Kaliforniya'daki kullanıcılar için veri işleme seçenekleri hakkında Meta'nın belgelerindeki yönergeleri izleyin.

5. Adım: Gerekli kodu ekleyin

Meta Audience Network entegrasyonu için ek kod gerekmez.

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

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

Yerel reklamlar

Bazı Meta Audience Network yerel reklam öğeleri, Google yerel reklam öğeleriyle bire bir eşlenmez. Bu tür öğeler, NativeAd içinde getExtras() yöntemi ile bir paket içinde yayıncıya geri gönderilir. Bağdaştırıcı aşağıdaki öğelerin geçirilmesini destekler:

İstek parametreleri ve değerleri
`FacebookMediationAdapter.KEY_ID`	Dize. Yerel reklamın benzersiz kimliği
`FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET`	Dize. Reklam sosyal bağlamı

Bu öğelerin nasıl ayıklanacağını gösteren bir kod örneğini aşağıda bulabilirsiniz:

Örnek:

Java

Bundle extras = nativeAd.getExtras();
if (extras.containsKey(FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET)) {
    String socialContext = extras.getString(FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET);
    // ...
}

Kotlin

val extras = nativeAd.getExtras()
if (extras.containsKey(FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET)) {
   var socialContext = extras.getString(FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET)
   // ...
}

MediaView olmadan Meta Audience Network yerel reklamlarını kullanma

Meta Audience Network'ün yerel reklam biçimi, MediaView öğesinin oluşturulmasını gerektirir. Bu öğe olmadan yerel reklamlar oluşturmayı planlıyorsanız Meta Audience Network'ün yerel banner'ını reklam biçimini kullandığınızdan emin olun.

Bunun yerine Meta Audience Network'ün yerel banner reklamlarını kullanmak için Meta Audience Network'ü kurarken Native Banner biçimini seçmeniz gerekir. Bağdaştırıcı, ilgili yerel reklam biçimini otomatik olarak yükleyecektir.

Reklam oluşturma

Audience Network bağdaştırıcısı, yerel reklamlarını NativeAd nesne olarak döndürür. Aşağıdaki Doğal reklamlar alanı açıklamaları bir NativeAd için doldurur.

Alan	Meta Audience Network bağdaştırıcısı tarafından doldurulur
Başlık
Resim	1
Metin
Uygulama simgesi
Harekete geçirici mesaj
Reklamveren Adı
Yıldızlı değerlendirme
Depolama
Fiyat

¹ Meta Audience Network bağdaştırıcısı, yerel reklamlar için ana resim öğesine doğrudan erişim sağlamaz. Bağdaştırıcı, MediaView öğesini bir video veya resimle doldurur.

Gösterim ve tıklama izleme

Aşağıdaki tabloda, yerel reklam gösterimlerinin ve tıklamalarının Google Mobile Ads SDK'sı tarafından ne zaman kaydedildiği vurgulanmaktadır.

Gösterim kaydı	Tıklama kaydı
Ekranda 1 piksel Meta Audience Network yerel reklam öğesi + öğe oluşturma şartları	Meta Audience Network SDK geri çağırması

Meta Audience Network, Meta Audience Network'ü kurarken Yerel veya Yerel Banner biçimini seçip seçmemenize bağlı olarak bir gösterimin geçerli olarak kabul edilmesi için belirli öğe oluşturma şartlarına sahiptir.

Meta Audience Network yerel biçimi	Gerekli öğe	Gerekli oluşturma sınıfı
Yerel biçim	Medya Görünümü	`MediaView`
Yerel Banner	Uygulama simgesi	`ImageView`

Android 9'da önbelleğe alma

Android 9'dan (API düzeyi 28) başlayarak, cleartext desteği varsayılan olarak devre dışıdır. Bu, Meta Audience Network SDK'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 belgelerine bakın.

Hata kodları

Bağdaştırıcı, Audience Network'ten reklam alamazsa aşağıdaki sınıfların altında ResponseInfo.getAdapterResponse() kullanarak reklam yanıtındaki temel hatayı kontrol edebilirsiniz:

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

Aşağıda, bir reklam yüklenemediğinde Kitle Ağı bağdaştırıcısı tarafından atılan kodlar ve eşlik eden mesajlar verilmiştir:

Hata kodu	Neden
101	Geçersiz sunucu parametreleri (ör. eksik Yerleşim Kimliği).
102	İstenen reklam boyutu, Meta Audience Network 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 yok.
109	Teklif yükünden yerel 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ılır.
101	Geçersiz sunucu parametreleri (ör. eksik Yerleşim Kimliği).
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ş/ödüllü reklamını gösteremedi.
105	Banner reklamın kök görüntüleme denetleyicisi `nil` şeklindedir.
106	Meta Audience Network SDK'sı başlatılamadı.
1000-9999	Meta Audience Network SDK'ya özel bir hata döndürdü. Daha fazla bilgi için Meta Audience Network'ün belgelerini inceleyin.