Halaman ini diterjemahkan oleh Cloud Translation API.

Engage SDK Perjalanan: Petunjuk integrasi teknis pihak ketiga

Tingkatkan engagement aplikasi dengan menjangkau pengguna di mana pun mereka berada. Integrasikan Engage SDK untuk menayangkan rekomendasi yang dipersonalisasi dan konten lanjutan langsung kepada pengguna di berbagai platform di perangkat, seperti Kumpulan Koleksi, Entertainment Space, dan Play Store. Integrasi ini menambahkan kurang dari 50 KB (terkompresi) ke APK rata-rata dan memerlukan waktu sekitar satu minggu bagi developer untuk sebagian besar aplikasi. Pelajari lebih lanjut di situs bisnis kami.

Panduan ini berisi petunjuk bagi partner developer untuk mengirimkan konten perjalanan dan acara ke platform konten Engage.

Detail integrasi

Terminologi

Integrasi ini mencakup jenis cluster berikut: Rekomendasi, Unggulan, Reservasi, dan Lanjutkan Penelusuran.

Cluster Rekomendasi menampilkan saran perjalanan & acara yang dipersonalisasi dari setiap partner developer. Rekomendasi ini dapat dipersonalisasi untuk pengguna atau digeneralisasi (misalnya, item yang sedang trending). Gunakan ini untuk menampilkan rekomendasi artikel, acara, penginapan, atau tempat menarik.
- Cluster Rekomendasi dapat dibuat dari listingan ArticleEntity, EventEntity, LodgingEntity, PointOfInterestEntity, atau StoreEntity, tetapi tidak dapat berupa campuran berbagai jenis entity.
Rekomendasi Anda menggunakan struktur berikut:
- Cluster Rekomendasi: Tampilan UI yang berisi kelompok rekomendasi dari partner developer yang sama.
- Entity: Objek yang mewakili satu item dalam cluster. Integrasi ini menawarkan beberapa entitas yang akan ditampilkan menggunakan Cluster Rekomendasi:
  - ArticleEntity: ArticleEntity mewakili rekomendasi untuk konten berbasis teks yang terkait dengan perjalanan & acara. Fitur ini dapat digunakan untuk artikel, postingan blog, konten pemasaran, cuplikan berita, dll.
    
    Gambar 1: UI yang menampilkan satu ArticleEntity dalam cluster Rekomendasi.
  - EventEntity: EventEntity mewakili acara yang akan berlangsung di masa mendatang. Waktu mulai acara adalah informasi penting yang perlu disampaikan kepada pengguna.
    
    Gambar 2: UI yang menampilkan satu EventEntity dalam Cluster rekomendasi.
  - LodgingEntity: LodgingEntity merepresentasikan akomodasi, seperti hotel, apartemen, rumah liburan untuk penyewaan jangka pendek dan jangka panjang.
    
    Gambar 3: UI yang menampilkan satu LodgingEntity dalam cluster Rekomendasi.
  - StoreEntity: StoreEntity merepresentasikan toko, restoran, kafe, dll. Objek ini menyoroti konten yang menampilkan tempat makan atau toko sebagai informasi penting yang perlu disampaikan kepada pengguna.
    
    Gambar 4: UI yang menampilkan satu StoreEntity dalam cluster Rekomendasi.
  - PointOfInterestEntity: PointOfInterestEntity merepresentasikan tempat menarik seperti SPBU, tempat acara, taman hiburan, museum, tempat wisata, jalur pendakian, dll. Entitas ini menyoroti konten yang lokasinya merupakan informasi penting yang perlu disampaikan kepada pengguna. Fitur ini tidak boleh digunakan untuk penginapan, toko, atau tempat makan.
    
    Gambar 5: UI menampilkan satu PointOfInterestEntity dalam cluster Rekomendasi.
Cluster Reservasi menampilkan konten yang baru-baru ini diakses oleh pengguna dari beberapa partner developer dalam satu pengelompokan UI. Setiap partner developer akan diizinkan untuk menyiarkan maksimum 10 entity di cluster Reservasi.

Konten reservasi Anda dapat menggunakan struktur berikut:
- RestaurantReservationEntity: RestaurantReservationEntity merepresentasikan reservasi untuk restoran atau kafe dan membantu pengguna melacak reservasi restoran yang akan datang atau sedang berlangsung.
  
  Gambar 6. UI menampilkan satu RestaurantReservationEntity dalam cluster Reservasi.
- EventReservationEntity: EventReservationEntity merepresentasikan reservasi untuk suatu acara dan membantu pengguna melacak reservasi acara mendatang atau yang sedang berlangsung. Peristiwa dapat mencakup, tetapi tidak terbatas pada, hal berikut:
  - Acara olahraga seperti reservasi untuk pertandingan sepak bola
  - Acara game seperti reservasi untuk eSports
  - Acara hiburan seperti reservasi untuk menonton film di bioskop, konser, teater, penandatanganan buku
  - Reservasi perjalanan atau tempat menarik seperti tur berpemandu, tiket museum
  - Reservasi acara sosial / seminar / konferensi
  - Reservasi sesi Pendidikan / Pelatihan
  Gambar 7. UI menampilkan satu EventReservationEntity dalam cluster Reservasi.
- LodgingReservationEntity: LodgingEntityReservation merepresentasikan pemesanan untuk akomodasi perjalanan dan membantu pengguna melacak pemesanan hotel atau rental akomodasi yang akan datang atau sedang berlangsung.
  
  Gambar 8. UI menampilkan satu LodgingReservationEntity dalam cluster Reservasi.
- TransportationReservationEntity: TransportationReservationEntity mewakili reservasi transportasi dengan mode apa pun dan membantu pengguna melacak reservasi untuk penerbangan, feri, kereta, bus, transportasi online, atau kapal pesiar yang akan datang atau sedang berlangsung.
  
  Gambar 9. UI menampilkan satu TransportationReservationEntity dalam cluster Reservasi.
- VehicleRentalReservationEntity: VehicleRentalReservationEntity mewakili reservasi rental kendaraan dan membantu pengguna melacak reservasi rental kendaraan yang akan datang atau sedang berlangsung.
  
  Gambar 10. UI menampilkan satu VehicleRentalReservationEntity dalam cluster Reservasi.
Cluster Unggulan menampilkan pilihan entity dari beberapa partner developer dalam satu pengelompokan UI. Akan ada satu cluster Unggulan yang ditampilkan di dekat bagian atas UI dengan penempatan prioritas di atas semua cluster Rekomendasi. Setiap partner developer akan diizinkan untuk menyiarkan hingga 10 entity di cluster Unggulan.
- GenericFeaturedEntity: GenericFeaturedEntity berbeda dari Item rekomendasi karena Item unggulan harus digunakan untuk satu konten teratas dari developer dan harus merepresentasikan satu konten paling penting yang akan menarik dan relevan bagi pengguna.
  
  Gambar 11: UI yang menampilkan FeaturedCluster dengan daftar GenericFeaturedEntity
Cluster Lanjutkan Penelusuran membantu pengguna melanjutkan perjalanan penelusuran perjalanan mereka sebelumnya dengan menampilkan daftar kueri penelusuran yang baru-baru ini ditelusuri pengguna di semua aplikasi perjalanan mereka. Cluster akan disematkan di posisi kedua, setelah cluster reservasi dan sebelum cluster rekomendasi dan unggulan. Setiap partner developer akan diizinkan untuk menyiarkan hingga 3 entity di cluster Lanjutkan Penelusuran.
- PointOfInterestEntity: PointOfInterestEntity merepresentasikan tempat menarik seperti SPBU, tempat acara, taman hiburan, museum, tempat wisata, jalur hiking, dll. Entitas ini menyoroti konten yang sebelumnya telah dicari pengguna.

Persiapan

Level API minimum: 19

Tambahkan library com.google.android.engage:engage-core ke aplikasi Anda:

dependencies {
    // Make sure you also include that repository in your project's build.gradle file.
    implementation 'com.google.android.engage:engage-core:1.5.2'
}

Ringkasan

Desain ini didasarkan pada implementasi layanan terikat.

Data yang dapat dipublikasikan klien tunduk pada batas berikut untuk berbagai jenis cluster:

Jenis cluster	Batas cluster	Batas entity minimum dalam cluster	Batas maksimum entity dalam cluster
Cluster Rekomendasi	Maksimal 7	Minimal 1	Maksimal 50 (`ArticleEntity`, `EventEntity`, `LodgingEntity`, `StoreEntity`, atau `PointOfInterestEntity`)
Cluster Reservasi	Maksimal 1	Minimal 1	Maksimal 20 (`RestaurantReservationEntity`, `EventReservationEntity`, `LodgingReservationEntity`, `TransportationReservationEntity`, atau `VehicleRentalReservationEntity`)
Cluster Unggulan	Maksimal 1	Minimal 1	Maksimal 20 (`GenericFeaturedEntity`)
Lanjutkan Cluster Penelusuran	Maksimal 1	Minimal 1	Maksimal 3 (`PointOfInterestEntity`)

Langkah 1: Memberikan data entity

SDK telah menentukan entity yang berbeda untuk mewakili setiap jenis item. Kami mendukung entity berikut untuk kategori Perjalanan & Acara:

GenericFeaturedEntity
ArticleEntity
EventEntity
LodgingEntity
StoreEntity
PointOfInterestEntity
RestaurantReservationEntity
EventReservationEntity
LodgingReservationEntity
TransportationReservationEntity
VehicleRentalReservationEntity

Diagram di bawah ini menguraikan atribut dan persyaratan yang tersedia untuk setiap jenis.

`GenericFeaturedEntity`

Atribut	Persyaratan	Deskripsi	Format
URI Tindakan	Wajib	Deep Link ke entity dalam aplikasi penyedia. Catatan: Anda dapat menggunakan deep link untuk atribusi. Lihat FAQ ini	URI
Gambar poster	Wajib	Kami hanya akan menampilkan 1 gambar jika beberapa gambar disediakan. Rasio aspek yang direkomendasikan adalah 16:9 Catatan: Jika badge disediakan, pastikan ruang aman 24 dp di bagian atas dan bawah gambar	Lihat Spesifikasi Gambar untuk panduan.
Judul	Opsional	Judul entitas.	Teks bebas Ukuran teks yang direkomendasikan: 50 karakter
Deskripsi	Opsional	Satu paragraf teks untuk mendeskripsikan entity. Catatan: Deskripsi atau daftar subjudul akan ditampilkan kepada pengguna, bukan keduanya.	Teks bebas Ukuran teks yang direkomendasikan: 180 karakter
Daftar subtitel	Opsional	Hingga 3 subjudul, dengan setiap subjudul berupa satu baris teks. Catatan: Deskripsi atau daftar subjudul akan ditampilkan kepada pengguna, bukan keduanya.	Teks bebas Ukuran teks yang direkomendasikan untuk setiap subjudul: maks. 50 karakter
Badge	Opsional	Setiap badge berupa teks bebas (maks. 15 karakter) atau gambar kecil. Perlakuan UX khusus di atas gambar/video, misalnya, sebagai overlay badge pada gambar "Update langsung" Durasi membaca artikel
Badge - Teks	Opsional	Judul untuk badge Catatan: Teks atau gambar diperlukan untuk badge	Teks bebas Ukuran teks yang direkomendasikan: maks. 15 karakter
Badge - Gambar	Opsional	Gambar kecil Perlakuan UX khusus, misalnya sebagai overlay badge pada thumbnail gambar/video. Catatan: Teks atau gambar diperlukan untuk badge	Lihat Spesifikasi Gambar untuk panduan.
Kategori Konten	Opsional	Mendeskripsikan kategori konten dalam entitas.	Daftar Enum Lihat bagian Kategori Konten untuk mendapatkan panduan.
DisplayTimeWindow (Opsional) - Menetapkan periode waktu untuk konten yang akan ditampilkan di platform
Stempel Waktu Awal	Opsional	Stempel waktu epoch yang setelahnya konten akan ditampilkan di platform. Jika tidak disetel, konten akan memenuhi syarat untuk ditampilkan di platform.	Stempel waktu epoch dalam milidetik
Stempel Waktu Akhir	Opsional	Stempel waktu epoch yang setelahnya konten tidak lagi ditampilkan di platform. Jika tidak disetel, konten akan memenuhi syarat untuk ditampilkan di platform.	Stempel waktu epoch dalam milidetik

`ArticleEntity`

