com_tapp_so 1.0.0

Flutter plugin for Tapp.so affiliate marketing SDK. Track attributions, handle deferred deep links, and fire conversion events on iOS and Android.

Tapp Flutter SDK

Flutter plugin for Tapp.so affiliate marketing SDK. Track attributions, handle deferred deep links, and fire conversion events on iOS and Android.

Features

• 🔗 Deferred Deep Links - Attribute installs to influencers even after app store redirect
• 📊 Event Tracking - Track purchases, registrations, and custom conversion events
• 🎯 Attribution - Know which influencer drove each install
• 📱 Cross-Platform - Full support for iOS and Android

Installation

Add this to your pubspec.yaml:

dependencies:
  com_tapp_so: ^1.0.0

Then run:

flutter pub get

iOS Setup

Run pod install from your Flutter project's iOS directory:

cd ios && pod install

The SDK handles the rest automatically.

Android Setup

Add JitPack to your project's android/build.gradle:

allprojects {
    repositories {
        google()
        mavenCentral()
        maven { url 'https://jitpack.io' }
    }
}

Quick Start

import 'package:com_tapp_so/com_tapp_so.dart';

final sdk = ComTappSo();

// Initialize the SDK
await sdk.start(
  authToken: 'YOUR_AUTH_TOKEN',
  env: EnvironmentType.PRODUCTION,
  tappToken: 'YOUR_TAPP_TOKEN',
  onDeferredDeepLink: (data) {
    print('Attribution: ${data.influencer}');
  },
);

API Reference

Initialize

await sdk.start(
  authToken: 'YOUR_AUTH_TOKEN',
  env: EnvironmentType.PRODUCTION, // or EnvironmentType.SANDBOX
  tappToken: 'YOUR_TAPP_TOKEN',
  onDeferredDeepLink: (data) { /* handle attribution */ },
  onFailResolvingUrl: (error) { /* handle errors */ },
);

Check Deep Link

bool shouldHandle = await sdk.shouldProcess('https://your-app.tapp.so/...');

Generate Affiliate URL

String? url = await sdk.generateUrl(
  influencer: 'influencer_id',
  adGroup: 'campaign_name',
  creative: 'creative_id',
  data: {'custom': 'data'},
);

Track Events

await sdk.handleTappEvent(
  eventAction: EventAction.tapp_purchase,
  metadata: {
    'orderId': '12345',
    'value': 99.99,
    'currency': 'USD',
  },
);

Fetch Link Data

LinkData? data = await sdk.fetchLinkData('https://your-app.tapp.so/...');
LinkData? originData = await sdk.fetchOriginLinkData();

Event Types

The SDK supports these built-in event types:

Event	Description
tapp_purchase	Completed purchase
tapp_complete_registration	User registration
tapp_add_to_cart	Added item to cart
tapp_initiate_checkout	Started checkout
tapp_subscribe	Subscription started
tapp_start_trial	Trial started
custom	Custom event with customValue

See the full list in EventAction enum.

License

This SDK is proprietary software. You must have a Tapp.so account to use it. See LICENSE for details.