

StartApp › SDK › Android

Integrasi Manual dengan File JAR

StartApp Tech
Pembaharuan Terakhir: 28 Juli 2020 03:13

Versi SDK: 4.6.1

Jika Anda mengupgrade SDK dari versi yang lebih lama, Anda harus mengulangi
langkah 1 dan mengimpor ulang semua kelas yang terpengaruh. 

Dokumen ini menjelaskan prosedur dasar untuk mengintegrasikan Iklan Dalam Aplikasi
StartApp ke dalam aplikasi Android Anda.

Setelah proses integrasi sederhana ini, Iklan Dalam Aplikasi StartApp memungkinkan
Anda memperoleh manfaat dari produk monetisasi Dalam Aplikasi StartApp, yang
memaksimalkan pendapatan yang dihasilkan oleh aplikasi Anda. Semua perolehan
keuntungan ini dicapai dengan sedikit usaha dan sedikit gangguan pada pengalaman
pengguna Anda.

CATATAN:

Contoh kode dalam dokumen ini dapat disalin / ditempel ke kode sumber
Anda

Jangan ragu untuk melihat proyek sampel kami sebagai referensi

Kami sangat menyarankan Anda menggabungkan Tes Integrasi  selama

integrasi dan sebelum ditayangkan

Harap perhatikan bahwa langkah 1-3 di bawah ini wajib

Jika Anda memiliki pertanyaan, hubungi kami melalui support@startapp.com

Mulai 
LANGKAH 1, MENAMBAHKAN DAN MENGINISIALISASI SDK KE PROYEK
ANDA

MANUAL (TOPLES)
Untuk pemasangan manual, ikuti petunjuk di bawah ini, perhatikan kami menawarkan
inisialisasi berbasis Manifest atau Kode yang sesuai dengan kebutuhan Anda

CATATAN PENTING:

Anda harus menerapkan hanya satu  dari metode inisialisasi di bawah ini
berdasarkan preferensi Anda.

AndroidManifest.xml Inisialisasi

Kode Inisialisasi

1. MENDOWNLOAD SDK
Jika Anda tidak menggunakan jCenter, Anda dapat mengunduh file zip SDK
dan menambahkan file StartAppInApp-xxxjar ke direktori “libs” proyek Anda
(Anda dapat menemukan versi terbaru di portal kami  ).

2. MEMPERBARUI FILE ANDROIDMANIFEST.XML ANDA

Tambahkan izin berikut di bawah  elemen <manifest> utama.
Izin Bluetooth bersifat opsional:

<uses-permission android:name="android.permission.INTERNET" />

<uses-permission android:name="android.permission.ACCESS_WIFI_ST
<uses-permission android:name="android.permission.ACCESS_NETWOR
<uses-permission android:name="android.permission.RECEIVE_BOOT_C
<uses-permission android:name="android.permission.BLUETOOTH" />

Tambahkan komponen android berikut di bawah bagian <application>:

<provider 
android:name="com.startapp.sdk.adsbase.StartAppInitProvider"
android:authorities="${applicationId}.startappinitprovider"
android:exported="false" />

<activity
android:name="com.startapp.sdk.adsbase.consent.ConsentActivity
android:configChanges="orientation|screenSize|screenLayout|key
android:theme="@android:style/Theme.Translucent"/>

<activity
android:name="com.startapp.sdk.ads.list3d.List3DActivity"
android:theme="@android:style/Theme"/>

<activity
android:name="com.startapp.sdk.adsbase.activities.OverlayActiv
android:configChanges="orientation|screenSize|screenLayout|key
android:theme="@android:style/Theme.Translucent"/>

<activity
android:name="com.startapp.sdk.adsbase.activities.FullScreenAct
android:configChanges="orientation|screenSize|screenLayout|key
android:theme="@android:style/Theme"/>

<service android:name="com.startapp.sdk.adsbase.InfoEventService

<service
android:name="com.startapp.sdk.adsbase.PeriodicJobService"
android:permission="android.permission.BIND_JOB_SERVICE" />