Atribut	Persyaratan	Deskripsi	Format
URI Tindakan	Wajib	Deep Link ke entity dalam aplikasi penyedia. Catatan: Anda dapat menggunakan deep link untuk atribusi. Lihat FAQ ini	URI
Judul	Wajib	Judul entitas.	Teks bebas Ukuran teks yang direkomendasikan: Maks. 50 karakter
Gambar poster	Opsional	Kami hanya akan menampilkan 1 gambar jika beberapa gambar disediakan. Rasio aspek yang direkomendasikan adalah 16:9 Catatan: Sebaiknya gunakan gambar. Jika badge disediakan, pastikan ruang aman 24 dps di bagian atas dan bawah gambar	Lihat Spesifikasi Gambar untuk panduan.
Sumber - Judul	Opsional	Nama penulis, organisasi, atau reporter	Teks bebas Ukuran teks yang direkomendasikan: Di bawah 25 karakter
Sumber - Gambar	Opsional	Gambar sumber seperti penulis, organisasi, reporter	Lihat Spesifikasi Gambar untuk panduan.
Deskripsi	Opsional	Satu paragraf teks untuk mendeskripsikan entity. Catatan: Deskripsi atau daftar subjudul akan ditampilkan kepada pengguna, bukan keduanya.	Teks bebas Ukuran teks yang direkomendasikan: 180 karakter
Daftar subtitel	Opsional	Hingga 3 subjudul, dengan setiap subjudul berupa satu baris teks. Catatan: Deskripsi atau daftar subjudul akan ditampilkan kepada pengguna, bukan keduanya.	Teks bebas Ukuran teks yang direkomendasikan untuk setiap subjudul: maks. 50 karakter
Badge	Opsional	Setiap badge berupa teks bebas (maks. 15 karakter) atau gambar kecil. Perlakuan UX khusus di atas gambar/video, misalnya, sebagai overlay badge pada gambar "Update langsung" Durasi membaca artikel
Badge - Teks	Opsional	Judul untuk badge Catatan: Teks atau gambar diperlukan untuk badge	Teks bebas Ukuran teks yang direkomendasikan: maks. 15 karakter
Badge - Gambar	Opsional	Gambar kecil Perlakuan UX khusus, misalnya sebagai overlay badge pada thumbnail gambar/video. Catatan: Teks atau gambar diperlukan untuk badge	Lihat Spesifikasi Gambar untuk panduan.
Waktu Publikasi Konten	Opsional	Ini adalah stempel waktu epoch dalam milidetik saat konten dipublikasikan / diperbarui di aplikasi.	Stempel waktu epoch dalam milidetik
Waktu Engagement Terakhir	Opsional	Stempel waktu epoch dalam milidetik saat pengguna berinteraksi dengan entitas ini terakhir kali.	Stempel waktu epoch dalam milidetik
Persentase Progres	Opsional	Persentase konten lengkap yang telah dikonsumsi oleh pengguna hingga saat ini.	Nilai int antara 0~100 inklusif.
Kategori Konten	Opsional	Mendeskripsikan kategori konten dalam entitas.	Daftar Enum Lihat bagian Kategori Konten untuk mendapatkan panduan.
DisplayTimeWindow (Opsional) - Menetapkan periode waktu untuk konten yang akan ditampilkan di platform
Stempel Waktu Awal	Opsional	Stempel waktu epoch yang setelahnya konten akan ditampilkan di platform. Jika tidak disetel, konten akan memenuhi syarat untuk ditampilkan di platform.	Stempel waktu epoch dalam milidetik
Stempel Waktu Akhir	Opsional	Stempel waktu epoch yang setelahnya konten tidak lagi ditampilkan di platform. Jika tidak disetel, konten akan memenuhi syarat untuk ditampilkan di platform.	Stempel waktu epoch dalam milidetik

`EventEntity`

Atribut	Persyaratan	Deskripsi	Format
URI Tindakan	Wajib	Deep Link ke entity dalam aplikasi penyedia. Catatan: Anda dapat menggunakan deep link untuk atribusi. Lihat FAQ ini	URI
Judul	Wajib	Judul entitas.	String Ukuran teks yang direkomendasikan: Maks. 50 karakter
Waktu Mulai yang Dilokalkan - Stempel Waktu	Wajib	Stempel waktu epoch saat acara diperkirakan akan dimulai.	Joda-Time Instant
Waktu Mulai yang dilokalkan - Zona waktu	Wajib	Zona waktu tempat acara diperkirakan akan dimulai.	DateTimeZone Joda-Time Lihat Spesifikasi Zona Waktu untuk panduan.
Mode acara	Wajib	Kolom untuk menunjukkan apakah acara akan diadakan secara virtual, tatap muka, atau keduanya.	Enum: VIRTUAL, IN_PERSON, atau HYBRID
Gambar poster	Wajib	Kami hanya akan menampilkan 1 gambar jika beberapa gambar disediakan. Rasio aspek yang direkomendasikan adalah 16:9 Catatan: Sebaiknya gunakan gambar. Jika badge disediakan, pastikan ruang aman 24 dps di bagian atas dan bawah gambar	Lihat Spesifikasi Gambar untuk panduan.
Lokasi - Negara	Wajib bersyarat	Negara tempat acara berlangsung. Catatan: Ini diperlukan untuk acara yang bersifat TATAP MUKA atau HYBRID	Teks bebas Ukuran teks yang direkomendasikan: maks. ~20 karakter
Lokasi - Kota	Wajib bersyarat	Kota tempat acara berlangsung. Catatan: Ini diperlukan untuk acara yang bersifat TATAP MUKA atau HYBRID	Teks bebas Ukuran teks yang direkomendasikan: maks. ~20 karakter
Lokasi - Tampilkan Alamat	Wajib bersyarat	Alamat atau nama tempat acara akan berlangsung yang harus ditampilkan kepada pengguna. Catatan: Ini diperlukan untuk acara yang bersifat TATAP MUKA atau HYBRID	Teks bebas Ukuran teks yang direkomendasikan: maks. ~20 karakter
Lokasi - Alamat	Opsional	Alamat jalan (jika ada) lokasi tempat acara diselenggarakan.	Teks bebas Ukuran teks yang direkomendasikan: maks. ~20 karakter
Lokasi - Negara bagian	Opsional	Negara bagian atau provinsi (jika berlaku) tempat acara diselenggarakan.	Teks bebas Ukuran teks yang direkomendasikan: maks. ~20 karakter
Lokasi - Kode pos	Opsional	Kode pos (jika ada) lokasi tempat acara diselenggarakan.	Teks bebas Ukuran teks yang direkomendasikan: maks. ~20 karakter
Lokasi - Lingkungan	Opsional	Lingkungan (jika ada) tempat acara diselenggarakan.	Teks bebas Ukuran teks yang direkomendasikan: maks. ~20 karakter
Waktu akhir	Opsional	Stempel waktu epoch saat acara diperkirakan akan berakhir. Catatan:Nilai ini akan ditampilkan dalam milidetik.	Stempel waktu epoch dalam milidetik
Deskripsi	Opsional	Satu paragraf teks untuk mendeskripsikan entity. Catatan: Deskripsi atau daftar subjudul akan ditampilkan kepada pengguna, bukan keduanya.	Teks bebas Ukuran teks yang direkomendasikan: 180 karakter
Daftar subtitel	Opsional	Hingga 3 subjudul, dengan setiap subjudul berupa satu baris teks. Catatan: Deskripsi atau daftar subjudul akan ditampilkan kepada pengguna, bukan keduanya.	Teks bebas Ukuran teks yang direkomendasikan untuk setiap subjudul: maks. 50 karakter
Badge	Opsional	Setiap badge berupa teks bebas (maks. 15 karakter) atau gambar kecil.
Badge - Teks	Opsional	Judul untuk badge Catatan: Teks atau gambar diperlukan untuk badge	Teks bebas Ukuran teks yang direkomendasikan: maks. 15 karakter
Badge - Gambar	Opsional	Gambar kecil Perlakuan UX khusus, misalnya sebagai overlay badge pada thumbnail gambar/video. Catatan: Teks atau gambar diperlukan untuk badge	Lihat Spesifikasi Gambar untuk panduan.
Harga - CurrentPrice	Wajib bersyarat	Harga tiket/kartu masuk acara saat ini. Harus diberikan jika harga yang dicoret disediakan.	Teks bebas
Harga - StrikethroughPrice	Opsional	Harga asli tiket/kartu masuk untuk acara.	Teks bebas
Info Harga	Opsional	Keterangan harga untuk menampilkan promo, acara, diskon anggota, jika tersedia.	Teks bebas Ukuran teks yang direkomendasikan: di bawah 45 karakter (Teks yang terlalu panjang dapat menampilkan elipsis)
Kategori Konten	Opsional	Mendeskripsikan kategori konten dalam entitas.	Daftar Enum yang Memenuhi Syarat TYPE_MOVIES_AND_TV_SHOWS (Contoh - Bioskop) TYPE_DIGITAL_GAMES (Contoh - eSports) TYPE_MUSIC (Contoh - Konser) TYPE_TRAVEL_AND_LOCAL (Contoh - Tur, festival) TYPE_HEALTH_AND_FITNESS (Contoh - Kelas yoga) TYPE_EDUCATION (Contoh - Kelas) TYPE_SPORTS (Contoh - Pertandingan sepak bola) TYPE_DATING (Contoh - pertemuan) Lihat bagian Kategori Konten untuk mendapatkan panduan.
DisplayTimeWindow (Opsional) - Menetapkan periode waktu untuk konten yang akan ditampilkan di platform
Stempel Waktu Awal	Opsional	Stempel waktu epoch yang setelahnya konten akan ditampilkan di platform. Jika tidak disetel, konten akan memenuhi syarat untuk ditampilkan di platform.	Stempel waktu epoch dalam milidetik
Stempel Waktu Akhir	Opsional	Stempel waktu epoch yang setelahnya konten tidak lagi ditampilkan di platform. Jika tidak disetel, konten akan memenuhi syarat untuk ditampilkan di platform.	Stempel waktu epoch dalam milidetik

`LodgingEntity`

