Mobile Platform as a Service：Tentang booth

Jenis booth

MCDP mendukung tujuh jenis booth berikut: splash, pop-up, bulletin, banner, list, float, dan booth kustom.

• Splash: Sebuah booth di area layar penuh saat aplikasi melakukan booting dingin. Booth splash bersifat unik secara global dalam aplikasi.

• Pop-up: Sebuah booth di aplikasi dengan lebar dan tinggi yang dapat dikontrol di area lapisan mengambang.

• Bulletin: Menyampaikan informasi relevan kepada pengguna dalam bentuk siaran pesan.

• Banner: Sebuah booth di area persegi panjang dengan posisi tetap pada halaman aplikasi yang mendukung banner horizontal dengan satu atau lebih ruang iklan.

• List: Banyak iklan berbeda terdaftar di area pada halaman aplikasi.

• Float: Sebuah booth di posisi tetap pada halaman aplikasi.

• Kustom: Iklan kustom tipe salinan.

Informasi dasar booth

Booth memiliki informasi dasar seperti nama booth, ID booth, dan waktu efektif (cache).

• Nama Booth: Wajib. Anda dapat memasukkan maksimal 30 karakter, dan nama tersebut tidak boleh sama dengan nama yang sudah ada.

• ID Booth: Wajib. ID dapat berisi huruf, angka, garis bawah (_), dan tanda hubung (-), dan tidak boleh sama dengan ID booth yang sudah ada.

  • ID Kustom: Jika booth merupakan booth dinamis, pilih bidang ini, lalu masukkan ID booth dan alamat halaman di kotak teks ID Kustom.

    • Alamat Halaman iOS: Masukkan alamat halaman klien iOS yang menampilkan booth. Untuk memasukkan VCName halaman, Anda perlu menghubungi pengembang aplikasi, misalnya, MPHomeViewController. Perhatikan bahwa VCName harus mewarisi dari DTViewController. Jika tidak, booth tidak akan ditampilkan.

    • Alamat Halaman Android: Masukkan alamat halaman klien Android yang menampilkan booth. Untuk memasukkan ActivityName halaman, Anda perlu menghubungi pengembang aplikasi, misalnya, com.mpaas.demo.cdp.DynamicContent1Activity.

    • Alamat Halaman HTML5: Masukkan alamat halaman HTML5 yang menampilkan booth. Untuk memasukkan jalur lengkap halaman, Anda perlu menghubungi pengembang aplikasi. Anda dapat menggunakan objek window.location untuk mendapatkan jalur lengkap halaman HTML5.

  • ID Preset Klien: Saat booth merupakan booth preset klien, pilih bidang ini, dan salin serta masukkan ID booth preset di kotak teks ID Preset Klien. Anda dapat menghubungi pengembang aplikasi untuk mendapatkan ID tersebut.

  • ID Booth Splash: Pilih bidang ini saat merupakan booth splash. ID booth splash default adalah STARTPAGE dan tidak dapat diubah. Sebuah aplikasi hanya dapat memiliki satu booth splash, yaitu jika sudah ada satu booth splash dalam aplikasi, Anda tidak dapat membuat booth splash lainnya.

• Masa Berlaku (Cache): Wajib. Mengacu pada waktu penyimpanan cache setelah iklan booth dimuat sekali. Waktu harus disesuaikan dengan pertimbangan penggunaan lalu lintas unduhan dan pengalaman pengguna. Rentang waktu yang dapat diatur berkisar antara 00:00:00 hingga 71:59:59.

Informasi konfigurasi booth

Booth dapat dikonfigurasikan untuk jenis booth, jenis materi booth, posisi booth, gaya, tinggi booth, lebar booth, dan jumlah ruang iklan.

• Jenis Booth: MCDP mendukung tujuh jenis booth: splash, popup, bulletin, banner, list, float, dan booth kustom.

• Jenis Materi Booth: Wajib. Mengacu pada jenis materi yang didukung oleh booth. Beberapa booth dapat disesuaikan.

