مستندات وب سرویس نیواد

آیا به دنبال راهی قدرتمند برای افزایش تعامل کاربران و بازگرداندن آن‌ها به اپلیکیشن خود هستید؟ 🤔 پوش نوتیفیکیشن یکی از موثرترین ابزارهای بازاریابی موبایلی است. وب سرویس پوش نوتیفیکیشن نیواد به شما کمک می‌کند تا این قابلیت کلیدی را به‌سادگی و با بالاترین کیفیت در اپلیکیشن اندرویدی خود پیاده‌سازی کنید. در این راهنمای جامع (بخش اول از مستندات وب سرویس نیواد)، ما شما را قدم به قدم در مسیر راه‌اندازی کتابخانه نیواد همراهی می‌کنیم.

این مستندات با تمرکز بر سادگی و کارایی طراحی شده است. بنابراین، حتی اگر تجربه زیادی در کار با سرویس‌های شخص ثالث نداشته باشید، می‌توانید به‌راحتی این فرآیند را تکمیل کنید. بیایید شروع کنیم! 🚀

چرا باید از پوش نوتیفیکیشن نیواد استفاده کنیم؟

استفاده از یک سرویس پایدار و بهینه برای ارسال نوتیفیکیشن، تفاوت چشمگیری در تجربه کاربری و موفقیت اپلیکیشن شما ایجاد می‌کند. وب سرویس نیواد با در نظر گرفتن نیازهای توسعه‌دهندگان ایرانی طراحی شده است. در ادامه به برخی از مهم‌ترین مزیت‌های آن اشاره می‌کنیم:

🎯 ارسال هدفمند و هوشمند: نوتیفیکیشن‌ها را بر اساس رفتار، موقعیت جغرافیایی و ویژگی‌های کاربران برای گروه‌های خاص ارسال کنید.
⚙️ راه‌اندازی سریع و آسان: با مستندات واضح و کتابخانه‌های بهینه‌شده، فرآیند پیاده‌سازی در کمترین زمان ممکن انجام می‌شود.
📊 گزارش‌گیری دقیق: آمار کاملی از نرخ باز شدن، کلیک و تعامل کاربران با هر نوتیفیکیشن دریافت کرده و کمپین‌های خود را بهینه کنید.
🚀 سرعت و پایداری بالا: سرورهای قدرتمند نیواد تضمین می‌کنند که پیام‌های شما با بالاترین سرعت و ضریب اطمینان به دست کاربران می‌رسد.
🇮🇷 بدون نیاز به ابزارهای جانبی: برای استفاده از مخزن (Repository) و سرویس‌های نیواد، به هیچ‌گونه ابزار تغییر IP نیاز نخواهید داشت.

کاربردهای کلیدی پوش نوتیفیکیشن نیواد

پوش نوتیفیکیشن فقط یک پیام ساده نیست؛ یک ابزار استراتژیک برای رشد کسب‌وکار شماست. از این قابلیت می‌توانید برای اهداف مختلفی استفاده کنید:

🛍️ اطلاع‌رسانی تخفیف‌ها و پیشنهادات ویژه: کاربران را از جدیدترین کمپین‌های فروش خود مطلع کرده و آن‌ها را به خرید ترغیب کنید.
📰 ارسال آخرین اخبار و مطالب: اگر یک اپلیکیشن خبری یا وبلاگ دارید، کاربران را فوراً از محتوای جدید خود باخبر سازید.
🔔 یادآوری‌ها و اعلان‌های سیستمی: برای یادآوری رویدادها، تکمیل پروفایل یا اطلاع‌رسانی تراکنش‌های موفق از نوتیفیکیشن استفاده کنید.
📈 بازگرداندن کاربران غیرفعال: کاربرانی که مدتی است به اپلیکیشن شما سر نزده‌اند را با یک پیام جذاب دوباره فعال کنید.

راهنمای کامل راه‌اندازی پوش نوتیفیکیشن نیواد در اندروید

اکنون که با مزایا و کاربردهای این سرویس آشنا شدیم، زمان پیاده‌سازی فرا رسیده است. این فرآیند در سه گام ساده خلاصه می‌شود. ما فرض می‌کنیم شما از Android Studio به عنوان محیط توسعه اصلی استفاده می‌کنید.

پیش‌نیاز: ثبت‌نام در پنل نیواد

قبل از هر چیز، شما به یک حساب کاربری در نیواد نیاز دارید.

به وب‌سایت نیواد مراجعه کرده و از طریق لینک p.api.ir ثبت‌نام کنید.
پس از ورود به پنل، یک اپلیکیشن جدید ایجاد کنید.
مقادیر application id، application secret و push secret را از پنل مدیریت اپلیکیشن خود یادداشت کنید. این کلیدها برای احراز هویت اپلیکیشن شما ضروری هستند.

گام اول: پیکربندی فایل `AndroidManifest.xml`

سیستم‌عامل اندروید برای اجرای صحیح سرویس‌ها و دسترسی به اینترنت به مجوزهای مشخصی نیاز دارد. نیواد برای راحتی شما، یک فایل AndroidManifest.xml نمونه در پنل کاربری قرار داده است.

کدهای زیر را به فایل AndroidManifest.xml پروژه خود اضافه کنید.

1. افزودن مجوزها (Permissions):

ابتدا مجوزهای لازم را قبل از تگ <application> قرار دهید.

xml

