اسکریپت ردیابی

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

ردیابی لینک‌ها:

قطعه کد زیر را در تگ هد همه صفحات سایت خود قرار دهید.

<script async src="https://analytics.affili.ir/scripts/affili-v2.js"></script>
<script>
  window.affiliData = window.affiliData || [];function affili(){affiliData.push(arguments);}
  affili('create');
</script>

ثبت مشتری:

در صورتی که ارائه دهنده سرویس SaaS هستید یا مشتری در ازای پرداخت حق عضویت از خدمات شما استفاده می‌کند و می‌خواهید در طول یک مدت زمان خاص یا برای تکرار خرید به بازاریاب پورسانت پرداخت کنید. نیاز است بعد از ثبت‌نام مشتری در سیستم شما از طریق قطعه کدی که در ادامه می‌آوریم، یک مشتری ایجاد کنید.

<script>
	affili('customer', customerId, metaData, function (affiliCustomerId) {
    	// Save affiliCustomerId in your DB
    });
</script>

پس از اینکه مشتری در افیلی تعریف ثبت شد شناسه مشتری در افیلی توسط تابع callback بازگردانده می‌شود. شما باید این مقدار را در دیتابیس خود ذخیره کنید. در قطعه کد بالا متغیرهای customerId و metaData باید با مقادیر صحیح توسط شما پر شوند که توضیح هر کدام را در ادامه می‌دهیم.

 customerId: 

شناسه یکتای مشتری در سیستم شماست. 

metaData:

آبجکتی حاوی اطلاعات اضافه راجع به مشتری است. ارسال این پارامتر اختیاری است. 

تذکر: در صورتی که مشتری از سمت افیلی نباشد، دیتایی سمت افیلی ذخیره نشده و تابع callback نیز فراخوانی نمی‌شود.

ثبت فروش:

برای ثبت فروش‌های انجام شده در thank you page قطعه کد زیر را قرار دهید.

<script async src="https://analytics.affili.ir/scripts/affili-v2.js"></script>
<script>
  window.affiliData = window.affiliData || [];function affili(){affiliData.push(arguments);}
  affili('create');
  affili('sale', uniqueSaleId, saleAmount, {
    coupon: couponCode,
    products: products,
    customer_id: affiliCustomerId
  });
</script>

دقت داشته باشید در کد بالا متغیرهای uniqueSaleId ،saleAmount ،couponCode ،products و affiliCustomerId باید توسط شما با مقادیر صحیح پر شود؛ که توضیح هر کدام در زیر آمده است.

uniqueSaleId:

یک شناسه یکتاست که باید در سیستم خود برای هر فروش ایجاد کنید. شما باید این متغیر را با یک تگ یا متغیر واقعی جایگزین کنید تا مقدار مربوطه را در هر فروش به صورت خودکار مقداردهی کند. شناسه یکتا میتواند هر چیزی که برای شما معنادار است باشد و باید برای هر فروش نیز منحصربفرد باشد. به طور مثال: شماره سفارش، شماره تراکنش و ... پس از ثبت فروش می‌توانید این شناسه را در پنل افیلی بخش کانورژنها مشاهده کنید. این امر باعث می‌شود که مدیریت داده‌های موجود در افیلی و سیستم شما آسانتر شود.

saleAmount:

مبلغ کل فروش یا همان مبلغ پرداختی کاربر بابت خرید است. دقت داشته باشید مبلغ مربوط به کرایه حمل و نقل و مالیات نباید لحاظ شده باشد.

couponCode:

در صورتی که مشتری هنگام خرید از کد تخفیف استفاده کرده باشد کد تخفیف مربوطه را باید وارد کنید در غیر اینصورت با مقدار null پر شود.

products:

آرایه‌ای از محصولاتی است که توسط مشتری خریداری شده، که به صورت زیر پر می‌شود.

products = [
  {
    "name": "محصول نمونه",
    "unit_price": 12000,
    "quantity": 3,
    "total_price": 36000
  },
  {
    "name": "محصول نمونه شماره دو",
    "unit_price": 43000,
    "quantity": 1,
    "total_price": 43000
  }
]

affiliCusomerId:

شناسه یکتای مشتری در افیلی است. ارسال این پارامتر اختیاری است. 

واحد پولی:

به صورت پیش‌فرض واحد پولی فروشگاه‌ها در افیلی ریال است در صورتی که از واحد پولی تومان استفاده می‌کنید به پشتیبانی فروشگاه‌ها اطلاع دهید تا واحد پولی شما تغییر کند.

ثبت لید:

برای ثبت لید هنگامی که اقدام مورد نظر رخ داد، قطعه کد زیر را فراخوانی کنید.

<script>
affili('lead', {
  meta_data: {
    form_id: "فرم صفحه لندیگ",
    first_name: "علی",
    last_name: "رمضانی",
    mobile: "09123456789",
    email: "test@exmpl.com",
  }
});
</script>

پارامتر form_id در متا دیتا برای هر فرم باید مقدار یکتایی داشته باشد. و ارسال آن الزامی است. این مقدار می‌تواند از نوع عدد یا یک رشته باشد. همچنین برای فرمهای لید همانند بالا می‌توانید سایر داده‌های فرم را در متغیر متا دیتا برای ما ارسال کنید. ارسال این اطلاعات برای تطبیق و جلوگیری از تقلب ناشران الزامی است.


Revision #10
Created 16 February 2023 09:45:02 by داود سرائی
Updated 23 October 2023 13:39:20 by داود سرائی