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