Clicky Integrations

Integration Overview

Clicky integrates with various platforms and tools to extend its analytics capabilities. From CMS platforms to notification services, these integrations help you embed analytics into your existing workflows.

CMS Integrations

WordPress

Clicky offers an official WordPress plugin that simplifies installation and configuration:

1. Install the "Clicky Analytics" plugin from the WordPress plugin repository
2. Activate the plugin and navigate to Settings → Clicky
3. Enter your Clicky Site ID and Site Key
4. Configure tracking options:
   • Track logged-in users (admins, editors, subscribers)
   • Enable outbound link tracking
   • Track search queries
5. Save settings

The plugin automatically adds the tracking code to all pages and supports additional features like goal tracking and admin dashboard widgets.

Drupal

For Drupal sites, use the Clicky module:

1. Download and install the Clicky module from Drupal.org
2. Navigate to Configuration → System → Clicky
3. Enter your Clicky credentials
4. Configure visibility settings to control which pages are tracked
5. Set user role exclusions as needed

Joomla

Clicky integration for Joomla:

1. Install a Clicky extension from the Joomla Extensions Directory
2. Access the extension configuration in Joomla admin
3. Add your Clicky Site ID
4. Configure tracking preferences
5. Position the module appropriately (typically in a hidden position)

Static Site Generators

For Jekyll, Hugo, Gatsby, and other static site generators, add the tracking code directly to your template:

<!-- Add to your base template, before </body> -->
<script>
  var clicky_site_ids = clicky_site_ids || [];
  clicky_site_ids.push(YOUR_SITE_ID);
</script>
<script async src="//static.getclicky.com/js"></script>

E-commerce Integrations

Shopify

Add Clicky tracking to your Shopify store:

1. Go to Online Store → Themes → Actions → Edit code
2. Open theme.liquid
3. Add the Clicky tracking code before the closing </body> tag
4. For conversion tracking, edit checkout.liquid (Shopify Plus) or use Additional Scripts

// In Additional Scripts (Settings → Checkout)
<script>
  var clicky_site_ids = clicky_site_ids || [];
  clicky_site_ids.push(YOUR_SITE_ID);
</script>
<script async src="//static.getclicky.com/js"></script>
<script>
  clicky.goal('purchase', {{ total_price | money_without_currency }}, 'Order {{ order_number }}');
</script>

WooCommerce

Combine the WordPress plugin with WooCommerce event tracking:

// Add to functions.php or custom plugin
add_action('woocommerce_thankyou', 'clicky_track_purchase');
function clicky_track_purchase($order_id) {
    $order = wc_get_order($order_id);
    $total = $order->get_total();
    ?>
    <script>
        clicky.goal('purchase', <?php echo $total; ?>, 'Order #<?php echo $order_id; ?>');
    </script>
    <?php
}

Magento

For Magento stores, add tracking via layout XML or directly in templates:

<!-- Add to default.xml layout -->
<referenceContainer name="before.body.end">
    <block class="Magento\Framework\View\Element\Template"
           name="clicky.tracking"
           template="Vendor_Module::clicky.phtml"/>
</referenceContainer>

Notification Integrations

Slack

Receive real-time alerts in Slack when specific events occur:

1. Create a Slack Incoming Webhook in your Slack workspace
2. In Clicky, go to Preferences → Alerts
3. Add a new alert with the Slack webhook URL
4. Configure alert triggers:
   • Traffic spikes
   • Goal completions
   • Uptime issues
5. Customize the message format

Email Alerts

Configure email notifications for key events:

1. Navigate to Preferences → Alerts
2. Set up alert conditions:
   • Daily/weekly traffic summaries
   • Real-time goal notifications
   • Uptime monitoring alerts
3. Specify recipient email addresses
4. Choose alert frequency

Webhooks

Send data to custom endpoints for advanced integrations:

1. Set up a webhook URL on your server
2. Configure Clicky alerts to POST to your endpoint
3. Process incoming webhook data:

// Example webhook handler (Node.js)
app.post('/clicky-webhook', (req, res) => {
  const alertData = req.body;

  // Process the alert
  console.log('Clicky alert received:', alertData);

  // Trigger your custom logic
  handleClickyAlert(alertData);

  res.status(200).send('OK');
});

Tag Manager Integration

Google Tag Manager

Deploy Clicky through GTM for centralized tag management:

1. Create a new Custom HTML tag in GTM
2. Add the Clicky tracking code:

