جمع‌آوری داده (لندر وب)

لندر (Lander) کتابخانه و SDK اختصاصی داده‌لند برای جمع‌آوری داده‌های رفتاری کلاینت است. این ابزار به عنوان جایگزینی برای گوگل تگ منیجر، امکان رهگیری خودکار و سفارشی رویدادها را در وب‌سایت‌ها فراهم می‌سازد. نمونه‌های عملی پیاده‌سازی در وب‌سایت dadelib.ir در دسترس است.

تنظیمات لندر وب

جهت دسترسی به این بخش، در صفحه مدیریت دیتاست و از نوار کناری، روی تنظیمات ماژول کلاینت مدنظر کلیک نموده و تب تنظیمات لندر (وب) را انتخاب فرمایید.

شیوه استفاده

لندر به صورت سلف‌هاستد (Self-Hosted) بر روی سرور سازمان میزبانی و لود می‌شود؛ بنابراین اجرای آن نیازی به ارسال درخواست دریافت اسکریپت به سرورهای داده‌لند ندارد و بدون نیاز به پیکربندی در سمت سرور راه‌اندازی می‌گردد. جهت پیاده‌سازی لندر، مراحل زیر را دنبال فرمایید:

<script>
  window.dadeLand = window.dadeLand || [];
</script>
<script src="/assets/dadeland/lander.js"></script>

رویدادهای خودکار

رویدادهای زیر به شکل خودکار و بدون نیاز به کدنویسی اضافی جمع‌آوری و ارسال می‌گردند:

مقادیر ارسالی

لندر به ازای تمامی رویدادها، اطلاعات زمینه‌ای زیر را به شکل خودکار یا بر اساس مقادیر موجود در حافظه مرورگر و کوکی ارسال می‌نماید:

انواع رویدادها

رویدادهای تعاملی فرانت‌اند در ۵ دسته‌بندی اصلی طبقه‌بندی شده‌اند:

مشاهده المان

این رویداد در صورت وجود دو شرط زیر ثبت می‌شود:

۱. وجود اتربیوت data-dl-view در المان: نام رویداد در ستون event به صورت ترکیب مقدار اتربیوت با پیشوند view_ ثبت می‌گردد.
۲. ورود ۱۰۰ درصد المان به Viewport: تریگر تنها با نمایش کامل المان در دید کاربر فعال می‌شود.

جهت ارسال پارامترهای سفارشی، اتربیوت data-dl-meta به صورت آبجکت JSON به المان اضافه می‌گردد:

<article class="border rounded-3xl bg-white" 
data-dl-view="card" data-dl-meta='{"name":"Deep Learning","rate":4.4}'>

خروجی ارسالی این المان به شکل زیر در انبار داده می‌نشیند:

{
  "event": "view_card",
  "meta": {"name":"Deep Learning","rate":4.4}
}

• الگوی پیشنهادی: مقدار data-dl-view با حروف کوچک و خط زیرین (snake_case) و بدون کلمه view درج شود؛ همچنین مقادیر data-dl-meta ساختار مسطح (Flat JSON) داشته باشند و اتربیوت بر روی المان والد معنادار در DOM قرار گیرد.

رویداد کلیک

شرط ارسال این رویداد، وجود اتربیوت data-dl-click در المان کلیک‌شده یا والد آن است. مقدار اتربیوت همراه با پیشوند click_ در ستون event ذخیره می‌شود:

<a href="/product/practical-sql" class="text-brand items-center"
data-dl-click="card" data-dl-meta='{"name":"Deep Learning","price":120000}'>

خروجی ارسالی رویداد کلیک:

{
  "event": "click_card",
  "meta": {"name":"Deep Learning","price":120000}
}

• الگوی پیشنهادی: اتربیوت در بالاترین المان والد مرتبط با محل کلیک قرار گیرد تا با کلیک روی متن یا آیکون‌های داخلی نیز رهگیری شود؛ نام رویداد به صورت snake_case و داده‌های متا به صورت مسطح باشند.

رویداد پخش مدیا

شرط ارسال این داده، درج اتربیوت data-dl-meta در تگ‌های <video> یا <audio> است:

<video class="w-full rounded-2xl"
data-dl-meta='{"name":"Video Title","duration":10000}'>

نام رویدادهای پخش مدیا سیستمی است و به صورت خودکار بر اساس جدول زیر ارسال می‌گردد:

خروجی آغاز پخش مدیا:

{
  "event": "start_media",
  "meta": {"name":"Video Title","duration":10000,"type":"video"}
}

• الگوی پیشنهادی: ارسال نام مدیا (name) و کل مدت زمان به میلی‌ثانیه (duration) در متای رویداد توصیه می‌گردد.

رویداد کاستوم

رویدادهایی که دارای تریگر اختصاصی هستند یا نیازمند دریافت تایید از بکند می‌باشند (نظیر افزودن به سبد خرید، نهایی‌سازی پرداخت یا ارسال فرم)، از طریق متد dadeLand.push (مشابه dataLayer) ارسال می‌گردند:

<script>
window.dadeLand.push({
  event: 'purchase',
  transaction_id: 'TXN-1773053889',
  meta: {
    quantity: 3,
    total_amount: 1500000
  }
});
</script>

پارامترهای قابل ارسال در رویداد کاستوم:

• الگوی پیشنهادی: نام رویداد با فرمت snake_case درج شود، مقادیر متا ساختار مسطح (Flat) داشته باشند و اطلاعات مالی و هویتی حساس به جای کلاینت، از طریق سرورساید به جداول اختصاصی انبار داده منتقل گردند.