swaarm_sdk

Description:

swaarm sdk

Swaarm SDK #
Installation #
To install the Swaarm SDK, add it to your Flutter project by running:
flutter pub add swaarm_sdk
copied to clipboard
Configuration #
To configure the Swaarm SDK, initialize the client in your main.dart file using the
SwaarmClient.init(<domain>, <token>) method. This should be done after running your app:
import 'package:flutter/material.dart';
import 'package:swaarm_sdk/swaarm_sdk.dart';

void main() {
runApp(const MyApp());
SwaarmClient.init("example.swaarm.com", "<token>");
}
copied to clipboard
Replace "example.swaarm.com" with your Swaarm tracking domain and "<token>" with your specific
access token. During development, you can enable debugging with:
import 'package:flutter/material.dart';
import 'package:swaarm_sdk/swaarm_sdk.dart';

void main() {
runApp(const MyApp());
SwaarmClient.init("example.swaarm.com", "<token>", debug: true);
}
copied to clipboard
Usage #
Automatic Event Tracking #
The Swaarm SDK automatically tracks certain events:

App Open Event: Fires every time the app is opened.
Install Event: Fires the first time the app is opened after installation.

These events include enriched user data, such as the OS version, vendorId, and, if available, the
IDFA (Identifier for Advertisers).
Note: On devices running iOS 14 and later, user consent is required to access the IDFA. This
consent must be requested from a visible app interface. For more details,
refer to this StackOverflow answer.
Custom Events #
You can manually trigger custom events using the event and purchase methods.
Sending a Custom Event
The event method allows you to track specific user actions. It supports the following parameters:

typeId: The type of event you want to track (e.g., "registration").
aggregatedValue: A numerical value that Swaarm aggregates in reports (e.g., number of items purchased).
customValue: A free-form string value presented as-is in reports (e.g., specific details about the event).

SwaarmClient.event(
typeId: "registration",
aggregatedValue: 25.0,
customValue: "{\"email\": \"[email protected]\"}"
);
copied to clipboard
Tracking Purchases
The purchase method is used to track purchase-related events. It supports the following parameters:

typeId: The type of purchase event (e.g., "subscription").
revenue: The amount of revenue generated by the purchase.
currency: The currency in which the revenue is reported (e.g., "USD").
receiptOrToken: The receipt data, transaction ID, or token used to verify the purchase.
androidPurchaseId: The purchase or subscription ID for Android transactions.

SwaarmClient.purchase(
typeId: "subscription",
revenue: 11.0,
currency: "USD",
receiptOrToken: "base64ReceiptDataOrTransactionIdOrToken",
androidPurchaseId: "purchaseOrSubscriptionID",
);
copied to clipboard