پرش به مطلب اصلی
نسخه: 3.0.0+

Myket Install Referrer

نیازمند SDK 3.0.0+

افزونه Myket Install Referrer از Adtrace Android SDK 3.0.0 به بعد در دسترس است و در SDK نسخه 2.6.0 وجود ندارد.

از افزونه اختیاری Myket Install Referrer استفاده کنید وقتی اپ Android شما در مایکت (Myket) منتشر می‌شود. این افزونه install referrer مایکت را می‌خواند و آن را به‌صورت sdk_click به ادتریس ارسال می‌کند؛ مشابه رفتار referrer در Google Play / Samsung / Xiaomi / Vivo.

قبل از شروع، شروع کار با SDK اندروید را کامل کنید و Adtrace SDK اصلی را مقداردهی اولیه کنید.

افزونه اختیاری

این افزونه را فقط اگر در مایکت منتشر می‌کنید اضافه کنید. اپ‌هایی که فقط Google Play را هدف می‌گیرند می‌توانند آن را رد کنند.

افزودن Maven repository مایکت​

SDK مربوط به referrer مایکت روی Maven repository مایکت میزبانی می‌شود. آن را به repositoryهای پروژه اضافه کنید (فایل root مربوط به settings.gradle / build.gradle، یا ماژولی که به افزونه وابسته است):

repositories {
    mavenCentral()
    google()
    maven { url "https://maven.myket.ir" }
}

افزودن وابستگی افزونه​

افزونه Myket را کنار Adtrace SDK اصلی در build.gradle اپ اضافه کنید:

build.gradle
dependencies {
    implementation 'io.adtrace:android-sdk:3.0.1'
    implementation 'io.adtrace:android-sdk-plugin-myket:3.0.1'
}

نسخه SDK اصلی و افزونه باید یکسان باشد (SDK 3.0.0+).

این افزونه به ir.myket:referrersdk وابسته است. Permissionها و ورودی‌های package visibility لازم از آن AAR در manifest اپ merge می‌شوند؛ نیازی به افزودن دستی آن‌ها نیست.

همچنین می‌توانید AAR افزونه را از صفحه GitHub releases دانلود کنید.

نحوه عملکرد​

وقتی افزونه روی classpath باشد، ادتریس در اولین session به‌صورت خودکار install referrer مایکت را می‌خواند و یک sdk_click ارسال می‌کند. برای جریان پیش‌فرض، کد مقداردهی اولیه اضافی لازم نیست.

با LogLevel.VERBOSE، Logcat را با تگ AdTrace فیلتر کنید. نمونهٔ خواندن موفق referrer مایکت شبیه این است:

Logcat (example)
Path:      /sdk_click
ClientSdk: android3.0.1
Parameters:
  referrer             utm_source=adtrace&utm_campaign=myket_test
  click_time           1727000000
  install_begin_time   1727000100
  referrer_api         myket

referrer، click_time و install_begin_time در صورت وجود از مایکت می‌آیند. referrer_api همیشه myket است.

اختیاری: فعال یا غیرفعال کردن خواندن Myket​

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

import io.adtrace.sdk.myket.AdTraceMyketReferrer;

// Disable Myket referrer reads
AdTraceMyketReferrer.doNotReadMyketReferrer();

// Re-enable (pass application context)
AdTraceMyketReferrer.readMyketReferrer(context);

Proguard / R8​

قوانین Consumer Proguard مربوط به Myket AIDL binder همراه افزونه ارائه می‌شوند. اگر نیاز به افزودن دستی دارید:

-keep interface com.myket.installreferrer.** { *; }
-keep class com.myket.installreferrer.** { *; }
-keep class ir.myket.referrersdk.** { *; }

تست یکپارچه‌سازی​

  1. یکپارچه‌سازی اصلی SDK را با ENVIRONMENT_SANDBOX و LogLevel.VERBOSE کامل کنید.
  2. اپ را از مایکت نصب کنید (یا از build تست / staging مایکت که referrer ارائه می‌دهد استفاده کنید).
  3. اپ را یک‌بار روی نصب تمیز باز کنید.
  4. در Logcat (تگ AdTrace) مطمئن شوید sdk_click با referrer_api=myket ارسال شده است.
  5. در پنل ادتریس، Settings → Testing Console را باز کنید و نصب / attribution دستگاه تست را بررسی کنید.
نکته

برای نمونه و رفتار binder خود مایکت، به نمونه referrer مایکت مراجعه کنید.