<receiver android:name="com.startapp.sdk.adsbase.remoteconfig.Bo
<intent-filter>
<action android:name="android.intent.action.BOOT_COMPLETED"/>
</intent-filter>
</receiver>
 Tambahkan tag meta-data berikut dengan StartApp App Id di bawah bagian
<aplikasi> di file manifes Anda:

<meta-data
android:name="com.startapp.sdk.APPLICATION_ID"
android:value="startapp_app_id" />

Ganti  "APPLICATION_ID"  dengan nilai Anda sendiri yang disediakan di  portal
pengembang

Untuk menemukan ID aplikasi Anda, klik tab "Aplikasi Saya" di panel kiri dan
pilih ID yang relevan dari daftar aplikasi Anda:

Jika Anda ingin menonaktifkan iklan kembali (diaktifkan secara default) harap
tambahkan tag meta-data berikut:

<meta-data
android:name="com.startapp.sdk.RETURN_ADS_ENABLED"
android:value="false" />

LANGKAH 2, OBFUSCATION (WAJIB UNTUK PENGGUNA PROGUARD)

Obfuscation melindungi aplikasi dari rekayasa balik atau modifikasi dengan

mempersulit pihak ketiga untuk mengakses kode sumber Anda (didekompilasi).

StartApp Dalam-Iklan sudah disamarkan!  Karenanya, jika Anda tidak menyamarkan

aplikasi Anda menggunakan ProGuard ™, Anda dapat melewati langkah ini. Jika Anda
telah menyamarkan aplikasi Anda menggunakan ProGuard, gunakan perintah berikut
di file konfigurasi ProGuard:


-keep class com.startapp.** {

*;
}

-keep class com.truenet.** {

*;
}

-keepattributes Exceptions, InnerClasses, Signature, Deprecated, Sourc

LineNumberTable, *Annotation*, EnclosingMethod
-dontwarn android.webkit.JavascriptInterface
-dontwarn com.startapp.**

-dontwarn org.jetbrains.annotations.**

LANGKAH 3, IZIN APLIKASI (SESUAI COPPA)

Jika anak-anak target aplikasi Anda (sebagaimana didefinisikan dalam undang-undang

yang berlaku, seperti 13 di AS dan 16 di UE) dan Anda mengintegrasikan versi SDK
melalui jCenter, Anda harus menghapus izin WIFI dari merger manifes Anda. Untuk
melakukannya, ikuti langkah-langkah ini:

1. Tambahkan baris ini ke elemen manifes:

xmlns:tools="http://schemas.android.com/tools"

2. Tambahkan baris ini ke daftar izin Anda:

<uses-permission android:name="android.permission.ACCESS_WIFI_STATE"

 
Persetujuan Pengguna 
PERSETUJUAN STARTAPP 

Kami membantu Anda untuk mematuhi hukum Privasi, saat menyematkan SDK kami.

Undang-undang privasi mengharuskan untuk mengungkapkan kepada pengguna aplikasi yang

StartApp SDK tertanam dalam aplikasi Anda dan mengumpulkan dan memproses data pribadi
mereka untuk tujuan menampilkan iklan yang dipersonalisasi. Di beberapa yurisdiksi, persetujuan
pengguna juga diperlukan. Kami menyematkan kotak pengungkapan / persetujuan yang akan
disajikan kepada pengguna aplikasi dan akan memungkinkan mereka untuk meninjau Kebijakan
Privasi StartApp, serta menggunakan hak mereka.

Kotak pengungkapan / persetujuan StartApp ditampilkan segera setelah aplikasi diluncurkan.

Kotak persetujuan / pengungkapan StartApp diaktifkan secara default. 

PERSETUJUAN DARI PENGGUNA EROPA (GDPR) 

Selain kotak pengungkapan / persetujuan StartApp, sebagaimana diwajibkan menurut GDPR,

Anda harus melaporkan kepada kami izin pengguna dengan tanda persetujuan ("pas"), melalui
API yang dirinci di bawah ini.

