app/ directory of your Android project

buildscript {
    dependencies {
        classpath 'com.google.gms:google-services:4.4.2'
    }
}

plugins {
    id 'com.android.application'
    id 'com.google.gms.google-services'
}
 
dependencies {
    // Notification module (automatically includes Firebase messaging)
    implementation 'ir.metrix.notification:metrix:2.8.1'
}

dependencies {
    implementation platform('com.google.firebase:firebase-bom:32.0.0') {
        exclude group: 'com.google.firebase', module: 'firebase-messaging'
        exclude group: 'com.google.firebase', module: 'firebase-iid'
    }
 
    // Notification module provides firebase-messaging
    implementation 'ir.metrix.notification:metrix:2.8.1'
}

implementation 'ir.metrix.notification:metrix:2.8.2'

<manifest xmlns:android="http://schemas.android.com/apk/res/android">
    <application>
        <!-- Firebase Cloud Messaging Service -->
        <service
            android:name="ir.metrix.notification.receivers.MetrixFirebaseMessagingService"
            android:exported="false">
            <intent-filter>
                <action android:name="com.google.firebase.MESSAGING_EVENT" />
            </intent-filter>
        </service>
    </application>
</manifest>

// هنگام ورود کاربر
MetrixAnalytics.User.setUserCustomId("user@example.com");
 
// هنگام خروج کاربر
MetrixAnalytics.User.deleteUserCustomId();

<manifest>
 
  ...
 
  <application>
 
    ...
 
    <meta-data
        android:name="metrix_auto_notification_permission"
        android:value="false" />
 
  </application>
</manifest>

// فعال کردن اعلان‌ها (پیش‌فرض: فعال)
MetrixNotification.enableNotifications();
 
// غیرفعال کردن اعلان‌ها
MetrixNotification.disableNotifications();
 
// بررسی وضعیت اعلان
boolean isEnabled = MetrixNotification.isNotificationEnable();

MetrixNotification.createNotificationDefaultChannel();

MetrixNotification.setNotificationListener(new MetrixNotificationListener() {
    @Override
    public void onNotificationReceived(PushNotification notification) {
        // مدیریت اعلان دریافتی
        Log.d("Notification", "Received: " + notification.getTitle());
    }
 
    @Override
    public void onNotificationClicked(PushNotification notification) {
        // مدیریت کلیک بر روی اعلان
        Log.d("Notification", "Clicked: " + notification.getTitle());
    }
 
    @Override
    public void onNotificationDismissed(PushNotification notification) {
        // مدیریت رد کردن اعلان
        Log.d("Notification", "Dismissed: " + notification.getTitle());
    }
});

boolean isInitialized = MetrixNotification.isInitialized();
 
// یا از یک listenerبرای تکمیل مقداردهی اولیه استفاده کنید
MetrixNotification.setInitializationCompleteListener(() -> {
    Log.d("Notification", "Notification module initialized");
});

<manifest xmlns:android="http://schemas.android.com/apk/res/android">
    <application>
        <!-- غیرفعال کردن بارگذاری خودکار پیام‌های درون‌برنامه‌ای -->
        <meta-data
            android:name="metrix_auto_load_in_app_messages"
            android:value="false" />
    </application>
</manifest>

// بارگذاری پیام‌ها در یک صفحه خاص
public class MyActivity extends AppCompatActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
 
        // بارگذاری پیام‌های درون‌برنامه‌ای برای این صفحه
        MetrixNotification.loadInAppMessages();
    }
}

// توقف پیام‌رسانی درون‌برنامه‌ای (مفید در حین بازی یا تعاملات مهم)
MetrixNotification.pauseInAppMessages(true);
 
// از سرگیری پیام‌رسانی درون‌برنامه‌ای
MetrixNotification.pauseInAppMessages(false);
 
// بررسی اینکه آیا پیام‌رسانی درون‌برنامه‌ای متوقف شده است یا خیر
boolean isPaused = MetrixNotification.isInAppMessagingPaused();

public class GameActivity extends AppCompatActivity {
    private void startGame() {
        // توقف پیام‌ها در حین بازی فعال
        MetrixNotification.pauseInAppMessages(true);
    }
 
    private void gameOver() {
        // از سرگیری پیام‌ها پس از پایان بازی
        MetrixNotification.pauseInAppMessages(false);
 
        // بارگذاری پیام‌ها برای نمایش اعلان‌های پاداش
        MetrixNotification.loadInAppMessages();
    }
}

public class PromotionalScreen extends AppCompatActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.promotional_screen);
 
        // بارگذاری پیام‌های درون‌برنامه‌ای فقط در صفحه تبلیغاتی
        MetrixNotification.loadInAppMessages();
    }
}

<manifest xmlns:android="http://schemas.android.com/apk/res/android">
    <uses-permission android:name="android.permission.POST_NOTIFICATIONS" />
</manifest>

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
    if (ContextCompat.checkSelfPermission(this,
            Manifest.permission.POST_NOTIFICATIONS)
            != PackageManager.PERMISSION_GRANTED) {
        ActivityCompat.requestPermissions(this,
            new String[]{Manifest.permission.POST_NOTIFICATIONS},
            PERMISSION_REQUEST_CODE);
    }
}

// بلافاصله پس از احراز هویت کاربر تنظیم شود
if (user.isAuthenticated()) {
    MetrixAnalytics.User.setUserCustomId(user.getId());
}

MetrixNotification.setNotificationListener(new MetrixNotificationListener() {
    @Override
    public void onNotificationClicked(PushNotification notification) {
        // به صفحه مربوطه هدایت کنید
        Intent intent = new Intent(context, NotificationDetailActivity.class);
        intent.putExtra("notification_id", notification.getId());
        startActivity(intent);
    }
});

// به کاربران اجازه دهید اعلان‌ها را از تنظیمات برنامه غیرفعال کنند
private void onNotificationSettingsClick() {
    boolean currentStatus = MetrixNotification.isNotificationEnable();
    MetrixNotification.enableNotifications(); // یا disableNotifications()
    updateSettingsUI();
}

// در لحظات حساس بارگذاری نکنید
private void onLoadingScreen() {
    MetrixNotification.pauseInAppMessages(true);
}
 
private void onLoadingComplete() {
    MetrixNotification.pauseInAppMessages(false);
    MetrixNotification.loadInAppMessages();
}

// اضافه کردن مدیریت اعلان پوش برای تست
if (BuildConfig.DEBUG) {
    MetrixNotification.setNotificationListener(new MetrixNotificationListener() {
        @Override
        public void onNotificationReceived(PushNotification notification) {
            Log.d("NotifTest", "Test notification: " + notification.getTitle());
        }
    });
}