Page 1

AdSpyTracker

_______________________ User Help Manual

Copyright © 2008 www.AdSpyTracker.com. All Rights Reserved.

AdSpyTracker

Page 2

Copyright / Disclaimer
All rights reserved. No parts of this document may be reproduced in any form or by any means (i.e. electronic, graphically, or mechanically, including recording, taping, photocopying, and/or information storage and retrieval systems) without the written consent of the author and publisher.

Products that are referred to in this work may be either trademarked and/or registered trademarks of the respective owners. The publisher and the author make no claim to these trademarks. While every single precaution was taken in the preparation of this work, the publisher and the author assume no responsibility for errors or omissions or for damages from the use of the information contained in this document or from the use of programs and source code that may accompany it. In no event shall the publisher and the author be liable for any loss of profit or any other commercial damage caused or alleged to have been caused directly or indirectly by the document.

Copyright © 2006 www.AdSpyTracker.com. All Rights Reserved.

Page 3

AdSpyTracker

AdSpyTracker Instructional Guide
Again, I want to congratulate you on taking a giant step in growing your business and building on your marketing knowledge. With AdSpyTracker, you have an enormous advantage over your competition, in that you can now track all aspects of your AdSenseTM ads right up to the exact advertisement that was clicked…You will be able to reveal the exact search terms that are drawing your visitors to any of your webpages…You can see the actual Ad Formats that are bringing you the most clicks so you can quickly test and track which size and color formats, AdUnits, and AdLinks drop the most cash into your account…You will know precisely how to boost your supporting content and target your Google search terms for AdSenseTM…and so much more!

In this guide, my goal is to give you a blueprint of what AdSpyTracker can do for you. By no means is this an all-encompassing guide, but it should give you enough information to do some serious damage in the ad-publishing world.

All right – are you read to get started? Let’s get to it!

Copyright © 2008 www.AdSpyTracker.com. All Rights Reserved.

AdSpyTracker

Page 4

Table Of Contents

• Installing AdSpyTracker ............................................................................ 5
Step #1: Setting Up a MySQL Database ................................................... 5 Step #2: Uploading AdSpyTracker to Your Server ............................ 9 Step #3: Running AdSpyTracker Setup ................................................. 10 Step #4: How To Track Your Ads .............................................................. 12

• AdSpyTracker Features............................................................. 14
Settings ......................................................................................................................... 14 AdUnits and AdLinks............................................................................................ 15 AdSenseTM for Search.......................................................................................... 23

Copyright © 2006 www.AdSpyTracker.com. All Rights Reserved.

Page 5

AdSpyTracker

Installing AdSpyTracker
Important Note: You do NOT have to install AdSpyTracker on every domain that you plan to track. You simply need to install it on only ONE domain and then place the code that we provide you on all of the domains and pages that you wish. AdSpyTracker will automatically separate each of your domain stats within the software. Installation Demo Videos If you would prefer to watch demo videos for installing AdSpyTracker, please visit http://www.adspytracker.com/videos.htm Here, you will find instructional videos for installing the software onto your server. Frequently Asked Questions [FAQ] You can find the FAQ for Adspytracker at http://www.adspytracker.com/FAQ.htm

STEP #1: SETTING UP A MYSQL DATABASE
This step is only necessary if you want to create a new database for AdSpyTracker. If you’re not sure whether or not you want to create a new database, then please continue with this step. Most users will not skip this step. However, if you are an advanced user and you are going to use a pre-existing database, you may move on to step #2. 1. Login to your cPanel. To do this, you will need to go to your web browser and type the following into the address bar: http://www.YOURDOMAIN.com/cpanel Note: Most web hosts use cPanel, but if you are a user whose web host does not, please contact them and ask them how to set up a MySQL database. Many times, there will be “database settings” in your account admin section if your web host does not use cPanel. After you have logged into your cPanel, your cPanel will look similar to the image below, with a list of icons. Select “MySQL Database”. This will take you to your database settings where you will be able to create a MySQL database.

Copyright © 2008 www.AdSpyTracker.com. All Rights Reserved.

AdSpyTracker

Page 6

Once you click on the MySQL Database icon, you will be taken to a screen that looks similar to the following:

Copyright © 2006 www.AdSpyTracker.com. All Rights Reserved.

Page 7

AdSpyTracker

2. Type the name of your Database in the field titled, “Db:”. Note: I recommend you name this “adspy” (without the quotes) so you can easily remember it. Once you’ve named your Database, click “Add Db”.

