یکپارچه‌سازی‌ها
Google Tag Manager (server-side)
کلیک‌ها و تبدیل‌ها را به‌صورت hitهای GA4 Measurement Protocol به کانتینر GTM سمت سرور خود بفرستید.
یکپارچه‌سازی Google Tag Manager هر کلیک ثبت‌شده در Letlink و هر تبدیل تأییدشده را به‌صورت hit در GA4 Measurement Protocol به کانتینر GTM سمت سرور شما می‌فرستد. وقتی رویداد به سرور تگ‌گذاری شما رسید، هر تگی در کانتینر می‌تواند روی آن عمل کند — GA4، Google Ads، Meta، یک انبار داده — بنابراین مقصدها را یک بار در GTM تنظیم می‌کنید نه برای هر ابزار جداگانه. در Growth و Ultimate در دسترس است.
آنچه نیاز دارید
- یک کانتینر سمت سرور در حال اجرا با آدرس HTTPS مخصوص خود، مثلاً
https://gtm.example.com. - یک کلاینت Measurement Protocol در آن کانتینر. GTM به‌طور پیش‌فرض آن را اضافه نمی‌کند.
- Measurement ID (
G-…) جریان وب GA4 که کانتینر به آن ارسال می‌کند.
آماده‌سازی کانتینر
- در کانتینر سرور خود، Clients → New را باز کنید و نوع کلاینت Measurement Protocol را انتخاب کنید.
- Activation Path را روی
/mp/collect(یا هر مسیری که ترجیح می‌دهید — همان مسیر را در Letlink وارد خواهید کرد) تنظیم و ذخیره کنید. - یک تگ Google Analytics: GA4 که با آن کلاینت فعال شود اضافه یا دوباره استفاده کنید، به‌علاوه هر تگ دیگری که می‌خواهید رویدادها به آن برسند، سپس کانتینر را Submit کنید.
اتصال آن به Letlink
- یکپارچه‌سازی‌ها ← Google Tag Manager (سمت سرور) را باز کنید. فقط مالکان و مدیران.
- URL سرور تگ‌گذاری (بدون مسیر)، Measurement ID و در صورت تغییر، مسیر کلاینت را وارد کنید.
- کلید محرمانه API اختیاری است. اگر تگ GA4 شما hitها را با Measurement Protocol secret به 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 به هم متصل کنید یا در تگ‌هایتان موارد تکراری را حذف کنید.
هیچ چیزی نمی‌رسد — چه چیزی را بررسی کنم؟
- URL سرور تگ‌گذاری باید HTTPS و از اینترنت در دسترس باشد. خطای
404معمولاً یعنی هیچ کلاینتی مسیر را نپذیرفته است: مسیر فعال‌سازی کلاینت Measurement Protocol را بررسی کنید. - حالت پیش‌نمایش فقط هنگام باز بودن درخواست‌ها را نشان می‌دهد. رویداد آزمایشی را پس از باز کردن آن ارسال کنید.
- تبدیل‌ها همیشه به این یکپارچه‌سازی ارسال می‌شوند، حتی وقتی فضای کاری تبدیل‌ها را به پلتفرم‌های تبلیغاتی ارسال نمی‌کند.