Cómo Capturar los Referidos Usando las SDKs

Aprende a capturar los referidos cuando estos hacen clic en un vínculo compartido y llegan a tu página de aterrizaje. En ésta guía te mostramos cómo integrar Genius Referrals con tu aplicación usando la SDK de PHP.

Requisitos Previos

  1. Registro en la plataforma: Regístrate en Genius Referrals y obtén tus credenciales de API.
  2. SDK de Genius Referrals: Asegúrate de haber instalado la SDK de Genius Referrals para PHP.
Paso 1: Capturar los Parámetros de la URL
Captura los parámetros que vienen en la URL cuando se visita un enlace compartido por un promotor y guardarlos usando la session de PHP.

Los parámetros que necesitas extraer de la URL de aterrizaje son:

  • gr_at: Token del promotor que hace la referencia.
  • gr_cs: Identificador de la campaña.
  • gr_ro: Identificador del origen de la referencia.
<?php
// En tu método acción, haz 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;
?>

Nota: Para establecer la conexión entre el Referido y el Promotor que compartió el enlace, debes asegurarte de que el referido haya completado una acción de conversión, ya que existe la posibilidad de que no se convierta en un cliente.
Paso 2: Crear la Conexión entre el Referido y el Promotor
Una vez que el referido haya completado una acción de conversión. Obtén los valores de las sessiones strGRAdvocateReferrerToken, strGRCampaignSlug y strGRReferralOriginSlug y crea el referido usando la SDK de PHP. Aquí tienes un ejemplo:
<?php

require_once "../vendor/autoload.php";
$contentType = "application/json"; // The content type
$xAuthToken = "2f266b71b8038e6"; // Your API Token, you can get your token here https://app.geniusreferrals.com/en/settings/api-access
$accountSlug = 'sandbox';

$client = new GeniusReferralsLib\GeniusReferralsClient($contentType, $xAuthToken);

// Cargando los parámetros de la sesión
$strGRAdvocateReferrerToken = $_SESSION['strGRAdvocateReferrerToken'];
$strGRCampaignSlug = $_SESSION['strGRCampaignSlug'];
$strGRReferralOriginSlug = $_SESSION['strGRReferralOriginSlug'];

// La información del Referido obtenida en el proceso de registro.
$strReferralFirstName = 'Jane';
$strReferralLastName = 'Doe';
$strReferralEmail = 'jane.doe@example.com';

// Creando el Referido, el cual es un promotor que no puede referir
$advocatesController = $client->getAdvocates();

// Preparing data needed to sent on the request
$advocateModel = new \GeniusReferralsLib\Models\Advocate();
$advocateModel->name = $strReferralFirstName;
$advocateModel->lastname = $strReferralLastName;
$advocateModel->email = $strReferralEmail;
$advocateModel->payoutThreshold = 1;
$advocateModel->canRefer = 0; // un referido no puede referir.

$newReferredAdvocate = $advocatesController->postAdvocate($accountSlug, new \GeniusReferralsLib\Models\AdvocateForm($advocateModel));

// Adding the currency to the referral
$advocatePatchForm = new \GeniusReferralsLib\Models\AdvocatePatchForm();
$advocatePatchForm->currencyCode = 'USD';

// Referral currency successfully added
$advocatesController->patchAdvocate($accountSlug, $newReferredAdvocate->token, $advocatePatchForm);

//Creating the referral object to connect the referral and the advocate
$referralsController = $client->getReferrals();

// Preparing data needed to create the referral
$referralModel = new \GeniusReferralsLib\Models\Referral();
$referralModel->campaignSlug = $strGRCampaignSlug;
$referralModel->httpReferer = $_SERVER['HTTP_REFERER'];
$referralModel->referralOriginSlug = $strGRReferralOriginSlug;
$referralModel->referredAdvocateToken = $newReferredAdvocate->token;

$referral = $referralsController->postReferral($accountSlug, $strGRAdvocateReferrerToken, new \GeniusReferralsLib\Models\ReferralForm($referralModel));

if(isset($referral->id)){
    // Referral successfully created
}
else{
    // handle errors
}
Nota: Siguiendo estos pasos, podrás capturar eficazmente los referidos en tu aplicación utilizando las herramientas proporcionadas por Genius Referrals.
¿Fue útil esta página?
LANGUAGE