After adding the database, this will take you to a screen where you need to click “Go Back” to return to the previous screen.

3. Now, you need to create a username and password. Below “Users:”, enter a new username and password. Then, click “Add User”. The screen will look like the image below.

Copyright © 2008 www.AdSpyTracker.com. All Rights Reserved.

AdSpyTracker

Page 8

After adding your new username and password, this will take you to a screen where you need to click “Go Back” to return to the previous screen.

4. Give the user Permissions to your database. To do this, click on the “User:” drop-down list. Select the user you just created. Then, click on the “Db:” drop-down list and Select the database you created. Once you have done this, make sure that the check-box labeled “ALL” in the Privileges section IS SELECTED. It should look like the following:

Once you have done this, click “Add User to Db”
Copyright © 2006 www.AdSpyTracker.com. All Rights Reserved.

Page 9

AdSpyTracker

5. Great job! You have just successfully created a new MySQL Database. Be sure to write down the FULL MySQL database name and the FULL username (and password) you created. Your “FULL” database name will probably look something like: yourhost_adspy Your “FULL” username will probably look something like: yourhost_username

STEP #2: UPLOADING ADSPYTRACKER TO YOUR SERVER
This part is very easy, especially if you’ve ever uploaded anything to your server (web site) before – and chances are you probably have. 1. Open up your FTP client. I personally use SmartFTP, but almost all FTP clients are similar. Other popular ones include WS_FTP and CuteFTP. 2. Create a directory (folder) called “adspy” in your server. Remember, you only need to add this directory to ONE domain. So if you have more than one domain on your server, you only need to add this directory to one of them. This is where you will upload all of the AdSpyTracker scripts (files). 3. Upload the robots.txt file to your root directory at the domain you’re installing AdSpyTracker to. For example, if you’re installting it at www.yourdomain.com, then upload robots.txt to your "public_html" directory so that the file is found at www.yourdomain.com/robots.txt Important: If you already have a robots.txt file on your site, then simply add the contents of our robots.txt file to the robots.txt file that you previously used. This will prevent the search engine spiders from indexing your Adspytracker software directory. 4. After you have unzipped the AdSpyTracker archive, upload all of these files to your newly created “adspy” directory. 5. Once all of the files are uploaded, you will need to Change the CHMOD permissions (aka WRITE privileges). You will need to change the CHMOD permissions to 777 for the following folders:

Folder • /libs/ • smarty/template/templates_c/

Copyright © 2008 www.AdSpyTracker.com. All Rights Reserved.

AdSpyTracker

Page 10

To do this, simply click on the file or folder and then execute the FTP command for this manually. Many times, you can Right-Click on the file or folder that you want to change permissions to. Then you choose “Properties/CHMOD”. And this will bring up a window that looks similar to this:

Simply change the permissions number to 777, so that “Read, Write and Execute” permissions are given to the everyone. Or you can put a check next to “Read, Write, and Execute” for User, Group, and Other.

5. That’s all. You’re DONE with this step. Great job!

STEP #3: RUNNING ADSPYTRACKER SETUP
This is by far the easiest part! 1. Direct your web browser to the following URL address: http://www.yourdomain.com/adspy/setup.php

Copyright © 2006 www.AdSpyTracker.com. All Rights Reserved.

Page 11

AdSpyTracker

This will automatically install the scripts onto your server by running the “setup.php” file that’s in the main directory of AdSpyTracker. If you did not name your directory, “adspy”, then simply replace that text with the name of your directory. This will bring up the following screen:

2. Insert your database information into the appropriate field. MySQL Host: your database server. (probably “localhost”) Note: For most all web hosts, this will be “localhost”. However, if your web host does not use “localhost” as their server, then you will need to contact them for this information. More often than not, this field will be filled with “localhost”. MySQL Username: this is the FULL username that you created in Step #1 MySQL Password: this is the password that you created in Step #1 MySQL Database: this is the FULL database name that you created in Step #1 Login Username: create a new login username that you will use to each time you login to your AdSpyTracker account.

Copyright © 2008 www.AdSpyTracker.com. All Rights Reserved.

AdSpyTracker

Page 12

Login Password: create a new password that you will use each time you login to your AdSpyTracker account. 3. Click on “Setup DB”. This will install the scripts onto your server. Once you’ve done this, you should see a message that says:

Simply click the link that says, “Login”, and you can Login to your account.