Atribut	Persyaratan	Deskripsi	Format
URI Tindakan	Wajib	Deep Link ke entity dalam aplikasi penyedia. Catatan: Anda dapat menggunakan deep link untuk atribusi. Lihat FAQ ini	URI
Judul	Wajib	Judul entitas.	String Ukuran teks yang direkomendasikan: Maks. 50 karakter
Gambar poster	Wajib	Kami hanya akan menampilkan 1 gambar jika beberapa gambar disediakan. Rasio aspek yang direkomendasikan adalah 16:9 Catatan: Jika badge disediakan, pastikan ruang aman 24 dp di bagian atas dan bawah gambar	Lihat Spesifikasi Gambar untuk panduan.
Lokasi - Negara	Wajib	Negara tempat akomodasi berada.	Teks bebas Ukuran teks yang direkomendasikan: maks. ~20 karakter
Lokasi - Kota	Wajib	Kota tempat akomodasi berada.	Teks bebas Ukuran teks yang direkomendasikan: maks. ~20 karakter
Lokasi - Tampilkan Alamat	Wajib	Alamat yang akan ditampilkan kepada pengguna. Sebaiknya sertakan nama kota dan mungkin negara bagian atau negara untuk sebagian besar kasus penggunaan. Hanya sertakan alamat jalan atau lingkungan jika pengguna berada di dekat lokasi, pengguna mengenal lokasi tersebut, atau kota disertakan dalam judul kelompok. Jika Anda menyertakan alamat jalan, berikan alamat yang ringkas, menggunakan singkatan jika memungkinkan (misalnya, "Jln" untuk "Jalan", "Gg" untuk "Gang").	Teks bebas Ukuran teks yang direkomendasikan: maks. ~20 karakter
Lokasi - Alamat	Opsional	Alamat jalan (jika ada) penginapan.	Teks bebas Ukuran teks yang direkomendasikan: maks. ~20 karakter
Lokasi - Negara bagian	Opsional	Negara bagian atau provinsi (jika berlaku) tempat akomodasi berada.	Teks bebas Ukuran teks yang direkomendasikan: maks. ~20 karakter
Lokasi - Kode pos	Opsional	Kode pos (jika ada) akomodasi.	Teks bebas Ukuran teks yang direkomendasikan: maks. ~20 karakter
Lokasi - Lingkungan	Opsional	Lingkungan (jika ada) penginapan.	Teks bebas Ukuran teks yang direkomendasikan: maks. ~20 karakter
Badge	Opsional	Setiap badge berupa teks bebas (maks. 15 karakter) atau gambar kecil.
Badge - Teks	Opsional	Judul untuk badge Catatan: Teks atau gambar diperlukan untuk badge	Teks bebas Ukuran teks yang direkomendasikan: maks. 15 karakter
Badge - Gambar	Opsional	Gambar kecil Perlakuan UX khusus, misalnya sebagai overlay badge pada thumbnail gambar/video. Catatan: Teks atau gambar diperlukan untuk badge	Lihat Spesifikasi Gambar untuk panduan.
Deskripsi	Opsional	Satu paragraf teks untuk mendeskripsikan entity. Catatan: Deskripsi atau daftar subjudul akan ditampilkan kepada pengguna, bukan keduanya.	Teks bebas Ukuran teks yang direkomendasikan: 180 karakter
Daftar subtitel	Opsional	Hingga 3 subjudul, dengan setiap subjudul berupa satu baris teks. Catatan: Deskripsi atau daftar subjudul akan ditampilkan kepada pengguna, bukan keduanya.	Teks bebas Ukuran teks yang direkomendasikan untuk setiap subjudul: maks. 50 karakter
AvailabilityTimeWindow - Localized Start Time - Timestamp	Opsional	Stempel waktu epoch saat akomodasi diperkirakan akan buka/tersedia.	Joda-Time Instant
AvailabilityTimeWindow - Localized Start Time - Timezone	Opsional	Zona waktu saat akomodasi diperkirakan buka/tersedia.	DateTimeZone Joda-Time Lihat Spesifikasi Zona Waktu untuk panduan.
AvailabilityTimeWindow - Localized End Time - Timestamp	Opsional	Stempel waktu epoch hingga penginapan diperkirakan buka/tersedia.	Joda-Time Instant
AvailabilityTimeWindow - Localized End Time - Timezone	Opsional	Zona waktu saat akomodasi diperkirakan buka/tersedia.	DateTimeZone Joda-Time Lihat Spesifikasi Zona Waktu untuk panduan.
Rating - Nilai maks	Opsional	Nilai skala rating maksimum. Harus diberikan jika nilai rating saat ini juga disediakan.	Angka >= 0,0
Rating - Nilai saat ini	Opsional	Nilai skala rating saat ini. Harus diberikan jika nilai rating maksimum juga disediakan.	Angka >= 0,0
Rating - Jumlah	Opsional	Jumlah rating untuk penginapan. Catatan: Berikan kolom ini jika aplikasi Anda ingin mengontrol cara ini ditampilkan kepada pengguna. Berikan string singkat yang dapat ditampilkan kepada pengguna. Misalnya, jika jumlahnya 1.000.000, pertimbangkan untuk menggunakan singkatan seperti 1M, sehingga tidak terpotong pada ukuran layar yang lebih kecil.	String
Rating - Nilai Jumlah	Opsional	Jumlah rating untuk penginapan. Catatan: Berikan kolom ini jika Anda tidak ingin menangani sendiri logika singkatan tampilan. Jika Jumlah dan Nilai Jumlah ada, kami akan menggunakan Jumlah untuk ditampilkan kepada pengguna	Panjang
Harga - CurrentPrice	Wajib bersyarat	Harga akomodasi saat ini. Harus diberikan jika harga yang dicoret disediakan.	Teks bebas
Harga - StrikethroughPrice	Opsional	Harga asli akomodasi, yang dicoret di UI.	Teks bebas
Info Harga	Opsional	Keterangan harga untuk menampilkan promo, acara, diskon anggota, jika tersedia.	Teks bebas Ukuran teks yang direkomendasikan: di bawah 45 karakter (Teks yang terlalu panjang dapat menampilkan elipsis)
DisplayTimeWindow (Opsional) - Menetapkan periode waktu untuk konten yang akan ditampilkan di platform
Stempel Waktu Awal	Opsional	Stempel waktu epoch yang setelahnya konten akan ditampilkan di platform. Jika tidak disetel, konten akan memenuhi syarat untuk ditampilkan di platform.	Stempel waktu epoch dalam milidetik
Stempel Waktu Akhir	Opsional	Stempel waktu epoch yang setelahnya konten tidak lagi ditampilkan di platform. Jika tidak disetel, konten akan memenuhi syarat untuk ditampilkan di platform.	Stempel waktu epoch dalam milidetik

`StoreEntity`

Objek StoreEntity mewakili setiap toko yang ingin dipublikasikan oleh partner developer, seperti tempat makan atau restoran populer yang relevan dengan pengalaman perjalanan seseorang.

Atribut	Persyaratan	Deskripsi	Format
Gambar poster	Wajib	Minimal satu gambar harus diberikan.	Lihat Spesifikasi Gambar untuk panduan.
URI Tindakan	Wajib	Deep Link ke entity dalam aplikasi penyedia. Catatan: Anda dapat menggunakan deep link untuk atribusi. Lihat FAQ ini	URI
Judul	Opsional	Nama toko.	Teks bebas Ukuran teks yang direkomendasikan: di bawah 45 karakter (Teks yang terlalu panjang dapat menampilkan elipsis)
Lokasi	Opsional	Lokasi toko.	Teks bebas Ukuran teks yang direkomendasikan: di bawah 45 karakter (Teks yang terlalu panjang dapat menampilkan elipsis)
Keterangan	Opsional	Keterangan untuk menampilkan promo, acara, atau info terbaru terkait toko, jika tersedia.	Teks bebas Ukuran teks yang direkomendasikan: di bawah 45 karakter (Teks yang terlalu panjang dapat menampilkan elipsis)
Cetak kecil keterangan	Opsional	Teks cetak kecil untuk keterangan.	Teks bebas Ukuran teks yang direkomendasikan: di bawah 45 karakter (Teks yang terlalu panjang dapat menampilkan elipsis)
Deskripsi	Opsional	Deskripsi toko.	Teks bebas Ukuran teks yang direkomendasikan: di bawah 90 karakter (Teks yang terlalu panjang dapat menampilkan elipsis)
Kategori	Opsional	Kategori toko, dalam konteks tempat makan, dapat berupa masakan seperti "prancis", "amerika baru", "ramen", "santapan mewah".	Teks bebas Ukuran teks yang direkomendasikan: di bawah 45 karakter (Teks yang terlalu panjang dapat menampilkan elipsis)
Rating - Nilai maks	Opsional	Nilai skala rating maksimum. Harus diberikan jika nilai rating saat ini juga disediakan.	Angka >= 0,0
Rating - Nilai saat ini	Opsional	Nilai skala rating saat ini. Harus diberikan jika nilai rating maksimum juga disediakan.	Angka >= 0,0
Rating - Jumlah	Opsional	Jumlah rating untuk penginapan. Catatan: Berikan kolom ini jika aplikasi Anda ingin mengontrol cara ini ditampilkan kepada pengguna. Berikan string singkat yang dapat ditampilkan kepada pengguna. Misalnya, jika jumlahnya 1.000.000, pertimbangkan untuk menggunakan singkatan seperti 1M, sehingga tidak terpotong pada ukuran layar yang lebih kecil.	String
Rating - Nilai Jumlah	Opsional	Jumlah rating untuk penginapan. Catatan: Berikan kolom ini jika Anda tidak ingin menangani sendiri logika singkatan tampilan. Jika Jumlah dan Nilai Jumlah ada, kami akan menggunakan Jumlah untuk ditampilkan kepada pengguna	Panjang
DisplayTimeWindow (Opsional) - Menetapkan periode waktu untuk konten yang akan ditampilkan di platform
Stempel Waktu Awal	Opsional	Stempel waktu epoch yang setelahnya konten akan ditampilkan di platform. Jika tidak disetel, konten akan memenuhi syarat untuk ditampilkan di platform.	Stempel waktu epoch dalam milidetik
Stempel Waktu Akhir	Opsional	Stempel waktu epoch yang setelahnya konten tidak lagi ditampilkan di platform. Jika tidak disetel, konten akan memenuhi syarat untuk ditampilkan di platform.	Stempel waktu epoch dalam milidetik

`PointOfInterestEntity`

Atribut	Persyaratan	Deskripsi	Format
URI Tindakan	Wajib	Deep Link ke entity dalam aplikasi penyedia. Catatan: Anda dapat menggunakan deep link untuk atribusi. Lihat FAQ ini	URI
Judul	Wajib	Judul entitas.	String Ukuran teks yang direkomendasikan: Maks. 50 karakter
Gambar poster	Wajib bersyarat	Kami hanya akan menampilkan 1 gambar jika beberapa gambar disediakan. Rasio aspek yang direkomendasikan adalah 16:9 Catatan: Gambar diperlukan jika entity adalah bagian dari cluster rekomendasi. Jika badge disediakan, pastikan ruang aman 24 dp di bagian atas dan bawah gambar	Lihat Spesifikasi Gambar untuk panduan.
Waktu Engagement Terakhir	Wajib bersyarat	Stempel waktu epoch saat pengguna terakhir kali berinteraksi dengan entitas ini. Catatan: Kolom ini wajib diisi jika entitas adalah bagian dari cluster lanjutkan penelusuran.	Joda-Time Instant
Lokasi - Negara	Wajib bersyarat	Negara tempat lokasi menarik berada. Catatan: Kolom ini wajib diisi jika entitas adalah bagian dari kelompok rekomendasi.	Teks bebas Ukuran teks yang direkomendasikan: maks. ~20 karakter
Lokasi - Kota	Wajib bersyarat	Kota tempat acara berlangsung. Catatan: Kolom ini wajib diisi jika entitas adalah bagian dari kelompok rekomendasi.	Teks bebas Ukuran teks yang direkomendasikan: maks. ~20 karakter
Lokasi - Tampilkan Alamat	Wajib bersyarat	Alamat yang akan ditampilkan kepada pengguna. Berikan alamat yang ringkas, menggunakan singkatan jika memungkinkan (misalnya, "Jln" untuk "Jalan", "Gg" untuk "Gang"). String ini dapat dipangkas bergantung pada perangkat dan setelan pengguna. Sertakan nama kota untuk identifikasi yang jelas. Catatan: Kolom ini wajib diisi jika entitas adalah bagian dari kelompok rekomendasi.	Teks bebas Ukuran teks yang direkomendasikan: maks. ~35 karakter
Lokasi - Alamat	Opsional	Alamat jalan (jika ada) dari tempat menarik.	Teks bebas Ukuran teks yang direkomendasikan: maks. ~20 karakter
Lokasi - Negara bagian	Opsional	Negara bagian atau provinsi (jika berlaku) tempat titik minat berada.	Teks bebas Ukuran teks yang direkomendasikan: maks. ~20 karakter
Lokasi - Kode pos	Opsional	Kode pos (jika ada) lokasi menarik.	Teks bebas Ukuran teks yang direkomendasikan: maks. ~20 karakter
Lokasi - Lingkungan	Opsional	Lingkungan (jika ada) lokasi menarik.	Teks bebas Ukuran teks yang direkomendasikan: maks. ~20 karakter
AvailabilityTimeWindow - Localized Start Time - Timestamp	Opsional	Stempel waktu epoch saat tempat menarik diperkirakan akan buka/tersedia.	Joda-Time Instant
AvailabilityTimeWindow - Localized Start Time - Timezone	Opsional	Zona waktu saat tempat menarik diperkirakan akan buka/tersedia.	DateTimeZone Joda-Time Lihat Spesifikasi Zona Waktu untuk panduan.
AvailabilityTimeWindow - Localized End Time - Timestamp	Opsional	Stempel waktu epoch hingga saat tempat menarik diperkirakan buka/tersedia.	Joda-Time Instant
AvailabilityTimeWindow - Localized End Time - Timezone	Opsional	Zona waktu saat tempat menarik diperkirakan akan buka/tersedia.	DateTimeZone Joda-Time Lihat Spesifikasi Zona Waktu untuk panduan.
Badge	Opsional	Setiap badge berupa teks bebas (maks. 15 karakter) atau gambar kecil.
Badge - Teks	Opsional	Judul untuk badge Catatan: Teks atau gambar diperlukan untuk badge	Teks bebas Ukuran teks yang direkomendasikan: maks. 15 karakter
Badge - Gambar	Opsional	Gambar kecil Perlakuan UX khusus, misalnya sebagai overlay badge pada thumbnail gambar/video. Catatan: Teks atau gambar diperlukan untuk badge	Lihat Spesifikasi Gambar untuk panduan.
Deskripsi	Opsional	Satu paragraf teks untuk mendeskripsikan entity. Catatan: Deskripsi atau daftar subjudul akan ditampilkan kepada pengguna, bukan keduanya.	Teks bebas Ukuran teks yang direkomendasikan: 180 karakter
Daftar subtitel	Opsional	Hingga 3 subjudul, dengan setiap subjudul berupa satu baris teks. Catatan: Deskripsi atau daftar subjudul akan ditampilkan kepada pengguna, bukan keduanya.	Teks bebas Ukuran teks yang direkomendasikan untuk setiap subjudul: maks. 50 karakter
Rating - Nilai maks	Opsional	Nilai skala rating maksimum. Harus diberikan jika nilai rating saat ini juga disediakan.	Angka >= 0,0
Rating - Nilai saat ini	Opsional	Nilai skala rating saat ini. Harus diberikan jika nilai rating maksimum juga disediakan.	Angka >= 0,0
Rating - Jumlah	Opsional	Jumlah rating untuk lokasi menarik. Catatan: Berikan kolom ini jika aplikasi Anda ingin mengontrol cara ini ditampilkan kepada pengguna. Berikan string singkat yang dapat ditampilkan kepada pengguna. Misalnya, jika jumlahnya 1.000.000, pertimbangkan untuk menggunakan singkatan seperti 1M, sehingga tidak terpotong pada ukuran layar yang lebih kecil.	String
Rating - Nilai Jumlah	Opsional	Jumlah rating untuk lokasi menarik. Catatan: Berikan kolom ini jika Anda tidak ingin menangani sendiri logika singkatan tampilan. Jika Jumlah dan Nilai Jumlah ada, kami akan menggunakan Jumlah untuk ditampilkan kepada pengguna	Panjang
Harga - CurrentPrice	Wajib bersyarat	Harga tiket/kartu masuk saat ini untuk lokasi menarik. Harus diberikan jika harga yang dicoret disediakan.	Teks bebas
Harga - StrikethroughPrice	Opsional	Harga asli tiket/kartu masuk untuk tempat menarik.	Teks bebas
Info Harga	Opsional	Keterangan harga untuk menampilkan promo, acara, diskon anggota, jika tersedia.	Teks bebas Ukuran teks yang direkomendasikan: di bawah 45 karakter (Teks yang terlalu panjang dapat menampilkan elipsis)
Kategori Konten	Opsional	Mendeskripsikan kategori konten dalam entitas.	Daftar Enum yang Memenuhi Syarat TYPE_TRAVEL_AND_LOCAL TYPE_MOVIES_AND_TV_SHOWS (Contoh - bioskop) TYPE_MEDICAL (Contoh - rumah sakit) TYPE_EDUCATION (Contoh - sekolah) TYPE_SPORTS (Contoh - stadion) Lihat bagian Kategori Konten untuk mendapatkan panduan.
DisplayTimeWindow (Opsional) - Menetapkan periode waktu untuk konten yang akan ditampilkan di platform
Stempel Waktu Awal	Opsional	Stempel waktu epoch yang setelahnya konten akan ditampilkan di platform. Jika tidak disetel, konten akan memenuhi syarat untuk ditampilkan di platform.	Stempel waktu epoch dalam milidetik
Stempel Waktu Akhir	Opsional	Stempel waktu epoch yang setelahnya konten tidak lagi ditampilkan di platform. Jika tidak disetel, konten akan memenuhi syarat untuk ditampilkan di platform.	Stempel waktu epoch dalam milidetik

