Skip to main content

SKAdNetwork Conversion

SKAdNetwork is Apple's privacy-focused attribution framework that allows advertisers to measure campaign effectiveness while maintaining user privacy. This guide shows you how to implement SKAdNetwork postback conversion tracking in your React Native app.

Overview​

SKAdNetwork provides privacy-compliant attribution for iOS 14.5+ apps without requiring user-level tracking. You can track conversion events (0-63) to measure user engagement while respecting Apple's privacy requirements.

Prerequisites​

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

Implementation​

Step 1: Configure Info.plist​

Add the SKAdNetwork endpoint to your Info.plist file:

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

Step 2: Initialize SDK and Set Initial Conversion Value​

App.js
import React, { useEffect } from 'react';
import { Platform } from 'react-native';
import TrackierSDK, { TrackierConfig } from 'react-native-trackier-sdk';

const App = () => {
  useEffect(() => {
    initializeTrackierSDK();
  }, []);

  const initializeTrackierSDK = () => {
    const sdkConfig = new TrackierConfig('YOUR_SDK_KEY', 'production');
    TrackierSDK.initialize(sdkConfig);
    console.log('Trackier SDK initialized successfully');

    // Set initial conversion value (iOS only)
    if (Platform.OS === 'ios') {
      TrackierSDK.updatePostbackConversion(0);
    }
  };

  return (
    // Your app components
  );
};

export default App;

Step 3: Track Conversion Events​

Track conversion events throughout your app when specific user actions occur:

// Track app open
if (Platform.OS === 'ios') {
  TrackierSDK.updatePostbackConversion(0);
}

// Track user registration
if (Platform.OS === 'ios') {
  TrackierSDK.updatePostbackConversion(10);
}

// Track first purchase
if (Platform.OS === 'ios') {
  TrackierSDK.updatePostbackConversion(20);
}

// Track subscription
if (Platform.OS === 'ios') {
  TrackierSDK.updatePostbackConversion(30);
}

Conversion Value Guidelines​

Conversion ValueRecommended Action
0App install/first open
1-10Registration, tutorial completion
11-20First purchase, add to cart
21-30Subscription, high-value purchase
31-63Custom high-value events
note

Best Practice: Reserve higher conversion values (40-63) for your most valuable user actions to maximize attribution data value.

Troubleshooting​

Common Issues​

Conversion Value Not Updating

  • Verify NSAdvertisingAttributionReportEndpoint is correctly added to Info.plist
  • Ensure you're testing on iOS 14.5+ device or simulator
  • Check that Platform.OS === 'ios' condition is working correctly

Info.plist Configuration Issues

  • Confirm the endpoint URL is exactly: https://apptrovesn.com/.well-known/skadnetwork/report-attribution
  • Ensure the Info.plist file is in the correct location (e.g., ios/YourApp/Info.plist)

Debug Tips​

// Test conversion value updates
if (Platform.OS === 'ios') {
  console.log('Updating SKAdNetwork conversion value to 10');
  TrackierSDK.updatePostbackConversion(10);
}

Support​

For technical support and questions:

This implementation enables privacy-compliant attribution tracking for your React Native iOS app using Apple's SKAdNetwork framework.