پلاگین وردپرس Metrix
این راهنما به شما کمک میکند تا پلاگین وردپرس Metrix را نصب کرده و آن را برای ارسال داده و ارائه اعلانهای پوش وب به کاربران وبسایت خود پیکربندی کنید.
پیشنیازها
قبل از شروع، مطمئن شوید که موارد زیر را دارید:
- وردپرس نسخه 5.0 یا بالاتر نصب شده باشد
- دسترسی مدیر به داشبورد وردپرس خود
- یک حساب Metrix با دسترسی به داشبورد خود
- App ID و API Key خود را از Metrix (برای راهاندازی اولیه الزامی است)
- کلید عمومی (Public Key) خود را برای اعلانهای پوش (فقط در صورت فعالسازی اعلانهای پوش الزامی است)
مرحله 1: دانلود پلاگین
آخرین نسخه پلاگین Metrix را از لینک زیر دانلود کنید:
https://cdn.metrix.ir/sdk/wordpress-plugin/metrix-2.7.3.1.zipتوجه: شماره نسخه از فرمت
WEB_SDK_VERSION.PLUGIN_UPDATESپیروی میکند. به عنوان مثال،2.7.3.1نشاندهنده Web SDK نسخه 2.7.3 با یک بهروزرسانی پلاگین است.
مرحله 2: نصب پلاگین
- به داشبورد مدیریت وردپرس خود وارد شوید
- به پلاگینها → افزودن جدید بروید
- روی دکمه بارگذاری پلاگین کلیک کنید
- فایل
metrix-2.7.3.1.zipکه دانلود کردهاید را انتخاب کنید - روی نصب کن کلیک کنید
- پس از اتمام نصب، روی فعال کردن پلاگین کلیک کنید
پس از فعالسازی، گزینه Metrix به منوی مدیریت وردپرس شما در نوار کناری سمت چپ اضافه خواهد شد.
مرحله 3: پیکربندی تنظیمات اولیه
- در داشبورد مدیریت وردپرس خود، روی Metrix در منوی سمت چپ کلیک کنید
- صفحه پیکربندی پلاگین Metrix را مشاهده خواهید کرد
تنظیمات اصلی
شما باید این فیلدها را پیکربندی کنید:
-
App ID (الزامی)
- این شناسه منحصر به فرد برنامه شماست
- آن را در داشبورد Metrix خود پیدا کنید: اطلاعات اپ → تنظیمات → فضای کاری
- نحوه پیدا کردن App ID خود
-
API Key (الزامی)
- این کلید پلاگین شما را با Metrix احراز هویت میکند
- آن را در داشبورد Metrix خود ایجاد یا مشاهده کنید: ایجاد API Key → API Key → تنظیمات → فضای کاری
- نحوه پیدا کردن API Key خود
- هر دو مقدار را در فیلدهای مربوطه وارد کنید
- روی دکمه ذخیره کلیک کنید
مهم: هر دو App ID و API Key الزامی هستند. اگر این فیلدها خالی باشند، پلاگین یک هشدار نمایش میدهد. وبسایت شما تا زمانی که هر دو مقدار پیکربندی نشوند، نمیتواند به Metrix متصل شود.
مرحله 4: تأیید نصب (اختیاری)
پس از ذخیره پیکربندی، Metrix به طور خودکار:
- SDK Metrix را در وبسایت شما راهاندازی میکند
- شروع به جمعآوری دادههای تحلیلی میکند
- یک اتصال با داشبورد Metrix شما برقرار میکند
شما باید SDK Metrix را در صفحه پلاگینها خود با وضعیت فعال مشاهده کنید.
مراحل بعدی
پس از اتمام تنظیمات اولیه، میتوانید:
فعال کردن اعلانهای پوش وب
اعلانهای پوش را برای ارسال پیامهای به موقع به کاربران خود پیکربندی کنید. برای دستورالعملهای دقیق به راهنمای اعلانهای پوش وب مراجعه کنید.
ردیابی رویدادهای سفارشی
برای تحلیل بهتر، رویدادهای سفارشی و دادههای کاربران را به Metrix ارسال کنید. برای اطلاعات بیشتر به راهنمای رویدادها و ردیابی مراجعه کنید.
نظارت بر تحلیلها
به داشبورد Metrix خود دسترسی پیدا کنید تا تحلیلها، بینشهای کاربر و عملکرد کمپین را مشاهده کنید.
عیبیابی
هشدار “تنظیمات شما کامل نیست”
اگر این خطا را مشاهده کردید:
- مطمئن شوید که فیلدهای App ID و API Key با مقادیر معتبر پر شدهاند
- دوباره بررسی کنید که اطلاعات را به درستی از داشبورد Metrix خود کپی کردهاید
- پس از اصلاح مقادیر، دوباره روی ذخیره کلیک کنید
پلاگین در منوی مدیریت ظاهر نمیشود
اگر منوی Metrix ظاهر نمیشود:
- مطمئن شوید که امتیازات مدیر (Administrator) را دارید
- پلاگین را غیرفعال و دوباره فعال کنید
- کش مرورگر خود را پاک کرده و صفحه را رفرش کنید
مشکلات اتصال
اگر وبسایت شما نمیتواند به Metrix متصل شود:
- بررسی کنید که App ID و API Key شما صحیح هستند
- اطمینان حاصل کنید که وبسایت شما به اینترنت متصل است
- تنظیمات فایروال خود را بررسی کنید تا اتصال به
metrix.irرا مجاز کند
ویژگیهای پلاگین
پلاگین وردپرس Metrix فراهم میکند:
- جمعآوری تحلیلها - ردیابی خودکار رفتار و رویدادهای کاربر
- اعلانهای پوش وب - ارسال اعلانهای پوش هدفمند به بازدیدکنندگان وبسایت
- ردیابی کاربران - شناسایی و تقسیمبندی کاربران
- مدیریت کمپین - ایجاد و مدیریت کمپینهای اعلان
- گزارشدهی در لحظه - مشاهده دادههای زنده در داشبورد Metrix خود
امنیت
پلاگین از ویژگیهای امنیتی وردپرس از جمله موارد زیر استفاده میکند:
- تأیید Nonce برای ارسال فرمها
- سیستم مجوزهای وردپرس (دسترسی فقط برای مدیر)
- ذخیرهسازی امن اطلاعات کاربری در جدول گزینههای وردپرس
هرگز API Key خود را به صورت عمومی به اشتراک نگذارید یا آن را در کنترل نسخه (version control) ذخیره نکنید.