مهاجرت از ادجاست به چابک ویرایش

با توجه به تحریم کاربران ایرانی از سوی سرویس ادجاست، شما می‌توانید به راحتی به سرویس چابک مهاجرت کنید و از قابلیت ترکر نصب (Tracker) چابک، کمپین‌های نصب و رفتار درون برنامه‌ای کاربران اپلیکیشن موبایل و وب خود را رصد کنید.

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

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

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

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

تعریف ترکر نصب (Install tracker)

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

۱. نصب کتابخانه

کد کتابخانه ادجاست را از بخش dependencies حذف کنید:

implementation 'com.adjust.sdk:adjust-android:4.17.0'
implementation 'com.google.android.gms:play-services-analytics:16.0.4'

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

سپس کتابخانه چابک را به بخش dependencies اضافه کنید:

implementation 'me.leolin:ShortcutBadger:1.1.22@aar' 
implementation 'com.adpdigital.push:chabok-lib:2.14.2'  
implementation 'com.google.android.gms:play-services-gcm:10.2.6'  

۲. توکن پوش‌نوتیفیکیشن

چابک برای نمایش پوش‌نوتیفیکیشن و همچنین تشخیص حذف و نصب مجدد اپلیکیشن به دریافت توکن نیاز دارد.

کد زیر را به فایل AndroidManifest.xml بخش application اضافه کنید:

<receiver
    android:name="com.google.android.gms.gcm.GcmReceiver"
    android:enabled="true"
    android:exported="true"
    android:permission="com.google.android.c2dm.permission.SEND">
    <intent-filter>
        <action android:name="com.google.android.c2dm.intent.RECEIVE" />
        <action android:name="com.google.android.c2dm.intent.REGISTRATION" />
        <category android:name="MY_APPLICATION_PACKAGE_ID" />
    </intent-filter>
</receiver>

۳. راه‌اندازی کتابخانه

کد مربوط به راه‌اندازی کتابخانه ادجاست را از کلاس Application و از متد onCreate پروژه خود حذف کنید:

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

        // Configure adjust SDK.
        String appToken = "XXXXXXXXXXXX";
        String environment = AdjustConfig.ENVIRONMENT_SANDBOX;
        AdjustConfig config = new AdjustConfig(this, appToken, environment);
        config.setLogLevel(LogLevel.VERBOSE);
        Adjust.setPushToken("token");
        
        Adjust.onCreate(config);
        
        ...
    }
}

سپس کدهای مربوط به مقدار دهی اولیه چابک را به کلاس Application متد onCreate اضافه کنید.

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

        AdpPushClient.init(
                getApplicationContext(),
                MY_ACTIVITY.class,
                "APP_ID/SENDER_ID", //based on your environment
                "API_KEY",          //based on your environment
                "SDK_USERNAME",     //based on your environment
                "SDK_PASSWORD"      //based on your environment
        );
        AdpPushClient.get().setDevelopment(true);

		...
    }
}

در متد init به جای پارامتر‌های APP_ID/SENDER_ID, API_KEY(SDK_KEY), SDK_USERNAME, SDK_PASSWORD مقادیر مربوط به حساب چابک خود را وارد نمایید. نحوه ایجاد حساب در بخش پیش‌نیازها توضیح داده شده است. در صورت داشتن حساب چابک هم می‌توانید این مقادیر را از پنل بخش تنظیمات قسمت دسترسی‌ و توکن‌ها بردارید.

۴. ثبت کاربر

یکی از مزیت‌های چابک امکان معرفی هر کاربر با یک شناسه منحصر به فرد است. این قابلیت به شما امکان می‌دهد دستگاه‌های کاربر را مدیریت کنید و سوابق جمع‌آوری شده را همانند یک سیستم مدیریت مشتریان (CRM) در اختیار داشته باشید.

@Override
public void onCreate() {
    super.onCreate();

    ...
    
    String userId = AdpPushClient.get().getUserId();
    
    if (userId != null && !userId.isEmpty()) {
        AdpPushClient.get().register(userId);
    } else {

        //If user is not registered verify the user and
        //call AdpPushClient.get().register("USER_ID") method at login page
        
        //If you have guest users
        // should be called here (If you want to track installs on user's first app launch (just like Adjust))
        AdpPushClient.get().registerAsGuest();

    }
}

متد registerAsGuest کاربر را به عنوان کاربر مهمان ثبت می‌کند. این متد به طور خودکار یک تگ مهمان (CHABOK_GUEST) به کاربر اختصاص می‌دهد.

متد register علاوه بر ثبت کاربر، عمل اتصال به سرور چابک را انجام می‌دهد، بنابراین باید فقط یک بار در طول اجرای اپلیکیشن (در کلاس application) فراخوانی شود: (برای اطلاعات بیشتر می‌توانید بخش ثبت کاربر را مطالعه کنید.)

نکته: دقت کنید که متد registerAsGuest را تنها استفاده نکنید و مانند بالا عمل کنید. در صورت فراخوانی این متد به تنهایی کاربر با هر بازدید به عنوان یک مهمان جدید محاسبه خواهد شد.

۵. ایجاد ترکر نصب

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

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

رصد رفتار کاربر (Track event)

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

با استفاده از متد track در کتابخانه ادجاست این امکان صورت می‌پذیرد همانند مثال زیر:

AdjustEvent event = new AdjustEvent("abc123");  
event.setRevenue(0.01, "EUR");  
event.setOrderId("{OrderId}");  
  
Adjust.trackEvent(event);  

با تغییر مثال بالا به کد زیر می‌توانید همان رفتار را در چابک رصد کنید:

JSONObject data = new JSONObject();  
data.put("currency", "EUR");  
data.put("revenue", 0.01)  
data.put("orderId", "{OrderId}");  
  
AdpPushClient.get().track("abc123", data);  

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