Archive de la Catégorie ‘Technique’

Informations techniques micropaiement et affiliation

1. MICROPAIEMENT

1.1 Installation du paiement à l’Acte

Le micropaiement à l’acte Rentabiliweb est une solution de paiement sécurisée qui permet de rentabiliser votre site Internet.

Audiotel/SMS+

Vous avez à votre disposition une offre complète internationale.
Le code est dicté par téléphone par un automate vocal.
Par sms : L’utilisateur envoie un mot clé et reçoit le code en retour par sms. Chaque pays établit sa propre facturation.
Vous devez donc choisir les différents paliers que vous allez proposer à vos membres.

Carte bancaire

Nous vous proposons plusieurs paliers différents entre 1.80 et 15 euros.
Si vous désirez utiliser un palier précis supérieur à 3 euros, nous vous invitons à créer un document CB personnalisé (clients premium et prestige).

Remarque : La configuration de Mistercash est couplée à notre solution de carte bancaire.

Paramétrage

Les paramétrages disponibles sont les suivants :

  • Par accès : le code sera valide x fois ;
  • Par jour : le code sera valide pendant x jour(s) à partir de la première saisie dans le formulaire.

1.1.1 Le formulaire de paiement

L’installation du formulaire est très simple et rapide.
Le script contient tous les éléments visuels et techniques du formulaire permettant de sécuriser et rentabiliser votre accès payant.

Trois types de formulaire sont disponibles :

  • Le formulaire classique (popup) : il se présente sous la forme de drapeaux représentant chaque pays, ainsi que d’une zone pour saisir le(s) code(s).
    En cliquant sur un drapeau, l’utilisateur pourra voir les types de paiement disponibles pour son pays dans un popup.
  • Le formulaire iframe : il se compose des mêmes zones que le formulaire classique mais il n’ouvre pas de popup pour afficher les différents moyens de paiement.
    L’utilisateur voit directement le numéro à composer.
    Il intègre également une fonction de géolocalisation affichant uniquement les moyens de paiement disponibles pour le pays de l’utilisateur.
  • Le formulaire Facebook : il possède les mêmes caractéristiques que le formulaire iframe, avec un design différent car étant utilisé pour monétiser les applications Facebook.
    Cependant, il est utilisable sur les sites web classiques par un légère modification du script généré par la plateforme Rentabiliweb (cf. a) Formulaires de paiement).

Voici les paramètres nécessaires pour la validation d’un code dans le formulaire :

  • docId : l’identifiant de votre document ;
  • siteId : l’identifiant de votre site où est configuré le document ;
  • code[n] : le champ permettant à l’utilisateur de saisir le(s) code(s) pour accéder à votre partie payante (n : de 0 à 10).

Voici les paramètres optionnels :

  • noInfos : si ce paramètre est égal à 1, Rentabiliweb ne retournera aucun paramètre lors de la redirection sur la page d’erreur (code, docId, siteId, data) ;
  • data : grâce à ce paramètre, vous pourrez transmettre des informations à vos pages protégées ou à votre page d’erreur. Rentabiliweb retournera la valeur du champ data en méthode GET dans l’url de redirection ;
  • record : Ce paramètre vous permettra d’enregistrer des valeurs qui vous seront retournées dans le journal de codes.
a) Installer le formulaire de paiement

Pour installer un formulaire de paiement, il suffit simplement de faire votre choix parmi ces trois types accessibles en allant dans le menu de gauche de votre espace administrateur de votre compte Rentabiliweb, section « Micropaiement/CB », en cliquant sur « Gestion des documents » puis sur le bouton « Installer » correspondant au document que vous désirez.

Micropaiement Rentabiliweb : gestion des documents

Micropaiement Rentabiliweb : installation des scripts

Il vous suffit ensuite de copier le script correspondant au formulaire de paiement de votre choix, puis de le coller dans votre page de paiement (la page d’accès configurée dans votre document Rentabiliweb) à l’endroit souhaité.

Pour installer le formulaire Facebook sur votre site web classique, il vous suffit de remplacer les balises <fb:iframe> et </<fb:iframe> par les balises iframe standards <iframe> et </iframe>.

Exemple :

Script du formulaire Facebook opérationnel pour les applications Facebook :

<fb:iframe src="http://payment.rentabiliweb.com/form/acte/form_fb.php?docId=xxxxx&siteId=yyyyyy&cnIso=geoip" frameborder="0" scrolling="auto" width="580" height="400"></fb:iframe>

Script adapté pour les sites web :

<iframe src="http://payment.rentabiliweb.com/form/acte/form_fb.php?docId=xxxxx&siteId=yyyyyy&cnIso=geoip" frameborder="0" scrolling="auto" width="580" height="400"></iframe>
b) Passer des valeurs supplémentaires

Vous pouvez, au travers de nos formulaires, passer des valeurs supplémentaires à votre page protégée ou à votre page d’erreur.
Pour les formulaires de type iframe ou popup, cela se pratique grâce à un champ caché. Ce champ caché aura obligatoirement le nom « data », et portera la valeur que vous lui attribuerez.

Le code de ce champ caché :

<input type="hidden" name="data" value="ma_valeur"/>

ou bien, pour passer une variable php :

<input type="hidden" name="data" value="<?php echo $ma_variable; ?>"/>

Cette façon de procéder peut également servir pour passer les paramètres record et noInfos.

Code html pour passer le paramètre noInfos :

<input type="hidden" name="noInfos" value="1"/>

