Easy to use Swift Package for recording pageviews and custom events for Plausible.
Plausible provides simple and meaningful insights into your website's traffic without invading the privacy of your visitors. However, integrating Plausible into a Swift application can be complex and time-consuming. AviaryInsights simplifies this process, allowing you to focus on building your application while still gaining the valuable insights that Plausible provides.
- Event tracking Define and track custom events in your application.
- Revenue tracking Track revenue data associated with events.
- Plausible API integration Send your events to the Plausible API for further analysis.
Apple Platforms
- Xcode 15 or later
- Swift 5.9 or later
- iOS 13 / watchOS 6 / tvOS 13 / visionOS 1 / macCatalyst 13 / macOS 10.15 or later deployment targets
Linux
- Ubuntu 20.04 or later
- Swift 5.9 or later
To add the AviaryInsights package to your Xcode project, select File > Swift Packages > Add Package Dependency and enter the repository URL.
Using Swift Package Manager add the repository url:
https://github.com/brightdigit/AviaryInsights.git
import AviaryInsights
// Initialize the client with your bundle identifier as the domain
let plausible = Plausible(domain: "com.example.yourApp")
// Define an event
let event = Event(url: "app://localhost/login")
// Send the event
plausible.send(event: event)Plausible is a client for interacting with the Plausible API. It is initialized with a domain, which is typically your app's bundle identifier. The Plausible client is used to send events to the Plausible API for tracking and analysis.
To construct a Plausible instance, you need to provide a domain. The domain is a string that identifies your application, typically the bundle identifier of your app.
let plausible = Plausible(domain: "com.example.yourApp")By default Plausible uses a URLSessionTransport, however you can use alternatives such as AsyncClient.
Event represents an event in your system. An event has a name, and optionally, a domain, URL, referrer, custom properties (props), and revenue information. You can create an Event instance and send it using the Plausible client.
To construct an Event, you need to provide at least a name. The name is a string that identifies the event you want to track. Optionally, you can also provide:
namestring that represents the name of the event. Default is pageview.urlstring that represents the URL where the event occurred. For an app you may wish to use a app url such asapp://localhost/login.domainoptional string that identifies the domain in which the event occurred. Overrides whatever was set in thePlausibleinstance.referreroptional string that represents the URL of the referrerpropsoptional dictionary of custom properties associated with the event.revenueoptionalRevenueinstance that represents the revenue data associated with the event
let event = Event
name: "eventName",
domain: "domain",
url: "url",
referrer: "referrer",
props: ["key": "value"],
revenue: Revenue(
currencyCode: "USD",
amount: 100
)
)AviaryInsights provides two ways to send events to the Plausible API:
This method sends an event to the Plausible API and throws an error if the operation fails. This is useful when you want to handle errors in your own way. Here's an example:
do {
try await plausible.postEvent(event)
} catch {
print("Failed to post event: \(error)")
}This method sends an event to the Plausible API in the background and ignores any errors that occur. This is useful when you don't need to handle errors and want to fire-and-forget the event. Here's an example:
plausible.postEvent(event)In both cases, event is an instance of Event that you want to send to the Plausible API.
AviaryInsights is available under the MIT license. See the LICENSE file for more info.