• Posisi Booth: Wajib. Mengacu pada posisi booth pada halaman, termasuk lapisan mengambang atas halaman, bagian atas halaman, bagian bawah halaman, kepala daftar, bagian bawah daftar, kiri atas layar, kanan atas layar, kiri tengah layar, kanan tengah layar, kiri bawah layar, dan kanan bawah layar. Beberapa booth dapat disesuaikan.

  null

  Jenis booth yang berbeda dapat dikonfigurasikan dengan posisi yang berbeda. Untuk detailnya, lihat lembar informasi konfigurasi booth berikut.

  Float Atas	Bagian Atas Halaman	Bagian Bawah Halaman	Kepala Daftar
  Booth berada di bagian atas halaman, mengambang di atas tata letak halaman, dan tidak bergerak ke bawah tata letak asli. Ini adalah posisi tetap relatif terhadap layar, lebar booth sama dengan lebar halaman.	Booth berada di bagian atas halaman dan bergerak ke bawah tata letak asli. Ini adalah posisi tetap relatif terhadap halaman, lebar booth sama dengan lebar halaman.	Booth berada di bagian bawah halaman dan bergerak ke atas tata letak halaman asli. Ini adalah posisi tetap relatif terhadap halaman, lebar booth sama dengan lebar halaman.	Terletak di bagian atas daftar (di atas ruang iklan pertama), dan bergerak ke bawah tata letak daftar asli ke bawah. Ini adalah posisi tetap relatif terhadap daftar, lebar booth sama dengan lebar daftar.
  Bagian Bawah Daftar	Kiri Atas Layar	Kiri Tengah Layar	Kiri Bawah Layar
  Terletak di bagian bawah daftar (di bawah ruang iklan terakhir), dan bergerak ke atas tata letak daftar asli ke atas. Ini adalah posisi tetap relatif terhadap daftar, lebar booth sama dengan lebar daftar.	Hanya untuk booth float. Terletak di kiri atas layar, mengambang di atas tata letak halaman, tidak memengaruhi tata letak halaman asli, dan merupakan posisi tetap relatif terhadap layar.	Hanya untuk booth float. Terletak di tengah sisi kiri layar, mengambang di atas tata letak halaman, tidak memengaruhi tata letak halaman asli, dan merupakan posisi tetap relatif terhadap layar.	Hanya untuk booth float. Terletak di kiri bawah layar, mengambang di atas tata letak halaman, tidak memengaruhi tata letak halaman asli, dan merupakan posisi tetap relatif terhadap layar.
  Kanan Atas Layar	Kanan Tengah Layar	Kanan Bawah Layar
  Terletak di kanan atas layar, mengambang di atas tata letak halaman, tidak memengaruhi tata letak halaman asli, dan merupakan posisi tetap relatif terhadap layar.	Hanya untuk booth float. Terletak di tengah kanan layar, mengambang di atas tata letak halaman, tidak memengaruhi tata letak halaman asli, dan merupakan posisi tetap relatif terhadap layar.	Hanya untuk booth float. Terletak di kanan bawah layar, mengambang di atas tata letak halaman, tidak memengaruhi tata letak halaman asli, dan merupakan posisi tetap relatif terhadap layar.

• Gaya: Wajib. Yaitu penampilan dan gaya booth, termasuk warna latar belakang, warna latar depan, warna teks, dan warna kontrol. Beberapa booth dapat disesuaikan.

  • Warna Latar Belakang: Warna latar belakang booth, nilainya adalah #F8F8F8 secara default.

  • Warna Latar Depan: Warna latar depan booth. Warna latar depan booth adalah warna latar belakang yang muncul saat booth diklik dan nilainya adalah #E7E7E5 secara default. Saat booth diklik, jika ada alamat pengalihan untuk materi di booth, warna latar depan dirender. Jika tidak, warna latar belakang dirender. Untuk konfigurasi alamat pengalihan, lihat Membuat Aktivitas > Menambahkan Iklan.

  • Warna Teks: Warna teks di booth, nilainya adalah #FF0000 secara default.

  • Warna Kontrol: Warna kontrol (corong kecil) di booth, nilainya adalah #1A1311 secara default.

• Tinggi Booth: Wajib. Tinggi booth di halaman aplikasi dalam px. Beberapa booth dapat disesuaikan.

• Lebar Booth: Wajib. Lebar booth di halaman aplikasi dalam px. Beberapa booth dapat disesuaikan.

• Ruang Iklan: Wajib. Booth tipe banner dan list mendukung beberapa bingkai, dan jumlah ruang iklan adalah jumlah bingkai di booth. Beberapa booth dapat disesuaikan.

  

• Durasi Tampilan Setiap Pesan: Konfigurasi ini terkait dengan jumlah ruang iklan. Waktu putar informasi tunggal tidak dapat dikonfigurasi saat jumlah ruang iklan adalah 1. Dan saat jumlah ruang iklan bukan 1, waktu putar informasi tunggal dapat dikonfigurasi sebagai bilangan bulat dari 1 hingga 10.

  	Splash	Pop-up	Bulletin	Banner	List	Float	Kustom
  Jenis Booth	√	√	√	√	√	√	√
  Jenis materi booth	√	√	x	√	√	√	x
  Posisi booth	Default	Posisi default	Float Atas	Float Atas	Float Atas	Kiri Atas Layar	x
  			Bagian Atas Halaman	Bagian Atas Halaman	Bagian Atas Halaman	Kanan Atas Layar
  			Bagian Bawah Halaman	Bagian Bawah Halaman	Bagian Bawah Halaman	Kiri Tengah Layar
  			Kepala Daftar (Hanya tersedia untuk halaman Native)	Kepala Daftar (Hanya tersedia untuk halaman Native)	Kepala Daftar (Hanya tersedia untuk halaman Native)	Kanan Tengah Layar
  			Bagian Bawah Daftar (Hanya tersedia untuk halaman Native)	Bagian Bawah Daftar (Hanya tersedia untuk halaman Native)	Bagian Bawah Daftar (Hanya tersedia untuk halaman Native)	Kiri Bawah Layar
  			-	-	-	Kanan Bawah Layar
  Gaya	x	x	√	x	x	x	√
  Tinggi booth	x	√	√	√	√	√	x
  Lebar booth	x	√	x	x	x	√	x
  Ruang iklan	1	1	1	1-10	1-10	1	1
  Durasi tampilan setiap pesan	x	x	x	1-10s	1-10s	x	x
  Catatan: “√” berarti elemen ini didukung dan harus dikonfigurasi; “x” berarti elemen ini tidak didukung; "-" berarti tidak ada konten.

