Ürünlerimiz hakkında görüşlerinizi paylaşmak ve geri bildirimde bulunmak için Google Advertising and Measurement Community sunucusundaki resmi Ad Manager Discord kanalına katılın.

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

Meta Audience Network'ü teklifli sistemle entegre etme

Bu kılavuz, teklif entegrasyonlarını kapsayarak uyumlulaştırma kullanarak Meta Audience Network'ten reklam yüklemek ve göstermek için Google Mobile Ads SDK'sının nasıl kullanılacağını açıklar. 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 SDK'sının ve bağdaştırıcısının bir Android uygulamasına nasıl entegre edileceğini kapsar.

Desteklenen entegrasyonlar ve reklam biçimleri

Meta Audience Network için uyumlulaştırma adaptörünün özellikleri şöyledir:

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

¹ Meta Audience Network, 2021'de yalnızca teklif verme özelliğini desteklemeye başladı.

Şartlar

En son Google Mobile Ads SDK'sı
Uyumlulaştırma Başlangıç Kılavuzu'nu tamamlayın.

Android API düzeyi 23 veya üstü

Meta Audience Network adaptörü 5.10.0.0 veya daha yeni bir sürüm (en son sürüm önerilir)

1. adım: Meta Audience Network kullanıcı arayüzünde yapılandırmaları ayarlayın

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

Başlayın'ı ve 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 istediğiniz mülk adını girin ve Sonraki'yi tıklayın.

Ardından, para kazanmak için platformunuzu seçin.

Uygulama ayrıntılarınızı ekleyip Sonraki'yi tıklayın.

Yeni ö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.

Aracılık 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.

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. Henüz yapmadıysanız Ad Manager için bir app-ads.txt dosyası oluşturun.

Meta Audience Network için app-ads.txt'yı uygulamak üzere app-ads.txt ile yetkili satıcıları belirleme 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 Rehberi'ne bakın.

2. adım: Ad Manager kullanıcı arayüzünde Meta Audience Network talebini ayarlayın

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

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

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

Teklif isteklerinde güvenli sinyal paylaşma

Envanter > Güvenli Sinyaller'e gidin. Güvenli sinyaller bölümünde Facebook'u arayın ve Uygulama entegrasyonunu etkinleştir'i açın.

Kaydet'i tıklayın.

SDK teklifli sistemi için güvenli sinyal paylaşımına izin verme

Yayınlama > Talep kanalı ayarları'na gidin. Varsayılan ayarlar sekmesinde, SDK Bidding için Güvenli sinyal paylaşımına izin ver'i etkinleştirin.

Kaydet'i tıklayın.

Meta teklifini yapılandırma

Yayınlama > Teklif Verenler'e gidin ve SDK Teklif Sistemi'ne Git'i tıklayın.

Yeni teklif veren'i tıklayın.

Teklif veren olarak Meta'yı seçin.

Bu teklif veren için SDK teklif verme özelliğini etkinleştirmek üzere Devam'ı tıklayın.

Bitti'yi tıklayın.

Reklam birimi eşlemesini yapılandırma

Yayınlama > Teklif Verenler'e gidin ve SDK Teklif Sistemi'ne Git'i tıklayın.

Meta Audience Network 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. Bir reklam birimi ve biçimi, Envanter türü olarak Mobil uygulama'yı ve Mobil uygulamanızı seçin. Ardından, önceki bölümde alınan Yerleşim Kimliği'ni girin.

Ad Manager kullanıcı arayüzünde ödüllü geçiş reklamı için reklam birimi eşlemesini yapılandırıyorsanız Ödüllü biçimini seçin ve ödüllü geçiş reklamı yerleşimi kimliğini kullanın.

Son olarak Kaydet'i tıklayın.

