Skip to content

Latest commit

 

History

History
40 lines (24 loc) · 2.08 KB

FLUSH.md

File metadata and controls

40 lines (24 loc) · 2.08 KB

🔍 Flush events

Flushing is the process of uploading tracking events to Exponea servers. All tracked events and customer properties are stored in the internal database of the Exponea SDK and later flushed based on flushing settings. When an event is successfully sent to Exponea API, the object will be deleted from the local database.

By default, Exponea SDK automatically takes care of flushing events to the Exponea API. This feature can be turned off by setting the property FlushMode to MANUAL. Please be careful with turning automatic flushing off because if you turn it off, you need to manually call _exponea.FlushData() to flush the tracked events manually every time there is something to flush.

Exponea SDK will only flush data when the device has a stable internet connection. If a connection/server error occurs when flushing the data, it will keep the data stored until it can be flushed later.

You can configure the flushing mode to work differently to suit your needs.

🔧 Flush Modes

  • Period

    • Periodic mode flushes data in your specified interval(60 minutes).
    • Flushing only happens while the app is running.
    • When the app enters the background, all remaining events are flushed.

  • AppClose

    • All events will be flushed once the applications enter the background.

  • Manual

    • Manual flushing mode disables any automatic upload, and it's your responsibility to flush data.

  • Immediate

    • DEFAULT VALUE
    • Flushes all data immediately as it is received.

It's possible to change the flushing period by setting the property FlushPeriod on the Exponea object. The default value is 60 minutes. Due to platform/implementation limitations, the minimum value is 15 minutes.

The Exponea SDK Flush service will retry to flush events recorded in the database in case of a failure. If the maximum limit of retries was achieved, the SDK will delete the specific event from the database and not try to send it again. You can configure this value by setting the property maxTries in the Exponea Configuration.

💻 Usage

 _exponea.Flush()