Iklan Hotel - Harga Sesuai Tanggal

Di beranda hotel statis, Anda menyediakan satu harga untuk setiap hotel. Anda tidak dapat memberikan harga yang berbeda berdasarkan tanggal singgah, lama menginap, atau jenis kamar. Untuk menampilkan harga yang lebih akurat di iklan Anda berdasarkan variabel ini, gunakan harga dinamis (sesuai tanggal) untuk memberikan harga menurut tanggal, jenis kamar, dan lama menginap yang berbeda-beda. Setelah disediakan, Anda dapat menggunakan tanda template hotel untuk memakai harga ini di iklan Anda.

Gunakan unggah batch jenis kamar dan data harga untuk membagikan detail harga dengan Facebook.

Lihat parameter kamar & harga untuk penjelasan semua parameter.

Unggah Batch Jenis Kamar dan Data Harga

Unggah batch terdiri atas dua bagian:

Unggah Jenis Kamar
Unggah Harga

Jika Anda menggunakan pengunggahan batch, batasi unggahan menjadi 50 MB untuk setiap file, sekitar 50.000 item dalam satu file. Kami merekomendasikan pembaruan yang lebih sering dan lebih kecil untuk variabel harga.

Unggah Jenis Kamar

Unggah satu atau beberapa file dengan jenis kamar menggunakan API Batch Kamar Hotel.

Catatan: Jika Anda tidak memiliki jenis kamar yang berbeda, Anda dapat melewati langkah ini.

curl \
  -X POST \
  -F file=@hotel_rooms_data_xml.xml \
  -F "access_token=<ACCESS_TOKEN>" \
  https://graph.facebook.com/<API_VERSION>/<PRODUCT_CATALOG_ID>/hotel_rooms_batch

Format File Jenis Kamar

Anda dapat menyediakan jenis kamar dalam format XML; lihat contoh.

Anda harus mengidentifikasi setiap hotel berdasarkan <property> di node XML <PropertyDataSet> dan menyediakan jenis kamar berdasarkan <RoomData>. File Anda harus diawali dengan tanda deklarasi <?xml.

Untuk detail selengkapnya tentang memperbarui dan menghapus jenis kamar melalui API batch, lihat Kamar Hotel, Referensi Batch.

Unggah Harga

Unggah satu atau beberapa file dengan detail harga menggunakan API Batch Variabel Harga. Anda dapat mengunggah detail harga dengan atau tanpa jenis kamar.

Catatan: Jika Anda hanya memiliki jumlah kamar yang sangat kecil, API Kamar Hotel dapat digunakan untuk membuat jenis kamar dan pengaturan harga.

curl \
  -X POST \
  -F file=@pricings_data_xml.xml \
  -F "access_token=<ACCESS_TOKEN>" \
  https://graph.facebook.com/<API_VERSION>/<PRODUCT_CATALOG_ID>/pricing_variables_batch

Format File Harga

Sebelum Anda mengunggah jenis kamar, pastikan hotel untuk kamar tersebut sudah ada di katalog. Anda dapat menyediakan variabel harga dalam format ini:

Format & Contoh File Deskripsi

Format & Contoh File	Deskripsi
XML dengan jenis kamar \| Contoh XML	Pastikan jenis kamar yang ingin Anda sediakan harganya sudah ada. Tentukan harga (`<Baserate>`) dalam setiap jenis kamar (`<RoomBundle>`) berdasarkan kombinasi tanggal singgah (`<Checkin>`) dan lama menginap (`<Nights>`). File harus diawali dengan tanda deklarasi `<?xml`.
XML tanpa jenis kamar \| Contoh XML	Tentukan harga (`<Baserate>`) untuk setiap kombinasi ID hotel (`<Property>`), tanggal singgah (`<Checkin>`), dan lama menginap (`<Nights>`). File harus diawali dengan tanda deklarasi `<?xml`.

XML dengan jenis kamar | Contoh XML

Pastikan jenis kamar yang ingin Anda sediakan harganya sudah ada.

Tentukan harga (<Baserate>) dalam setiap jenis kamar (<RoomBundle>) berdasarkan kombinasi tanggal singgah (<Checkin>) dan lama menginap (<Nights>).

File harus diawali dengan tanda deklarasi <?xml.

XML tanpa jenis kamar | Contoh XML

Tentukan harga (<Baserate>) untuk setiap kombinasi ID hotel (<Property>), tanggal singgah (<Checkin>), dan lama menginap (<Nights>).

File harus diawali dengan tanda deklarasi <?xml.

Untuk detail selengkapnya tentang cara memperbarui dan menghapus variabel harga melalui batch, lihat Referensi Batch Variabel Harga.

Parameter Kamar & Harga

Nama dan Jenis Kolom Deskripsi

Nama dan Jenis Kolom	Deskripsi
`Property` jenis: string	Wajib. Pengidentifikasi unik dari hotel yang disediakan oleh pengiklan sebagai `hotel_id` di beranda hotel.
`RoomID` jenis: string	Wajib. Pengidentifikasi unik dari jenis kamar yang disediakan oleh pengiklan.
`Name` jenis: string	Wajib. Nama jenis kamar hotel.
`Description` jenis: string	Wajib. Deskripsi jenis kamar hotel.
`BasePrice` jenis: float	Wajib. Harga terendah kamar hotel. Mata uang harus disertakan. Contoh: `159 USD`
`URL` jenis: string	Tautan ke halaman kamar hotel.
`CheckinDate` jenis: tanggal	Wajib. Tanggal singgah untuk `price`. Kami mendukung hingga 180 hari sejak tanggal beranda diunggah. Gunakan ISO‑8601 (TTTT‑BB‑HH).
`Nights` jenis: int	Wajib. Jumlah malam menginap di hotel untuk `price`. Nilai maks: 14
`Baserate` jenis: float	Wajib. Harga didasarkan pada `checkin_date` dan `length_of_stay`. Contoh: `180`
`Tax` jenis: float	Wajib. Nilai pajak selama menginap.
`OtherFees` jenis: float	Wajib. Biaya yang dikenakan selama menginap.
`SalePrice` jenis: float	Harga diskon jika berlaku. Contoh: `159`
`SalePriceTax` jenis: float	Nilai pajak untuk harga diskon.

Property

jenis: string

Wajib. Pengidentifikasi unik dari hotel yang disediakan oleh pengiklan sebagai hotel_id di beranda hotel.

RoomID

jenis: string

Wajib. Pengidentifikasi unik dari jenis kamar yang disediakan oleh pengiklan.

Name

jenis: string

Wajib. Nama jenis kamar hotel.

Description

jenis: string

Wajib. Deskripsi jenis kamar hotel.

BasePrice

jenis: float

Wajib. Harga terendah kamar hotel. Mata uang harus disertakan.

Contoh: 159 USD

URL

jenis: string

Tautan ke halaman kamar hotel.

CheckinDate

jenis: tanggal

Wajib. Tanggal singgah untuk price. Kami mendukung hingga 180 hari sejak tanggal beranda diunggah. Gunakan ISO‑8601 (TTTT‑BB‑HH).

Nights

jenis: int

Wajib. Jumlah malam menginap di hotel untuk price. Nilai maks: 14

Baserate

jenis: float

Wajib. Harga didasarkan pada checkin_date dan length_of_stay.

Contoh: 180

Tax

jenis: float

Wajib. Nilai pajak selama menginap.

OtherFees

jenis: float

Wajib. Biaya yang dikenakan selama menginap.

SalePrice

jenis: float

Harga diskon jika berlaku.

Contoh: 159

SalePriceTax

jenis: float

Nilai pajak untuk harga diskon.