ឯកសារ

ដំឡើង tag

ការដំឡើងស្តង់ដារគឺ script async តែមួយមុន tag body បិទនៃរាល់ទំព័រដែលអ្នកចង់វាស់ស្ទង់។ ជំនួស XXXX ដោយ site_id ដែលបង្ហាញនៅទំព័រគ្រប់គ្រងគេហទំព័ររបស់អ្នក។

<script async src="https://9ping.dev/hm.min.js" data-sid="XXXX"></script>

ប្រសិនបើអ្នកប្រើ Google Tag Manager បង្កើត Custom HTML tag ថ្មី បិទភ្ជាប់ snippet ដូចគ្នា ហើយកំណត់ trigger ទៅ All Pages។

សម្រាប់អ្នកចូលមើលដែលបានបិទ JavaScript ឬសម្រាប់បរិបទអ៊ីមែល និង AMP បន្ថែមរូបភាព pixel តែមួយជាជម្រើសបម្រុងក្នុង noscript tag — អ្នកនឹងចាប់យកយ៉ាងហោចណាស់ page view។

<noscript><img src="https://9ping.dev/collect.php?sid=XXXX&type=pv" width="1" height="1" alt=""></noscript>

សម្រាប់ single-page apps (React, Vue, Next, Nuxt និងមិត្តភក្តិ) បញ្ចូល script ម្តងនៅពេលចាប់ផ្តើម — tag រាប់ page view និម្មិតដោយស្វ័យប្រវត្តិនៅរាល់ការផ្លាស់ប្តូរផ្លូវខាងអតិថិជន។

(function(){var s=document.createElement('script');s.async=true;s.src='https://9ping.dev/hm.min.js';s.dataset.sid='XXXX';document.head.appendChild(s);})();

ព្រឹត្តិការណ៍ផ្ទាល់ខ្លួន

នៅពេល tag បានផ្ទុក អនុគមន៍ window.tj សកលអាចប្រើបានសម្រាប់ព្រឹត្តិការណ៍ ad-hoc ដូចជាចុចប៊ូតុង ការដាក់ស្នើទម្រង់ និងការទាញយក។ ហត្ថលេខាគឺ category, action, label។

tj('event', 'button', 'click', 'download_whitepaper');

សម្រាប់ router ដែលអ្នកគ្រប់គ្រងដោយខ្លួនឯង អ្នកអាចបាញ់ page view ច្បាស់លាស់ដោយហៅ tj('pv')។ សម្រាប់ការចុចមុន tag stub ដំបូងតម្រៀបការហៅ ហើយចាក់សារឡើងវិញនៅពេល script ផ្ទុក ដូច្នេះអ្នកមិនចាំបាច់រុំ handler របស់អ្នកក្នុង setTimeout ទេ។

ផ្ទៀងផ្ទាត់ភាពជាម្ចាស់គេហទំព័រ

ការផ្ទៀងផ្ទាត់ត្រូវបានណែនាំមុនពេលអ្នកបើករបាយការណ៍កម្រិតខ្ពស់។ ការគ្រប់គ្រងគេហទំព័របង្ហាញវិធីសាស្ត្របួនអាចផ្លាស់ប្តូរបានសម្រាប់គេហទំព័រនីមួយៗ — ជ្រើសរើសណាមួយដែលងាយស្រួលបំផុត។

វិធីសាស្ត្រទីមួយ — ឯកសារ HTML។ ទាញយក tj-verify-TOKEN.html ពី dashboard ហើយផ្ទុកវាឡើងទៅ root គេហទំព័ររបស់អ្នក។

វិធីសាស្ត្រទីពីរ — meta tag។ បិទភ្ជាប់ meta tag តែមួយចូលក្នុង head នៃទំព័រដើមរបស់អ្នក។

<meta name="tj-site-verification" content="YOUR_TOKEN">

វិធីសាស្ត្រទីបី — លេខកូដតាមដាន។ ប្រសិនបើទំព័រដើមដំណើរការ tag របស់យើងរួចហើយ ហើយបានទទួលការចូលមើលយ៉ាងហោចណាស់មួយ វាត្រូវបានផ្ទៀងផ្ទាត់ដោយស្វ័យប្រវត្តិ។ វិធីសាស្ត្រទីបួន — DNS TXT។ បន្ថែម tj-site-verification=YOUR_TOKEN ជាកំណត់ត្រា TXT នៅលើដែន apex។

Open API និងការដាក់ឱ្យដំណើរការធំៗ