Si vous faites cela, cela implique que Rentabiliweb ne retournera aucun paramètre lors de la redirection sur la page d’erreur (code, docId, siteId, data).

Les formulaires popup et iFrame peuvent grossièrement être divisé en 2 parties. Celle permettant l’achat d’un code par un des moyens de paiement proposés, celle contenant le formulaire pour la saisie du code et l’accès au contenu protégé. C’est dans cette deuxième partie qu’il est possible d’ajouter une balise de champ caché pour faire passer un des paramètres optionnels.

Exemple pour le formulaire popup et le paramètre data (valeur)

<form id="rweb_tickets_XXXXX"  method="get" action="http://payment.rentabiliweb.com/access.php" style="margin: 0px; padding: 0px;" >
     <table width="280" cellpadding="0" cellspacing="0" style=" margin: 2px auto;">
          <tr>
	       <td style="text-align: center"><label for="code_0" style=" font-family:Arial, Helvetica, sans-serif;font-size: 12px; font-weight:bold; color:#3b5998; padding: 2px 2px 5px 2px; margin: 0px;">
                        Saisissez votre code d'accès et validez :<br/>
			<span style="font-size: 11px; font-style: italic;color:#5c5c5c;">Please enter your access code :</span></label></td>
          </tr>
          <tr>
               <td style="text-align: center">
	            <input name="code[0]" type="text" id="code_0" size="10" style="border: solid 1px #3b5998; padding: 2px; font-weight: bold; color:#3b5998; text-align: center;"/>
	            <input type="hidden" name="docId" value="XXXXX" />
		    <input type="hidden" name="data" value="ma_valeur" />
		    <input type="button"  alt="Ok" onclick="getElementById('rweb_sub_XXXXX').disabled=true;document.getElementById('rweb_tickets_XXXXX').submit();" id="rweb_sub_XXXXX"  style="width: 40px; height:20px; vertical-align:middle; margin-left: 5px; border: none; background:url(http://payment.rentabiliweb.com/data/i/component/button_ok.gif);"/></td>
          </tr>
     </table>
</form>

Exemple pour le formulaire iFrame et le paramètre data (variable php)

<form id="rweb_tickets_XXXXX" method="get" action="http://payment.rentabiliweb.com/access.php" style="margin: 0px; padding: 0px;" >
     <table width="400" cellpadding="0" cellspacing="0" style=" margin: 2px auto;">
          <tr>
               <td style="text-align: center"><label for="code_0" style=" font-family:Arial, Helvetica, sans-serif;font-size: 12px; font-weight:bold; color:#3b5998; padding: 2px; margin: 0px;">
               Saisissez votre code d'accès et validez :
	       <br/>
	       <span style="font-size: 11px; font-style: italic;color:#5c5c5c;">Please enter your access code :</span></label></td>
          </tr>
          <tr>
               <td style="text-align: center">
	            <input name="code[0]" type="text" id="code_0" size="10" style="border: solid 1px #3b5998; padding: 2px; font-weight: bold; color:#3b5998; text-align: center;"/>
		    <input type="hidden" name="docId" value="XXXXX" />
		    <input type="hidden" name="data" value="<?php echo $ma_variable;?>" />
		    <input type="button"  alt="Ok" onclick="getElementById('rweb_sub_XXXXX').disabled=true;document.getElementById('rweb_tickets_XXXXX').submit();" id="rweb_sub_XXXXX"  style="width: 40px; height:20px; vertical-align:middle; margin-left: 5px; border: none; background:url(http://payment.rentabiliweb.com/data/i/component/button_okdefault.gif);"/>
               </td>
          </tr>
     </table>
</form>

Pour le formulaire de type Facebook, la méthode pour passer une valeur supplémentaire est un peu différente. Cela se pratique en ajoutant le paramètre data dans l’URL de la source du formulaire.

Exemple pour le formulaire Facebook et le paramètre data (valeur)

<iframe src="http://payment.rentabiliweb.com/form/acte/form_fb.php?docId=xxxxx&siteId=yyyyyy&cnIso=geoip&data=ma_valeur" frameborder="0" scrolling="auto" width="580" height="400"></iframe>

Exemple pour le formulaire Facebook et le paramètre data (variable php)

<iframe src="http://payment.rentabiliweb.com/form/acte/form_fb.php?docId=xxxxx&siteId=yyyyyy&cnIso=geoip&data=<?php echo $ma_variable; ?>" frameborder="0" scrolling="auto" width="580" height="400"></iframe>

Si vous voulez passer plusieurs valeurs par ce champ caché (formulaires iFrame et popup) ou par ce paramètre (formulaire Facebook), il vous suffit de créer un tableau, de le sérialiser puis de l’encoder (en base 64 par exemple), ce qui donnerait par exemple :

$tableau = array($maVar1, $maVar2, $maVarN);
$data = serialize($tableau);
$data = base64_encode($data);

Ce champ est passé en paramètre GET, donc pour le récupérer dans votre page protégée ou votre page d’erreur, il vous suffira d’écrire :

$le_champ_a_recuperer=$_GET['data'];

Si vous avez sérialisé puis encodé un tableau de variables, il faudra écrire ceci pour récupérer votre tableau dans votre page protégée ou votre page d’erreur :

$data = base64_decode($_GET['data']);
$tableau = unserialize($data);

Vous pouvez aussi, grâce à la méthode des champs cachés, passer les variables d’affiliation. Ceci est expliqué plus bas, dans le 2. 2 Configuration et intégration des paramètres d’affiliation.

c) Code HTML et CSS

