Sapevi che puoi integrare il pannello affiliati nel tuo sito web? Per farlo, bisogna utilizzare l'API fornita nel nostro software di affiliazione.
In questo tutorial creeremo una semplice pagina che funge da pannello affiliati. Mostrerà quindi il link tracciante dell'affiliato e il totale delle commissioni che ha guadagnato. Se l'utente non è ancora iscritto al tuo network di affiliazione, potrà iscriversi come affiliato con un singolo click.
L'unico requisito è avere i nomi e gli indirizzi e-mail dei tuoi utenti. Pertanto, ti suggeriamo di inserire questo codice in una sezione del tuo sito in cui i tuoi utenti hanno già effettuato il login, in questo modo avrai già a disposizione i dati dell’utente.
Le chiamate API che vengono fatte in questo tutorial sono le seguenti:
1. Leggere i dati dell'affiliato (per verificare se l'utente è registrato)
2. Iscrivere un affiliato (se l'utente non è registrato)
3. Leggere le statistiche totali
Questa immagine è un esempio del risultato finale:
E questo è il codice completo:
<?php
// AffiliationSoftware API example
// change these with your affiliationsoftware URL and API
$your_url = 'https://NAME.affiliationsoftware.app/';
$your_api = 'https://NAME.affiliationsoftware.app/script/api.php?key=XXX';
// change these with your users details
$user_name = "John Doe";
$user_email = "test@test.test";
// read affiliate data to check if the user is already registered
$data = array(
'action' => 'affiliate_data',
'affiliate' => $user_email,
);
$api = curl_init( $your_api );
curl_setopt( $api, CURLOPT_POST, 1 );
curl_setopt( $api, CURLOPT_RETURNTRANSFER, 1 );
curl_setopt( $api, CURLOPT_POSTFIELDS, $data );
$res = curl_exec( $api );
curl_close( $api );
$affiliate = json_decode( $res, true );
// if the user is already registed
if( isset( $affiliate['refid'] ) ) {
// default affiliate link
$affiliate['link'] = $your_url . $affiliate['refid'];
// read total statistics
$data = array(
'action' => 'affiliate_stats',
'affiliate' => $user_email,
);
$api = curl_init( $your_api );
curl_setopt( $api, CURLOPT_POST, 1 );
curl_setopt( $api, CURLOPT_RETURNTRANSFER, 1 );
curl_setopt( $api, CURLOPT_POSTFIELDS, $data );
$res = curl_exec( $api );
curl_close( $api );
$statistics = json_decode( $res, true );
}
// if user is not registred
if( !isset( $affiliate['refid'] ) && isset( $_GET['signup'] ) ) {
// signup affiliate
$data = array(
'action' => 'affiliate_add',
'name' => $user_name,
'email' => $user_email,
);
$api = curl_init( $your_api );
curl_setopt( $api, CURLOPT_POST, 1 );
curl_setopt( $api, CURLOPT_RETURNTRANSFER, 1 );
curl_setopt( $api, CURLOPT_POSTFIELDS, $data );
$res = curl_exec( $api );
curl_close( $api );
$signup = json_decode( $res, true );
// reload page after signup
if( isset( $signup['success'] ) ) { header( 'location: ?' ); exit; }
}
?>
<!doctype html>
<html>
<head>
<meta charset="utf-8">
<title>AffiliationSoftware API example</title>
</head>
<body>
<h1>Affiliate program</h1>
<?php if( isset( $affiliate['refid'] ) ) { ?>
<h3>Your affiliate link</h3>
<p><?php echo $affiliate['link']; ?></p>
<h3>Your statistics</h3>
<ul>
<li>Pending commissions: <strong><?php echo $statistics['transactions_pending']; ?> €</strong></li>
<li>Approved commissions: <strong><?php echo $statistics['transactions_approved']; ?> €</strong></li>
<li>Paid commissions: <strong><?php echo $statistics['transactions_paid']; ?> €</strong></li>
</ul>
<?php } else { ?>
<h3>Sign up as affiliate</h3>
<p><a href='?signup'>Click to join</a></p>
<?php } ?>
</body>
</html>
Sentiti libero di usarlo per il tuo progetto, ma non dimenticare di sostituire l'URL e la chiave API con la tua. Puoi trovare la tua API in: Pannello admin > Impostazioni > AffiliationSoftware.
Naturalmente questo è un esempio di base, ma puoi migliorarlo con altre funzioni e puoi anche implementare facilmente il tuo design.
Articolo pubblicato il: 01.09.2021