EL PROGRAMA DE MERCADEO DE REFERIDO DE REFERIDOS DE GENIUS REFERRALS




En Genius Referrals sab铆amos desde el comienzo que necesit谩bamos implementar nuestro propio programa de mercadeo de referidos para incrementar nuestra adquisici贸n de clientes a trav茅s de programas de referidos. Los programas de mercadeo de referidos son clave para para adquirir nuevos clientes con alta fidelidad e incrementar las ventas. Es por eso que hemos creado nuestro propio programa de mercadeo de recomendaci贸n de amigos usando nuestras SDKs y decidimos armar un caso de uso para que usted pueda aprender c贸mo implementar su propio programa. Usted puede ver nuestro programa de referidos en tiempo real aqu铆.

El Problema:

Debido a que la mayor铆a de las herramientas de mercadeo (publicidad en la TV , publicidad de radio, carteles, publicidad en Internet, etc.) solo apuntan a clientes aleatorios, es alto el costo de adquirir nuevos clientes y la falta de fidelidad de los nuevos clientes. Genius Referrals ten铆a la necesidad de encontrar nuevas v铆as de adquirir:

  • Nuevos clientes con alto margen de contribuci贸n.
  • Nuevos clientes con alto ratio de retenci贸n.
  • Clientes m谩s valiosos en ambos corto o largo tiempo.

La Soluci贸n:

Luego de investigar varias v铆as para incrementar nuestra adquisici贸n de clientes. El equipo de Genius Referrals decidi贸, que un programa de referidos es el camino a seguir cuando se quiere adquirir nuevos clientes con alto valor y alta fidelidad a un precio razonable. Las investigaciones muestran que nuevos clientes adquiridos a trav茅s de un programa de referidos son m谩s rentables y m谩s leales que otros clientes. El valor promedio de un cliente referido es al menos 16% m谩s alto que el de un cliente que no ha sido referido en similar demograf铆a y tiempo de adquisici贸n.

El programa de Recomendaci贸n de Amigos:

Decidimos implementar un Programa de Recomendaci贸n de Amigos para estimular nuestra adquisici贸n de clientes y ventas.

La campa帽a de marketing asociada con el programa establece lo siguiente:

  • Dar 15% del dinero que un cliente gasta en la Plataforma de Genius Referrals a su promotor.
  • Dar las bonificaciones por los primeros 90 d铆as luego que el cliente ha sido registrado.

Desarrollo:

Para desarrollar este programa primeramente definimos los requerimientos que necesit谩bamos cumplir para tener un programa de recomendaci贸n de amigos exitoso. Luego decidimos las principales interfaces de usuario y finalmente implementamos el programa usando nuestras SDKs.

Los Requerimientos:

