MaxMind
Support My Account FAQ My Order
Support My Account FAQ My Order

GeoIP Installation Guidelines
Automatic Updates
Linux/Unix APIs
Windows APIs
Sample CSV Structure
ISO 3166-1 Codes
ISO 3166-2 Codes
FIPS 10-4 Codes
Country Lat/Long
US State Lat/Long
US Metro Code
GeoIP Support Center


Using GeoIP with phpAdsNew

New! We have an installation guide for openAds.

Installation of GeoIP Country database with phpAdsNew
Here is a brief outline of the steps needed to install GeoIP Country with phpAdsNew on Unix or Linux. For more details, see page 42 of the phpAdsNew administrator guide.

First, download the GeoIP or GeoLite database, and transfer the file to the server hosting phpAdsNew. Once you have uploaded the GeoIP tarball to your server, open a ssh session and run the following commands:
$ tar xvfz GeoIP-106_20051201.tar.gz
$ mv GeoIP-106_20051201/GeoIP-106_20051201.dat /usr/local/share/GeoIP/GeoIP.dat
Then from phpAdsNew set the GeoIP database location under geotargeting options to
/usr/local/share/GeoIP/GeoIP.dat
Installation of GeoIP Region database with phpAdsNew
The instructions are similar to the ones above for GeoIP Country. The commands for GeoIP Region are:
$ tar xvfz GeoIPRegion-115_20051201.tar.gz
$ mv GeoIPRegion-115_20051201/GeoIPRegion-115.dat /usr/local/share/GeoIP/GeoIPRegion.dat
Then from phpAdsNew set the GeoIP database path under geotargetting options to
/usr/local/share/GeoIP/GeoIPRegion.dat
Installation of GeoIP City database with phpAdsNew
The commands for GeoIP City are:
$ tar xvfz GeoIP-133_20051201.tar.gz
$ mv GeoIP-133_20051201/GeoIPCity.dat /usr/local/share/GeoIP/GeoIPCity.dat
Then from phpAdsNew set the GeoIP database path under geotargetting options to
/usr/local/share/GeoIP/GeoIPCity.dat

If you do not have shell access to the server
After you have downloaded the database, unzip it using a program like WinZip. Then rename the *.dat file to GeoIP.dat, GeoIPRegion.dat, or GeoIPCity.dat, for the GeoIP Country, Region or City databases, respectively. Finally upload the *.dat file to the /usr/local/share/GeoIP or other user-specified folder on your server using FTP or another upload mechanism.

Using free GeoLite databases for phpAdsNew
The GeoLite Country and GeoLite City databases can be used with phpAdsNew. To use, download the binary format, extract, and install to the file locations as specified above. The commercial GeoIP databases are a drop-in replacement when higher accuracy is needed.

Older versions of phpAdsNew
There have been reports of phpAdsNew 2.0.6 not working with GeoIP. If you run into issues with 2.0.6, we suggest that you try upgrading to 2.0.7.

Earlier versions of phpAdsNew only support GeoIP Country and GeoIP Region. We have a patch for phpAdsNew 2.0 that works with the MaxMind GeoIP City database.

Troubleshooting
If you have set up the country targeting on a campaign, and configured phpAdsNew to set the path to the GeoIP.dat file, but phpAdsNew does not deliver any ads to the country specific ad, then you may need to modify the phpAdsNew source code to send the $_SERVER['REMOTE_ADDR'] variable instead of the $HTTP_SERVER_VARS['REMOTE_ADDR'] variable in libraries/lib-remotehost.inc.php, which might have issues due to load balancers.

If you see the "US/Ca State" Delivery limitation blank in the selection field in the 2.05-rc1 build of phpAdsNew, then changle line 63 of admin/banner-acl.php to:
if ($info['region']) $type_list['region'] = $strUSCAState;
There is a known issue with Canadian Province targeting with the 2.05-rc1 build of phpAdsNew, please contact us for details.

For OpenAds 2.0.11, to see the geotargeting menu, you have to select Country from the limitations menu which starts with "Weekday".


MaxMind, GeoIP and related marks are registered trademarks of MaxMind, Inc.
Copyright © 2008 MaxMind, Inc. All Rights Reserved. Terms of use.