PLUGIN: PPC Feed (“Pay Per Click Add-On”)

Index

1. How does it work?
2. Installation
3. Configuration


1. How does it work?

“Lets you Turn your copy of PowerSeek into an instant PPC Search Engine”

The PPC-Feed plug-in enables you to add instant PPC results to your PowerSeek search results. It gets PPC results from SearchFeed.com or Kanoodle.com (which ever you choose or both) and displays it together with your search results. The PPC links displayed with your search results are targeted. This means that the PPC links displayed are targeted at the keywords that have been searched for with your Search Engine.

“Generate Income with no effort, month after month!”

With a traditional PPC Search Engine you would need to get advertisers to sign up, and manage advertiser accounts. This alone could cost you hours upon hours of work, not to mention the marketing behind getting large amounts of advertisers to sign up.

With the PPC-Feed Plug-in, there is no need to get advertisers or manage anything. You sign up for an account at SearchFeed.com and/or Kanoodle.com. Install and configure the PPC-Feed Plug-in and SearchFeed.com and Kanoodle.com handles the rest. You get paid for every click month after month with no effort on your part. Kanoodle.com and Searchfeed.com has already, and is doing all the work for you. They got and are getting advertisers, managing advertiser accounts and handle all the administrative tasks.

“Ease of Use”

The PPC results from SearchFeed.com and Kanoodle.com are completely customizable via templates. It works in the same manner as PowerSeek’s templates. You can give the PPC results any look and feel you have in mind.

Features:

  • Choose the number of Kanoodle.Com/SearchFeed.com PPC link results you would like with your search results.
     
  • Look and feel of PPC results are completely customizable with templates - Works in the same manner as PowerSeek's link style templates.
     
  • You can include PPC links in your nomatch.html PowerSeek template. This means PPC results will be displayed in the event where nothing in your PowerSeek database matched an end-user's keywords.
     
  • The following options are available for Kanoodle.com PPC link results:
    • Enable Backfill - In the event where there are no PPC links to display, a link will still be displayed.
    • You can choose to include 'adult' PPC links' or choose to display adult PPC links only.

2. Installation

Step 1. UNZIP THE .ZIP ARCHIVE IN WHICH THE PLUGIN CAME

  • Unzip the .zip archive in which the plugin came.

Step 2 - COPY/FTP CGI SCRIPTS

  • Copy/ftp the ps_ppc.pm  file into the /cgi-bin/"pseek" directory.

Step 3 - COPY/FTP CGI ADMIN SCRIPTS

  • Copy/ftp the p_ppc.cgi file into the /cgi-bin/"pseek"/admin/ directory.

Step 4 - SET PERMISSION OF .cgi AND .pm FILES TO 755

  • If you are unsure about this operation please check our Online Documentation for Powerseek under “How do I set/assign permissions to directories and files”

Step 5 - COPY/FTP TEMPLATES

  • Copy/ftp the kanoodle_searchres.html and searchfeed_searchres.html  files into the /data/ directory.

Step 6 - SET PERMISSION OF TEMPLATE FILES TO 777

  • Set the permissions of the kanoodle_searchres.html and searchfeed_searchres.html files that you transferred to 777.
    If you are unsure about this operation please check our Online Documentation for Powerseek under “How do I set/assign permissions to directories and files”.

Step 7 - COPY/FTP HTML IMAGES

  • Copy/ftp the rppc.gif, searchfeed.gif and kanoodle.gif files into your ‘html’ directory.

Step 8 - UPDATE SEARCH SCRIPTS

  • Powerseek uses two scripts for searching. search.cgi and search2.cgi both located in your /cgi-bin directory. Open these files with a unix compatible text based editor like TextPad. Located under the copyright notice there will be this line:
    $use_ppc_plugin = 0;
    The above mentioned line must be updated to equal 1. It should look like this after the update:
    $use_ppc_plugin = 1;
      
    If you move down a few lines you will see a line that reads:
    #use ps_ppc;
    Remove the "#" so the line looks like this:
    use ps_ppc;

Before PPC results can be included you will need to do the steps below:


3. Configuration

Once you have installed the Plug-In apply for an account at SearchFeed.com and/or Kanoodle.com - After you have an account with the above mentioned PPC Search Engines, come back to this section to configure the Plug-In.

To configure the plug-in go to your PowerSeek Control Panel >> Plug-Ins >> Remote PPC Plugin

A popup window will apear with a Kanoodle.com and SearchFeed.com section

Step 1. Kanoodle.com Section Explanation

Enable Kanoodle Feature - If you plan to use Kanoodle search then you should set this to “Yes”. No search results from Kanoodle.com will be returned or displayed unless this option is set to “Yes”.
Affiliate ID Number:

Kanoodle.com ID - Can be found on the right hand side of the Webpage once you have logged into your account.

