Managing Campaigns

Campaigns are the core of TipPanel. Each campaign represents a widget that you can embed on your website to collect tips and messages from your visitors.

Campaign Overview

In TipPanel, a campaign represents a widget configuration that you can embed on your website. Each campaign has its own:

  • Name: A descriptive name to help you identify the campaign
  • Domain: The website domain where the widget will be embedded
  • Widget Type: Floating or Inline (depending on your subscription plan)
  • Appearance Settings: Colors, fonts, position, and other visual settings
  • Custom Text: Customizable text for all widget elements
  • Status: Active or Inactive

The Campaigns page in your dashboard shows a list of all your campaigns with key information and action buttons for each one.

Note: The number of campaigns you can create depends on your subscription plan. See the Campaign Limits section for details.

Creating a Campaign

To create a new campaign:

  1. Navigate to the Campaigns page in your dashboard
  2. Click the Create Campaign button in the top-right corner
  3. Fill in the campaign details:
    • Campaign Name: Enter a descriptive name (e.g., "Blog Tips", "Support Donations")
    • Domain: Enter the domain where you'll embed the widget (e.g., "myblog.com")
    • Widget Type: Select Floating or Inline (Inline is only available on Pro plan and above)
  4. Click Create to save your new campaign
Widget Types
Floating Widget
  • Appears as a floating button in the corner of your website
  • Expands to a full widget when clicked
  • Can be positioned in any corner of the screen
  • Available on all subscription plans
Inline Widget
  • Embedded directly within your website content
  • Always visible (no need to click to expand)
  • Can be placed anywhere in your page layout
  • Only available on Pro plan and above

After creating a campaign, you'll be redirected to the Campaigns page where your new campaign will appear in the list. From there, you can customize its appearance, get the embed code, or perform other actions.

Editing a Campaign

To edit an existing campaign:

  1. Navigate to the Campaigns page in your dashboard
  2. Find the campaign you want to edit in the list
  3. Click the Edit button (pencil icon) for that campaign
  4. Update the campaign details:
    • Campaign Name: Change the descriptive name
    • Domain: Update the domain if needed
    • Widget Type: Change between Floating and Inline (if available on your plan)
    • Status: Set to Active or Inactive
  5. Click Save to update the campaign
Important: Changing a campaign's widget type may reset some appearance settings, as different widget types have different configuration options.

Customizing Widget Appearance

To customize the appearance of your widget:

  1. Navigate to the Campaigns page in your dashboard
  2. Find the campaign you want to customize
  3. Click the Appearance button for that campaign
  4. Use the appearance editor to customize:
    • Theme: Colors, fonts, and overall look
    • Layout: Position, size, and behavior
    • Custom Text: All text elements in the widget
  5. Use the preview panel to see how your changes look in real-time
  6. Click Save to apply your changes

For more detailed information on customizing your widget's appearance, see the Widget Appearance documentation.

Cloning a Campaign

Cloning a campaign creates a duplicate with all the same settings, which you can then modify. This is useful when you want to create similar widgets for different websites or sections of your site.

To clone a campaign:

  1. Navigate to the Campaigns page in your dashboard
  2. Find the campaign you want to clone
  3. Click the Clone button (copy icon) for that campaign
  4. A new campaign will be created with the name "Copy of [Original Campaign Name]"
  5. You can then edit the cloned campaign as needed
Note: Cloning a campaign counts toward your campaign limit. Make sure you have available slots in your subscription plan before cloning.

Deleting a Campaign

To delete a campaign:

  1. Navigate to the Campaigns page in your dashboard
  2. Find the campaign you want to delete
  3. Click the Delete button (trash icon) for that campaign
  4. Confirm the deletion in the confirmation dialog
Warning: Deleting a campaign is permanent and cannot be undone. All associated data, including messages and analytics, will be deleted.

If you want to temporarily disable a campaign instead of deleting it, you can set its status to "Inactive" in the campaign settings.

Getting the Embed Code

To get the embed code for your campaign:

  1. Navigate to the Campaigns page in your dashboard
  2. Find the campaign you want to embed
  3. Click the Embed Code button (code icon) for that campaign
  4. Copy the generated code snippet
  5. Paste the code into your website's HTML, just before the closing </body> tag
Example Embed Code
<script src="https://tippanel.com/widget/widget.js" 
        id="tippanel-widget" 
        data-website-id="your-website-id" 
        data-campaign-id="your-campaign-id" 
        async></script>

Embedding in Different Platforms

If you're using a content management system (CMS), here's how to add the embed code:

  1. Install a plugin like "Header and Footer Scripts" or "Insert Headers and Footers"
  2. Go to the plugin settings
  3. Paste the embed code in the "Footer" section
  4. Save your changes

  1. Go to your Shopify admin panel
  2. Navigate to "Online Store" > "Themes"
  3. Click "Actions" > "Edit code" for your current theme
  4. Find the theme.liquid file
  5. Paste the embed code just before the closing </body> tag
  6. Save your changes

  1. Go to your Wix dashboard
  2. Click on "Settings" > "Custom Code"
  3. Click "Add Custom Code"
  4. Give your code a name (e.g., "TipPanel Widget")
  5. Paste the embed code
  6. Set "Place Code in" to "Body - end"
  7. Select "Load code on all pages" or choose specific pages
  8. Click "Apply"

  1. Go to your Squarespace dashboard
  2. Navigate to "Settings" > "Advanced" > "Code Injection"
  3. Paste the embed code in the "Footer" section
  4. Click "Save"
Important: Make sure to add the code to all pages where you want the widget to appear. If you're using the Floating widget type, it's recommended to add it to all pages of your website for a consistent user experience.

Campaign Limits by Plan

The number of campaigns you can create depends on your subscription plan:

Plan Campaign Limit Widget Types
Free 1 campaign Floating only
Pro 3 campaigns Floating and Inline
Premium 10 campaigns Floating and Inline
Lifetime Unlimited campaigns Floating and Inline

If you need more campaigns than your current plan allows, you can upgrade your subscription to a higher plan.