import { init, getAttributionStatus, onMetrixUserIdReceived } from '@metrixorg/websdk';
 
// Initialize with session tracking
init('APP_ID', 'API_KEY', {
  sessionTracking: {
    enabled: true,
    packageName: 'my-web-app',
  },
});
 
// Get Metrix user ID
const metrixUserId = await onMetrixUserIdReceived();
console.log('Metrix User ID:', metrixUserId);
 
// Check attribution status
const attribution = await getAttributionStatus();
console.log('Attribution:', attribution);

import { getAttributionStatus, onMetrixUserIdReceived } from '@metrixorg/websdk';
 
// Wait for Metrix user ID to be available
await onMetrixUserIdReceived();
 
// Get attribution information
const attribution = await getAttributionStatus();
 
if (attribution) {
  console.log('Attribution Status:', attribution.attributionStatus);
  console.log('Source:', attribution.acquisitionSource);
  console.log('Campaign:', attribution.acquisitionCampaign);
}

getAttributionStatus(): Promise<AttributionStatus | null>

interface AttributionStatus {
  acquisitionAd: string; // Ad identifier
  acquisitionAdSet: string; // Ad set identifier
  acquisitionCampaign: string; // Campaign name
  acquisitionSource: string; // Source (e.g., 'Google', 'Facebook')
  acquisitionSubId: string; // Additional tracking sub ID
  acquisitionAdNetwork: string; // Ad network (e.g., 'Google Ads')
  attributionStatus: string; // Current status (see below)
  trackerToken: string; // Metrix tracker token
  installTime: number; // Installation timestamp (ms)
  reinstalled: boolean; // Whether user reinstalled
  installedByImpression: boolean; // Whether attributed to impression
}

import { init, getAttributionStatus, onMetrixUserIdReceived } from '@metrixorg/websdk';
 
// Initialize SDK
init('APP_ID', 'API_KEY', {
  sessionTracking: { enabled: true },
});
 
// Wait for Metrix ID
const metrixUserId = await onMetrixUserIdReceived();
console.log('Device ID:', metrixUserId);
 
// Get attribution with complete handling
try {
  const attribution = await getAttributionStatus();
 
  if (!attribution) {
    console.log('Attribution not available yet');
    return;
  }
 
  switch (attribution.attributionStatus) {
    case 'ATTRIBUTED':
      console.log('✓ Attributed user');
      console.log('  Campaign:', attribution.acquisitionCampaign);
      console.log('  Source:', attribution.acquisitionSource);
      console.log('  Network:', attribution.acquisitionAdNetwork);
      console.log('  Install Time:', new Date(attribution.installTime));
      break;
 
    case 'NOT_ATTRIBUTED_YET':
      console.log('○ Attribution still processing...');
      // SDK will retry automatically
      break;
 
    case 'ATTRIBUTION_NOT_NEEDED':
      console.log('Organic user - no campaign attribution');
      break;
 
    case 'UNKNOWN':
      console.log('? Attribution status unknown');
      break;
  }
 
  // Log for analytics
  analytics.logAttribution({
    status: attribution.attributionStatus,
    source: attribution.acquisitionSource,
    campaign: attribution.acquisitionCampaign,
  });
} catch (error) {
  console.error('Failed to get attribution:', error);
}

const attribution = await getAttributionStatus();
 
if (attribution?.attributionStatus === 'ATTRIBUTED') {
  // Show campaign-specific welcome message
  showWelcomeMessage(attribution.acquisitionCampaign);
} else {
  // Show generic welcome
  showGenericWelcome();
}

function trackPurchase(amount) {
  getAttributionStatus().then(attribution => {
    analytics.trackPurchase({
      amount,
      campaign: attribution?.acquisitionCampaign,
      source: attribution?.acquisitionSource,
    });
  });
}

async function calculateROI() {
  const attribution = await getAttributionStatus();
 
  if (attribution?.attributionStatus === 'ATTRIBUTED') {
    const roi = calculateReturn(attribution.acquisitionCampaign);
    updateDashboard(attribution.acquisitionCampaign, roi);
  }
}

const attribution = await getAttributionStatus();
 
if (attribution?.reinstalled) {
  console.log('Warning: User reinstalled app');
  // Apply additional fraud checks
}

import { init } from '@metrixorg/websdk';
 
init('APP_ID', 'API_KEY', {
  sessionTracking: {
    enabled: true, // Required
    packageName: 'my-app', // Optional: identify your app
  },
});

interface SessionTrackingConfig {
  enabled: boolean; // Enable/disable session tracking (required)
  packageName?: string; // App identifier for tracking (optional)
}

