Mulai menggunakan penyematan pribadi

Halaman ini akan memandu Anda cara menyiapkan penyematan pribadi. Opsi penyematan pribadi mengharuskan Anda mengelola elemen HTML <iframe> secara langsung untuk menyematkan konten Looker dan mengharuskan pengguna login ke Looker secara terpisah dari aplikasi host.

Kami akan membahas contoh kode penyematan pribadi ini:

<iframe
    src="https://instance.looker.com/embed/dashboards/4?Timeframe=14+day"
    width="600"
    height="300"
    frameborder="0">
</iframe>

1. Membuat URL konten sematan

Pertimbangkan contoh konten Looker di URL https://instance.looker.com/dashboards/4?theme=red&Timeframe=14+day. Dari URL konten Looker ini, kita akan membuat URL konten sematan dan menetapkan atribut src iframe ke URL tersebut. Anda dapat menggunakan URL konten Looker Anda sendiri saat mengerjakan langkah-langkah ini.

URL konten sematan dari contoh kode sebelumnya adalah sebagai berikut:

https://instance.looker.com/embed/dashboards/4?theme=red&Timeframe=14+day

URL konten sematan terdiri dari tiga bagian:

  • Nama host: nama host instance Looker Anda
  • Jalur: Jalur URL konten Looker yang diawali dengan /embed (dengan langkah tambahan untuk visualisasi kueri)
  • Parameter: Parameter URL yang menentukan filter dan tema

Protokol harus selalu https://. Mari kita buat setiap bagian secara mendetail.

Bagian 1: Nama host

  1. Buka konten Looker Anda. Mengikuti contoh URL konten Looker: https://instance.looker.com/dashboards/4?theme=red&Timeframe=14+day.
  2. Nama host URL konten sematan Anda adalah instance.looker.com.

Bagian 2: Jalur

Jalur URL konten sematan bergantung pada konten Looker yang Anda sematkan.

Menyematkan semua konten Looker kecuali visualisasi kueri

  1. Buka konten Looker Anda. Mengikuti contoh URL konten Looker: https://instance.looker.com/dashboards/4?theme=red&Timeframe=14+day
  2. Identifikasi jalur URL konten Looker Anda: /dashboards/4.
  3. Awali jalur URL konten Looker Anda dengan /embed. Jalur URL konten sematan Anda adalah /embed/dashboards/4.

Menyematkan visualisasi kueri

  1. Buka visualisasi kueri Anda. Contoh URL: instance.looker.com/explore/my_model/my_explore?qid=1234567890abcdefghij12
  2. Identifikasi client ID kueri Anda. Parameter qid: 1234567890abcdefghij12 adalah client ID kueri Anda yang mewakili kueri dan setelan visualisasi.
  3. Jalur URL konten sematan Anda adalah /embed/query-visualization/ yang ditambahkan dengan client ID kueri Anda. Contoh jalur URL konten sematan adalah /embed/query-visualization/1234567890abcdefghij12

Bagian 3: Parameter

Parameter URL konten sematan mengontrol filter dan tema konten sematan Anda.

Filter

  1. Buka URL konten Looker Anda.
  2. Sesuaikan filter konten secara manual sesuai keinginan Anda. Untuk contoh ini, URL konten Looker yang dihasilkan adalah: https://instance.looker.com/dashboards/4?Timeframe=14+day
  3. Parameter URL konten sematan Anda adalah parameter URL konten Looker, misalnya, Timeframe=14+day

Dalam contoh ini, parameter Timeframe=14+day menetapkan nilai filter Timeframe dasbor.

Tema

Lihat panduan tema untuk membaca cara mengontrol tampilan konten sematan Anda.

2. Menguji URL konten sematan

Buka URL konten sematan di browser Anda untuk melihat pratinjau perilaku dan tampilan konten sematan Anda.

3. Membuat iframe

  1. Buat elemen iframe di aplikasi host Anda.
  2. Tetapkan atribut src ke URL konten sematan Anda.
  3. Tentukan width, height, dan atribut lainnya sesuai kebutuhan Anda untuk menampilkan konten Looker sematan dengan sebaik-baiknya.

4. Mempertimbangkan masalah akses pengguna

Pengguna harus sedang login ke Looker untuk melihat konten sematan Anda. Iframe akan menampilkan halaman error 401 jika pengguna tidak login.

Opsi login pengguna

Pengguna dapat login ke Looker dengan salah satu dari dua cara berikut:

1. Login ke Looker terlebih dahulu

Pengguna harus login ke Looker di browser yang sama sebelum dapat melihat konten sematan.

2. Mengaktifkan layar login Looker sematan opsional

Tambahkan allow_login_screen=true ke parameter URL konten sematan Anda untuk menampilkan layar login Looker di iframe jika pengguna tidak login. Contoh URL konten sematan kita menjadi: https://instance_name.looker.com/embed/dashboards/4?Timeframe=14+day&allow_login_screen=true

Perhatikan dua peringatan:

  • Anda harus menonaktifkan setelan Same-Origin Protections for Looker Login Pages untuk mengaktifkan layar login Looker di sematan iframe.
  • Jika instance Looker Anda mengautentikasi pengguna menggunakan single sign-on (SSO) dengan penyedia identitas, penyedia identitas Anda dapat memblokir layar login dalam iframe Anda. Anda harus menggunakan opsi 1 jika hal ini terjadi.

Looker menggunakan cookie untuk autentikasi pengguna dan penyimpanan sesi. Browser pengguna Anda harus mengaktifkan cookie pihak ketiga jika pengguna Anda mengakses nama host URL konten sematan instance Looker Anda berada di domain yang berbeda dari aplikasi host Anda.

Beberapa browser, seperti Firefox dan Safari, secara default menggunakan kebijakan cookie yang memblokir cookie pihak ketiga. Jika browser pengguna tidak dapat mengizinkan cookie pihak ketiga, Anda dapat menambahkan domain kustom ke instance Looker sehingga aplikasi host dan nama host URL konten sematan instance Looker berada di domain yang sama.

5. Berinteraksi dengan iframe Anda

Mulai menggunakan fitur pesan posting iframe penyematan Looker.

Langkah berikutnya

Mulai menggunakan penyematan bertanda tangan menggunakan Embed SDK kami dan lihat contoh hal yang dapat Anda lakukan dengan penyematan Looker.