Produk Gateway

Conversions API Gateway dan Signals Gateway: Panduan Pemecahan Masalah

Langkah Pemecahan Masalah untuk Host

Gunakan langkah-langkah pemecahan masalah secara berurutan untuk Produk Gateway, Conversions API Gateway, atau Signals Gateway Anda seperti di bawah ini, untuk membantu menyelesaikan masalah.

Endpoint Pemeriksaan Kesehatan Produk Gateway

Silakan buka:

https://<Gateway Products Endpoint>/hub/health/

Host dapat memantau status server instance melalui layanan pemeriksaan kesehatan ini.

Masalah 1: UI Gateway host tidak dapat diakses atau tidak menunjukkan informasi apa pun

Langkah 1. Gunakan pemeriksa DNS online, seperti https://dnschecker.org/, untuk memverifikasi apakah domain Gateway telah di-resolve ke alamat IP yang tepat yang disediakan dalam penyiapan instance dan disebarkan sepenuhnya. Jika tidak, tunggu beberapa waktu hingga DNS sepenuhnya disebarkan dan pastikan bahwa Anda telah membuat rekaman CNAME di pendaftar domain Anda.

Langkah 2. Jaringan mungkin tidak dapat diakses untuk sementara waktu - tunggu beberapa menit untuk login kembali ke UI Produk Gateway atau muat ulang halaman.

Langkah 3. Sumber daya instance mungkin tidak mencukupi. Hentikan pod untuk merilis sumber daya dengan mengikuti langkah-langkah berikut ini:

  • Sambungkan ke Pengelola Sesi dan jalankan perintah kubectl delete deployment capig untuk menghentikan pod Produk Gateway.
  • Tunggu selama 5 menit, lalu jalankan perintah kubectl get pods -A. Semua status pod seharusnya Berjalan atau Selesai.
  • Jika tidak, jalankan perintah kubectl delete deployment hub untuk menghentikan pod Hub. Ulangi langkah di atas

Langkah 4. Hapus penginstalan dan instal ulang instance jika ini adalah instance baru.

Langkah 5. Bagikan dengan kontak Meta Anda (jika ada)

  • Catatan Produk Gateway
  • Ini dapat diunduh dari halaman /hub/pengaturan/pembaruan dengan mengklik tombol “Unduh catatan”.
  • Tangkapan layar dari fitur UI Gateway host di mana kesalahan terjadi.

"Error 400: Identity Pool does not exist (myproject-3-XXXXX.svc.id.goog)” terjadi selama onboarding host GCP

Kesalahan ini biasanya terjadi karena Anda belum membuat klaster Google Kubernetes Engine di akun GCP Anda dan perlu waktu untuk membuat beberapa sumber daya dasar untuk pertama kalinya. Anda harus menggunakan skrip menghapus instalan yang dijelaskan di Panduan menghapus instalan untuk membersihkan instalasi dan mencoba kembali instalasi baru.

Waktu sesi CloudShell habis selama onboarding host GCP

Jika sesi CloudShell dibiarkan saja dalam waktu yang lama, terminal CloudShell bisa terputus. Bahkan dalam hal ini, penginstalan mungkin sudah selesai. Untuk memeriksa petunjuk instalasi, silakan buka Halaman Penyimpanan Cloud GCP, dan cari bucket bernama capig-{your_login_id}-XXX-storage-bucket. Ada file bernama capig-onboarding-guide.txt. Silakan buka file tersebut dan ikuti petunjuk yang disediakan.

Langkah Pemecahan Masalah untuk Akun: Menghubungkan ke Gateway

Ikuti langkah-langkah pemecahan masalah di bawah ini untuk membantu menyelesaikan masalah:

Masalah 1: Tidak Dapat Menyelesaikan Instalasi

Pastikan Anda telah mengikuti semua langkah yang diperinci dalam panduan onboarding. Jika Anda masih diblokir, hubungi petugas kontak Meta Anda dengan deskripsi yang jelas, atau lebih baik lagi jika ada cuplikan layar untuk masalah ini.

Masalah 2: UI Gateway Tidak Dapat Diakses atau Tidak Menampilkan Informasi Apa Pun

Langkah 1. Periksa apakah jaringan mati sementara. Tunggu beberapa menit untuk login kembali ke UI Produk Gateway atau muat ulang halaman.

Langkah 2. Bagikan dengan kontak Meta Anda (jika ada)

  • Catatan Produk Gateway
  • Tangkapan layar Konsol dari fitur developer pada UI Gateway host di mana kesalahan terjadi

Masalah 3: Tidak menerima Peristiwa Gateway setelah Instalasi Selesai