┌─────────────────────────────────────────────────────────┐
│ 1. کاربر از صفحه بازدید می‌کند / اپلیکیشن اجرا می‌شود  │
│    ← صفحه فعال می‌شود                                   │
│    ← اگر اولین جلسه است: به عنوان نصب شمارش شود      │
└─────────────────────────────────────────────────────────┘
                        ↓
┌───────────────────────────────────────────────────────┐
│ 2. جلسه فعال است                                     │
│    ← URL صفحه پیگیری شود                             │
│    ← مدت زمان جلسه اندازه‌گیری شود                   │
│    ← میزان تعامل پیگیری شود                         │
│    ← رویدادها و درآمد ارسال شود                     │
└───────────────────────────────────────────────────────┘
                        ↓
        ┌─────────────────────────────────┐
        │ کاربر به صفحه دیگری می‌رود یا  │
        │ صفحه پنهان می‌شود؟              │
        └─────────────────────────────────┘
                ↓                    ↓
               بله                     خیر
                │                       │
                ↓                       ↓
        ┌─────────────────────┐    ┌─────────────────────────┐
        │ جلسه پایان می‌یابد │    │    همچنان فعال است      │
        │ اطلاعات جلسه ارسال شود  │    │  پیگیری ادامه یابد│
        │ پایان ردیابی       │    └─────────────────────────┘
        └─────────────────────┘
                 ↓
        ┌───────────────────────────────────┐
        │ بیش از ۳۰ دقیقه عدم فعالیت؟     │
        │ بله ← جلسه جدید آغاز می‌شود      │
        │ خیر ← جلسه از سر گرفته می‌شود    │
        └───────────────────────────────────┘

init('APP_ID', 'API_KEY', {
  sessionTracking: {
    enabled: true,
  },
});
 
// اولین بازدید کاربر → نصب ثبت می‌شود
// بازدیدهای بعدی → نشست‌ها ردیابی می‌شوند

init('APP_ID', 'API_KEY', {
  sessionTracking: {
    enabled: true,
    packageName: 'my-pwa', // Optional identifier
  },
});

dependencies {
  implementation("com.google.android.gms:play-services-ads-identifier:18.0.1")
}

import com.google.android.gms.ads.identifier.AdvertisingIdClient;
import com.google.android.gms.common.GooglePlayServicesNotAvailableException;
import com.google.android.gms.common.GooglePlayServicesRepeatedException;
 
public class LaunchActivity extends AppCompatActivity {
  @Override
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
 
    new Thread(() -> {
      try {
        AdvertisingIdClient.Info adInfo = AdvertisingIdClient.getAdvertisingIdInfo(this);
        String advertisingId = adInfo.getId();
        
        // Launch TWA with advertising ID
        Intent launchIntent = new Intent(Intent.ACTION_VIEW);
        Uri uri = Uri.parse("https://yourapp.com/app?gps_adid=" + advertisingId);
        launchIntent.setData(uri);
        startActivity(launchIntent);
      } catch (GooglePlayServicesNotAvailableException e) {
        // Handle error
      } catch (GooglePlayServicesRepeatedException e) {
        // Handle error
      }
    }).start();
  }
}

import com.google.android.gms.ads.identifier.AdvertisingIdClient
import com.google.android.gms.common.GooglePlayServicesNotAvailableException
import com.google.android.gms.common.GooglePlayServicesRepeatedException
 
class LaunchActivity : AppCompatActivity() {
  override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    
    Thread {
      try {
        val adInfo = AdvertisingIdClient.getAdvertisingIdInfo(this)
        val advertisingId = adInfo.id
        
        // Launch TWA with advertising ID
        val uri = Uri.parse("https://yourapp.com/app?gps_adid=$advertisingId")
        val launchIntent = Intent(Intent.ACTION_VIEW, uri)
        startActivity(launchIntent)
      } catch (e: GooglePlayServicesNotAvailableException) {
        // Handle error
      } catch (e: GooglePlayServicesRepeatedException) {
        // Handle error
      }
    }.start()
  }
}

init('APP_ID', 'API_KEY', {
  sessionTracking: {
    enabled: true,  // SDK automatically reads gps_adid
  },
});

https://yourapp.com/app?gps_adid=DEVICE_ADVERTISING_ID

https://yourapp.com/app?gps_adid=5e6afe60-2b3f-4b4f-8f8f-8f8f8f8f8f8f

import { onMetrixUserIdReceived } from '@metrixorg/websdk';
 
const metrixUserId = await onMetrixUserIdReceived();
console.log('Metrix User ID:', metrixUserId);

onMetrixUserIdReceived(): Promise<string>

import { init, onMetrixUserIdReceived } from '@metrixorg/websdk';
 
// Initialize SDK
init('APP_ID', 'API_KEY', {
  sessionTracking: { enabled: true },
});
 
// Wait for ID (typically ready within 1-2 seconds)
try {
  const metrixUserId = await onMetrixUserIdReceived();
  console.log('Ready to use:', metrixUserId);
} catch (error) {
  console.error('Failed to get Metrix user ID:', error);
}