NE SURTOUT PAS MODIFIER LE CODE HTML SINON DES ERREURS PEUVENT SE PRODUIRE
Pour modifier l’apparence de votre formulaire de paiement, vous pouvez vous servir d’une feuille de style ou de modifier le style directement dans la balise souhaitée.
Pour ne pas afficher un block il vous suffit d’ajouter dans la feuille de style ou dans la balise style=’display: none;’
Pour mieux identifier les blocks vous pouvez vous servir de la web developer toolbar avec firefox disponible ici :
http://chrispederick.com/work/web-developer/
Une fois installée, vous appuyez sur les touches ctrl+shift+F et cliquez sur un block pour voir son id ou sa class.

1.1.2 La vérification du code

Rentabiliweb met à disposition un script permettant de sécuriser l’accès à vos pages payantes.
Ce script est récupérable dans la même page web que le formulaire de paiement (cf. début du a) Installer le formulaire de paiement).

Ce script de sécurisation doit impérativement être couplé à notre formulaire de paiement (sans modification du code html), sinon des erreurs peuvent se produire.
Pour obtenir de l’aide ou des conseils sur la sécurisation de votre site ou la personnalisation de votre formulaire de paiement, veuillez s’il vous plait prendre contact avec notre équipe technique.

Votre site, grâce à des langages comme PHP ou ASP, pourra interroger les serveurs Rentabiliweb pour vérifier le code de l’utilisateur.
Votre script va donc effectuer une requête HTTP.

Vous pouvez choisir le script de protection parmi deux types : Php ou Javascript.

Le script de protection en Php s’installe en le copiant à partir de la page Micropaiement » Installation de votre document. Il est à coller tout en haut du code de votre page à protéger, celle qui contient votre contenu payant.

Exemple

<?php
// Identifiants de votre document
$docId = xxxxx
$siteId = yyyyyy
// PHP5 avec register_long_arrays désactivé?
if (!isset($HTTP_GET_VARS)) {
     $HTTP_SESSION_VARS    = $_SESSION;
     $HTTP_SERVER_VARS     = $_SERVER;
     $HTTP_GET_VARS        = $_GET;
}
// Construction de la requête pour vérifier le code
$query      = 'http://payment.rentabiliweb.com/checkcode.php?';
$query     .= 'docId='.$docId;
$query     .= '&siteId='.$siteId;
$query     .= '&code='.$HTTP_GET_VARS['code'];
$query     .= "&REMOTE_ADDR=".$HTTP_SERVER_VARS['REMOTE_ADDR'];
$result     = @file($query);
if(trim($result[0]) !== "OK") {
header('Location: http://www.votresite.com/votrepageerreur.html');
    exit();
}
// Accès à votre page protégée
?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr">
//LE CODE DE VOTRE PAGE PROTEGEE ...
</html>

Voici l’url du script de vérification : http://payment.rentabiliweb.com/checkcode.php

Voici les paramètres nécessaires pour la requête :

  • docId : l’identifiant de votre document ;
  • siteId : l’identifiant de votre site où est configuré le document ;
  • code : ce paramètre contiendra le(s) code(s) saisis par l’internaute (en cas de multicode les codes seront séparés par des tirets « - »).

Notre script retournera en cas d’erreur : KO

En cas de code valide Rentabiliweb retournera : OK
De plus, sur la seconde et la troisième ligne, Rentabiliweb vous fournit des informations sur la nature du code (pays, type de paiement) sous cette forme :

- $result[1] : est le code ISO du pays (pour les dom tom : DT, pour les paiements par CB et Paypal : XX),
- $result[2] : est le type de paiement utilisé pour obtenir le code (1 : audiotel, 2 : sms, 3 : Internet+, 5 : CB, 8 : Paypal, 10 : Néosurf, 13 : OnNET).

Le script de protection en Javascript s’installe différemment. Il s’installe en le copiant à partir de la page Micropaiement » Installation de votre document. Il est à coller entre les balises <head> et </head> du code html de votre  page à protéger, celle qui contient votre contenu payant.

Exemple

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<meta http-equiv="Content-Language" content="fr">
<meta name="description" content="description de votre page " />
<meta name="keywords" content="vos mots clés" />

<noscript>
<meta http-equiv="Refresh" content="0;URL=URL_CHECKTICKET_JS?docId=xxxxx&siteId=yyyyyy&nojs=1">
</noscript>
<script type="text/javascript" language="Javascript" src="URL_CHECKTICKET_JS?docId=xxxxx&siteId=yyyyyy"></script>
</head>

Pour sécuriser plusieurs pages grâce au même accès vous pouvez utiliser un système de session ou de cookie.

1.2 Installation du paiement CB > 3 EUR (clients premium et prestige)

1.2.1 Le formulaire de paiement

  • bouton d’achat

Ce bouton permettra à vos visiteurs d’acheter leur ticket abonné pour accéder à votre service.
En cliquant sur ce bouton, un popup s’ouvre avec les systèmes de paiement disponibles.
Voici les variables nécessaires au bon fonctionnement du popup :
- docId : l’identifiant de votre document
- siteId : l’identifiant de votre site où est configuré le document

Voici les paramètres facultatifs :
- data : grâce à ce paramètre vous pourrez transmettre des informations à l’url de votre page protégée et à votre url de callback (si configurée dans votre document).
Rentabiliweb retournera la valeur du champ data en method GET dans l’url de votre page protégée et votre url de callback (si configurée dans votre document).

  • formulaire de saisie

