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

Meta Audience Network'ü teklifli sistemle entegre etme

Bu kılavuzda, reklam öğelerinizi yüklemek ve görüntülemek için Google Mobile Ads SDK'sının nasıl kullanan Meta Audience Network reklamları AdMob Uyumlulaştırması, ele alacağız. Burada, Meta Kitle Ağı'nın bir reklam biriminin uyumlulaştırma yapılandırması ve Meta Kitle'nin nasıl entegre edileceği Ağ SDK'sı ve bağdaştırıcısını bir uygulamaya Android dönüştürün.

Desteklenen entegrasyonlar ve reklam biçimleri

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

Entegrasyon
Teklif verme
Şelale ¹
Formatlar
Banner
Geçiş reklamı
Ödüllü
Ödüllü geçiş reklamı
Yerel biçim

¹ Meta Kitle Ağı haline geldi yalnızca teklif verme artış oldu.

Şartlar

En son Google Mobile Ads SDK'sı
Arabuluculuğu tamamlama Başlangıç kılavuzu

Android API düzeyi 21 veya üstü

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

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.

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 AdMob ayarlayın

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 ekleyin

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 uygulamayı ekleyin ve yapılandırmaları içerir. Meta kitlenin en son sürümlerini kullanın Ağ SDK'sı ve bağdaştırıcı:

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

Manuel entegrasyon

Şunun için Meta Audience Network SDK'sının en son sürümünü indirin: Android. AudienceNetwork.aar klasörünü AudienceNetwork/bin klasöründen çıkarın ve projenize ekleyin.
Meta Audience Network bağdaştırıcısına gidin yapılar Google'ın Maven deposunda. En son sürümü seçin, Meta'yı indirin Kitle Ağ bağdaştırıcısının .aar dosyasını kullanarak dosyayı projenize ekleyin.

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

AB kullanıcı rızası ve GDPR

Google AB Kullanıcı İzni kapsamında Politika uyarınca, belirli bilgilerin ifşa edildiğinden emin olmalısınız. Avrupa Ekonomik Alanı'ndaki (AEA) kullanıcıların cihaz tanımlayıcılarının ve kişisel verilerin kullanımı. Bu politika AB eGizlilik Yönergesi ve Genel Veri Koruma şartları Düzenleme (GDPR). Rıza isterken her reklam ağını tanımlamanız gerekir kişisel verileri toplayabilecek, alabilecek veya kullanabilen uyumlulaştırma zincirinizde her ağın kullanımıyla ilgili bilgi sağlar. Google şu anda Kullanıcının izin seçimini bu tür ağlara otomatik olarak iletmelidir.

Meta'nın belgelerindeki yönergeleri uygulayın. GDPR ve Meta reklamcılık için geliştirilmiştir.

ABD eyalet gizlilik yasaları

. ABD eyalet gizlilik yasaları kullanıcılara, doğru zamanda "indirimi" devre dışı bırakmak "kişisel bilgilerinin” (kanunların bu konudaki hariç tutmanın, öne çıkan bir "Do Not Sell My Personal My Personal (Kişisel Bilgilerimi Kesinlikle Satmayın) Bilgiler" bağlantısını ile başlar. İlgili içeriği oluşturmak için kullanılan ABD eyalet gizliliği yasalara uygunluk rehberi, yasalarca belirlenen kısıtlanmış veri işleme kullanılabilir ancak Google, bu ayarı her reklama uygulayamaz. ağda yer alır. Bu nedenle, reklam ağlarının her birini kişisel satışlarına katılabilecek uyumlulaştırma zincirinizde ağlarla ilgili bilgileri takip edin ve bu ağların yönlendirmelerini izleyerek uygunluk açısından önemlidir.

Şu kılavuzdaki yönergeleri izleyin: Meta'nın belgeleri inceleyin.

5. Adım: Gerekli kodu ekleyin

Meta Audience Network entegrasyonu için ek kod gerekmez.

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

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

Biraz Meta Audience Network doğal reklamı öğeleri Google doğal reklam öğeleriyle bire bir eşleme yapmaz. Bu tür öğeler NativeAd içinde getExtras() yöntemini kullanarak bir pakette yayıncıya geri gönderilir. Bağdaştırıcı, aşağıdaki öğelerin iletilmesini destekler:

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

Bu öğelerin nasıl çıkarılacağını gösteren bir kod örneğini burada 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)
   // ...
}

Meta Audience Network doğal reklamlarını MediaView olmadan kullanma

Meta Audience Network'ün yerel reklam biçimi, . MediaView öğe. Bu öğe olmadan doğal reklamlar oluşturmayı planlıyorsanız Meta Kitle Ağı'nın . yerel banner reklam biçimi.

Bunun yerine Meta Audience Network'ün yerel banner reklamlarını kullanmak için Native Banner biçimi için Meta Kitle Ağı'nı ve bağdaştırıcı, ilgili yerel reklam biçimini otomatik olarak yükler.

Reklam oluşturma

Kitle Ağı bağdaştırıcısı, yerel reklamlarını . NativeAd nesneler'i tıklayın. Aşağıdakileri doldurur . Yerel reklamlar alanı açıklamaları - NativeAd.

Alan	Meta Audience Ağ 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 Ağ bağdaştırıcısı Ana resim öğesine doğrudan erişim sağlamaz yerel reklamları için. Bunun yerine, bağdaştırıcı, . MediaView bunu kolayca yapabilirsiniz.

Gösterim ve tıklama izleme

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

Gösterim kaydı	Tıklama kaydı
Ekranda 1 piksel Meta Audience Network doğal reklam öğesi + öğe oluşturma koşulları	Meta Audience Network SDK'sı geri çağırması

Meta Audience Network'ün aşağıdakileri karşılamak için belirli öğe oluşturma gereksinimleri vardır: geçerli olarak kabul edilecek bir gösterim seçin. Bu, seçtiğiniz Meta Kitle oluşturulurken Yerel veya Yerel Banner biçimi Ağ.

Meta Audience Network yerel biçimi	Gerekli öğe	Zorunlu 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 (API düzeyi 28) sürümünden itibaren, cleartext desteği varsayılan olarak devre dışıdır, Bu işlem, Meta Kitlenin medya önbelleğine alma işlevselliğini etkileyecektir Ağ SDK'sı, kullanıcı deneyimini ve reklam gelirini etkileyebilir. Takip et Meta'nın belgeleri kullanarak uygulamanızdaki ağ güvenliği yapılandırmasını güncelleyin.

Hata kodları

Bağdaştırıcı, Kitle Ağı'ndan bir reklam alamazsa kullanarak reklam yanıtından gelen temel hata . ResponseInfo.getAdapterResponses() şu sınıflarda:

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

Kitle Ağı tarafından gönderilen kodlar ve beraberindeki mesajlar aşağıda verilmiştir adaptörü eklemeniz gerekir:

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ı.
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ü. Görüntüleyin Meta Audience Network belgeleri inceleyebilirsiniz.