Support

Instructions GA4 and Google Ads Refund Plugin for Shopware

Table of contents

Compatibility

The plugin is compatible with Shopware 6 from version 6.4.8.0 to 6.7.0.0. It is also available for the Shopware Cloud version.

Setting up the plugin

Install the plugin from the Shopware Store. However, you must leave the plugin deactivated as it must be set up first.

Plugin for Shopware 6 & Cloud
To the Shopware Store
Refund Plugin GA4 Googl Ads fuer Shopware aktivieren
Leave the plugin deactivated and click on “Configure”

Leave the plugin deactivated. If you have already activated it, deactivate it again.

Sales channel

Refund Plugin Verkauskanal 1
Select your desired sales channel for which you want to record returns

Plugin configuration

Google Ads Refund E Mail Adresse Anleitung
Enter your e-mail address.

Enter your e-mail address and continue with the setup. The e-mail will only be sent when you activate the plugin in the plugin overview.

In the email you will find the CSV URLs of all sales channels that you need to upload to Google Ads.

If you have changed your e-mail address, it is not enough to simply save the plugin. You must activate the plugin in the plugin overview and then deactivate it again.

Google Ads Refund Sprache E Mail Anleitung
Select the language in which the instruction email with the CSV URLs should be sent.

Google Analytics 4 Configuration

GA4 aktivieren fuer Refund Plugin
You can deactivate the sending of refund events to GA4 here

You can find the Google Analytics 4 measurement ID in your Google Analytics 4 account.

About Google Analytics
About Google Analytics
GA4 Einstellungen
Click on the cogwheel at the bottom left of Google Analytics
Google Analytics 4 Datenstreams 2
Click on “Data streams” under “Data collection and modification”
GA4 Refund Datenstream
Select the data stream that is to receive the refund events
GA4 Mess ID kopieren
Copy the measurement ID. Leave the GA4 browser tab open.
Refund Plugin GA4 Mess ID
Insert the measurement ID into the plugin

Now switch back to the same GA4 browser window that you had previously opened and scroll down.

GA Measerment Protocol Refund Event
Click on “Measerment Protocol - API-Secrets” in the data stream
GA4 Measerment Protocoll Key erstellen
Click on the blue “Create” button
Google Analytics 4 API Key anlegen
Enter a name for your API key. For example “Refund” and click on “Create”
GA4 API Key kopieren
Copy the APO key (secret value)

Now switch back to your Shopware backend and copy the API key.

GA4 Measerment Protocoll Key einfuegen
Insert your API key into the Refund plugin

Google Ads configuration

Refund Plugin Google Ads
You can deactivate the creation of the CSV for Google Ads here

You have the option of protecting the CSV file with an Htaccess password.

Google Ads CSV Passwortschutz
Assign a user name for the htaccess protection of the CSV file
Google Ads CSV Passwortschutz Passwort
Assign a password for the htaccess password protection
Google Ads CSV Passwortschutz Passwort
Assign a password for the htaccess password protection
Google Ads CSV Passwortschutz Passwort
Assign a password for the htaccess password protection

Now switch to your Google Ads account so that you can copy the name of your purchase conversion.

About Google Ads
About Google Ads
Google Ads Zielvorhaben
In your Google Ads account, click on “Target project” in the navigation on the left
Google Ads Purchase Event
Copy the conversion name of your purchase event.
Google Ads Purchase Event
Copy the conversion name of your purchase event.

Now switch back to your Shopware backend. However, leave the Google Ads browser window open.

Google Ads Conversion Name
Enter your conversion name in the field. Pay attention to upper and lower case
Google Ads Conversion Wert Refund
Select the type of conversion value for recording the refunds. You should select the same setting as for your purchase event.
Google Ads Purchase Event Zeitzone
Enter the correct time zone, otherwise errors may occur.
Goolge Ads Google Analytics Refund Plugin
Click on the “Save” button and go back to the plugin overview.
Goolge Ads Google Analytics Refund Plugin
Click on the “Save” button and go back to the plugin overview.
Refund Plugin aktivieren
Now activate the plugin. If the plugin was already activated, deactivate it and then activate it. You should now receive an e-mail

E-mail with URL's

Refund Plugin aktivieren
Now activate the plugin. If the plugin was already activated, deactivate it and then activate it. You should now receive an e-mail

An e-mail will now be sent to the e-mail address you entered. The e-mail comes from the following e-mail address: mailer@refund-app.mission-om.com with the subject: “Instructions – Shopware Refund Plugin for GA4 and Google Ads”.

Please also check your spam folder.

Refund E Mail

In the e-mail you will find all CSV files for Google Ads. There are URLs for all sales channels together or for all individual sales channels.

Set up Google Ads CSV Refund Upload

Now switch to your Google Ads account so that you can set up the CSV upload.

About Google Ads
About Google Ads

Daily upload of refunds

Google Ads Refund Upload CSV
Click on “Target project” in your Google Ads account
Google Ads Refunds Upload
Now click on “Uploads”
Google Ads Refund Uploads Zeitplan
Click on “Schedules” and then on the “Plus” button
Google Ads Refund Upload https
Select “HTTPS” for the upload
Google Ads Refund Upload URL
Insert your URL, use the URL with the extension “...weekly.csv”

For the schedule, use the file with the extension “…weekly.csv”, this file is updated as soon as someone makes a refund. The other file with “…initial.csv” contains all of the refunds from the last 50 days and should only be used for a one-off upload.

Google Ads Refund Upload Passwort
If you have created a password protection in the plugin, enter it here.
Google Ads Refund Upload Zeitplan
Select “Daily” as the frequency. You can freely select the time.
Google Ads Refund Upload speichern
Then click on “Save and show preview”

It is normal for errors to appear during processing. This is because not every referral comes from Google Ads, but also from other sources. Since the conversion ID is not available in Google Ads, report Google Ads: “The conversion action specified in the customization request was not found. Check if it is available in this account”

Google Ads Refund Upload Vorschau
Click on “Ok”

Google Ads CSV Refund one-time upload (upload of the previous 50 days)

Google Ads Refund Upload einmalig
Click on “Uploads” and then on the “Plus” button
Google Ads Refund Upload einmalig HTTPS
Select “HTTPS” as the upload type
Google Ads Refund Upload einmalig URL
Paste the URL from the e-mail with the extension “...initial.csv”
Google Ads Refund Upload einmalig Passwort
If you have created a password protection in the plugin, enter it here.
Google Ads Refund Upload einmalig speichern
Then click on Apply

It is normal for errors to appear during processing. This is because not every referral comes from Google Ads, but also from other sources. Since the conversion ID is not available in Google Ads, Google Ads: “The conversion action specified in the customization request was not found. Check if it is available in this account”