Guides

Share Links for Advocate

Suggest Edits

Each participant in your referral program has unique share links that they can send to family and friends as an easy way to make referrals. These links will direct the referred person to the landing page you have configured for your referral program, where the Universal Tracking Tag will create an attribution event between the customer advocate and the person they referred.

If you're building a custom Advocate participant experience, then you'll need to include the customer advocate's share link object to dynamically populate their share links.

🚧

Before building a custom Advocate experience...

Connect with your implementation team to make sure a custom experience is a good fit. We recommend that most clients use the Advocate widget editor to create program widgets. If your organization is unable to do so, e.g., because of a strict Content Security Policy (CSP), then you can create a custom experience instead, using our API or GraphQL to pull in data.

Retrieve the share link object

You can retrieve the share link object you need via REST API, GraphQL, or within your impact.com Advocate program.

Use one of the following REST API calls to retrieve share links.

Reference

Share links are specific to an engagement medium and a share medium. The engagement medium is the method you use to show a participant's share information to them, e.g., a pop-up widget. The share medium is the method the participant used to distribute their share link to others, e.g, via WhatsApp.

Share mediums

  • FACEBOOK
  • FBMESSENGER
  • TWITTER (X)
  • EMAIL
  • DIRECT
  • LINKEDIN
  • SMS
  • WHATSAPP
  • LINEMESSENGER
  • PINTEREST
  • UNKNOWN

Engagement mediums

Engagement MediumDescription
POPUPDisplayed to participants as a pop-up modal that renders on top of other elements on a page.
EMBEDDisplayed to participants in-line as part of your page.
HOSTEDDisplayed to participants in a microsite.
cleanShareLinkA share link available on the participant's profile in your Advocate program.
UNKNOWNA set of share links retrieved for a participant via the user details report.
EMAILDisplayed to participants in program notification emails.
MOBILEDisplayed to participants via the mobile SDKs.

Share link object example

{ 
  "POPUP": {
    "FACEBOOK": "https://ssqt.co/m93Jla9", 
    "TWITTER": "https://ssqt.co/mM3Jla9", 
    "EMAIL": "https://ssqt.co/mo3Jla9", 
    "DIRECT": "https://ssqt.co/m53Jla9", 
    "LINKEDIN": "https://ssqt.co/m73Jla9", 
    "SMS": "https://ssqt.co/ma3Jla9", 
    "FBMESSENGER": "https://ssqt.co/mh3Jla9", 
    "WHATSAPP": "https://ssqt.co/mF3Jla9", 
    "LINEMESSENGER": "https://ssqt.co/mD3Jla9", 
    "PINTEREST": "https://ssqt.co/Rz3Jla9", 
    "UNKNOWN": "https://ssqt.co/mB3Jla9" 
  	}, 
    "EMBED": { 
      "FACEBOOK": "https://ssqt.co/mw3Jla9", 
      "TWITTER": "https://ssqt.co/mc3Jla9", 
      "EMAIL": "https://ssqt.co/mJ3Jla9", 
      "DIRECT": "https://ssqt.co/mQ3Jla9", 
      "LINKEDIN": "https://ssqt.co/mH3Jla9", 
      "SMS": "https://ssqt.co/m23Jla9", 
      "FBMESSENGER": "https://ssqt.co/mg3Jla9", 
      "WHATSAPP": "https://ssqt.co/mZ3Jla9", 
      "LINEMESSENGER": "https://ssqt.co/mx3Jla9", 
      "PINTEREST": "https://ssqt.co/mf3Jla9", 
      "UNKNOWN": "https://ssqt.co/mX3Jla9" 
    }, 
    "HOSTED": { 
      "FACEBOOK": "https://ssqt.co/mu3Jla9",
      "TWITTER": "https://ssqt.co/mS3Jla9",
      "EMAIL": "https://ssqt.co/ml3Jla9", 
      "DIRECT": "https://ssqt.co/mt3Jla9", 
      "LINKEDIN": "https://ssqt.co/mY3Jla9", 
      "SMS": "https://ssqt.co/mq3Jla9", 
      "FBMESSENGER": "https://ssqt.co/mK3Jla9", 
      "WHATSAPP": "https://ssqt.co/mr3Jla9", 
      "LINEMESSENGER": "https://ssqt.co/mW3Jla9", 
      "PINTEREST": "https://ssqt.co/Rm3Jla9", 
      "UNKNOWN": "https://ssqt.co/mA3Jla9" 
    }, 
    "cleanShareLink": "https://ssqt.co/mz3Jla9",
     "UNKNOWN":{
       "FACEBOOK": "https://ssqt.co/mm3Jla9", 
       "TWITTER": "https://ssqt.co/mR3Jla9", 
       "EMAIL": "https://ssqt.co/mL3Jla9", 
       "DIRECT": "https://ssqt.co/mv3Jla9", 
       "LINKEDIN": "https://ssqt.co/m63Jla9", 
       "SMS": "https://ssqt.co/mk3Jla9", 
       "FBMESSENGER": "https://ssqt.co/m03Jla9", 
       "WHATSAPP": "https://ssqt.co/mI3Jla9", 
       "LINEMESSENGER": "https://ssqt.co/m83Jla9", 
       "PINTEREST": "https://ssqt.co/mp3Jla9",
       "UNKNOWN": "https://ssqt.co/mz3Jla9" 
     }, 
     "EMAIL": { 
       "FACEBOOK": "https://ssqt.co/mT3Jla9", 
       "TWITTER": "https://ssqt.co/mG3Jla9", 
       "EMAIL": "https://ssqt.co/mb3Jla9", 
       "DIRECT": "https://ssqt.co/mP3Jla9",
       "LINKEDIN": "https://ssqt.co/m13Jla9",
       "SMS": "https://ssqt.co/mO3Jla9", 
       "FBMESSENGER": "https://ssqt.co/m43Jla9", 
       "WHATSAPP": "https://ssqt.co/mi3Jla9", 
       "LINEMESSENGER": "https://ssqt.co/my3Jla9", 
       "PINTEREST": "https://ssqt.co/RL3Jla9", 
       "UNKNOWN": "https://ssqt.co/mV3Jla9" 
     }, 
     "MOBILE": { 
       "FACEBOOK": "https://ssqt.co/mn3Jla9", 
       "TWITTER": "https://ssqt.co/mC3Jla9", 
       "EMAIL": "https://ssqt.co/mE3Jla9", 
       "DIRECT": "https://ssqt.co/me3Jla9",
       "LINKEDIN": "https://ssqt.co/m33Jla9", 
       "SMS": "https://ssqt.co/mN3Jla9",
       "FBMESSENGER": "https://ssqt.co/mU3Jla9", 
       "WHATSAPP": "https://ssqt.co/ms3Jla9", 
       "LINEMESSENGER": "https://ssqt.co/md3Jla9", 
       "PINTEREST": "https://ssqt.co/RR3Jla9", 
       "UNKNOWN": "https://ssqt.co/mj3Jla9" 
     } 
}

Updated 9 months ago