Moloco'yu teklifli sistemle entegre etme

Bu kılavuzda, teklifli sistem entegrasyonlarını kapsayan uyumlulaştırma özelliğini kullanarak Moloco'dan reklam yüklemek ve göstermek için Google Mobile Ads SDK ürününü nasıl kullanacağınız gösterilmektedir. Bu açıklamalar, Moloco'nun bir reklam biriminin uyumlulaş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 uyumlulaştırma adaptörünün özellikleri şöyledir:

Entegrasyon
Teklifli sistem
Şelale
Formatlar
Uygulama Açma
Banner
Geçiş reklamı
Ödüllü
Ödüllü geçiş reklamı
Yerel biçim

Ön koşullar

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

  • iOS 13.0 veya sonraki sürüm dağıtım hedefi

  • Moloco bağdaştırıcısı 3.9.1.0 veya sonraki sürümler.

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, ardından yeni bir uygulama oluşturmak için Uygulama Ekle düğmesini tıklayın.

Uygulamanız için OS (İşletim Sistemi) ve Privacy Settings'i (Gizlilik Ayarları) seçin, formun geri kalanını doldurun ve ardından Create'i (Oluştur) tıklayın.

Uygulamanız oluşturulduktan sonra ayrıntıları görüntülemek için Apps (Uygulamalar) sekmesinden uygulamanızı seçin ve App Key'i (Uygulama Anahtarı) not edin.

Genel Bakış > Reklam Birimleri sekmesine gidin, açılır menüden uygulamayı seçin ve ardından 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 Create'i (Oluştur) 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 gidin ve Güvenli sinyal paylaşımı'nı inceleyip açın. 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 Teklif Sistemi için Güvenli sinyal paylaşımına izin ver'i açın.

Kaydet'i tıklayın.

Moloco teklifli sistemini 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 Sistemi'ni 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 reklam SDK'sı 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ündeki AB ve ABD eyalet tüzükleri reklam iş ortakları listesine Moloco Ads'i 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: Moloco SDK'sını ve bağdaştırıcısını içe aktarın

Swift Package Manager'ı kullanma

Devam etmeden önce, desteklenen minimum bağdaştırıcı sürümü olan 4.1.0.0'ı kullanmanız gerekir.

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

  1. Xcode'da File > Add Package Dependencies... (Dosya > Paket Bağımlılıkları Ekle...) seçeneğine gidin.

  2. Görünen istemde aşağıdaki paket URL'sini arayın:

    https://github.com/googleads/googleads-mobile-ios-mediation-moloco.git
    
  3. Bağımlılık Kuralı'nda Dal'ı seçin.

  4. Metin alanına main yazın.

CocoaPods'u kullanma

  • Aşağıdaki satırı projenizin Podfile dosyasına ekleyin:

    pod 'GoogleMobileAdsMediationMoloco'
    
  • Komut satırından şu komutu çalıştırın:

    pod install --repo-update

4. adım: Moloco SDK'sındaki gizlilik ayarlarını uygulayın

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ğu durumlarda ç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ızı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.

Moloco Ads SDK iOS bağdaştırıcısı sürüm 3.5.0.0 ve sonraki sürümler, IAB'nin Şeffaflık ve Kullanıcı Rızası Çerçevesi (TCF) ile entegre olan Kullanıcı Rızası Yönetim Platformlarından Moloco Ads SDK'ya GDPR izin sinyallerinin iletilmesini destekler. Daha fazla bilgi için TCF İzin Dizeleri başlıklı makaleyi inceleyin.

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'sı, rıza bilgilerini Moloco SDK'sına 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 bunu Google Mobile Ads SDK ü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'dan 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 Moloco uygulama anahtarı eksik veya geçersiz.
103 com.google.ads.mediation.moloco Moloco reklam birimi kimliği eksik veya geçersiz.
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ı oluşturmak için gereken oluşturma verileri mevcut değil.
-1 ile 5.000 arasında Moloco SDK tarafından gönderildi Moloco SDK bir hata döndürdü. Daha fazla bilgi için Moloco'nun belgelerini inceleyin.

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

