AdServer

- System-Voraussetzungen
- Installation
- AdServer in Ihre Seiten integrieren
- Accounts hinzufügen / löschen / bearbeiten / archivieren
- Gruppen hinzufügen / löschen

System-Voraussetzungen:
Um AdServer einsetzen zu können benötigen Sie einen Server mit PHP3 oder PHP4 und MySQL Unterstützung.

Installation:
Öffnen Sie die Datei "connect.inc" mit einem gewöhnlichen Texteditor. Sie werden nun eine Reihe von Variablen sehen, die Sie bitte ausfüllen.

$server_path (Die Url zum AdServer-Verzeichnis)
$datei_endung (Die Dateiendung der AdServer-Dateien)
$banner_target (Wo soll die Ziel-Seite geöffnet werden z.B. "_blank", "_new")
$banner_height (Bannergröße (wenn egal einfach leer lassen))
$banner_width (Bannerbreite (wenn egal einfach leer lassen))
$admin_user (der von Ihnen gewünschte Username)
$admin_pass (das von Ihnen gewünschte Passwort)
$admin_email (Ihre E-Mail Adresse)
$admin_subject (Betreff für die Bestätigungsmail an die Sponsoren)
$prioritaet (Wenn Sie Prioritäten verwenden möchten setzen Sie die Variable auf "1", andernfalls auf "0")
$db_host (Datenbank Host)
$db_user (Datenbank Benutzername)
$db_pass (Datenbank Passwort)
$db_name (Datenbank Name)
$table_accounts (Name der ersten Tabelle)
$table_banner (Name der zweiten Tabelle)
$table_groups (Name der dritten Tabelle)
$table_stats (Name der vierten Tabelle)

Die Tabellennamen können im Allgemeinen bei den Standarteinstellungen belassen werden.

Standartmäßig ist die Dateiendung der AdServer-Dateien ".php"! Sollten Sie diese Endung aus irgendeinem Grund ändern wollen, so ersetzen Sie bitte alle Dateien mit der Endung ".php" durch die von Ihnen gewünschte Endung und tragen die neue Dateiendung in die Variable "$datei_endung" ein!
Ändern Sie auf keinen Fall den Namen der Dateien mit der Endung ".inc"!

Beachten Sie auch, dass alle Beispiele in dieser Anleitung von der Dateiendung ".php" ausgehen. Korrigieren Sie bei Bedarf einfach die Endungen!

Jetzt speichern Sie die Datei und laden alle Dateien auf Ihren Server.
Anschließend rufen Sie die Datei "create.php" über Ihren Browser auf - das war alles! AdServer ist nun betriebsbereit.

AdServer in Ihre Seiten integrieren:
Es gibt vier Möglichkeiten AdServer in Ihre Seiten zu integrieren:
1. per SSI
2. per IFRAMES
3. per PHP-Include
4. per JavaScript

1. Falls Sie in Ihren Seiten bereits SSI verwenden, können Sie folgenden Code an die Stelle schreiben, wo später der Banner erscheinen soll:
- Wenn AdServer im cgi-bin Verzeichnis liegt:


Beispiel:

- Wenn AdServer nicht im cgi-bin Verzeichnis liegt:

Beispiel:

2. Falls Sie kein SSI verwenden können / wollen, gibt es auch noch die Möglichkeit IFRAMES zu nutzen. Dazu fügen Sie an die Stelle wo der Banner erscheinen soll, folgendes ein:

<iframe id="AdServer" src="pfad zu adserver.php" height="höhe" width="breite" marginwidth="0" marginheight="0" clip="breite,höhe" border="0" frameborder="0" scrolling="no">
<ilayer id="adtemp" visibility="hidden" width="breite" height="höhe" border="0" scrolling="no" bordercolor="#000000">
</ilayer>
</iframe>

Und zwischen </body> und </html> fügen Sie folgendes ein:

<layer id="AdServer" src='pfad zu adserver.php' visibility=hidden width=468 onload="moveToAbsolute(adtemp.pageX,adtemp.pageY); AdServer.clip.height=60; AdServer.clip.width=468; visibility='show';"> </layer>

Beispiel:

Möchten Sie mehrere Banner auf einer einzelnen Seite einbinden, so fügen Sie nochmals die beiden Codes an die oben beschriebenen Stellen ein. Im ersten Teil des Codes müssen Sie allerdings eine andere ID wählen! Also statt "AdServer" bzw. "adtemp" z.B. "AdServer2" und "adtemp2"! Im zweiten Teil des Codes würden Sie dann ebenfalls "AdServer" durch "AdServer2" und "adtemp" durch "adtemp2" ersetzen! Achten Sie auf Groß- und Kleinschreibung! Sie dürfen z.B. nicht "adserver/adserver.php" ersetzen (da es kleingeschrieben ist)!

