Skip to main content

Embed Acknowledgement Widget

Display social proof on your website with acknowledgement testimonials

Overview​

The Incentive Request Acknowledgement Widget allows you to display social proof on your website by showing acknowledgement messages from Incentive Recipients who have received incentives. This builds trust and increases conversions.

What the Widget Shows​

ElementDescription
Acknowledgement MessageRecipient's confirmation message
Recipient InformationUsername and avatar
Visual DesignProfessional testimonial-style card

How to Access​

From Request Detail Page​

  1. Navigate to an incentive request detail page
  2. Click the Floating Action Button (FAB) in bottom-right
  3. Select "Embed Acknowledgement Widget"

Direct URL​

Navigate to: /provider/incentive-requests/embed/<incentive_request_id>

Page Layout​

Header Section​

ElementDescription
Back ButtonReturn to previous page
Title"Embed Incentive Request Acknowledgement Widget"
DescriptionPurpose explanation
Take TourInteractive guide

Configuration Panel (Left Side)​

SectionDescription
Embed CodeTextarea with iframe code
Copy ButtonCopy code to clipboard
Preview ButtonOpen widget in new tab

Preview Panel (Right Side)​

SectionDescription
Live PreviewWidget as it appears on your site
Installation InstructionsStep-by-step guide

Getting Your Embed Code​

Step 1: Navigate to Embed Page​

Access via FAB or direct URL.

Step 2: Copy the Embed Code​

  1. Locate the embed code textarea
  2. Click the Copy button (clipboard icon)
  3. See confirmation: "Copied! Embed code copied to clipboard"

Embed Code Format​

<iframe 
  src="https://incentise.com/incentive-request-acknowledgement-widget?incentive_request_id=<ID>" 
  width="320" 
  height="120" 
  frameborder="0" 
  style="border-radius: 8px;">
</iframe>

Installing the Widget​

Step 1: Copy the Embed Code​

Use the copy button on the embed page.

Step 2: Paste on Your Website​

Add the code where you want the widget to appear.

Common Locations:

  • Product pages
  • Service pages
  • Landing pages
  • Checkout pages
  • Homepage testimonials section

Step 3: Customize (Optional)​

Adjust the iframe attributes:

AttributeDefaultDescription
width320Widget width in pixels
height120Widget height in pixels
styleborder-radius: 8pxCustom CSS styling

Previewing the Widget​

Preview Button​

  1. Click "Preview Widget" button
  2. Widget opens in new browser tab
  3. See exactly how it appears to visitors

Live Preview on Page​

  • Right panel shows live preview
  • Updates automatically
  • Accurate representation of final appearance

How the Widget Works​

Data Source​

  • Displays acknowledgement from specific incentive request
  • Shows recipient's username and avatar
  • Uses the acknowledgement message

Real-Time Updates​

  • Widget automatically updates when data changes
  • No manual embed code updates needed

Widget States​

StateDescription
LoadingSpinner while fetching data
SuccessShows acknowledgement message and info
ErrorError message if data unavailable

Requirements​

Acknowledgement Required​

The widget only displays data if:

  • Recipient has acknowledged receiving the incentive
  • Request has reached "Acknowledged" status
  • Valid acknowledgement message exists

One Widget Per Request​

  • Each embed code is specific to one request
  • For multiple acknowledgements, embed multiple widgets

Best Practices​

Strategic Placement​

✅ Recommended:

  • Place on high-traffic pages
  • Position where visible but not intrusive
  • Consider multiple widgets for different requests
  • Use on product/service pages

Design Integration​

  • Adjust widget dimensions to match your design
  • Test on different devices and screen sizes
  • Ensure widget complements page layout

Content Strategy​

  • Use widgets for requests with positive acknowledgements
  • Rotate widgets periodically for fresh content
  • Highlight specific products or services

Performance​

  • Widget loads asynchronously
  • Won't slow down your page
  • Lightweight and optimized

Customization Examples​

Larger Widget​

<iframe 
  src="https://incentise.com/incentive-request-acknowledgement-widget?incentive_request_id=<ID>" 
  width="400" 
  height="150" 
  frameborder="0" 
  style="border-radius: 12px;">
</iframe>

Full-Width Widget​

<iframe 
  src="https://incentise.com/incentive-request-acknowledgement-widget?incentive_request_id=<ID>" 
  width="100%" 
  height="120" 
  frameborder="0" 
  style="border-radius: 8px; max-width: 400px;">
</iframe>

Troubleshooting​

Widget Shows "Error" or "Failed to Load"​

Causes:

  • Request doesn't have an acknowledgement yet
  • Request ID in embed code is incorrect
  • Network connectivity issues

Solutions:

  1. Verify recipient has acknowledged
  2. Check request ID matches
  3. Test with preview button
  4. Check browser console for errors

Widget Doesn't Appear on Website​

Causes:

  • Iframe code not pasted correctly
  • Website blocks iframes
  • CSS/JavaScript conflicts

Solutions:

  1. Verify embed code copied completely
  2. Check platform supports iframe embedding
  3. Test in simple HTML page first
  4. Contact website administrator if blocked

Widget Size Doesn't Fit​

Solutions:

  • Modify width and height attributes
  • Adjust style attribute for custom CSS
  • Test different sizes

Privacy Considerations​

  • Widget displays public information only
  • Shows username and avatar
  • Recipients can choose to remain anonymous
  • No sensitive data exposed