What is the Partner Dashboard Widget?
The Partner Dashboard Widget allows you to securely link your Partners directly to their Partner Dashboards through a button without having to import any data lists to Feathr first. The Partner Dashboard Widget will create a new Partner in real time when we see them for the first time or update an existing Partner if we've seen them before.
How Does it Work?
When the Super Pixel loads, it will scan the page for a widget element with class feathr-dashboard-widget. Once it finds one, it will tell Feathr servers to either create a new Partner or update a Partner with the information embedded in the widget element. Whether or not a new Partner is created depends on whether the data-partner-id value has previously been seen. This means a partner must go to the exhibitor platform before they will be created or updated in Feathr.
Note: data-partner-id maps to External ID in Feathr. If Partners in Feathr don't have External IDs that match your vendor's partner IDs, then duplicates will be created.
Configuring the Widget
Your Registration Vendor, Exhibitor Management platform, and any other Partner Service Providers can easily integrate Feathr's Partner Dashboard into their own systems. This article will refer to these systems a your "vendor".
There are two steps in implementing the Partner Dashboard Widget -- setting up your Super Pixel, and configuring the Widget Elements.
Note: The Super Pixel needs to be included in the same page as the Widget Element.
Widget Element
The Widget element should be placed into a template the display the partner information on the system that you would like to integration with.
The Widget element must be configured correctly to securely link your Partners to their Partner Dashboards. The code is project specific and campaign specific and must be inserted into the page HTML where you would like the widget to appear.
<div class="feathr-dashboard-widget"
data-campaign-id="<feathr invite campaign id>"
data-partner-id="< insert _vendor's_ id for this Partner >"
data-partner-name="< insert company/speaker/exhibitor's name >"
data-partner-email="< insert company/speaker/exhibitor's email >"
data-partner-logo="< insert url of company/speaker/exhibitor logo >"
data-partner-custom-some-paramater="< some custom value >"
data-mode="exit">
</div>
The data-campaign-id will be the ID of the relevant Invite campaign. When a partner is created or updated, they will be added to this campaign and receive the collateral from it. The vendor is responsible for filling in the other attributes in the element.
Super Pixel
Your Super Pixel placement might need to be slightly modified based on whether the application that you are using is Single Page or Multi Page.
- Multi Page: As long as your Super Pixel is included in the same page as your Widget Element, the Super Pixel should work normally and will create or update Partners.
- Single Page: This types of sites don't reload as you navigate. In this case, your Super Pixel will need to be fired after the widget is loaded onto the page. The easiest way to do this is to include the Super Pixel with your widget code, see below for an example. This may result in 2 Super Pixels being present on the page, this is fine for most use cases. Note: Map Your Show is a Single Page Application.
<div class="feathr-dashboard-widget"
data-campaign-id="<feathr invite campaign id>"
data-partner-id="< insert _vendor's_ id for this Partner >"
data-partner-name="< insert company/speaker/exhibitor's name >"
data-partner-email="< insert company/speaker/exhibitor's email >"
data-partner-logo="< insert url of company/speaker/exhibitor logo >"
data-partner-custom-some-paramater="< some custom value >"
data-mode="exit">
</div>
<script>
!function(f,e,a,t,h,r){if(!f[h]){r=f[h]=function(){r.invoke?
r.invoke.apply(r,arguments):r.queue.push(arguments)},
r.queue=[],r.loaded=1*new Date,r.version="1.0.0",
f.FeathrBoomerang=r;var g=e.createElement(a),
h=e.getElementsByTagName("head")[0]||e.getElementsByTagName("script")[0].parentNode;
g.async=!0,g.src=t,h.appendChild(g)}
}(window,document,"script","https://cdn.feathr.co/js/boomerang.min.js","feathr");
feathr("fly", "<YOUR FEATHR ACCOUNT ID>");
feathr("sprinkle", "page_view");
</script>
Note: Reach out to your Customer Success Manger if you need further assistance modifying your Super Pixel.
---
Parameter: data-campaign-id
Required
id of the Feathr Invite Campaign. This should/will be given by Feathr when giving the code to the client / vendor.
---
Parameter: data-partner-id
Required
id of the company/exhibitor/speaker/sponsor from the vendor. The vendor will fill this in on their side.
---
Parameter: data-partner-name
Required
Name of company/exhibitor/speaker/sponsor. The vendor will fill this in on their side.
---
Parameter: data-partner-email
Optional
Email address of the company/exhibitor/speaker/sponsor. If there are multiple emails available then the most primary / main contact is best. The vendor will fill this in on their side.
---
Parameter: data-partner-logo
Optional
URL to the image that represents the logo/headshot/profile of the Partner. Vendor will fill this in on their end.
Ex: https://www.website.com/logo.png
---
Parameter: data-partner-custom-<some>-value>
Optional
The Widget accepts any number of custom parameters which will become custom partner variables in Feathr.
The format is data-partner-custom-any-desired-variable="value"
The above parameter would become PARTNER.ANY_DESIRED_VARIABLE in Feathr.
---
Once the widget has been implemented, your Partners will be able to see and click on the 'Access Dashboard' button on your page to create or update their Partner Dashboard.
