ویژگی‌های استاندارد Universal Analytics (UA) پردازش داده‌ها را در 1 ژوئیه 2023 متوقف کردند . دارایی‌های UA 360 پردازش داده‌ها را در تاریخ 1 ژوئیه 2024 متوقف خواهند کرد و برخی از ویژگی‌های UA 360 قبل از آن منسوخ خواهند شد ، زیرا ما به Google Analytics 4 منتقل می‌شویم . برای استفاده از Google Analytics 4، به Firebase مهاجرت کنید .

این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

اندازه‌گیری کمپین - Android SDK نسخه ۲ (قدیمی)

این سند یک نمای کلی از نحوه اندازه‌گیری کمپین‌ها و منابع ترافیک با Google Analytics SDK برای اندروید نسخه ۲ ارائه می‌دهد.

بررسی اجمالی

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

انواع مختلفی از اندازه گیری کمپین در Google Analytics SDK برای Android موجود است:

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

بخش‌های زیر زمان و نحوه اجرای هر نوع اندازه‌گیری کمپین را در برنامه شما شرح می‌دهند.

اندازه‌گیری کمپین Google Play

Google Play Campaign Measurement به شما این امکان را می دهد که ببینید کدام کمپین ها و منابع ترافیک کاربران را برای دانلود برنامه شما از فروشگاه Google Play می فرستند. ما به همه توسعه دهندگان توصیه می کنیم که اندازه گیری کمپین فروشگاه Google Play را اجرا کنند.

نحوه عملکرد اندازه‌گیری کمپین Google Play

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

در زیر شرح کاملی از نحوه عملکرد اندازه‌گیری کمپین Google Play ارائه شده است:

کاربر روی پیوندی از یک تبلیغ، وب‌سایت یا برنامه کلیک می‌کند که او را به صفحه فروشگاه Google Play برنامه شما می‌برد. پیوند با پارامترهای کمپین برچسب گذاری شده است.
پس از اینکه کاربر برنامه شما را دانلود و نصب کرد، فروشگاه Google Play یک هدف INSTALL_REFERRER را در دستگاه پخش می‌کند که شامل همان پارامترهای کمپین است.
سپس برنامه شما با استفاده از شی BroadcastReceiver ارائه شده در زیر، خواندن پارامترهای کمپین و استفاده از آنها برای به روز رسانی اطلاعات کمپین Google Analytics به این هدف پاسخ می دهد.

اجرای اندازه‌گیری کمپین Google Play

برای اجرای اندازه‌گیری کمپین فروشگاه Google Play:

1. یک BroadcastReceiver جدید به فایل AndroidManifest.xml خود اضافه کنید

BroadcastReceiver زیر به برنامه شما اجازه می‌دهد تا هنگام نصب برنامه شما به هدف INSTALL_REFERRER که توسط فروشگاه Google Play پخش می‌شود، پاسخ دهد. به صورت زیر آن را به فایل AndroidManifest.xml خود اضافه کنید:

<!-- Used for install referral measurement-->
<service android:name="com.google.analytics.tracking.android.CampaignTrackingService"/>
<receiver android:name="com.google.analytics.tracking.android.CampaignTrackingReceiver" android:exported="true">
  <intent-filter>
    <action android:name="com.android.vending.INSTALL_REFERRER" />
  </intent-filter>
</receiver>

مشکل شناخته شده : javadoc برای CampaignTrackingReceiver در حال حاضر نمونه نادرستی از این قطعه را نشان می دهد.

2. پارامترهای کمپین را به لینک های فروشگاه Google Play خود اضافه کنید

پارامترهای کمپین برای انتقال اطلاعات مربوط به کمپین یا منبع ترافیکی که کاربر را به صفحه فروشگاه Google Play برنامه شما ارجاع داده است به پیاده سازی Google Analytics برنامه شما استفاده می شود.

برای یادگیری نحوه ایجاد رشته پارامتر کمپین، از Google Play URL Builder استفاده کنید یا به بخش مرجع پارامترهای کمپین مراجعه کنید.

هنگامی که رشته پارامتر کمپین خود را ساختید، آن را به عنوان مقدار پارامتر referrer به URL های فروشگاه Google Play خود اضافه کنید، مانند این مثال:

https://play.google.com/store/apps/details?id=com.example.app
&referrer=utm_source%3Dgoogle
%26utm_medium%3Dcpc
%26utm_term%3Drunning%252Bshoes
%26utm_content%3DdisplayAd1
%26utm_campaign%3Dshoe%252Bcampaign

فروشگاه Google Play فقط مقدار پارامتر referrer را به پیاده سازی Google Analytics برنامه شما منتقل می کند، بنابراین مهم است که مطمئن شوید در پیوندهای فروشگاه Google Play شما وجود دارد.

اندازه گیری کمپین های عمومی

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

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

اجرای اندازه گیری کمپین عمومی

برای تنظیم مقادیر کمپین برای یک کمپین عمومی، setCampaign() را فراخوانی کنید و یک رشته پارامتر کمپین را به عنوان آرگومان ارسال کنید.

یک پیاده‌سازی معمولی ممکن است هنگام راه‌اندازی برنامه setCampaign() فراخوانی کند و قصد راه‌اندازی آن را بررسی کند تا ببیند آیا پارامترهای کمپین معتبری وجود دارد یا خیر:

public class SampleActivity extends Activity {

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

    // Get the intent that started this Activity.
    Intent intent = this.getIntent();
    Uri uri = intent.getData();

    // Call setContext() here so that we can access EasyTracker
    // to update campaign information before calling activityStart().
    EasyTracker.getInstance().setContext(this);

