Đo lường chiến dịch – SDK Android phiên bản 2 (Cũ)

Tài liệu này cung cấp thông tin tổng quan về cách đo lường chiến dịch và nguồn lưu lượng truy cập bằng SDK Google Analytics cho Android phiên bản 2.

Tổng quan

Việc đo lường chiến dịch trong Google Analytics có thể giúp bạn cải thiện giá trị của các kênh tiếp thị bằng cách cho phép phân bổ chiến dịch và nguồn lưu lượng truy cập cho hoạt động của người dùng trong ứng dụng của bạn.

Có một số loại đo lường chiến dịch trong SDK Google Analytics dành cho Android:

  • Đo lường chiến dịch trên Google Play – Xem những chiến dịch, trang web và ứng dụng nào đã giới thiệu người dùng đến trang Cửa hàng Google Play của ứng dụng để tải ứng dụng của bạn xuống.
  • Đo lường chiến dịch chung – Xem chiến dịch hoặc nguồn lưu lượng truy cập nào đã khởi chạy ứng dụng của bạn – Xem chiến dịch hoặc nguồn lưu lượng truy cập nào đã chạy ứng dụng của bạn.
  • Đo lường lượt giới thiệu – Xem nguồn lưu lượng truy cập giới thiệu nào (chẳng hạn như các trang web hoặc ứng dụng khác) đã khởi chạy ứng dụng của bạn sau khi cài đặt.

Các phần sau đây sẽ mô tả thời điểm và cách triển khai từng loại đo lường chiến dịch trong ứng dụng của bạn.

Đo lường chiến dịch trên Google Play

Tính năng Đo lường chiến dịch trên Google Play giúp bạn biết được những chiến dịch và nguồn lưu lượng truy cập nào đang đưa người dùng tải ứng dụng của bạn xuống từ Cửa hàng Google Play. Tất cả các nhà phát triển nên triển khai tính năng Đo lường chiến dịch trên Cửa hàng Google Play.

Cách hoạt động của tính năng Đo lường chiến dịch trên Google Play

Tính năng đo lường chiến dịch trên Cửa hàng Google Play dựa trên việc sử dụng Tham số chiến dịch để chuyển thông tin về chiến dịch và nguồn lưu lượng truy cập vào ứng dụng của bạn tại thời điểm ứng dụng được tải xuống từ Cửa hàng Google Play.

Sau đây là nội dung mô tả toàn diện về cách hoạt động của giải pháp Đo lường chiến dịch trên Google Play:

  1. Người dùng nhấp vào một đường liên kết (từ quảng cáo, trang web hoặc ứng dụng) đưa họ đến trang Cửa hàng Google Play của ứng dụng. Mối liên kết này được gắn thẻ bằng Thông số chiến dịch.
  2. Sau khi người dùng tải xuống và cài đặt ứng dụng của bạn, Cửa hàng Google Play sẽ truyền phát một ý định INSTALL_REFERRER trên thiết bị có chứa cùng các thông số chiến dịch đó.
  3. Sau đó, ứng dụng của bạn sẽ phản hồi ý định đó bằng cách sử dụng đối tượng BroadcastReceiver được cung cấp bên dưới, đọc các thông số chiến dịch và sử dụng các thông số đó để cập nhật thông tin chiến dịch trên Google Analytics.

Triển khai Đo lường chiến dịch trên Google Play

Cách triển khai tính năng Đo lường chiến dịch trên Cửa hàng Google Play:

1. Thêm một BroadcastReceiver mới vào tệp AndroidManifest.xml của bạn

BroadcastReceiver sau đây cho phép ứng dụng của bạn phản hồi thông báo về ý định INSTALL_REFERRER do Cửa hàng Google Play truyền ra khi ứng dụng được cài đặt. Thêm vào tệp AndroidManifest.xml như sau:

<!-- 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>

2. Thêm thông số chiến dịch vào đường liên kết đến Cửa hàng Google Play

Thông số chiến dịch được dùng để chuyển thông tin về chiến dịch hoặc nguồn lưu lượng truy cập đã giới thiệu người dùng đến trang Cửa hàng Google Play của ứng dụng đến phương thức triển khai Google Analytics của ứng dụng.

Để tìm hiểu cách tạo chuỗi thông số chiến dịch, hãy sử dụng Trình tạo URL của Google Play hoặc tham khảo phần tham khảo Thông số chiến dịch.

Sau khi bạn đã tạo chuỗi thông số chiến dịch, hãy thêm chuỗi đó vào URL Cửa hàng Google Play dưới dạng giá trị của thông số referrer, như trong ví dụ sau: 

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

Cửa hàng Google Play sẽ chỉ chuyển giá trị của tham số referrer đến hoạt động triển khai Google Analytics của ứng dụng, vì vậy, điều quan trọng là bạn phải đảm bảo thông số này hiện diện trong các đường liên kết đến Cửa hàng Google Play.

Đo lường chiến dịch chung

Bạn có thể sử dụng phương pháp đo lường chiến dịch chung để liên kết một chiến dịch hoặc nguồn lưu lượng truy cập với một người dùng sau khi họ đã cài đặt ứng dụng của bạn.

Ví dụ: nếu đang chạy một chiến dịch có tính phí để tiếp cận những người dùng hiện tại đã cài đặt ứng dụng của bạn, thì bạn có thể sử dụng phương pháp đo lường chiến dịch chung để đo lường những lượt khởi chạy ứng dụng nào là kết quả của chiến dịch đó.

