Bu kılavuz, uyumlaştırma kullanarak Moloco'dan reklam yüklemek ve göstermek için Google Mobile Ads SDK'sının nasıl kullanılacağını teklif entegrasyonlarını kapsayarak açıklar. Bu açıklamalar, Moloco'nun bir reklam biriminin uyumlaştırma yapılandırmasına nasıl ekleneceğini ve Moloco 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
Moloco için arabuluculuk bağdaştırıcısında aşağıdaki özellikler bulunur:
Entegrasyon | |
---|---|
Teklifli sistem | |
Şelale | |
Formatlar | |
Uygulama Açma | |
Banner | |
Geçiş reklamı | |
Ödüllü | |
Ödüllü geçiş reklamı | |
Doğal |
Gereksinimler
iOS 12.0 veya üzeri sürüm dağıtım hedefi
Moloco bağdaştırıcısı 3.9.1.0 veya sonraki sürümler
En son Google Mobile Ads SDK'sı
Uyumlulaştırma Başlangıç Kılavuzunu tamamlayın.
1. adım: Moloco kullanıcı arayüzünde yapılandırmaları ayarlayın
Moloco Yayıncı Portalı'na giriş yapın.
Genel Bakış > Uygulamalar sekmesine gidin ve yeni bir uygulama oluşturmak için Uygulama Ekle düğmesini tıklayın.

Uygulamanız için İşletim Sistemi ve Gizlilik Ayarları'nı seçin, formun geri kalanını doldurun ve Oluştur'u tıklayın.

Uygulamanız oluşturulduktan sonra, ayrıntıları görüntülemek için Uygulamalar sekmesinden uygulamayı seçin ve Uygulama Anahtarı'nı not alın.

Genel Bakış > Reklam Birimleri sekmesine gidin, açılır menüden uygulamayı seçin ve Yeni Reklam Birimi'ni tıklayın.

Açık artırma yöntemi olarak Uygulama içi teklif verme'yi seçin ve formun geri kalanını doldurun. Ardından Oluştur'u tıklayın.

Ayrıntılarını görüntülemek için Reklam Birimleri sekmesinde yeni oluşturduğunuz reklam birimine gidin. Reklam birimi kimliğini not edin.

