Cómo Registrar Nuevos Promotores

Básicamente, existen dos vías para registrar nuevos promotores con AIM en la Plataforma de Genius Referrals.

  1. Usando una de nuestras SDK.
  2. Usando nuestra API RESTful. Revise los detalles aquí.

Usando una de nuestras SDKs es muy fácil y puedes hacerlo llamando al método postAdvocate(...) para registrar el nuevo promotor y llamando el método postAdvocate(...) para establecer la moneda apropiada para el promotor. Debajo te mostramos un ejemplo.  

Recuerde que cada cliente en su plataforma representa un promotor en la plataforma Genius Referrals. Por lo que usted tiene que registrar todos sus clientes en la Plataforma de Genius Referrals.

Cuando registre nuevos promotores, usted tiene que enviar los siguientes parámetros 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: Esto representa la cantidad total en bonificaciones que el promotor tiene que generar antes de ser capaz de canjear sus bonificaciones.

Existen dos vías para obtener el parámetro Account Slug. Puedes obtenerlo en la página de tu cuenta en nuestro Centro de Control o usando el método getAccounts de la SDK

Evitando enviar información personal a la Plataforma de Genius Referrals

Si por razones de seguridad usted no puede enviar información personal de sus clientes a nuestra plataforma, usted puede enviar referencias para el nombre, apellido y correo electrónico. Tenga en cuenta que usted debe guardar estas referencias localmente en su aplicación.  

Como ejemplo vamos a crear el siguiente promotor para la cuenta 'Mi tienda' que creamos previamente.

  • Account Slug: my-store
  • Name: John
  • Last Name: Smith
  • Email: john@email.com
  • Payout Threshold:


Ejemplo usando la SDK de PHP: 

Usando la SDK de Javascript

Tenemos varios ejemplos aquí de cómo implementar esta integración con Javascript. Así que revísala si Javascript es lo que quieres usar.  

Usando las Aplicaciones de Ejemplo

También tenemos dos aplicaciones de ejmplos donde puede ver la integración en acción, descargue las aplicaciones de ejemplo aquí

Actualizando la moneda del promotor

Luego de registrar un promotor, necesita actualizar la moneda de un promotor o el promotor no será capaz de recibir bonificaciones. 

    /*
     * En su metodo accion haga algo similar a esto
     */
    
    // Cree un objeto GRPHPAPIClient 
    $objGeniusReferralsAPIClient = new GRPHPAPIClient('YOUR_USERNAME', 'YOUR_API_TOKEN');

    //preparando los datos a ser enviados en el pedido
    $arrAdvocate = array(
        'advocate' => array(
            "name" => "Jonh", 
            "lastname" => "Smith", 
            "email" => "jonh@email.com", 
            "payout_threshold" => 5
            )
        );
    $objResponse = $objGeniusReferralsAPIClient->postAdvocate('my-store', $arrAdvocate);
    $intResponseCode = $objGeniusReferralsAPIClient->getResponseCode();
    // promotor creado exitosamente
    if($intResponseCode == 201){
        //obteniendo el token del encabezador Location
        $arrLocation = $objResponse->getHeader('Location')->raw(); 
        $strLocation = $arrLocation[0];
        $arrParts = explode('/', $strLocation); 
        $strAdvocateToken = end($arrParts); 
        
        //Actualizando la moneda del promotor
        $arrParams = array('currency_code' =>  'USD'); 
        $objResponse = $objGeniusReferralsAPIClient->patchAdvocate('my-store', $strAdvocateToken, $arrParams); 
        $intResponseCode1 = $objGeniusReferralsAPIClient->getResponseCode();
        if($intResponseCode1 == 204){
            //moneda actualizada exitosamente
            // TODO: guardar la referencia entre el nuevo promotor y el cliente en su base de datos local.
            // Use el $strAdvocateToken como referencia para que luego pueda usar el metodo getAdvocate(...)
            // para recuperar los datos del promotor.
        }
        else{
            // gestione errores
        } 
        
    }
    else{
        // gestione errors
    } 
Recuerde reemplazar los parámetros YOUR_USERNAME y YOUR_API_TOKEN por los generados para ti. 

Para más información relacionada con el objeto Promotor revise nuestra API RESTful y nuestros SDKs


Recurso Extensión Tamaño



Por favor, deje sus comentarios o preguntas debajo