STEP #4: HOW TO TRACK YOUR ADS
This step will show you exactly how to place the code onto your sites so you can start tracking your ads. The AdSpyTracker code should ONLY be on each webpage ONE time total. Even if you have more than one Adsense code block on your webpage, the AdSpyTracker code should only be placed onto the webpage once. See below for the proper placement of this code. 1. FOR ADSENSETM for ADUNITS and ADLINKS A. Place the following code directly BELOW the LAST line of the LAST
Copyright © 2006 www.AdSpyTracker.com. All Rights Reserved.

Page 13

AdSpyTracker

occurrence of your AdSenseTM code: <script type=“text/javascript” src='http://www.YOURDOMAIN.com/adspy/adspy.php'></ script> If you place the code on the page more than once, then your statistical data will not be very accurate. Once the code is placed into the proper position, it should look similar to below:

2. FOR ADSENSETM for SEARCH.
If you have both AdUnits (or AdLinks) and Adsense for Search on your pages, you still ONLY need ONE Adspytracker code on your webpages. If your Adsense for Search code is the last occurrence of Adsense on your webpage, then you will put the Adspytracker code below that. The last line of the AdSenseTM for Search code looks a bit different than the AdUnits or AdLinks code. See the screenshot below. Once the code is placed into the proper position below the Adsense for Search code (only one time in total on your webpage), it should look similar to this:

Copyright © 2008 www.AdSpyTracker.com. All Rights Reserved.

AdSpyTracker

Page 14

AdSpyTracker Features

SETTINGS SCREEN:
Before you can start using AdSpyTracker, you must first setup the scripts by following the installation steps we discussed earlier.

Copyright © 2006 www.AdSpyTracker.com. All Rights Reserved.

Page 15

AdSpyTracker

LOGIN SCREEN:

Before you can use AdSpyTracker, you must first login by using the user name and password you created when you installed and setup the script.

MAIN INTERFACE:

Copyright © 2008 www.AdSpyTracker.com. All Rights Reserved.

AdSpyTracker

Page 16

The main interface is where you will view all of the data that AdSpyTracker has gathered and reported for you. There are several sections within the main interface that include the following:

SELECT DATE RANGE:

Allows you to select the time frame that you would like to gather data from. You can choose to view data reports from only today, yesterday, last week, last month, last year, or up to several months, or years at a time. After you’ve chosen your date range, click on the “Select” button. To View All statistics , click “Show All”. This will set the date from the time of your first installation to the present day.

RESET DOMAIN STATISTICS:
This will erase all data and statistics for the selected domain. You can only reset one domain at a time. In order to do this, you must first select a domain that you would like to reset the statistics for. Then, click the “Reset Domain Statistics” button. If you would like to reset ALL data for every domain, simply click the “Settings” button in the top navigation menu, and then select “Setup DB” from next screen.

SHOW STATS FOR SELECTED DOMAINS:
To show stats for the selected domains, you need to first choose the domain from the dropdown menu. Once you’ve selected the domain, simply click “Filter”. This will bring up the stats for the chosen domain. Note: Domains will not appear in the list until statistics have been reported for that domain.

AdUnits and AdLinks Drop-Down Menu:
ADUNITS:
This drop-down menu allows you to view data reports for your AdSenseTM for Content - AdUnits.

Copyright © 2006 www.AdSpyTracker.com. All Rights Reserved.

Page 17

AdSpyTracker

ADLINKS:
This drop-down menu allows you to view data reports for your AdSenseTM for Content - AdLinks.

ADSENSETM FOR SEARCH:
This drop-down menu allows you to view data reports for your AdSenseTM for Search. See the special help section later in this manual.

AdSense AdUnits

AdSense AdLinks

DOMAIN SUMMARY:
Shows stats for the domains that your ads were shown on. The data for this report table is listed with the following categories: Domain Page: The domain that the clicks are tracking for. Views: This is the number of times that the pages containing your ads were loaded or viewed by your visitors for the chosen time period. % of Views: This is the percentage of the total number of views for this particular report. Ad Clicks: This is the number of ad clicks that have been reported for the chosen time period. % of Clicks: This is the percentage of the total number of ad-clicks for this particular report CTR: This is the click-through rate (percentage). In other words, it is the number of clicks an ad unit receives divided by the number of times the ad unit is shown (views).

Copyright © 2008 www.AdSpyTracker.com. All Rights Reserved.

AdSpyTracker

Page 18