រាល់គណនីទាំងអស់ផ្តល់នូវសោ API ផ្ទាល់ខ្លួន (បុព្វបទ tjk_) ដែលអនុញ្ញាតឱ្យអ្នករាយបញ្ជីគេហទំព័រ បង្កើតគេហទំព័រ ទាញ snippet tag និងអាន​ស្ថិតិតាម HTTPS។ ផ្ទៀងផ្ទាត់ដោយផ្ញើ header X-API-Key។

curl -H "X-API-Key: $TJ_KEY" "https://9ping.dev/openapi.php?action=sites"

ដើម្បីដាក់ឱ្យដំណើរការ tag ឆ្លងកាត់ក្រុមគេហទំព័រទាំងមូលពីប្រអប់ Linux តែមួយ ទាញយក tj-deploy.sh ពីការគ្រប់គ្រងគេហទំព័រ។ វាចុះឈ្មោះដែននីមួយៗតាម API បង្កើត snippet tag ហើយអាចបញ្ចូលវាជាជម្រើសចូលក្នុង template របស់អ្នក។

Open API គាំទ្រការបង្កើតគេហទំព័រធំៗពីឯកសារអត្ថបទ ដែលបន្ទាត់នីមួយៗគឺជាដែនទទេ ឬ domain|name។ អ្នកអាចរកបញ្ជីសកម្មភាពពេញលេញនៅក្នុងឯកសារយោង API។

សុវត្ថិភាព៖ ការផ្ទៀងផ្ទាត់ពីរជំហាន និងលេខកូដសង្គ្រោះ

គណនី dashboard ទាំងអស់មានការផ្ទៀងផ្ទាត់ពីរជំហានដែលបង្ខំជាមួយ Google Authenticator (TOTP, RFC 6238)។ នៅពេលចុះឈ្មោះ អ្នកទទួលបានលេខកូដសង្គ្រោះម្តងគត់ដប់ — រក្សាទុកវានៅកន្លែងសុវត្ថិភាព ប្រសិនបើអ្នកបាត់ទូរស័ព្ទរបស់អ្នក ទាំងនេះគឺជាមធ្យោបាយតែមួយគត់របស់អ្នកដើម្បីត្រឡប់មកវិញ។

លេខកូដសង្គ្រោះប្រើតែម្តងគត់ និងរក្សាទុកជា hash នៅលើ server។ ដើម្បីសង្គ្រោះ ប្រើតំណ Recover with a recovery code នៅទំព័រចូល លំហូរសង្គ្រោះនឹងអនុញ្ញាតឱ្យអ្នកកំណត់ពាក្យសម្ងាត់ថ្មី និងភ្ជាប់ authenticator ឡើងវិញ។

ផ្លាស់ប្តូរពី GA4 ឬ Baidu Tongji

អ្នកមិនចាំបាច់ដក tag ដែលមានស្រាប់របស់អ្នកដើម្បីសាក 9ping Analytics ទេ — tag ទាំងពីរអាចដំណើរការក្បែរគ្នា និងរាយការណ៍ដោយឯករាជ្យ ដែលជាវិធីសុវត្ថិភាពបំផុតក្នុងការប្រៀបធៀបលេខសម្រាប់មួយសប្តាហ៍មុនពេលអ្នកប្តូរ។

ដើម្បីផ្លាស់ប្តូរ បន្ថែមដែនរបស់អ្នកនៅការគ្រប់គ្រងគេហទំព័រ បិទភ្ជាប់ tag មួយបន្ទាត់មុន tag body បិទ (ឬរុញវាតាម GTM) ឃ្លាំមើលផ្ទាំងពេលវេលាជាក់ស្តែងភ្លឺឡើង ហើយដក tag ចាស់ចេញនៅពេលអ្នករួចរាល់។

ព្រឹត្តិការណ៍ផ្ទាល់ខ្លួនបកប្រែបានច្បាស់៖ ព្រឹត្តិការណ៍ GA4 ដែលមានឈ្មោះ ឧទាហរណ៍ signup ជាមួយប៉ារ៉ាម៉ែត្រ method និង plan ក្លាយជា tj('event', 'signup', method, plan)។ គោលដៅ និង funnel ត្រូវបានដោះស្រាយក្នុង 9ping ដោយ tag ព្រឹត្តិការណ៍ពាក់ព័ន្ធ មិនមានការកំណត់រចនាសម្ព័ន្ធគោលដៅដាច់ដោយឡែកត្រូវរក្សាទេ។