Nos guides

Voici la liste de nos guides pratiques :

Annonceurs : Valider une inscription incentive

La mise en place des campagnes incentives aux clics demande une action de la part des annonceurs afin de valider, suite à l'inscription sur votre site internet au près de Easy-Ads qu'une IP s'est bien inscrite.

A la fin de votre système d'inscription, vous devez placer le script suivant qui vérifie si le visiteurs à cliqué sur une de vos campagne et si il n'a pas encore validé votre inscription ajoute les gains au diffuseur.

Le lien de validation est de le forme suivante :

http://www.easy-ads.net/api?a=confirmCampaign&ca=*idcampagne*&ip=*ipvisiteur*&k=*votrecleapi*


Attention : vous devez remplacer *idcampagne* par l'identifiant de votre campagne, *ipvisiteur* par l'ip du visteur et *votrecleapi* par votre clé api que vous pouvez récupérer dans le menu "Mon Compte" dans la rubrique "Ma clé API".

Nous vous conseillons d'utiliser le code PHP suivant :

<?php

$update = file_get_content('http://www.easy-ads.net/api?a=confirmCampaign&ca=*idcampagne*&ip=*ipvisiteur*&k=*votrecleapi*');
Api : Formattage du flux

Nos flux de données transmis par l'API sont encodés en Json.

Wikipedia a écrit

JSON (JavaScript Object Notation) est un format de données textuel, générique, dérivé de la notation des objets du langage ECMAScript. Il permet de représenter de l'information structurée.

L'avantage du format Json est d'être légé et utilisable dans tous les language de programmation car il est uniquement composé de texte. Voici quelques liens utilises pour utiliser json dans vos divers scripts / programmes :

Nous vous conseillons l'utilisation de l'extension JsonView sur Mozilla Firefox ou Google Chrome permettant de faciliter l'affichage des flux json dans votre navigateur.

Diffuseurs : Afficher des annonces sur vos sites

Easy-Ads vous propose de nombreuses solutions afin de publier des annonces sur vos sites internet.

Diffuseurs : Utilisation de l'url de retour

Vous pouvez configurer sur chacun de vos sites une url de retour qui est appelée automatiquement après la validation d'un clic ou d'une inscription sur Easy-Ads.

L'url de retour peut être de la forme suivante :

http://example.com/retourAuto.php


Ou par exemple de cette forme :

http://www.example.com/retour.php?k=votreCleSecrete


Attention : nous vous conseillons d'utiliser un paramètre secret pour des questions de sécurité.

Les paramètres retournés sont les suivants :


Voici un exemple de fichier retour.php à utiliser :

<?php

if(isset($_GET['k']) && $_GET['k'] == 'votreCleSecrete')
{
	$idCampagne = isset($_GET['ca']) ? intval($_GET['ca']) : exit();
	$userIp = isset($_GET['ip']) ? intval($_GET['ip']) : exit();
	$userData = isset($_GET['data']) ? intval($_GET['data']) : '';

	// Ajout dans la base
	mysql_query('INSERT INTO clics (campagne, ip, infos, data) VALUES (\''.$idCampagne.'\', \''.mysql_real_escape_string($userIp).'\', \''.mysql_real_escape_string($userData).'\', NOW()) ');
}
Diffuseurs : Vérifier si un visiteurs à participé à une annonce

Grâce à un système très simple, Easy Ads vous permet de vérifier si un membre ou un visiteur de votre site à visité une cliqué sur une bannière ou finalisé une inscription.

Pour vérifier si un membre à visité une campagne, vous pouvez utiliser l'url suivante :

http://www.easy-ads.net/api?a=checkStatus&i=*idsite*&ca=*idcampagne*&ip=*ipmembre*


Attention : Vous devez remplacer *idsite* par l'identifiant de votre site, *idcampagne* par l'id de la campagne à vérifier et *ipmembre* par l'adresse ip de votre membre.

Cette url vous retourne deux valeurs dans un tableau au format json. La première nommé "result" contient le nombre de clic ou inscription effectué, la seconde valeur "max" correspond au nombre maximum de clic ou d'inscription possible pour ce membre.
Si "result" est inférieur à "max" alors le membre peux encore cliquer sur la bannière ou s'inscrire à la campagne.

Voici l'exemple d'un script php pour vérifier si un membre à cliqué sur une campagne :

<?php

$content = file_get_content('http://www.easy-ads.net/api?a=checkStatus&i=*idsite*&ca=*idcampagne*&ip=*ipmembre*');

if($content)
{
	$content = json_decode($content);

	// Au moins un clic / inscription effectué
	if($content['result'] > 0)
	{
		echo '<strong>'.$content['result'].' clics / inscriptions effectué. '.$content['max'].' clics / inscriptions restant';
	}
}
Récupérer le solde de son compte

Il est possible de récupérer sur votre site le solde de votre compte Easy-Ads. Pour récupérer cet information, vous devez utiliser votre clé API disponible dans le menu "Mon Compte" puis dans la section "Ma clé API".

L'url pour récupérer le solde de votre compte est la suivante :

http://www.easy-ads.net/api?a=getBalance&k=*votrecleapi*


Le résultat de cette url sera de la forme suivante :

{"balance":35.9}


Le solde du compte d'exemple est donc de 35.90€.

Vous recherchez une information qui n'est pas dans la liste ? N'hésitez pas à nous contacter.