`RestaurantReservationEntity`

Atribut	Persyaratan	Deskripsi	Format
URI Tindakan	Wajib	Deep Link ke entity dalam aplikasi penyedia. Catatan: Anda dapat menggunakan deep link untuk atribusi. Lihat FAQ ini	URI
Judul	Wajib	Judul entitas.	String Ukuran teks yang direkomendasikan: Maks. 50 karakter
Waktu Mulai Reservasi yang Dilokalkan - Stempel Waktu	Wajib	Stempel waktu epoch saat reservasi diperkirakan akan dimulai.	Joda-Time Instant
Waktu Mulai Pemesanan yang Dilokalkan - Zona Waktu	Wajib	Zona waktu saat pemesanan diperkirakan akan dimulai.	DateTimeZone Joda-Time Lihat Spesifikasi Zona Waktu untuk panduan.
Lokasi - Negara	Wajib	Negara tempat restoran berada.	Teks bebas Ukuran teks yang direkomendasikan: maks. ~20 karakter
Lokasi - Kota	Wajib	Kota tempat restoran berada.	Teks bebas Ukuran teks yang direkomendasikan: maks. ~20 karakter
Lokasi - Tampilkan Alamat	Wajib	Alamat restoran yang akan ditampilkan kepada pengguna.	Teks bebas Ukuran teks yang direkomendasikan: maks. ~20 karakter
Lokasi - Alamat	Opsional	Alamat jalan (jika ada) restoran.	Teks bebas Ukuran teks yang direkomendasikan: maks. ~20 karakter
Lokasi - Negara bagian	Opsional	Negara bagian atau provinsi (jika berlaku) tempat restoran berada.	Teks bebas Ukuran teks yang direkomendasikan: maks. ~20 karakter
Lokasi - Kode pos	Opsional	Kode pos restoran (jika ada).	Teks bebas Ukuran teks yang direkomendasikan: maks. ~20 karakter
Lokasi - Lingkungan	Opsional	Kawasan (jika ada) tempat restoran berada.	Teks bebas Ukuran teks yang direkomendasikan: maks. ~20 karakter
Gambar poster	Opsional	Kami hanya akan menampilkan 1 gambar jika beberapa gambar disediakan. Rasio aspek yang direkomendasikan adalah 16:9	Lihat Spesifikasi Gambar untuk panduan.
Deskripsi	Opsional	Satu paragraf teks untuk mendeskripsikan entity. Catatan: Deskripsi atau daftar subjudul akan ditampilkan kepada pengguna, bukan keduanya.	Teks bebas Ukuran teks yang direkomendasikan: 180 karakter
Daftar subtitel	Opsional	Hingga 3 subjudul, dengan setiap subjudul berupa satu baris teks. Catatan: Deskripsi atau daftar subjudul akan ditampilkan kepada pengguna, bukan keduanya.	Teks bebas Ukuran teks yang direkomendasikan untuk setiap subjudul: maks. 50 karakter
Ukuran Tabel	Opsional	Jumlah orang dalam grup reservasi	Bilangan bulat > 0
DisplayTimeWindow (Opsional) - Menetapkan periode waktu untuk konten yang akan ditampilkan di platform
Stempel Waktu Awal	Opsional	Stempel waktu epoch yang setelahnya konten akan ditampilkan di platform. Jika tidak disetel, konten akan memenuhi syarat untuk ditampilkan di platform.	Stempel waktu epoch dalam milidetik
Stempel Waktu Akhir	Opsional	Stempel waktu epoch yang setelahnya konten tidak lagi ditampilkan di platform. Jika tidak disetel, konten akan memenuhi syarat untuk ditampilkan di platform.	Stempel waktu epoch dalam milidetik

`EventReservationEntity`

Atribut	Persyaratan	Deskripsi	Format
URI Tindakan	Wajib	Deep Link ke entity dalam aplikasi penyedia. Catatan: Anda dapat menggunakan deep link untuk atribusi. Lihat FAQ ini	URI
Judul	Wajib	Judul entitas.	String Ukuran teks yang direkomendasikan: Maks. 50 karakter
Waktu Mulai yang Dilokalkan - Stempel Waktu	Wajib	Stempel waktu epoch saat acara diperkirakan akan dimulai.	Joda-Time Instant
Waktu Mulai yang dilokalkan - Zona waktu	Wajib	Zona waktu tempat acara diperkirakan akan dimulai.	DateTimeZone Joda-Time Lihat Spesifikasi Zona Waktu untuk panduan.
Mode acara	Wajib	Kolom untuk menunjukkan apakah acara akan diadakan secara virtual, tatap muka, atau keduanya.	Enum: VIRTUAL, IN_PERSON, atau HYBRID
Lokasi - Negara	Wajib bersyarat	Negara tempat acara berlangsung. Catatan: Ini diperlukan untuk acara yang bersifat TATAP MUKA atau HYBRID	Teks bebas Ukuran teks yang direkomendasikan: maks. ~20 karakter
Lokasi - Kota	Wajib bersyarat	Kota tempat acara berlangsung. Catatan: Ini diperlukan untuk acara yang bersifat TATAP MUKA atau HYBRID	Teks bebas Ukuran teks yang direkomendasikan: maks. ~20 karakter
Lokasi - Tampilkan Alamat	Wajib bersyarat	Alamat atau nama tempat acara akan berlangsung yang harus ditampilkan kepada pengguna. Catatan: Ini diperlukan untuk acara yang bersifat TATAP MUKA atau HYBRID	Teks bebas Ukuran teks yang direkomendasikan: maks. ~20 karakter
Lokasi - Alamat	Opsional	Alamat jalan (jika ada) lokasi tempat acara diselenggarakan.	Teks bebas Ukuran teks yang direkomendasikan: maks. ~20 karakter
Lokasi - Negara bagian	Opsional	Negara bagian atau provinsi (jika berlaku) tempat acara diselenggarakan.	Teks bebas Ukuran teks yang direkomendasikan: maks. ~20 karakter
Lokasi - Kode pos	Opsional	Kode pos (jika ada) lokasi tempat acara diselenggarakan.	Teks bebas Ukuran teks yang direkomendasikan: maks. ~20 karakter
Lokasi - Lingkungan	Opsional	Lingkungan (jika ada) tempat acara diselenggarakan.	Teks bebas Ukuran teks yang direkomendasikan: maks. ~20 karakter
Gambar poster	Opsional	Kami hanya akan menampilkan 1 gambar jika beberapa gambar disediakan. Rasio aspek yang direkomendasikan adalah 16:9 Catatan: Sebaiknya gunakan gambar. Jika badge disediakan, pastikan ruang aman 24 dps di bagian atas dan bawah gambar	Lihat Spesifikasi Gambar untuk panduan.
Waktu berakhir yang dilokalkan - Stempel waktu	Opsional	Stempel waktu epoch saat acara diperkirakan berakhir.	Joda-Time Instant
Waktu berakhir yang dilokalkan - Zona waktu	Opsional	Zona waktu saat acara diperkirakan akan berakhir.	DateTimeZone Joda-Time Lihat Spesifikasi Zona Waktu untuk panduan.
Penyedia Layanan - Nama	Opsional	Nama penyedia layanan. Catatan:Teks atau gambar diperlukan untuk penyedia layanan.	Teks bebas. Misalnya, nama penyelenggara acara/tur
Penyedia Layanan - Gambar	Opsional	Logo/gambar penyedia layanan. Catatan:Teks atau gambar diperlukan untuk penyedia layanan.	Lihat Spesifikasi Gambar untuk panduan.
Deskripsi	Opsional	Satu paragraf teks untuk mendeskripsikan entity. Catatan: Deskripsi atau daftar subjudul akan ditampilkan kepada pengguna, bukan keduanya.	Teks bebas Ukuran teks yang direkomendasikan: 180 karakter
Daftar subtitel	Opsional	Hingga 3 subjudul, dengan setiap subjudul berupa satu baris teks. Catatan: Deskripsi atau daftar subjudul akan ditampilkan kepada pengguna, bukan keduanya.	Teks bebas Ukuran teks yang direkomendasikan untuk setiap subjudul: maks. 50 karakter
Badge	Opsional	Setiap badge berupa teks bebas (maks. 15 karakter) atau gambar kecil.
Badge - Teks	Opsional	Judul untuk badge Catatan: Teks atau gambar diperlukan untuk badge	Teks bebas Ukuran teks yang direkomendasikan: maks. 15 karakter
Badge - Gambar	Opsional	Gambar kecil Perlakuan UX khusus, misalnya sebagai overlay badge pada thumbnail gambar/video. Catatan: Teks atau gambar diperlukan untuk badge	Lihat Spesifikasi Gambar untuk panduan.
ID Reservasi	Opsional	ID pemesanan untuk pemesanan acara.	Teks bebas
Harga - CurrentPrice	Wajib bersyarat	Harga tiket/kartu masuk acara saat ini. Harus diberikan jika harga yang dicoret disediakan.	Teks bebas
Harga - StrikethroughPrice	Opsional	Harga asli tiket/kartu masuk untuk acara.	Teks bebas
Info Harga	Opsional	Keterangan harga untuk menampilkan promo, acara, diskon anggota, jika tersedia.	Teks bebas Ukuran teks yang direkomendasikan: di bawah 45 karakter (Teks yang terlalu panjang dapat menampilkan elipsis)
Rating - Nilai maks	Opsional	Nilai skala rating maksimum. Harus diberikan jika nilai rating saat ini juga disediakan.	Angka >= 0,0
Rating - Nilai saat ini	Opsional	Nilai skala rating saat ini. Harus diberikan jika nilai rating maksimum juga disediakan.	Angka >= 0,0
Rating - Jumlah	Opsional	Jumlah rating untuk acara. Catatan: Berikan kolom ini jika aplikasi Anda ingin mengontrol cara ini ditampilkan kepada pengguna. Berikan string singkat yang dapat ditampilkan kepada pengguna. Misalnya, jika jumlahnya 1.000.000, pertimbangkan untuk menggunakan singkatan seperti 1M, sehingga tidak terpotong pada ukuran layar yang lebih kecil.	String
Rating - Nilai Jumlah	Opsional	Jumlah rating untuk acara. Catatan: Berikan kolom ini jika Anda tidak ingin menangani sendiri logika singkatan tampilan. Jika Jumlah dan Nilai Jumlah ada, kami akan menggunakan Jumlah untuk ditampilkan kepada pengguna	Panjang
Kategori Konten	Opsional	Mendeskripsikan kategori konten dalam entitas.	Daftar Enum yang Memenuhi Syarat TYPE_MOVIES_AND_TV_SHOWS (Contoh - Bioskop) TYPE_DIGITAL_GAMES (Contoh - eSports) TYPE_MUSIC (Contoh - Konser) TYPE_TRAVEL_AND_LOCAL (Contoh - Tur, festival) TYPE_HEALTH_AND_FITNESS (Contoh - Kelas yoga) TYPE_EDUCATION (Contoh - Kelas) TYPE_SPORTS (Contoh - Pertandingan sepak bola) TYPE_DATING (Contoh - pertemuan) Lihat bagian Kategori Konten untuk mendapatkan panduan.
DisplayTimeWindow (Opsional) - Menetapkan periode waktu untuk konten yang akan ditampilkan di platform
Stempel Waktu Awal	Opsional	Stempel waktu epoch yang setelahnya konten akan ditampilkan di platform. Jika tidak disetel, konten akan memenuhi syarat untuk ditampilkan di platform.	Stempel waktu epoch dalam milidetik
Stempel Waktu Akhir	Opsional	Stempel waktu epoch yang setelahnya konten tidak lagi ditampilkan di platform. Jika tidak disetel, konten akan memenuhi syarat untuk ditampilkan di platform.	Stempel waktu epoch dalam milidetik

