پرش به مطلب اصلی

تنظیم SDK signature

SDK Signature به شما اجازه می‌دهد ترافیک Adtrace را بر اساس منبع نصب یا app store جدا کنید، آمار را بر اساس signature تحلیل کنید، و (اختیاری) تشخیص تقلب را تقویت کنید. هر signature مقادیر secret خاص خود را دارد. signature ها را در پنل تعریف می‌کنید، یک مجموعه را در هر build store جایگذاری می‌کنید، و گزارش‌ها را در پنل بر اساس signature فیلتر می‌کنید.

فعال‌سازی الزامی است

یک ادمین باید SDK Signature را در حساب شما فعال کند. اگر می‌خواهید از این ویژگی استفاده کنید با پشتیبانی Adtrace در info@adtrace.io تماس بگیرید.

SDK signature چه کاری انجام می‌دهد​

موارد استفادهتوضیح
جداسازی store ها / منابعاز یک signature متفاوت برای هر store استفاده کنید (مثلاً Google Play، بازار، مایکت). نصب‌ها، رویدادها، و درآمد آن build تحت آن signature attributed می‌شوند.
فیلتر تحلیلدر پنل، Statistics → User Acquisition را باز کنید و Show by SDK Signature را فعال کنید تا داده را بر اساس signature تجزیه کنید.
تشخیص تقلببا Fraud Detection فعال برای یک signature، نصب‌هایی از APK بدون signature مطابق می‌توانند به عنوان تقلب علامت‌گذاری شوند. تنها زمانی فعال کنید که هر APK production یک signature داشته باشد.

Adtrace SDK Signature را در SDK های native mobile (Android، iOS، و غیره) پشتیبانی می‌کند. برای Web در دسترس نیست.

قبل از شروع​

نیازجزئیات
فعال‌سازی حسابSDK Signature توسط Adtrace فعال شده (با info@adtrace.io تماس بگیرید)
دسترسی به پنلApp Secrets در پنل Adtrace پس از فعال‌سازی قابل مشاهده است
یک build برای هر signatureهر نسخه store/منبع باید یک signature را جاسازی کند.

مرحله ۱: تعریف signature ها در پنل​

  1. پنل Adtrace → Settings را باز کنید.
  2. بخش SDK Signature را باز کنید و Add SDK Signature را انتخاب کنید.
  3. پر کنید:
فیلدتوضیح
نامبرچسب برای store یا منبع نصب (مثلاً Myket، Bazaar، Google Play).
App Versionنسخه SDK signature (نه versionName اپ شما). برای تمایز signature ها استفاده می‌شود.
نوع App Storeنوع store (مثلاً Bazaar، Myket، Play Store).
  1. Add را انتخاب کنید. برای هر store یا منبعی که نیاز دارید تکرار کنید.
  2. مقادیری که Adtrace برای هر signature نشان می‌دهد را کپی کنید:
    • Secret ID (همچنین Security ID نامیده می‌شود)
    • چهار فیلد عددی secret (info1 … info4)

اختیاری: Fraud Detection را برای یک signature تنها زمانی فعال کنید که تمام APK هایی که برای آن کانال ارسال می‌کنید آن signature را داشته باشند.

مرحله ۲: یکپارچه‌سازی در SDK​

setAppSecret را در نمونه AdTraceConfig قبل از AdTrace.onCreate() فراخوانی کنید.

Method signature​

public void setAppSecret(long secretId, long info1, long info2, long info3, long info4)
پارامترتوضیح
secretIdSecret ID (Security ID) از پنل برای این signature
info1اولین مقدار secret از پنل
info2دومین مقدار secret از پنل
info3سومین مقدار secret از پنل
info4چهارمین مقدار secret از پنل

از مقادیر یک signature پنل برای هر build استفاده کنید.

مثال​

String appToken = "{YourAppToken}";
String environment = AdTraceConfig.ENVIRONMENT_PRODUCTION;

AdTraceConfig config = new AdTraceConfig(this, appToken, environment);
config.setAppSecret(secretId, info1, info2, info3, info4);
AdTrace.onCreate(config);

secretId، info1، … info4 را با اعداد از پنل برای store‌ای که می‌سازید جایگزین کنید.

پنهان کردن secret ها در کد native

برای کاهش exposure در APK های decompile شده، appToken و مقادیر signature را از NDK/JNI بارگذاری کنید. به پنهان کردن اطلاعات حساس با NDK مراجعه کنید.

آزمایش قبل از انتشار​

  1. Signature های آزمایشی را در پنل ایجاد کنید.
  2. برای هر signature که می‌خواهید تأیید کنید، یک build جداگانه قابل نصب با آن signature در کد تولید کنید.
  3. یک نصب تازه در دستگاه آزمایشی انجام دهید.
  4. نصب‌ها و رویدادها را trigger کنید، سپس Statistics را با Show by SDK Signature فعال بررسی کنید.
  5. تأیید کنید که نصب‌ها و رویدادها تحت signature مورد انتظار ظاهر می‌شوند.
یک signature برای هر نصب

هر APK نصب شده باید دقیقاً یک پیکربندی signature داشته باشد.

مرتبط​