Sürüm 4.11.1.0 (Devam ediyor)

Sürüm 4.11.0.0

  • Moloco SDK'sının 4.11.0 sürümüyle uyumluluğu doğrulandı.

Aşağıdakilerle geliştirilip test edilmiştir:

  • Google Mobile Ads SDK'sı 13.11.0 sürümü.
  • Moloco SDK'sı 4.11.0 sürümü.

Sürüm 4.10.0.0

  • Moloco SDK'sının 4.10.0 sürümüyle uyumluluğu doğrulandı.
  • Moloco SDK'nın doğal reklam gösterimlerini izleyebildiğini belirtmek için güncellendi.

Aşağıdakilerle geliştirilip test edilmiştir:

  • Google Mobile Ads SDK'sı 13.9.0 sürümü.
  • Moloco SDK'sı 4.10.0 sürümü.

4.9.1.0 sürümü

  • Moloco SDK'sının 4.9.1 sürümüyle uyumluluğu doğrulandı.

Aşağıdakilerle geliştirilip test edilmiştir:

  • Google Mobile Ads SDK'sı 13.8.0 sürümü.
  • Moloco SDK 4.9.1 sürümü

4.9.0.0 sürümü

  • Moloco SDK'sının 4.9.0 sürümüyle uyumluluğu doğrulandı.

Aşağıdakilerle geliştirilip test edilmiştir:

  • Google Mobile Ads SDK'sı 13.7.0 sürümü.
  • Moloco SDK'sı 4.9.0 sürümü.

Sürüm 4.8.1.1

  • Uyarlanabilir banner reklam boyutları için destek eklendi.

Aşağıdakilerle geliştirilip test edilmiştir:

  • Google Mobile Ads SDK'sı 13.6.0 sürümü.
  • Moloco SDK 4.8.1 sürümü.

Sürüm 4.8.1.0

  • Moloco SDK'sının 4.8.1 sürümüyle uyumluluğu doğrulandı.

Aşağıdakilerle geliştirilip test edilmiştir:

  • Google Mobile Ads SDK'sı 13.6.0 sürümü.
  • Moloco SDK 4.8.1 sürümü.

Sürüm 4.8.0.0

  • Moloco SDK'sının 4.8.0 sürümüyle uyumluluğu doğrulandı.

Aşağıdakilerle geliştirilip test edilmiştir:

  • Google Mobile Ads SDK'sı 13.6.0 sürümü.
  • Moloco SDK'sı 4.8.0 sürümü.

Sürüm 4.7.0.0

  • Moloco SDK'sının 4.7.0 sürümüyle uyumluluğu doğrulandı.
  • Google Mobile Ads SDK'sı bağımlılığını azaltmak için minimum iOS sürümünü güncelleyerek alt sürümlere izin verin.

Aşağıdakilerle geliştirilip test edilmiştir:

  • Google Mobile Ads SDK'sı 13.5.0 sürümü.
  • Moloco SDK'sı 4.7.0 sürümü.

Sürüm 4.6.1.1

  • Bağdaştırıcı artık ageRestrictedTreatment Google Mobile Ads SDK işaretini Moloco SDK'sının COPPA API'sine yönlendiriyor.

Aşağıdakilerle geliştirilip test edilmiştir:

  • Google Mobile Ads SDK'sı 13.3.0 sürümü.
  • Moloco SDK 4.6.1 sürümü.

Sürüm 4.6.1.0

  • Moloco SDK'sının 4.6.1 sürümüyle uyumluluğu doğrulandı.

Aşağıdakilerle geliştirilip test edilmiştir:

  • Google Mobile Ads SDK'sı 13.3.0 sürümü.
  • Moloco SDK 4.6.1 sürümü.

Sürüm 4.6.0.0

  • Moloco SDK'sının 4.6.0 sürümüyle uyumluluğu doğrulandı.

Aşağıdakilerle geliştirilip test edilmiştir:

  • Google Mobile Ads SDK'sı 13.2.0 sürümü.
  • Moloco SDK'sı 4.6.0 sürümü.