Bendera izin pengguna menunjukkan apakah pengguna yang berbasis di UE telah memberikan
izin untuk membagikan data aplikasinya untuk tujuan personalisasi iklan. Berdasarkan tanda
persetujuan ini, StartApp akan menargetkan iklan yang paling relevan untuk pengguna Anda. Jika
pengguna tidak menyetujui, kami tidak akan menampilkan iklan yang dipersonalisasi kepada
pengguna ini.

CATATAN PENTING:

Pengumpulan persetujuan hanya diperlukan di negara-negara yang dicakup

oleh GDPR (negara-negara anggota UE). Persetujuan tidak diperlukan untuk
pengguna yang berbasis di luar negara-negara tersebut.

Kami menyarankan Anda untuk meneruskan flag izin ke StartApp segera

setelah menginisialisasi SDK.
 Jika ada perubahan izin selama masa aktivitas pengguna, Anda diminta untuk
mengirimkan kembali tanda izin yang relevan ke StartApp.

Versi SDK yang lebih lama (sebelum 3.9.3): Kami akan terus mendukungnya
dengan menampilkan iklan. Penting untuk diketahui bahwa jika Anda tidak
dapat memperbarui versi SDK dan izin pengguna untuk pengguna GDPR
salah, jangan menginisialisasi StartApp SDK untuk pengguna tersebut.

Gunakan metode ini jika pengguna menyetujui:

StartAppSDK.setUserConsent (this,
"pas",
System.currentTimeMillis(),
true);

Gunakan metode ini jika pengguna tidak menyetujui:

StartAppSDK.setUserConsent (this,
"pas",
System.currentTimeMillis(),
false);

CATATAN:   parameter stempel waktu harus mewakili waktu spesifik izin diberikan oleh
pengguna.

Untuk mempermudah proses, kami telah menambahkan jendela persetujuan ke

aplikasi demo kami. Silakan ikuti tautan untuk melihat proyek demo. 

Format Iklan

SPLASH AD (DISARANKAN)

StartApp Splash Ad adalah unit iklan berkinerja terbaik, menampilkan CPM

tertinggi di industri
Iklan Splash adalah iklan halaman penuh yang ditampilkan segera setelah aplikasi
diluncurkan. Iklan Pembuka terlebih dahulu menampilkan layar pembuka halaman

penuh yang Anda tentukan (seperti dijelaskan di bawah) diikuti dengan iklan halaman
penuh.

Iklan Splash diaktifkan secara default. Jika Anda ingin menonaktifkannya cukup
hubungi  StartAppAd.disableSplash () setelah memanggil StartAppSDK.init .

Secara default, aplikasi Anda akan menggunakan layar splash yang telah ditentukan
sebelumnya yang dirancang oleh StartApp. Jika Anda ingin menyesuaikan layar ini
atau jika Anda sudah memiliki layar splash sendiri dan ingin menggunakannya, silakan
merujuk ke  Penggunaan Lanjutan .

KEMBALIKAN IKLAN

The  Kembali iklan  adalah unit iklan baru yang ditampilkan setelah pengguna kembali
ke aplikasi Anda setelah jangka waktu tertentu. Untuk meminimalkan gangguan,
periode waktu singkat diabaikan.

Iklan kembali diaktifkan dan diaktifkan secara default. Jika Anda ingin menonaktifkan
fitur ini, cukup berikan "false" sebagai parameter ke-3 dari  metode
StartAppSDK.init :

StartAppSDK.init(this, "StartApp App ID", false);

IKLAN PENGANTARA

Iklan Interstisial adalah iklan satu halaman penuh, ditampilkan sebelum atau setelah
halaman konten atau tindakan tertentu, seperti saat memasuki tahapan, antar tahapan,
saat menunggu tindakan, saat keluar dari aplikasi, dan lainnya. Ada tiga cara untuk
mengintegrasikan Iklan Pengantara: Iklan
Keluar  - menampilkan iklan setelah keluar dari aplikasi Anda
Iklan Pengantara Standar  - menampilkan iklan di lokasi tertentu dalam Aplikasi
Iklan Pengantara Anda  - menampilkan iklan secara otomatis di antara aktivitas
KELUAR DARI IKLAN
Untuk menampilkan iklan setelah keluar dari aplikasi Anda saat menekan tombol