`LodgingReservationEntity`

Atribut	Persyaratan	Deskripsi	Format
URI Tindakan	Wajib	Deep Link ke entity dalam aplikasi penyedia. Catatan: Anda dapat menggunakan deep link untuk atribusi. Lihat FAQ ini	URI
Judul	Wajib	Judul entitas.	Teks bebas. Misalnya, "Masa Menginap Anda mulai 12 Desember" Ukuran teks yang direkomendasikan: Maks. 50 karakter
Waktu Check-in yang Dilokalkan - Stempel Waktu	Wajib	Stempel waktu epoch yang menunjukkan waktu check-in untuk reservasi.	Joda-Time Instant
Waktu Check-in yang Dilokalkan - Zona Waktu	Wajib	Zona waktu tempat waktu check in untuk reservasi berada.	DateTimeZone Joda-Time Lihat Spesifikasi Zona Waktu untuk panduan.
Waktu Check-out yang Dilokalkan - Stempel Waktu	Wajib	Stempel waktu epoch yang menunjukkan waktu check out untuk reservasi.	Joda-Time Instant
Waktu Check-out yang Dilokalkan - Zona Waktu	Wajib	Zona waktu saat waktu check out berlaku untuk reservasi.	DateTimeZone Joda-Time Lihat Spesifikasi Zona Waktu untuk panduan.
Lokasi - Negara	Wajib	Negara tempat akomodasi berada.	Teks bebas Ukuran teks yang direkomendasikan: maks. ~20 karakter
Lokasi - Kota	Wajib	Kota tempat akomodasi berada.	Teks bebas Ukuran teks yang direkomendasikan: maks. ~20 karakter
Lokasi - Tampilkan Alamat	Wajib	Alamat yang akan ditampilkan kepada pengguna. Berikan alamat yang ringkas, menggunakan singkatan jika memungkinkan (misalnya, "Jln" untuk "Jalan", "Gg" untuk "Gang"). String ini dapat dipangkas bergantung pada perangkat dan setelan pengguna. Sertakan nama kota untuk identifikasi yang jelas.	Teks bebas Ukuran teks yang direkomendasikan: maks. ~35 karakter
Lokasi - Alamat	Opsional	Alamat jalan (jika ada) penginapan.	Teks bebas Ukuran teks yang direkomendasikan: maks. ~20 karakter
Lokasi - Negara bagian	Opsional	Negara bagian atau provinsi (jika berlaku) tempat akomodasi berada.	Teks bebas Ukuran teks yang direkomendasikan: maks. ~20 karakter
Lokasi - Kode pos	Opsional	Kode pos (jika ada) akomodasi.	Teks bebas Ukuran teks yang direkomendasikan: maks. ~20 karakter
Lokasi - Lingkungan	Opsional	Lingkungan (jika ada) penginapan.	Teks bebas Ukuran teks yang direkomendasikan: maks. ~20 karakter
Gambar poster	Opsional	Kami hanya akan menampilkan 1 gambar jika beberapa gambar disediakan. Rasio aspek yang direkomendasikan adalah 16:9 Catatan: Jika badge disediakan, pastikan ruang aman 24 dp di bagian atas dan bawah gambar	Lihat Spesifikasi Gambar untuk panduan.
Deskripsi	Opsional	Satu paragraf teks untuk mendeskripsikan entity. Catatan: Deskripsi atau daftar subjudul akan ditampilkan kepada pengguna, bukan keduanya.	Teks bebas Ukuran teks yang direkomendasikan: 180 karakter
Daftar subtitel	Opsional	Hingga 3 subjudul, dengan setiap subjudul berupa satu baris teks. Catatan: Deskripsi atau daftar subjudul akan ditampilkan kepada pengguna, bukan keduanya.	Teks bebas Ukuran teks yang direkomendasikan untuk setiap subjudul: maks. 50 karakter
ID Reservasi	Opsional	ID pemesanan untuk pemesanan akomodasi.	Teks bebas
Rating - Nilai maks	Opsional	Nilai skala rating maksimum. Harus diberikan jika nilai rating saat ini juga disediakan.	Angka >= 0,0
Rating - Nilai saat ini	Opsional	Nilai skala rating saat ini. Harus diberikan jika nilai rating maksimum juga disediakan.	Angka >= 0,0
Rating - Jumlah	Opsional	Jumlah rating untuk penginapan. Catatan: Berikan kolom ini jika aplikasi Anda ingin mengontrol cara ini ditampilkan kepada pengguna. Berikan string singkat yang dapat ditampilkan kepada pengguna. Misalnya, jika jumlahnya 1.000.000, pertimbangkan untuk menggunakan singkatan seperti 1M, sehingga tidak terpotong pada ukuran layar yang lebih kecil.	String
Rating - Nilai Jumlah	Opsional	Jumlah rating untuk penginapan. Catatan: Berikan kolom ini jika Anda tidak ingin menangani sendiri logika singkatan tampilan. Jika Jumlah dan Nilai Jumlah ada, kami akan menggunakan Jumlah untuk ditampilkan kepada pengguna	Panjang
Harga - CurrentPrice	Wajib bersyarat	Harga akomodasi saat ini. Harus diberikan jika harga yang dicoret disediakan.	Teks bebas
Harga - StrikethroughPrice	Opsional	Harga asli akomodasi, yang dicoret di UI.	Teks bebas
Info Harga	Opsional	Keterangan harga untuk menampilkan promo, acara, diskon anggota, jika tersedia.	Teks bebas Ukuran teks yang direkomendasikan: di bawah 45 karakter (Teks yang terlalu panjang dapat menampilkan elipsis)
DisplayTimeWindow (Opsional) - Menetapkan periode waktu untuk konten yang akan ditampilkan di platform
Stempel Waktu Awal	Opsional	Stempel waktu epoch yang setelahnya konten akan ditampilkan di platform. Jika tidak disetel, konten akan memenuhi syarat untuk ditampilkan di platform.	Stempel waktu epoch dalam milidetik
Stempel Waktu Akhir	Opsional	Stempel waktu epoch yang setelahnya konten tidak lagi ditampilkan di platform. Jika tidak disetel, konten akan memenuhi syarat untuk ditampilkan di platform.	Stempel waktu epoch dalam milidetik

`TransportationReservationEntity`

Atribut	Persyaratan	Deskripsi	Format
URI Tindakan	Wajib	Deep Link ke entity dalam aplikasi penyedia. Catatan: Anda dapat menggunakan deep link untuk atribusi. Lihat FAQ ini	URI
Judul	Wajib	Judul entitas.	Teks bebas. Misalnya, "SFO ke SAN" Ukuran teks yang direkomendasikan: Maks. 50 karakter
Jenis Transportasi	Wajib	Mode/jenis transportasi untuk reservasi.	Enum: FLIGHT, TRAIN, BUS, atau FERRY
Waktu Keberangkatan yang Dilokalkan - Stempel Waktu	Wajib	Stempel waktu epoch yang menunjukkan waktu keberangkatan.	Joda-Time Instant
Waktu Keberangkatan yang Dilokalkan - Zona Waktu	Wajib	Zona waktu waktu keberangkatan.	DateTimeZone Joda-Time Lihat Spesifikasi Zona Waktu untuk panduan.
Waktu Kedatangan yang Dilokalkan - Stempel Waktu	Wajib	Stempel waktu epoch yang menunjukkan waktu kedatangan.	Joda-Time Instant
Waktu Kedatangan yang Dilokalkan - Zona Waktu	Wajib	Zona waktu waktu tiba.	DateTimeZone Joda-Time Lihat Spesifikasi Zona Waktu untuk panduan.
Nomor Transportasi	Wajib	Nomor penerbangan, nomor bus, nomor kereta, atau nomor feri/kapal pesiar.	Teks bebas
Waktu Boarding yang Dilokalkan - Stempel Waktu	Wajib	Stempel waktu epoch yang menunjukkan waktu naik pesawat untuk reservasi (jika ada)	Joda-Time Instant
Waktu Boarding yang Dilokalkan - Zona Waktu	Wajib	Zona waktu waktu naik pesawat untuk reservasi (jika berlaku)	DateTimeZone Joda-Time Lihat Spesifikasi Zona Waktu untuk panduan.
Lokasi Keberangkatan - Negara	Opsional	Negara keberangkatan.	Teks bebas Ukuran teks yang direkomendasikan: maks. ~20 karakter
Lokasi Keberangkatan - Kota	Opsional	Kota keberangkatan.	Teks bebas Ukuran teks yang direkomendasikan: maks. ~20 karakter
Lokasi Keberangkatan - Menampilkan Alamat	Opsional	Lokasi keberangkatan yang akan ditampilkan kepada pengguna.	Teks bebas Ukuran teks yang direkomendasikan: maks. ~20 karakter
Lokasi Keberangkatan - Alamat Jalan	Opsional	Alamat jalan (jika ada) lokasi keberangkatan.	Teks bebas Ukuran teks yang direkomendasikan: maks. ~20 karakter
Lokasi Keberangkatan - Negara Bagian	Opsional	Negara bagian atau provinsi (jika berlaku) lokasi keberangkatan.	Teks bebas Ukuran teks yang direkomendasikan: maks. ~20 karakter
Lokasi Keberangkatan - Kode pos	Opsional	Kode pos (jika ada) lokasi keberangkatan.	Teks bebas Ukuran teks yang direkomendasikan: maks. ~20 karakter
Lokasi Keberangkatan - Lingkungan	Opsional	Lingkungan (jika ada) lokasi keberangkatan.	Teks bebas Ukuran teks yang direkomendasikan: maks. ~20 karakter
Lokasi Kedatangan - Negara	Opsional	Negara tujuan.	Teks bebas Ukuran teks yang direkomendasikan: maks. ~20 karakter
Lokasi Kedatangan - Kota	Opsional	Kota kedatangan.	Teks bebas Ukuran teks yang direkomendasikan: maks. ~20 karakter
Lokasi Kedatangan - Menampilkan Alamat	Opsional	Lokasi kedatangan yang akan ditampilkan kepada pengguna.	Teks bebas Ukuran teks yang direkomendasikan: maks. ~20 karakter
Lokasi Kedatangan - Alamat Jalan	Opsional	Alamat jalan (jika ada) lokasi kedatangan.	Teks bebas Ukuran teks yang direkomendasikan: maks. ~20 karakter
Lokasi Kedatangan - Negara Bagian	Opsional	Negara bagian atau provinsi (jika berlaku) lokasi kedatangan.	Teks bebas Ukuran teks yang direkomendasikan: maks. ~20 karakter
Lokasi Kedatangan - Kode pos	Opsional	Kode pos (jika ada) lokasi kedatangan.	Teks bebas Ukuran teks yang direkomendasikan: maks. ~20 karakter
Lokasi Kedatangan - Lingkungan	Opsional	Lingkungan (jika ada) lokasi kedatangan.	Teks bebas Ukuran teks yang direkomendasikan: maks. ~20 karakter
Penyedia Layanan - Nama	Opsional	Nama penyedia layanan. Catatan:Teks atau gambar diperlukan untuk penyedia layanan.	Teks bebas. Misalnya, Nama maskapai penerbangan
Penyedia Layanan - Gambar	Opsional	Logo/gambar penyedia layanan. Catatan:Teks atau gambar diperlukan untuk penyedia layanan.	Lihat Spesifikasi Gambar untuk panduan.
Gambar poster	Opsional	Kami hanya akan menampilkan 1 gambar jika beberapa gambar disediakan. Rasio aspek yang direkomendasikan adalah 16:9	Lihat Spesifikasi Gambar untuk panduan.
Deskripsi	Opsional	Satu paragraf teks untuk mendeskripsikan entity. Catatan: Deskripsi atau daftar subjudul akan ditampilkan kepada pengguna, bukan keduanya.	Teks bebas Ukuran teks yang direkomendasikan: 180 karakter
Daftar subtitel	Opsional	Hingga 3 subjudul, dengan setiap subjudul berupa satu baris teks. Catatan: Deskripsi atau daftar subjudul akan ditampilkan kepada pengguna, bukan keduanya.	Teks bebas Ukuran teks yang direkomendasikan untuk setiap subjudul: maks. 50 karakter
ID Reservasi	Opsional	ID reservasi untuk reservasi transportasi.	Teks bebas
Harga - CurrentPrice	Wajib bersyarat	Harga reservasi saat ini. Harus diberikan jika harga yang dicoret disediakan.	Teks bebas
Harga - StrikethroughPrice	Opsional	Harga asli reservasi, yang dicoret di UI.	Teks bebas
Info Harga	Opsional	Keterangan harga untuk menampilkan promo, acara, diskon anggota, jika tersedia.	Teks bebas Ukuran teks yang direkomendasikan: di bawah 45 karakter (Teks yang terlalu panjang dapat menampilkan elipsis)
DisplayTimeWindow (Opsional) - Menetapkan periode waktu untuk konten yang akan ditampilkan di platform
Stempel Waktu Awal	Opsional	Stempel waktu epoch yang setelahnya konten akan ditampilkan di platform. Jika tidak disetel, konten akan memenuhi syarat untuk ditampilkan di platform.	Stempel waktu epoch dalam milidetik
Stempel Waktu Akhir	Opsional	Stempel waktu epoch yang setelahnya konten tidak lagi ditampilkan di platform. Jika tidak disetel, konten akan memenuhi syarat untuk ditampilkan di platform.	Stempel waktu epoch dalam milidetik

