Pustaka PHP kami memungkinkan Anda merekam data analitik dari kode PHP Anda. Permintaan masuk ke server kami, lalu kami merutekan data Anda ke layanan analitik apa pun yang Anda aktifkan di halaman tujuan
Pustaka ini bersumber terbuka, jadi Anda bisa memeriksanya di GitHub
PHP sedikit berbeda dari perpustakaan sisi server kami yang lain karena ini adalah bahasa single-threaded. Kami telah melakukan semua yang kami bisa untuk membuat perpustakaan kami seperforma mungkin, sambil tetap memberi Anda ruang untuk menyetel pengaturan untuk aplikasi Anda. Jika Anda ingin mempelajari lebih lanjut tentang menyetel setelan Anda untuk performa tinggi, pastikan untuk membaca bagian kami di bagian akhir panduan ini
Ingin tetap diperbarui pada rilis?
Mulai
Kloning repositori dari Github ke direktori aplikasi yang Anda inginkan
Untuk pengguna komposer. kami juga membantu Anda
git clone //github.com/segmentio/analytics-php /my/app/folders/
Tambahkan yang berikut ini ke skrip PHP Anda untuk benar-benar memuat pustaka analitik Segmen dalam kode Anda
require_once("/path/to/analytics-php/lib/Segment.php"); use Segment\Segment; _
Sekarang, Anda siap menginisialisasi modul. Dalam contoh kami, pertama-tama kami mengganti nama modul ini menjadi require_once("/path/to/analytics-php/lib/Segment.php"); use Segment\Segment; 9 untuk kenyamanan. Dalam skrip inisialisasi Anda, lanjutkan dan lakukan panggilan berikut
# set up our Segment tracking and # alias to Analytics for convenience class_alias('Segment', 'Analytics'); Segment::init("YOUR_WRITE_KEY");
Anda hanya perlu memanggil # set up our Segment tracking and # alias to Analytics for convenience class_alias('Segment', 'Analytics'); Segment::init("YOUR_WRITE_KEY"); _0 satu kali saat file php Anda diminta. Semua file Anda kemudian akan memiliki akses ke klien require_once("/path/to/analytics-php/lib/Segment.php"); use Segment\Segment; 9 yang sama
Tentu saja, Anda ingin mengganti # set up our Segment tracking and # alias to Analytics for convenience class_alias('Segment', 'Analytics'); Segment::init("YOUR_WRITE_KEY"); 2 dengan Kunci Tulis Anda yang sebenarnya yang dapat Anda temukan di Segmen di bawah pengaturan sumber Anda
Konsumen PHP default adalah. Jika ini tidak bekerja dengan baik untuk Anda, atau jika Anda memiliki proyek bervolume tinggi, Anda mungkin ingin mencoba salah satu konsumen kami yang lain seperti
Konfigurasi daerah
Untuk paket Bisnis dengan akses ke Segmen Regional, Anda dapat menggunakan parameter konfigurasi # set up our Segment tracking and # alias to Analytics for convenience class_alias('Segment', 'Analytics'); Segment::init("YOUR_WRITE_KEY"); 3 untuk mengirim data ke wilayah yang diinginkan
- Oregon (Default) — # set up our Segment tracking and # alias to Analytics for convenience class_alias('Segment', 'Analytics'); Segment::init("YOUR_WRITE_KEY"); _4
- Dublin — # set up our Segment tracking and # alias to Analytics for convenience class_alias('Segment', 'Analytics'); Segment::init("YOUR_WRITE_KEY"); 5
Mengenali
Senang mendengarnya. Untuk berbagai metode yang dijelaskan di halaman ini, Anda dapat mengganti properti dan ciri dalam contoh kode dengan variabel yang mewakili data yang dikumpulkan
Identifikasi panggilan memungkinkan Anda mengikat pengguna ke tindakan mereka, dan merekam sifat tentang mereka. Ini mencakup ID Pengguna unik dan fitur opsional apa pun yang Anda ketahui tentangnya
Kami merekomendasikan untuk memanggil # set up our Segment tracking and # alias to Analytics for convenience class_alias('Segment', 'Analytics'); Segment::init("YOUR_WRITE_KEY"); _6 satu kali saat akun pengguna pertama kali dibuat, dan hanya mengidentifikasi lagi nanti saat sifat mereka berubah
Inilah kemungkinan panggilan dasar ke # set up our Segment tracking and # alias to Analytics for convenience class_alias('Segment', 'Analytics'); Segment::init("YOUR_WRITE_KEY"); 6
Segment::identify(array( "userId" => "2sfjej334", "traits" => array( "email" => $user->email, "name" => $user->name, "friends" => 25 ) ));
Ini akan mengidentifikasi pengguna dengan ID Pengguna uniknya (yang Anda kenal dengannya di basis data Anda) dan memberinya label dengan # set up our Segment tracking and # alias to Analytics for convenience class_alias('Segment', 'Analytics'); Segment::init("YOUR_WRITE_KEY"); 8, # set up our Segment tracking and # alias to Analytics for convenience class_alias('Segment', 'Analytics'); Segment::init("YOUR_WRITE_KEY"); 9, dan Segment::identify(array( "userId" => "2sfjej334", "traits" => array( "email" => $user->email, "name" => $user->name, "friends" => 25 ) )); 0 ciri-ciri
Panggilan # set up our Segment tracking and # alias to Analytics for convenience class_alias('Segment', 'Analytics'); Segment::init("YOUR_WRITE_KEY"); _6 memiliki bidang-bidang berikut
Segment::identify(array( "userId" => "2sfjej334", "traits" => array( "email" => $user->email, "name" => $user->name, "friends" => 25 ) )); 2 StringID untuk pengguna ini di basis data Anda. Segment::identify(array( "userId" => "2sfjej334", "traits" => array( "email" => $user->email, "name" => $user->name, "friends" => 25 ) )); 3 Larik, opsionalSejumlah sifat yang Anda ketahui tentang pengguna. Hal-hal seperti. # set up our Segment tracking and # alias to Analytics for convenience class_alias('Segment', 'Analytics'); Segment::init("YOUR_WRITE_KEY"); 8, # set up our Segment tracking and # alias to Analytics for convenience class_alias('Segment', 'Analytics'); Segment::init("YOUR_WRITE_KEY"); 9 atau Segment::identify(array( "userId" => "2sfjej334", "traits" => array( "email" => $user->email, "name" => $user->name, "friends" => 25 ) )); 0. Segment::identify(array( "userId" => "2sfjej334", "traits" => array( "email" => $user->email, "name" => $user->name, "friends" => 25 ) )); 7 String, opsionalJika Anda ingin melacak pengguna secara anonim, Anda dapat menyertakan ID Anonim alih-alih ID PenggunaSegment::identify(array( "userId" => "2sfjej334", "traits" => array( "email" => $user->email, "name" => $user->name, "friends" => 25 ) )); 8 Nomor, opsionalJumlah detik sejak zaman unix (Segment::identify(array( "userId" => "2sfjej334", "traits" => array( "email" => $user->email, "name" => $user->name, "friends" => 25 ) )); 9) menunjukkan kapan identifikasi terjadi. Jika identifikasi baru saja terjadi, biarkan saja dan kami akan menggunakan waktu server. Jika Anda mengimpor data dari masa lalu, pastikan Anda memberikan Segment::identify(array( "userId" => "2sfjej334", "traits" => array( "email" => $user->email, "name" => $user->name, "friends" => 25 ) )); 8. Segment::track(array( "userId" => "f4ca124298", "event" => "Signed Up", "properties" => array( "plan" => "Enterprise" ) )); 1 Array, opsionalSebuah objek yang berisi sejumlah pilihan atau konteks tentang permintaan. Untuk melihat referensi lengkap kunci yang didukung, periksa diTemukan detail tentang payload metode identifikasi di Spesifikasi kami
Melacak
Segment::track(array( "userId" => "f4ca124298", "event" => "Signed Up", "properties" => array( "plan" => "Enterprise" ) )); 2 memungkinkan Anda merekam tindakan yang dilakukan pengguna Anda. Setiap tindakan memicu apa yang kita sebut "peristiwa", yang juga dapat memiliki properti terkait
Anda ingin melacak peristiwa yang merupakan indikator keberhasilan situs Anda, seperti Mendaftar, Barang Dibeli, atau Artikel Ditandai
Untuk memulai, sebaiknya lacak beberapa peristiwa penting saja. Anda selalu dapat menambahkan lebih banyak nanti
Contoh Segment::track(array( "userId" => "f4ca124298", "event" => "Signed Up", "properties" => array( "plan" => "Enterprise" ) )); _2 panggilan
Segment::track(array( "userId" => "f4ca124298", "event" => "Signed Up", "properties" => array( "plan" => "Enterprise" ) ));
Itu hanya memberi tahu kami bahwa pengguna Anda baru saja memicu acara Mendaftar dan memilih paket Perusahaan hipotetis Anda
Segment::track(array( "userId" => "f4ca124298", "event" => "Signed Up", "properties" => array( "plan" => "Enterprise" ) )); 2 properti acara dapat berupa apa saja yang ingin Anda rekam, misalnya
Segment::track(array( "userId" => "f4ca124298", "event" => "Article Bookmarked", "properties" => array( "title" => "Snow Fall", "subtitle" => "The Avalanche at Tunnel Creek", "author" => "John Branch" ) ));
Panggilan Segment::track(array( "userId" => "f4ca124298", "event" => "Signed Up", "properties" => array( "plan" => "Enterprise" ) )); _2 memiliki bidang-bidang berikut
Segment::identify(array( "userId" => "2sfjej334", "traits" => array( "email" => $user->email, "name" => $user->name, "friends" => 25 ) )); 2 StringID untuk pengguna ini di basis data Anda. Segment::track(array( "userId" => "f4ca124298", "event" => "Signed Up", "properties" => array( "plan" => "Enterprise" ) )); 7 StringNama acara yang Anda lacak. Kami merekomendasikan nama yang dapat dibaca manusia seperti Lagu Dimainkan atau Status Diperbarui. Segment::track(array( "userId" => "f4ca124298", "event" => "Signed Up", "properties" => array( "plan" => "Enterprise" ) )); 8 Array, opsionalA hash properti untuk acara tersebut. Jika peristiwa tersebut adalah Produk Ditambahkan ke keranjang, acara tersebut mungkin memiliki properti seperti Segment::track(array( "userId" => "f4ca124298", "event" => "Signed Up", "properties" => array( "plan" => "Enterprise" ) )); 9 atau Segment::track(array( "userId" => "f4ca124298", "event" => "Article Bookmarked", "properties" => array( "title" => "Snow Fall", "subtitle" => "The Avalanche at Tunnel Creek", "author" => "John Branch" ) )); 0. Segment::identify(array( "userId" => "2sfjej334", "traits" => array( "email" => $user->email, "name" => $user->name, "friends" => 25 ) )); 7 String, opsionalJika Anda ingin melacak pengguna secara anonim, Anda dapat menyertakan ID Anonim alih-alih ID PenggunaSegment::identify(array( "userId" => "2sfjej334", "traits" => array( "email" => $user->email, "name" => $user->name, "friends" => 25 ) )); 8 Nomor, opsionalJumlah detik sejak zaman unix (Segment::identify(array( "userId" => "2sfjej334", "traits" => array( "email" => $user->email, "name" => $user->name, "friends" => 25 ) )); 9) menunjukkan kapan identifikasi terjadi. Jika identifikasi baru saja terjadi, biarkan saja dan kami akan menggunakan waktu server. Jika Anda mengimpor data dari masa lalu, pastikan Anda memberikan Segment::identify(array( "userId" => "2sfjej334", "traits" => array( "email" => $user->email, "name" => $user->name, "friends" => 25 ) )); 8. Segment::track(array( "userId" => "f4ca124298", "event" => "Signed Up", "properties" => array( "plan" => "Enterprise" ) )); 1 Array, opsionalSebuah objek yang berisi sejumlah pilihan atau konteks tentang permintaan. Untuk melihat referensi lengkap kunci yang didukung, periksa diTemukan detail tentang praktik terbaik dalam penamaan peristiwa serta payload metode Segment::track(array( "userId" => "f4ca124298", "event" => "Signed Up", "properties" => array( "plan" => "Enterprise" ) )); 2 di Spesifikasi kami
Halaman
Metode Segment::track(array( "userId" => "f4ca124298", "event" => "Article Bookmarked", "properties" => array( "title" => "Snow Fall", "subtitle" => "The Avalanche at Tunnel Creek", "author" => "John Branch" ) )); _7 memungkinkan Anda merekam tampilan halaman di situs web Anda, bersama dengan informasi tambahan opsional tentang halaman yang sedang dilihat
Jika Anda menggunakan penyiapan sisi klien kami yang digabungkan dengan pustaka PHP, panggilan halaman sudah dilacak untuk Anda secara default. Namun, jika Anda ingin merekam tampilan halaman Anda sendiri secara manual dan tidak menggunakan pustaka sisi klien kami, baca terus
Contoh Segment::track(array( "userId" => "f4ca124298", "event" => "Article Bookmarked", "properties" => array( "title" => "Snow Fall", "subtitle" => "The Avalanche at Tunnel Creek", "author" => "John Branch" ) )); _7 panggilan
Segment::page(array( "userId" => $user->id, "category" => "Docs", "name" => "PHP library", "properties" => array( "url" => "//segment.com/libraries/php/" ) ));
Panggilan Segment::track(array( "userId" => "f4ca124298", "event" => "Article Bookmarked", "properties" => array( "title" => "Snow Fall", "subtitle" => "The Avalanche at Tunnel Creek", "author" => "John Branch" ) )); _7 memiliki bidang-bidang berikut
Segment::identify(array( "userId" => "2sfjej334", "traits" => array( "email" => $user->email, "name" => $user->name, "friends" => 25 ) )); 2 StringID untuk pengguna ini di basis data Anda. Segment::page(array( "userId" => $user->id, "category" => "Docs", "name" => "PHP library", "properties" => array( "url" => "//segment.com/libraries/php/" ) )); 1 String, opsionalKategori halaman. Berguna untuk hal-hal seperti e-niaga di mana banyak halaman mungkin berada di bawah kategori yang lebih besar. Catatan. jika Anda hanya meneruskan satu string ke Segment::track(array( "userId" => "f4ca124298", "event" => "Article Bookmarked", "properties" => array( "title" => "Snow Fall", "subtitle" => "The Avalanche at Tunnel Creek", "author" => "John Branch" ) )); _7 kami menganggap itu adalah # set up our Segment tracking and # alias to Analytics for convenience class_alias('Segment', 'Analytics'); Segment::init("YOUR_WRITE_KEY"); 9, bukan Segment::page(array( "userId" => $user->id, "category" => "Docs", "name" => "PHP library", "properties" => array( "url" => "//segment.com/libraries/php/" ) )); 1. Anda harus menyertakan # set up our Segment tracking and # alias to Analytics for convenience class_alias('Segment', 'Analytics'); Segment::init("YOUR_WRITE_KEY"); _9 jika Anda ingin mengirim Segment::page(array( "userId" => $user->id, "category" => "Docs", "name" => "PHP library", "properties" => array( "url" => "//segment.com/libraries/php/" ) )); 1. # set up our Segment tracking and # alias to Analytics for convenience class_alias('Segment', 'Analytics'); Segment::init("YOUR_WRITE_KEY"); 9 String, opsionalNama halaman, misalnya Signup atau Home. Segment::track(array( "userId" => "f4ca124298", "event" => "Signed Up", "properties" => array( "plan" => "Enterprise" ) )); 8 Objek, opsionalKamus properti halaman. Segmen secara otomatis mengirimkan Segment::page(array( "userId" => $user->id, "category" => "Docs", "name" => "PHP library", "properties" => array( "url" => "//segment.com/libraries/php/" ) )); _9, Segment::group(array( "userId" => $user->id, "groupId" => $group->id, "traits" => array( "name" => $group->name, "size" => $group->size ); )); 0, Segment::group(array( "userId" => $user->id, "groupId" => $group->id, "traits" => array( "name" => $group->name, "size" => $group->size ); )); 1 dan Segment::group(array( "userId" => $user->id, "groupId" => $group->id, "traits" => array( "name" => $group->name, "size" => $group->size ); )); 2, tetapi Anda juga dapat menambahkan milik Anda sendiri. Segment::identify(array( "userId" => "2sfjej334", "traits" => array( "email" => $user->email, "name" => $user->name, "friends" => 25 ) )); 7 String, opsionalJika Anda ingin melacak pengguna secara anonim, Anda dapat menyertakan ID Anonim alih-alih ID PenggunaSegment::track(array( "userId" => "f4ca124298", "event" => "Signed Up", "properties" => array( "plan" => "Enterprise" ) )); 1 Array, opsionalSebuah objek yang berisi sejumlah opsi atau konteks tentang permintaan. Untuk melihat referensi lengkap kunci yang didukung, periksa diTemukan detail tentang muatan Segment::track(array( "userId" => "f4ca124298", "event" => "Article Bookmarked", "properties" => array( "title" => "Snow Fall", "subtitle" => "The Avalanche at Tunnel Creek", "author" => "John Branch" ) )); _7 di Spesifikasi kami
Kelompok
Segment::group(array( "userId" => $user->id, "groupId" => $group->id, "traits" => array( "name" => $group->name, "size" => $group->size ); )); 6 memungkinkan Anda mengaitkan an dengan grup. Grup dapat berupa perusahaan, organisasi, akun, proyek, atau tim. Ini juga memungkinkan Anda merekam sifat khusus tentang grup, seperti industri atau jumlah karyawan
Ini berguna untuk alat seperti Intercom, Preact dan Totango, karena mengikat pengguna ke grup pengguna lain
Contoh Segment::group(array( "userId" => $user->id, "groupId" => $group->id, "traits" => array( "name" => $group->name, "size" => $group->size ); )); _6 panggilan
Segment::group(array( "userId" => $user->id, "groupId" => $group->id, "traits" => array( "name" => $group->name, "size" => $group->size ); ));
Panggilan Segment::group(array( "userId" => $user->id, "groupId" => $group->id, "traits" => array( "name" => $group->name, "size" => $group->size ); )); _6 memiliki bidang-bidang berikut
Segment::identify(array( "userId" => "2sfjej334", "traits" => array( "email" => $user->email, "name" => $user->name, "friends" => 25 ) )); 2 StringID untuk pengguna ini di basis data Anda. Segment::alias(array( "previousId" => $previousId, "userId" => $userId )) 0 StringID untuk grup yang akan diasosiasikan dengan pengguna. Segment::identify(array( "userId" => "2sfjej334", "traits" => array( "email" => $user->email, "name" => $user->name, "friends" => 25 ) )); 3 Larik, opsionalSuatu larik yang berisi a ciri-ciri yang harus diberi tag pada grup. Ini mungkin hal-hal seperti # set up our Segment tracking and # alias to Analytics for convenience class_alias('Segment', 'Analytics'); Segment::init("YOUR_WRITE_KEY"); 9 grup atau ________69______3Segment::identify(array( "userId" => "2sfjej334", "traits" => array( "email" => $user->email, "name" => $user->name, "friends" => 25 ) )); 7 String, opsionalJika Anda ingin melacak pengguna secara anonim, Anda dapat menyertakan ID Anonim alih-alih ID PenggunaSegment::track(array( "userId" => "f4ca124298", "event" => "Signed Up", "properties" => array( "plan" => "Enterprise" ) )); 1 Array, opsionalSebuah objek yang berisi sejumlah opsi atau konteks tentang permintaan. Untuk melihat referensi lengkap kunci yang didukung, periksa diTemukan detail lebih lanjut tentang Segment::group(array( "userId" => $user->id, "groupId" => $group->id, "traits" => array( "name" => $group->name, "size" => $group->size ); )); _6 termasuk muatan Segment::group(array( "userId" => $user->id, "groupId" => $group->id, "traits" => array( "name" => $group->name, "size" => $group->size ); )); 6 di Spesifikasi kami
Alias
Segment::alias(array( "previousId" => $previousId, "userId" => $userId )) _8 adalah bagaimana Anda mengasosiasikan satu identitas dengan yang lain. Ini adalah metode tingkat lanjut, tetapi diperlukan untuk berhasil mengelola identitas pengguna di beberapa tujuan kami
Di dalamnya digunakan untuk mengasosiasikan pengguna anonim dengan pengguna yang teridentifikasi setelah mereka mendaftar. Karena jika pengguna Anda mengganti ID, Anda dapat menggunakan Segment::alias(array( "previousId" => $previousId, "userId" => $userId )) 8 untuk mengganti nama Segment::identify(array( "userId" => "2sfjej334", "traits" => array( "email" => $user->email, "name" => $user->name, "friends" => 25 ) )); 2
Contoh Segment::alias(array( "previousId" => $previousId, "userId" => $userId )) _8 panggilan
Segment::alias(array( "previousId" => $previousId, "userId" => $userId ))
Panggilan Segment::alias(array( "previousId" => $previousId, "userId" => $userId )) _8 memiliki bidang-bidang berikut
Segment::identify(array( "userId" => "2sfjej334", "traits" => array( "email" => $user->email, "name" => $user->name, "friends" => 25 ) )); 2 StringID untuk pengguna ini di basis data Anda. # the anonymous user does actions ... Segment::track(array( "userId" => "anonymous_user", "event" => "Anonymous Event" )); # the anonymous user signs up and is aliased Segment::alias(array( "previousId" => "anonymous_user", "userId" => "identified@example.com" )); # the identified user is identified Segment::identify(array( "userId" => "identified@example.com", "traits" => array( "plan" => "Free" ) )); # the identified user does actions ... Segment::track(array( "userId" => "identified@example.com", "event" => "Identified Action" )); 4 StringID sebelumnya untuk alias dariBerikut adalah contoh lengkap bagaimana kita dapat menggunakan panggilan Segment::alias(array( "previousId" => $previousId, "userId" => $userId )) 8
# the anonymous user does actions ... Segment::track(array( "userId" => "anonymous_user", "event" => "Anonymous Event" )); # the anonymous user signs up and is aliased Segment::alias(array( "previousId" => "anonymous_user", "userId" => "identified@example.com" )); # the identified user is identified Segment::identify(array( "userId" => "identified@example.com", "traits" => array( "plan" => "Free" ) )); # the identified user does actions ... Segment::track(array( "userId" => "identified@example.com", "event" => "Identified Action" ));
Untuk detail lebih lanjut tentang Segment::alias(array( "previousId" => $previousId, "userId" => $userId )) _8 termasuk payload panggilan ________69______8, lihat Spesifikasi kami
Impor Historis
Anda dapat mengimpor data historis dengan menambahkan argumen Segment::identify(array( "userId" => "2sfjej334", "traits" => array( "email" => $user->email, "name" => $user->name, "friends" => 25 ) )); 8 ke salah satu pemanggilan metode Anda. Ini dapat membantu jika Anda baru saja beralih ke Segmen
Histori impor hanya dapat dilakukan ke tujuan yang dapat menerima data stempel waktu historis. Sebagian besar alat analitik seperti Mixpanel, Amplitudo, Kissmetrics, dll. dapat menangani jenis data itu dengan baik. Salah satu tujuan umum yang tidak menerima data historis adalah Google Analytics karena API mereka tidak dapat menerima data historis
Catatan. Jika Anda melacak hal-hal yang sedang terjadi saat ini, tinggalkan Segment::identify(array( "userId" => "2sfjej334", "traits" => array( "email" => $user->email, "name" => $user->name, "friends" => 25 ) )); 8 dan server kami akan mencatat waktu permintaan untuk Anda
Memilih Tujuan
Panggilan Segment::alias(array( "previousId" => $previousId, "userId" => $userId )) 8, Segment::group(array( "userId" => $user->id, "groupId" => $group->id, "traits" => array( "name" => $group->name, "size" => $group->size ); )); 6, # set up our Segment tracking and # alias to Analytics for convenience class_alias('Segment', 'Analytics'); Segment::init("YOUR_WRITE_KEY"); 6, Segment::track(array( "userId" => "f4ca124298", "event" => "Article Bookmarked", "properties" => array( "title" => "Snow Fall", "subtitle" => "The Avalanche at Tunnel Creek", "author" => "John Branch" ) )); 7 dan Segment::track(array( "userId" => "f4ca124298", "event" => "Signed Up", "properties" => array( "plan" => "Enterprise" ) )); 2 semuanya dapat diteruskan array require_once("/path/to/analytics-php/lib/Segment.php"); use Segment\Segment; 05 yang memungkinkan Anda menghidupkan atau mematikan tujuan tertentu. Secara default semua tujuan diaktifkan
Dengan menggunakan larik require_once("/path/to/analytics-php/lib/Segment.php"); use Segment\Segment; _05, Anda dapat menentukan penyedia analitik mana yang Anda inginkan untuk setiap panggilan
Inilah panggilan Segment::track(array( "userId" => "f4ca124298", "event" => "Signed Up", "properties" => array( "plan" => "Enterprise" ) )); _2 dengan larik require_once("/path/to/analytics-php/lib/Segment.php"); use Segment\Segment; 05 yang ditampilkan
require_once("/path/to/analytics-php/lib/Segment.php"); use Segment\Segment; _0
Dalam hal ini, kami menetapkan bahwa kami ingin trek ini hanya menuju ke Mixpanel dan Pelanggan. io. require_once("/path/to/analytics-php/lib/Segment.php"); use Segment\Segment; _09 mengatakan bahwa tujuan tidak boleh diaktifkan kecuali ditentukan lain. require_once("/path/to/analytics-php/lib/Segment.php"); use Segment\Segment; _10 menyalakan Mixpanel, dll
Bendera tujuan peka huruf besar-kecil dan cocok dengan nama tujuan dalam dokumen (mis. e. “Platform Terbuka AdLearn”, “kagum. sm", "MailChimp", dll. )
Catatan
Tersedia di tingkat bisnis, pemfilteran lacak panggilan dapat dilakukan langsung dari UI Segmen di halaman skema sumber Anda. Kami merekomendasikan menggunakan UI jika memungkinkan karena ini adalah cara yang jauh lebih sederhana untuk mengelola filter Anda dan dapat diperbarui tanpa perubahan kode di pihak Anda
Jika Anda menggunakan paket kakek, peristiwa yang dikirim ke sisi server yang difilter melalui dasbor Segmen akan tetap diperhitungkan dalam penggunaan API Anda
Menyiram
require_once("/path/to/analytics-php/lib/Segment.php"); use Segment\Segment; _11 secara eksplisit memberi tahu runtime PHP untuk menyiram data yang dikirim ke server Segmen. Di sebagian besar konfigurasi, ini dilakukan secara otomatis saat runtime, tetapi beberapa penginstalan PHP tidak akan mengurusnya untuk Anda, jadi ada baiknya menelepon di akhir skrip Anda, untuk amannya
require_once("/path/to/analytics-php/lib/Segment.php"); use Segment\Segment; _1
Konfigurasi
Karena PHP adalah lingkungan berulir tunggal dan tidak berbagi apa pun, kami tidak dapat menggunakan antrean di utas terpisah atau kumpulan koneksi untuk menghapus pesan. Sebagai gantinya, Anda memiliki opsi untuk menentukan konsumen yang berbeda untuk mengajukan permintaan ke server kami
Ada beberapa opsi yang dapat Anda gunakan untuk mengonfigurasi klien guna membantu proses debug. Ini dapat diaktifkan dengan salah satu konsumen yang Anda gunakan
require_once("/path/to/analytics-php/lib/Segment.php"); use Segment\Segment; _2
require_once("/path/to/analytics-php/lib/Segment.php"); use Segment\Segment; _12 String, opsionalUntuk secara eksplisit menandai konsumen mana yang akan digunakan. Default ke require_once("/path/to/analytics-php/lib/Segment.php"); use Segment\Segment; _13. require_once("/path/to/analytics-php/lib/Segment.php"); use Segment\Segment; _14 Boolean, opsionalApakah akan mencatat pesan dan menunggu tanggapan. Membuat konsumen yang mengantre menjadi non-async, defaultnya adalah require_once("/path/to/analytics-php/lib/Segment.php"); use Segment\Segment; 15. require_once("/path/to/analytics-php/lib/Segment.php"); use Segment\Segment; 16 Boolean, opsionalApakah akan menggunakan SSL untuk sambungan, default ke require_once("/path/to/analytics-php/lib/Segment.php"); use Segment\Segment; 17. Karena ini menambah waktu pulang pergi yang signifikan, ubah ke require_once("/path/to/analytics-php/lib/Segment.php"); use Segment\Segment; 15 jika Anda membuat banyak permintaan. require_once("/path/to/analytics-php/lib/Segment.php"); use Segment\Segment; 19 Fungsi, opsionalA handler yang akan dipanggil pada kesalahan untuk membantu dalam debugging, require_once("/path/to/analytics-php/lib/Segment.php"); use Segment\Segment; 20Konsumen Lib-Curl
Konsumen lib-curl adalah pilihan yang andal untuk sumber volume rendah atau jika Anda menginginkan waktu respons yang cepat di bawah beban ringan. Pustaka berjalan secara sinkron, mengantri panggilan dan mengirimkannya secara berkelompok ke server Segmen. Secara default, ini terjadi setiap 100 panggilan, atau pada akhir penayangan halaman. Secara default, kami mengabaikan respons http untuk mengoptimalkan kecepatan perpustakaan, tetapi Anda dapat memilih untuk menunggu respons ini dengan mengaktifkan mode debug
Jika server Anda menangani lebih dari 20 permintaan per detik, Anda mungkin ingin melihat untuk mengoptimalkan kinerja
Maksimal require_once("/path/to/analytics-php/lib/Segment.php"); use Segment\Segment; _21 per permintaan batch dan require_once("/path/to/analytics-php/lib/Segment.php"); use Segment\Segment; 22 per panggilan
Batas API Pelacakan HTTP
API Pelacakan HTTP Segmen menerima permintaan batch hingga 500 KB. Untuk menghindari kesalahan dalam pembuatan peristiwa, pastikan ukuran muatan peristiwa individual tetap di bawah 32 KB
Konsumen lib-curl adalah pustaka PHP default Segmen, meskipun Anda masih dapat menginisialisasinya secara eksplisit dan mengatur ukuran antrean dan kumpulan dalam pengaturan inisialisasi pustaka
require_once("/path/to/analytics-php/lib/Segment.php"); use Segment\Segment; _3
Konsumen Fork-Curl
Konsumen fork-curl harus bekerja paling baik untuk kasus di mana Anda tidak dapat menggunakan soket persisten, atau ingin memastikan waktu respons yang cepat di bawah beban ringan. Ini bekerja dengan membuat antrean dalam memori yang melacak dan mengidentifikasi panggilan buffer. Antrean dikosongkan dengan membagi proses require_once("/path/to/analytics-php/lib/Segment.php"); use Segment\Segment; 23 asinkron yang mengirimkan permintaan batch. Secara default, ini terjadi setiap require_once("/path/to/analytics-php/lib/Segment.php"); use Segment\Segment; _24 panggilan, atau pada akhir penayangan halaman. Konsumen ini akan menelurkan proses terpisah untuk setiap permintaan yang melacak peristiwa. Jika server Anda menangani lebih dari 20 permintaan per detik, Anda mungkin ingin melihat
Untuk menginisialisasi konsumen secara eksplisit, gunakan require_once("/path/to/analytics-php/lib/Segment.php"); use Segment\Segment; _25 sebagai entri dalam larik require_once("/path/to/analytics-php/lib/Segment.php"); use Segment\Segment; 26 Anda
require_once("/path/to/analytics-php/lib/Segment.php"); use Segment\Segment; _4
require_once("/path/to/analytics-php/lib/Segment.php"); use Segment\Segment; _27 Nomor, opsionalUkuran maksimal antrean, default ke require_once("/path/to/analytics-php/lib/Segment.php"); use Segment\Segment; 28 item. require_once("/path/to/analytics-php/lib/Segment.php"); use Segment\Segment; _29 Nomor, opsionalBerapa banyak item yang akan dikirim dalam satu permintaan curl, default ke require_once("/path/to/analytics-php/lib/Segment.php"); use Segment\Segment; 24Konsumen Soket
Jika Anda tidak dapat menelurkan proses lain dari skrip PHP Anda, Anda dapat menggunakan konsumen soket, yang memungkinkan Anda membuat permintaan ke Segmen. Setiap kali melacak atau mengidentifikasi panggilan dibuat, itu akan memulai permintaan soket ke server kami. Permintaan soket hampir sama asinkronnya dengan PHP, di mana permintaan tersebut akan menulis data acara dan menutup koneksi sebelum menunggu tanggapan. Namun, jika server Anda menangani lebih dari 100 permintaan per detik atau tidak dapat menggunakan koneksi tetap, Anda mungkin ingin menggunakan salah satu konsumen lain sebagai gantinya.
Untuk menginisialisasi konsumen secara eksplisit, gunakan require_once("/path/to/analytics-php/lib/Segment.php"); use Segment\Segment; _31 sebagai entri dalam larik require_once("/path/to/analytics-php/lib/Segment.php"); use Segment\Segment; 26 Anda
require_once("/path/to/analytics-php/lib/Segment.php"); use Segment\Segment; _5
require_once("/path/to/analytics-php/lib/Segment.php"); use Segment\Segment; _33 Angka, opsionalJumlah detik untuk menunggu permintaan soket habis, default ke require_once("/path/to/analytics-php/lib/Segment.php"); use Segment\Segment; 34. require_once("/path/to/analytics-php/lib/Segment.php"); use Segment\Segment; 14 Boolean, opsionalApakah akan memeriksa respons untuk kesalahan, default ke require_once("/path/to/analytics-php/lib/Segment.php"); use Segment\Segment; 15. Ini akan membuat perpustakaan diblokir hingga respons diterima dari API, sehingga tidak disarankan untuk penggunaan produksi. require_once("/path/to/analytics-php/lib/Segment.php"); use Segment\Segment; 19 Fungsi, opsionalSebuah fungsi untuk menangani kesalahan, terutama berguna untuk debugging. Perhatikan bahwa jika mode debug tidak ditentukan, maka require_once("/path/to/analytics-php/lib/Segment.php"); use Segment\Segment; 19 hanya akan dipanggil pada kesalahan tingkat koneksi dan waktu habisFile Konsumen
Konsumen file adalah metode yang lebih berkinerja untuk membuat permintaan ke Segmen. Setiap kali melacak atau mengidentifikasi panggilan dibuat, itu akan merekam panggilan itu ke file log. File log kemudian diunggah “out of band” dengan menjalankan file require_once("/path/to/analytics-php/lib/Segment.php"); use Segment\Segment; 39 yang ditemukan di repositori github kami
Untuk menginisialisasi konsumen ini secara eksplisit, gunakan require_once("/path/to/analytics-php/lib/Segment.php"); use Segment\Segment; _40 sebagai entri dalam larik require_once("/path/to/analytics-php/lib/Segment.php"); use Segment\Segment; 26 Anda
require_once("/path/to/analytics-php/lib/Segment.php"); use Segment\Segment; _6
require_once("/path/to/analytics-php/lib/Segment.php"); use Segment\Segment; 42 String, opsionalLokasi untuk menulis file log, default ke require_once("/path/to/analytics-php/lib/Segment.php"); use Segment\Segment; 43Untuk mengunggah file log Anda ke segmen. com, cukup jalankan file require_once("/path/to/analytics-php/lib/Segment.php"); use Segment\Segment; _44 yang disertakan sebagai bagian dari repositori kami
require_once("/path/to/analytics-php/lib/Segment.php"); use Segment\Segment; _7
Kami merekomendasikan menjalankan ini sebagai bagian dari tugas cron setiap beberapa menit agar file log Anda tetap dapat dikelola ukurannya. Setiap kali require_once("/path/to/analytics-php/lib/Segment.php"); use Segment\Segment; 44 dijalankan, file log lama akan dihapus untuk Anda setelah selesai diproses
Cara termudah untuk melakukannya adalah membuat tugas cron baru untuk mengunggah file log Anda. Menggunakan default, tugas cron ini harus dijalankan sebagai pengguna-www. Anda harus menjalankan perintah berikut di terminal Anda, tetapi ubah lokasi skrip PHP untuk menunjuk ke require_once("/path/to/analytics-php/lib/Segment.php"); use Segment\Segment; 46 Anda
require_once("/path/to/analytics-php/lib/Segment.php"); use Segment\Segment; _8
Penyelesaian masalah
Kiat berikut sering kali membantu menyelesaikan masalah umum
Tidak ada acara di debugger saya
Periksa kembali apakah Anda telah mengikuti semua langkah di Quickstart
Pastikan Anda memanggil metode API Segmen setelah pustaka berhasil dipasang—, , dll
Pastikan aplikasi Anda tidak dimatikan sebelum peristiwa antrean lokal require_once("/path/to/analytics-php/lib/Segment.php"); use Segment\Segment; 49 didorong ke Segmen. Anda dapat memanggil require_once("/path/to/analytics-php/lib/Segment.php"); use Segment\Segment; _50 secara manual untuk memastikan antrean diproses sepenuhnya sebelum dimatikan
Tidak ada acara di alat akhir saya
Periksa kembali kredensial Anda untuk tujuan tersebut
Pastikan bahwa tujuan yang sedang Anda pecahkan dapat menerima panggilan API sisi server. Kompatibilitas ditampilkan di halaman dokumen tujuan dan di sheet di halaman Tujuan sumber Segmen Anda
Lihat dokumentasi tujuan untuk melihat apakah ada persyaratan lain untuk menggunakan metode dan tujuan yang Anda coba untuk bekerja
Perpustakaan Pihak Ketiga
Jika Anda hanya membutuhkan dukungan untuk PHP5, tim di Underground Elephant telah merilis perpustakaan pihak ke-3 berdasarkan Guzzle
Jika Anda menggunakan Laravel 4, teman kami di Catchet telah menulis pembungkusnya untuk Anda. Repo Dokumen dan GitHub dapat ditemukan di sini. https. //github. com/cachethq/Laravel-Segment
Halaman ini terakhir diubah. 20 Oktober 2022
Butuh bantuan?
Pertanyaan?
Kunjungi halaman Dukungan kami
Bantu sempurnakan dokumen ini
Edit halaman ini Minta perubahan dokumen
Apakah halaman ini membantu?
Ya
TIDAK
Terima kasih atas umpan balik Anda
Bisakah kita meningkatkan dokumen ini?
Memulai Segmen
Segmen adalah cara termudah untuk mengintegrasikan situs web & data aplikasi seluler Anda ke lebih dari 300 analitik dan alat pertumbuhan