Zum Inhalt

Integrate Google reCAPTCHA in a data protection-compliant and functional way - step by step

As Google's popular and effective spam protection establishes connections to external servers, the application must not be loaded without the consent of website visitors. However, this means that reCAPTCHA cannot be displayed to website visitors who have not given their consent for external content to be loaded. This results in the problem that these visitors cannot send forms that are protected by reCAPTCHA.

With CCM19, you can use the script placeholder plugin to easily display a button in your forms that allows visitors to subsequently give their consent to reCAPTCHA in the form.

Here is an example of the display:

f3f776e7-5ab6-4d32-a5bc-5f5700be23d3.png

1. Add reCAPTCHA integration

First of all, an entry of the reCAPTCHA under "Integrations & Cookies" is required as a working basis. It is quite possible that this entry has already been generated automatically during onboarding. Then you can skip to point 2 and continue with setting up the placeholder.\ If this is not the case, the entry must be added manually. To do this, simply click on the blue button "Select entry from database".

35dde7cb-af13-4d96-9241-373a407baaa3.png

Then search for the template for reCAPTCHA in the embedding database. You can select the entry found by clicking on the green arrow.

855c9148-1c29-4f01-be5b-bda684a67e24.png

Save the integration by clicking on "Save and close".

This adds Google reCAPTCHA as an integration to the list:

5da097b9-ee99-479f-8573-076b3d82a41f.png

2. add script placeholder from template

The integration will now ensure that reCAPTCHA is always blocked if the cookies are not accepted via the cookie banner. So that the forms can still be used, a button must now be generated via the "Script placeholder" function, which can be used to subsequently activate reCAPTCHA, which is displayed under the form instead of the reCAPTCHA.

To make your work easier, we have already stored a design for this button as a template. Navigate to the menu item "Script placeholders" and select "Browse templates".

be4281f0-b6ed-49ab-b09b-dde32d7edafa.png

In the template list you will find the suggestion for Google reCAPTCHA. Select this entry by clicking on it.

6086be9a-d699-49a6-9437-f7c66acc1f4f.png

_You only need to add two things.

1. Select the entry for Google reCAPTCHA from the "Integration" select box. The name will correspond to the name of the entry under "Integrations & Cookies".

2. Click on the "Active" button to activate the placeholder.

7a2a8145-2a23-4041-9abe-93b299c6d39c.png

Now just click on "Create" to finish setting up the placeholder. Ideally, the placeholder should now already be displayed in the form.\ If this is not the case, you may need to make other settings. Please continue with the third step.

3. customize script placeholder

To configure the script placeholder, click on the green pencil icon.

756b2844-75e4-440a-a572-a2f1249aa622.png

If the placeholder is not yet displayed, a different CSS selector may need to be stored. This can be done in the "Content" tab. If you are familiar with the developer tools of the browser you are using, you can probably find a suitable selector yourself. If you do not know what to enter here, simply contact our support team.

2461821c-f014-4e2e-931c-5c43716c0dd7.png

Under the "Text modules" tab, you can optionally customize the texts in the placeholder.

24379c93-de9f-4bf2-9311-a2c37868871d.png