التكاملات
Google Analytics 4
Measurement Protocol من جهة الخادم: تصبح كل نقرة مسجّلة حدث link_click.
في Solo وGrowth وUltimate، يمكن لـ Letlink إرسال حدث GA4 لكل نقرة مسجّلة باستخدام Measurement Protocol. لا يعمل شيء في متصفح الزائر، لذا يصل الحدث حتى عندما لا يحمّل الزائر بكسل موقعك — بما في ذلك عمليات مسح QR وعروض الويب داخل التطبيقات وإعادة التوجيه الفورية.
جمع بيانات الاعتماد
- في Google Analytics، افتح Admin ← Data streams ← مسار بيانات الويب الخاص بك.
- انسخ معرّف القياس (
G-متبوعًا بحروف وأرقام). - افتح Measurement Protocol API secrets وأنشئ سرًا. انسخه مرة واحدة؛ فلن يعرضه GA4 مرة أخرى.
الصقها في Letlink
- انتقل إلى التكاملات ← Google Analytics 4. للمالكين والمشرفين فقط.
- الصق معرّف القياس وسر API، ثم احفظ.
- لقطع الاتصال، امسح Measurement ID واحفظ (اترك السر فارغًا).
الحدث
ترسل كل نقرة مسجّلة حدثًا باسم link_click مع engagement_time_msec=1. يكون client_id في GA4 هو بصمة الجهاز عند توفرها، وإلا click.{visit_id}. المعلمات:
| المعلمة | المعنى |
|---|---|
| short_code | الجزء الأخير من الرابط القصير |
| link_type | direct أو utm أو appstore أو instagram أو mobile أو device |
| variation | اسم اختبار التقسيم، أو qr لعمليات المسح، أو فارغ |
| device_type | مثل desktop وsmartphone |
| browser | عائلة المتصفح |
| session_id | المعرّف الرقمي للزيارة، ليتعامل GA4 مع كل نقرة كجلسة مستقلة |
رؤيتها في GA4
قد تستغرق الأحداث حتى 24 ساعة لتظهر في التقارير العادية. للتحقق بشكل أسرع، استخدم Admin ← DebugView بعد إرسال زيارات، أو Realtime إذا كانت أحداث Measurement Protocol مضمّنة في موقعك. حدّد short_code وvariation كأبعاد مخصصة إذا أردتها في الاستكشافات.
ما ليس عليه هذا
- لا يحمّل gtag.js عند إعادة التوجيه.
- لا يربط النقرة بجلسة لاحقة على موقع الوجهة. معرّف العميل هو بصمة Letlink، لا ملف تعريف الارتباط
_gaالخاص بموقعك. - لا يعمل عند بلوغ الحد الشهري للنقرات أو عندما يمنع حد زيارات الجهاز إعادة التوجيه.