3. Als weitere Möglichkeit können Sie AdServer auch per PHP-Include in Ihre Seiten einbinden (dies ist z.B. sinnvoll, wenn Sie eine hauptsächlich auf PHP basierende Website haben). Folgendes fügen Sie in Ihre Seite ein:

An den Anfang der Seite (in den Codebereich):

require("pfad zu adserver_php.php");

An die Stelle wo der Banner erscheinen soll:

$reqid = "reqid";
$group = "group";
adserver_ad();

Beispiel:

<?
require("adserver/adserver_php.php");
.....
.....
.....
$reqid = "";
$group = "oben_rechts";
adserver_ad();
.....
.....
?>

Achtung:
Es ist notwendig, dass bereits eine Datenbankverbindung besteht! Falls dies nicht der Fall sein sollte, fügen Sie bitte folgendes ganz oben in den Codebereich der Seite ein:

require("pfad zu connect.inc");

z.B.:

require("adserver/connect.inc");

4. Als letzte Möglichkeit können Sie AdServer per Javascript in Ihre Seite einbinden. Dazu fügen Sie an die Stelle der Seite wo der Banner erscheinen soll folgenden Code ein:

Beispiel:

Achtung:
Dies funktioniert nur, wenn JavaScript im Browser des Besuchers aktiviert ist!

Optionale Angaben:
Alle Optionalen-Angaben werden im Code direkt hinter "adserver.php" geschrieben!

1.) ?reqid=Account
Dieser Code erzwingt die Einblendung des Accounts "Account"! Beispiel: adserver.php?reqid=1004

2.) ?group=Gruppe
Dieser Code erzwingt die Einblendung eines Accounts aus der Gruppe "Gruppe"! Beispiel: adserver.php?group=oben_rechts

3.) ?refresh=SEKUNDEN
Wenn Sie AdServer per Iframe in Ihre Seite eingebunden haben, wird nach einem bestimmten Zeitraum ein weiterer Banner geladen. Bei allen anderen Einbindungsmöglichkeiten, wird die ganze Seite erneut geladen!
Beispiel:
adserver.php?refresh=20
adserver.php?group=oben&refresh=20

Accounts hinzufügen:
Um einen neuen Account hinzuzufügen gehen Sie einfach in das Administrations-Menü (admin.php). Geben Sie die bei der Installation angegebenen Benutzerdaten ein und klicken Sie auf den Button. Anschließend klicken Sie auf den Button "Account anlegen".

Sie haben nun die Möglichkeit einen neuen Account zu erstellen, indem Sie einfach die Formular-Felder ausfüllen.

1.) Passwort
Hier geben Sie das Passwort an, mit dem der Kunde später seine Statistiken abrufen kann.

2.) Kunde
Hier können Sie die Firma oder den Namen Ihres Kunden eintragen.

3.) E-Mail
Hier tragen Sie die E-Mail Adresse des Kunden ein. Sobald der Account hinzugefügt wurde, wird der Kunde eine Bestätigungsmail mit den Zugangsdaten zum Statistik-Bereich erhalten. Die E-Mail wird aus der Datei mail.dat generiert. Sie können diese Datei nach Ihren Wünschen modifizieren.

4.) Einblendungen
Wenn der Kunde eine bestimmte Anzahl an Einblendungen gebucht hat, können Sie die Anzahl hier eintragen. Ansonsten lassen Sie die "0" stehen.

5.) Klicks
Wenn der Kunde eine bestimmte Anzahl an Klicks gebucht hat, können Sie die Anzahl hier eintragen. Ansonsten lassen Sie die "0" stehen.

6.) Start-Datum
Wenn der Account erst ab einem bestimmten Datum auf Ihrer Seite eingeblendet werden soll, können Sie hier das Start-Datum eintragen. Ansonsten lassen Sie die Vorgabe stehen.

7.) Bis Datum
Wenn der Kunde Werbung für einen bestimmten Zeitraum gebucht hat, können Sie hier das Datum eintragen, bis zu dem die Werbung geschaltet werden soll. Ansonsten lasse Sie die Vorgabe stehen.

8.) Start-Uhrzeit
Hier können Sie einstellen, ab welcher Uhrzeit der Banner eingeblendet werden soll.

9.) Bis Uhrzeit
Hier können Sie einstellen, bis zu welcher Uhrzeit der Banner eingeblendet werden soll.

Achtung: Die "Start-Uhrzeit" muss kleiner sein als die "Bis Uhrzeit"!
Es sind also nur Zeitspannen innerhalb eines Tages möglich!

Richtig: 9-16 Uhr
Falsch: 22-7 Uhr

10.) Banner Url
Hier tragen Sie die Url zum Banner des Kunden ein.

11.) Linkziel
Hier tragen Sie die Url ein, auf die der Surfer kommen soll, wenn er das Banner anklickt.