El programa de recomendaci贸n de amigos debe cumplir los siguientes requerimientos:

  • Permitir a los promotores recomendar los servicios de la plataforma a trav茅s de los medios sociales (Facebook, Twitter, LinkedIn, WhatsApp and Pinterest), correo electr贸nico, y cualquier otro medio impreso (carteles, folletos, tarjetas de negocio, etc.).
  • Permitir a los promotores ganar bonificaciones a trav茅s de v谩lidas referencias. Una bonificaci贸n tiene que ser dada luego que el cliente referido completa un pago en la Plataforma de Genius Referrals.
  • Permitir a los promotores canjear sus bonificaciones como dinero o cr茅dito. La cantidad m铆nima a canjear por solicitud de canje es $20.
  • Permitir a los promotores revisar la anal铆tica de su programa de referidos.

    El dise帽o (maquetas):

    Antes de saltar dentro de la fase de implementaci贸n, armamos las siguientes maquetas para ser implementadas por nuestro equipo de desarrollo. Decidimos que con 5 pesta帽as pod铆amos cumplir todos los requerimientos.

    Pesta帽a 1: Resumen

    Esta etiqueta ayuda a que nuestros clientes (promotores) se familiaricen con el programa y los motiva a comenzar a compartir los servicios de Genius Referrals con sus amigos.
    Resumen del programa Recomienda a un amigo

    Pesta帽a 2: Acceso

    Los promotores pueden registrarse y acceder a cada una de las funcionalidades.
    Acceso al programa

    Pesta帽a 3: Compartir

    Los promotores pueden recomendar los servicios compartiendo sus enlaces para compartir en las redes sociales (Facebook, Twitter, WhatsApp, Linkedin and Pinterest), enviando correos electr贸nicos a sus amigos, compartiendo su URL personal e imprimiendo su c贸digo QR en carteles, folletos, tarjetas de negocios, etc.
    Herramientas de referencia del programa

    Pesta帽a 4: Ganar

    Los promotores pueden revisar las estad铆sticas (con la cantidad de referencias/bonificaciones por red que han generado) y los gr谩ficos (con la participaci贸n diaria por referencias y la participaci贸n diaria por bonificaci贸n).
    Referencias y Bonificaciones ganadas del programa

    Pesta帽a 5: Recibir Pago

    Los promotores tambi茅n pueden canjear sus bonificaciones en dinero o en cr茅dito usando esta pesta帽a. Ellos van a necesitar una cuenta de Paypal si desean que el dinero sea canjeado como dinero.
    Canjee sus bonificaciones

    Implementation:

    Implementaci贸n:
    i
    Implementar y gestionar un programa de mercadeo de referidos
    La Implementaci贸n y administraci贸n de este programa de recomendaci贸n de amigos parece que es un mont贸n de trabajo, y realmente lo es si haces todo el trabajo tu solo. Gracias a la Plataforma de Genius Referrals puedes implementar y mantener un programa de recomendaci贸n de amigos con una intervenci贸n m铆nima y sin arruinarse. Cuando usas nuestra sofisticada plataforma obtienes todos estos beneficios.
    Para implementar este programa de recomendaci贸n de amigos usando Genius Referrals, necesitamos seguir las siguientes orientaciones descritas en la secci贸n integraci贸n. Estamos usando AIM como m茅todo de integraci贸n debido a que es el m茅todo m谩s flexible que se puede utilizar cuando est谩 integrando su programa de mercadeo de referidos. Esto significa que puede hacer pr谩cticamente cualquier cosa con AIM, nosotros recomendamos fuertemente el uso de este m茅todo de integraci贸n.

    Configurando la nueva cuenta en la Plataforma Genius Referral:

    Luego de completar el proceso de registro (primer paso en AIM) creamos una cuenta y campa帽a para nuestro sitio Web (paso 2 en AIM).
    Cuando creamos una nueva campa帽a configuramos el tipo de campa帽a como porcentaje porque estamos dando 15% del pago del promotor al referente del promotor. Hemos creado un nivel "1 = referrals 15%" que puedes leer de esta forma:
    i
    A partir de que un promotor ha generado al menos una referencia, dar el 15% del pago que sus promotores referidos han hecho en el sistema.
    En la pesta帽a Elegibilidad es donde espec铆ficas las restricciones para la campa帽a de mercadeo de referidos. En este caso en particular la 煤nica restricci贸n que tenemos es la cantidad de d铆as en que la campa帽a estar谩 activa. Por lo que, establecemos 90 d铆as en el campo Cantidad de d铆as porque la campa帽a estar谩 activa por solo 3 meses luego que el promotor referido se ha registrado.

    Configurando un paquete de widgets para la campa帽a:

    Luego de configurar la nueva cuenta y campa帽a, es tiempo de configurar el paquete de widgets que a ser谩 usado en la campa帽a.
    i
    La importancia de los paquetes de widgets
    Los Paquetes de Widgets nos permiten configurar los contenidos por defecto que queremos que nuestros promotores compartan en los medios sociales cuando recomienden nuestros servicios. Es 煤til crear m谩s de un paquete de widgets si su aplicaci贸n tiene m谩s de un lenguaje o si necesita publicar nuevas campa帽as promocionales en un per铆odo corto de tiempo, revise los detalles aqu铆.
    La informaci贸n general del paquete: Como nuestro sitio Web est谩 internacionalizado, necesit谩bamos paquetes de widgets para cada lenguaje, para que nuestros promotores fueran capaces de compartir los contenidos por defecto del programa de referidos en su lenguaje local. El siguiente paquete de widgets es un ejemplo de los que hemos creado para nuestra plataforma (paso 4 en AIM).

    Note como hemos configurado la Campa帽a para que sea 'Get 15% for 90 days' y el Lenguaje para que sea Ingl茅s.
    The package general information

    La configuraci贸n de los widgets:

    Despu茅s de configurar la informaci贸n 煤til del paquete, establecemos los widgets para todas las redes. Aqu铆 especificamos la informaci贸n que nuestros promotores compartir谩n en las redes sociales.
    i
    Definiendo los contenidos por defecto de los widgets
    Su equipo de marketing es responsable de definir los contenidos a ser publicados por defecto en las redes sociales. Asegure que que han hecho su investigaci贸n y han armado una buena redacci贸n con alto valor y calidad que est茅 orientada a la audiencia adecuada. El 茅xito de su programa de mercadeo de referidos depende en gran medida de cu谩n interesantes estos contenidos son.

    Configuraci贸n del widget de Facebook:

    En la parte derecha de la imagen de abajo, puede ver un ejemplo de los contenidos por defecto que ser谩n publicados en Facebook una vez que el promotor ha hecho clic en el enlace para compartir de Facebook. Revisa abajo como hemos configurado el widget. Para el paquete de Facebook tambi茅n puede especificar m煤ltiples im谩genes, la URL del autor y la URL de la editorial.
    The Facebook widget set up

    Configuraci贸n del widget de Twitter:

    Configurar el widget de Twitter es muy simple, solo necesitas entrar el tweet que quieres que sea publicado en Twitter y eso es pr谩cticamente todo lo que hay que hacer. Una cosa que tienes que tener en cuenta es la localizaci贸n de la etiqueta [url].
    i
    Componiendo el tweet
    El tweet es compuesto por tweet+url. La URL (URL para compartir) consumir谩 22 caracteres de su tweet. Usted solo tiene 118 caracteres, as铆 que haga que cada palabra cuente. La etiqueta [url] ser谩 reemplazada autom谩ticamente por la URL para compartir que ser谩 publicado en Twitter. Si desea cambiar la localizaci贸n de la etiqueta [url], mu茅vela a la localizaci贸n adecuada dentro del tweet. Si por alguna raz贸n, decides eliminar la etiqueta [url] del tweet, la URL para compartir ser谩 adicionada autom谩ticamente al final del tweet.
    Mira c贸mo hemos configurado el widget de Twitter.
    The Twitter widget set up

    Configuraci贸n del widget de LinkedIn:

    La configuraci贸n del LinkedIn es muy similar a las anteriores y se explica por s铆 sola, solo tenemos que configurar el t铆tulo personalizado, el sumario y la fuente. Revise debajo como hemos configurado el nuestro.
    The Linkedin widget set up

    Configuraci贸n del widget de Pinterest:

    Para Pinterest hemos configurado la descripci贸n y la URL de la imagen que queremos que los promotores compartan en esta red social en particular. Como s贸lo puedes publicar una sola imagen en este widget, recomendamos que publique una con contenidos de alto valor y calidad de resoluci贸n.
    i
    Usando Pinterest
    Este servicio es muy bueno para compartir Carteles, folletos u otro tipo de medio para promover sus servicios.
    The Pinterest widget set up

    Configuraci贸n del widget de WhatsApp :

    La configuraci贸n del WhatsApp es muy similar a las anteriores, solo tenemos que configurar el sumario. Revise nuestra configuraci贸n para este widget
    The WhatsApp widget set up

    Sus enlaces y URL para compartir:

    El objetivo principal de configurar un paquete de widgets es obtener la lista de enlaces y URL para compartir que puedes publicar m谩s adelante en sus p谩ginas de referencias, y que sus promotores puedan hacer clics para compartir los contenidos por defecto (que has configurado previamente) en:

    • Los medios sociale
    • Correos electr贸nico
    • Mensajes personale
    • Tarjetas de negocio
    • Carteles
    • Folletos
    Despu茅s de completar la configuraci贸n de los widgets, finalmente tenemos la lista de enlaces y URLs para compartir. Note c贸mo el sistema ha generado una URL para compartir en cada red.

    El dominio gr3f.co es el que utilizamos para proveer redirecciones de alto rendimiento entre nuestros clientes, las redes sociales y viceversa.
    Los par谩metros de las URLs para compartir:
    Par谩metro
    Descripci贸n
    advocate_token
    El token del promotor del cliente que esta compartiendo el v铆nculo o URL.
    widget_id
    El identificador del widget
    i
    Trabajando con los par谩metros
    El advocate_token que parece en la cadena de la consulta necesita ser reemplazado en su aplicaci贸n por el token del promotor adecuado.
    The widgets package share links

    Instalando la SDK de Genius Referrals:

    El pr贸ximo paso (paso 4 en AIM) luego de terminar la configuraci贸n del paquete de widgets es descargar e instalar una de nuestras SDKs en su proyecto.

    En este caso usamos la SDK para PHP de Genius Referrals que puede descargar aqu铆. Puede encontrar m谩s detalles del proceso de instalaci贸n aqu铆.

    Registrando nuevos promotores en la Plataforma de Genius Referrals:

    Una vez que hemos exitosamente instalado y probado la SDK para PHP usando estos ejemplos. Estamos en condici贸n de comenzar a enviar pedidos para registrar nuevos promotores en la Plataforma de Genius Referrals (paso 5 en AIM).
    i
    Recuerde que cada cliente en su aplicaci贸n representa un promotor en la Plataforma de Genius Referrals. Por lo tanto, tiene que registrar todos sus clientes en la Plataforma de Genius Referrals.

    Cuando registra nuevos promotores, necesita enviar la siguiente informaci贸n para cada promotor:

    • Account Slug: El identificador de la cuenta
    • Name: El nombre del promotor
    • Last name: El apellido del promotor
    • Email: El correo electr贸nico del promotor
    • Payout Threshold (Umbral de pago): Esto representa la cantidad de bonificaciones que el promotor tiene que generar antes de poder canjear sus bonificaciones.
    Find the location of your account slug
    i
    Evitando enviar informaci贸n personal a la Plataforma Genius Referrals
    Si por razones de seguridad usted no puede enviar informaci贸n personal de sus clientes a nuestra plataforma, en su lugar puedes enviar referencias para el nombre, apellido y correo electr贸nico. Tenga en cuenta que debe almacenar estas referencias localmente en sus aplicaci贸n.
    Una de las restricciones del programa de recomendaci贸n de amigos de Genius Referrals es que un promotor puede canjear sus bonificaciones como cr茅dito o dinero una vez que ha generado al menos $20 (Umbral de pago).
    Permitir a los promotores canjear sus bonificaciones como cr茅dito o dinero. El m铆nimo permitido por pedido de canje es $20.
    El primer punto a tocar en la aplicaci贸n de Genius Referrals es el proceso de registro. Cada vez que un cliente completa el proceso de registro exitosamente ten铆amos que crear un nuevo promotor en la Plataforma de Genius Referrals usando una de nuestras SDKs. El ejemplo de abajo muestra c贸mo hacerlo usando la SDK de PHP.
    Como ejemplo, vamos a crear el siguiente promotor para la cuenta 'Genius Referrals' que hemos creado previamente.

    • Account Slug: genius-referral
    • Name: John
    • Last name: Smith
    • Email: john@email.com
    • Payout Threshold: 20
    Ejemplo usando la SDK de PHP:
    i
    Usando la SDK de Javascript
    Tenemos varios ejemplos que muestran c贸mo implementar esta integraci贸n con Javascript aqu铆. As铆 que rev铆salos si Javascript es la v铆a que quieres utilizar. Tambi茅n tenemos dos aplicaciones de ejemplos donde puede ver la integraci贸n en acci贸n, descargue las aplicaciones de ejemplo aqu铆.


    Estableciendo la moneda del promotor
    Luego de registrar el promotor necesita actualizar su moneda, de lo contrario el promotor no ser谩 capaz de recibir bonificaciones.
    i
     /*
         * En su m茅todo acci贸n haga algo similar a esto
         */
        
        // Cree un nuevo objeto GRPHPAPIClient 
        $objGeniusReferralsAPIClient = new GRPHPAPIClient('YOUR_USERNAME', 'YOUR_API_TOKEN');
    
        //preparando los datos a ser enviados en su pedido
        $arrAdvocate = array(
            'advocate' => array(
                "name" => "Jonh", 
                "lastname" => "Smith", 
                "email" => "jonh@email.com", 
                "payout_threshold" => 20
                )
            );
        $objResponse = $objGeniusReferralsAPIClient->postAdvocate('genius-referrals', $arrAdvocate);
        $intResponseCode = $objGeniusReferralsAPIClient->getResponseCode();
        // promotor creado exitosamente
        if($intResponseCode == 201){
            //obteniendo el token del promotor del encabezado Location
            $arrLocation = $objResponse->getHeader('Location')->raw(); 
            $strLocation = $arrLocation[0];
            $arrParts = explode('/', $strLocation); 
            $strAdvocateToken = end($arrParts); 
            
            //Actualizando el promotor con su moneda
            $arrParams = array('currency_code' =>  'USD'); 
            $objResponse = $objGeniusReferralsAPIClient->patchAdvocate('genius-referrals', $strAdvocateToken, $arrParams); 
            $intResponseCode1 = $objGeniusReferralsAPIClient->getResponseCode();
            if($intResponseCode1 == 204){
                // moneda exitosamente actualizada
                // TODO: Guardar la referencia entre el nuevo promotor y el cliente en su base de datos local.
                // Utilice el $strAdvocateToken como referencia para que luego pueda usar el metodo getAdvocate(...)
                // para recuperar los datos del promotor.
            }
            else{
                // gestion de errores
            } 
            
        }
        else{
            // gestion de errores
        }
    i
    Recuerde reemplazar los valores YOUR_USERNAME y YOUR_API_TOKEN por los que fueron generados para ti.

    Permitiendo que nuestros promotores compartan sus enlaces para compartir:

    Una vez que ya hab铆amos registrado un cliente como un promotor en la Plataforma de Genius Referrals, necesit谩bamos ser capaces de permitirle compartir (paso 6 en AIM) los contenidos que definimos previamente en la secci贸n paquetes de widgets.

    Existen dos v铆as que puedes utilizar para obtener los enlaces para compartir de un promotor, y publicarlos en tu p谩gina personalizada de recomendaci贸n de amigos. El primer m茅todo es construir usted mismo, los enlaces para compartir para tus promotores, tomando la informaci贸n de la p谩gina de paquetes de widgets, y la segunda es obtener los enlaces para compartir usando una SDK o nuestra API RESTful directamente. Usar la SDK para obtener los enlaces para compartir es muy f谩cil, hemos implementado un m茅todo que puedes utilizar para este prop贸sito. Solo necesitas saber eladvocate_token, la campa帽a y el paquete de widgets que quiere que sus promotores compartan. Revise la documentaci贸n de referencia para m谩s detalles.
    Ejemplo usando la SDK de PHP:
     /*
         * En su m茅todo acci贸n haga algo similar a esto 
         */
    
        //El token del promotor
        $strGRAdvocateToken  = 'cc6bdb82850654d89bebada2b52e8028922b098c1d3'; 
        
        // Creando un nuevo objeto GRPHPAPIClient 
        $objGeniusReferralsAPIClient = new GRPHPAPIClient('YOUR_USERNAME', 'YOUR_API_TOKEN');
    
        $strResponse = $objGeniusReferralsAPIClient->getAdvocatesShareLinks('genius-referrals', $strGRAdovocateToken);
        $intResponseCode = $objGeniusReferralsAPIClient->getResponseCode();
        if($intResponseCode == 200){
            $objResponse = json_decode($strResponse);
        }
        else{
            // gestion de errores
        }
    Una vez que ha obtenido los enlaces para compartir usando la SDK puede analizar la informaci贸n y obtener las URLs para compartir para cada red. Luego construya los enlaces para compartir de acuerdo a sus necesidades.

    El panel de control de los promotores:

    Para implementar la pesta帽a panel de control (paso 7 en AIM) hemos usando nuevamente la SDK para consumir las estad铆sticas de los promotores. Puedes obtener informaci贸n importante que puede ser mostrada en gr谩ficas que motivaron a sus promotores a compartir m谩s sus servicios e incrementar la probabilidad de adquirir nuevos clientes. Los m茅todos que puede usar para obtener estas perspectivas con los siguientes:

    • getBonusesSummaryPerOriginReport: Obtiene la cantidad de bonificaciones que sus promotores han recibido por red. Vea un ejemplo aqu铆.
    • getReferralsSummaryPerOriginReport: Obtiene la cantidad de referencias que un promotor ha recibido por red. Vea un ejemplo aqu铆.
    Capturando nuevas Referencias:

    Una vez que un promotor ha compartido un enlaces para compartir en una de las redes, eventualmente el enlaces para compartir ser谩 clickeado por uno de los amigos de su promotor. Cuando el v铆nculo es clickeado, el amigo ser谩 redireccionado a su aplicaci贸n y aterrizar谩 en la URL de aterrizaje que especificamos en la configuraci贸n del paquete de widgets. En este momento, usted necesita ser capaz de obtener el token del promotor, el slug de la campa帽a y el slug del origen de la referencia que forman parte de la URL de aterrizaje y crear una nueva referencia para el promotor que ha compartido el v铆nculo (paso 8 en AIM). Los par谩metros que son incluidos en la cadena URL son:

    • gr_at: Almacena el token del promotor referente
    • gr_cs: Almacena el slug de la campa帽a
    • gr_ro: Almacena el slug del origen de la referencia.
    Aqu铆 tiene un simple ejemplo que puede utilizar para obtener los par谩metros.
    Ejemplo usando la SDK para PHP:
    /*
     * En su metodo accion haga 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 una conexi贸n entre el nuevo cliente (un cliente potencial) y su referente (el promotor que ha compartido el enlace). Esto deber铆a ser hecho luego que el cliente potencial ha terminado el proceso de registro porque existe la probabilidad de que el cliente potencial nunca termine el proceso de registro. Por lo que, tenemos que guardar las variables $strGRAdvocateReferrerToken, $strGRCampaignSlug y $strGRReferralOriginSlug en alg煤n lugar (una sesi贸n de PHP por ejemplo) y una vez que el cliente potencial ha terminado el proceso de registro ( y hemos registrado el promotor en la Plataforma de Genius Referrals) creamos la nueva referencia para el promotor referente que ha compartido el enlace. Aqu铆 tiene un ejemplo.
    Ejemplo usando la SDK para PHP:
    /*
         * En su metodo accion haga algo similar a esto
         */
    
        //cargando los parametros guardados en la sesion
        $strGRAdvocateReferrerToken  = $_SESSION['strGRAdvocateReferrerToken']; 
        $strGRCampaignSlug           = $_SESSION['strGRCampaignSlug'];
        $strGRReferralOriginSlug     = $_SESSION['strGRReferralOriginSlug'];
    
        // Creando un nuevo objeto 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 ha creado exitosamente, continue
        }
        else{
            //gestion de errores
        }

    Dando bonificaciones a los promotores:

    Ahora que estamos exitosamente registrando nuevos promotores, permitiendo que compartan los servicios en las redes y capturando y creando nuevas referencias (conexiones entre los promotores). Estamos en una posici贸n donde podemos comenzar a dar bonificaciones a los promotores luego que se dispare una acci贸n en nuestra aplicaci贸n (paso 9 en AIM).

    En el programa de recomendaci贸n de amigos de Genius Referrals estamos dando a los promotores 15% del pago que un promotor referido ha hecho en el sistema. Esto significa que nuestra acci贸n disparadora es un pago completado. Por lo que, inmediatamente despu茅s que un pago es completado en nuestra plataforma, intentamos dar una bonificaci贸n al referente del promotor. Aqu铆 tiene un ejemplo de c贸mo puedes dar bonificaciones a tus promotores.
    Ejemplo usando la SDK de PHP:
    /*
         * En su metodo acci贸n haga algo similar a esto
         */
    
        //El token del promotor que ha hecho el pago
        $strGRAdvocateToken  = 'cc6bdb82850654d89bebada2b52e80289b098c1d3'; 
        
        // Crea un objeto GRPHPAPIClient 
        $objGeniusReferralsAPIClient = new GRPHPAPIClient('YOUR_USERNAME', 'YOUR_API_TOKEN');
    
        //preparando la informaci贸n a enviar en el pedido
        $arrParams = array(
            'bonus' => array(
                'advocate_token'       => $strGRAdvocateToken, //el promotor que hizo el pago
                'reference'            => rand(1000000, 9999999), //Un n煤mero de referencia, podr铆a ser el id del pago, time, etc.
                'amount_of_payments'   => 1, 
                'payment_amount'       => 100 //la cantidad del pago hecha por el promotor referido.
            )
        );
        //intentando dar una bonificacion el promotor referente.
        $strResponse = $objGeniusReferralsAPIClient->postBonuses('genius-referrals', $arrParams); 
        $intResponseCode = $objGeniusReferralsAPIClient->getResponseCode();
        if($intResponseCode == 201){
            // bonificaci贸n dada al referente del promotor. 
        }
        else{
            // No hay necesidad de dar una bonificaci贸n al referente del promotor.
        }
    i
    Enviando los par谩metros correctos
    Usted sol贸 necesita enviar el advocate_token y la referencia como par谩metros obligatorios. La amount_of_payment y payment_amount son par谩metros opcionales y dependen del tipo de restricci贸n que ha configurado en sus campa帽a

    Permitiendo que sus promotores canjeen sus bonificaciones:

    Los promotores estar谩n constantemente refiriendo sus servicios en las redes y estar谩n generando nuevas referencias y bonificaciones r谩pidamente. Te sorprender谩s de lo r谩pido que, este servicio de voz a voz puede incrementar tu adquisici贸n de clientes. Despu茅s que hayan generado algunas bonificaciones, sus promotores van a querer su dinero. Por lo que tienen que ser capaz de canjear sus bonificaciones como dinero, bienes o cr茅ditos.

    En el programa de recomendaci贸n de amigos de Genius Referrals, dejamos que nuestros promotores canjeen sus bonificaciones como dinero usando una cuenta de Paypal o como cr茅dito que es acreditado en su cuenta de Genius Referrals. La 煤nica restricci贸n que los promotores tienen en esta campa帽a es que pueden canjear sus bonificaciones una vez que han alcanzado el umbral de $20.

    Para permitir que los promotores canjeen sus bonificaciones (de acuerdo con el dise帽o implementado previamente) b谩sicamente tenemos que garantizar lo siguiente:

    1. Mostrar la cantidad de bonificaciones disponibles que nuestro promotor puede canjear.
    2. Validar que el promotor ha alcanzado el umbral de $20.
    3. Permitir que el promotor adicione una cuenta de Paypal para que pueda canjear sus bonificaciones como dinero.
    4. Permitir al promotor hacer un pedido de canje.
    5. Mostrar el historial de los pedidos de canje.
    Mostrar la informaci贸n de las bonificaciones es muy f谩cil y puedes acceder a ella r谩pidamente obteniendo el promotor con el m茅todo getAdvocate(...) desde una de nuestras SDKs, revisa aqu铆 un ejemplo de las respuestas que obtendr谩s. En la respuesta, el par谩metro claimed_balance representa la cantidad de bonificaciones que el promotor ya ha canjeado, el par谩metro unclaimed_balance representa la cantidad pendiente a canjear.

    Para permitir que el promotor adicione una cuenta de Paypal usamos el m茅todo postAdvocatePaymentMethod(...) para crear el nuevo m茅todo de pago y el m茅todo getAdvocatePaymentMethods(...) para mostrar la lista de m茅todos de pago.
    Ejemplo usando la SDK de PHP:
      /*
         * En su metodo acci贸n haga algo similar a esto
         */
    
        //El token del promotor del cliente que quiere adicionar una cuenta de paypal
        $strGRAdvocateToken  = '44ae47f4eda382a8f5830b78fedb7cf1de88981b0'; 
    
        // Crear un objeto GRPHPAPIClient
        $objGeniusReferralsAPIClient = new GRPHPAPIClient('YOUR_USERNAME', 'YOUR_API_TOKEN');
    
        //preparando los datos a enviar en el pedido
        $arrParams = array(
            'advocate_payment_method' => array(
                'username'       => 'john@mail.com',
                'description'    => 'Personal Paypal account', 
                'is_active'      => true
            )
        );
        //intentando crear una nueva cuenta de paypal para el promotor
        $strResponse = $objGeniusReferralsAPIClient->postAdvocatePaymentMethod('genius-referrals', $strGRAdovocateToken, $arrParams); 
        $intResponseCode = $objGeniusReferralsAPIClient->getResponseCode();
        if($intResponseCode == 201){
            // Cuenta de Paypal creada exitosamente
        }
        else{
            // gestion de errores
        } 
    Para permitir que los promotores canjeen sus bonificaciones usamos el m茅todo postRedemptionRequest(...) el cual crea un pedido de canje que es procesado m谩s tarde por uno de nuestros administradores de cuentas en el Portal. Una vez que el pedido ha sido completado, el promotor recibir谩 la bonificaci贸n en la forma que ha solicitado (cr茅dito, dinero o un bien). El ejemplo de abajo muestra los detalles.
    i
    Gestionando los pedidos de canje completamente en su aplicaci贸n
    Usted puede procesar los pedidos de canje en su aplicaci贸n usando una de nuestras SDKs. Esto significa que puedes crear y procesar los pedidos directamente en su aplicaci贸n sin tener que ir al Centro de Control. Puedes usar el m茅todo patchRedemptionRequestRedemption(...) para aprobar y completar un pedido de canje.
    Ejemplo usando la SDK de PHP:
    /*
         * En sus metodo acci贸n, has algo similar a esto
         */
    
        //El token del promotor que quiere canjear su bonificacion
        $strGRAdvocateToken  = '44ae47f4eda382a8f5830b78fedb7cf1de88981b0'; 
    
        // Crear un nuevo objeto GRPHPAPIClient
        $objGeniusReferralsAPIClient = new GRPHPAPIClient('YOUR_USERNAME', 'YOUR_API_TOKEN');
        
        //Preparando los datos a ser enviados en el pedido 
        $arrParams = array(
            'redemption_request' => array(
                'advocate_token'            => $strGRAdovocateToken,
                'request_status_slug'       => 'requested', 
                'request_action_slug'       => 'credit',
                'currency_code'             => 'USD',
                'amount'                    => 50,
                'description'               => 'Redeeming as credit'
            )
        );
        
        //intentando crear un nuevo pedido de canje para el promotor. 
        $strResponse = $objGeniusReferralsAPIClient->postRedemptionRequest('genius-referrals', $arrParams); 
        $intResponseCode = $objGeniusReferralsAPIClient->getResponseCode();
        if($intResponseCode == 201){
            // Pedido de canje creado exitosamente
        }
        else{
            // gestion de errores
        }  
    Los par谩metros requests_status_slug, request_action_slug y currency_code son utilidades que usamos para crear los pedidos de canje. Puedes obtener la lista completa de ellas usando estos m茅todos getRedemptionRequestStatuse, getRedemptionRequestsAction y getCurrencie con una de nuestras SDKs.

    Para mostrar el historial de pedidos de canje usamos el m茅todo getRedemptionRequests(...) y usamos los filtros para obtener solo los pedidos de canje para el promotor espec铆fico. Una vez que obtenemos la colecci贸n de datos, la mostramos en una tabla.
    Ejemplo usando la SDK de PHP:
    /*
         * En su m茅todo acci贸n haga algo similar a esto
         */
    
        // Cree un nuevo objeto GRPHPAPIClient
        $objGeniusReferralsAPIClient = new GRPHPAPIClient('YOUR_USERNAME', 'YOUR_API_TOKEN');
        
        $strResponse = $objGeniusReferralsAPIClient->getRedemptionRequests('genius-referrals', 1, 10, 'email::john@mail.com'); 
        $intResponseCode = $objGeniusReferralsAPIClient->getResponseCode();
        if($intResponseCode == 200){
            // pedido exitosamente procesado
            $objResponse = json_decode($strResponse); 
            //TODO: mostrar datos al usuario 
        }
        else{
            // gestion de errores
        }
    Arriba estamos obteniendo los primeros 10 pedidos de canje para el promotor con correo electr贸nico john@mail.com. M谩s informaci贸n sobre este m茅todo en nuestra documentaci贸n de referencia de la API.

    Monitoreando y administrando sus cuentas:

    Esta es la 煤ltima secci贸n de esta p谩gina y es donde explicamos la importancia de monitorear y administrar sus programas de recomendaci贸n de amigos. En nuestro Portal encontrar谩s varias herramientas que le ayudar谩n a administrar su programa de recomendaciones de referidos. Usted puede crear nuevos programas y campa帽as, paquetes de widgets sociales, promotores, bonificaciones, hacer pagos, etc. Pr谩cticamente todo lo que puedes hacer con las SDKs y m谩s puedes hacerlo con las interfaces de usuario de nuestro Centro de Control.

    Nosotros adem谩s, mostramos perspectivas que pueden ayudarle a analizar y optimizar su programa de mercadeo de referidos. Hemos estudiado de cerca las m茅tricas m谩s importantes cuando se trata de programas de mercadeo de referidos y hemos armado la anal铆tica que le ayudar谩 a obtener lo mejor de su programa de mercadeo de referidos. Obtienes todas las estad铆sticas descompuestas por red (Facebook, Twitter, LinkedIn, Pinterest, Email, PURL) para que puedas tirar de los hilos necesarios.

    A medida que su programa de mercadeo de referidos madura, es muy importante que preste atenci贸n a la visi贸n que le presentamos y tome acciones apropiadas si ve un decline en su adquisici贸n de clientes. Para mantener su programa de recomendaci贸n de amigos funcionando con alto rendimiento, este debe evolucionar constantemente. Algunas veces, tendr谩 que ajustar los contenidos por defectos de tus paquetes de widgets y otras veces tendr谩s que crear mejores campa帽as para aumentar la atracci贸n de clientes. Aqu铆 tiene algunos ejemplos de la anal铆tica que puede encontrar en nuestro Centro de Control.
    Ejemplo de las estad铆sticas:
    Refer a friend marketing program insights
    LANGUAGE