Number of Search Results to Return - The amount of results to return at a time from Kanoodle.com. The range is from 1 - 10.

Suppress run-of site Results: If your contract with them allows it, you will be able to select to have no popup ads when a search is made, returning only kanoodle.com results. No ads will be shown if the option is set to “Yes”.

Enable BackFill: According to the kanoodle.com documentation they will supplement there own results with those of their back end provider(s). e.g.: You request 10 results, they have 8 bids on file for that keyword. They will deliver 8 paid results and two unpaid results. You should only use this option if it is included in your contract. This will be the result if the option is set to “Yes”.

Include "Adult ONLY" Results: This option will include material that is marked as "Adult Only" if there are any. If this option is set to “Yes”.

Return only Adult Results: This option will return only material that is marked as "Adult Only". If there are no "Adult Only" material it will display nothing. If this option is set to “Yes”.

Edit Links Style - The way that pages and links are displayed in Powerseek are controlled by a network of templates. The PowerSeek template system makes it easy to apply the look and feel you want for your Search Engine & Directory pages. By clicking on the 'click here' link, you can change the PPC link style in the same manner you would edit the links style from the PowerSeek templates.

The Template variables that can be used in this template are listed in the template window for easy reference.

The template name is “kanoodle_searchres.html” and is located in the PowerSeek 'data' directory.

The Template Variables are:

!!kan_title_with_clickurl!!
This variable will show the heading as well as the link to click to kanoodle.com.

!!kan_description!!
Description of the result as provided by Kanoodle.

!!kan_url!!
URL to the Website. Not to Kanoodle but the actual bidders Website.

!!kan_bidprice!!
It shows in US cents the price the bidder will pay for a click through.

!!kan_clickurl!!
The actual "<a href>" link the user will have to click on to register the click through.

!!kan_title!!
The title of the Website.

Step 2. SearchFeed.Com Section Explanation

Enable Searchfeed Feature - If you plan to use Searchfeed search then you should set this to “Yes”. No search results from Searchfeed.com will be returned or displayed unless this option is set to “Yes”.

Track ID - Searchfeed.com ID. Can be found on the left hands side of the Webpage once you have logged into your account at SearchFeed.com

Account ID - Searchfeed.com ID. Can be found on the left hands side of the Webpage once you have logged into your account at SearchFeed.com

Number of Search Results to Return: The amount of results to return at a time from Searchfeed.com. The range is from 1 - 10.

Edit Links Style - The way that pages and links are displayed in Powerseek are controlled by a network of templates. The PowerSeek template system makes it easy to apply the look and feel you want for your Search Engine & Directory pages. By clicking on the 'click here' link, you can change the PPC link style in the same manner you would edit the links style from the PowerSeek templates.

The Template variables that can be used in this template are listed in the template window for easy reference.

The template name is “searchfeed_searchres.html” and is located in the PowerSeek 'data' directory.

The Template Variables are:

!!searchfeed_title_with_clickurl!!
This variable will show the heading as well as the link to click to Searchfeed.com.

!!searchfeed_description!!
Description of the result as provided by Searchfeed.

!!searchfeed_url!!
URL to the Website. Not to Searchfeed but the actual bidders Website.

!!searchfeed_bidprice!!
It shows in US cents the price the bidder will pay for a click through.

!!searchfeed_clickurl!!
The actual "<a href>" link the user will have to click on to register the click through.

!!searchfeed_title!!
The title of the Website.

Step 3. Configure Your PowerSeek Search Templates

Now that you configured the Kanoodle.Com and/or SearchFeed.com settings and templates, you need to add the PPC search results to your PowerSeek search result templates. To do this, include the search display variables (%%kanoodle_search%% and %%searchfeed_search%%)  into your PowerSeek search results Templates.

You can place the variables in the following templates:

  • Main Search Page (searchres.html)
  • No Match (nomatch.html)

Place the following variables in the above mentioned templates:

  • %%kanoodle_search%%
    This variable should be placed where you want the Kanoodle.com results to be displayed. This may be before or after the Powerseek results.
  • %%searchfeed_search%%
    This variable should be placed where you want the Searchfeed.com results to be displayed. This may be before or after the Powerseek results.

Step 4. Configure Your 'No Match' PowerSeek Template

If you want to include PPC results from Kanoodle.Com and/or SearchFeed.com when end-users searched for keywords where a match could not be found in the PowerSeek database, do the following:

  • Go to the PowerSeek Control Panel >> Settings >> Global Engine Settings
    Look for a setting that reads 'What to use when a search revealed no matches?'
    Set this setting to: 'Use and the template called no_match.html'.
      
  • Go to the template manager and add the variables, %%kanoodle_search%% and %%searchfeed_search%%
    to the no_match.html template where you would like the Kanoodle.com and/or SearchFeed.com search results displayed.