Batch یکی از پیشگامان ارتباطات و اطلاع رسانی پوش است که برای iOS, Android & mobile websites طراحی شده است.
مناسب برای آمارگیری دقیق از تعداد نصب .
حداقل نسخه : Android 4.0.3 (API Level 15) و بالاتر
قبل از هرکاری :
1- وارد Batch's dashboard شده و اپ اندرویدی جدیدی بسازید
2- حالا بگذارید کلید های پوش شما ساخته بشن ؛ بعد اون هارو توی Batch's dashboard قرار بدید
*کلید Server API Key رو دریافت کنید*
اینجا برای یافتن Server Api Key دو مرحله پیش رو دارید
ابتدا با فیلترشکن وارد Firebase console بعد از اینکه وارد حسابتون شدید ، در صورت وجود ، پروژه ای رو انتخاب یا ایجاد کنید.
سپس روی + یا نام پروژه ی موجود کلیک کرده و وارد "Project settings" شوید.
روی عنوان "Cloud Messaging" کلیک کرده و Server API Key رو کپی کنید.
* فایل google-services.json خودتون رو که از فایربیس دانلود کردید رو کنار پروژه قرار بدید (عین تصویر زیر)
*پیکربندی پوش بچ*
حالا به ⚙ Settings → General در Batch's dashboard رفته ، زبان پیش فرض را انتخاب کرده و Server API Key را در⚙️ Settings → Push settings وارد کنید .
* دقت داشته باشید که پکیج نیم باید در برنامه شما ، بچ و فایربیس یکسان باشد *
* گام بعدی :
بعد از کپی کردن محتویات فایل فشرده ی خریداری شده ، کتابخونه ی Hitex_Batch رو تیک بزنید .
در Basic4Android وارد Project → Manifest Editor شده و پنج خط زیر رو به آخر کد اضافه کنید : (بجای YOUR_API_KEY یکی از کلید های Live یا Dev را وارد کنید)
CreateResourceFromFile(Macro, FirebaseAnalytics.GooglePlayBase)
CreateResourceFromFile(Macro, FirebaseAnalytics.Firebase)
CreateResourceFromFile(Macro, FirebaseAnalytics.FirebaseAnalytics)
CreateResourceFromFile(Macro, Hitex_Batch.Manifast)
AddReplacement($BatchApiKey$, YOUR_API_KEY)
Dev API key: برای توسعه یا اهداف تستی استفاده می شود ، این نوع کلید شامل ثبت آمار نمی شود ، مراقب باشید اپ خود را با این کلید توی مارکت ها منتشر نکنید .
Live API key: باید فقط در محیط تولید و در نسخه نهایی برنامه شما در مارکت استفاده شود .
Batch's dashboard → Settings → General
* اضافه کردن پشتیبانی از پوش نوتیفیکیشن *
برای اضافه کردن پشتیبانی از پوش نوتیفیکیشن ، بچ به firebase-core و firebase-messaging نسخه ی 11.0.0 و بالاتر نیاز دارد . ما به شدت استفاده از آخرین نسخه ی موجود رو پیشنهاد میکنیم (درحال حاضر 12.0.1)
کد های زیر رو به پروژتون اضافه کنید :
#AdditionalJar: com.google.firebase:firebase-core
#AdditionalJar: com.google.firebase:firebase-messaging
اگر میخواهید بچ به شناسه ی تبلیغاتی شما (Advertising ID) و دیباگ اشکال زدایی شما دسترسی داشته باشد ، استفاده کنید ، این شامل firebase-analytics هم می شود .
نگران نباشید این گزینه ها کاملاً اختیاری هستند.
#AdditionalJar: com.google.firebase:firebase-analytics
#AdditionalJar: com.google.android.gms:play-services-ads-identifier
در آخر مالتی دکس رو فعال کنید :
#MultiDex: True
چنانچه بعد از اضافه کردن موارد بالا با خطای Maven Artifact مواجه شدید ، پس از اطمینان از نصب آخرین نسخه ی Basic4Android نسخه ی ساپورت SDK خود را بروز رسانی کنید (به شدت پیشنهاد میشود از SDK خود ِبیسیک که توسط ارل ، ارائه شده استفاده کنید.)
* نمایی از sdk خود بیسیک :
* نتیجه را آزمایش کنید : *
تبریک میگم شما بخشی از این آموزش رو انجام دادید.
بعد از اینکه برنامه رو روی شبیه ساز یا دستگاه اندرویدی که گوگل پلی روی آن فعال است اجرا کردید ، باید کد زیر رو توی Log بیسیک مشاهده کنید :
مورد دوم ممکن است بسته به انتخاب نوع Api Key یا استفاده نکردن از دیپندنسی های فایربیس Core و Messaging نمایش داده نشود .
پس از انجام مراحل بالا در قسمت Settings → Debug میتوانید با Installation ID که توی لاگ دریافت کردید به مشخصات دستگاه اندرویدی رجیستر شده دسترسی داشته باشید و پوش تستی بفرستید . (پوش تستی را بر روی Dev Api تست کنید ، توکن ممکن است کمی با تأخیر ظاهر شود)
* تصاویری از آمار نصب و پوش :
سوالات متداول :
آیا سرویس بچ رایگان است ؟
بچ طرح های رایگان و پولی با قابلیت های متفاوتی دارد که میتوان از طریق این صفحه به اون ها دسترسی داشت . (آمار نصب دقیق و تایید ارسال 500 پوش در دقیقه رایگان است)
آیا میتوانم بچ را در چندین برنامه استفاده کنم ؟
بله میتوانید هر تعداد که خواستید ، برنامه اضافه کنید.
آیا اعضای تیم من میتوانند برنامه های من را مدیریت کنند ؟
به عنوان سرپرست یا ادمین میتوانید افرادی از اعضای تیم تان را برای مدیریت برنامه هایتان ، ایجاد یا ویرایش کمپین های اعلان پوش تعیین کنید.
آیا بچ امن است ؟
امنیت بالاترین الویت ماست ، تمامی فعالیت های ما از طریق دو روش encryption + SSL انجام می شود .
آیا بچ در ایران کار می کند ؟
بله ، شما میتوانید با بچ به کاربران ایرانی تان نیز پوش ارسال کنید .
چرا آمار برنامه یا برنامه های من در داشبرد بچ مشاهده نمی شود ؟
ابتدا مطمئن شوید که از کلید Live API key در برنامه تان استفاده کرده اید ، اگر باز هم مشکل دارید به این صفحه مراجعه کنید .
یا به تیم پشتیبانی ما support@batch.com. ایمیل بزنید.
به خاطر داشته باشید که آمار نصب و غیره با تأخیر حداکثر 24 ساعت ثبت می شوند . (به طور معمول نصب ها ساعت 12 هر ظهر و توکن ها در همان لحظه بروز رسانی می شوند.)
توجه : 24 ساعت تأخیر در نمایش آمار نصب ، توی خود سایت Batch مطرح شده و برای نسخه ی Studio هم به همین صورته .
چنانچه پس از گذشت 24 ساعت ، همچنان آماری را مشاهده نکردید ، مراحل ابتدایی نصب Hitex_Batch را مجدداً انجام دهید تا اشتباه هایتان را برطرف کنید.