How Do I Upload Upload the Geolite2-country.mmdb File

You can use geo-targeting to display or hibernate ads for visitors coming from a specific location, i.east., a state, urban center, or continent. This feature is available within the "Geo Location"Visitor Status included in the Geo-Targeting add-on.

• Enabling Geo-Targeting
  • Download and connect the MaxMind databases automatically
  • Manually upload the MaxMind databases
• Using Geo-Targeting
  • Brandish Ads by Land
  • Display Ads past Metropolis
  • Display Ads by State/Region
  • Display Ads by Continent
• Targeting multiple geolocations
• Using translated state or city names
• Targeting locations by radius
• What else y'all need to know
• Tests and issues
  • General issues
  • Testing locations
  • Troubleshooting

Enabling Geo-Targeting

The Geo-Targeting add-on by Advanced Ads requires the GeoLite2 databases provided past MaxMind. Advanced Ads can connect with MaxMind and download the databasesautomatically for you. All you lot need is a free license key from MaxMind.

Download and connect the MaxMind databases automatically

Follow these steps to install the Geo-Targeting ads add-on. Generate a license central at MaxMind, and let Advanced Ads download the databases.

1. Download and install the Geo-Targeting addition
2. Enable the license central atAvant-garde Ads > Settings > Licenses > Geo-Targeting
3. Sign upwardly every bit a GeoLite2 user for free at maxmind.com
4. Generate a license cardinal in your MaxMind account.
   • SelectMy License Key in the left navigation.
   • Click onGenerate new license key.
   • Give your license key a title.
   • Select "No", when you are asked "Will this key be used for GeoIP Update?"

Delight notation: the MaxMind license primal will merely be visible in one case, so please save information technology somewhere for after utilise. You can generate a new complimentary license key in your MaxMind account anytime.

Getting a new license key from MaxMind

5. Copy the generated license key to the field "MaxMind license fundamental" in your Avant-garde Ads settings atAdvanced Advertizement > Settings > General > Geo-Targeting

6. Click"Update geo location database (~66MB)" to upload the files and connect with the databases.
   • if you go the error message "Database update failed", please check if the license key is correct or endeavor again later if it is a temporary error by MaxMind.

Advanced Ads volition download the database files to the folderwp-content/uploads/avant-garde-ads-geo on your webhost. You lot can update the database afterward each first Tuesday of a month.

Manually upload the MaxMind databases

You can also manually download the MaxMind databases and upload them via FTP in the binderwp-content/uploads/advanced-ads-geo of your WordPress installation.

Follow these steps to upload theGeoLite2 databases manually:

1. Sign upwardly every bit a GeoLite2 user at maxmind.com and generate a license key equally described to a higher place.
2. Download the databasesGeoLite2 City andGeoLite2 Country in thebinary format from your MaxMind account. They are provided as GZIP files. You don't need to download the SHA256 files.
3. Unpack the GZIP files. Each archive contains a .mmdb file and 2 .txt files.
4. UploadGeoLite2-Urban center.mmdb andGeoLite2-Country.mmdb into the binderwp-content/uploads/advanced-ads-geo via FTP.
5. Enter your MaxMind license key into the field "MaxMind license key" in Advanced Ad > Settings > General > Geo-Targeting. Salvage the settings after.

Please make sure to upload both .mmdb files. Advanced Ads volition recognize the databases automatically.

When the databases are successfully continued, you will see the confirmation "Geo Database found" atAdvanced Ads > Settings > General > Geo-Targeting.

Using Geo-Targeting

To geo-targeting ads, go to theCompany Conditions meta box on the advertising edit screen and select the geolocation option.

To geo-targeting ads, cull "Geo Location" from the visitor atmospheric condition.

After selecting this condition, y'all can choose whether the ad should show upward or exist subconscious for the location. And then select the country or continent. Inserting a city is optional.

Define a country, a region, or a city to specify the geo-targeting of your ads.

Brandish Ads past Country

To brandish or hide an ad by country, choose it from the second select field of the geolocation options.

The plugin provides a list of all available countries. If yous are missing one, then please contact united states.

You can detect some widespread countries at the height of the list and the rest later on. You can as well just start typing the name to leap to information technology.

Leave the field for the city and state empty to target all visitors from that land.

Example: displaying ads by country

Display Ads past Urban center

To target an ad to a specific urban center, enter the city'south proper name into theMetropolis field.

You don't need to select a country or state.

Case: displaying ads by city

Brandish Ads by State/Region

The level of a state or region depends on the individual construction of the country you are targeting. To target a country, enter the proper noun into theLand/Region field.

You don't need to select a country. Entering a urban center name would lead to the region existence ignored in the check.

Case: displaying ads by country/region

Display Ads by Continent

You lot find the option of a continent in the second select field beneath the most mutual countries.

In that location is also a bulk selection to select countries from the Eu. This choice is not identical to Europe as a continent.

With the UK leaving the Eu in 2021, we removed this state from the EU option.

Example: displaying ads by continent

Targeting multiple geolocations

You can also target multiple geo locations, e.chiliad., two or more dissimilar countries.

Example: showing an advertising in Los Angeles and San Francisco

To target multiple locations, you just add another visitor condition with the OR connector. There is no limit on areas yous tin can combine with each other.

Using translated land or city names

The geolocation database provides some translations for city and state names. The availability of these translations depends on the country.

To cheque names in other languages, choose i fromAdvanced Ads > Settings > Full general > Languages of names.

Choose the language of the state, region, or city.

At that place are upwards to 8 languages bachelor. If the proper noun you entered is not available in the chosen linguistic communication, it volition be checked confronting the English language name.

