اتصال Event و Profile به RetenX
راهنمای توسعهدهنده برای فرستادن رفتار مخاطب از Web SDK، Android SDK یا سرور و پیوند آن با شناسه ثابت مخاطب (Subscriber ID) و Profile 360°.
Event باید به چه کسی وصل شود؟
هر Event باید به مخاطب پایدار متصل باشد. در Web و Android، Pushfa شناسه ثابت مخاطب (Subscriber ID) را خودکار میسازد و نگهداری میکند. در سمت سرور همان subscriber_id یا شناسه Profile را همراه Event بفرستید تا رفتار بین دستگاه، Push و شماره موبایل گم نشود.
ارسال از Web SDK
نام رویداد را ثابت و قابلفهم انتخاب کنید و دادههای لازم برای شرطها و شخصیسازی را داخل properties بفرستید. اطلاعات حساس یا غیرضروری را وارد Event نکنید.
PushfaRetenXEvent('add_to_cart', {
cart: { id: 'C-14051', total: 890000 },
product: { name: 'کفش ورزشی', url: 'https://shop.example/cart' }
});ارسال از Android SDK یا سرور
در Android از متدهای RetenX موجود در SDK استفاده کنید؛ ثبت توکن و شناسه ثابت مخاطب (Subscriber ID) نیز توسط خود SDK انجام میشود و به ثبت دستی توکن در وبسرویس نیاز نیست. برای رفتارهای قطعی سمت سرور مانند پرداخت موفق، رویداد را از سمت سرور بفرستید تا نتیجه به مرورگر یا بازبودن اپ وابسته نباشد.
نمونه رویداد هدف در Web SDK
این رویداد میتواند تبدیل را به آخرین تماس معتبر RetenX منتسب کند و در صورت فعالبودن گزینه توقف، اجرای در حال انجام سفر مشتری را متوقف کند. چون کد مرورگر قابل دستکاری است، این رکورد «کلاینت» محسوب میشود و مبلغ آن وارد درآمد تأییدشده نمیشود. برای تأیید سفارش، همین رویداد و همین order_id را بعد از پرداخت قطعی از سمت سرور بفرستید.
await window.Pushfa.event('checkout_completed', {
order_id: 'ORD-1042',
amount: 850000
});