React Integration Guide
Welcome to our guide on integrating Concord into a React application. We make it easy to integrate Concord into your React applications in just a few minutes and this guide will help you get up and running quickly. This guide includes the following information:
- Initial Concord configuration.
- Google Consent Mode V2 configuration.
- Integrating Concord into a React application.
Getting Started With Concord
As part of the initial onboarding process that occurs when you set up a new organization or project in Concord, you will be able to choose your preferred consent settings, including the Consent Mode (Implied vs. Express), the Blocking mode (how trackers like cookies, scripts, iframes, etc. are processed and blocked), the Google Consent Mode V2 setting (we recommend Basic mode for most companies), the Consent Duration (how long consent lasts), and other options (Sensitive Information consent, Do Not Sell, Global Privacy Control, etc.).
During that process, we provide sensible defaults that are recommended as the default global settings, but those settings can always be adjusted and additional regions can also be added and customized later in all paid plans.
For more details on this process or to complete it for the first time, please follow the instructions in this guide:
https://www.concord.tech/docs/getting-started
Google Consent Mode V2 Configuration
Our Google Consent Mode V2 integration allows websites to adjust how and when data is shared with Google based on user consent collected via the Concord Consent Banner & Privacy Center.
We recommend Basic mode for most companies that work with us and Google and our simplified setup integrates with Google in the following ways:
- Based on the user’s geographical location, privacy laws in that region, and your consent settings in Concord, we can be configured to block all non-essential cookies and scripts until the user grants consent. The GCM integration allows for a few different options that determine how and when Google tags are allowed and what data is shared with them and when.
- Regardless of the chosen GCM Mode (we provide both Basic and Advanced modes), when enabled and once consent is granted, Concord automatically shares the user's consent preferences with Google, which changes the behavior of Google services based on these preferences. This works with both Google Tag (gtag) and Google Tag Manager (GTM) implementations.
As noted above, Basic mode is the default setting and will be automatically enabled unless you change it. More details on that process can be found here:
https://www.concord.tech/docs/understanding-configuring-google-consent-mode-gcm-v2
You can verify that this is set correctly by going to Deployment → Integrations → Embed Concord and checking the setting as shown below. If you want to change that setting, simply click on the button in the upper right of the Google Tag Manager (Consent Mode V2) section (which will show Disabled, Enabled: Basic, or Enabled: Advanced):
Integrating Concord Into a React Application
The final step is to Integrate Concord into your React application, which typically takes just a few minutes. Please follow the instructions below to complete this part of the process:
1. Login to your Concord organization and go to Deployment → Integrations → Embed Concord and copy the Direct Embed Code for the project you want to add to your React application (projects can be changed via the Projects selector in the page header if needed).
2. In your React application open your index.html file. In this example, we have created a standard React application via Vite so the file is at the root of the project.
3. Paste the Concord script code you copied above at the top of the head section right below the opening <head> tag.
- Note: The Concord script should always go above any other custom code to ensure that Concord runs first.
- Note: Concord code should be placed exactly as copied above. Adding async or defer to the code can cause issues with compliance due to timing.
4. Deploy your application and ensure that the Concord script tag shows up in the source code.
5. Go back to Concord to verify your integration under Deployment → Integrations → Embed Concord. If successfully added and deployed, you should see the following:
Congratulations. You have successfully integrated Concord into your React application and any future changes to your attached project in Concord will be automatically synced to your application.