<permission android:name="<your_package_name>.permission.C2D_MESSAGE" android:protectionLevel="signature" />
<uses-permission android:name="<your_package_name>.permission.C2D_MESSAGE" />

<!-- مجوزهای ضروری برای اتصال به اینترنت و دریافت پیام -->
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

<!-- مجوز اختیاری برای ایجاد لرزش هنگام دریافت نوتیفیکیشن -->
<uses-permission android:name="android.permission.VIBRATE" />

نکته مهم: حتماً عبارت <your_package_name> را با نام پکیج اپلیکیشن خود (مثلاً com.example.myapp) جایگزین کنید.

2. افزودن شناسه‌های نیواد:

سپس، کد meta-data زیر را داخل تگ <application> کپی کنید. این شناسه برای تشخیص اپلیکیشن شما توسط سرورهای نیواد استفاده می‌شود.

xml

<application
    ...>

    <meta-data
        android:name="io.nivad.push.application_id"
        android:value="YOUR_APPLICATION_ID" />

    <!-- سایر سرویس‌ها و رسیورهای نیواد به صورت خودکار توسط کتابخانه اضافه می‌شوند -->

</application>

توجه: مقدار YOUR_APPLICATION_ID را با application_id که از پنل نیواد دریافت کرده‌اید، جایگزین نمایید. در نسخه‌های جدید کتابخانه نیواد، نیازی به افزودن دستی Receiver و Service نیست و این کار به صورت خودکار انجام می‌شود.

گام دوم: افزودن کتابخانه نیواد به پروژه (فایل `build.gradle`)

در این مرحله، کتابخانه نیواد را به پروژه اندرویدی خود اضافه می‌کنیم. فایل build.gradle (Module: app) را باز کرده و تغییرات زیر را اعمال کنید.

1. افزودن مخزن (Repository) نیواد:

ابتدا مخزن نیواد را به بخش repositories در فایل settings.gradle یا build.gradle سطح پروژه اضافه کنید.

groovy

// In settings.gradle
dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
        maven { url 'https://repo.nivad.io/repository/maven-public/' } // مخزن جدید نیواد
    }
}

2. افزودن وابستگی‌ها (Dependencies):

سپس، کتابخانه‌های core و push نیواد را به بخش dependencies در فایل build.gradle (Module: app) اضافه کنید.

groovy

dependencies {
    // ... سایر وابستگی‌های پروژه شما

    // کتابخانه‌های نیواد
    implementation 'io.nivad.core:library:+'
    implementation 'io.nivad.push:library:+'
}

پس از افزودن این کدها، روی گزینه Sync Now در بالای صفحه کلیک کنید تا کتابخانه‌ها دانلود و به پروژه شما اضافه شوند.

گام سوم: مقداردهی اولیه (Initialize) کتابخانه نیواد

آخرین مرحله، فعال‌سازی سرویس نیواد در لحظه اجرای اپلیکیشن است. بهترین مکان برای این کار، متد onCreate در کلاس Application پروژه شماست. اگر این کلاس را ندارید، یک کلاس جدید ایجاد کنید که از Application ارث‌بری کند.

java

import android.app.Application;
import io.nivad.core.NivadCore;
import io.nivad.push.NivadPush;

public class YourApplicationClass extends Application {
    @Override
    public void onCreate() {
        super.onCreate();

        // مقداردهی اولیه سرویس اصلی نیواد
        NivadCore.initialize(
            this,
            "<YOUR_NIVAD_APPLICATION_ID>",
            "<YOUR_NIVAD_APPLICATION_SECRET>"
        );

        // مقداردهی اولیه سرویس پوش نوتیفیکیشن
        NivadPush.initialize("<YOUR_NIVAD_PUSH_SECRET>");
    }
}

فراموش نکنید که مقادیر application_id، application_secret و push_secret را با کلیدهای دریافتی از پنل نیواد جایگزین کنید. در نهایت، نام این کلاس را در فایل AndroidManifest.xml و در تگ <application> با استفاده از android:name معرفی کنید:

xml

<application
    android:name=".YourApplicationClass"
    ...>
    ...
</application>

تبریک می‌گوییم! 🎉 شما با موفقیت وب سرویس پوش نوتیفیکیشن نیواد را در اپلیکیشن خود راه‌اندازی کردید. از این پس، دریافت پیام‌ها، نمایش نوتیفیکیشن‌ها و جمع‌آوری آمار به صورت خودکار انجام می‌شود.

جمع‌بندی و گام‌های بعدی

در این بخش از مستندات وب سرویس نیواد، ما به صورت گام به گام مراحل راه‌اندازی کتابخانه پوش نوتیفیکیشن در یک پروژه اندرویدی را بررسی کردیم. همان‌طور که مشاهده کردید، این فرآیند بسیار ساده و سریع است. با انجام این سه مرحله، اپلیکیشن شما آماده دریافت نوتیفیکیشن‌های هوشمند و هدفمند از پنل نیواد است.

در بخش‌های بعدی این مستندات، به بررسی ویژگی‌های پیشرفته‌تر مانند ارسال دیتا، مدیریت رویداد کلیک و سفارشی‌سازی ظاهر نوتیفیکیشن‌ها خواهیم پرداخت.

💬 آیا در فرآیند راه‌اندازی با مشکلی مواجه شدید؟ یا پیشنهادی برای بهبود این مستندات دارید؟ حتماً در بخش نظرات با ما در میان بگذارید. تیم فنی نیواد آماده پاسخگویی به شماست.