Articles on: API Documentation

Event Tracking via the Super Send API

Event Tracking via the Super Send API

Super Send’s Event Tracking API allows you to monitor key metrics such as opens, clicks, replies, and bounces. This functionality provides critical insights into your campaign’s performance, helping you optimize and refine your outreach efforts.



1. Retrieving Events



Use the GET method to retrieve a list of events associated with your campaigns.

Example Request:



curl -X GET https://api.supersend.io/v1/events \
-H "Authorization: Bearer <YOUR_API_KEY>"


Query Parameters:



CampaignId: Filter events by a specific campaign.
ContactId: Retrieve events for a particular contact.
Type: Filter events by type (e.g., open, click, reply, bounce).

Example with Filters:



curl -X GET "https://api.supersend.io/v1/events?CampaignId=<CAMPAIGN_ID>&Type=open" \
-H "Authorization: Bearer <YOUR_API_KEY>"




2. Types of Events



Here are the event types you can track:

Opens:
Triggered when a contact opens an email.

Clicks:
Logged when a contact clicks a link in your email.

Replies:
Captured when a contact replies to your email.

Bounces:
Recorded when an email cannot be delivered.



3. Event Data Structure



Each event includes the following fields:

{
  "id": "event-id",
  "CampaignId": "campaign-id",
  "ContactId": "contact-id",
  "type": "event-type",
  "timestamp": "event-timestamp"
}


Field Descriptions:



id: Unique identifier for the event.
CampaignId: The campaign associated with the event.
ContactId: The contact associated with the event.
type: The type of event (e.g., open, click, reply, bounce).
timestamp: The date and time the event occurred.


4. Best Practices for Event Tracking



Monitor Frequently:
Regularly check event data to assess campaign performance.

Filter Data:
Use query parameters to narrow down events for specific campaigns or contacts.

Automate Reporting:
Integrate the Event Tracking API with reporting tools for automated performance analysis.

Act on Insights:
Use event data to optimize future campaigns, such as improving subject lines for higher open rates or refining call-to-action links.



By leveraging the Event Tracking API, you can gain valuable insights into your outreach campaigns, ensuring continuous improvement and success.

Updated on: 22/01/2025

Was this article helpful?

Share your feedback

Cancel

Thank you!