`VehicleRentalReservationEntity`

Atribut	Persyaratan	Deskripsi	Format
URI Tindakan	Wajib	Deep Link ke entity dalam aplikasi penyedia. Catatan: Anda dapat menggunakan deep link untuk atribusi. Lihat FAQ ini	URI
Judul	Wajib	Judul entitas.	Teks bebas. Misalnya, "Avis Union Square SF" Ukuran teks yang direkomendasikan: Maks. 50 karakter
Waktu Pengambilan yang Dilokalkan - Stempel Waktu	Wajib	Stempel waktu epoch yang menunjukkan waktu pengambilan untuk reservasi.	Joda-Time Instant
Waktu Pengambilan yang Dilokalkan - Zona Waktu	Wajib	Zona waktu waktu pengambilan untuk reservasi.	DateTimeZone Joda-Time Lihat Spesifikasi Zona Waktu untuk panduan.
Waktu Kembali yang Dilokalkan - Stempel Waktu	Opsional	Stempel waktu epoch yang menunjukkan waktu check out untuk reservasi.	Joda-Time Instant
Waktu Kembali yang Dilokalkan - Zona Waktu	Opsional	Zona waktu waktu check out untuk reservasi.	DateTimeZone Joda-Time Lihat Spesifikasi Zona Waktu untuk panduan.
Alamat Pengambilan - Negara	Opsional	Negara lokasi pengambilan.	Teks bebas Ukuran teks yang direkomendasikan: maks. ~20 karakter
Alamat Pengambilan - Kota	Opsional	Kota lokasi pengambilan.	Teks bebas Ukuran teks yang direkomendasikan: maks. ~20 karakter
Alamat Pengambilan - Alamat yang Ditampilkan	Opsional	Lokasi pengambilan yang akan ditampilkan kepada pengguna.	Teks bebas Ukuran teks yang direkomendasikan: maks. ~20 karakter
Alamat Pengambilan - Alamat	Opsional	Alamat jalan (jika ada) lokasi pengambilan.	Teks bebas Ukuran teks yang direkomendasikan: maks. ~20 karakter
Alamat Pengambilan - Negara Bagian	Opsional	Negara bagian atau provinsi (jika berlaku) lokasi pengambilan.	Teks bebas Ukuran teks yang direkomendasikan: maks. ~20 karakter
Alamat Pengambilan - Kode pos	Opsional	Kode pos (jika ada) lokasi pengambilan.	Teks bebas Ukuran teks yang direkomendasikan: maks. ~20 karakter
Alamat Pengambilan - Lingkungan	Opsional	Kawasan (jika ada) lokasi pengambilan.	Teks bebas Ukuran teks yang direkomendasikan: maks. ~20 karakter
Alamat Pengembalian - Negara	Opsional	Negara lokasi pengembalian.	Teks bebas Ukuran teks yang direkomendasikan: maks. ~20 karakter
Alamat Pengembalian - Kota	Opsional	Kota lokasi pengembalian.	Teks bebas Ukuran teks yang direkomendasikan: maks. ~20 karakter
Alamat Pengembalian - Alamat yang Ditampilkan	Opsional	Lokasi pengembalian yang akan ditampilkan kepada pengguna.	Teks bebas Ukuran teks yang direkomendasikan: maks. ~20 karakter
Alamat Pengembalian - Alamat Jalan	Opsional	Alamat jalan (jika ada) dari lokasi pengembalian.	Teks bebas Ukuran teks yang direkomendasikan: maks. ~20 karakter
Alamat Pengembalian - Negara Bagian	Opsional	Negara bagian atau provinsi (jika berlaku) lokasi pengembalian.	Teks bebas Ukuran teks yang direkomendasikan: maks. ~20 karakter
Alamat Pengembalian - Kode pos	Opsional	Kode pos (jika ada) lokasi pengembalian.	Teks bebas Ukuran teks yang direkomendasikan: maks. ~20 karakter
Alamat Pengembalian - Lingkungan	Opsional	Lingkungan (jika ada) lokasi pengembalian.	Teks bebas Ukuran teks yang direkomendasikan: maks. ~20 karakter
Penyedia Layanan - Nama	Opsional	Nama penyedia layanan. Catatan:Teks atau gambar diperlukan untuk penyedia layanan.	Teks bebas. Misalnya, "Avis Car Rental"
Penyedia Layanan - Gambar	Opsional	Logo/gambar penyedia layanan. Catatan:Teks atau gambar diperlukan untuk penyedia layanan.	Lihat Spesifikasi Gambar untuk panduan.
Gambar poster	Opsional	Kami hanya akan menampilkan 1 gambar jika beberapa gambar disediakan. Rasio aspek yang direkomendasikan adalah 16:9	Lihat Spesifikasi Gambar untuk panduan.
Deskripsi	Opsional	Satu paragraf teks untuk mendeskripsikan entity. Catatan: Deskripsi atau daftar subjudul akan ditampilkan kepada pengguna, bukan keduanya.	Teks bebas Ukuran teks yang direkomendasikan: 180 karakter
Daftar subtitel	Opsional	Hingga 3 subjudul, dengan setiap subjudul berupa satu baris teks. Catatan: Deskripsi atau daftar subjudul akan ditampilkan kepada pengguna, bukan keduanya.	Teks bebas Ukuran teks yang direkomendasikan untuk setiap subjudul: maks. 50 karakter
ID Konfirmasi	Opsional	ID konfirmasi untuk reservasi sewa kendaraan.	Teks bebas
Harga - CurrentPrice	Wajib bersyarat	Harga reservasi saat ini. Harus diberikan jika harga yang dicoret disediakan.	Teks bebas
Harga - StrikethroughPrice	Opsional	Harga asli reservasi, yang dicoret di UI.	Teks bebas
Info Harga	Opsional	Keterangan harga untuk menampilkan promo, acara, diskon anggota, jika tersedia.	Teks bebas Ukuran teks yang direkomendasikan: di bawah 45 karakter (Teks yang terlalu panjang dapat menampilkan elipsis)
DisplayTimeWindow (Opsional) - Menetapkan periode waktu untuk konten yang akan ditampilkan di platform
Stempel Waktu Awal	Opsional	Stempel waktu epoch yang setelahnya konten akan ditampilkan di platform. Jika tidak disetel, konten akan memenuhi syarat untuk ditampilkan di platform.	Stempel waktu epoch dalam milidetik
Stempel Waktu Akhir	Opsional	Stempel waktu epoch yang setelahnya konten tidak lagi ditampilkan di platform. Jika tidak disetel, konten akan memenuhi syarat untuk ditampilkan di platform.	Stempel waktu epoch dalam milidetik

Spesifikasi gambar

Spesifikasi yang diperlukan untuk aset gambar tercantum dalam tabel ini:

Rasio aspek	Piksel minimum	Piksel yang direkomendasikan
Persegi (1x1) Pilihan	300x300	1200x1200
Lanskap (1,91x1)	600x314	1200x628
Potret (4x5)	480x600	960x1200

Rasio aspek

Piksel minimum

Piksel yang direkomendasikan

Persegi (1x1)

Pilihan

300x300

1200x1200

Lanskap (1,91x1)

600x314

1200x628

Potret (4x5)

480x600

960x1200

Gambar harus dihosting di CDN publik agar Google dapat mengaksesnya.

Format file

PNG, JPG, GIF statis, WebP

Ukuran file maksimum

5120 KB

Rekomendasi tambahan

Area aman gambar: Tempatkan konten penting Anda di 80% bagian tengah gambar.
Gunakan latar belakang transparan agar gambar dapat ditampilkan dengan benar di setelan tema Gelap dan Terang.

Spesifikasi zona waktu

Lebih memilih ID (misalnya, "America/Los_Angeles") daripada selisih (misalnya, "-07:00").

Contoh penggunaan: DateTimeZone.forID("America/Los_Angeles")

Kategori Konten

Kategori konten memungkinkan aplikasi memublikasikan konten yang termasuk dalam beberapa kategori. Hal ini memetakan konten dengan beberapa kategori yang telah ditentukan sebelumnya, yaitu:

TYPE_EDUCATION
TYPE_SPORTS
TYPE_MOVIES_AND_TV_SHOWS
TYPE_BOOKS
TYPE_AUDIOBOOKS
TYPE_MUSIC
TYPE_DIGITAL_GAMES
TYPE_TRAVEL_AND_LOCAL
TYPE_HOME_AND_AUTO
TYPE_BUSINESS
TYPE_NEWS
TYPE_FOOD_AND_DRINK
TYPE_SHOPPING
TYPE_HEALTH_AND_FITENESS
TYPE_MEDICAL
TYPE_PARENTING
TYPE_DATING

Gambar harus dihosting di CDN publik agar Google dapat mengaksesnya.

Pedoman untuk menggunakan kategori konten

Beberapa entitas seperti ArticleEntity dan GenericFeaturedEntity memenuhi syarat untuk menggunakan kategori konten apa pun. Untuk entitas lain seperti EventEntity, EventReservationEntity, PointOfInterestEntity, hanya sebagian kecil kategori ini yang memenuhi syarat. Periksa daftar kategori yang memenuhi syarat untuk jenis entity sebelum mengisi daftar.
Gunakan jenis entity tertentu untuk beberapa kategori konten melalui kombinasi entity Umum dan ContentCategory:
- TYPE_MOVIES_AND_TV_SHOWS - Lihat entitas dari Panduan integrasi Watch sebelum menggunakan entitas generik.
- TYPE_BOOKS - Periksa EbookEntity sebelum menggunakan entitas generik.
- TYPE_AUDIOBOOKS - Periksa AudiobookEntity sebelum menggunakan entitas generik.
- TYPE_SHOPPING - Periksa ShoppingEntity sebelum menggunakan entitas generik.
- TYPE_FOOD_AND_DRINK - Lihat entitas dari Panduan Integrasi Makanan sebelum menggunakan entitas generik.
Kolom ContentCategory bersifat opsional dan harus dibiarkan kosong jika konten tidak termasuk dalam kategori yang disebutkan sebelumnya.
Jika beberapa kategori konten diberikan, berikan kategori tersebut dalam urutan relevansi dengan konten, dengan kategori konten yang paling relevan ditempatkan di urutan pertama dalam daftar.

Langkah 2: Menyediakan data Cluster

Sebaiknya jalankan tugas publikasi konten di latar belakang (misalnya, menggunakan WorkManager) dan dijadwalkan secara berkala atau berbasis peristiwa (misalnya, setiap kali pengguna membuka aplikasi atau saat pengguna menambahkan sesuatu ke keranjangnya).

AppEngageTravelClient bertanggung jawab untuk memublikasikan cluster.

Ada API berikut untuk memublikasikan cluster di klien:

isServiceAvailable
publishRecommendationClusters
publishFeaturedCluster
publishReservationCluster
publishContinueSearchCluster
publishUserAccountManagementRequest
updatePublishStatus
deleteRecommendationsClusters
deleteFeaturedCluster
deleteReservationCluster
deleteContinueSearchCluster
deleteUserManagementCluster
deleteClusters