Ce formulaire fonctionne du même principe que le formulaire de paiement à l’Acte. Il accepte les mêmes paramètres.

1.2.2 La vérification du code

La vérification d’un ticket abonné se fait de la même façon que le paiement à l’Acte.

1.2.3 Url de callback

Rentabiliweb vous permet d’être informé lorsqu’un de vos clients achète un ticket abonné.
Dès qu’un achat est validé, le serveur Rentabiliweb envoie une requête sur vos serveurs à l’url indiquée dans le paramétrage de votre document.

Voici les paramètres que cette url retourne :

En cas de paiement Oneshot :
- docId : identifiant de ce document
- ticket : code abonnement délivré à l’internaute
- reference : numéro de la transaction
- amount : montant payé par l’internaute
- data : données « data » si présentes dans le script d’achat de pass abonné

En cas de paiement par réabonnement :
- docId : identifiant de ce document
- duration : durée de l’abonnement
- endDate : date de fin d’abonnement (forme : AAAA-MM-JJ HH:MM:SS)
- ticket : ticket abonné délivré à l’internaute
- reference : numéro de la transaction
- amount : montant payé par l’internaute
- renew : 1 s’il s’agit d’un renouvellement ; 0 s’il s’agit d’un premier paiement
- data : données « data » si présentes dans le script d’achat de ticket abonné

L’url de callback est exécutée à chaque transaction (paiement, réabonnement).

Rentabiliweb possède un POOL de requêtes, celui-ci renverra la requête de callback en cas de non réponse de vos serveurs.

2. AFFILIATION

2.1 Utilisation des liens partenaires

Lors de la création du programme d’affiliation, vous avez configuré une bannière et un lien de promotion.

Rentabiliweb fournit à vos affiliés un lien d’inscription à votre programme ainsi que les scripts pour promouvoir vos services.
Le système gère automatiquement les partages de gains lors du paiement CB ou lors de la saisie du code pour un paiement à l’acte.

Nous gérons le backoffice technique de vos affiliations (inscriptions, envois d’emails automatiques, statistiques/gains) et le paiement de vos affiliés.

2.2 Configuration et intégration des variables d’affiliation

Vous pouvez paramétrer directement dans le formulaire de paiement votre affiliation et les reversements affiliés.

Les variables d’affiliation sont prioritaires sur l’utilisation des liens partenaires.

Les deux systèmes ne peuvent pas être utilisés en même temps.

Voici les paramètres :

  • PRID : id de votre programme d’affiliation ;
  • CAFF_n : code affilié du partenaire qui touchera les gains (n de 1 à 4) ;
  • POUR_n : pourcentage des gains reversé au partenaire sur l’acte (n de 1 à 4) ;
  • POUR_CB_n : pourcentage des gains reversé au partenaire sur la CB (n de 1 à 4) ;
  • PRGR_n : code du programme de reversement en sommes fixes qui sera utilisé pour calculer les gains affiliés (n de 1 à 4).

Attention vous ne pouvez utiliser que l’un des paramètres POUR_n (POUR_CB_n dans le cas d’un document CB) ou PRGR_n.

Pour configurer vos programmes de reversements en sommes fixes cliquez-ici

Intégration à nos formulaires de paiement

Elles peuvent s’intégrer de la même manière que ce qui est expliqué dans b) Passer des valeurs supplémentaires, à savoir grâce à des champs cachés dans le formulaire de micropaiement.

Exemple pour le formulaire popup :

<form id="rweb_tickets_XXXXX"  method="get" action="http://payment.rentabiliweb.com/access.php" style="margin: 0px; padding: 0px;" >
     <table width="280" cellpadding="0" cellspacing="0" style=" margin: 2px auto;">
          <tr>
	       <td style="text-align: center"><label for="code_0" style=" font-family:Arial, Helvetica, sans-serif;font-size: 12px; font-weight:bold; color:#3b5998; padding: 2px 2px 5px 2px; margin: 0px;">
                        Saisissez votre code d'accès et validez :<br/>
			<span style="font-size: 11px; font-style: italic;color:#5c5c5c;">Please enter your access code :</span></label></td>
          </tr>
          <tr>
               <td style="text-align: center">
	            <input name="code[0]" type="text" id="code_0" size="10" style="border: solid 1px #3b5998; padding: 2px; font-weight: bold; color:#3b5998; text-align: center;"/>
	            <input type="hidden" name="docId" value="XXXXX" />
		    <input type="hidden" name="PRID" value="<?php echo $le_prid;?>" />
                    <input type="hidden" name="CAFF_1" value="<?php echo $identifiant_de_votre_affilié;?>" />
                    <input type="hidden" name="POUR_1" value="<?php echo $le_pourcentage_à_reverser_à_cet_affilié;?>" />
		    <input type="button"  alt="Ok" onclick="getElementById('rweb_sub_XXXXX').disabled=true;document.getElementById('rweb_tickets_XXXXX').submit();" id="rweb_sub_XXXXX"  style="width: 40px; height:20px; vertical-align:middle; margin-left: 5px; border: none; background:url(http://payment.rentabiliweb.com/data/i/component/button_ok.gif);"/></td>
          </tr>
     </table>
</form>

Vous veillerez à indiquer le pourcentage en chiffre, exemple 80 pour 80%, ou 45 pour 45%.

Informations techniques SMS Go

Introduction

Bienvenue dans le manuel d’intégration et de configuration technique du service SMS Go.

Très rapides, ces quelques étapes vous permettront en toute simplicité d’intégrer, de paramétrer, puis de tester nos services.

