ارسال RetenX Event از Android SDK

ثبت رفتار کاربر، properties و Aliasهای هویتی از داخل اپ Android با Pushfa.trackEvent().

ارسال Event

نام event باید دقیقاً با Start، Exit یا Wait Until در Journey یکسان باشد. 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، Aliasهای Profile 360° را نیز ثبت یا بروزرسانی کنید.

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 انتخاب کنید.