Triển khai hoạt động đo lường chiến dịch chung

Để đặt giá trị chiến dịch cho một chiến dịch chung, hãy gọi setCampaign() và chuyển chuỗi thông số chiến dịch làm đối số.

Một quy trình triển khai thông thường có thể gọi setCampaign() khi ứng dụng được khởi chạy và kiểm tra ý định đã khởi chạy ứng dụng đó để xem có thông số chiến dịch hợp lệ hay không:

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.
  }
}

Đo lường lượt giới thiệu

Tính năng đo lường lượt giới thiệu tương tự như các phương pháp đo lường chiến dịch khác, vì tính năng này cho phép bạn đo lường nguồn giới thiệu đã chạy ứng dụng của bạn trên thiết bị của người dùng. Tuy nhiên, tính năng đo lường lượt giới thiệu sử dụng một chuỗi đơn giản như "google.com" hoặc "myOtherApp", thay vì một chuỗi các thông số chiến dịch.

Khi bạn đặt nguồn giới thiệu, như "google.com", thứ nguyên nguồn sẽ được đặt thành "google.com", trong khi thứ nguyên phương tiện được ngầm đặt thành "liên kết giới thiệu"

Giống như hoạt động đo lường chiến dịch, theo mặc định, việc đặt nguồn giới thiệu sẽ khiến lệnh gọi gửi tiếp theo bắt đầu một phiên mới.

Trong đoạn mã sau, chúng tôi giả định rằng bạn đã gắn thẻ mọi đường liên kết sẽ mở ứng dụng của bạn bằng các thông số chiến dịch trên Google Analytics hoặc bằng một tham số referrer đơn giản để mô tả nguồn giới thiệu. Nếu thông số referrer hiện diện khi không có các thông số chiến dịch khác, thì thông tin chiến dịch của người dùng sẽ được cập nhật bằng nguồn tham chiếu mới:

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.
  }
}

Vấn đề đã biết

  • javadoc cho CampaignTrackingReceiver sử dụng đường dẫn lớp không chính xác trong ví dụ sử dụng. Hãy xem bài viết Triển khai đo lường chiến dịch trên Google Play để biết cách sử dụng đúng.
  • Bạn chỉ có thể chỉ định một lớp BroadcastReceiver cho mỗi ứng dụng. Nếu cần kết hợp hai hoặc nhiều BroadcastReceivers từ các SDK khác nhau, bạn cần tạo lớp BroadcastReceiver riêng để nhận tất cả thông báo truyền tin và gọi BroadcastReceivers thích hợp cho từng loại thông báo truyền tin.
  • Tính năng Đo lường chiến dịch trên Google Play hiện không hỗ trợ các lượt cài đặt từ web đến thiết bị được thực hiện từ Cửa hàng Play trực tuyến.

Thông số chiến dịch

Các thông số chiến dịch được dùng để truyền thông tin về các nguồn lưu lượng truy cập và chiến dịch đang đưa người dùng đến với ứng dụng của bạn.

  • Trong hoạt động đo lường chiến dịch chung, một chuỗi thông số chiến dịch chưa mã hoá sẽ được chuyển dưới dạng một đối số đến setCampaign() .
  • Trong Đo lường chiến dịch trên Google Play, thông số referrer có chuỗi thông số chiến dịch được mã hoá dưới dạng giá trị của thông số này sẽ được thêm vào bất kỳ URL nào trỏ đến trang Cửa hàng Play của ứng dụng.

Sau đây là ví dụ về một chuỗi chiến dịch hợp lệ, chưa được mã hoá có thể dùng để đo lường chiến dịch chung:

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

Bảng dưới đây hiển thị danh sách đầy đủ các thông số chiến dịch hiện có có thể dùng trong Google Play hoặc dữ liệu đo lường chiến dịch chung.

Thông số Nội dung mô tả Ví dụ
utm_campaign Tên chiến dịch; được dùng để phân tích từ khoá nhằm xác định một quảng cáo sản phẩm cụ thể hoặc chiến dịch mang tính chiến lược utm_campaign=spring_sale
utm_source Nguồn chiến dịch; được dùng để xác định công cụ tìm kiếm, bản tin hoặc nguồn khác utm_source=google
utm_medium Phương tiện chiến dịch; được dùng để xác định phương tiện, chẳng hạn như email hoặc chi phí mỗi lượt nhấp (cpc) utm_medium=cpc
utm_term Cụm từ chiến dịch; được sử dụng cùng với kết quả tìm kiếm có trả phí để cung cấp từ khoá cho quảng cáo utm_term=running+shoes
utm_content Nội dung chiến dịch; được sử dụng cho thử nghiệm A/B và quảng cáo nhắm mục tiêu theo nội dung để phân biệt các quảng cáo hoặc đường liên kết trỏ đến cùng một URL utm_content=logolink
utm_content=textlink
gclid Thông số tự động gắn thẻ của Google Ads; được dùng để đo lường Google Ads. Giá trị này được tạo tự động và không bao giờ được sửa đổi.

Trình tạo URL của Google Play

Sử dụng Trình tạo URL của Google Play để tạo URL cho hoạt động Đo lường chiến dịch trên Google Play.