Avec SMS Go, Rentabiliweb vous offre la possibilité de créer votre propre service SMS+ en interaction complète avec l’activité et le contenu de votre site.

Le principe est simple :

  1. Vous déterminez et réservez votre mot-clé
  2. Vos utilisateurs envoient votre mot-clé suivi de l’action qu’ils veulent effectuer, à un numéro surtaxé
  3. Vous traitez la demande de votre utilisateur et lui renvoyez le message de votre choix

Inscrivez-vous dès maintenant sur notre site Internet :
http://www.rentabiliweb.com

Une fois inscrit vous disposez d’un login et d’un mot de passe.
Connectez-vous ensuite dans votre espace membre Rentabiliweb

I. Créer son service SMS Go

1. Connectez vous à Rentabiliweb avec votre login et votre mot de passe.

connexion à Rentabiliweb

2. Dans le menu de gauche, repérez la section « Service SMS+ » et cliquez sur « Sms Go »

SMS Go

3. Dans la page SMS Go » Création d’un service, cliquez sur « les règles d’utilisation » afin de vous informer sur les obligations légales concernant ce service.
4. Quand vous êtes au fait de ces règles, cliquez sur « Créer un document SmsGo » sur la page SMS Go » Création d’un service.

Créer un service SMS Go

5. Remplissez le formulaire de création du service

