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

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

Meta Audience Network'ü teklifli sistemle entegre etme

Bu kılavuzda, teklif verme entegrasyonlarını kapsayan AdMob aracılığı ile Meta Audience Network'ten reklam yüklemek ve göstermek için Google Mobile Ads SDK'sını nasıl kullanacağınız gösterilmektedir. Bu kılavuzda, Meta Audience Network'ün bir reklam biriminin aracılık yapılandırmasına nasıl ekleneceği ve Meta Audience Network SDK'sının ve bağdaştırıcısının bir iOS uygulamasına nasıl entegre edileceği açıklanmaktadır.

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 Audience Network, 2021'de yalnızca teklif verme modeline geçti.

Şartlar

En yeni Google Mobile Ads SDK'sı
Uyumlulaştırma Başlangıç kılavuzunu tamamlama

iOS 10.0 veya sonraki bir sürümün dağıtım hedefi
Meta Audience Network adaptörü 5.10.0.0 veya daha yeni bir sürüm (en son sürüm önerilir)
En son Meta Audience Network SDK'sı genellikle Xcode'un en son sürümünü gerektirir.

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ı ekleyin ve 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 doldurun ve 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 uygulamanız 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: AdMob kullanıcı arayüzünde Meta Audience Network talebini ayarlayın

Reklam biriminiz için aracılık ayarlarını yapılandırma

Meta Audience Network'ü reklam biriminizin aracılık yapılandırmasına eklemeniz gerekir.

Öncelikle AdMob hesabınızda oturum açın. Ardından Aracılık sekmesine gidin. Değiştirmek istediğiniz mevcut bir uyumlulaştırma grubunuz varsa bu uyumlulaştırma grubunun adını tıklayarak grubu düzenleyin ve Meta Audience Network'ü reklam kaynağı olarak ekleme bölümüne geçin.

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

Reklam biçiminizi ve platformunuzu girip Devam'ı tıklayın.

Uyumlulaştırma grubunuza bir ad verin ve hedeflenecek konumları seçin. Ardından, aracılık grubu durumunu Etkin olarak ayarlayın ve Reklam Birimleri Ekle'yi tıklayın.

Bu uyumlulaştırma grubunu mevcut AdMob reklam birimlerinizden biri veya daha fazlasıyla ilişkilendirin. Ardından Bitti'yi tıklayın.

Artık seçtiğiniz reklam birimleriyle doldurulmuş reklam birimleri kartını görmelisiniz:

Meta Audience Network'ü reklam kaynağı olarak ekleme

Reklam Kaynakları bölümündeki Teklifli Sistem kartında Reklam kaynağı ekle'yi seçin. Ardından Meta Audience Network'ü seçin. .

İş ortaklığı sözleşmesi nasıl imzalanır?'ı tıklayın ve Meta Audience Network ile teklifli sistem iş ortaklığı kurun.

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

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

Ardından, önceki bölümde elde edilen Yerleşim Kimliği'ni girin. Ardından Bitti'yi tıklayın.

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

AdMob 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

CocoaPods'u kullanma (önerilir)

Aşağıdaki satırı projenizin Podfile'ına ekleyin:
```
pod 'GoogleMobileAdsMediationFacebook'
```
Komut satırından şunu çalıştırın:
```
pod install --repo-update
```

Manuel entegrasyon

iOS için Meta Audience Network SDK'sının en son sürümünü indirin ve projenizde FBAudienceNetwork.framework bağlantısını oluşturun.
Meta Audience Network bağdaştırıcısının en son sürümünü Değişiklik Günlüğü'ndeki indirme bağlantısından indirin ve projenizdeki MetaAdapter.framework ile bağlayın.

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ı'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 yerlerde ç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. Aracılık zincirinizdeki her reklam kaynağına rızanın iletildiğini doğrulamak sizin sorumluluğunuzdadır. Google, kullanıcının izin 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 reklam sunma 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 her reklam ağını tanımlamanız 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

Derleme hataları

Swift

Swift entegrasyonu için ek kod gerekmez.

Objective-C

Meta Audience Network bağdaştırıcısı 6.9.0.0 veya sonraki sürümlerde, derleme hatalarını önlemek için aşağıdaki adımları uygulayarak hedefinizin Build Settings'ine Swift yolları eklemeniz gerekir.

Hedefin Build Settings (Derleme Ayarları) bölümündeki Library Search Paths (Kitaplık Arama Yolları) altına aşağıdaki yolları ekleyin:

$(TOOLCHAIN_DIR)/usr/lib/swift/$(PLATFORM_NAME)
$(SDKROOT)/usr/lib/swift

Hedefin Build Settings (Derleme Ayarları) bölümündeki Runpath Search Paths (Çalışma Yolu Arama Yolları) altına aşağıdaki yolu ekleyin:

/usr/lib/swift

Reklam izleme etkin

iOS 14 veya sonraki sürümler için geliştirme yapıyorsanız Meta Audience Network, aşağıdaki kodu kullanarak Advertising Tracking Enabled işaretini açıkça ayarlamanızı gerektirir:

Swift

// Set the flag as true
FBAdSettings.setAdvertiserTrackingEnabled(true)

Objective-C

// Set the flag as true.
[FBAdSettings setAdvertiserTrackingEnabled:YES];

SKAdNetwork entegrasyonu

SKAdNetwork tanımlayıcılarını projenizin Info.plist dosyasına eklemek için Meta Audience Network'ün dokümanlarını inceleyin.

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

Test reklamlarını etkinleştirme

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 Network'ten test reklamları aldığınızı doğrulamak için reklam inceleyicide Meta Audience Network (Teklifli Sistem) reklam kaynaklarını kullanarak 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, extraAssets özelliğinde yayıncıya geri aktarılır.GADNativeAd Adaptör, aşağıdaki öğelerin iletilmesini destekler:

İstek parametreleri ve değerleri
`GADFBSubtitle`	Dize. Reklam alt başlığı
`GADFBSocialContext`	Dize. Reklamın sosyal bağlamı

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

Swift

let socialContext: String = nativeAd.extraAssets[GADFBSocialContext]

Objective-C

NSString *socialContext = nativeAd.extraAssets[GADFBSocialContext];

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

Meta Audience Network'ün yerel reklam biçimi, GADMediaView öğ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ı, yerel reklamlarını GADNativeAd nesneleri olarak döndürür. Aşağıdaki Yerel reklamlar alanı açıklamalarını bir GADNativeAd 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. Bunun yerine, adaptör GADMediaView öğesini video veya resimle doldurur.

Gösterim ve tıklama izleme

Aşağıdaki tabloda, Google Mobile Ads SDK'sı tarafından yerel reklam gösterimlerinin ve tıklamalarının 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ü	`GADMediaView`
Doğal banner	Uygulama simgesi	`UIImageView`

Hata kodları

Adaptör, Kitle Ağı'ndan reklam alamıyorsa aşağıdaki sınıflar altında GADResponseInfo.adNetworkInfoArray kullanarak reklam yanıtındaki temel hatayı kontrol edebilirsiniz:

GADMAdapterFacebook
GADMediationAdapterFacebook

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

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	Meta Audience Network reklam nesnesi başlatılamadı.
104	Meta Audience Network SDK, geçiş reklamını/ödüllü reklamını sunamadı.
105	Banner reklamın kök görünüm denetleyicisi `nil`.
106	Meta Audience Network SDK'sı başlatılamadı.
1000-9999	Meta Audience Network, SDK'ya özgü bir hata döndürdü. Daha fazla bilgi için Meta Audience Network'ün belgelerini inceleyin.