// Frontend: Get the ID
const metrixUserId = await onMetrixUserIdReceived();
 
// Send to backend
fetch('/api/user/setup', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ metrixUserId }),
});

# Backend: Use for server-to-server API calls
import requests
 
def send_event_to_metrix(metrix_user_id, event_name):
  response = requests.post(
    'https://api.metrix.ir/v1/events',
    headers={'Authorization': 'Bearer YOUR_API_KEY'},
    json={
      'userId': metrix_user_id,
      'eventName': event_name,
      'timestamp': datetime.utcnow().isoformat(),
    }
  )
  return response.json()

const metrixUserId = await onMetrixUserIdReceived();
 
// Store in database if needed
localStorage.setItem('metrix_user_id', metrixUserId);
 
// Or send to backend
analyticsAPI.setUserId(metrixUserId);

import {
  init,
  authorizeUser,
  getAttributionStatus,
  onMetrixUserIdReceived,
  newEvent,
} from '@metrixorg/websdk';
 
// ==========================================
// 1. INITIALIZE SDK
// ==========================================
init('APP_ID', 'API_KEY', {
  sessionTracking: {
    enabled: true,
    packageName: 'my-web-app',
  },
});
 
// ==========================================
// 2. GET SYSTEM IDs
// ==========================================
const metrixUserId = await onMetrixUserIdReceived();
console.log('System User ID:', metrixUserId);
 
// ==========================================
// 3. CHECK ATTRIBUTION
// ==========================================
const attribution = await getAttributionStatus();
console.log('Attribution:', attribution?.attributionStatus);
console.log('Campaign:', attribution?.acquisitionCampaign);
console.log('Source:', attribution?.acquisitionSource);
 
// ==========================================
// 4. AUTHORIZE USER
// ==========================================
authorizeUser('customer@example.com');
 
// ==========================================
// 5. TRACK EVENTS WITH CONTEXT
// ==========================================
newEvent('app_opened', {
  attribution_status: attribution?.attributionStatus,
  campaign: attribution?.acquisitionCampaign,
});
 
// ==========================================
// 6. SEND TO ANALYTICS
// ==========================================
analytics.init({
  userId: metrixUserId,
  customerId: 'customer@example.com',
  campaign: attribution?.acquisitionCampaign,
});
 
// ==========================================
// 7. MONITOR SESSION
// ==========================================
document.addEventListener('visibilitychange', () => {
  if (document.hidden) {
    console.log('Session paused');
  } else {
    console.log('Session resumed');
  }
});

// ✓ Good - Initialize immediately
import { init } from '@metrixorg/websdk';
init('APP_ID', 'API_KEY', { ... });
 
// ✗ Bad - Delayed initialization
setTimeout(() => init(...), 5000);

// ✓ Good - Wait for IDs to be ready
const id = await onMetrixUserIdReceived();
const attribution = await getAttributionStatus();
 
// ✗ Bad - Use immediately without waiting
console.log(metrixUserId);  // May be undefined

// ✓ Good - Enable to count installs
init('APP_ID', 'API_KEY', {
  sessionTracking: { enabled: true },
});
 
// ✗ Bad - Disabled, installs not tracked
init('APP_ID', 'API_KEY', {
  sessionTracking: { enabled: false },
});

// ✓ Good
try {
  const attribution = await getAttributionStatus();
  // Use attribution
} catch (error) {
  console.error('Attribution unavailable:', error);
  // Graceful fallback
}
 
// ✗ Bad - Unhandled errors crash
const attribution = await getAttributionStatus();
console.log(attribution.acquisitionCampaign);  // Crashes if null

// ✓ Good - Proper URL format
const uri = Uri.parse("https://app.com?gps_adid=" + advertisingId);
 
// ✗ Bad - Wrong parameter name
const uri = Uri.parse("https://app.com?adid=" + advertisingId);

// Wait for ID first
await onMetrixUserIdReceived();
const attribution = await getAttributionStatus();

const idPromise = onMetrixUserIdReceived();
const timeoutPromise = new Promise((_, reject) => setTimeout(() => reject('Timeout'), 5000));
 
try {
  const metrixUserId = await Promise.race([idPromise, timeoutPromise]);
} catch {
  console.log('ID not available in time');
}

// در <head> یا ابتدای اجرای اپ قرار دهید
init('APP_ID', 'API_KEY', {
  sessionTracking: { enabled: true },
});

// Correct format
"https://app.com?gps_adid=5e6afe60-2b3f-4b4f-8f8f-8f8f8f8f8f8f"
 
// Not valid
"https://app.com?ad_id=5e6afe60..."  // Wrong parameter name
"https://app.com?gps_adid="           // Empty value