Targeting locations by radius

Yous tin can target a region or larger area around a specific spot using theradius option.

Utilise the radius option to geo-target ads effectually a specific location

The usage is straightforward. Choose whether to include or exclude the given area, the distance, and whether it should be measured in kilometers or miles.

And so get the coordinates by entering a urban center proper noun and click on the appropriate results to load the exact coordinates.

This option is also just as accurate equally the underlying database and might still be off.

Getting coordinates for a specific city

What else you need to know

Like with all dynamic advertising conditions, an installed and activated cache can negatively influence the functionality. Use enshroud-busting in Avant-garde Ads Pro in such cases.

If you are missing more details for your targeted region, delight check out the Extending the database section.

The Radius option might non work when your traffic uses a different nameserver, similar Sucuri or Cloudflare.

Tests and problems

General issues

Delight be aware that IPs are continually changing. The more populated the region, the more authentic geo-targeting is working.

Please note that the used GeoLite2 database by MaxMind might miss IPs, peculiarly for modest locations and cities. See the upgrade options below.

There is besides a listing of how authentic the lists are on a city level for each land. Come across GeoIP2 Metropolis Accurateness.

Caching and geo-targeted ads

On buried websites, brand sure that you enable cache-busting under Advanced Ads > Settings > Pro.

If Cache-Busting is used, the Geo-Location visitor condition merely looks up the location of the company ones. This could lead to unexpected behavior when you alter the IP accost while debugging the option.

To resolve this, you lot can:

• Use a private window in your browser for each test. Close the window later each tested location.
• Clear the advanced_ads_pro_visitor_referrer cookie after each check.
• Disable enshroud-busting for the placement (only for testing).

Update the Company profile option when testing different locations in the same browser with cache-busting enabled.

Important changes due to the CCPA

Post-obit the new privacy regulations set by the California Consumer Privacy Human action (CCPA), MaxMind has inverse the distribution of their free GeoLite2 databases.

Since December 30th, 2019, MaxMind requires the users of their GeoLite2 databases to register for a MaxMind account and obtain a license key. This style, MaxMind can ensure that their service complies with the privacy regulations mandated in the CCPA.

They still offer their GeoLite2 databases free of charge and provide an insightful commodity about the changes here.

If you lot have installed the database files before Dec 30th, 2019, you should already have them on your server. But y'all should sign up as a new MaxMind user and obtain a free license central to comply with the CCPA.

With the license cardinal, the Geo-Targeting add-on can upload the files and connect with the database automatically as described in a higher place.

Geo-targeting examination ad

The post-obit advert shows your current position according to the geo-targeting database. It allows you to estimate how far it might be off for your position.

You tin can download this advertising'south code on this page. Use it in thePlain text and lawmaking ad type and enable thePermit PHP choice.

In one case the database files are uploaded, yous can geo-target your ads with theCompany Conditions meta box on the ad edit screen.

Testing locations

Using a abiding

This method is most appropriate when testing on a staging or new website.

Yous tin set the constant ADVANCED_ADS_GEO_TEST_IP in your wp-config.php to simulate that traffic from all visitors on your website comes from a specific IP address.

                ascertain( 'ADVANCED_ADS_GEO_TEST_IP', '31.17.16.74' ); // some High german IP address              

Other resources for testing:

• Online-Test for IP addresses and their location
• Test GeoIP2 database online
• GeoIP2 City Accurateness

Using a VPN

You lot can use a so-called VPN to your website from a different "location". Our team prefers using TunnelBear, which has a free plan big enough for testing.

There are also websites offering a VPN without installing anything or having to create an business relationship. If you try them, and so please make certain to test more than ane service. We have found some of them to deliver unreliable results.

Troubleshooting

To observe a potential problem with geo-targeting, you can log all checks made by the plugin.

Add together the following line to yourwp-config.php file to log all checks done by the Geo-Targeting plugin.

define('ADVANCED_ADS_GEO_CHECK_DEBUG', truthful );

Once the constant is added, all checks volition be written into the geo_check.log file in your wp-content folder. You can access it by using the following URL with example.com being your domain: http://www.example.com/wp-content/geo-bank check.log.

I log entry might await similar this:

GEO Check (setting|visitor): State |DE – REGION | – CITY new york|berlin

The value from the ad settings (left) and the one from the current user (right) are separated by a pipe (|). In the example in a higher place, the company is in Berlin, Germany (DE), just the ad setting is New York.

Note thatCountry andREGION will but exist listed here if you provided a value in the geo-targeting Visitor Status. When you fix a continent, it will also be listed next toCOUNTRY.

There is no error output if your IP is empty, e.g., when you are in a local environment.

Unfortunately, there is no list available for all regions. We suggest to enable geo-targeting debugging and go the regions from the log file.

Go along in mind that city and state names must exist perfect matches with the geolocation database. Even small-scale differences volition consequence in a cleaved bank check.

Example:Bryanskaya Oblast' andBryanskaya Oblast' are non the same string, because of the dissimilar apostrophe.

A proficient reference to ensure that you utilize the correct spelling is the ISO 3166-2 standard for representing names of countries and their subdivisions.

The GeoLite2 database created by MaxMind might not be as accurate, particularly for smaller areas.

MaxMind offers the GeoIP2 database with better accuracy on a country or city level. Meet their offers.

To utilise their additional database, just rename it to GeoLite2-City.mmdb for the city level and GeoLite2-Land.mmdb for the state level. Replace files with the same name in wp-content/uploads/advanced-ads-geo to apply information technology.

neherartimessill.blogspot.com

Source: https://wpadvancedads.com/manual/geo-targeting-condition/

Share this post