Conversions API

Conversions API Gateway - Kesalahan dan Peringatan Pemecahan Masalah

Jika Anda melihat bahwa peristiwa server hilang, atau volume peristiwa server lebih rendah dari peristiwa browser, gunakan dokumentasi ini untuk memecahkan masalah. Untuk informasi tentang fitur pemecahan masalah, lihat Conversions API Gateway - Fitur Pemecahan Masalah.

Gunakan langkah penyelesaian masalah berikut untuk membantu mengidentifikasi masalah:

  1. Navigasikan ke Pengelola Peristiwa
  2. Buka situs web di browser
  3. UI admin Conversions API Gateway

Domain Tidak Dikonfigurasi untuk Mengirim Peristiwa

Conversions API Gateway akan menerima peristiwa dari domain terhubung yang Anda konfigurasikan selama pengaturan integrasi. Jika volume peristiwa server tampak lebih rendah dibandingkan peristiwa browser, mungkin karena Pixel terpicu di domain yang belum terhubung ke Meta.

Diagnostik

  • Login ke Pengelola Peristiwa
  • Pilih peristiwa yang sesuai
  • Klik Lihat Detail dan pilih Ringkasan Peristiwa
  • Dari menu pilihan di sebelah kiri, pilih Domain, untuk menemukan domain tempat peristiwa browser diaktifkan
  • Jika domain tersebut tidak ada atau berbeda dari domain yang telah terkonfirmasi, dapat diharapkan bahwa peristiwa browser tidak direkam

Penyelesaian

DNS Tidak Dikonfigurasi atau Pemetaan DNS Salah

Conversions API Gateway di-hosting di AWS, yang memberikannya alamat IP saat dibuat. Anda harus memetakan subdomain dari domain Anda ke alamat IP ini sehingga endpoint Conversions API Gateway dapat dijangkau dari browser melalui panggilan permintaan pihak pertama.

Diagnostik

  • Gunakan pemeriksa DNS online seperti https://dnschecker.org/ untuk memeriksa apakah domain Conversions API Gateway telah diselesaikan ke alamat IP yang benar dan sepenuhnya disebarkan. Jika domain Anda tidak terselesaikan ke alamat IP mana pun, lihat bagian resolusi untuk langkah berikutnya.
  • Dapatkan alamat IP server Conversions API Gateway Anda dari dasbor AWS EC2 Anda atau tanyakan informasi ini ke informasi kontak infrastruktur cloud Anda.
  • Jika kedua alamat IP berbeda, lihat bagian resolusi untuk langkah berikutnya.

Penyelesaian

  • Bekerja samalah dengan admin di pendaftar domain.
  • Perbarui rekaman DNS di pendaftar domain Anda dengan alamat IP server Conversions API Gateway (yang ditampilkan di dasbor AWS EC2 Anda).
    • Atur rekaman A DNS yang memetakan subdomain Conversions API Gateway Anda ke alamat IP server yang dibuat selama pengaturan.

Sertifikat Tidak Pernah Dikeluarkan

Jika Conversions API Gateway tidak pernah memiliki sertifikat keluaran Let’s Encrypt, bahkan lama setelah DNS dikonfigurasikan dengan benar, itu berarti domain Anda sangat populer sehingga Let’s Encrypt menolak untuk menerbitkannya.

Penyelesaian

  • Pertimbangkan untuk menempatkan AWS Load Balancer (ALB) di depan instance Conversions API Gateway dan gunakan ALB untuk meng-host sertifikat yang Anda miliki.

Sertifikat Dikeluarkan tetapi Kedaluwarsa

Masalah ini terjadi jika Anda menutup port 80 setelah Conversions API Gateway berhasil diinstal, atau Anda menjalankan versi lama.

Penyelesaian

  • Buka port 80 dan tingkatkan Conversions API Gateway ke versi terbaru.

UI Gateway Tidak Dapat Diakses

Masalah ini terjadi jika Anda menutup port 80 setelah Conversions API Gateway berhasil diinstal, atau Anda menjalankan versi lama.

Penyelesaian

  • Verifikasikan alamat IP untuk instance Conversions API Gateway cocok dengan konfigurasi DNS. Jika tidak, lihat DNS Tidak Dikonfigurasi atau Pemetaan DNS Salah.
  • Jika server tidak responsif, hal ini dapat disebabkan oleh kesalahan jaringan sementara dan dapat diselesaikan dengan memulai ulang instance. Diperlukan waktu beberapa menit untuk memulai Conversions API Gateway, jadi tunggu sekitar 10 menit untuk masuk lagi.

Gateway Memerlukan Peningkatan Versi

Tampaknya Conversions API Gateway versi sebelum v1.0.8 berhenti mengirimkan peristiwa ke Meta. Kami menyarankan Anda meningkatkan ke setidaknya v1.0.8 untuk memaksimalkan manfaat pengaturan. Ini akan melanjutkan alur peristiwa dan memastikan pembaruan otomatis di masa mendatang.

Diagnostik

  • Untuk memeriksa Conversions API Gateway versi saat ini:
    • Buka UI admin Conversions API Gateway Anda:
https://<Conversions API Gateway Endpoint>/hub
  • Periksa versi saat ini dari server Conversions API Gateway Anda:
    • Menu sisi kiri > Pengaturan > Pembaruan

Penyelesaian

Untuk meningkatkan Conversions API Gateway, lakukan hal berikut:

Pemecahan Masalah dengan Log EKS

Jika Anda mengalami masalah saat menginstal Conversions API Gateway untuk versi EKS akun tunggal atau versi multiakun, Anda dapat merujuk ke log untuk memecahkan masalah.

Log penginstalan EKS tersedia di AWS Cloudwatch dengan nama grup “ConversionsAPIGateway/cloud-init-output.log”. Anda bisa memeriksa apakah ada pesan kesalahan. Kesalahan umum termasuk melampaui batas sumber daya AWS dan tidak adanya izin AWS.



Rekaman DNS dengan Jenis CAA Tidak Memiliki amazonaws.com

Jika rekaman DNS yang diminta disiapkan oleh Conversions API Gateway memiliki sertifikat TLS yang sesuai atau tidak memiliki rekaman CAA, Anda dapat mengabaikan bagian ini.

Jika Anda memiliki rekaman CAA untuk domain tersebut, pastikan Anda menetapkan amazonaws.com sebagai nilai untuk rekaman CAA itu jika Anda telah memasang versi AWS EKS dari Conversions API Gateway (untuk Akun Tunggal) atau Conversions API Gateway untuk Beberapa Akun versi 1.10.* atau yang lebih baru yang menggunakan Pengelola Sertifikat AWS untuk pembuatan domain. Contoh rekaman CAA:

0 issue "amazonaws.com"

Jika Anda telah memasang Conversions API Gateway untuk Beberapa Akun versi 1.9.* atau yang lebih lama, pastikan Anda menetapkan letsencrypt.org sebagai nilai untuk rekaman CAA. Contoh:

0 issue "letsencrypt.org"

Lihat Juga