'Kembali',  ganti  metode onBackPressed () dan tambahkan metode 
StartAppAd.onBackPressed (ini)  SEBELUM metode  super.onBackPressed () (
ini adalah konteks aktivitas / aplikasi):

@Override
public void onBackPressed() {
StartAppAd.onBackPressed(this);
super.onBackPressed();
}

PENGANTARA STANDAR
Gunakan metode showAd ()  untuk menampilkan Iklan Pengantara di lokasi tertentu
dalam aplikasi Anda.

Panggil StartAppAd.showAd (ini) di tempat yang tepat dalam aktivitas di mana

Anda ingin menampilkan Iklan. Metode showAd mengembalikan nilai true jika iklan
berhasil ditampilkan, atau false jika tidak (misalnya, jika iklan belum siap).

Berikut adalah contoh menampilkan Iklan Pengantara di antara Aktivitas:

public void btnOpenActivity (View view){

Intent nextActivity = new Intent(this, NextActivity.class);
startActivity(nextActivity);
StartAppAd.showAd(this);
}

Harap perhatikan - Jika Anda ingin menggunakan Iklan Autostitial namun belum
menampilkan Interstitial di lokasi tertentu, panggil 
StartAppAd.disbleAutoInterstitial (); sebelum memanggil
StartAppAd.showAd , jika tidak, dua iklan mungkin ditampilkan bersamaan. Ingatlah
untuk memanggil StartAppAd.enableAutoInterstitial (); kemudian untuk
mengaktifkan kembali Iklan Autostitial.
 PENTING: 
Memuat iklan mungkin membutuhkan waktu beberapa detik. Jika Anda
memanggil showAd () saat iklan belum berhasil dimuat, tidak ada yang akan
ditampilkan. Jika Anda ingin menampilkan iklan ketika aplikasi Anda diluncurkan,
gunakan  "Iklan Splash" kami . Anda juga dapat menerapkan iklan pengantara
Anda sebagai objek dan menggunakan callback "onReceiveAd" yang dipicu saat
iklan dimuat dan siap digunakan. Lihat "Iklan Interstisial" di bawah bagian
"Penggunaan Lanjutan".

AUTOSTITIALS
"Autostitial" adalah singkatan dari "Auto Interstitial"; gunakan integrasi ini untuk
menampilkan Iklan Pengantara setiap kali ada aktivitas yang diubah.
Cukup panggil StartAppAd.enableAutoInterstitial (); setelah memanggil
StartAppSDK.init . Anda bisa mendapatkan kontrol lebih terhadap frekuensi
Autostitial Ads menggunakan dua metode: frekuensi waktu dan frekuensi aktivitas.

FREKUENSI WAKTU
Anda dapat menyetel interval waktu minimum antara Iklan Autostitial berturut-turut.
Misalnya, tetapkan interval 1 menit antara dua iklan yang berurutan (waktu dalam
detik):


StartAppAd.setAutoInterstitialPreferences(
new AutoInterstitialPreferences()
.setSecondsBetweenAds(60)
);

FREKUENSI KEGIATAN
Anda dapat menetapkan jumlah minimum aktivitas antara Iklan Autostitial berturut-
turut.
Misalnya, tampilkan Autostitial setelah setiap 3 aktivitas:

StartAppAd.setAutoInterstitialPreferences(
new AutoInterstitialPreferences()
.setActivitiesBetweenAds(3)
);
Frekuensi waktu dan frekuensi aktivitas dapat digunakan bersama.

IKLAN BANNER

Tambahkan View berikut di dalam Activity layout XML Anda

<com.startapp.sdk.ads.banner.Banner
android:id="@+id/startAppBanner"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_centerHorizontal="true" />

 CATATAN:
Kode ini menempatkan View di dalam Aktivitas Anda. Anda juga memiliki opsi
untuk menambahkan atribut tambahan untuk menempatkannya di lokasi yang
diinginkan dalam Aktivitas Anda.

Untuk panduan integrasi lengkap, silakan merujuk ke   halaman Penggunaan Lanjutan .

