CAITS PowerCounter
Dokumentation
Diese Dokumentation gibt alle wichtigen Details der Funktionsvielfalt des PowerCounters wieder.
Sie wird stetig aktualisiert und um neue Antworten im Bereich FAQ ergänzt.
Inhaltsverzeichnis dieser Dokumentation
Grundeinstellungen
Damit PowerCount weiß, welche Website gezählt werden soll, müssen Sie in Ihrem Userprofil mindestens eine Domain eingeben, und zwar in der Form
http[s]://[www.]domainname.de[/unterverzeichnis]
- "http://" oder "https://" muß angegeben werden.
- "www." am Anfang der URL kann angegeben werden, muß aber nicht.
- Liegt Ihre Homepage in einem Unterverzeichnis auf dem Webserver, geben Sie dieses Unterverzeichnis mit an.
- Eingegebene Unterverzeichnisse dürfen nicht mit einem "/" abgeschlossen werden.
- Hat Ihre Homepage Unterverzeichnisse, geben Sie diese nicht mit an.
- Geben Sie nie Dateinamen zu einzelnen Seiten ein!
Einige Beispiele:
richtig:
http://www.domain.com
http://meinehomepage.de/meindackel
http://www.subdomain.hauptdomain.net/unterverzeichnis
falsch (Fehler fett hervorgehoben):
http://www.domain.de/index.html - Dateiname wurde angegeben
www.meinehompage.de - http:// am Anfang fehlt
http://domain.mit/unterverzeichnis/und/slash/ - Slash am Ende
Freewebspace-Homepages mit Domainumleitung
Geben Sie einfach alle Adressen zu Ihrer Homepage an, also die Weiterleitungsdomain und die tatsächliche URL zu Ihrer Homepage beim Freehoster (etwa Freecity, Fortune City, t-online.de, arcor.de und so weiter).
Einstellungen im Userprofil
Sichtbarkeit und Erscheinungsbild
Wenn Sie sich in Ihren Userbereich einloggen, finden Sie eine Rubrik namens 'Userprofil'. Hier können Sie
die Basiseinstellungen Ihres Accounts verändern.
Unter anderem finden Sie einen Schalter mit der Bezeichnung 'visible'. Dies ist ein globaler Schalter, mit dem Sie die
generelle Möglichkeit, den Counter anzuzeigen, ein- und ausschalten können,
egal ob als Grafik oder im Textmodus. Wenn Sie diesen Schalter ausschalten, wird der Counter auf keinen Fall irgendwo angezeigt
und arbeitet nur als unsichtbarer Webbug.
Die Defaulteinstellung ist "eingeschaltet" und sollte von den meisten Usern unangetastet gelassen werden. Auch wenn Sie den Counter als unsichtbaren Webbug einsetzen wollen, sollten Sie die Einstellung
auf dem Default belassen, da dies eventuelle Fehlersuche vereinfacht, wenn Sie den Counter doch einmal sichtbar laufen lassen wollen.
Darunter finden Sie eine Dropdownliste mit allen derzeit verfügbaren TrueType-Fonts. Diese Fonts
werden dazu benutzt, den Stil des sichtbaren Counters zu verändern. Im Gegensatz zu anderen Countern, die in der Regel mit fest
vorgefertigten Grafiken arbeiten, bieten wir Ihnen auf diese Weise
die Möglichkeit, Größe, Farbe und Schriftart Ihres Counters selbst frei festzulegen - sie erhalten mit den verschiedenen Farbgebungen,
die Sie ebenfalls frei wählen können, damit eine nahezu unendliche Auswahl an Counterstilen.
HINWEIS:: Falls Ihnen ein bestimmter Stil fehlt, mailen Sie uns an und schicken Sie uns den fehlenden Font - nach einer überprüfung,
ob rechtliche Bedenken gegen die Nutzung sprechen, schalten wir diesen dann für Sie frei.
Farbgebung des Counterimages
Unter der Auswahl der Schriftart finden Sie zwei Farbpaletten, mit denen Sie Vorder- und Hintergrundfarbe des Counters festlegen.
Sie können einfach aus der Farbtabelle einen Wert anklicken oder selbst in Form der vom HTML üblichen drei Schreibweisen einen Wert eingeben, etwa #FF0000 oder "red" für ein knalliges Rot.
Wenn Sie den Schalter 'transparent background' anklicken, wird Ihre Hintergrundfarbe unabhängig vom gewählten Wert auf transparent gesetzt.
Dennoch sollten Sie eine sinnvolle Hintergrundfarbe vorgeben, um den Counter farblich "glatt" in Ihre Webseite zu integrieren.
Noch ein Beispiel für alle drei Notationen:
plain-text: blue
RGB: 00+00+255
Hexadecimal: #0000FF
Vergessen Sie nicht, die '+'-Zeichen einzusetzen, wenn Sie das RGB-Format verwenden, und vergessen Sie den "Gartenzaun" (#) nicht, wenn Sie die
hexadezimale Schreibweise bevorzugen.
Durch einen Klick auf 'Konfiguration speichern' können Sie Ihre Einstellungen direkt mit dem Beispielbild am Ende der Seite überprüfen.
Sichtbarkeit der Statistiken
Seit Ende Dezember 2001 haben Sie weiterhin die Möglichkeit, selbst zu wählen, welche Informationen Ihnen auf den verschiedenen Statistikseiten überhaupt
zusammengestellt werden sollen. Dazu dienen die Auswahlknöpfe unter den Farbtabellen. ein Häkchen bedeutet, die entsprechende Information wird angezeigt, kein Häkchen bedeutet,
diese Tabelle wird nicht generiert.
Sichtbarkeit, mögliche Betriebsarten
Der PowerCouter kann wahlweise als unsichtbarer Webbug (nur in kostenpflichtigen Modellen) oder als sichtbarer Counter auf Ihrer Website eingeblendet werden.
Um den Counter vollständig nutzen zu können müssen Sie seitens Ihres Providers lediglich Javascripte auf Ihrer Homepage ablegen und nutzen dürfen.
Seit Frühjahr 2001 wird auch die Anzeige des Counters im Textmodus - ohne Bild - unterstützt - Sie können selbst wählen, ob
und wie Sie den Counter anzeigen wollen.
Sichtbarkeit und Einbindung des Counters
Zur Inbetriebnahme des Counters binden Sie den Counter mit dem in der Email genannten Code in jede HTML-Seite ein, die Sie unmittelbar nach Ihrer Anmeldung erhalten haben.
Achten Sie hierbei auf die korrekte Schreibweise bei der Einbindung in Ihre HTML-Seiten!
Der in der Email genannte Javascriptcode darf nie in den <HEAD></HEAD>-Bereich einer HTML-Seite eingebaut werden, sondern gehört zwischen <BODY> und </BODY> eingebaut! Achten Sie beim Einbau des HTML-Codes darauf, daß sich keine Zeilenumbrüche mitten in den HTML-Tags und den Befehlen befinden - dies führt bei den meisten Browsern dazu, daß der Counter nicht einwandfrei aufgerufen werden kann und stattdessen eine unschöne Fehlermeldung auf Ihrer Homepage erscheint.
Verwenden Sie zum Einbau des Codes niemals Microsoft Frontpage, da dieser HTML-Editor den Countercode grundsätzlich beschädigt und somit eine einwandfreie Funktion des PowerCounters verhindert!
Haben Sie den Countercode korrekt eingebunden, schickt das kleine Javascript fortan alle wichtigen Besucherinformationen zum PowerCounter.
Diese Informationen, die Sie ja bequem mit Ihrem Login überprüfen können, können Sie zumindest teilweise auch auf Ihrer Webseite sichtbar machen.
In der Folge wollen wir Ihnen erklären, wie dies funktioniert.
Standardmäßig ist der Counter in den kostenpflichtigen Modellen unsichtbar, egal welche Einstellung Sie in Ihrem Profil vorgenommen haben!
Durch den 'visible'-Schalter in Ihrem Profil schalten Sie lediglich die generelle Fähigkeit ein, den Counter anzuzeigen!
Um den Counter auf einer bestimmten HTML-Seite sichtbar zu machen, müssen Sie direkt in dieser Seite entsprechende Parameter
in den Aufruf des Counters einfügen.
Wir verwenden dazu die folgenden zwei Variablen:
showme = 'y|n' und st = 'js|img'.
Die st Variable darf mit folgenden Werten belegt werden:
st='js' für Textausgabe (DEFAULT)
st='img' für Bildausgabe
Wollen Sie den Counter nun auf einer Seite sichtbar machen, müssen Sie showme = 'y' setzen.
showme='n' unsichtbar (DEFAULT)
showme='y' sichtbar
Normalerweise sieht der in die HTML-Seiten einzubindende Code wie folgt aus:
<script language="JavaScript"
src="http://powercounter.milestone-services.de/powercounter.js.php?id=Ihr_Accountname">
</script>
<noscript><img src="http://powercounter.milestone-services.de/powercounter.php?
id=Ihr_Accountname&st=img" /></noscript>
Als unsichtbarer Standardwert ist showme = 'n' und st = 'js' vorgegeben, Ihr Counter
also komplett unsichtbar. Um dies zu ändern verwenden Sie einfach stattdessen den folgenden Code:
<script>showme='y'; st='js'</script>
<script type="text/javascript"
src="http://powercounter.milestone-services.de/powercounter.js.php?id=Ihr_Accountname">
</script>
<noscript><img src="http://powercounter.milestone-services.de/powercounter.php?
id=Ihr_Accountname&st=img" /></noscript>
Dieses Beispiel macht Ihren Counter sichtbar und zeigt ihn im Textmodus an. Genauso funktioniert es auch als Bild,
einfach st auf 'img' setzen - schon erscheint der Counter in dem Stil, den Sie in Ihrem Userprofil eingestellt haben.
Hinweis:
Verwenden Sie NIE die Kombination st='y'; showme='n',
da dies eine unsichtbare 1x1 Pixel Grafik erzeugt! Sauberer ist es, einen unsichtbaren Counter auf dem Standardweg (siehe oben) zu erzeugen.
Anzeige der Daten auf Ihrer Homepage
Nun wissen Sie, wie Sie den Counter selbst sichtbar machen können.
Nehmen wir nun einmal an, Sie haben den PowerCounter-Code am Ende jeder Ihrer Seiten eingebunden und Sie wollen ihn
aber an anderer Stelle Ihrer Webseite anzeigen... oder Sie wollen eine Anzeige, wieviele Besucher sich just in diesem Moment
auf Ihrer Seite befinden oder die Anzahl der heutigen Besucher.
Mit "showhits.php" ist all dies und noch viel mehr möglich!
Die Aufgabe dieses Scripts ist lediglich die Wiedergabe bestimmter Werte ohne selbst den Counter hochzuzählen - eine reine Anzeige also.
showhits.php verändert KEINEN Wert in Ihrem Account, es wird ausschließlich lesend auf die Daten zugegriffen.
HINWEIS: In Ihrem Userprofil muß der Schalter "visible" EINGESCHALTET sein, sonst zeigt showhits.php absolut nichts an!
Es gibt derzeit 2 verschiedene Möglichkeiten showhits.php zu nutzen:
st='js' für Textoutput (DEFAULT)
st='img' für Bildoutput
Die korrekte Anwendung der 2 Modi funktioniert wie folgt:
- JavaScript [
st = 'js']:
<script language="JavaScript"
src="http://powercounter.milestone-services.de/showhits.php?
id=Ihr_Accountname&st=js"></script>
Wichtig: den kompletten Code in eine Zeile ohne Umbrüche schreiben!!
- Image-Tag [
st = 'img']:
<IMG src="http://powercounter.milestone-services.de/showhits.php?
id=Ihr_Accountname&st=img">
Die Variable showme hat keine Wirkung auf showhits.php - sie ist immer auf
'y' gesetzt. Wenn Sie nichts sichtbar machen wollten, würden Sie das Script nicht aufrufen gell? ,-)
Es gibt eine Reihe von Daten, die showhits.php anzeigen kann. Das Script kann
heutige Hits, heutige Pageimpressions, Hits diesen Monat/Pageimpressions diesen Monat, aktuell anwesende
Besucher, komplett alle Pageimpressions seit Installation des Counters, Download Hits etc. anzeigen. Gerade letzteres Feature ist im Zusammenhang mit unserem integrierten Downloadcounter sehr interessant für Downloadarchive.
Je nach Anwendungszweck müssen Sie einfach eine andere Variable in den schon beschriebenen Code einfügen: type
type= hits | pageviews | today | todayviews | month |
monthviews | onlineusr | toplist | mpdl
mpdl= /url_der_anzuzeigenden_downloads
Erläuterung aller Parameter:
hits: zeigt alle Hits an (default)
pageviews: zeigt alle Pageimpressions an
today: zeigt heutige Hits an
todayviews: zeigt heutige Pageimpressions an
month: zeigt Hits dieses Monats an
monthviews: zeigt Pageimpressions dieses Monats an
toplist: zeigt aktuelle Platzierung in der Topliste an
onlineusr: zeigt aktuell anwesende Besucher an
mpdl: zeigt Anzahl Downloads/Klicks an
Zur Veranschaulichung ein weiteres Beispiel: Sie wollen die aktuell anwesenden Besucher als Text
auf Ihrer Webseite anzeigen:
- JavaScript [
st = 'js']:
<script language="JavaScript"
src="http://powercounter.milestone-services.de/showhits.php?
id=Ihr_Accountname&st=js&type=onlineusr"></script>
Wichtig: den kompletten Code in eine einzige Zeile schreiben, ohne Umbrüche!!
Nehmen wir nun an, Sie wollen anzeigen, wieviele Besucher die Datei /files/myfile.zip downgeloaded haben.
Sie wollen diese Anzeige als Bild generieren (selbstverständlich klappt auch dies als Text-Aufruf!):
- Image-Tag [
st = 'img']:
<IMG src="http://powercounter.milestone-services.de/showhits.php?
id=Ihr_Accountname&st=img&mpdl=/files/myfile.zip">
Oder als Textausgabe:
<script
src="http://powercounter.milestone-services.de/showhits.php?
id=Ihr_Accountname&st=js&mpdl=/files/myfile.zip"></script>
Wichtig: den kompletten Code in eine Zeile ohne Umbrüche schreiben!!
URL Behandlung
Dynamische Websites
Ein URL kann in die folgenden Komponenten aufgeteilt werden:
<scheme>://<user>@<host>:<port>/<path>?<query>#<fragment>
Normalerweise wollen die meisten User nicht den kompletten URL in ihre Logfiles einspeichern.
Im Multipage-Listing will man in der Regel keine Unterscheidung nach Querystring machen, z.B.
abc.php?f=4&i=2136&t=2066
wird genauso behandelt wie der Aufruf abc.php oder
abc.php?f=4&i=2000&t=2015.
Daher trennen wir normalerweise den Querystring vom Rest des URL.
Anders sieht es aus, wenn Sie eine dynamische Webseite betreiben, die sich ihren Inhalt aus einer Datenbank holt -
meistens wird das über eine einzige Seite und mit Querystrings erledigt, etwa eine index.php, an die dann Parameter wie zum Beispiel
index.php?artikel=123&absatz=2
angehängt werden.
Hier muß offensichtlich DOCH zwischen verschiedenen Querystrings unterschieden werden.
An dieser Stelle greift die Einstellung namens "short query" in Ihren Usersettings ein. Sie können hier einfach Ihren Querystring eintragen, der
geloggt werden soll und darf. Jeder String kommt dabei in eine eigene Zeile, getrennt wird mit der <ENTER>-Taste.
Ein Beispiel:
http://www.abc.com/abc.php?date=200111&s=d46df4e47043bfab5d08fee9d24e0146&threadid=100&page=news
Date und Page sind die Teile die wir loggen wollen, s= ist eine Session-ID, die sich ja bei jedem Benutzer ändert und die uns aus diesem Grund nicht interessiert.
In Ihren Einstellungen geben Sie nun ein:
short query:
------------
| date |
| page |
------------
Das Ergebnis in den Logs sieht dann so aus:
http://www.abc.com/abc.php?date=200111&page=news
Durch die Angabe von "date" und "page" schneidet der PowerCounter den Querystring
auf diese beiden Werte zusammen und wirft allen nicht erwünschten Ballast kurzerhand weg - so zum Beispiel die erwähnte Session-ID.
Wenn Sie ein "*" in das Feld "Short Query" eingeben, wird nichts abgeschnitten und der komplette Querystring wird ausgewertet.
VORSICHT! Es wird dadurch unter Umständen extrem viele Logeinträge geben, so daß eine sinnvolle Auswertung nicht mehr möglich ist - wir empfehlen daher dringend, die Querystrings wie beschrieben zu verkleinern!
Defaultmäßig ist das "short query"-Feld komplett leer. Auf diese Weise schneidet PowerCounter
den kompletten Queryteil eines URLs ab.
index.* --> /
Eine weitere nette Ergänzung ist dieses Eingabefeld in Ihren Usersettings - speziell für all jene, die
Aufrufe wie http://www.abc.com/index.html als Treffer auf http://www.abc.com/ gewertet haben wollen.
Sie geben einfach alle Ihre Index-Dateien Zeile für Zeile an, die als Treffer auf / gewertet werden sollen:
---------------
| index.html |
| index.php |
| index.phtml |
---------------
Damit wissen Sie alle wichtigen Details zur Einbindung des Counters.
Wenn Sie noch weitere Fragen haben, kontaktieren Sie uns einfach oder besuchen Sie das Support-Forum!
| 
