Adds Google Analytics Event Tracking to all Contact Form 7 forms sitewide, using \u201cContact Form\u201d as the Event Category, the Contact Form 7 event as the Event Action, and the form name as the Event Label.<\/p>\n\n
Supports the most popular Google Analytics plugins, including the following:<\/p>\n\n
gtag.js<\/code> and the older universal analytics.js<\/code>)<\/li>\n- Google Tag Manager (using
gtm.js<\/code>) (see additional setup instructions in the FAQ section)<\/li>\n- Any other plugin using
gtag<\/code>, ga<\/code>, _gaq<\/code>, or __gaTracker<\/code> as the Javascript function<\/li>\n- To add others, open a pull request<\/a><\/li>\n<\/ul>\n\n\n
\n- Install and activate the plugin<\/li>\n
- Enable the actions you would like to send (if you skip this step, it will send all available actions).<\/li>\n
- Enjoy!<\/li>\n<\/ol>\n\n\n
\nWhat about GDPR (General Data Protection Regulation)?<\/h3><\/dt>\nThis plugin does not collect or send any personal information or form submissions to Google Analytics. The only form-related information sent is the name of the form and the submission result (invalid, spam, mail sent, mail failed, and sent).<\/p>\n\n
Google Analytics does collect more information including, but not limited to, the following:<\/p>\n\n
\n- Page name, URL, and language<\/li>\n
- Screen and window size<\/li>\n
- The user\u2019s IP address<\/li>\n<\/ul>\n\n
For more information, refer to Google\u2019s compliance information<\/a>.<\/p>\n\nPlease also note that Contact Form 7 and other plugins may collect, process, or store user data.<\/p><\/dd>\n
Where will events show up?<\/h3><\/dt>\nCheck your statistics in Google Analytics under Behavior > Events<\/em> or under Real-Time > Events<\/em>.<\/p><\/dd>\nWhat events will be shown?<\/h3><\/dt>\nThis depends on the settings you choose.<\/p>\n\n
\n- Invalid<\/strong> - Fires when an Ajax form submission has completed successfully, but mail hasn\u2019t been sent because there are fields with invalid input.<\/li>\n
- Spam<\/strong> - Fires when an Ajax form submission has completed successfully, but mail hasn\u2019t been sent because a possible spam activity has been detected.<\/li>\n
- Mail Sent<\/strong> - Fires when an Ajax form submission has completed successfully, and mail has been sent.<\/li>\n
- Mail Failed<\/strong> - Fires when an Ajax form submission has completed successfully, but it has failed in sending mail.<\/li>\n
- Sent<\/strong> - Fires when an Ajax form submission has completed successfully, regardless of other incidents.\n\n
\n- This is the only event available if you have Contact Form 7 version 4.7 or earlier.<\/li>\n
- This is the only original event sent by this plugin. I recommend enabling the other four and disabling this event, unless you need it for old goals you had set up from several years ago.<\/li>\n<\/ul><\/li>\n<\/ul><\/dd>\n
How do I set a goal in Google Analytics?<\/h3><\/dt>\nNote: these instructions are provided for reference and may become out of date if Google Analytics changes their feature set or labels.<\/p>\n\n
\n- Click on \u201cAdmin\u201d in your Google Analytics account menubar<\/li>\n
- In the right-most column (\u201cView\u201d), click on \u201cGoals\u201d<\/li>\n
- Click on the \u201c+ New Goal\u201d button<\/li>\n
- Set the Goal description\n\n
\n- Enter a name for the goal (I suggest \u201cContact Forms\u201d)<\/li>\n
- Choose the \u201cEvent\u201d radio button and click \u201cContinue\u201d<\/li>\n<\/ol><\/li>\n
- Set the Goal details\n\n
\n- Set the \u201cCategory Equals to\u201d field to \u201cContact Form 7\u201d<\/li>\n
- Set the \u201cAction Equals to\u201d field to the event you wish to track (see above<\/a> for a list of events)<\/li>\n
- If you want to define goals for specific form, enter the name of your form in the \u201cLabel\u201d field<\/li>\n
- Click the \u201cSave\u201d button<\/li>\n<\/ol><\/li>\n<\/ol><\/dd>\n
How do I use this with Google Tag Manager (gtm.js)?<\/h3><\/dt>\n\n- In your Google Tag Manager workspace, add a new Trigger.\n\n
\n- Choose trigger type: \u201cOther\/Custom Event\u201d<\/li>\n
- Set \u201cEvent name\u201d to \u201cContact Form 7\u201d<\/li>\n
- Set \u201cThis trigger fires on\u201d to \u201cSome Custom Events\u201d<\/li>\n
- Set the dropdowns to \u201cEvent contains Contact Form 7\u201d\n\n
\n- <\/li>\n<\/ul><\/li>\n
- Save the trigger<\/li>\n<\/ol><\/li>\n
- In your Google Tag Manager workspace, add a new Tag.\n\n
\n- Choose tag type: \u201cUniversal Analytics\u201d<\/li>\n
- Change \u201cTrack Type\u201d to \u201cEvent\u201d<\/li>\n
- Set \u201cCategory\u201d to \u201cContact Form 7\u201d<\/li>\n
- Set \u201cLabel\u201d\u00a0to \u201c{{Event}}\u201d\n\n
\n- <\/li>\n<\/ul><\/li>\n
- Click in the \u201cTriggering\u201d box and choose the trigger you set up above.<\/li>\n<\/ol><\/li>\n
- Save and publish your changes.<\/li>\n<\/ol><\/dd>\n\n<\/dl>\n\n\n
1.8.12<\/h4>\n\n\n- Update tested-up-to version.<\/li>\n<\/ul>\n\n
1.8.11<\/h4>\n\n\n- Update tested-up-to version.<\/li>\n<\/ul>\n\n
1.8.10<\/h4>\n\n\n- Fix issue with minified JS<\/li>\n<\/ul>\n\n
1.8.9<\/h4>\n\n\n- Fix undefined index issue in new installations<\/li>\n<\/ul>\n\n
1.8.8<\/h4>\n\n\n- Update tested-up-to version and automatic deployment.<\/li>\n<\/ul>\n\n
1.8.7<\/h4>\n\n\n- Fix typo in old tracking code for GTM.<\/li>\n<\/ul>\n\n
1.8.6<\/h4>\n\n\n- Fix typo in upgrade notes.<\/li>\n<\/ul>\n\n
1.8.5<\/h4>\n\n\n- Fix a bug with GTM and older CF7 versions.<\/li>\n
- Drop \u201cContact Form\u201d event labels for some integrations, leaving just \u201cContact Form 7\u201d as the event label.<\/li>\n<\/ul>\n\n
1.8.4<\/h4>\n\n\n- Fix a bug sending \u201cContact Form\u201d\u00a0instead of \u201cContact Form 7\u201d as the event label for certain configurations.<\/li>\n<\/ul>\n\n
1.8.3<\/h4>\n\n\n- Fix a bug sending the form ID instead of name to Google Analytics.<\/li>\n<\/ul>\n\n
1.8.2<\/h4>\n\n\n- Cache form titles and IDs for better performance.<\/li>\n
- Remove 1.7.0 admin upgrade notices.<\/li>\n<\/ul>\n\n
1.8.1<\/h4>\n\n\n- Fix a bug causing events not to send due to upgrade logic.<\/li>\n
- Set default options if user has not selected events to send.<\/li>\n<\/ul>\n\n
1.8.0<\/h4>\n\n\n- Add options to enable\/disable the available event actions.<\/li>\n<\/ul>\n\n
1.7.5<\/h4>\n\n\n- Update readme with goal tracking instructions<\/li>\n<\/ul>\n\n
1.7.4<\/h4>\n\n\n- Update readme with GDPR notes<\/li>\n<\/ul>\n\n
1.7.3<\/h4>\n\n