In many cases it's necessary to have end users explicitly opt in to your Customer Experience Improvement Program (CEIP).  This ensures that they know their information is being sent, what you are going to do with it, and are comfortable with the process.  You can see an example of this in Loupe itself - the same facility is used to allow you to opt in or out of our CEIP.

How it Works

When configured & integrated with your application your users will get a standard dialog prompting them to opt in our out of your CEIP for the first few times they run your application.  If they make a decision or have been asked enough times they aren't asked again until they update your application to a new version.  They can change their decision at any time.  If they opt out then the agent will automatically disable auto send.  If they change their mind their decision takes effect within seconds to either start or stop session transfer.

What happens before the user makes a decision?

You specify the default value - opt in or out - that is assumed if they haven't yet (or never) make a decision.  Either way the user interface will initially display with no selection made to ensure they explicitly opt in or out.

What if I disable auto send?

Then auto send consent has no effect and won't be displayed on startup.

How do I get the startup selection to display?

You need to add a call to Log.DisplayStartupConsentDialog in your application, typically after the main form has displayed.  This call is safe in all cases - if auto send isn't configured or the user has already made their election or the user has already been prompted enough times then it will still act correctly.  The dialog will only display once per process so it is safe to call from multiple places if there are multiple potential first forms.

How do I let users change their decision?

You should connect a menu option up to Log.DisplayConsentDialog.  If auto send consent is configured then it will display and reflect their current decision, if they have made any.  Otherwise, it returns immediately.

Adding User Opt In to your Application

To add Auto Send Consent to your Windows application you need to:

1. Configure Auto Send Consent:  Either through the App.Config file or through programmatic configuration you need to set several options to both enable it and configure consent dialog.
2. Call Display Startup Consent:  When enabled, background sending can't start until the DisplayStartupConsent method is called.  This call both gathers consent (if necessary) and activates auto send for the current application.  If no call is made auto send won't start even if it was previously accepted.

Where To Next?

• To set up user opt in for your WinForms or WPF application, see User Opt In - Configuration.
• To understand more about automatically sending data from your application to you, see Reference - Sending Session Data Automatically.