CÓMO CAPTURAR NUEVAS REFERENCIAS EN MI PROGRAMA
Una vez que uno de sus promotores utiliza un vínculo para compartir (usando sus vínculos para compartir) sus amigos van a hacer clic en el contenido, que fue publicado en la red, y será redireccionado de vuelta al sitio Web y aterrizará en la página de aterrizaje que definición en su Paquete de Widgets Sociales. En ese momento tiene que ser capaz de capturar la nueva referencia obteniendo los parámetros de la URL y guardar la nueva referencia en la Plataforma de Genius Referrals usando una de nuestras SDKs o RESTful API.
Para capturar una nueva referencia necesitas extraer los siguientes parámetros que fueron incluidos en la URL de aterrizaje, los parámetros son:
Para capturar una nueva referencia necesitas extraer los siguientes parámetros que fueron incluidos en la URL de aterrizaje, los parámetros son:
- gr_at: Almacena el token del promotor que hace la referencia
- gr_cs: Almacena el identificador de la campaña
- gr_ro: Almacena el identificador del origen de la referencia
Ejemplo usando la SDK de PHP
/*
* En su método acción has algo similar a esto
*/
$strGRAdvocateReferrerToken = $_GET['gr_at'];
$strGRCampaignSlug = $_GET['gr_cs'];
$strGRReferralOriginSlug = $_GET['gr_ro'];
$_SESSION['strGRAdvocateReferrerToken'] = $strGRAdvocateReferrerToken;
$_SESSION['strGRCampaignSlug'] = $strGRCampaignSlug;
$_SESSION['strGRReferralOriginSlug'] = $strGRReferralOriginSlug;
El paso final es crear la conexión entre el nuevo cliente (el cliente potencial) y su referente (el promotor que ha compartido el vínculo). Esto debe ser hecho luego que el cliente potencial ha terminado el proceso de registro. Debido a que existe la probabilidad de que el cliente potencial nunca se convierta en uno de sus clientes. Por lo tanto, tienes que guardar las variables $strGRAdvocateReferrerToken, $strGRCampaignSlug y $strGRReferralOriginSlug en algún lugar (por ejemplo, una sección en PHP) y una vez que el cliente potencial ha terminado el proceso de registro (y hayas registrado el promotor en la plataforma de Genius Referrals) puede crear una nueva referencia para el promotor referente que ha compartido el vínculo. Aquí tienes un ejemplo.
Ejemplo usando la SDK de PHP
/*
* En su método acción has algo similar a esto
*/
//cargando los parámetros de la session
$strGRAdvocateReferrerToken = $_SESSION['strGRAdvocateReferrerToken'];
$strGRCampaignSlug = $_SESSION['strGRCampaignSlug'];
$strGRReferralOriginSlug = $_SESSION['strGRReferralOriginSlug'];
// Crear una instancia de GRPHPAPIClient
$objGeniusReferralsAPIClient = new GRPHPAPIClient('YOUR_USERNAME', 'YOUR_API_TOKEN');
$arrParams = array(
'referral' => array(
'referred_advocate_token' => $strGRNewAdovocateToken, //the one create when the advocate was registered.
'referral_origin_slug' => $strGRReferralOriginSlug,
'campaign_slug' => $strGRCampaignSlug,
'http_referer' => $_SERVER['HTTP_REFERER']
)
);
$objGeniusReferralsAPIClient->postReferral('genius-referrals', $strGRAdvocateReferrerToken, $arrParams);
$intResponseCode = $objGeniusReferralsAPIClient->getResponseCode();
if($intResponseCode == 201){
//si se creó exitosamente continúe
}
else{
//gestión de errores
}