Avoir les 10 mots clefs de la veille en XML avec Piwik

Avoir des donnée de Piwik : appellez l’API !

Les APIs en version libre nous aide beaucoup. Vous pouvez avoir toutes les données assez facilement en appellant une de ces APIs. Il y a différentes façons d’appeller l’API, qui dépend de la technologie que vous utilisez.

Avec les APIs de Piwik il est facile d’avoir :

• les mots clefs en provenance des moteurs de recherche de la dernière semaine
• le top 5 des navigateurs utilisés dans l’année courante
• Le top 10 des pages de votre site Web qui contiennent le mot “blog”, ordonné par ordre croissant
• la liste des sites enregistrés dans Piwik ou la liste des utilisateurs qui ont un accès administrateur sur le site numéro 4
• et plus encore

Vous pouvez avoir les données dans l’un de ces formats :

• XML
• JSON
• CSV
• serialized PHP
• simple HTML

Tutoriel : avoir le top 10 des mots clefs

Ce tutoriel vous montrera comment demander le top 10 des mots clefs de la veille dans le format XML.

Construire l’URL

Pour construire l’URL de l’API, vous avez besoin :

• d’une adresse de base avec Piwik
• Exemple: http://piwik.org/demo/?module=API

• le nom de la méthode que vous voulez appellez. Il possède ce format moduleName.methodToCall (voir la liste des méthode de l’API)
• Exemple: vous voulez récupérer les derniers mots clefs depuis le Referers du plugin. Le paramètre de la méthode est method=Referers.getKeywords

• l’id du site Web
• Exemple: idSite=1

• le paramètre de la date. Il peut être today, yesterday, ou n’importe quelle date au format YYYY-MM-JJ
• Exemple: date=yesterday

• le paramètre de la période. Il peut-être day, week, month ou year
• Exemple: period=day

• le paramètre du format. Definit le format de sortie de nos donnés : XML, JSON, CSV, PHP (serialized PHP), HTML (simple html)
• Exemple: format=xml

• (optionel) le paramètre filter_limit qui definit le nombre de colonnes à retourner
• Exemple: filter_limit=10

L’URL final est http://piwik.org/demo/?module=API&method=Referers.getKeywords&idSite=1&date=yesterday&period=day&format=xml&filter_limit=10

Ici la sortie de notre demande :

<?xml version="1.0" encoding="utf-8" ?>
<result>
        <row>
                <label>piwik</label>
                <nb_uniq_visitors>39</nb_uniq_visitors>

                <nb_visits>41</nb_visits>
                <nb_actions>193</nb_actions>
                <max_actions>27</max_actions>
                <sum_visit_length>13965</sum_visit_length>

                <bounce_count>7</bounce_count>
                <idsubdatatable>147</idsubdatatable>
        </row>
        <row>
                <label>89</label>

                <nb_uniq_visitors>10</nb_uniq_visitors>
                <nb_visits>11</nb_visits>
                <nb_actions>17</nb_actions>
                <max_actions>6</max_actions>

                <sum_visit_length>992</sum_visit_length>
                <bounce_count>9</bounce_count>
                <idsubdatatable>111</idsubdatatable>
        </row>

        <row>
                <label>web+analytics</label>
                <nb_uniq_visitors>8</nb_uniq_visitors>
                <nb_visits>8</nb_visits>

                <nb_actions>32</nb_actions>
                <max_actions>19</max_actions>
                <sum_visit_length>1599</sum_visit_length>
                <bounce_count>4</bounce_count>

                <idsubdatatable>169</idsubdatatable>
        </row>
        <row>
                <label>analytics</label>
                <nb_uniq_visitors>7</nb_uniq_visitors>

                <nb_visits>7</nb_visits>
                <nb_actions>12</nb_actions>
                <max_actions>3</max_actions>
                <sum_visit_length>1055</sum_visit_length>

                <bounce_count>3</bounce_count>
                <idsubdatatable>112</idsubdatatable>
        </row>
        <row>
                <label>open+source+web+analytics</label>

                <nb_uniq_visitors>4</nb_uniq_visitors>
                <nb_visits>4</nb_visits>
                <nb_actions>10</nb_actions>
                <max_actions>3</max_actions>

                <sum_visit_length>687</sum_visit_length>
                <bounce_count>0</bounce_count>
                <idsubdatatable>140</idsubdatatable>
        </row>

        <row>
                <label>open+source+web+2.0</label>
                <nb_uniq_visitors>2</nb_uniq_visitors>
                <nb_visits>2</nb_visits>

                <nb_actions>3</nb_actions>
                <max_actions>2</max_actions>
                <sum_visit_length>74</sum_visit_length>
                <bounce_count>1</bounce_count>

                <idsubdatatable>139</idsubdatatable>
        </row>
        <row>
                <label>web+2.0</label>
                <nb_uniq_visitors>2</nb_uniq_visitors>

                <nb_visits>2</nb_visits>
                <nb_actions>3</nb_actions>
                <max_actions>2</max_actions>
                <sum_visit_length>128</sum_visit_length>

                <bounce_count>1</bounce_count>
                <idsubdatatable>167</idsubdatatable>
        </row>
        <row>
                <label>analytics+</label>

                <nb_uniq_visitors>2</nb_uniq_visitors>
                <nb_visits>2</nb_visits>
                <nb_actions>3</nb_actions>
                <max_actions>2</max_actions>

                <sum_visit_length>84</sum_visit_length>
                <bounce_count>1</bounce_count>
                <idsubdatatable>113</idsubdatatable>
        </row>

        <row>
                <label>piwik+video</label>
                <nb_uniq_visitors>1</nb_uniq_visitors>
                <nb_visits>1</nb_visits>

                <nb_actions>1</nb_actions>
                <max_actions>1</max_actions>
                <sum_visit_length>10</sum_visit_length>
                <bounce_count>1</bounce_count>

                <idsubdatatable>153</idsubdatatable>
        </row>
        <row>
                <label>piwik+live+tracking</label>
                <nb_uniq_visitors>1</nb_uniq_visitors>

                <nb_visits>1</nb_visits>
                <nb_actions>1</nb_actions>
                <max_actions>1</max_actions>
                <sum_visit_length>10</sum_visit_length>

                <bounce_count>1</bounce_count>
                <idsubdatatable>152</idsubdatatable>
        </row>
</result>