Langkah 1. Situs web bisa jadi diblokir. Secara default, situs web mana pun yang menerima peristiwa dari Pixel yang terkait dengan Produk Gateway Anda diizinkan untuk menerima dan menerbitkan peristiwa. Hanya situs web yang diblokir yang akan dicegah agar tidak menerima dan menerbitkan peristiwa

Diagnostik

Buka UI Produk Gateway Anda, dan pilih Situs Web -> Situs Web yang Diblokir dari menu sebelah kiri.

Resolusi

Buka blokir situs web apa pun yang ingin Anda terima dan terbitkan peristiwanya.

Langkah 2. Pixel mungkin tidak diinstal dengan cara standar. Agar Produk Gateway berfungsi dengan baik, kami sarankan untuk menambahkan Pixel secara langsung ke tag <head> situs web Anda.

Diagnostik

  • Periksa apakah pixel terinstal sesuai dengan pedoman yang disebutkan di bagian Resolusi.
  • Periksa apakah peristiwa tersebut telah dikonfigurasikan menggunakan Fitur Pengaturan Peristiwa. Saat ini, Produk Gateway tidak mendukung pelacakan peristiwa yang dikonfigurasikan menggunakan Fitur Penyiapan Peristiwa.

Resolusi

  • Instal kode dasar untuk pixel
    • Untuk Meta Pixel, lihat petunjuk ini
    • Untuk Signals Gateway Pixel, petunjuknya ada di modal perincian Sumber Data
  • Selain itu, terapkan kode pelacakan konversi jika Anda ingin melacak konversi. Pastikan bahwa kode dasar telah terinstal di setiap halaman tempat Anda ingin melacak konversi.

Langkah 3. Konfigurasi DNS mungkin tidak lengkap atau salah. Pixel berkomunikasi dengan Gateway pada domain yang sesuai dengan komunikasi ini, idealnya sama dengan halaman tempat pixel terpicu. Contoh: jika pixel terpicu di advertiser.com, idealnya Gateway akan dapat dijangkau oleh pixel di gateway.advertiser.com.

Subdomain dari domain akun (domain tempat pixel terpicu) harus dikaitkan dengan subdomain host melalui rekaman CNAME di provider DNS pengiklan, sehingga endpoint Produk Gateway dapat dijangkau oleh pixel melalui panggilan permintaan pihak pertama.

Diagnostik

Gunakan pemeriksa DNS online seperti https://dnschecker.org/ untuk memverifikasi apakah rekaman CNAME seperti yang dijelaskan di atas telah diatur dengan benar, yaitu subdomain akun dengan benar mengarah ke subdomain host, yang mengarah ke domain yang diseimbangkan dengan muatan yang ditetapkan pada saat pembuatan. Jika domain akun pada akhirnya tidak mengarah ke domain bermuatan seimbang, lihat bagian Resolusi untuk langkah berikutnya.

Resolusi

  • Bekerja samalah dengan admin di pendaftar domain.
  • Perbarui rekaman DNS di pendaftar domain Anda dengan alamat IP server Produk Gateway Anda. Tetapkan rekaman DNS CNAME yang memetakan subdomain Produk Gateway Anda ke alamat IP server yang dihasilkan selama penyiapan.

Langkah 4. Peristiwa dapat diblokir oleh Kebijakan Keamanan Konten (CSP). Beberapa situs web mungkin memiliki CSP yang memblokir peristiwa agar tidak diterima oleh Produk Gateway.

Diagnostik

Periksa apakah ada header tanggapan kebijakan keamanan konten yang diatur di server dari situs web pengiklan.


Resolusi

  • Izinkan daftar subdomain ke aturan CSP untuk menjadikannya pengecualian dari kebijakan.

Langkah 5. Putuskan sambungan pixel sepenuhnya dan hubungkan kembali.

Langkah 6. Pastikan Anda menggunakan token akses sistem yang valid.

Diagnostik

Periksa apakah ada header tanggapan kebijakan keamanan konten yang diatur di server dari situs web pengiklan.

Akses https://<Gateway Product Endpoint>/capig/graphiql/. Tempelkan perintah di bawah ini dengan tenantId untuk mendapatkan token akses yang sesuai

query test {
   tenantQueries (tenantId:"") {
    account {
      signalConfigs {
        connectionId
        connectionStatus {
          badToken
          accessTokenAvailable 
        }
      }
    }
  }
}

Untuk menemukan tenantId, buka UI Produk Gateway dan pilih akun yang sesuai di mana tautan url ditampilkan sebagai https://<Gateway Product Endpoint>/hub/capig/?tenant=<tenentId>.

Jika hasil badToken adalah true, perbaiki dengan mengklik tombol “Tambahkan Sumber Data” untuk menambahkan Sumber Data yang sama lagi.

Langkah 7. Verifikasi dengan host Anda apakah UI host dapat diakses dan ikuti langkah-langkah pemecahan masalah dalam panduan ini.