`isServiceAvailable`

API ini digunakan untuk memeriksa apakah layanan tersedia untuk integrasi, dan apakah konten dapat ditampilkan di perangkat atau tidak.

Kotlin

client.isServiceAvailable.addOnCompleteListener { task ->
    if (task.isSuccessful) {
        // Handle IPC call success
        if(task.result) {
          // Service is available on the device, proceed with content publish
          // calls.
        } else {
          // Service is not available, no further action is needed.
        }
    } else {
      // The IPC call itself fails, proceed with error handling logic here,
      // such as retry.
    }
}

Java

client.isServiceAvailable().addOnCompleteListener(task - > {
    if (task.isSuccessful()) {
        // Handle success
        if(task.getResult()) {
          // Service is available on the device, proceed with content publish
          // calls.
        } else {
          // Service is not available, no further action is needed.
        }
    } else {
      // The IPC call itself fails, proceed with error handling logic here,
      // such as retry.
    }
});

`publishRecommendationClusters`

API ini digunakan untuk memublikasikan daftar objek RecommendationCluster.

Kotlin

client.publishRecommendationClusters(
      PublishRecommendationClustersRequest.Builder()
        .addRecommendationCluster(
          RecommendationCluster.Builder()
            .addEntity(entity1)
            .addEntity(entity2)
            .setTitle("Top Picks For You")
            .build()
        )
        .build()
    )

Java

client.publishRecommendationClusters(
            new PublishRecommendationClustersRequest.Builder()
                .addRecommendationCluster(
                    new RecommendationCluster.Builder()
                        .addEntity(entity1)
                        .addEntity(entity2)
                        .setTitle("Top Picks For You")
                        .build())
                .build());

Saat layanan menerima permintaan tersebut, tindakan berikut akan terjadi dalam satu transaksi:

Data RecommendationCluster yang ada dari partner developer akan dihapus.
Data dari permintaan akan diuraikan dan disimpan di Cluster Rekomendasi yang diperbarui.

Jika terjadi error, seluruh permintaan akan ditolak dan status yang ada dipertahankan.

`publishFeaturedCluster`

API ini digunakan untuk memublikasikan daftar objek FeaturedCluster.

Kotlin

client.publishFeaturedCluster(
    PublishFeaturedClusterRequest.Builder()
      .setFeaturedCluster(
        FeaturedCluster.Builder()
          .addEntity(entity1)
          .addEntity(entity2)
          .build())
      .build())

Java

client.publishFeaturedCluster(
            new PublishFeaturedClustersRequest.Builder()
                .addFeaturedCluster(
                    new FeaturedCluster.Builder()
                        .addEntity(entity1)
                        .addEntity(entity2)
                        .build())
                .build());

Saat layanan menerima permintaan tersebut, tindakan berikut akan terjadi dalam satu transaksi:

Data FeaturedCluster yang ada dari partner developer akan dihapus.
Data dari permintaan akan diuraikan dan disimpan di Cluster Unggulan yang diperbarui.

Jika terjadi error, seluruh permintaan akan ditolak dan status yang ada dipertahankan.

`publishReservationCluster`

API ini digunakan untuk memublikasikan objek ReservationCluster.

Kotlin

client.publishReservationCluster(
    PublishReservationClusterRequest.Builder()
      .setReservationCluster(
        ReservationCluster.Builder()
          .addLodgingReservationEntity(lodgingReservationEntity)
          .addVehicleRentalReservationEntity(vehicleRentalReservationEntity)
          .addTransportationReservationEntity(transportationReservationEntity)
          .addEventReservationEntity(eventReservationEntity)
          .addRestaurantReservationEntity(restaurantReservationEntity)
          .build())
      .build())

Java

client.publishReservationCluster(
            new PublishReservationClusterRequest.Builder()
                .setReservationCluster(
                    new ReservationCluster.Builder()
                        .addLodgingReservationEntity(lodgingReservationEntity)
                        .addVehicleRentalReservationEntity(vehicleRentalReservationEntity)
                        .addTransportationReservationEntity(transportationReservationEntity)
                        .addEventReservationEntity(eventReservationEntity)
                        .addRestaurantReservationEntity(restaurantReservationEntity)
                        .build())
                .build());

Saat layanan menerima permintaan tersebut, tindakan berikut akan terjadi dalam satu transaksi:

Data ReservationCluster yang ada dari partner developer akan dihapus.
Data dari permintaan akan diuraikan dan disimpan di Cluster Reservasi yang diperbarui.

Jika terjadi error, seluruh permintaan akan ditolak dan status yang ada dipertahankan.

`publishContinueSearchCluster`

API ini digunakan untuk memublikasikan daftar objek ContinueSearchCluster.

Kotlin

client.publishContinueSearchCluster(
    PublishContinueSearchClusterRequest.Builder()
      .setContinueSearchCluster(
        ContinueSearchCluster.Builder()
          .addPointOfInterestEntity(entity1)
          .addPointOfInterestEntity(entity2)
          .build())
      .build())

Java

client.publishContinueSearchCluster(
            new PublishContinueSearchClusterRequest.Builder()
                .setContinueSearchCluster(
                    new ContinueSearchCluster.Builder()
                        .addPointOfInterestEntity(entity1)
                        .addPointOfInterestEntity(entity2)
                        .build())
                .build());

Saat layanan menerima permintaan tersebut, tindakan berikut akan terjadi dalam satu transaksi:

Data ContinueSearchCluster yang ada dari partner developer akan dihapus.
Data dari permintaan akan diuraikan dan disimpan di Cluster Lanjutkan Penelusuran yang diperbarui.

Jika terjadi error, seluruh permintaan akan ditolak dan status yang ada dipertahankan.

`publishUserAccountManagementRequest`

API ini digunakan untuk memublikasikan kartu Login. Tindakan login mengarahkan pengguna ke halaman login aplikasi sehingga aplikasi dapat memublikasikan konten (atau memberikan konten yang lebih dipersonalisasi)

Metadata berikut adalah bagian dari Kartu Login -

Atribut	Persyaratan	Deskripsi
URI Tindakan	Wajib	Deeplink ke Tindakan (yaitu membuka halaman login aplikasi)
Gambar	Opsional - Jika tidak diberikan, Judul harus diberikan	Gambar Ditampilkan pada Kartu Gambar rasio aspek 16x9 dengan resolusi 1264x712
Judul	Opsional - Jika tidak diberikan, Gambar harus diberikan	Judul pada Kartu
Teks Tindakan	Opsional	Teks yang Ditampilkan pada CTA (yaitu Login)
Subjudul	Opsional	Subjudul Opsional pada Kartu

Kotlin

var SIGN_IN_CARD_ENTITY =
      SignInCardEntity.Builder()
          .addPosterImage(
              Image.Builder()
                  .setImageUri(Uri.parse("http://www.x.com/image.png"))
                  .setImageHeightInPixel(500)
                  .setImageWidthInPixel(500)
                  .build())
          .setActionText("Sign In")
          .setActionUri(Uri.parse("http://xx.com/signin"))
          .build()

client.publishUserAccountManagementRequest(
            PublishUserAccountManagementRequest.Builder()
                .setSignInCardEntity(SIGN_IN_CARD_ENTITY)
                .build());

Java

SignInCardEntity SIGN_IN_CARD_ENTITY =
      new SignInCardEntity.Builder()
          .addPosterImage(
              new Image.Builder()
                  .setImageUri(Uri.parse("http://www.x.com/image.png"))
                  .setImageHeightInPixel(500)
                  .setImageWidthInPixel(500)
                  .build())
          .setActionText("Sign In")
          .setActionUri(Uri.parse("http://xx.com/signin"))
          .build();

client.publishUserAccountManagementRequest(
            new PublishUserAccountManagementRequest.Builder()
                .setSignInCardEntity(SIGN_IN_CARD_ENTITY)
                .build());

Saat layanan menerima permintaan tersebut, tindakan berikut akan terjadi dalam satu transaksi:

Data UserAccountManagementCluster yang ada dari partner developer akan dihapus.
Data dari permintaan akan diuraikan dan disimpan di Cluster UserAccountManagementCluster yang diperbarui.

Jika terjadi error, seluruh permintaan akan ditolak dan status yang ada dipertahankan.

`updatePublishStatus`

Jika untuk alasan bisnis internal apa pun, tidak ada cluster yang dipublikasikan, sebaiknya perbarui status publikasi menggunakan API updatePublishStatus. Hal ini penting karena:

Memberikan status dalam semua skenario, bahkan saat konten dipublikasikan (STATUS == PUBLISHED), sangat penting untuk mengisi dasbor yang menggunakan status eksplisit ini untuk menyampaikan kondisi dan metrik integrasi Anda yang lain.
Jika tidak ada konten yang dipublikasikan, tetapi status integrasi tidak rusak (STATUS == NOT_PUBLISHED), Google dapat menghindari pemicuan pemberitahuan di dasbor kondisi aplikasi. Fitur ini mengonfirmasi bahwa konten tidak dipublikasikan karena situasi yang diharapkan dari sudut pandang penyedia.
Hal ini membantu developer memberikan analisis tentang kapan data dipublikasikan atau tidak.
Google dapat menggunakan kode status untuk mendorong pengguna melakukan tindakan tertentu dalam aplikasi sehingga mereka dapat melihat konten aplikasi atau mengatasinya.

Daftar kode status publikasi yang memenuhi syarat adalah:

// Content is published
AppEngagePublishStatusCode.PUBLISHED,

// Content is not published as user is not signed in
AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SIGN_IN,

// Content is not published as user is not subscribed
AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SUBSCRIPTION,

// Content is not published as user location is ineligible
AppEngagePublishStatusCode.NOT_PUBLISHED_INELIGIBLE_LOCATION,

// Content is not published as there is no eligible content
AppEngagePublishStatusCode.NOT_PUBLISHED_NO_ELIGIBLE_CONTENT,

// Content is not published as the feature is disabled by the client
// Available in v1.3.1
AppEngagePublishStatusCode.NOT_PUBLISHED_FEATURE_DISABLED_BY_CLIENT,

// Content is not published as the feature due to a client error
// Available in v1.3.1
AppEngagePublishStatusCode.NOT_PUBLISHED_CLIENT_ERROR,

// Content is not published as the feature due to a service error
// Available in v1.3.1
AppEngagePublishStatusCode.NOT_PUBLISHED_SERVICE_ERROR,

// Content is not published due to some other reason
// Reach out to engage-developers@ before using this enum.
AppEngagePublishStatusCode.NOT_PUBLISHED_OTHER

Jika konten tidak dipublikasikan karena pengguna tidak login, Google merekomendasikan untuk memublikasikan Kartu Login. Jika karena alasan apa pun penyedia tidak dapat memublikasikan Kartu Login, sebaiknya panggil API updatePublishStatus dengan kode status NOT_PUBLISHED_REQUIRES_SIGN_IN

Kotlin

client.updatePublishStatus(
   PublishStatusRequest.Builder()
     .setStatusCode(AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SIGN_IN)
     .build())

Java

client.updatePublishStatus(
    new PublishStatusRequest.Builder()
        .setStatusCode(AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SIGN_IN)
        .build());

`deleteRecommendationClusters`

API ini digunakan untuk menghapus konten Cluster Rekomendasi.

Kotlin

client.deleteRecommendationClusters()

Java

client.deleteRecommendationClusters();

Saat menerima permintaan, layanan akan menghapus data yang ada dari Cluster Rekomendasi. Jika terjadi error, seluruh permintaan akan ditolak dan status yang ada dipertahankan.

`deleteFeaturedCluster`

API ini digunakan untuk menghapus konten Cluster Unggulan.

Kotlin

client.deleteFeaturedCluster()

Java

client.deleteFeaturedCluster();

Saat menerima permintaan, layanan akan menghapus data yang ada dari Cluster Unggulan. Jika terjadi error, seluruh permintaan akan ditolak dan status yang ada dipertahankan.

`deleteReservationCluster`

API ini digunakan untuk menghapus konten Cluster Reservasi.

Kotlin

client.deleteReservationCluster()

Java

client.deleteReservationCluster();

Saat menerima permintaan, layanan akan menghapus data yang ada dari Cluster Reservasi. Jika terjadi error, seluruh permintaan akan ditolak dan status yang ada dipertahankan.

`deleteUserManagementCluster`

API ini digunakan untuk menghapus konten Cluster UserAccountManagement.

Kotlin

client.deleteUserManagementCluster()

Java

client.deleteUserManagementCluster();

Saat menerima permintaan, layanan akan menghapus data yang ada dari Cluster UserAccountManagement. Jika terjadi error, seluruh permintaan akan ditolak dan status yang ada dipertahankan.

`deleteContinueSearchCluster`

API ini digunakan untuk menghapus konten Cluster Lanjutkan Penelusuran.

Kotlin