formulaire de création SMS Go

  1. Choisissez le site internet où votre service SMS Go sera installé
  2. Si le site où vous voulez installer le service SMS Go n’est pas encore présent sur votre compte Rentabiliweb ou si vous souhaitez modifier l’URL d’un site existant, vous pouvez faire cela en cliquant sur le bouton « Modifier/Ajouter un site »
  3. Indiquez le nom du service SMS Go (exemples : dédicaces webradio, passer une annonce, etc.)
  4. Entrez l’URL de réponse : cette URL contiendra le script php (ou tout autre langage de script tel l’ASP) qui permettra de recevoir les SMS envoyés par vos clients et d’exécuter les traitements que vous avez décidé selon le contenu de ces SMS (exemple d’URL de réponse : http://www.test.com/sms.php).
    Cette URL devra impérativement se situer sur le site que vous avez choisi dans la phase a. Pour plus de détails concernant les scripts php (langage que nous utiliserons pour exemple) relatifs à l’utilisation de ce service, cf. « Installer et utiliser son service SMS Go » ci-après
  5. Définissez le mot-clé dédié que vous souhaitez utiliser (4 caractères minimum, sans espace ni caractères spéciaux (à savoir accents, &, #, $, etc.)), par exemple : DEDI, NOURRIR, VOTE, etc.
  6. Ecrivez le message que vos clients recevront lorsque leur message sera valide par rapport au traitement du script php que vous aurez conçu, c’est à dire lorsque vous choisirez de faire un <?php echo ‘OUI’; ?> (plus de détails dans « Installer et utiliser son service SMS Go » ci-après). Ce message devra comporter 100 caractères maximum.
  7. Ecrivez le message que vos clients recevront lorsque leur message sera invalide par rapport au traitement du script php que vous aurez conçu, c’est à dire lorsque vous choisirez de faire un <?php echo ‘NON’; ?> (plus de détails dans « Installer et utiliser son service SMS Go » ci-après). Ce message devra comporter 100 caractères maximum.
  8. Notez la description de votre service en quelques mots, exemple : service de dédicaces pour la web radio, service pour passer une annonce, etc.
  9. Choisissez le palier SMS que vous désirez pour la France
  10. Vérifiez que le mot-clé que vous avez choisi à la phase e. est disponible sur le palier que vous venez de choisir pour la France
  11. Vous pouvez cocher cette case si vous ne désirez pas de palier français pour votre service SMS Go. Dans ce cas, il ne sera disponible que pour le palier belge que vous choisirez dans la phase suivante
  12. Choisissez le palier SMS que vous désirez pour la Belgique
  13. Vérifiez que le mot-clé que vous avez choisi à la phase e. est disponible sur le palier que vous venez de choisir pour la Belgique
  14. Vous pouvez cocher cette case si vous ne désirez pas de palier belge pour votre service SMS Go. En ce cas, il ne sera disponible que pour le palier français que vous aurez choisi dans la phase i.
  15. Tout est bien rempli ? Si c’est le cas, alors cliquez sur « Valider »

Si vous n’avez rien oublié, votre service vient d’être créé et un message vous l’indique. Si vous avez oublié de remplir un champ obligatoire, un message vous l’indiquera, il vous suffira d’en tenir compte et de cliquer à nouveau sur « Valider » une fois que vous aurez corrigé votre erreur.

6. Confirmation de la création du service

confirmation de la création du service

II. Installer et utiliser son service SMS Go

Votre service SMS Go est créé, mais ce service étant soumis à validation, notre équipe se réserve le droit de l’accepter ou de le refuser après contrôle. Par sécurité, elle s’engage également à vérifier le site mentionné pour la création de votre service SMS Go. Ce délai de validation s’applique entre 24 à 48h.

Voici un exemple de message qui apparaît durant la phase de validation. Rendez-vous « Sms Go », section « Service SMS+ » dans le menu de gauche) :

SMS Go en attente

Voici un exemple de message qui apparaît lorsque votre service est validé par notre équipe :

refus SMS Go

Voici un exemple de message qui apparaîtrait si votre service était modéré par notre équipe :

SMS Go accepté

Mise en place du service sur votre serveur

Utiliser le service SMS Go demande quelques connaissances en programmation php (ou tout autre langage de script serveur). Néanmoins, les clients les moins familiarisés peuvent retrouver ici des exemples utiles de script en php. Sachez que nous utiliserons le php comme langage de script à titre d’exemple.

Pour traiter le message envoyé et mettre en place votre service, vous devez développer le script php de traitement à l’URL de réponse fournie (exemple : http://www.test.com/sms.php).

Nous faisons suivre, sur ce script, l’intégralité du message envoyé par l’appelant dans le paramètre « sms » (envoyé par nos serveurs en méthode POST). Vous récupérez donc le sms sous la forme d’une variable php en utilisant $_REQUEST['sms'] dans votre script php.
Vous pouvez donc récupérer et traiter ce message pour déclencher les actions souhaitées et renvoyer une réponse à votre client.

Pour tester ce script de traitement, vous pouvez entrer dans votre navigateur une URL de type http://www.test.com/sms.php?sms=VOTREMOTCLE votre message, ce qui simulera l’appel que nous réalisons.

Si vous nous renvoyez une réponse positive (en écrivant OUI comme sortie de votre script), nous renverrons à l’appelant le message configuré comme réponse en cas de succès (cf. I. Créer son service SMS Go, phase f. du formulaire de création de service).

Si vous nous renvoyez une réponse négative (en écrivant NON comme sortie de votre script), nous renverrons à l’appelant le message configuré comme réponse en cas d’échec (cf. I. Créer son service SMS Go, phase g. du formulaire de création de service).

Exemples de scripts php pour traiter les sms entrants

Pour enregistrer les sms dans un fichier texte sur votre serveur (il vous appartient de modifier le nom de ce fichier texte en changeant ‘nom_du_fichier‘ ci dessous)

<?php
$message = $_REQUEST['sms'];
$jour = date('d/m/Y');
$heure = date('H');
$minutes = date('i');
$fp = fopen('nom_du_fichier.txt', a);
fwrite($fp, "\r\n".$jour.' '.$heure.':'.$minutes.' - '.$message);
fclose($fp);
echo 'OUI';
?>

NB : Ce script fonctionne et est prêt à l’emploi, cependant, il est simplissime et ne permet que l’enregistrement des sms reçus dans un fichier texte. Il renverra systématiquement la réponse en cas de succès à l’appelant (par l’instruction echo ‘OUI’).

Pour exécuter différentes actions selon le message (il vous appartient de modifier les noms des actions en changeant ‘action1‘ et ‘action2‘)

<?php
$sms = explode(' ', $_REQUEST['sms']);
$keyword = strtoupper($sms[0]);
$action = trim($sms[1]);
switch($action) {
	case 'action1':
		// Ici les traitements correspondant à l'action 1
		echo 'OUI';
		break;
	case 'action2':
		// Ici les traitements correspondant à l'action 2
		echo 'OUI';
		break;

		default:
		echo 'NON';
		break;
}
?>

NB : Ce script n’est pas opérationnel en l’état, il demande à ce que vous lui indiquiez quels sont les traitements à effectuer selon l’action qu’il reçoit. En effet, tel qu’il est construit, ce script attend qu’une action soit indiquée après le mot-clé (exemple avec le mot clé NOURRIR : NOURRIR LION ; LION correspondant ici à ‘action 1′, vous devrez indiquer les traitements pour LION.

Si vous avez des questions techniques particulières, la FAQ dédiée à SMS Go vous apporte les réponses que vous cherchez.

Enfin, vous mettons à votre disposition des outils en téléchargement sur notre blog pour utiliser votre service SMS Go. Par exemple, pour un système de gestion de dédicaces, l’URL suivante :
http://blog.rentabiliweb.com/index.php/2009/08/20/telechargements

Utiliser le service SMS Go

Le script est-il créé ? Est-il en place sur votre serveur à l’URL de réponse configurée ?
Alors votre service SMS Go est installé et prêt à servir.

Il ne vous reste plus qu’à l’indiquer sur votre site web par un affichage clair.

Il est important de stipuler à vos clients qu’ils doivent placer un espace après le mot-clé (donc avant leur message) afin que ce service fonctionne comme il se doit.

Exemple d’affichage

Logo SMS+

France : Envoie DEDI suivi d’un espace, puis ta dédicace au 81077 (2 euros + coût d’un sms)
Belgique : Envoie DEDI suivi d’un espace, puis ta dédicace au 7337 (2 euros + coût d’un sms)

Nous attirons aussi votre attention sur le fait de changer le palier du service (ce que vous pouvez faire quand vous le souhaitez) change le numéro d’appel. Evitez au maximum ces changements. Si le changement est inévitable, merci de bien prévoir la transition et de la plainifier à l’avance. Vous devrez donc prévenir vos clients suffisamment clairement et à l’avance que le xx/xx/xxxx, le numéro et le tarif changeront.

Le journal des SMS Go

Vous avez la possibilité, via le journal SMS Go, d’effectuer le suivi des appels qui ont été réalisés sur votre service SMS Go. Vous pouvez choisir :

  • le service SMS Go que vous voulez suivre (si vous en avez plusieurs, pour un client prestige par exemple)
  • le mois des appels
  • le statut de l’appel

Concernant ce dernier point, le statut « URL réponse non accessible » est intéressant car cela signifie que notre plateforme n’arrive pas à joindre l’URL de traitement, et donc vous devez vérifier :

  • qu’il n’y a pas d’erreur dans l’URL de réponse configurée
  • que l’URL de réponse n’est pas protégée avec 1 authentification http (par exemple)
  • qu’il n’y a pas eu de panne serveur de votre hébergeur

NB : Nous vous rappelons que vous devez respecter les règles d’utilisation* des services SMS+ afin d’utiliser correctement le service SMS Go, aussi, nous vous conseillons vivement de lire la section suivante qui vous rappelle quelles sont ces règles.

III. Rappel des règles d’utilisation des services SMS+

Comme l’Audiotel, l’utilisation des numéros SMS+ est soumise à des règles strictes que ce soit pour le micropaiement ou pour les services premiums.

En tant qu’utilisateur actuel ou futur utilisateur, nous vous demandons de lire attentivement ce message qui vous informe des règles à respecter édictées par l’organisation smsplus.org.

Nous attirons votre attention sur le fait que le non respect de ces recommandations nous amènera à prendre des mesures strictes comme la coupure du service et l’annulation de vos reversements.
Il est strictement interdit d’utiliser le spam ou toute autre forme de publicité abusive, avec mention de nos jeux instant gagnant, sous peine de coupure de compte et d’annulation de reversements.

Affichage du prix après le numéro

Il est obligatoire d’afficher le prix après toute mention de nos numéros SMS+ sur chaque page où est mentionné le numéro. Le renvoi en bas de page sous forme d’astérisque n’est pas accepté. La mention du prix doit figurer systématiquement à côté du numéro y compris dans les publicités sous forme de bannières :

71018 0.50 EUR + prix d’un sms
81281 1.50 EUR + prix d’un sms
81077 2.00 EUR + prix d’un sms
etc…

Insertion du logo SMS+

Les logos spécifiques SMS+ doivent être affichés sur la page qui mentionne un numéro SMS+. Vous pouvez afficher le logo soit à côté du numéro cité soit n’importe où sur votre page (ex : en bas de page).

Vous trouverez sur cette page les différents modèles que nous mettons à votre disposition. Différents formats et couleurs vous sont proposés : choisissez le modèle le plus adapté à votre site. Chaque logo SMS+ doit être affiché dans sa taille originale (il est interdit de le réduire).

logo SMS 2 logo SMS 1

Dans le cadre de la lutte contre la contrefaçon et en respect avec la loi, il est strictement interdit de réserver et d’utiliser un mot clé faisant référence à une marque, un nom de domaine ou un nom privé ne vous appartenant pas. L’utilisation du spam (forum, email ou autres) pour faire la promotion de votre service payant est également prohibé.

Nous vous rappelons qu’il est très important de veiller au respect des droits de la propriété intellectuelle mentionnés ci dessus, en cas de procès vous êtes, en tant que webmaster, tenu pour premier responsable de la contrefaçon constatée.

En cas de malversation ou de non respect des règles édictées ci-dessus, Rentabiliweb se réserve le droit de fermer tout compte et d’annuler les gains correspondants. Rentabiliweb est également habilité à communiquer vos coordonnées aux autorités et responsables compétents.

* Nous nous réservons le droit de couper tout compte ne respectant pas nos conditions générales et celles de nos fournisseurs Télécoms.

Le module statistiques Rentabiliweb

Le module de statistiques Rentabiliweb a été conçu pour vous aider à mieux identifier vos sources de revenu et ainsi optimiser la transformation de vos offres.

Optimisé pour l’aide à la prise de décision, il possède des atouts qui sauront vous satisfaire et vous séduire à coup sûr :

  • affichage ultra rapide et performant
  • haut degré de précision
  • nombreux filtres pour obtenir les données que vous souhaitez
  • export des statistiques sous 4 formats (csv, xml, xls, jpeg) (4 sur figure 1)

Figure 1 : affichage au démarrage

Figure 1 : affichage au démarrage

L’affichage par défaut vous présente les statistiques du mois en cours. Vous pouvez agir sur les paramètres (1 sur figure 1), filtrer les résultats (2 sur figure 1), afficher un histogramme du nombre de transactions (5 sur figure 1) ou un tableau recensant les transactions et gains (6 sur figure 1) :

  • du jour actuel et précédent
  • totaux du mois courant

Vous pouvez afficher ces statistiques (via les onglets, 3 sur figure 1) :

  • par nombre de transactions (histogramme)
  • par gains (courbe)
  • en tableau (avec nombre de transactions et gains)

Figure 2 : ajouter des paramètres de filtrage

Figure 2 : ajouter des paramètres de filtrage

Notre module statistiques est très complet, il permet, en cliquant sur  « Ajouter des paramètres de filtrage », d’afficher les statistiques de manière très pointue en groupant par (1 sur figure 2) :

  • type de paiement
  • pays
  • document
  • site
  • numéro
  • affilié

et ce :

  • au mois, pour les 30 ou 90 derniers jours, voire à l’année (2 sur figure 2)
  • pour tous vos sites ou un en particulier (3 sur figure 2)
  • pour tous types de paiement ou un en particulier (4 sur figure 2)
  • pour tous les numéros ou un en particulier (5 sur figure 2)
  • pour tous vos documents ou un en particulier (6 sur figure 2)
  • pour tous les pays ou un en particulier (7 sur figure 2)

Quelques exemples d’affichage en groupant par type de paiement, pour un mois défini :

Figure 3 : affichage par transactions (histogramme), pointeur de souris sur un jour particulier

Figure 3 : affichage par transactions (histogramme), pointeur de souris sur un jour particulier

Cet affichage par histogramme vous permet de voir l’évolution du nombre de transactions, moyen de paiement par moyen de paiement, sur un mois complet. Quand vous positionnez le pointeur de souris sur un jour, cela vous indique le nombre de transactions pour ce jour ainsi que les gains associés. Pour changer l’affichage du moyen de paiement, il vous suffit de cocher (cases de droite en couleur) celui que vous désirez.

Figure 4 : affichage par transactions (courbes comparatives), pointeur de souris sur un jour particulier

Figure 4 : affichage par transactions (courbes comparatives), pointeur de souris sur un jour particulier

Cet affichage par courbes comparatives vous donne la possibilité de comparer les transactions liées à vos moyens de paiement d’un seul coup d’oeil, il vous suffit simplement de cocher à droite ceux que vous désirez comparer.

De plus, lorsque vous survolez un jour particulier avec la souris, il vous indique le nombre de codes réalisés par moyen de paiement.

Figure 5 : affichage par gains détaillés (courbes comparatives), pointeur de souris sur un jour particulier

Figure 5 : affichage par gains détaillés (courbes comparatives), pointeur de souris sur un jour particulier

Cet affichage par courbes comparatives vous donne la possibilité de comparer les gains liés à vos moyens de paiement d’un seul coup d’œil, il vous suffit simplement de cocher à droite ceux que vous désirez comparer.

De plus, lorsque vous survolez un jour particulier avec la souris, il vous indique le gain réalisé par moyen de paiement.

Figure 6 : affichage par transactions (diagramme), pointeur de souris sur un type de paiement

Figure 6 : affichage par transactions (diagramme), pointeur de souris sur un type de paiement

Cet affichage en diagramme vous indique la répartition en pourcentage du nombre de transactions réalisées (dans cet exemple, sur un mois) par type de paiement (pour cet exemple).

Il vous permet ainsi de voir très rapidement, dans cet exemple, quel est le type de paiement le plus utilisé par vos clients.

Au survol d’un type de paiement, il indique aussi le nombre de transactions.

Figure 7 : affichage par gains détaillés (diagramme), pointeur de souris sur un type de paiement

Figure 7 : affichage par gains détaillés (diagramme), pointeur de souris sur un type de paiement

Cet affichage en diagramme vous indique la répartition en pourcentage des gains réalisés (dans cet exemple, sur un mois) par type de paiement (pour cet exemple).

Il vous permet ainsi de voir très rapidement le type de paiement le plus utilisé par vos clients.

Au survol d’un type de paiement, il indique aussi les gains en euros.

Ces exemples ne constituent qu’une petite facette de ce que vous propose ce module de statistiques, vu les filtres que vous pouvez indiquer sur les données à obtenir. Ils démontrent néanmoins le potentiel de ce module qui vous permettra d’avoir un œil avisé sur les transactions et gains de votre (vos) site(s), et de pouvoir déterminer les décisions qui s’imposent.

Solutions techniques aux différents problèmes

Le formulaire est installé, mais la redirection ne fonctionne pas (ou redirige vers une autre page)

Parmi les raisons qui peuvent provoquer un problème lors de la redirection, il y a le changement de domaine : l’authentification sur le site se fait sur un domaine particulier (http://site.com) alors que la redirection se fait sur un autre domaine où l’authentification est perdue (http://www.site.com). Le problème peut être réglé soit en paramétrant explicitement les cookies sur un ensemble de domaines, soit en effectuant des redirections pour s’assurer que l’authentification et redirection correspondent toujours.

Il y a plusieurs solutions possibles à ce problème fréquent :

  • Vous vous assurez que l’authentification a bien lieu sur le même domaine que la page de redirection (protégée).
  • Il est possible de changer le domaine des cookies de session pour qu’ils prennent en compte tous les sous-domaines soit en configurant le php.ini (session.cookie_domain), soit en appelant session_set_cookie_param (http://fr.php.net/manual/fr/function.session-set-cookie-params.php).
// A appeler avant session_start pour que les bons paramètres soient pris en compte
session_set_cookie_param(0, '/', '.domain.dns');

session_start();
  • Utiliser l’API

Autre raison qui peut provoquer un problème lors de la redirection : la directive allow_url_fopen positionnée à ‘Off’. Si votre hébergeur ne souhaite pas la modifier, il existe une parade : l’utilisation de la fonction cURL() à la place de file() dans le script de protection.

$url = 'http://payment.rentabiliweb.com/checkcode.php?';
$url .= 'docId='.$docId;
$url .= '&siteId='.$siteId;
$url .= '&code='.$_GET['code'];
$url .= "&REMOTE_ADDR=".$HTTP_SERVER_VARS['REMOTE_ADDR'];  

$ch 	= curl_init();
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_USERAGENT, $_SERVER['HTTP_USER_AGENT']);
curl_setopt($ch, CURLOPT_REFERER, $_SERVER['HTTP_REFERER']);
curl_setopt($ch, CURLOPT_TIMEOUT, 10); // 10secondes de time out
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_HTTPGET, 1);

$result	= curl_exec($ch);

if(ereg('OK', strtoupper($result)) {
  // ok
}
else {
  // erreur
}

Téléchargements

> Outil SMS Go Dédicace

L’outil SMS Go Dédicace vous permet de sauvegarder les sms que vous avez reçu dans une base de données, puis, grâce à une interface simple sécurisée,  de les afficher afin que vous puissiez les accepter ou les refuser.

Télécharger l’outil SMS Go Dédicace (documentation technique incluse)