Meta'yı GDPR ve ABD eyalet yönetmelikleri reklam iş ortakları listesine ekleme

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

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ını 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:24.5.0")
    implementation("com.google.ads.mediation:facebook:6.20.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ündeki AudienceNetwork.aar dosyasını çıkarın ve projenize ekleyin.
Google'ın Maven deposunda Meta Audience Network bağdaştırıcı 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ı indirip projenize ekleyin.

4. adım: Meta Audience Network SDK'sındaki gizlilik ayarlarını uygulayın

AB kullanıcı rızası ve GDPR

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ğunda ç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 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. Google, kullanıcının rıza seçimini bu tür ağlara otomatik olarak iletemez.

Meta, IAB Europe Küresel Tedarikçi Listesi'ne (GVL) kayıtlı değildir. Bunun yerine Ek İzin için teknik spesifikasyonu kullanmanız gerekir. Daha ayrıntılı bilgi için Ek İzin bileşenleri başlıklı makaleyi inceleyin. Ek İzin spesifikasyonu, IAB Europe Şeffaflık ve Kullanıcı Rızası Çerçevesi (TCF) sürüm 2 ile birlikte çalışır. Bu spesifikasyon; Kullanıcı Rızası Yönetim Platformları (CMP'ler) ve iş ortaklarıyla birlikte, Google reklam teknolojisi sağlayıcılar (ATP) listesinde yer alan ancak henüz IAB Europe GVL'nin bir parçası olmayan şirketler için ek izin sinyalleri toplamanıza ve iletmenize olanak tanır.

GDPR ve Meta reklamcılığı için Meta'nın dokümanlarındaki yönergeleri uygulayın.

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 veri işleme seçenekleriyle ilgili Meta'nın dokümanlarındaki 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ş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

Yerel reklamlar

Bazı Meta Audience Network yerel reklam öğeleri, Google yerel reklam öğeleriyle bire bir eşlenmez. Bu tür öğeler, NativeAd içindeki getExtras() yöntemiyle bir paket halinde yayıncıya geri iletilir. Adaptör, aşağıdaki öğelerin iletilmesini destekler:

İstek parametreleri ve değerleri
`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 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)
   // ...
}

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

Meta Audience Network'ün yerel reklam biçimi, MediaView öğesinin oluşturulmasını gerektirir. Doğal reklamları bu öğe olmadan oluşturmayı planlıyorsanız Meta Audience Network'ün doğal banner reklam biçimini 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. Bu durumda 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ı, doğal reklamlarını NativeAd nesneleri olarak döndürür. NativeAd için aşağıdaki alanları 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
Mağaza
Fiyat

¹ Meta Audience Network bağdaştırıcısı, yerel reklamları için ana resim öğesine doğrudan erişim sağlamaz. Bunun yerine, adaptör MediaView öğesini 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ı	Kaydı tıklayın.
Ekranda Meta Audience Network yerel reklam öğesinin 1 pikseli + öğe oluşturma koşulları	Meta Audience Network SDK geri araması

Meta Audience Network'ün, Meta Audience Network'ü ayarlarken Yerel veya Yerel Banner biçimini seçmenize bağlı olarak, bir gösterimin geçerli sayılması için belirli öğe oluşturma koşulları vardır.

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

Android 9'da önbelleğe alma

Android 9 (API düzeyi 28) sürümünden itibaren düz metin desteği varsayılan olarak devre dışı bırakılacak. Bu durum, Meta Audience Network SDK'sının medya önbelleğe alma işlevini etkileyecek ve kullanıcı deneyiminin yanı sıra reklam gelirini de etkileyebilecek. Uygulamanızdaki ağ güvenliği yapılandırmasını güncellemek için Meta'nın dokümanlarını inceleyin.

Hata kodları

Adaptör Kitle Ağı'ndan reklam alamıyorsa aşağıdaki sınıflarda ResponseInfo.getAdapterResponses() kullanarak reklam yanıtındaki temel hatayı kontrol edebilirsiniz:

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

Bir reklam yüklenemediğinde Audience Network bağdaştırıcısı tarafından verilen kodlar ve ilgili mesajlar şöyledir:

Hata kodu	Neden
101	Geçersiz sunucu parametreleri (ö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ında reklam isteğinde bulunmalıdır.
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 yerel reklam oluşturulamadı.
110	Meta Audience Network SDK, 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 bilgi için Meta Audience Network'ün belgelerini inceleyin.