Create Referral Pages to Easily Share Your Services

Implement referral pages so your advocates can easily share and promote your services. With Genius Referrals, your advocates can use referral links via emails, personalized URLs, and printable QR codes to maximize the reach of your campaigns.

Prerequisites:

  1. Platform Registration: Sign up for Genius Referrals and obtain your API credentials.
  2. Genius Referrals SDK: Ensure you have installed the Genius Referrals SDK for PHP.
  3. Registered Advocate: The advocate must be registered on the Genius Referrals platform.
  4. Authenticated Advocate: The advocate must be authenticated within your program.
Note: If you haven’t completed these requirements yet, we recommend reviewing our Guide to Register Advocates. This guide provides detailed instructions on how to register and authenticate your advocates on the Genius Referrals platform.
Step 1: Obtain Share Links
To integrate a share page into your application, you'll need to retrieve the share links for each advocate from the Genius Referrals Platform. You can do this using our SDKs or RESTful API.

  • Method 1: Manual Configuration
You can manually set up share links by choosing your preferred promotion channels in our platform's Share Messaging section.

  • Method 2: Using SDK or API
For a more efficient process, we recommend using our SDKs or RESTful API to retrieve the share links directly. This approach is straightforward and effective.

To implement the share page in your application, you must obtain the share links for each advocate from the Genius Referrals Platform. You can do this using our SDKs or RESTful API.
Step 2: Use SDKs to Obtain Share Links
We have a method to help you obtain share links for various promotion channels. To use this method, you will need the advocate_token, the campaign, and the promotion channel package you want your advocates to share.
Step 3: Integrate Share Links
Once you have obtained the share links using the SDK, you can analyze the data and retrieve the URL for each promotion channel. Then, create the links according to your needs.
Example using the PHP SDK

<?php

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

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

// Getting the share links package for the advocate
$advocateShareLinksResponse = $client->getAdvocates()->getShareLinks($accountSlug, $advocateToken);

if($advocateShareLinksResponse->code == 200)
{
    $objAdvocateShareLinks = $advocateShareLinksResponse->data;
    // Process the response and get the URLs for each distribution channel. 
} else {
    // Handle errors
}
Example Response

{
   "code":200,
   "data":{
      "get-10-of-for-90-days":{
         "my-first-package":{
            "direct-email":"https://gr3f.co/c/e2323/62",
            "facebook-share":"https://gr3f.co/s/e2323/57",
            "google-1":"https://gr3f.co/s/e2323/59",
            "linkedin-post":"https://gr3f.co/s/e2323/60",
            "personal":"https://gr3f.co/c/e2323/63",
            "pin-it":"https://gr3f.co/s/e2323/61",
            "twitter-post":"https://gr3f.co/s/e2323/58"
         }
      }
   }
}
Note: By following these steps, you can effectively implement a share page in your application, enabling your advocates to easily refer your services through various promotion channels. For additional details, please refer to our SDKs or RESTful API documentation.
Step 4: Integration Options
  • Social Media: Add buttons for each social media platform to your page and link them to the corresponding URL.
  • Email: Provide an email template that includes the obtained referral link.
  • QR Code: Generate a QR code that links to the advocate’s referral URL.
Was this page helpful?
Español
LANGUAGE