Documentation

Notifications PostBack


À chaque fois qu'un visiteur ou un utilisateur de votre site Internet, application, blog,... effectue une action (lead), nous faisons appel à votre fichier PostBack avec certaines informations. Ces informations peuvent être utilisées de plusieurs façon, la plus courante étant pour récompenser l'utilisateur qui a effectué l'action.


Notre serveur effectuera une requête HTTP GET au PostBack que vous aurez définie dans la section "Informations du compte" de votre profil OptimiAds, incluant tous les paramètres que vous aurez défini parmi les suivants.


Paramètres du PostBack

  • [SUB_ID] : Il s'agit de l'identifiant unique de l'utilisateur qui a effectué l'action sur votre plateforme (userId).
  • [AMOUNT] : Le montant de votre monnaie virtuelle à créditer à votre utilisateur.
  • [TRANSACTION_ID] : Code d'identification unique de la transaction effectuée par votre utilisateur sur l'Offer Wall OptimiAds.
  • [IP] : L'adresse IP de l'utilisateur qui a effectué l'action.


Si vous souhaitez recevoir ces paramètres personnalisés, vous pouvez les spécifier dans l'URL de PostBack comme dans l'exemple suivant :
http://postback.example.com/?userId=[SUB_ID]&reward=[AMOUNT]&transId=[TRANSACTION_ID]&userIp=[IP]


Vous pouvez utiliser n'importe lequel des paramètres du tableau "Paramètres du PostBack". Vous devrez les mettre entre [ ]


Exemple de PostBack


<?php

$userId = isset($_GET['userId']) ? $_GET['userId'] : null;
$transactionId = isset($_GET['transId']) ? $_GET['transId'] : null;
$points = isset($_GET['reward']) ? $_GET['reward'] : null;
$userip = isset($_GET['userIp']) ? $_GET['userIp'] : "0.0.0.0";

if (isNewTransaction($transactionId)) // On vérifie si la transaction existe déjà
{
    processTransaction($userId, $points, $transactionId);
    echo 1; exit();
}
else
{
    // Si la transaction existe déjà on affiche "0"
    echo 0; exit();
}

?>