Materi booth yang didukung

Jenis materi booth yang didukung oleh MCDP tercantum dalam tabel berikut:

• Teks: Teks biasa ditampilkan.

• Gambar Statis: Gambar statis dalam format PNG, JPG, dan JPEG ditampilkan.

• GIF: GIF ditampilkan.

• Animasi Lottie: Animasi Lottie ditampilkan.

• Halaman HTML5: Halaman HTML5 online ditampilkan.

Jenis materi booth yang didukung bervariasi menurut jenis booth, seperti yang dijelaskan dalam tabel berikut.

Mode konfigurasi booth

MCDP menyediakan dua mode konfigurasi booth: konfigurasi dinamis dan preset klien. Anda dapat memilih salah satu sesuai kebutuhan.

• Konfigurasi Dinamis

  Dalam kasus konfigurasi booth dinamis, setelah Anda menambahkan SDK MCDP ke proyek klien, langsung konfigurasikan properti booth di konsol, termasuk nama booth, ID booth, halaman booth, jenis booth, jenis materi booth, posisi booth, lebar booth, tinggi booth, dan jumlah ruang iklan.

  Jenis booth yang didukung oleh booth dinamis meliputi pop-up, bulletin, banner, list, float, dan booth kustom. Untuk posisi booth yang didukung oleh berbagai jenis booth, lihat kolom Posisi Booth di lembar informasi konfigurasi booth. Dalam konfigurasi dinamis, hanya konten booth yang dikonfigurasikan, bukan posisinya. Booth dinamis tidak mendukung posisi belly-band.

  Perhatikan hal-hal berikut saat menggunakan booth dinamis:

  • Untuk booth kustom, Anda perlu melakukan preset booth di klien terlebih dahulu. Jenis booth ini bersifat khusus dan berlaku untuk skenario tertentu yang memerlukan salinan kustom. Sebagai contoh kotak pencarian, di konsol, Anda dapat mendefinisikan isi salinan di kotak pencarian, tetapi Anda tidak dapat mengatur posisi, lebar, dan tinggi kotak pencarian, dan properti ini perlu dikonfigurasikan melalui klien.

  • Di klien Android, lapisan mengambang atas atau bagian atas halaman harus berisi kontrol ViewGroup dengan tag h5_titlebar, atau tata letak harus berisi kontrol AUTitleBar dari komponen antui-build; kepala/bagian bawah daftar harus berisi kontrol ListView.

  • Di klien iOS, kepala/bagian bawah daftar harus berisi kontrol UITableView.

• Preset Klien

  Dalam kasus booth yang telah dipreset di klien, Anda perlu menambahkan SDK MCDP ke proyek klien dan melakukan preset beberapa properti booth di proyek klien melalui coding, termasuk ID, halaman, posisi, lebar, dan tinggi booth. Kemudian Anda perlu membuat booth di konsol dan memasukkan ID booth yang telah dipreset di proyek klien untuk menyelesaikan pembuatan booth. Anda juga dapat mengatur lebar dan tinggi booth di konsol, tetapi keduanya hanya dapat diatur saat belum dikonfigurasi di proyek klien.

  Jenis booth yang didukung oleh booth yang telah dipreset di klien meliputi pop-up, bulletin, banner, list, float, dan booth kustom. Mode konfigurasi klien tersedia untuk mendukung posisi booth yang tidak didukung oleh booth dinamis (misalnya, posisi belly-band).

  null

  Untuk kemudahan penyesuaian, kami sarankan Anda hanya melakukan preset ID, halaman, dan posisi booth di proyek klien dan hanya mengonfigurasi tinggi booth di konsol.

  Untuk detail tentang prosedur melakukan preset booth di halaman berbeda, lihat artikel berikut:

  • Halaman Android: Konfigurasikan Booth Preset di aplikasi Android.

  • iOS page: Konfigurasi booth preset pada aplikasi Android.

  • Halaman HTML5: Konfigurasikan Booth Preset di halaman HTML5.