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

Meta Kitle Ağını 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 SDK'sının ve adaptörünün bir Android uygulamaya nasıl entegre edileceği açıklanmaktadı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 ¹
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 kullanılmaya başlandı.

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ü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 Ad Manager ayarlayın

Ad Manager hesabınızda oturum açın.

Güvenli sinyal paylaşımını etkinleştirin

Yönetici > Genel ayarlar'a gidin. Ad Exchange hesap ayarları sekmesine gidin ve Güvenli sinyal paylaşımı'nı inceleyip etkinleştirin. Save'i (Kaydet) tıklayın.

Meta teklif vermeyi yapılandırma

Ad Manager 360

Yayınlama > Teklif verenler'e gidin ve SDK Teklif Verme sekmesinde Yeni teklif veren'i tıklayın.

Teklif veren olarak Meta'yı seçin.

Bu teklif verenin sinyal kitaplığını izin verilen sinyaller listesine ekle ve Sinyallerin bu teklif verenle paylaşılmasına izin ver seçeneklerini açık duruma getirin. Ardından Devam'ı tıklayın.

Devam'ı tıklayın.

Done'ı (Bitti) tıklayın.

Ad Manager

Yayınlama > Teklif verenler'e gidin ve SDK Teklif Verme sekmesinde Yeni teklif veren'i tıklayın.

Teklif veren olarak Meta'yı seçin.

Hemen internet üzerinden kabul et'i tıklayın. Ardından, katılım sürecini başlatmak üzere Facebook'un sitesine yönlendirilmek için iletişim kutusunda Evet, kabul ediyorum'u tıklayın.

İşletme Yöneticisi hesabınızla oturum açın.

İşletmenizi seçin.

İşletmenizi seçtikten sonra aşağıdaki iletişim kutusu görüntülenir. Ad Manager'a dön'ü tıklayın.

Devam'ı tıklayın.

Done'ı (Bitti) tıklayın.

Reklam birimi eşlemeyi yapılandırın

Yayınlama > Teklif verenler'e gidin ve SDK Teklif Verme sekmesinde Meta için şirketi seçin.

Reklam birimi eşleme sekmesine gidin ve Yeni reklam birimi eşleme'yi tıklayın.

Belirli reklam birimi'ni seçin. Reklam birimi ve biçim, Envanter türü olarak Mobil uygulama ve Mobil uygulamanızı seçin. Ardından, önceki bölümden elde edilen değerini girin. Son olarak Kaydet'i tıklayın.

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

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ısının en son sürümlerini kullanın:

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

Manuel entegrasyon

Android için Meta Audience Network SDK'sının en son sürümünü indirin. AudienceNetwork/bin klasörünün altındaki AudienceNetwork.aar dosyasını çıkarın ve 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'sında gizlilik ayarlarını uygulayın

AB kullanıcı rızası ve GDPR

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ık için Meta dokümanlarındaki yönergeleri uygulayın.

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ılara yönelik veri işleme seçenekleri için Meta'nın belgelerindeki yönergeleri uygulayın.

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

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

Yerel reklamlar

Bazı Meta Audience Network yerel reklamı öğeleri, Google yerel reklam öğeleriyle bire bir eşlemez. Bu tür öğeler, NativeAd ürününde getExtras() yöntemi kullanılarak bir paketteki yayıncıya geri verilir. 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 öğesinin oluşturulmasını gerektirir. Bu öğe olmadan doğal reklamlar oluşturmayı planlıyorsanız Meta Audience Network'ün yerel banner'ını kullandığınızdan emin olun.

Bunun yerine Meta Audience Network'ün yerel banner reklamlarını kullanmak için Meta Audience Network'ü ayarlarken Native Banner biçimini seçmeniz gerekir. Adaptör, ilgili yerel reklam biçimini otomatik olarak yükler.

Reklam oluşturma

Kitle Ağı bağdaştırıcısı, yerel reklamlarını NativeAd nesneleri olarak döndürür. Aşağıdaki alanları ( NativeAd) doldurur.

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ı, yerel reklamları için ana resim öğesine doğrudan erişim sağlamaz. Bunun yerine, bağdaştırıcı MediaView değerini 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 belirtilmiştir.

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, bir gösterimin geçerli olarak kabul edilmesi için Meta Kitle Ağı'nı ayarlarken Yerel veya Yerel Banner biçimini seçip seçmemenize bağlı olarak belirli öğe oluşturma şartlarına sahiptir.

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 durum, Meta Audience Network SDK'sının medya önbelleğe alma işlevini etkileyecektir. Ayrıca, kullanıcı deneyimi ve reklam geliri etkilenebilir. Uygulamanızdaki ağ güvenliği yapılandırmasını güncellemek için Meta'nın belgelerindeki talimatları uygulayın.

Hata kodları

Bağdaştırıcı, Kitle Ağı'ndan bir reklam alamazsa aşağıdaki sınıfların altında ResponseInfo.getAdapterResponse() kullanarak reklam yanıtında temel alınan hatayı kontrol edebilirsiniz:

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

Bir reklam yüklenemediğinde Kitle Ağı bağdaştırıcısı tarafından gönderilen kodlar ve beraberindeki mesajlar aşağıda verilmiştir:

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