Skip to content

How to Schedule Lucit Campaigns in Apparatix

Integration Overview

Apparatix integrates with Lucit through Live Link technology, allowing real-time dynamic content updates without file uploads or manual creative changes. This integration provides seamless dynamic advertising capabilities within the Apparatix player ecosystem.

Prerequisites

✅ Lucit Operator Profile - You must have access to an Operator Profile in Lucit
✅ Apparatix App Installed - The Apparatix app must be added to your Operator Profile (Settings -> Apps & Data -> ADD NEW)
✅ Lucit Campaign with at least one screen configured
✅ Apparatix Player Access with file management permissions
✅ Live Link Enabled in APX (contact Apparatix support if not visible) ✅ APX Player Helper installed on every screen (contact Apparatix support for help)

Step-by-Step Integration

Step 1: Lucit Configuration

  1. Switch to Operator Profile
  2. Click on the Profile Drop-Down in the top-right corner of Lucit
  3. Select your Operator Profile from the list

  4. Verify you see the Operator menu items on the left sidebar

  5. Verify Apparatix App is Installed

  6. Navigate to Settings -> Apps & Data
  7. Confirm the Apparatix app appears in your list

  8. If not visible, click ADD NEW and add the Apparatix app

  9. Access Campaign Management

  10. From your Operator Profile, navigate to Campaigns in the left sidebar

  11. Locate your target campaign in the list

  12. Activate Campaign (if needed)

  13. If the campaign shows as Draft status, click on the campaign
  14. Click the ACTIVATE button to make the campaign active

  15. Confirm campaign is now in active/running state

  16. Open Link Player Dialog

  17. From the Campaigns list, click on your campaign name
  18. Click LINK PLAYER button

  19. The Link Player dialog will open showing available integrations

  20. Access Apparatix Tab

  21. In the Link Player dialog, locate the Apparatix tab
  22. If you don't see the Apparatix tab, return to Step 2 to add the app

  23. Click on the Apparatix tab to view integration options

  24. Copy Live Link URL

  25. Find the Live Link URL in the Apparatix section
  26. Format: https://pull.lucit.app/api/v1/campaigns/apx/v2/{export.hash_id}/pull/html?api_token={token}&n={account_slug}|{export_slug}
  27. Click Copy URL button to clipboard

Step 2: Apparatix Configuration

  1. Access Apparatix File Manager
  2. Log into your Apparatix control panel

  3. Navigate to File Manager section

  4. Create Live Link Item

  5. Click Create New → Live Link
  6. Paste the copied Lucit URL into the URL field

  7. Name the creative (e.g., "Lucit Dynamic Campaign - [Campaign Name]")

  8. Schedule Campaign

  9. Navigate to Scheduling section
  10. Create new playlist or add to existing playlist
  11. Add your Lucit Live Link creative to desired time slots
  12. Apply schedule to target screens/zones

Step 3: Testing & Validation

  1. Verify Live Link Connection
  2. Check that the Live Link URL loads properly in Apparatix preview
  3. Confirm creative displays correctly on test screen

  4. Check that you are receiving real-time play reports in Lucit for this campaign

  5. Test Dynamic Updates

  6. Make a change in your Lucit campaign (update text, data, or imagery)
  7. Wait for refresh interval (60-300 seconds)

  8. Verify changes appear on Apparatix-connected screens

  9. Monitor Performance

  10. Check Apparatix logs for any connection errors
  11. Verify consistent refresh rates and data loading

Troubleshooting

Common Issues

Problem: Live Link URL not working
Solution: - Verify Lucit campaign is published and screens are configured - Make sure your screen identifiers match to the screen identifiers in Apparatix - Make sure that all screen identifiers end in .1 for instance MYSCRA.1 - Confirm Live Link feature is enabled (contact Apparatix support)

Problem: Creative not updating
Solution: - Check refresh interval settings in Apparatix - Verify internet connectivity on player devices
- Confirm campaign changes are saved and published in Lucit

Problem: Not working on some screens - Verify that EACH screen in the campaign has the APX Player Helper installed - Verify that the APX Player Helper is up and running on each screen - Verify that the screen identifiers match for every screen Operator Profile -> Screens -> {Screen} -> Identifier

Problem: Display formatting issues
Solution: - Verify screen resolution settings match Lucit screen settings for each screen

Technical Reference

https://pull.lucit.app/api/v1/campaigns/apx/v2/{export.hash_id}/pull/html
?api_token={token}
&n={account_slug}|{export_slug}

Supported Features

  • Real-time content updates via Live Link technology
  • Dynamic data integration from external APIs and databases
  • Responsive design automatically sized for Apparatix screen configurations
  • Rich media support including images, videos, and interactive elements
  • Multi-screen management with location-specific content customization

Next Steps

  1. Optimize Campaign Performance: Monitor analytics and adjust refresh rates for optimal performance
  2. Scale Implementation: Apply Live Link integration to additional campaigns and screens
  3. Advanced Features: Explore location-based dynamic content and personalization options
  4. Support: Contact your Lucit Account Representative for advanced configuration assistance

For additional support with Apparatix integration, contact your Lucit Account Representative or submit a support ticket through the Lucit platform.