2. adım: Ad Manager kullanıcı arayüzünde Moloco 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 Moloco Ads SDK'yı 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.
Moloco 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 Moloco Ads'i 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.
Moloco Ads SDK 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 Uygulama Anahtarı ve Reklam Birimi Kimliği'ni girin.
Son olarak Kaydet'i tıklayın.
Moloco Ads'i AB ve ABD eyalet tüzükleri reklam iş ortakları listesine ekleme
Ad Manager kullanıcı arayüzünde Moloco Ads'i AB ve ABD eyalet yönetmelikleri reklam iş ortakları listesine eklemek için AB tüzükleri ayarları ve ABD eyalet yönetmelikleri ayarları bölümlerindeki adımları uygulayın.
3. adım: Moloco 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 'GoogleMobileAdsMediationMoloco'
Komut satırından şunu çalıştırın:
pod install --repo-update
4. adım: Moloco 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.
Moloco SDK, izin bilgilerini Moloco SDK'ya iletmek için
hasUserConsent
işaretini içerir.
Aşağıdaki örnek kodda, izin bilgilerinin Moloco SDK'sına nasıl iletileceği gösterilmektedir. Bu işaretleri ayarlamayı seçerseniz Google Mobile Ads SDK'sı üzerinden reklam istemeden önce yapmanız önerilir.
Swift
import MolocoSDK
// ...
MolocoPrivacySettings.hasUserConsent = true;
Objective-C
#import <MolocoSDK/MolocoSDK-Swift.h>
// ...
[MolocoPrivacySettings setHasUserConsent:YES];
Daha fazla bilgi için Moloco'nun Gizlilik belgelerine bakı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.
Moloco SDK, izin bilgilerini Moloco SDK'ya iletmek için isDoNotSell
işaretini içerir.
Aşağıdaki örnek kodda, izin bilgilerinin Moloco SDK'sına nasıl iletileceği gösterilmektedir. Bu işaretleri ayarlamayı seçerseniz Google Mobile Ads SDK'sı üzerinden reklam istemeden önce yapmanız önerilir.
Swift
import MolocoSDK
// ...
MolocoPrivacySettings.isDoNotSell = true;
Objective-C
#import <MolocoSDK/MolocoSDK-Swift.h>
// ...
[MolocoPrivacySettings setIsDoNotSell:YES];
Daha fazla bilgi için Moloco'nun Gizlilik belgelerine bakın.
5. adım: Uygulamanızı test edin
Test reklamlarını etkinleştirme
Ad Manager için test cihazınızı kaydettiğinizden emin olun.
Test reklamlarını doğrulama
Moloco Ads SDK'sından test reklamları aldığınızı doğrulamak için Moloco (Teklifli Sistem) reklam kaynaklarını kullanarak reklam inceleyicide tek reklam kaynağı testini etkinleştirin.
Hata kodları
Adaptör Moloco'dan reklam alamıyorsa aşağıdaki sınıflarda
GADResponseInfo.adNetworkInfoArray
kullanarak reklam yanıtındaki temel hatayı kontrol edebilirsiniz:
MolocoSDK.MolocoError
GADMediationAdapterMoloco
Bir reklam yüklenemediğinde Moloco bağdaştırıcısı tarafından verilen kodlar ve ilgili mesajlar şöyledir:
Hata kodu | Alan adı | Neden |
---|---|---|
101 | com.google.ads.mediation.moloco | Moloco SDK, iOS 12 ve önceki sürümlerde reklam yayınlamayı desteklemez. |
102 | com.google.ads.mediation.moloco | Eksik veya geçersiz Moloco uygulama anahtarı. |
103 | com.google.ads.mediation.moloco | Eksik veya geçersiz Moloco reklam birimi kimliği. |
104 | com.google.ads.mediation.moloco | Reklam gösterilmeye hazır değil. |
105 | com.google.ads.mediation.moloco | Reklam gösterilemedi. |
106 | com.google.ads.mediation.moloco | Reklamın oluşturulması için oluşturma verileri kullanılamıyor. |
-1 ila 5000 | Moloco SDK tarafından gönderildi | Moloco SDK bir hata döndürdü. Daha fazla ayrıntı için Moloco'nun belgelerini inceleyin. |
Ödüllü sunucu tarafı doğrulama
Sunucu tarafı doğrulama (SSV) geri çağırmalarını doğruluyorsanız Moloco'nun reklam kaynağı tanımlayıcısı 8267622065755668722
olur.
Moloco iOS Uyumlulaştırma Adaptörü Değişiklik Günlüğü
Sürüm 3.13.0.0 (Devam ediyor)
- Çerçevelerin içindeki Info.plist'i içerir.
Sürüm 3.12.1.0
- Moloco SDK'sının 3.12.1 sürümüyle uyumluluğu doğrulandı.
Aşağıdakilerle geliştirilip test edilmiştir:
- Google Mobile Ads SDK'sı 12.8.0 sürümü.
- Moloco SDK sürümü 3.12.1.
Sürüm 3.12.0.0
- Moloco SDK'sının 3.12.0 sürümüyle uyumluluğu doğrulandı.
Aşağıdakilerle geliştirilip test edilmiştir:
- Google Mobile Ads SDK'sı 12.8.0 sürümü.
- Moloco SDK sürümü 3.12.0.
Sürüm 3.11.0.0
- Moloco SDK'sının 3.11.0 sürümüyle uyumluluğu doğrulandı.
Aşağıdakilerle geliştirilip test edilmiştir:
- Google Mobile Ads SDK'sı 12.6.0 sürümü.
- Moloco SDK'sı 3.11.0 sürümü.
Sürüm 3.10.1.0
- Moloco SDK'sının 3.10.1 sürümüyle uyumluluğu doğrulandı.
Aşağıdakilerle geliştirilip test edilmiştir:
- Google Mobile Ads SDK'sı 12.6.0 sürümü.
- Moloco SDK sürümü 3.10.1.
Sürüm 3.10.0.0
- Moloco SDK'sının 3.10.0 sürümüyle uyumluluğu doğrulandı.
Aşağıdakilerle geliştirilip test edilmiştir:
- Google Mobile Ads SDK'sı 12.5.0 sürümü.
- Moloco SDK'sı 3.10.0 sürümü.
Sürüm 3.9.1.0
- Teklifli sistem reklam biçimleri için filigran desteği eklendi.
- Orta dikdörtgen banner reklamlar yüklenirken yaşanan sorun düzeltildi.
- Moloco SDK'sının 3.9.1 sürümüyle uyumluluğu doğrulandı.
Aşağıdakilerle geliştirilip test edilmiştir:
- Google Mobile Ads SDK'sı 12.3.0 sürümü.
- Moloco SDK sürümü 3.9.1.
Sürüm 3.9.0.0
- Uyumlulaştırma platformu adı artık Moloco SDK başlatılırken ayarlanıyor.
- Moloco SDK'sının 3.9.0 sürümüyle uyumluluğu doğrulandı.
Aşağıdakilerle geliştirilip test edilmiştir:
- Google Mobile Ads SDK'sı 12.3.0 sürümü.
- Moloco SDK'sı 3.9.0 sürümü.
Sürüm 3.8.0.0
-fobjc-arc
ve-fstack-protector-all
işaretlerini etkinleştirin.- Yerel reklamlar için yıldız puanı alma sorunu düzeltildi.
- Moloco SDK'sının 3.8.0 sürümüyle uyumluluğu doğrulandı.
Aşağıdakilerle geliştirilip test edilmiştir:
- Google Mobile Ads SDK'sı 12.2.0 sürümü.
- Moloco SDK'sı 3.8.0 sürümü.
Sürüm 3.7.2.0
- Moloco SDK'sının 3.7.2 sürümüyle uyumluluğu doğrulandı.
- Yerel reklam biçimi için teklif verme desteği eklendi.
Aşağıdakilerle geliştirilip test edilmiştir:
- Google Mobile Ads SDK'sı 12.1.0 sürümü.
- Moloco SDK'sı 3.7.2 sürümü.
Sürüm 3.7.1.0
- Moloco SDK'sının 3.7.1 sürümüyle uyumluluğu doğrulandı.
Aşağıdakilerle geliştirilip test edilmiştir:
- Google Mobile Ads SDK'sı 12.1.0 sürümü.
- Moloco SDK sürümü 3.7.1.
Sürüm 3.7.0.0
- Moloco SDK'sının 3.7.0 sürümüyle uyumluluğu doğrulandı.
Aşağıdakilerle geliştirilip test edilmiştir:
- Google Mobile Ads SDK'sı 12.0.0 sürümü.
- Moloco SDK'sı 3.7.0 sürümü.
Sürüm 3.6.0.1
- Bağdaştırıcı, Moloco SDK sürümünü ana iş parçacığından alacak şekilde güncellendi.
- Artık Google Mobile Ads SDK'sının 12.0.0 veya daha sonraki bir sürümü gereklidir.
Aşağıdakilerle geliştirilip test edilmiştir:
- Google Mobile Ads SDK'sı 12.0.0 sürümü.
- Moloco SDK'sı 3.6.0 sürümü.
Sürüm 3.6.0.0
- Moloco SDK'sının 3.6.0 sürümüyle uyumluluğu doğrulandı.
Aşağıdakilerle geliştirilip test edilmiştir:
- Google Mobile Ads SDK'sı 11.13.0 sürümü.
- Moloco SDK'sı 3.6.0 sürümü.
Sürüm 3.5.0.0
- İlk sürüm.
- Banner (MREC dahil), geçiş reklamı ve ödüllü reklam biçimleri için teklif desteği eklendi.
- Moloco SDK'sının 3.5.0 sürümüyle uyumluluğu doğrulandı.
Aşağıdakilerle geliştirilip test edilmiştir:
- Google Mobile Ads SDK'sı 11.13.0 sürümü.
- Moloco SDK'sı 3.5.0 sürümü.