CÓMO REGISTRAR NUEVOS PROMOTORES

Básicamente, existen dos vías para registrar nuevos promotores con AIM en la Plataforma de Genius Referrals.
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.
Revise los detalles aquí.
Recuerde que cada cliente en su aplicación representa un promotor en la plataforma Genius Referrals.
Por lo tanto, debe registrar a todos sus clientes en la plataforma Genius Referrals.

i
Cuando registre nuevos promotores, usted tiene que enviar los siguientes parámetros para cada promotor:
  • Account Slug: El identificador de la cuenta
  • Name: El identificador de la cuenta
  • 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 Portal o usando el método getAccounts de la SDK.
Evitando enviar información personal a la Plataforma de Genius ReferralsSi 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.
i
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: 5
i
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.
i
Usando las Aplicaciones de Ejemplo
También tenemos dos aplicaciones de ejemplos donde puede ver la integración en acción, descargue las aplicaciones de ejemplo aquí.
i
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.
Ejemplo usando el SDK de PHP:
/*
     * 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.
Además, tenemos dos aplicaciones de muestra donde puede ver e integrar en acción. Descargue estas aplicaciones de muestra aquí.
i
Para más información relacionada con el objeto Promotor revise nuestra API RESTful y nuestros SDKs.
LANGUAGE