====== "Configure Now" changes are not saved ======

Our Unreal Engine plugin, "Google Analytics Measurement Protocol", offers a convenient "//Configure Now//" button to automatically set it as the default Analytics Provider for your project.
However, due to a known issue with the Unreal Engine method [[https://github.com/EpicGames/UnrealEngine/blob/2d53fcab0066b1f16dd956b227720841cad0f6f7/Engine/Source/Runtime/Analytics/Analytics/Private/Analytics.cpp#L59|FAnalytics::Get().WriteConfigValueToIni()]], this automatic configuration may encounter file locking problems when your project is under Version Control Systems that support file locking (such as Subversion or Perforce).

{{ :ue5-google-analytics:gamp-configure-now.png |}}

This manifests itself with the plugin configuration being unchanged again and needing to be re-configured after using the "//Configure Now//" button and restarting Unreal Engine as required.


===== Problem =====

The issue arises because Unreal Engine fails to lock the configuration file, preventing it from being writable, which in turn blocks the plugin from saving changes. As a result, the automatic configuration might not work as intended.

===== Workaround Solutions =====

==== Manual File Locking ====

Before clicking "//Configure Now//", manually lock the configuration file to ensure it is writable, using the tools provided by your Version Control System. This will allow Unreal Engine to successfully write the necessary configuration changes.

==== Manual Configuration ====

If automatic locking is not feasible, manually edit the configuration file ''<PROJECT_ROOT>\Config\DefaultEngine.ini'' by adding the following sections:

<file ini DefaultEngine.ini>
[Analytics]
ProviderModuleName=GoogleAnalyticsMP
GAMP_Protocol=GA4_gtag
GAMP_TrackingID=...your Measurement ID for the Shipping configuration...

[AnalyticsDebug]
ProviderModuleName=GoogleAnalyticsMP
GAMP_Protocol=GA4_gtag
GAMP_TrackingID=...your Measurement ID for the Debug configuration...

[AnalyticsTest]
ProviderModuleName=GoogleAnalyticsMP
GAMP_Protocol=GA4_gtag
GAMP_TrackingID=...your Measurement ID for the Test configuration...

[AnalyticsDevelopment]
ProviderModuleName=GoogleAnalyticsMP
GAMP_Protocol=GA4_gtag
GAMP_TrackingID=...your Measurement ID for the Development configuration...

[AnalyticsPIE]
ProviderModuleName=GoogleAnalyticsMP
GAMP_Protocol=GA4_gtag
GAMP_TrackingID=...your Measurement ID for the Play-In-Editor configuration...
</file>

Instructions

  - **Identify the Configuration File** - navigate to your project's root directory and locate ''Config\DefaultEngine.ini''.
  - **Verify Write Permissions** - Ensure the file is not locked by version control. Grant write permissions to enable file modification.
  - **Manual Editing**: open ''DefaultEngine.ini'' in a text editor; copy and paste the provided configuration settings into the file; replace ''...your Measurement ID...'' with the appropriate Measurement ID for each configuration.
  - **Save Changes** - Save and close the file. Ensure there are no errors reported by your version control system.

Following these steps will ensure that the "Google Analytics Measurement Protocol" plugin is correctly configured, even in environments using file-locking version control systems. If you encounter further issues, feel free to reach out to our support team for additional assistance.