ارسال RetenX Event از Android SDK

ثبت رفتار کاربر، properties و شناسه‌های مستعار هویتی از داخل اپ Android با Pushfa.trackEvent().

ارسال Event

نام event باید دقیقاً با Start، Exit یا Wait Until در سفر مشتری یکسان باشد. SDK شناسه ثابت مخاطب (Subscriber ID)، زمان UTC و idempotency key را خودکار اضافه می‌کند.

Pushfa.trackEvent(
    eventName = "product_view",
    params = mapOf(
        "product_id" to 42,
        "product_name" to "کفش ورزشی",
        "price" to 1_250_000,
        "in_stock" to true,
    ),
) { result ->
    if (result.isSuccess) {
        Log.d("Pushfa", "subscriber=${result.value?.subscriberId}")
    } else {
        Log.e("Pushfa", result.error?.message.orEmpty())
    }
}

Event همراه Alias

می‌توانید هم‌زمان با event، شناسه‌های مستعار پروفایل ۳۶۰ درجه مخاطب را نیز ثبت یا به‌روزرسانی کنید.

Pushfa.trackEvent(
    eventName = "checkout_completed",
    params = mapOf(
        "order_id" to "ORDER-9001",
        "amount" to 3_800_000,
    ),
    aliases = mapOf(
        "mobile" to "09120000000",
        "crm_id" to "CRM-9",
    ),
) { result ->
    Log.d("Pushfa", "event sent=${result.isSuccess}")
}

نوع داده‌های مجاز

مقادیر params باید به JSON تبدیل شوند: String، Number، Boolean، null، List و Map. داده حساس، فایل یا object غیرقابل‌تبدیل ارسال نکنید. نام eventها را ثابت و ترجیحاً snake_case انتخاب کنید.