SKAdNetwork Conversion

This guide provides instructions for implementing SKAdNetwork postback conversion with the Trackier Flutter SDK. SKAdNetwork postback conversion allows you to track user engagement and conversion events for iOS 14.5+ apps.

Overview

SKAdNetwork postback conversion is Apple's privacy-focused attribution system that allows you to track conversion events without compromising user privacy. This is essential for iOS 14.5+ apps that want to measure campaign effectiveness while respecting user privacy.

note

Important: SKAdNetwork postback conversion can be called from any part of your app to track user engagement and conversion events.

Prerequisites

• iOS 14.5 or later
• Trackier Flutter SDK installed
• Access to your app's Info.plist file

Implementation

Step 1: Configure Info.plist

Add the SKAdNetwork configuration to your Info.plist file:

<key>NSAdvertisingAttributionReportEndpoint</key>
<string>https://apptrovesn.com/.well-known/skadnetwork/report-attribution</string>

note

After configuring Info.plist, call the initial conversion value (iOS only):

import 'dart:io' show Platform;

if (Platform.isIOS) {
  Trackierfluttersdk.updatePostbackConversion(0);
}

Step 2: Integration with Trackier SDK

Initialize the Trackier SDK and then call postback conversion from any part of your app:

main.dart

import 'package:flutter/material.dart';
import 'package:trackier_sdk_flutter/trackier_sdk_flutter.dart';
import 'dart:io' show Platform;

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  
  // Initialize Trackier SDK
  await initializeTrackierSDK();
  
  runApp(MyApp());
}

Future<void> initializeTrackierSDK() async {
  // 1. Initialize the SDK
  final config = TrackierSDKConfig(
    appToken: "YOUR_SDK_TOKEN_HERE", // Replace with your actual SDK token
    env: TrackierSDKConfig.ENV_DEVELOPMENT
  );
  
  Trackierfluttersdk.initializeSDK(config);
  
  // 2. Set initial conversion value (iOS only)
  if (Platform.isIOS) {
    Trackierfluttersdk.updatePostbackConversion(0);
  }
}

Step 4: Track Conversion Events

Track conversion events throughout your app:

Usage Examples

import 'dart:io' show Platform;

// Track app open (iOS only)
if (Platform.isIOS) {
  Trackierfluttersdk.updatePostbackConversion(0);
}

// Track user registration (iOS only)
if (Platform.isIOS) {
  Trackierfluttersdk.updatePostbackConversion(10);
}

// Track first purchase (iOS only)
if (Platform.isIOS) {
  Trackierfluttersdk.updatePostbackConversion(20);
}

// Track subscription (iOS only)
if (Platform.isIOS) {
  Trackierfluttersdk.updatePostbackConversion(30);
}

// Track high-value purchase (iOS only)
if (Platform.isIOS) {
  Trackierfluttersdk.updatePostbackConversion(40);
}

// Track premium upgrade (iOS only)
if (Platform.isIOS) {
  Trackierfluttersdk.updatePostbackConversion(50);
}

note

Best Practice: Call updatePostbackConversion immediately after the user action occurs to ensure accurate attribution tracking.

Conversion Value Guidelines

Value Range	Description	Use Case
0-9	App Engagement	App opens, session starts
10-19	User Onboarding	Registration, profile setup
20-29	First Actions	First purchase, first subscription
30-39	Regular Usage	Repeat purchases, engagement
40-49	High Value	Premium purchases, upgrades
50-63	Premium/Loyalty	VIP status, loyalty program

Best Practices

• Flexible Usage: Trackierfluttersdk.updatePostbackConversion can be called from any part of your app
• Meaningful Values: Use conversion values that represent user value (0-63)
• Timing: Send conversion values immediately after the event occurs
• Validation: Always validate conversion values before sending
• Error Handling: The SDK handles errors internally
• iOS Only: SKAdNetwork is only available on iOS devices
• Platform Check: Consider checking platform before calling on cross-platform apps

Troubleshooting

Postback Not Sent

• Check if SKAdNetwork is available on the device (iOS 14.5+)
• Verify the conversion value is within 0-63 range
• Check console logs for error messages

Integration Issues

• Verify the app token is correct
• Ensure SDK is properly initialized
• Check Info.plist configuration for postback endpoint

Support

For technical support and questions:

• Support Email: support@trackier.com
• Documentation: Trackier Documentation Portal

---

This guide provides implementation of SKAdNetwork postback conversion with the Trackier Flutter SDK, ensuring proper attribution tracking while respecting user privacy on iOS 14.5+.