<script>
  var clicky_site_ids = clicky_site_ids || [];
  clicky_site_ids.push({{Clicky Site ID}});
</script>
<script async src="//static.getclicky.com/js"></script>

3. Create a GTM variable for your Clicky Site ID
4. Set the trigger to "All Pages"
5. Publish the container

For event tracking through GTM:

<script>
  clicky.goal('{{Event Name}}', {{Event Value}}, '{{Event Title}}');
</script>

Other Tag Managers

Clicky works with any tag management solution that supports custom JavaScript:

• Tealium: Add as a Custom Container tag
• Segment: Use a custom destination function
• Ensighten: Deploy as a custom tag

API Integration

REST API

Clicky's API provides programmatic access to your analytics data:

# Get visitor data
curl "https://api.clicky.com/api/stats/4?site_id=YOUR_SITE_ID&sitekey=YOUR_SITE_KEY&type=visitors&output=json"

# Get goal data
curl "https://api.clicky.com/api/stats/4?site_id=YOUR_SITE_ID&sitekey=YOUR_SITE_KEY&type=goals&output=json"

API Parameters

Common API parameters:

Building Custom Dashboards

Use the API to create custom reporting:

// Example: Fetch and display visitor data
async function getClickyData() {
  const response = await fetch(
    `https://api.clicky.com/api/stats/4?site_id=${SITE_ID}&sitekey=${API_KEY}&type=visitors&date=last-7-days&output=json`
  );
  const data = await response.json();
  return data;
}

// Process and display
getClickyData().then(data => {
  console.log('Weekly visitors:', data);
  updateDashboard(data);
});

Twitter/X Analytics

Connecting Twitter Analytics

Clicky can track engagement from Twitter/X:

1. Go to Preferences → Twitter
2. Authorize Clicky to access your Twitter account
3. Configure tracking options:
   • Track mentions of your domain
   • Monitor branded hashtags
   • Track link clicks from Twitter

Viewing Twitter Data

Once connected, Twitter data appears in:

• Traffic Sources: See Twitter as a referral source with engagement metrics
• Twitter Reports: Dedicated reports showing tweets that drive traffic
• Real-time Feed: Watch Twitter visitors arrive in real-time

Analytics Platform Integrations

Data Warehouse Export

Export Clicky data to your data warehouse:

1. Use the API to pull historical data
2. Set up scheduled exports with a cron job or serverless function
3. Transform data as needed for your warehouse schema

# Example: Python script for data export
import requests
import json

def export_clicky_data(date_range):
    api_url = f"https://api.clicky.com/api/stats/4"
    params = {
        'site_id': SITE_ID,
        'sitekey': API_KEY,
        'type': 'pages',
        'date': date_range,
        'output': 'json',
        'limit': 1000
    }

    response = requests.get(api_url, params=params)
    return response.json()

# Export and save
data = export_clicky_data('last-30-days')
with open('clicky_export.json', 'w') as f:
    json.dump(data, f)

BI Tool Connections

Connect Clicky data to business intelligence platforms:

• Tableau: Use web data connector or API-based data source
• Power BI: Create a custom connector or use API calls
• Looker: Build a custom LookML model around API exports
• Google Data Studio: Use a community connector or API

White-Label Integration

Agency Setup

For agencies managing multiple client sites:

1. Create a parent account with white-label access
2. Add client sites under your account
3. Configure custom branding:
   • Custom domain for dashboards
   • Logo replacement
   • Color scheme customization
4. Set up client access with appropriate permissions

Embedded Analytics

Embed Clicky dashboards in your own applications:

<!-- Embed a Clicky widget -->
<iframe
  src="https://clicky.com/stats/widget?site_id=YOUR_SITE_ID&type=visitors"
  width="400"
  height="300"
  frameborder="0">
</iframe>

Troubleshooting Integrations

Common Issues

Plugin not tracking:

• Verify Site ID is entered correctly
• Check for JavaScript conflicts with other plugins
• Ensure tracking code appears in page source

API returning errors:

• Confirm API key permissions
• Check rate limit status
• Validate date format in requests

Slack notifications not arriving:

• Test webhook URL independently
• Verify alert configuration in Clicky
• Check Slack channel permissions

Testing Integrations

1. Install integration on a test environment first
2. Use Clicky's real-time dashboard to verify data flow
3. Test all configured events and alerts
4. Document any customizations for future reference