گزارش تبدیل و درآمد واقعی در RetenX
انتساب استاندارد خرید به آخرین پیام RetenX، تفکیک رویداد ثبتشده در سمت کاربر از سفارش تأییدشده و محاسبه نرخ تبدیل و درآمد واقعی هر Journey.
این قابلیت چیست و چه فایدهای دارد؟
برای سنجش نتیجه، آمار ارسال و کلیک بهتنهایی کافی نیست. گزارش تبدیل مشخص میکند چند نفر پس از دریافت پیام به هدفی مانند تکمیل خرید رسیدهاند و سفارشهای تأییدشده چه درآمدی داشتهاند. با این گزارش میتوانید سفرها، متن پیامها و زمان ارسال را بر اساس نتیجه واقعی مقایسه کنید.
مدل انتساب Last-touch چگونه کار میکند؟
در RetenX هر اعلان یا پیامک که با موفقیت از یک گره ارسال شود، یک «تماس» با مخاطب محسوب میشود. وقتی رویداد هدف ثبت شد، سیستم آخرین تماس معتبر را در بازه زمانی تعیینشده پیدا میکند و نتیجه را به همان سفر نسبت میدهد. بنابراین یک سفارش همزمان برای چند سفر شمرده نمیشود.
| وضعیت | نتیجه |
|---|---|
| Push همین سفر مشتری دو ساعت قبل ارسال شده و پنجره ۲۴ ساعت است. | تبدیل به همین سفر مشتری منتسب میشود. |
| رویداد هدف رسیده ولی هیچ اعلان پوش یا پیامک از RetenX ارسال نشده است. | رویداد ثبت میشود اما تبدیل منتسب ساخته نمیشود. |
| آخرین تماس خارج از پنجره انتساب است. | تبدیل به آن سفر مشتری منتسب نمیشود. |
| چند سفر مشتری پیش از خرید پیام فرستادهاند. | جدیدترین تماس معتبر برنده Last-touch است. |
| یک order_id دوباره ارسال میشود. | سفارش برای همان سرویس دوباره شمرده نمیشود. |
| همان سفارش ابتدا از کلاینت و سپس از سمت سرور میرسد. | رکورد قبلی تأیید سرور میشود و دو سفارش ساخته نمیشود. |
شاخصهای گزارش
| شاخص | تعریف |
|---|---|
| سفارش منتسبشده | تعداد order_idهای یکتا که با مدل Last-touch به سفر مشتری وصل شدهاند؛ شامل کلاینت و سرور. |
| سفارش تأییدشده | سفارشی که رویداد آن از سمت سرور، با کلید خصوصی و order_id معتبر رسیده است. |
| سفر مشتری تبدیلشده | تعداد اجرای یکتایی که حداقل یک تبدیل گرفتهاند. |
| نرخ تبدیل | سفر مشتری تبدیلشده تقسیم بر کل اجراهای سفر مشتری، به درصد. |
| درآمد تأییدشده | جمع مبلغ سفارشهای تأییدشده سروری در واحد انتخابشده. |
| میانگین سفارش تأییدشده | درآمد تأییدشده تقسیم بر تعداد سفارشهای تأییدشده. |
تنظیم سفر مشتری در پنل
رویداد هدف را مشخص کنید
در مرحله اول سفر مشتری مثلاً checkout_completed را بهعنوان رویداد هدف وارد کنید.
نام پارامتر مبلغ را وارد کنید
اگر مبلغ در params.amount است amount و اگر در params.order.total است order.total را بنویسید.
نام پارامتر شناسه سفارش را وارد کنید
یک شناسه پایدار مانند order_id یا order.id انتخاب کنید که در کل سرویس برای هر سفارش یکتا باشد.
واحد و پنجره انتساب را انتخاب کنید
IRT برای تومان، IRR برای ریال و USD برای دلار است. پنجره پیشفرض ۲۴ ساعت است.
رفتار پس از هدف را تعیین کنید
با فعالبودن «توقف پس از Conversion»، سفر در حال اجرای مخاطب متوقف میشود؛ خاموشکردن آن فقط ادامه سفر مشتری را آزاد میگذارد و ثبت گزارش همچنان انجام میشود.
نمونه ثبت از Web SDK
ارسال از مرورگر برای واکنش سریع سفر مشتری مفید است، اما به دلیل قابلدستکاریبودن کد کلاینت، درآمد آن تأییدشده محسوب نمیشود.
await window.Pushfa.event('checkout_completed', {
order_id: 'ORD-1042',
amount: 850000
});نمونه ثبت قطعی از سمت سرور
بعد از تأیید پرداخت در سمت سرور، همان رویداد هدف را با کلیدهای سرویس، شناسه همان مخاطب، 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 مشخص میکند رویداد به یک سفر مشتری منتسب شده است. verified فقط وقتی true است که درخواست از وبسرویس سرور آمده و شناسه سفارش معتبر داشته باشد.
{
"status": "success",
"conversion": {
"attributed": true,
"campaign_id": 42,
"value": 850000,
"currency": "IRT",
"verified": true
}
}خواندن گزارش و خروجی PDF
در فهرست سفرهای مشتری، ستونهای تبدیل، نرخ تبدیل و درآمد تأییدشده نمای سریع میدهند. با «گزارش سفر» خلاصه شاخصها و جدول سفارشها شامل شناسه سفارش، شناسه ثابت مخاطب (Subscriber ID)، Alias، مبلغ، اعتبار کلاینت یا سرور، آخرین تماس و زمان تبدیل باز میشود. خروجی PDF جامع نیز همین شاخصها را برای همه کمپینها نگهداری میکند.