گزارش Conversion و درآمد واقعی در RetenX
انتساب استاندارد خرید به آخرین پیام RetenX، تفکیک Event کلاینت از سفارش تأییدشده و محاسبه نرخ تبدیل و درآمد واقعی هر Journey.
این قابلیت چیست و چه فایدهای دارد؟
گزارش ارسال و کلیک نشان میدهد پیام دیده شده است، اما نتیجه تجاری را مشخص نمیکند. گزارش Conversion، Event هدفی مانند checkout_completed را به Journey مؤثر وصل میکند و نشان میدهد چند اجرای سفر به خرید رسیدهاند، نرخ تبدیل چقدر بوده و سفارشهای تأییدشده چه مقدار درآمد ساختهاند. با این گزارش میتوانید Journeyها، متنها، زمان ارسال و کانال Push یا SMS را بر اساس فروش واقعی مقایسه کنید.
مدل انتساب Last-touch چگونه کار میکند؟
RetenX فقط ارسال موفق یک گره Push یا SMS را «تماس» در نظر میگیرد. وقتی Event هدف برسد، بین Journeyهای واجد شرایط همان مخاطب، جدیدترین تماس داخل پنجره انتساب صاحب Conversion میشود. بنابراین یک سفارش همزمان به چند Journey نسبت داده نمیشود.
| وضعیت | نتیجه |
|---|---|
| Push همین Journey دو ساعت قبل ارسال شده و پنجره ۲۴ ساعت است. | Conversion به همین Journey منتسب میشود. |
| Event هدف رسیده ولی هیچ Push یا SMS از RetenX ارسال نشده است. | Event ثبت میشود اما Conversion منتسب ساخته نمیشود. |
| آخرین تماس خارج از پنجره انتساب است. | Conversion به آن Journey منتسب نمیشود. |
| چند Journey پیش از خرید پیام فرستادهاند. | جدیدترین تماس معتبر برنده Last-touch است. |
| یک order_id دوباره ارسال میشود. | سفارش برای همان سرویس دوباره شمرده نمیشود. |
| همان سفارش ابتدا از کلاینت و سپس از Backend میرسد. | رکورد قبلی تأیید سرور میشود و دو سفارش ساخته نمیشود. |
شاخصهای گزارش
| شاخص | تعریف |
|---|---|
| سفارش منتسبشده | تعداد order_idهای یکتا که با مدل Last-touch به Journey وصل شدهاند؛ شامل کلاینت و سرور. |
| سفارش تأییدشده | سفارشی که Event آن از Backend، با کلید خصوصی و order_id معتبر رسیده است. |
| Journey تبدیلشده | تعداد اجرای یکتایی که حداقل یک Conversion گرفتهاند. |
| نرخ تبدیل | Journey تبدیلشده تقسیم بر کل اجراهای Journey، به درصد. |
| درآمد تأییدشده | جمع مبلغ سفارشهای تأییدشده سروری در واحد انتخابشده. |
| میانگین سفارش تأییدشده | درآمد تأییدشده تقسیم بر تعداد سفارشهای تأییدشده. |
تنظیم Journey در پنل
رویداد هدف را مشخص کنید
در مرحله اول Journey مثلاً checkout_completed را بهعنوان رویداد هدف وارد کنید.
نام پارامتر مبلغ را وارد کنید
اگر مبلغ در params.amount است amount و اگر در params.order.total است order.total را بنویسید.
نام پارامتر شناسه سفارش را وارد کنید
یک شناسه پایدار مانند order_id یا order.id انتخاب کنید که در کل سرویس برای هر سفارش یکتا باشد.
واحد و پنجره انتساب را انتخاب کنید
IRT برای تومان، IRR برای ریال و USD برای دلار است. پنجره پیشفرض ۲۴ ساعت است.
رفتار پس از هدف را تعیین کنید
با فعالبودن «توقف پس از Conversion»، اجرای باز مخاطب بسته میشود؛ خاموشکردن آن فقط ادامه Journey را آزاد میگذارد و ثبت گزارش همچنان انجام میشود.
نمونه ثبت از Web SDK
ارسال از مرورگر برای واکنش سریع Journey مفید است، اما به دلیل قابلدستکاریبودن کد کلاینت، درآمد آن تأییدشده محسوب نمیشود.
await window.Pushfa.event('checkout_completed', {
order_id: 'ORD-1042',
amount: 850000
});نمونه ثبت قطعی از Backend
بعد از تأیید پرداخت در Backend، همان Event هدف را با کلیدهای سرویس، شناسه همان مخاطب، order_id و مبلغ بفرستید. api_private_key را هرگز در JavaScript، اپ یا خروجی عمومی قرار ندهید.
curl -X POST https://pushfa.com/api/webservices/retention/events \
-H "Content-Type: application/json" \
-d '{
"api_public_key": "YOUR_PUBLIC_KEY",
"api_private_key": "YOUR_PRIVATE_KEY",
"subscriber_id": "SUBSCRIBER_UUID",
"event_name": "checkout_completed",
"event_time": "2026-08-23T14:35:00+03:30",
"idempotency_key": "550e8400-e29b-41d4-a716-446655440000",
"params": {
"order_id": "ORD-1042",
"amount": 850000
}
}'پاسخ API و تشخیص انتساب
در پاسخ موفق، conversion.attributed مشخص میکند Event به یک Journey منتسب شده است. verified فقط وقتی true است که درخواست از وبسرویس Backend آمده و شناسه سفارش معتبر داشته باشد.
{
"status": "success",
"conversion": {
"attributed": true,
"campaign_id": 42,
"value": 850000,
"currency": "IRT",
"verified": true
}
}خواندن گزارش و خروجی PDF
در فهرست Journeyها، ستونهای Conversion، نرخ تبدیل و درآمد تأییدشده نمای سریع میدهند. با «گزارش سفر» خلاصه شاخصها و جدول سفارشها شامل شناسه سفارش، Subscriber ID، Alias، مبلغ، اعتبار کلاینت یا سرور، آخرین تماس و زمان Conversion باز میشود. خروجی PDF جامع نیز همین شاخصها را برای همه کمپینها نگهداری میکند.