SKAdNetwork Conversion

This guide provides instructions for implementing SKAdNetwork postback conversion with the Trackier Cordova 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 Cordova 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):

if (this.platform.is('ios')) {
  this.trackierCordovaPlugin.updatePostbackConversion(0);
}

Step 2: Integration with Trackier SDK

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

app.component.ts

import { Component } from '@angular/core';
import { Platform } from '@ionic/angular';
import { TrackierCordovaPlugin, TrackierConfig } from '@awesome-cordova-plugins/trackier/ngx';

@Component({
  selector: 'app-root',
  templateUrl: 'app.component.html',
  styleUrls: ['app.component.scss'],
})
export class AppComponent {
  constructor(
    private platform: Platform,
    private trackierCordovaPlugin: TrackierCordovaPlugin
  ) {
    this.initializeApp();
  }

  async initializeApp() {
    await this.platform.ready();

    // Initialize Trackier SDK
    await this.initializeTrackierSDK();
  }

  async initializeTrackierSDK() {
    try {
      const trackierConfig: TrackierConfig = {
        appToken: 'YOUR_SDK_KEY',
        environment: 'production'
      };

      await this.trackierCordovaPlugin.initializeSDK(trackierConfig);
      console.log('Trackier SDK initialized successfully');

      // Set initial conversion value (iOS only)
      if (this.platform.is('ios')) {
        this.trackierCordovaPlugin.updatePostbackConversion(0);
      }
    } catch (error) {
      console.error('Error initializing Trackier SDK:', error);
    }
  }
}

Step 3: Track Conversion Events

Track conversion events throughout your app:

Usage Examples

// Track app open
if (this.platform.is('ios')) {
  this.trackierCordovaPlugin.updatePostbackConversion(0);
}

// Track user registration
if (this.platform.is('ios')) {
  this.trackierCordovaPlugin.updatePostbackConversion(10);
}

// Track first purchase
if (this.platform.is('ios')) {
  this.trackierCordovaPlugin.updatePostbackConversion(20);
}

// Track subscription
if (this.platform.is('ios')) {
  this.trackierCordovaPlugin.updatePostbackConversion(30);
}

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: 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: Implement proper error handling for postback failures
• 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

Debug Tips

// Check if platform is iOS
if (this.platform.is('ios')) {
  console.log('iOS detected, SKAdNetwork available');
} else {
  console.log('Not iOS, SKAdNetwork not available');
}

// Test conversion value
if (this.platform.is('ios')) {
  this.trackierCordovaPlugin.updatePostbackConversion(10);
}

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 Cordova SDK, ensuring proper attribution tracking while respecting user privacy on iOS 14.5+.