Sürüm 4.5.1.0

  • Moloco SDK'sının 4.5.1 sürümüyle uyumluluğu doğrulandı.

Aşağıdakilerle geliştirilip test edilmiştir:

  • Google Mobile Ads SDK'sı 13.2.0 sürümü.
  • Moloco SDK 4.5.1 sürümü

Sürüm 4.5.0.0

  • Moloco SDK'sının 4.5.0 sürümüyle uyumluluğu doğrulandı.

Aşağıdakilerle geliştirilip test edilmiştir:

  • Google Mobile Ads SDK'sı 13.1.0 sürümü.
  • Moloco SDK'sı 4.5.0 sürümü.

Sürüm 4.4.1.0

  • Moloco SDK'sının 4.4.1 sürümüyle uyumluluğu doğrulandı.

Aşağıdakilerle geliştirilip test edilmiştir:

  • Google Mobile Ads SDK'sı 13.1.0 sürümü.
  • Moloco SDK'sı 4.4.1 sürümü.

Sürüm 4.4.0.0

  • Moloco SDK'sının 4.4.0 sürümüyle uyumluluğu doğrulandı.

Aşağıdakilerle geliştirilip test edilmiştir:

  • Google Mobile Ads SDK'sı 13.1.0 sürümü.
  • Moloco SDK'sı 4.4.0 sürümü.

Sürüm 4.3.0.2

  • Google Mobile Ads SDK bağımlılığı 13.0.0 sürümüne güncellendi.

Aşağıdakilerle geliştirilip test edilmiştir:

  • Google Mobile Ads SDK'sı 13.0.0 sürümü.
  • Moloco SDK'sı 4.3.0 sürümü.

Sürüm 4.3.0.1

  • CocoaPods minimum iOS sürümü 13.0 olarak güncellendi.

Aşağıdakilerle geliştirilip test edilmiştir:

  • Google Mobile Ads SDK'sı 13.0.0 sürümü.
  • Moloco SDK'sı 4.3.0 sürümü.

Sürüm 4.3.0.0

  • Moloco SDK'sının 4.3.0 sürümüyle uyumluluğu doğrulandı.

Aşağıdakilerle geliştirilip test edilmiştir:

  • Google Mobile Ads SDK'sı 12.14.0 sürümü.
  • Moloco SDK'sı 4.3.0 sürümü.

Sürüm 4.2.0.0

  • Moloco SDK'sının 4.2.0 sürümüyle uyumluluğu doğrulandı.

Aşağıdakilerle geliştirilip test edilmiştir:

  • Google Mobile Ads SDK'sı 12.14.0 sürümü.
  • Moloco SDK'sı 4.2.0 sürümü.

Sürüm 4.1.2.0

  • Moloco SDK'sının 4.1.2 sürümüyle uyumluluğu doğrulandı.

Aşağıdakilerle geliştirilip test edilmiştir:

  • Google Mobile Ads SDK'sı 12.14.0 sürümü.
  • Moloco SDK sürümü 4.1.2.

Sürüm 4.1.0.0

  • Moloco SDK'sının 4.1.0 sürümüyle uyumluluğu doğrulandı.

Aşağıdakilerle geliştirilip test edilmiştir:

  • Google Mobile Ads SDK'sı 12.14.0 sürümü.
  • Moloco SDK'sı 4.1.0 sürümü.

Sürüm 3.13.0.0

  • Çerçeveler içinde Info.plist içerir.
  • Moloco SDK'sının 3.13.0 sürümüyle uyumluluğu doğrulandı.

Aşağıdakilerle geliştirilip test edilmiştir:

  • Google Mobile Ads SDK'sı 12.9.0 sürümü.
  • Moloco SDK'sı 3.13.0 sürümü.

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.

3.12.0.0 sürümü

  • 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ı 3.12.0 sürümü.

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 3.10.1 sürümü.

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.
  • MREC 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şaretleri etkinleştirildi.
  • Doğal reklamlar için yıldız puanı alınmasıyla ilgili bir sorun 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ı.
  • Doğal reklam biçimi için teklifli sistem 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 ileti dizisinden 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 teklifli sistem 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ü.