Bu kılavuzda, reklam öğelerinizi yüklemek ve görüntülemek için Google Mobile Ads SDK'sının nasıl uyumlulaştırma kullanarak InMobi'den gelen reklamlar hem şelale hem teklif entegrasyonlarını kapsar. Burada, InMobi'nin ve InMobi SDK'sı ile InMobi SDK'sının nasıl entegre edileceği ve bağdaştırıcıyı bir uygulamaya Unity dönüştürün.
Desteklenen entegrasyonlar ve reklam biçimleri
Entegrasyon | |
---|---|
Teklif verme | 1 |
Şelale | |
Formatlar | |
Banner | |
Geçiş reklamı | |
Ödüllü | |
Yerel biçim | 2 |
1 Teklif entegrasyonu kapalı beta sürümü kullanıyorsanız erişim isteğinde bulunmak için hesap yöneticinizle iletişime geçin.
Şartlar
- En son Google Mobile Ads SDK'sı .
- Unity 4 veya sonraki sürümler .
- Android'de dağıtmak için
- Android API düzeyi 21 veya üstü
- iOS'te dağıtmak için
- 10.0 veya sonraki bir iOS dağıtım hedefi
- Google ile yapılandırılmış, çalışan bir Unity proje Mobile Ads SDK'sı. Görüntüleyin Ayrıntılı bilgi için Başlarken.
- Arabuluculuğu tamamlama Başlangıç kılavuzu
1. Adım: InMobi kullanıcı arayüzünde yapılandırmaları ayarlayın
Sign up for an InMobi account.
Bidding
Select Use InMobi SSP with Google Open Bidding and enter your Google Publisher ID.
Waterfall
No additional step is required for waterfall integrations.
Log in to your InMobi account once verified.
Add an app
To add your app to the InMobi dashboard, click Inventory > Inventory Settings.
Click Add Inventory and select the Mobile App channel from the drop-down menu.
Start typing your published app store URL in the search bar and select the app from the auto-populated results. Click Continue.
If your app in not published, click Link manually and enter the required details. Click Continue.
Review the App & Website Compliance settings and then click Save and Create Placements.
Placements
After you set up your inventory, the system redirects you to the placement creation workflow.
Bidding
Select the type of ad unit. The enter a Placement Name, select On and Google Open Bidding for Audience Bidding and Partner respectively, and fill out the rest of the form. Click Create Placement when done.
Waterfall
Select the type of ad unit. Then enter a Placement Name, select Off for Audience Bidding, and fill out the rest of the form. Click Create Placement when done.
Once the placement is created, its details are shown. Take note of the Placement ID, which will be used for setting up your AdMob ad unit.
Account ID
Your InMobi account ID is available under Finance > Payment Settings > Payment Information.
Locate InMobi Reporting API Key
Bidding
This step isn't required for bidding integrations.
Waterfall
Go to My Account > Account Settings. Navigate to the API Key tab and click Generate API Key.
Select the email of the user the key is required for and click Generate API Key. A file containing the API key and username/login name will be generated.
Only the publisher administrator of the account will be able to generate an API key for all users. If you have forgotten the previously generated API key, reset your API key by hovering over your mail on the API Key tab.
Turn on test mode
Enable Test Mode for your placement on all live impressions or certain test devices only.
2. Adım: Kullanıcı arayüzünde InMobi talebini ayarlayın AdMob
Reklam biriminiz için uyumlulaştırma ayarlarını yapılandırma
Android
Talimatlar için Android kılavuzunun 2. adımına bakın.
iOS
Talimatlar için iOS rehberinin 2. adımına göz atın.
GDPR ve ABD eyalet düzenlemeleri reklam iş ortakları listesine InMobi ekleyin
.GDPR ayarları ve ABD eyalet düzenlemeleri ayarları bölümündeki adımları uygulayarak AdMob kullanıcı arayüzünde GDPR ve ABD eyalet düzenlemeleri reklam iş ortakları listesine InMobi ekleyin.
3. Adım: InMobi SDK'sını ve bağdaştırıcısını içe aktarın
InMobi için Google Mobile Ads uyumlulaştırma eklentisinin en son sürümünü indirin
indirme bağlantısından
Changelog (Değişiklik günlüğü) ve ayıklama
GoogleMobileAdsInMobiMediation.unitypackage
.
Unity proje düzenleyicinizde Öğeler > Paketi İçe Aktar > Özel
Paketleyin'i tıklayın ve istediğiniz GoogleMobileAdsInMobiMediation.unitypackage
dosyasını seçin.
indirildi. Tüm dosyaların seçili olduğundan emin olun ve İçe Aktar'ı tıklayın.
Ardından Öğeler > Play Hizmetleri Çözümleyici > Android Çözümleyici > Kuvvet
Çöz'e dokunun. Unity Play Hizmetleri Çözümleyici kitaplığı bağımlılık gerçekleştirir
ve beyan edilen bağımlılıkları
Unity uygulamanızın Assets/Plugins/Android
dizini.
4. Adım: Gizlilik ayarlarını InMobi SDK'sında uygulayın
AB kullanıcı rızası ve GDPR
Google AB Kullanıcı İzni kapsamında Politika uyarınca, belirli bilgilerin ifşa edildiğinden emin olmalısınız. Avrupa Ekonomik Alanı'ndaki (AEA) kullanıcıların cihaz tanımlayıcılarının ve kişisel verilerin kullanımı. Bu politika AB eGizlilik Yönergesi ve Genel Veri Koruma şartları Düzenleme (GDPR). Rıza isterken her reklam ağını tanımlamanız gerekir kişisel verileri toplayabilecek, alabilecek veya kullanabilen uyumlulaştırma zincirinizde her ağın kullanımıyla ilgili bilgi sağlar. Google şu anda Kullanıcının izin seçimini bu tür ağlara otomatik olarak iletmelidir.
InMobi sürüm 2.1.0 için Google Mobile Ads uyumlulaştırma eklentisine
İzin bilgilerini Google Ads'e aktarmanıza olanak tanıyan InMobi.UpdateGDPRConsent()
yöntemi
InMobi'ye gidin. Aşağıdaki örnek kod, izin bilgilerinin
InMobi SDK'sı. Bu yöntemi çağırmayı seçerseniz bunu önceden
Google Mobile Ads SDK'sı ile reklam isteğinde bulunma
using GoogleMobileAds.Api.Mediation.InMobi;
using System.Collections.Generic;
// ...
Dictionary<string, string> consentObject = new Dictionary<string, string>();
consentObject.Add("gdpr_consent_available", "true");
consentObject.Add("gdpr", "1");
InMobi.UpdateGDPRConsent(consentObject);
InMobi'nin GDPR uygulaması konusuna bakın ayrıntılar inMobi'nin kabul ettiği olası anahtarlar ve değerler hakkında daha fazla bilgi bu izin nesnesini tanımlayın.
ABD eyalet gizlilik yasaları
. ABD eyalet gizlilik yasaları kullanıcılara, doğru zamanda "indirimi" devre dışı bırakmak "kişisel bilgilerinin” (kanunların bu konudaki hariç tutmanın, öne çıkan bir "Do Not Sell My Personal My Personal (Kişisel Bilgilerimi Kesinlikle Satmayın) Bilgiler" bağlantısını ile başlar. İlgili içeriği oluşturmak için kullanılan ABD eyalet gizliliği yasalara uygunluk rehberi, yasalarca belirlenen kısıtlanmış veri işleme kullanılabilir ancak Google, bu ayarı her reklama uygulayamaz. ağda yer alır. Bu nedenle, reklam ağlarının her birini kişisel satışlarına katılabilecek uyumlulaştırma zincirinizde ağlarla ilgili bilgileri takip edin ve bu ağların yönlendirmelerini izleyerek uygunluk açısından önemlidir.
InMobi'nin web sitesine göz atın CCPA belgeleri inceleyin.
5. Adım: Gerekli ilave kodu ekleyin
Android
InMobi entegrasyonuna gerek yoktur.
iOS
SKAdNetwork entegrasyonu
InMobi'nin
belgeleri
kullanarak projenizin Info.plist
dosyasına SKAdNetwork tanımlayıcılarını ekleyin.
6. Adım: Uygulamanızı test edin
Test reklamlarını etkinleştir
AdMob için test cihazınızı kaydettiğinizden ve InMobi kullanıcı arayüzünde test modunu etkinleştirdiğinizden emin olun.
Test reklamlarını doğrulama
InMobireklam kaynağından test reklamları aldığınızı doğrulamak için InMobi (Bidding) and InMobi (Waterfall) reklam kaynaklarını kullanarak reklam inceleyicide tek reklam kaynağı testini etkinleştirin.
İsteğe bağlı adımlar
Android
İzinler
InMobi, optimum performans için aşağıdaki isteğe bağlı öğelerin eklenmesini önerir
uygulamanızın AndroidManifest.xml
dosyasına izin verin.
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
İsteğe bağlı olarak bu izinleri
Plugins/Android/GoogleMobileAdsInMobiMediation/AndroidManifest.xml
dosyası oluşturun.
iOS
iOS entegrasyonu için ek bir işlem yapmanıza gerek yoktur.
Hata kodları
Bağdaştırıcı InMobi'den bir reklam alamazsa yayıncılar
kullanarak reklam yanıtından gelen temel hata
ResponseInfo
şu sınıflarda:
Android
com.google.ads.mediation.inmobi.InMobiAdapter
com.google.ads.mediation.inmobi.InMobiMediationAdapter
iOS
GADMAdapterInMobi
GADMediationAdapterInMobi
Aşağıdakiler, Reklamın yüklenmemesi:
Android
Hata kodu | Neden |
---|---|
0-99 | InMobi SDK Hataları. Kodu inceleyin inceleyebilirsiniz. |
100 | Kullanıcı arayüzünde yapılandırılan InMobi sunucu parametreleri AdMob eksik/geçersiz. |
101 | InMobi SDK'sı başlatılamadı. |
102 | İstenen reklam boyutu, InMobi tarafından desteklenen bir banner boyutuyla eşleşmiyor. |
103 | Reklam isteği, birleştirilmiş bir doğal reklam isteği değil. |
104 | InMobi SDK'sı başlatılmadan InMobi reklamı istemeye çalışıldı. Bu bağdaştırıcı InMobi SDK'sını başlattığından teoride hiçbir zaman gerçekleşmemelidir oluşturmanız gerekir. |
105 | InMobi'nin reklamı henüz gösterilmeye hazır değil. |
106 | InMobi bir reklam gösteremedi. |
107 | InMobi, gerekli bir öğenin eksik olduğu bir doğal reklam döndürdü. |
108 | InMobi'nin doğal reklam resim öğeleri, bozuk biçimli bir URL içeriyor. |
109 | Bağdaştırıcı, InMobi'nin doğal reklam resim öğelerini indiremedi. |
iOS
Hata kodu | Neden |
---|---|
101 | Kullanıcı arayüzünde yapılandırılan InMobi sunucu parametreleri AdMob eksik/geçersiz. |
102 | InMobi Bağdaştırıcısı, istenen reklam biçimini desteklemiyor. |
103 | Bu ağ yapılandırması için bir InMobi reklamı zaten yüklü. |
Diğer | InMobi SDK'sı hata döndürdü. Ayrıntılı bilgi için IMRequestStatus.h sayfasını inceleyin. |
InMobi Unity Uyumlulaştırma Eklentisi Değişiklik Günlüğü
Sonraki Sürüm
DummyClient
adlı dosyaPlaceholderClient
olarak yeniden adlandırıldı.
Sürüm 4.6.2
- InMobi Android bağdaştırıcısının 10.7.4.0 sürümünü destekler.
- InMobi iOS bağdaştırıcısının 10.7.4.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 9.1.1 sürümüyle geliştirilip test edilmiştir.
Sürüm 4.6.1
- InMobi Android bağdaştırıcısının 10.7.4.0 sürümünü destekler.
- InMobi iOS bağdaştırıcısının 10.7.2.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 9.1.0 sürümüyle geliştirilip test edilmiştir.
Sürüm 4.6.0
- InMobi Android bağdaştırıcısının 10.7.3.0 sürümünü destekler.
- InMobi iOS bağdaştırıcısının 10.7.2.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 9.1.0 sürümüyle geliştirilip test edilmiştir.
Sürüm 4.5.1
- InMobi Android bağdaştırıcısının 10.6.7.1 sürümünü destekler.
- InMobi iOS bağdaştırıcısının 10.7.2.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 9.1.0 sürümüyle geliştirilip test edilmiştir.
Sürüm 4.5.0
- InMobi Android bağdaştırıcısının 10.6.7.1 sürümünü destekler.
- InMobi iOS bağdaştırıcısının 10.7.1.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 9.0.0 sürümüyle geliştirilip test edilmiştir.
Sürüm 4.4.1
- InMobi Android bağdaştırıcısının 10.6.2.0 sürümünü destekler.
- InMobi iOS bağdaştırıcısının 10.6.0.0 sürümünü destekler.
- Google Mobile Ads Unity eklentisi 8.6.0 sürümüyle geliştirilip test edilmiştir.
Sürüm 4.4.0
- InMobi Android bağdaştırıcısının 10.6.0.0 sürümünü destekler.
- InMobi iOS bağdaştırıcısının 10.6.0.0 sürümünü destekler.
- Google Mobile Ads Unity eklentisi 8.6.0 sürümüyle geliştirilip test edilmiştir.
Sürüm 4.3.3
- InMobi Android bağdaştırıcısının 10.5.8.0 sürümünü destekler.
- InMobi iOS bağdaştırıcısının 10.5.8.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 8.5.2 sürümüyle geliştirilip test edilmiştir.
Sürüm 4.3.0
- Bağdaştırıcı içeriği
GoogleMobileAds/Mediation/InMobi/
hedefine taşındı. - Bağdaştırıcı ad alanı,
GoogleMobileAds.Mediation.InMobi
kullanılacak şekilde yeniden düzenlendi. - InMobi Android bağdaştırıcısının 10.5.4.1 sürümünü destekler.
- InMobi iOS bağdaştırıcısının 10.5.4.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 8.1.0 sürümüyle geliştirilip test edilmiştir.
Sürüm 4.2.2
- InMobi Android bağdaştırıcısının 10.1.2.1 sürümünü destekler.
- InMobi iOS bağdaştırıcısının 10.1.2.1 sürümünü destekler.
- Google Mobile Ads Unity eklentisi 7.3.1 sürümüyle geliştirilip test edilmiştir.
Sürüm 4.2.1
- InMobi Android bağdaştırıcısının 10.1.2.0 sürümünü destekler.
- InMobi iOS bağdaştırıcısının 10.1.2.0 sürümünü destekler.
- Google Mobile Ads Unity eklentisi 7.3.1 sürümüyle geliştirilip test edilmiştir.
Sürüm 4.2.0
- InMobi Android bağdaştırıcısının 10.1.1.0 sürümünü destekler.
- InMobi iOS bağdaştırıcısının 10.1.1.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 7.3.0 sürümüyle geliştirilip test edilmiştir.
Sürüm 4.1.0
- InMobi Android bağdaştırıcısının 10.0.9.0 sürümünü destekler.
- InMobi iOS bağdaştırıcısının 10.1.0.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 7.3.0 sürümüyle geliştirilip test edilmiştir.
Sürüm 4.0.4
- InMobi Android bağdaştırıcısının 10.0.7.0 sürümünü destekler.
- InMobi iOS bağdaştırıcısının 10.0.7.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 7.0.2 sürümüyle geliştirilip test edilmiştir.
Sürüm 4.0.3
- InMobi Android bağdaştırıcısının 10.0.5.0 sürümünü destekler.
- InMobi iOS bağdaştırıcısının 10.0.5.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 7.0.0 sürümüyle geliştirilip test edilmiştir.
Sürüm 4.0.2
- InMobi Android bağdaştırıcısının 10.0.3.0 sürümünü destekler.
- InMobi iOS bağdaştırıcısının 10.0.2.1 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 7.0.0 sürümüyle geliştirilip test edilmiştir.
Sürüm 4.0.1
- InMobi Android bağdaştırıcısının 10.0.3.0 sürümünü destekler.
- InMobi iOS bağdaştırıcısının 10.0.2.0 sürümünü destekler.
Sürüm 4.0.0
- InMobi Android bağdaştırıcısının 10.0.1.0 sürümünü destekler.
- InMobi iOS bağdaştırıcısının 10.0.1.0 sürümünü destekler.
Sürüm 3.2.0
- InMobi Android bağdaştırıcısının 9.2.0.0 sürümünü destekler.
- InMobi iOS bağdaştırıcısının 9.2.1.0 sürümünü destekler.
Sürüm 3.1.2
- InMobi Android bağdaştırıcısının 9.1.9.0 sürümünü destekler.
- InMobi iOS bağdaştırıcısının 9.1.7.0 sürümünü destekler.
Sürüm 3.1.1
- InMobi Android bağdaştırıcısının 9.1.1.0 sürümünü destekler.
- InMobi iOS bağdaştırıcısının 9.1.1.0 sürümünü destekler.
Sürüm 3.1.0
- InMobi Android bağdaştırıcısının 9.1.0.0 sürümünü destekler.
- InMobi iOS bağdaştırıcısının 9.1.0.0 sürümünü destekler.
Sürüm 3.0.3
- InMobi Android bağdaştırıcısının 9.0.7.1 sürümünü destekler.
- InMobi iOS bağdaştırıcısının 9.0.7.2 sürümünü destekler.
Sürüm 3.0.2
- InMobi Android bağdaştırıcısının 9.0.7.0 sürümünü destekler.
- InMobi iOS bağdaştırıcısının 9.0.7.0 sürümünü destekler.
Sürüm 3.0.1
- InMobi Android bağdaştırıcısının 9.0.6.0 sürümünü destekler.
- InMobi iOS bağdaştırıcısının 9.0.7.0 sürümünü destekler.
Sürüm 3.0.0
- InMobi Android bağdaştırıcısının 9.0.4.0 sürümünü destekler.
- InMobi iOS bağdaştırıcısının 9.0.4.0 sürümünü destekler.
Sürüm 2.4.0
- InMobi Android bağdaştırıcısının 7.3.0.1 sürümünü destekler.
- InMobi iOS bağdaştırıcısının 7.4.0.0 sürümünü destekler.
Sürüm 2.3.0
- Android bağdaştırıcısı 7.2.9.0 sürümünü destekler.
- iOS bağdaştırıcısı 7.3.2.0 sürümünü destekler.
Sürüm 2.2.2
- Eklenti, yeni Ödüllü API'yi destekleyecek şekilde güncellendi.
- Android bağdaştırıcısı 7.2.7.0 sürümünü destekler.
- iOS bağdaştırıcısı 7.2.7.0 sürümünü destekler.
Sürüm 2.2.1
- Android bağdaştırıcısı 7.2.2.0 sürümünü destekler.
- iOS bağdaştırıcısı 7.2.4.0 sürümünü destekler.
Sürüm 2.2.0
- Android bağdaştırıcısı 7.2.1.0 sürümünü destekler.
- iOS bağdaştırıcısı 7.2.0.0 sürümünü destekler.
Sürüm 2.1.2
- Android bağdaştırıcısı 7.1.1.1 sürümünü destekler.
- iOS bağdaştırıcısı 7.1.2.0 sürümünü destekler.
Sürüm 2.1.1
- Android bağdaştırıcısı 7.1.1.1 sürümünü destekler.
- iOS bağdaştırıcısı 7.1.1.2 sürümünü destekler.
Sürüm 2.1.0
- Android bağdaştırıcısı 7.1.0.0 sürümünü destekler.
- iOS bağdaştırıcısı 7.1.1.1 sürümünü destekler.
InMobi.UpdateGDPRConsent()
yöntemi eklendi.
Sürüm 2.0.0
- Android bağdaştırıcısı 7.0.4.0 sürümünü destekler.
- iOS bağdaştırıcısı 7.1.1.0 sürümünü destekler.
Sürüm 1.0.0
- İlk çıkış tarihi!
- Android bağdaştırıcısı 6.2.4.0 sürümünü destekler.
- iOS bağdaştırıcısı 6.2.1.0 sürümünü destekler.