بیزینس هایی که از وردپرس برای توسعه سایت خود استفاده می کنند می توانند با استفاده از راهنمای زیر پلاگین را نصب کنند. در این سند به صورت گام به گام نحوه نصب پلاگین شرح داده شده است:

راهنمای نصب پلاگین

برای ارسال داده به متریکس و ارسال وب پوش به کاربران وب سایت خود لازم است تا پلاگین آن را نصب کنید. میتوانید فایل زیپ آن را از لینک زیر دانلود کنید https://cdn.metrix.ir/sdk/wordpress-plugin/metrix-2.2.0.0.zip بعد از دانلود پلاگین وارد صفحه پلاگین های پنل ادمین سایت خود شده و گزینه افزودن پلاگین جدید (Add new plugin) را کلیک کنید.

سپس دکمه آپلود پلاگین (Upload plugin) را کلیک کنید و فایل پلاگین را آپلود کنید. بعد از آپلود پلاگین آن را نصب کنید و پلاگین را فعال کنید.

درصورتی که پلاگین را به درستی نصب و فعال کرده باشید میتوانید sdk متریکس را داخل لیست پلاگین های خود ببینید.

بعد از فعال کردن پلاگین یک تب جدید با نام Metrix SDK به تب های منوی پنل ادمین اضافه می گردد. با وارد شدن به آن، وارد تنظیمات پلاگین خواهید شد. برای شروع کار پلاگین لازم است app id و api key را وارد کنید. این دو را می توانید از صفحه تنظیمات داشبورد متریکس دریافت کنید.

در صورتی که میخواهید برای کاربران خود پوش نوتیفیکیشن از طریق وب سایت خود ارسال کنید، گزینه enable push notification را قسمت فعال کرده و public key را وارد نمایید. این مقدار را می توانید درمسیر زیر دریافت کنید:

داشبورد در صفحه تنظیمات -> تنظیمات کانال های ارتباطی -> تنظیمات وب پوش

برای ارسال وب پوش به کاربران خود می توانید از طریق داشبورد، کمپین وب پوش ایجاد کنید.

برای این که از کاربران خود دسترسی ارسال پوش اخذ کنید لازم است تا گزینه show subscription bell را فعال کنید تا زنگوله ای در گوشه صفحه وب سایت نمایش داده شود.

ارسال دیتای کاربر و رخداد از طریق وردپرس

• با استفاده از php:

1. در صورتی که با php می توانید دیتا ارسال کنید نیاز هست که متد مورد نظر خودتون رو در جای مناسب صدا بزنید. مثلا برای فرستادن دیتای کاربر میتوانید با استفاده از هوک wp_footer کاربر فعلی را از طریق متد های ورد پرس دریافت کنید و با استفاده از sdk ارسال کنید.

// after website being loaded call send_user function
add_action( 'wp_footer', 'send_user' );
 
function send_user() {
  $current_user = wp_get_current_user();
  if ( $current_user->user_email ) {
    Metrix_SDK::authorize_user( $current_user->user_email );
    Metrix_SDK::set_email( $current_user->user_email );
  }
}

یکی از روش های دیگر صدا زدن متد های sdk این است که آن را از قالب های وردپرس صدا بزنیم. برای این کار کافی است در فایل قالب متد صدا زده شود. مانند:

<?php Metrix_SDK::new_event("EVENT_SLUG", array( 'name' => "PAGE_NAME" )) ?>

در مثال بالا ابتدا یک رخداد داخل داشبورد ساخته شده و یک اتریبیوت با اسم name به آن اضافه شده. اسلاگ آن داخل متد new_event قرار داده شده و PAGE_NAME را به عنوان اسم آن صفحه ای که میخواهید ارسال کنید ست کنید (این مقدار میتواند داینامیک باشد تا برای هر صفحه یک اسم خاص گذاشته شود)

1. ارسال دیتا بعد از سابمیت کردن فرم

به عنوان مثال می خواهید دیتای ثبت شده توسط فرم را برای متریکس به صورت رخداد ارسال کنید. برای این کار لازم است تا یک فرم تعریف کنید. بالای آن فرم یه کد php قرار دهید تا در صورتی که این فرم سابمیت شد، مقدار موجود در فرم را از طریق sdk برای ما ارسال کنید.

<?php
  if ( isset( $_POST['search'] ) ) {
    if ( isset( $_POST['search_value'] ) ) {
      // ...
      Metrix_SDK::new_event("YOUR_EVENT_SLUG", array( 'search' => $_POST['search_value'] ) );
    }
  }
?\>
 
<form method="post">
  <input name="search_value">
  <input type="submit" name="search" value="Search">
</form>

• با استفاده از Javascript

در صورتی که ارسال رخداد در سمت کلاینت ساید سایت وردپرس شما باید انجام شود، مانند کلیک کردن کاربر بر روی دکمه لازم است که شما از طریق ارسال دیتا به روش sdk وب اقدام کنید. شما نیازی به پیاده سازی sdk وب ندارید فقط کافی است با استفاده از کد js، متد newEvent را صدا بزنید. برای جزئیات بیشتر به مستنداتsdkوب مراجعه کنید.

متریکس برای شما اطلاعات کاربرانتان را ذخیره و نگهداری می کند و در صورتی که بخواهید میتوانید از طریق داشبورد متریکس، برای کاربران خود کمپین پیامکی اجرا کنید.

انواع متد های ارسال داده های کاربران :

Metrix_SDK::authorize_user( $user_id );
Metrix_SDK::set_first_name( $first_name );
Metrix_SDK::set_last_name( $last_name );
Metrix_SDK::set_email( $email );
Metrix_SDK::set_hashed_email( $hashed_email );
Metrix_SDK::set_phone_number( $phone_number );
Metrix_SDK::set_hashed_phone_number( $hashd_phone_number );
Metrix_SDK::set_country( $country );
Metrix_SDK::set_city( $city );
Metrix_SDK::set_region( $region );
Metrix_SDK::set_locality( $locality );
Metrix_SDK::set_gender( $birthday );
Metrix_SDK::set_custom_attribute( $key, $value );
Metrix_SDK::set_custom_user_id( $id );

متد ارسال رخداد :

$custom_attributes = array(
  'manufacturer' => 'Nike',
  'product_name' => 'Shirt',
); // attributes are optional
 
Metrix_SDK::new_event( $slug, $custom_attributes );
 
// if your event doesn't have any attribute only send slug like this
Metrix_SDK::new_event( $slug );