    if (intent.getData() != null) {
      EasyTracker.getTracker().setCampaign(uri.getPath());
    }
    ... // The rest of your onCreate() code.
  }

  @Override
  public void onStart() {
    super.onStart();
    EasyTracker.getInstance().activityStart(this);
    ... // The rest of your onStart() code.
  }


  @Override
  public void onStop() {
    super.onStop();
    EasyTracker.getInstance().activityStop(this);
    ... // The rest of your onStop() code.
  }
}

اندازه گیری ارجاعات

اندازه گیری ارجاع مشابه سایر انواع اندازه گیری کمپین است زیرا به شما امکان می دهد منبع ارجاعی را که برنامه شما را روی دستگاه کاربر راه اندازی کرده است اندازه گیری کنید. با این حال، اندازه‌گیری ارجاع از یک رشته ساده مانند «google.com» یا «myOtherApp» به جای رشته‌ای از پارامترهای کمپین استفاده می‌کند.

وقتی منبع ارجاعی مانند "google.com" را تنظیم می کنید، بعد منبع روی "google.com" تنظیم می شود، در حالی که بعد متوسط به طور ضمنی روی "ارجاع دهنده" تنظیم می شود.

همانند اندازه‌گیری کمپین، تنظیم یک منبع ارجاع‌دهنده، به‌طور پیش‌فرض باعث می‌شود که تماس ارسال بعدی، جلسه جدیدی را آغاز کند.

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

public class SampleActivity extends Activity {

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

    // Get the intent that started this Activity.
    Intent intent = this.getIntent();
    Uri uri = intent.getData();

    // Call setContext() here so that we can access EasyTracker
    // to update campaign information before activityStart() is called.
    EasyTracker.getInstance().setContext(this);

    if (uri != null) {
      if(uri.getQueryParmeter("utm_source") != null) {    // Use campaign parameters if avaialble.
        EasyTracker.getTracker().setCampaign(uri.getPath());
      } else if (uri.getQueryParameter("referrer") != null) {    // Otherwise, try to find a referrer parameter.
        EasyTracker.getTracker().setReferrer(uri.getQueryParameter("referrer"));
      }
    }
  }


  @Override
    public void onStart() {
    super.onStart();
    EasyTracker.getInstance().activityStart(this);
    ... // The rest of your onStart() code.
  }


  @Override
  public void onStop() {
    super.onStop();
    EasyTracker.getInstance().activityStop(this);
    ... // The rest of your onStop() code.
  }
}

مشکلات شناخته شده

javadoc برای CampaignTrackingReceiver از یک مسیر کلاس نادرست در مثال استفاده خود استفاده می کند. برای استفاده صحیح به پیاده سازی کمپین اندازه گیری Google Play مراجعه کنید.
فقط یک کلاس BroadcastReceiver را می توان در هر برنامه مشخص کرد. اگر نیاز به ترکیب دو یا چند BroadcastReceivers از SDK های مختلف دارید، باید کلاس BroadcastReceiver خود را ایجاد کنید که همه پخش ها را دریافت می کند و برای هر نوع پخش، BroadcastReceivers مناسب را فراخوانی می کند.
Google Play Campaign Measurement در حال حاضر از نصب وب به دستگاه که از فروشگاه Play وب شروع شده است پشتیبانی نمی کند.

پارامترهای کمپین

پارامترهای کمپین برای انتقال اطلاعات در مورد منابع ترافیک و کمپین هایی که کاربران را به برنامه شما می آورند استفاده می شود.

در اندازه گیری کلی کمپین، یک رشته پارامتر کمپین رمزگذاری نشده به عنوان آرگومان به setCampaign() ارسال می شود.
در Google Play Campaign Measurement، یک پارامتر referrer با یک رشته پارامتر کمپین رمزگذاری شده به عنوان مقدار آن به هر URL که به صفحه فروشگاه Play برنامه شما اشاره می کند، اضافه می شود.

در زیر نمونه ای از یک رشته کمپین معتبر و رمزگذاری نشده است که می تواند برای اندازه گیری کلی کمپین استفاده شود:

"utm_campaign=my_campaign&utm_source=google&utm_medium=cpc&utm_term=my_keyword&utm_content=ad_variation1"

جدول زیر فهرست کامل پارامترهای کمپین موجود را نشان می دهد که می توانند در Google Play یا اندازه گیری کلی کمپین استفاده شوند.

پارامتر	شرح	مثال ها)
`utm_campaign`	نام کمپین؛ برای تجزیه و تحلیل کلمات کلیدی برای شناسایی یک تبلیغ خاص محصول یا کمپین استراتژیک استفاده می شود	`utm_campaign=spring_sale`
`utm_source`	منبع کمپین؛ برای شناسایی موتور جستجو، خبرنامه یا منبع دیگر استفاده می شود	`utm_source=google`
`utm_medium`	رسانه کمپین؛ برای شناسایی رسانه ای مانند ایمیل یا هزینه هر کلیک (cpc) استفاده می شود	`utm_medium=cpc`
`utm_term`	مدت کمپین؛ با جستجوی پولی برای تامین کلمات کلیدی تبلیغات استفاده می شود	`utm_term=running+shoes`
`utm_content`	محتوای کمپین؛ برای تست A/B و تبلیغات هدفمند محتوا برای متمایز کردن تبلیغات یا پیوندهایی که به یک URL اشاره می کنند استفاده می شود.	`utm_content=logolink` `utm_content=textlink`
`gclid`	پارامتر برچسب گذاری خودکار گوگل ادز ; برای اندازه گیری تبلیغات گوگل استفاده می شود. این مقدار به صورت پویا تولید می شود و هرگز نباید تغییر یابد.

Google Play URL Builder

از Google Play URL Builder برای ایجاد URL برای اندازه گیری کمپین Google Play استفاده کنید.