client.deleteContinueSearchCluster()

Java

client.deleteContinueSearchCluster();

Saat menerima permintaan, layanan akan menghapus data yang ada dari Cluster Lanjutkan Penelusuran. Jika terjadi error, seluruh permintaan akan ditolak, dan status yang ada dipertahankan.

`deleteClusters`

API ini digunakan untuk menghapus konten jenis cluster tertentu.

Kotlin

client.deleteClusters(
    DeleteClustersRequest.Builder()
      .addClusterType(ClusterType.TYPE_RESERVATION)
      .addClusterType(ClusterType.TYPE_FEATURED)
      .addClusterType(ClusterType.TYPE_RECOMMENDATION)
      .addClusterType(ClusterType.TYPE_CONTINUE_SEARCH)
      .build())

Java

client.deleteClusters(
            new DeleteClustersRequest.Builder()
                .addClusterType(ClusterType.TYPE_RESERVATION)
                .addClusterType(ClusterType.TYPE_FEATURED)
                .addClusterType(ClusterType.TYPE_RECOMMENDATION)
                .addClusterType(ClusterType.TYPE_CONTINUE_SEARCH)
                .build());

Saat menerima permintaan tersebut, layanan akan menghapus data yang ada dari semua cluster yang cocok dengan jenis cluster yang ditentukan. Klien dapat memilih untuk meneruskan satu atau beberapa jenis cluster. Jika terjadi error, seluruh permintaan akan ditolak dan status yang ada dipertahankan.

Penanganan error

Sangat disarankan untuk memproses hasil tugas dari API publikasi sehingga tindakan lanjutan dapat diambil untuk memulihkan dan mengirim ulang tugas yang berhasil.

Kotlin

client.publishRecommendationClusters(
        PublishRecommendationClustersRequest.Builder()
          .addRecommendationCluster(..)
          .build())
      .addOnCompleteListener { task ->
        if (task.isSuccessful) {
          // do something
        } else {
          val exception = task.exception
          if (exception is AppEngageException) {
            @AppEngageErrorCode val errorCode = exception.errorCode
            if (errorCode == AppEngageErrorCode.SERVICE_NOT_FOUND) {
              // do something
            }
          }
        }
      }

Java

client.publishRecommendationClusters(
              new PublishRecommendationClustersRequest.Builder()
                  .addRecommendationCluster(...)
                  .build())
          .addOnCompleteListener(
              task -> {
                if (task.isSuccessful()) {
                  // do something
                } else {
                  Exception exception = task.getException();
                  if (exception instanceof AppEngageException) {
                    @AppEngageErrorCode
                    int errorCode = ((AppEngageException) exception).getErrorCode();
                    if (errorCode == AppEngageErrorCode.SERVICE_NOT_FOUND) {
                      // do something
                    }
                  }
                }
              });

Error akan ditampilkan sebagai AppEngageException dengan penyebab disertakan sebagai kode error.

Kode error	Nama error	Catatan
`1`	`SERVICE_NOT_FOUND`	Layanan tidak tersedia di perangkat yang ditentukan.
`2`	`SERVICE_NOT_AVAILABLE`	Layanan tersedia di perangkat tertentu, tetapi tidak tersedia pada saat panggilan (misalnya, dinonaktifkan secara eksplisit).
`3`	`SERVICE_CALL_EXECUTION_FAILURE`	Eksekusi tugas gagal karena masalah threading. Dalam hal ini, tindakan tersebut dapat dicoba lagi.
`4`	`SERVICE_CALL_PERMISSION_DENIED`	Pemanggil tidak diizinkan untuk melakukan panggilan layanan.
`5`	`SERVICE_CALL_INVALID_ARGUMENT`	Permintaan berisi data yang tidak valid (misalnya, lebih dari jumlah cluster yang diizinkan).
`6`	`SERVICE_CALL_INTERNAL`	Terjadi error di sisi layanan.
`7`	`SERVICE_CALL_RESOURCE_EXHAUSTED`	Panggilan layanan terlalu sering dilakukan.

Langkah 3: Menangani intent siaran

Selain melakukan panggilan API publikasi konten melalui tugas, Anda juga harus menyiapkan BroadcastReceiver untuk menerima permintaan publikasi konten.

Tujuan intent siaran terutama untuk pengaktifan kembali aplikasi dan memaksa sinkronisasi data. Intent siaran tidak didesain untuk dikirim terlalu sering. Intent itu hanya dipicu jika Layanan Engage menyimpulkan bahwa konten mungkin sudah tidak berlaku (misalnya, seminggu yang lalu). Dengan demikian, pengguna menjadi lebih yakin bahwa mereka dapat memiliki pengalaman konten baru meskipun aplikasi tidak dijalankan dalam waktu yang lama.

BroadcastReceiver harus disiapkan dengan dua cara berikut:

Daftarkan instance class BroadcastReceiver secara dinamis menggunakan Context.registerReceiver(). Hal ini memungkinkan komunikasi dari aplikasi yang masih aktif dalam memori.

Kotlin

class AppEngageBroadcastReceiver : BroadcastReceiver(){
  // Trigger recommendation cluster publish when PUBLISH_RECOMMENDATION broadcast
  // is received
  // Trigger featured cluster publish when PUBLISH_FEATURED broadcast is received
  // Trigger continue search cluster publish when PUBLISH_CONTINUE_SEARCH
  // broadcast is received
  // Trigger reservation cluster publish when PUBLISH_RESERVATION broadcast is
  // received
}

fun registerBroadcastReceivers(context: Context){
  var  context = context
  context = context.applicationContext

// Register Recommendation Cluster Publish Intent
  context.registerReceiver(AppEngageBroadcastReceiver(),
                           IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_RECOMMENDATION),
                           com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
                           /*scheduler=*/null)

// Register Featured Cluster Publish Intent
  context.registerReceiver(AppEngageBroadcastReceiver(),
                           IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_FEATURED),
                           com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
                           /*scheduler=*/null)

// Register Continue Search Cluster Publish Intent
  context.registerReceiver(AppEngageBroadcastReceiver(),
                           IntentFilter(com.google.android.engage.travel.service.Intents.ACTION_PUBLISH_CONTINUE_SEARCH),
                           com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
                           /*scheduler=*/null)

// Register Reservation Cluster Publish Intent
  context.registerReceiver(AppEngageBroadcastReceiver(),
                           IntentFilter(com.google.android.engage.travel.service.Intents.ACTION_PUBLISH_RESERVATION),
                           com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
                           /*scheduler=*/null)
}

Java

class AppEngageBroadcastReceiver extends BroadcastReceiver {
// Trigger recommendation cluster publish when PUBLISH_RECOMMENDATION broadcast
// is received

// Trigger featured cluster publish when PUBLISH_FEATURED broadcast is received

// Trigger continue search cluster publish when PUBLISH_CONTINUE_SEARCH
// broadcast is received

// Trigger reservation cluster publish when PUBLISH_RESERVATION broadcast is
// received
}

public static void registerBroadcastReceivers(Context context) {

context = context.getApplicationContext();

// Register Recommendation Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
                         new IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_RECOMMENDATION),
                         com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
                         /*scheduler=*/null);

// Register Featured Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
                         new IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_FEATURED),
                         com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
                         /*scheduler=*/null);

// Register Continue Search Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
                         new IntentFilter(com.google.android.engage.travel.service.Intents.ACTION_PUBLISH_CONTINUE_SEARCH),
                         com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
                         /*scheduler=*/null);

// Register Reservation Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
                         new IntentFilter(com.google.android.engage.travel.service.Intents.ACTION_PUBLISH_RESERVATION),
                         com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
                         /*scheduler=*/null);

}

Deklarasikan penerapan secara statis dengan tag <receiver> di file AndroidManifest.xml Anda. Hal ini memungkinkan aplikasi menerima intent siaran ketika tidak sedang berjalan, dan juga memungkinkan aplikasi untuk memublikasikan konten.

<application>
   <receiver
      android:name=".AppEngageBroadcastReceiver"
      android:permission="com.google.android.engage.REQUEST_ENGAGE_DATA"
      android:exported="true"
      android:enabled="true">
      <intent-filter>
         <action android:name="com.google.android.engage.action.PUBLISH_RECOMMENDATION" />
      </intent-filter>
      <intent-filter>
         <action android:name="com.google.android.engage.action.PUBLISH_FEATURED" />
      </intent-filter>
      <intent-filter>
         <action android:name="com.google.android.engage.action.travel.PUBLISH_CONTINUE_SEARCH" />
      </intent-filter>
      <intent-filter>
         <action android:name="com.google.android.engage.action.travel.PUBLISH_RESERVATION" />
      </intent-filter>
   </receiver>
</application>

Intent berikut dikirim oleh layanan:

com.google.android.engage.action.PUBLISH_RECOMMENDATION Sebaiknya mulai panggilan publishRecommendationClusters saat menerima intent ini.
com.google.android.engage.action.PUBLISH_FEATURED Sebaiknya mulai panggilan publishFeaturedCluster saat menerima intent ini.
com.google.android.engage.action.travel.PUBLISH_CONTINUE_SEARCH Sebaiknya mulai panggilan publishContinueSearchCluster saat menerima intent ini.
com.google.android.engage.action.travel.PUBLISH_RESERVATION Sebaiknya mulai panggilan publishReservationCluster saat menerima intent ini.

Alur kerja integrasi

Untuk panduan langkah demi langkah cara memverifikasi integrasi Anda setelah selesai, lihat Alur kerja integrasi developer untuk Engage.

FAQ

Lihat Pertanyaan Umum tentang Engage SDK untuk mengetahui FAQ.

Kontak

Hubungi engage-developers@google.com jika ada pertanyaan selama proses integrasi.

Langkah berikutnya

Setelah menyelesaikan integrasi ini, langkah-langkah Anda berikutnya adalah sebagai berikut:

Kirim email ke engage-developers@google.com dan lampirkan APK terintegrasi yang siap diuji oleh Google.
Google melakukan verifikasi dan peninjauan secara internal untuk memastikan integrasi berfungsi seperti yang diharapkan. Jika diperlukan perubahan, Google akan menghubungi Anda dengan menyertakan detail yang diperlukan.
Setelah pengujian selesai dan tidak ada perubahan yang diperlukan, Google akan menghubungi Anda untuk memberi tahu bahwa Anda dapat mulai memublikasikan APK yang diupdate dan terintegrasi ke Play Store.
Setelah Google mengonfirmasi bahwa APK yang diupdate telah dipublikasikan ke Play Store, cluster Rekomendasi, Unggulan, Reservasi, dan Lanjutkan Penelusuran dapat dipublikasikan dan terlihat oleh pengguna.

Engage SDK Perjalanan: Petunjuk integrasi teknis pihak ketiga Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Detail integrasi

Terminologi

Persiapan

Ringkasan

Langkah 1: Memberikan data entity

GenericFeaturedEntity

ArticleEntity

EventEntity

LodgingEntity

StoreEntity

PointOfInterestEntity

RestaurantReservationEntity

EventReservationEntity

LodgingReservationEntity

TransportationReservationEntity

VehicleRentalReservationEntity

Spesifikasi gambar

Spesifikasi zona waktu

Kategori Konten

Langkah 2: Menyediakan data Cluster

isServiceAvailable

Kotlin

Java

publishRecommendationClusters

Kotlin

Java

publishFeaturedCluster

Kotlin

Java

publishReservationCluster

Kotlin

Java

publishContinueSearchCluster

Kotlin

Java

publishUserAccountManagementRequest

Kotlin

Java

updatePublishStatus

Kotlin

Java

deleteRecommendationClusters

Kotlin

Java

deleteFeaturedCluster

Kotlin

Java

deleteReservationCluster

Kotlin

Java

deleteUserManagementCluster

Kotlin

Java

deleteContinueSearchCluster

Kotlin

Java

deleteClusters

Kotlin

Java

Penanganan error

Kotlin

Java

Langkah 3: Menangani intent siaran

Kotlin

Java

Alur kerja integrasi

FAQ

Kontak

Langkah berikutnya

Engage SDK Perjalanan: Petunjuk integrasi teknis pihak ketiga

`GenericFeaturedEntity`

`ArticleEntity`

`EventEntity`

`LodgingEntity`

`StoreEntity`

`PointOfInterestEntity`

`RestaurantReservationEntity`

`EventReservationEntity`

`LodgingReservationEntity`

`TransportationReservationEntity`

`VehicleRentalReservationEntity`

`isServiceAvailable`

`publishRecommendationClusters`

`publishFeaturedCluster`

`publishReservationCluster`

`publishContinueSearchCluster`

`publishUserAccountManagementRequest`

`updatePublishStatus`

`deleteRecommendationClusters`

`deleteFeaturedCluster`

`deleteReservationCluster`

`deleteUserManagementCluster`

`deleteContinueSearchCluster`

`deleteClusters`