DIRECTORY of DOMAIN URL:
Shows stats for the directories of the URLs you’re your ads were viewed on. The data for this report table is listed with the following categories: Directory of URL: This is the directory of the URL that the ads were viewed on. For example: If your ads were viewed on www.yourdomain.com/Articles/article1.htm , then the Directory of Domain URL would be www.yourdomain.com/Article/. Views: This is the number of times that the pages containing your ads were loaded or viewed by your visitors for the chosen time period. % of Views: This is the percentage of the total number of views for this particular report. Ad Clicks: This is the number of ad clicks that have been reported for the chosen time period. % of Clicks: This is the percentage of the total number of ad-clicks for this particular report CTR: This is the click-through rate (percentage). In other words, it is the number of clicks an ad unit receives divided by the number of times the ad unit is shown (views).

PAGE WITH ADS:
Shows stats for the web page from which your ads are being viewed. The data for this report table is listed with the following categories: Page with Ads: This is the web page from which your ads are being viewed. Views: This is the number of times that the pages containing your ads were loaded or viewed by your visitors for the chosen time period. % of Views: This is the percentage of the total number of views for this particular report. Ad Clicks: This is the number of ad clicks that have been reported for the chosen time period. % of Clicks: This is the percentage of the total number of ad-clicks for this particular report CTR: This is the click-through rate (percentage). In other words, it is the number of clicks an ad unit receives divided by the number of times the ad unit is shown (views).

DATE:
Shows stats from the dates that your ads were viewed. The data for this report table is listed with the following categories:
Copyright © 2006 www.AdSpyTracker.com. All Rights Reserved.

Page 19

AdSpyTracker

Date: This is the date that your ads were clicked Views: This is the number of times that the pages containing your ads were loaded or viewed by your visitors for the chosen time period. % of Views: This is the percentage of the total number of views for this particular report. Ad Clicks: This is the number of ad clicks that have been reported for the chosen time period. % of Clicks: This is the percentage of the total number of ad-clicks for this particular report CTR: This is the click-through rate (percentage). In other words, it is the number of clicks an ad unit receives divided by the number of times the ad unit is shown (views).

HOUR:
Shows stats from the hour that your ads were clicked. The data for this report table is listed with the following categories: Hour: This is the hour that your ads were clicked Views: This is the number of times that the pages containing your ads were loaded or viewed by your visitors for the chosen time period. % of Views: This is the percentage of the total number of views for this particular report. Ad Clicks: This is the number of ad clicks that have been reported for the chosen time period. % of Clicks: This is the percentage of the total number of ad-clicks for this particular report CTR: This is the click-through rate (percentage). In other words, it is the number of clicks an ad unit receives divided by the number of times the ad unit is shown (views).

AD FORMATS:
Shows stats for the formats of your ads that were viewed on your page. The data for this report table is listed with the following categories: Ad Format: This is the format of the ad that was viewed on your page. These are in Width x Height. ColorBorder: This is the color of the border of your ad unit ColorBg: This is the color of the background of your ad unit ColorLink: This is the color of the link found in your ad unit (this is the “title” of the ad) ColorURL: This is the color of the URL found in your ad unit ColorText: This is the color of the text of your ad unit.
Copyright © 2008 www.AdSpyTracker.com. All Rights Reserved.

AdSpyTracker

Page 20

Views: This is the number of times that the pages containing your ads were loaded or viewed by your visitors for the chosen time period. % of Views: This is the percentage of the total number of views for this particular report. Ad Clicks: This is the number of ad clicks that have been reported for the chosen time period. % of Clicks: This is the percentage of the total number of ad-clicks for this particular report CTR: This is the click-through rate (percentage). In other words, it is the number of clicks an ad unit receives divided by the number of times the ad unit is shown (views).

SELECTED AD URL:
Shows stats from the exact URL of the ad that was clicked by your visitor. The data for this report table is listed with the following categories: Ad URL: The URL of the advertisement that was clicked by your visitor. If the ad was clicked by a visitor using FireFox or Internet Explorer 7, this will say “Unknown (FireFox)” or “Unknown (Internet Explorer 7)”. Ad Clicks: This is the number of ad clicks that have been reported for the chosen time period % of Clicks: This is the percentage of the total number of ad-clicks for this particular report