IKLAN MREC

MRec adalah iklan persegi panjang 300X250 yang terintegrasi dalam tata letak
aplikasi. Iklan akan diperbarui secara otomatis.

Tambahkan tampilan berikut di dalam XML tata letak aktivitas Anda:

<com.startapp.sdk.ads.banner.Mrec
android:id="@+id/startAppMrec"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_centerHorizontal="true" />

CATATAN:
 Kode ini menempatkan View di dalam Aktivitas Anda. Anda juga memiliki opsi
untuk menambahkan atribut tambahan untuk menempatkannya di lokasi yang

diinginkan dalam Aktivitas Anda.

Untuk menambahkan MRec secara terprogram, daripada menggunakan XML layout:

// Get the Main relative layout of the entire activity

RelativeLayout mainLayout = (RelativeLayout)findViewById(R.id.mainLayo

// Define StartApp Mrec

Mrec startAppMrec = new Mrec(this);
RelativeLayout.LayoutParams mrecParameters =
new RelativeLayout.LayoutParams(
RelativeLayout.LayoutParams.WRAP_CONTENT,
RelativeLayout.LayoutParams.WRAP_CONTENT);
mrecParameters.addRule(RelativeLayout.CENTER_HORIZONTAL);
mrecParameters.addRule(RelativeLayout.ALIGN_PARENT_BOTTOM);

// Add to main Layout

mainLayout.addView(startAppMrec, mrecParameters);

IKLAN SAMPUL

Sampul adalah iklan persegi panjang 1200X628 yang terintegrasi dalam tata letak
aplikasi. Iklan akan diperbarui secara otomatis.

Tambahkan tampilan berikut di dalam XML tata letak aktivitas Anda:

<com.startapp.sdk.ads.banner.Cover
android:id="@+id/startAppCover"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_centerHorizontal="true" />

CATATAN:
 Kode ini menempatkan View di dalam Aktivitas Anda. Anda juga memiliki opsi
untuk menambahkan atribut tambahan untuk menempatkannya di lokasi yang

diinginkan dalam Aktivitas Anda.

Untuk menambahkan Cover secara terprogram, daripada menggunakan XML layout:

// Get the Main relative layout of the entire activity

RelativeLayout mainLayout = (RelativeLayout)findViewById(R.id.mainLayo

// Define StartApp Cover

Cover startAppCover = new Cover(this);
RelativeLayout.LayoutParams coverParameters =
new RelativeLayout.LayoutParams(
RelativeLayout.LayoutParams.WRAP_CONTENT,
RelativeLayout.LayoutParams.WRAP_CONTENT);
coverParameters.addRule(RelativeLayout.CENTER_HORIZONTAL);
coverParameters.addRule(RelativeLayout.ALIGN_PARENT_BOTTOM);

// Add to main Layout

mainLayout.addView(startAppCover, coverParameters);

IKLAN VIDEO BERINSENTIF

Iklan Reward adalah iklan video interstisial yang memberikan reward kepada
pengguna sebagai imbalan karena telah menonton iklan video secara keseluruhan.
Hadiahnya mungkin berupa barang dalam aplikasi, mata uang virtual, atau konten
premium apa pun yang disediakan oleh aplikasi. Karena pengguna benar-benar
memilih untuk menonton video berbonus dan diberikan sesuatu yang berharga
sebagai imbalan, Iklan Imbalan adalah solusi monetisasi yang efektif dan bersih untuk
retensi pengguna yang lebih kuat dan menjaga keterlibatan pengguna dalam aplikasi
Anda untuk waktu yang lebih lama.

PENTING:
1. Iklan Video Reward didukung dari API level 16 ke atas

2. Harap pastikan untuk memperbarui file manifes Anda dengan

"FullScreenActivity" seperti yang dijelaskan  di sini
 
Untuk menampilkan Iklan Reward, teruskan parameter AdMode berikut saat
memanggil metode  loadAd ()  :

startAppAd.loadAd(AdMode.REWARDED_VIDEO);

Terapkan pendengar berikut untuk mendapat panggilan balik ketika pengguna selesai
menonton video dan berhak mendapatkan hadiah:

startAppAd.setVideoListener(new VideoListener() {
@Override
public void onVideoCompleted() {
// Grant user with the reward
}
});

IKLAN ASLI

"Iklan Native" adalah representasi mentah dari sebuah iklan tanpa UI pembungkus
yang telah ditentukan sebelumnya, yang memberi Anda kebebasan untuk merancang
dan mengontrol iklan persis seperti yang Anda inginkan. Dengan menggunakan Iklan
Native, Anda dapat merancang pengalaman iklan yang sangat sesuai dengan suasana,
konten, dan fungsionalitas aplikasi Anda.

Untuk panduan integrasi lengkap, lihat bagian  "Menggunakan Iklan Native"  di bawah
halaman  "Penggunaan Lanjutan"  .
 

Menguji Integrasi

Sebelum Anda memublikasikan aplikasi Anda dengan StartApp, kami sangat

menyarankan Anda untuk menguji integrasi Anda untuk memastikannya beroperasi
dengan benar.

Nyalakan Mode Tes dengan menambahkan yang berikut ini:

StartAppSDK.setTestAdsEnabled(true);

Now you are all set to get test ads.

 IMPORTANT NOTE: 
You MUST turn off the test mode by removing the code above before going
live or else your app will fail to monetize.

Helpful Log Information

StartApp SDK automatically prints key logs to the DDMS console. These logs provide
useful information about the initialization and ad load life cycle. 

The following table capture these logs:

Scenario Log Level Log Message

The SDK successfully Info StartApp SDK initialized with account

initialized with APP_ID id: %APP_ID%"

If appId was set empty or Error Invalid app id passed to init. Please
null provide a valid app id.

If a publisher didn’t write Error Please grant the mandatory

needed permissions in the permissions : INTERNET &
manifest file ACCESS_NETWORK_STATE, SDK could
not be initialized.

If an ad was successfully Info Loaded %AD_TYPE% ad with creative

loaded, the placement ID - %ADID%"
AD_TYPE can be of following
values depends on which ad
has been loaded:

1. VIDEO

2. REWARDED_VIDEO
3. INTERSTITIAL

4. RETURN

5. OFFER_WALL

6. OFFER_WALL_3D

7. BANNER

8. MREC

9. COVER

10. BANNER_3D

11. NATIVE

SPLASH

if an ad failed to load, the Error Failed to load %AD_TYPE% ad

AD_TYPE takes value from %ERROR_MESSAGE%
the previous ‘successful
loaded’ column and
ERROR_MESSAGE shows the
reason which can be NO FILL

if an impression was sent Info Sending impression

successfully

if an impression wasn’t sent Error Dropped impression because

but the ad had been %REASON%"
rendered, happens by
different REASONs: if an ad
was overlapped by an other
view or an ad has been
closed too quickly

If an ad was closed by the Info Closed Ad

user, pressed [X] button

If an ad was clicked by the Info Iklan yang Diklik

 user and click event has been
sent


jika iklan dicegah memuat Kesalahan Gagal memuat% PLACEMENT% iklan:

oleh SDK sesuai dengan fitur NO FILL
'pemuatan eksplisit'.
PENEMPATAN dapat berupa
nilai berikut:

1. INAPP_FULL_SCREEN

2. INAPP_OFFER_WALL

3. INAPP_SPLASH

4. INAPP_OVERLAY

5. INAPP_RETURN

Proyek Sampel

StartApp menyediakan proyek integrasi sampel yang tersedia di "GitHub"

Penggunaan Lanjutan

Untuk penggunaan lanjutan, silakan lihat  "Penggunaan Lanjutan"

Apakah artikel ini berguna?

 Iya  Tidak

0 dari 0 ditemukan ini berguna

  
ARTIKEL DI BAGIAN INI

Integrasi melalui jCenter

Integrasi Manual dengan File JAR

Penggunaan Lanjutan

Adaptor AdMob

Mopub

MOBILE, TERPENUHI.

   

Blog

Faq

Kebijakan

Hubungi kami

Tema oleh Lotus Themes