التكاملات
Google Tag Manager (server-side)
أرسل النقرات والتحويلات إلى حاوية GTM من جهة الخادم كزيارات GA4 Measurement Protocol.
يرسل تكامل Google Tag Manager كل نقرة مسجّلة في Letlink، وكل تحويل معتمد، إلى حاوية GTM من جهة الخادم الخاصة بك كزيارة GA4 Measurement Protocol. بمجرد وصول الحدث إلى خادم الوسوم، يمكن لأي وسم في الحاوية التصرف بناءً عليه — GA4 أو Google Ads أو Meta أو مستودع بيانات — فتضبط الوجهات مرة واحدة في GTM بدلًا من ضبطها لكل أداة. متاح في Growth وUltimate.
ما تحتاجه
- حاوية من جهة الخادم قيد التشغيل بعنوان HTTPS خاص بها، مثل
https://gtm.example.com. - عميل Measurement Protocol في تلك الحاوية. لا يضيف GTM واحدًا افتراضيًا.
- معرّف القياس (
G-…) لتدفق ويب GA4 الذي تمرّر إليه الحاوية.
جهّز الحاوية
- في حاوية الخادم، افتح Clients → New واختر نوع العميل Measurement Protocol.
- عيّن Activation Path إلى
/mp/collect(أو أي مسار تفضّله — ستُدخل المسار نفسه في Letlink) واحفظ. - أضف وسم Google Analytics: GA4 أو أعد استخدامه بحيث يُشغّله ذلك العميل، إضافةً إلى أي وسوم أخرى تريد أن تصلها الأحداث، ثم Submit الحاوية.
اربطه بـ Letlink
- افتح التكاملات ← Google Tag Manager (من جهة الخادم). للمالكين والمسؤولين فقط.
- أدخل رابط خادم الوسوم (دون مسار) ومعرّف القياس، ومسار العميل إن كنت قد غيّرته.
- سر API اختياري. الصق سر GA4 Measurement Protocol إذا كان وسم GA4 لديك يمرّر الزيارات إلى Google به.
- احفظ واضغط إرسال حدث تجريبي، ثم راقب وصول الطلب في وضع المعاينة للحاوية.
ما نرسله
طلب POST إلى <tagging server><path>?measurement_id=G-… بجسم GA4 Measurement Protocol قياسي. client_id هو بصمة الجهاز نفسها التي تستخدمها لوحة التحكم، ويوضع بلد الزائر في user_location عند معرفته.
| حدث Letlink | حدث GA4 | معاملات إضافية |
|---|---|---|
| نقرة | link_click |
short_code، link_type، variation، destination_url، قيم UTM، click_id |
| بيع | purchase |
transaction_id (معرّف طلبك)، value، currency |
| عميل محتمل | generate_lead |
value، currency عند إرسالهما |
| التسجيل | sign_up |
method = short_link |
| مخصص | اسم حدثك، منقّحًا وفق قواعد GA4 | value، currency عند إرسالهما |
يحمل كل تحويل أيضًا conversion_id (conv-<id>) وclick_id للنقرة التي جاء منها، لتتمكن من ربطهما في BigQuery أو إزالة التكرار في وسومك.
لا شيء يصل — ما الذي يجب أن أتحقق منه؟
- يجب أن يكون رابط خادم الوسوم HTTPS وقابلًا للوصول من الإنترنت. الرمز
404يعني غالبًا أنه لا يوجد عميل يطالب بالمسار: تحقق من مسار التفعيل لعميل Measurement Protocol. - لا يعرض وضع المعاينة الطلبات إلا أثناء فتحه. أرسل حدث الاختبار بعد فتحه.
- تُرسل التحويلات دائمًا إلى هذا التكامل، حتى عندما لا تمرّر مساحة العمل التحويلات إلى منصات الإعلانات.