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

Meta Audience Network'ü teklifli sistemle entegre etme

Bu kılavuzda, Meta Audience Network'ten reklam yüklemek ve görüntülemek için Google Mobile Ads SDK'sını nasıl kullanacağınız gösterilmektedir. Bu kılavuzda, teklif entegrasyonları da ele alınmaktadır. Meta Audience Network'in 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ı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 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 olarak değişti.

Şartlar

En son Google Mobile Ads SDK'sı
Uyumlulaştırmayı tamamlama Başlangıç kılavuzu

10.0 veya sonraki bir iOS dağıtım hedefi
Meta Audience Network adaptörü 5.10.0.0 veya sonraki sürümler (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

Kaydolup İşletme Yöneticisi Başlangıç sayfasına giriş yapın.

Başlayın'ı ve ardından Yeni hesap oluştur'u tıklayın.

Zorunlu alanları işletme ayrıntılarınızla 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 mülkün istediğiniz adını girin ve İleri'yi tıklayın.

Ardından, para kazanacağınız platformu 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ı oluşturun. Ödeme bilgilerinizi girmeniz için yeni bir sayfaya yönlendirilirsiniz. Gerekli bilgileri doldurun ve ardından Sonraki'yi tıklayın.

Uyumlulaştırma platformu olarak Google AdMob'u seçin ve ardından 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.

Test modunu etkinleştirme

Meta Audience Network test reklamlarını etkinleştirmeyle ilgili ayrıntılı talimatlar için Audience Network Uygulamasını Test Etme kılavuzuna 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 gidin, Güvenli sinyal paylaşımı'nı inceleyip etkinleştirin. Kaydet'i tıklayın.

Meta teklifli sistemi yapılandırma

Ad Manager 360

Yayınlama > Teklif verenler'e gidin ve SDK Teklif Sistemi sekmesinin altında 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 etkinleştirin. Ardından Devam'ı tıklayın.

Devam'ı tıklayın.

Bitti'yi tıklayın.

Ad Manager

Yayınlama > Teklif verenler'e gidin ve SDK Teklif Sistemi sekmesinin altında Yeni teklif veren'i tıklayın.

Teklif veren olarak Meta'yı seçin.

Hemen internetten katıl'ı tıklayın. Ardından, ilk katılım sürecini başlatmak için Facebook'un sitesine yönlendirilmek üzere 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österilir. Ad Manager'a dön'ü tıklayın.

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 sekmesinin altında Meta için şirketi seçin.

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

Belirli bir 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 elde edilen Yerleşim Kimliği'ni girin. 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 GDPR ve ABD eyalet düzenlemeleri reklam iş ortakları listesine Meta eklemek için GDPR ayarlarındaki ve ABD eyalet düzenlemeleri ayarlarındaki 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)

Projenizin Podfile dosyasına aşağıdaki satırı 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 FBAudienceNetwork.framework bağlantısını projenize ekleyin.
Değişiklikler Günlüğü'ndeki indirme bağlantısından Meta Audience Network bağdaştırıcının en son sürümünü indirin ve MetaAdapter.framework bağlantısını projenize ekleyin.

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

AB kullanıcı rızası ve GDPR

Google AB Kullanıcı Rızası Politikası uyarınca, Avrupa Ekonomik Alanı (AEA)'ndaki kullanıcılara cihaz tanımlayıcıları ve kişisel verilerin kullanımıyla ilgili belirli açıklamaların yapılmasını ve izinlerin alınmasını sağlamanız gerekir. Bu politika, AB eGizlilik Yönergesi ve Genel Veri Koruma Yönetmeliği (GDPR) şartlarını yansıtmaktadır. İzin alırken, uyumlulaştırma zincirinizde kişisel veri toplayabilecek, alabilecek veya kullanabilecek her reklam ağını tanımlamanız ve her ağın kullanımı hakkında bilgi vermeniz gerekir. Google şu anda kullanıcının izin seçimini bu tür ağlara otomatik olarak iletememektedir.

GDPR ve Meta reklamcılığıyla ilgili Meta'nın belgelerindeki yönergeleri uygulayın.

ABD eyalet gizlilik yasaları

ABD eyalet gizlilik yasaları, kullanıcılara "kişisel bilgilerinin" "satışının" (bu terimlerin yasalardaki tanımlarına uygun şekilde) kapsamı dışında kalma hakkı sunmayı zorunlu kılar. Kapsam dışında kalma seçeneği, "satan" tarafın ana sayfasında belirgin bir şekilde görünen "Kişisel Bilgilerimi Kesinlikle Satmayın" gibi bir bağlantıyla sunulur. ABD eyalet gizlilik yasaları 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 her reklam ağına uygulayamaz. Bu nedenle, uyumlulaştırma zincirinizde kişisel bilgilerin satışına katılabilir her reklam ağını tanımlamanız ve uyumluluğu sağlamak için bu ağların her birinin talimatlarını uygulamanız gerekir.

Kaliforniya'daki kullanıcılar için veri işleme seçenekleri hakkında Meta'nın dokümanlarındaki talimatları 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 hedefinizin Derleme Ayarları'na Swift yolları eklemek üzere aşağıdaki adımları uygulamanız gerekir.

Kitaplık Arama Yolları bölümündeki hedefin Derleme Ayarları'na aşağıdaki yolları ekleyin:

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

Aşağıdaki yolu, hedefin Derleme Ayarları'ndaki Çalışma Yolu Arama Yolları bölümüne 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 İzlemenin Etkin 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'in dokümanlarını inceleyin.

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 doğal reklam öğeleri, Google doğal reklam öğeleriyle bire bir eşleşmez. Bu tür öğeler, GADNativeAd mülkündeki extraAssets mülkünde yayıncıya geri aktarılır. 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ği aşağıda verilmiştir:

Swift

let socialContext: String = nativeAd.extraAssets[GADFBSocialContext]

Objective-C

NSString *socialContext = nativeAd.extraAssets[GADFBSocialContext];

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

Meta Audience Network'in yerel reklam biçimi, öğenin oluşturulmasını gerektirir. GADMediaView Yerel reklamları bu öğe olmadan oluşturmayı planlıyorsanız Meta Audience Network'in yerel banner reklam biçimini kullandığınızdan emin olun.

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

Reklam oluşturma

Audience Network bağdaştırıcısı, yerel reklamlarını GADNativeAd nesneler olarak döndürür. GADNativeAd için aşağıdaki alanlar doldurulur.

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ı, doğal reklamları için ana resim öğesine doğrudan erişim sağlamaz. Bunun yerine, adaptör GADMediaView alanına bir video veya resim doldurur.

Gösterim ve tıklama izleme

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

Gösterim kaydı	Kaydı tıklayın
Ekrandaki 1 piksel Meta Audience Network doğal reklam öğesi + öğe oluşturma şartları	Meta Audience Network SDK geri çağırma

Meta Audience Network'i ayarlarken yerel veya yerel banner biçimini seçtiğinize bağlı olarak, bir gösterimin geçerli olarak kabul edilmesi için Meta Audience Network'in belirli öğe oluşturma koşulları vardır.

Meta Audience Network yerel biçimi	Zorunlu öğe	Gerekli oluşturma sınıfı
Yerel biçim	Medya Görünümü	`GADMediaView`
Yerel 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üklenemezse Audience Network bağdaştırıcısı tarafından oluşturulan kodlar ve bunlarla ilişkili 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'sı geçiş reklamını/ödüllü reklamı gösteremedi.
105	Banner reklamın kök görüntü kontrolörü `nil`.
106	Meta Audience Network SDK'sı başlatılamadı.
1000-9999	Meta Audience Network, SDK'ya özgü bir hata döndürmüştür. Daha fazla bilgi için Meta Audience Network'in dokümanlarını inceleyin.

Meta Audience Network iOS Uyumlulaştırma Adaptörü Değişiklik Günlüğü