12.) ALT-Text
Hier können Sie den Text eintragen, den Surfer sehen wenn der Banner noch nicht geladen ist, oder sie Grafiken ausgeschaltet haben.

13.) Priorität
Wenn Sie Prioritäten bei der Installation aktiviert haben, können Sie hier einstellen, mit welcher Priorität der Account behandelt werden soll. Je höher der Wert, desto häufiger wird der Banner angezeigt.

14.) HTML-Banner
Hier können Sie den HTML-Code eintragen, der anstatt eines Banners angezeigt werden soll.

15.) Einblenden
Markieren Sie "Grafik Banner", wenn der Grafik Banner eingeblendet werden soll, oder markieren Sie "HTML-Banner", wenn der HTML-Banner eingeblendet werden soll.

Wenn Sie alles ausgefüllt haben, klicken Sie auf den Button "Account hinzufügen". Sie haben nun die Möglichkeit den Account den einzelnen Gruppen zuzuordnen (siehe Gruppen hinzufügen / löschen). Eine Mehrfachauswahl ist mit gedrückter "Strg-Taste" möglich. Soll der Account keiner Gruppe zugeordnet werden, markieren Sie keine der Gruppen. Jetzt klicken Sie auf "Speichern".

Der Account ist jetzt erfolgreich in das System integriert!

Achtung: Der Account 1000 hat eine Sonderrolle! Er ist der Standard-Account und wird immer dann eingeblendet, wenn alle anderen Accounts abgelaufen sind! Auch wenn er selbst bereits abgelaufen ist!

Accounts löschen
Um einen bestehenden Account zu löschen klicken Sie im Administrations-Menü auf den Button "Accounts löschen". Es wird Ihnen eine Liste aller Accounts, sowie deren Status (aktiv oder abgelaufen) ausgegeben. Wenn Sie einen Account löschen möchten, markieren Sie einfach die Checkbox für den jeweiligen Account und klicken auf "Account löschen". Möchten Sie alle Accounts löschen genügt ein Klick auf den Button "Alle löschen".

Accounts bearbeiten
Sie können bestehende Accounts bearbeiten, indem Sie im Administrations-Menü auf den Button "Accounts bearbeiten" klicken. Ihnen wird eine Liste aller Accounts ausgegeben. Klicken Sie auf die Nummer des Accounts, welchen Sie bearbeiten möchten. Anschließend erscheint eine Seite, auf der Sie alle Einstellungen des Accounts modifizieren können.

Accounts archivieren
Um einen bestehenden Account zu archivieren klicken Sie im Administrations-Menü auf den Button "Accounts löschen". Es wird Ihnen eine Liste aller Accounts, sowie deren Status (aktiv oder abgelaufen) ausgegeben. Wenn Sie einen Account archivieren möchten, markieren Sie einfach die Checkbox für den jeweiligen Account und klicken auf "Account archivieren". Der Account wird von nun an weder auf Ihrer Website oder in der AdServer-Administration angezeigt - nur Statistiken des Accounts sind weiterhin abrufbar. Möchten Sie eine Liste der Archivierten-Accounts anzeigen, so klicken Sie im "Accounts löschen"-Menü auf den Button "Archivierte Accounts zeigen"!

Gruppen hinzufügen
Gruppen sind für Sie interessant, wenn Sie AdServer auf mehr als nur einer Seite einsetzen möchten, Sie mehrere Banner auf einer Seite einblenden möchten, oder wenn Sie verhindern wollen, dass bestimmte Banner auf einer bestimmten Seite eingeblendet werden.

Um eine neue Gruppe anzulegen klicken Sie im Administrations-Menü auf den Button "Gruppen administrieren". Auf der darauf folgenden Seite haben Sie nun die Möglichkeit eine neue Gruppe anzulegen. Geben Sie einfach den Namen der Gruppe in das Formular-Feld ein und klicken Sie auf "Hinzufügen". Die neue Gruppe wurde nun erfolgreich eingerichtet. Bestehende Accounts können im Menü "Accounts bearbeiten" (siehe Accounts bearbeiten) auch noch im Nachhinein neuen Gruppen zugeordnet werden.

(siehe AdServer in Ihre Seiten integrieren)

Gruppen löschen
Um eine Gruppe zu löschen klicken Sie im Administrations-Menü auf den Button "Gruppen administrieren" und anschließend auf den Button "Gruppen löschen". Es wird Ihnen eine Liste aller Gruppen ausgegeben. Wenn Sie eine Gruppe löschen möchten, markieren Sie einfach die Checkbox für die jeweilige Gruppe und klicken auf "Gruppe löschen". Möchten Sie alle Gruppen löschen genügt ein Klick auf den Button "Alle löschen".

Bei weiteren Fragen wenden Sie sich bitte an info@php-adserver.de