IP targeting for sales channel, country or language
Description
Highlights
About the Extension
Configuration / Use of the plugin
A new entry will be added in the Shopware Admin:Settings -> Plugins ->IP-Targeting and speech recognition
Create targeting / redirection rule
Settings -> Plugins ->IP-Targeting and Voice Recognition-> add.
Test mode to simulate a country
NEW: from version 4.6.0
In the plugin settings it is now possible to simulate a country - the following settings are possible:
Simulate country / IP address for: Here you can select whether the simulation should be simulated only for your own IP address or for the selected country.
Attention: If this simulation is performed in the LIVE system, it is recommended that the simulation is performed only for the own IP address.
Simulate country / IP address for: In the frontend, selection of the country or a defined IP address will simulate - browser languages must still be set accordingly in the browser.
EXAMPLE CONFIGURATION
Requirement:
- myshop.de - Only country Germany
- myshop.at - Only country Austria
- myshop.ch - Only country Switzerland
- myshop.en - All other countries of the world
Configuration in the module (Assigned domains):
- myshop.de - Unblock country Deutschland
- myshop.at - Unblock country Austria
- myshop.ch - Unblock country Switzerland
- myshop.en - Block countries Germany, Austria and Switzerland
Important: The domain myshop.en MUST always be entered, as in this case, where the countries DE, AT and CH are blocked. Otherwise there will be no modal window and no redirection!
BASIC SETTINGS
Internal name (displayed in the overview).
It is possible to create multiple redirection rules - this is useful for different domains / sales channels.
Definition of the redirection rule via country detection (IP-Targeting) and/or language detection (browser language)
Landing detection (IP targeting) (preferred use)
We have integrated an IP address database from MaxMind; IP addresses are matched on the basis of this table. We update this IP database several times a year in the course of plug-in updates.
An IP address is assigned to a country. If no assignment is possible, the default country is used.
Language recognition (browser language)
We have integrated a browser language recognition, due to the language a redirection can be controlled
This is useful if a sales channel redirection is to be carried out based on the language (e.g. language Italian -> Webshop.it)
Country detection (IP targeting) and language detection (browser language)
The combination of IP targeting and browser speech recognition only makes sense if several languages exist under one domain.
Type of redirection
Direct call forwarding without consultation
Consultation via modal window (recommended)
Behavior when closing the modal window (click on 'X')
Do not enable closing and hide ("X")
this setting forces the user to select the delivery country.
Close and ask again on new page view
allows further page views until the user has decided on a delivery country, only then the window no longer appears.
Same behavior as when confirming the selection using the button
if the user closes the modal window without selection, the displayed selection is still used for the shop.
Close and do not ask again
Modal window closes and no redirection or other action is performed.
Show modal window, even if the customer is already in a matching domain
The domain is suitable if the configuration matches the recognized country and / or the recognized language.
ASSIGNED DOMAINS (Add Domain)
Basic settings
Domain (= target domain)
The following conditions apply to this domain and therefore a redirection takes place.
Standard delivery country (=fallback)
The default delivery country determines the delivery country of the domain if no alternative selection was made in the modal window
or no country has been detected by IP-Targeting. (Relevant for tax rules and pricing rules at country level).
Assignment of countries (detection via IP address, geo targeting) OR not AND
Forward the following countries to this domain
The countries assigned here are made available for selection in the front end.
This feature is useful if a domain has a few countries (e.g. Germany, Switzerland, Austria) to assign to it.
OR
Block the following countries for this domain
All countries that are assigned to the sales channel are available for selection, except for the countries selected here.
This feature is useful if some countries (e.g. Germany, Switzerland, Austria) are already assigned to another domain and all others should then be assigned to this domain.
Data privacy
Cookies
The plugin sets a cookie "acris_shop_switch_checked". This cookie stores in which domains of the sales channel an IP query has already taken place. Since the plugin is required for the correct functionality of the plugin, the cookie is inserted by the plugin in the functional cookies.
IP database
The database for the IP query is located directly at the plug-in, i.e. on the server where the shop system is also located. There is no data exchange with another server and no IP addresses or IP queries are stored in the course of the query. The plugin can therefore be used without any concerns regarding data protection.
Tips & tricks
Adjustments of the texts in the modal window
Settings -> Plugins ->IP-Targeting and speech recognition -> create a new redirection rule or edit an existing one ->in the layout area, changes are possible. Please change the language at the top (=Shopware Standard) if you want to work with different languages.From version 3.4.0: The language in the modal window is based on the customer's browser language. This configuration can be customized in the plugin settings.
Open IP targeting modal window afterwards
Requirement: In order to be able to use the function, a valid redirection rule that is valid for the current domain must have been configured (see above).
1. Plugin Settings
In the plugin settings (Extensions > My Extensions > "IP targeting for sales channel, country or language" > Configure) the setting "IP targeting modal window can be called later via JavaScript command" must be activated.
2. Configure link
It is now possible to open the modal window via the JavaScript console call "window.openShopSwitchModal();" even after it has been confirmed by the user.
The link can also be placed as an external link in a category (e.g. in the footer): "javascript:openShopSwitchModal()"
Alternatively, the HTML link can also be inserted in the theme. Example: <a title="Ip targeting settings">Ip targeting settings</a>
Using the IP Targeting Module Headless
As with the implementation via AJAX, it is possible to call the central storefront API route "Acris\ShopSwitch\Components\ShopSwitch\ShopSwitchRoute" via Headless.
The URL is /store-api/acris-shop-switch-rules/{activeDomainId}. The call can be made via GET or POST. The active domain ID (from database table sales_channel_domain) is mandatory as a parameter.
This contains all relevant information on IP targeting. The modal window can then be displayed via the respective storefront technology and the result can be reacted to by the route.
If the functionality is unclear or components for an implementation are missing, please feel free to contact the support team via the Shopware account.
Support
The configuration possibilities of the plugin are manifold.
That's why we are happy to offer a setup service for an additional fee - please ask us: office@acris.at
Details
- Available: English, German
- Latest update: 4 December 2024
- Publication date: 23 July 2020
- Version: 6.3.14
- Category: Language & Internationalisation
Resources
Reviews (12)
Super flexibel anpassbar und funktioniert einwandfrei
Alles bestens, danke!
Super Plugin, Support schnell und hilfreich
Alles soweit TOP, schneller und hilfreicher Support :-)
Vielseitig konfigurier- und einsetzbar! Ideal für mehrsprachige Shops mit spezielleren Anforderungen.
Funtioniert genau so, wie es soll, wie bisher alles von Acris...
Tolles Plugin, macht was es soll und mehr
Die Einrichtung hatte mich ein wenig überfordert (deswegen ausnahmsweise nicht überall 5 Sterne ;) aber der wirklich extrem gute Support hat uns wie immer sofort, sehr freundlich und unkomliziert weitergeholfen.
Wir und unsere nicht deutschsprachigen Kunden danken!
Professional Plugin with responsive support
Support und Funktion überragend
erleichtert OSS
About the Extension Partner
ACRIS E-Commerce GmbH
Partner Status
-
Shopware
Gold Partner -
Shopware
Premium Extension Partner
Details
- Ø-Rating: 4.9
- Partner since: 2015
- Extensions: 122
Support
- Based in: Austria
- Speaks: German, English
- Response time: Very quickly