Google, içerikleri tercih ettiğiniz dile çevirmek için yapay zeka teknolojisini kullanır. Yapay zeka çevirilerinde hata olabilir.

Meta Audience Network'ü teklifli sistemle entegre etme

Bu kılavuzda, teklifli sistem entegrasyonlarını kapsayan AdMob Uyumlulaştırması'nı kullanarak Meta Audience Network'ten reklam yüklemek ve göstermek için Google Mobile Ads SDK ürününün nasıl kullanılacağı açıklanmaktadır. 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 iOS 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 teklifli sistem kullanmaya başladı.

Ön koşullar

Devam etmeden önce aşağıdakileri doğrulayın:

iOS 15.0 veya sonraki sürüm dağıtım hedefi
Meta Audience Network bağdaştırıcısı 5.10.0.0 veya sonraki sürümler (en yeni sürüm önerilir).
En yeni Meta Audience Network SDK'sı genellikle Xcode'un en yeni sürümünü gerektirir.

En yeni Google Mobile Ads SDK sürümü.
AdMob Uyumlulaştırması'nı ayarlayın.

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

Kaydolun ve İşletme Yöneticisi başlangıç sayfasında oturum açın.

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

Ardından, para kazanmak istediğiniz platformu seçin.

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

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

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.

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

Meta Audience Network için app-ads.txt uygulamasını kullanmak istiyorsanız app-ads.txt ile Yetkili Satıcıları Tanımlama 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 kılavuzuna bakın.

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

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

Meta Audience Network'ü reklam biriminizin uyumlulaştırma yapılandırmasına eklemeniz gerekir.

Öncelikle 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 grubunun adını tıklayarak 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, uyumlulaştırma 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öreceksiniz:

Meta Audience Network'ü reklam kaynağı olarak ekleme

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

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

Onayla ve kabul et'e, 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 alınan 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

Meta'yı AdMob kullanıcı arayüzündeki 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ümündeki 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

Swift Package Manager'ı kullanma

Devam etmeden önce, desteklenen minimum adaptör sürümü olan 6.20.1.0'a sahip olmanız gerekir.

Projenize paket bağımlılığı eklemek için aşağıdaki adımları uygulayın:

Xcode'da File (Dosya) > Add Package Dependencies... (Paket Bağımlılıkları Ekle...) bölümüne gidin.

Görüntülenen istemde aşağıdaki paket URL'sini arayın:

https://github.com/googleads/googleads-mobile-ios-mediation-meta.git

Bağımlılık Kuralı'nda Dal'ı seçin.
Metin alanına main yazın.

CocoaPods'u kullanma

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

Manuel entegrasyon

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

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 ve yasal olarak gerekli olduğu durumlarda çerez veya başka yerel depolama bilgilerinin kullanılmasının yanı sıra, kişisel verilerin reklam kişiselleştirme amacıyla toplanması, paylaşılması ve kullanılması için kullanıcıların iznini 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.

Meta, IAB Europe Küresel Katılımcı Listesi'ne (GVL) kayıtlı değildir. Bunun yerine Ek İzin teknik özellikler teknik spesifikasyonunu kullanmanız gerekir. Daha fazla bilgi için Ek İzin bileşenleri başlıklı makaleyi inceleyin. Ek İzin spesifikasyonu, IAB Avrupa Şeffaflık ve Kullanıcı Rızası Çerçevesi (TCF) 2. sürüm 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 toplayıp iletmenize olanak tanır.

GDPR ve Meta reklamcılığı için Meta'nın belgelerindeki 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çenekleri hakkında Meta'nın belgelerindeki talimatları uygulayın.

5. adım: Gerekli kodu ekleme

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ümler için derleme hatalarını önlemek amacıyla aşağıdaki adımları uygulayarak Swift yollarını hedefinizin Derleme Ayarları'na eklemeniz gerekir.

Hedefin Build Settings (Derleme Ayarları) bölümündeki Library Search Paths (Kitaplık Arama Yolları) kısmı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 (Runpath Arama Yolları) altına aşağıdaki yolu ekleyin:

/usr/lib/swift

Reklam izleme etkin

iOS 14 veya sonraki sürümler için uygulama geliştiriyorsanız Meta Audience Network, aşağıdaki kodu kullanarak Reklam İzleme Etkin işaretini açıkça ayarlamanızı gerektirir:

Swift

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

Objective-C

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

SKAdNetwork'ü uygulama

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 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 doğal reklam öğeleri, Google doğal reklam öğeleriyle bire bir eşleşmez. Bu tür öğeler, GADNativeAd öğesinin extraAssets mülkünde yayıncıya geri iletilir. Bağdaştırıcı, 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 = nativeAd.extraAssets?[GADFBSocialContext] as? StringMetaMediationSwiftSnippets.swift

Objective-C

NSString *socialContext = nativeAd.extraAssets[GADFBSocialContext];MetaMediationObjectiveCSnippets.m

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

Meta Audience Network'ün doğal 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 doğal banner reklamlarını kullanmak için Meta Audience Network'ü ayarlarken Native Banner biçimini seçmeniz gerekir. Uyumlulaştırıcı, ilgili doğal reklam biçimini otomatik olarak yükler.

Reklam oluşturma

Audience Network bağdaştırıcısı, doğal reklamları GADNativeAd nesneleri olarak döndürür. GADNativeAd için aşağıdaki Doğal reklam alan açıklamalarını doldurur.

Alan	Meta Audience Network bağdaştırıcısı tarafından doldurulur
Başlık
Resim	1
Body
Uygulama simgesi
Harekete geçirici mesaj
Reklamveren Adı
Yıldız puanı
Mağaza
Fiyat

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

Gösterim ve tıklama izleme

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

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ğırma işlevi

Meta Audience Network, bir gösterimin geçerli sayılması için belirli öğe oluşturma şartlarına sahiptir. Bu şartlar, Meta Audience Network'ü ayarlarken Doğal veya Doğal Banner biçimini seçip seçmediğinize bağlıdır.

Meta Audience Network doğal 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 Audience Network'ten reklam alamıyorsa aşağıdaki sınıflarda GADResponseInfo.adNetworkInfoArray kullanarak reklam yanıtındaki temel hatayı kontrol edebilirsiniz:

GADMAdapterFacebook
GADMediationAdapterFacebook

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	Sunucu parametreleri geçersiz (ö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'sı, 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.