REFERRING URL:
Shows the stats from the referrel URL that your visitors came from. This shows you how your visitors reached your web page. The data for this report table is listed with the following categories: Referring URL: This is the exact referral URL that your visitor came from. If it says (direct hit/email hit) then it means your visitor directly typed in your site’s URL or they visited your site by clicking on a link in their email provider. Views: This is the number of times that the pages containing your ads were loaded or viewed by your visitors for the chosen time period. % of Views: This is the percentage of the total number of views for this particular report. Ad Clicks: This is the number of ad clicks that have been reported for the chosen time period. % of Clicks: This is the percentage of the total number of ad-clicks for this particular report CTR: This is the click-through rate (percentage). In other words, it is the number of clicks an ad unit receives divided by the number of times the ad
Copyright © 2006 www.AdSpyTracker.com. All Rights Reserved.

Page 21

AdSpyTracker

unit is shown (views).

REFERRING DOMAIN:
Shows stats of the domain that referred your visitors. Instead of showing you each and every referring URL, you can view which domains were the most popular referrers. The data for this report table is listed with the following categories: Referring Domain: This is the domain that referred your visitor. . If it says (direct hit/email hit) then it means your visitor directly typed in your site’s URL or they visited your site by clicking on a link in their email provider. Views: This is the number of times that the pages containing your ads were loaded or viewed by your visitors for the chosen time period. % of Views: This is the percentage of the total number of views for this particular report. Ad Clicks: This is the number of ad clicks that have been reported for the chosen time period. % of Clicks: This is the percentage of the total number of ad-clicks for this particular report CTR: This is the click-through rate (percentage). In other words, it is the number of clicks an ad unit receives divided by the number of times the ad unit is shown (views).

REFERRING KEYWORDS:
Shows stats of the exact keywords that led your visitors to your web page, if they were referred by a search engine. The data for this report table is listed with the following categories: Referring Keywords: If the visitor reached your page from a search engine, this shows the exact keywords that referred your visitor to your web page. Views: This is the number of times that the pages containing your ads were loaded or viewed by your visitors for the chosen time period. % of Views: This is the percentage of the total number of views for this particular report. Ad Clicks: This is the number of ad clicks that have been reported for the chosen time period. % of Clicks: This is the percentage of the total number of ad-clicks for this particular report CTR: This is the click-through rate (percentage). In other words, it is the number of clicks an ad unit receives divided by the number of times the ad unit is shown (views).

Copyright © 2008 www.AdSpyTracker.com. All Rights Reserved.

AdSpyTracker

Page 22

IP ADDRESSES:
Shows stats for your Unique Visitor ratio. That is, you will be able to see the unique visitors who clicked on your ads by viewing their IP addresses. The data for this report table is listed with the following categories: IP Address: This is the IP addresses of the visitors who clicked on your ad units. Ad Clicks: This is the number of ad clicks that have been reported for the chosen time period. % of Clicks: This is the percentage of the total number of ad-clicks for this particular report

CLICK DETAILS:
Shows a comprehensive report of detailed statistics for each and every click. The data for this report table is listed with the following categories: IP: This is the IP addresses of the visitors who clicked on your ad units. Ad: For AdUnits, this is the exact ad URL that was clicked by your visitor. For AdLinks, this is the title of the AdLink that was clicked by your visitor Page with Ads: This is the web page from which your ads are being viewed. Date: Shows stats from the dates that your ads were viewed. Hour: This is the hour that your ads were clicked Referring Keywords: If the visitor reached your page from a search engine, this shows the exact keywords that referred your visitor to your web page. Referring URL: This is the exact referral URL that your visitor came from. If it says (direct hit/email hit) then it means your visitor directly typed in your site’s URL or they visited your site by clicking on a link in their email provider.

AdSenseTM for Search Drop-Down Menu:
This menu contains all the same catergories as AdUnits and AdLinks excluding “AdFormats” and “Selected Ad URL”. However, this menu contains two additional categories titled, “Search Terms” and “Search Details”. They are described below.

AdSense for Search

Copyright © 2006 www.AdSpyTracker.com. All Rights Reserved.

Page 23

AdSpyTracker

SEARCH TERMS:
Shows stats of the terms that your visitors searched for from your web page.

SEARCH DETAILS:
Shows a comprehensive report of detailed statistics for each and every search that your visitor performed from your site. That wraps up the features contained within AdSpyTracker. Please visit http://www.adspytracker.com/support/ for any technical questions that you may have. Enjoy the software!

Matt Callen

Copyright © 2008 www.AdSpyTracker.com. All Rights Reserved.

Sign up to vote on this title
UsefulNot useful