برچسب های Universal Analytics

برای فعال کردن تغییرات زمان اجرا در اجرای Google Analytics خود که نیازی به بازسازی و ارسال مجدد باینری برنامه خود به بازار ندارد، Universal Analytics (UA) را با Google Tag Manager (GTM) در برنامه خود پیاده کنید.

این راهنما به شما نشان می‌دهد که چگونه از برچسب‌های Universal Analytics و Google Tag Manager SDK برای Android استفاده کنید:

• ارسال نماهای صفحه
• ارسال رویدادها
• ارسال تراکنش های تجارت الکترونیک

ارسال نماهای صفحه

برای ارسال نمای صفحه هر بار که صفحه جدیدی در برنامه شما باز می شود به Google Analytics:

1. یک متغیر نام صفحه ایجاد کنید
2. یک ماشه رویداد صفحه باز ایجاد کنید
3. یک تگ نمای صفحه نمایش Universal Analytics ایجاد کنید
4. رویداد صفحه باز و نام صفحه را به لایه داده فشار دهید

1. یک متغیر نام صفحه ایجاد کنید

برای ایجاد یک متغیر نام صفحه نمایش در GTM:

1. به حساب Google Tag Manager خود وارد شوید.
2. یک ظرف سیار انتخاب کنید.
3. در نوار پیمایش سمت چپ، روی متغیرها کلیک کنید.
4. در قسمت متغیرهای تعریف شده توسط کاربر ، روی New کلیک کنید.
5. روی Untitled Variable کلیک کنید تا نام صفحه نام متغیر را وارد کنید.
6. متغیر لایه داده را به عنوان نوع متغیر انتخاب کنید.
7. screenName را به‌عنوان نام متغیر لایه داده وارد کنید و مقدار پیش‌فرض صفحه ناشناخته آن را تنظیم کنید.

   اسکرین شات ایجاد متغیر نام صفحه را ببینید.

   

8. روی Create Variable کلیک کنید.

2. یک محرک رویداد صفحه باز ایجاد کنید

برای ایجاد یک ماشه در GTM برای فعال کردن برچسب نمای صفحه نمایش Universal Analytics :

1. به حساب Google Tag Manager خود وارد شوید.
2. یک ظرف سیار انتخاب کنید.
3. در نوار پیمایش سمت چپ، روی Triggers کلیک کنید.
4. روی New کلیک کنید.
5. روی Untitled Trigger کلیک کنید تا نام ماشه OpenScreenEvent را وارد کنید.
6. رویداد سفارشی را انتخاب کنید.
7. در زیر Fire On ، شرط زیر را وارد کنید:

   

8. روی Create Trigger کلیک کنید.

3. یک برچسب نمای صفحه نمایش Universal Analytics ایجاد کنید

برای ایجاد تگ نمای صفحه نمایش Universal Analytics که توسط رویداد صفحه باز اجرا می شود:

1. به حساب Google Tag Manager خود وارد شوید.
2. یک ظرف سیار انتخاب کنید.
3. در نوار پیمایش سمت چپ، روی برچسب‌ها کلیک کنید.
4. روی New کلیک کنید.
5. روی Untitled Tag کلیک کنید تا نام برچسب را وارد کنید Open Screen .
6. محصول Google Analytics را انتخاب کنید.
7. شناسه پیگیری را وارد کنید.
8. App View را به عنوان نوع آهنگ انتخاب کنید.
9. تنظیمات بیشتر را کلیک کنید.
10. روی فیلدها برای تنظیم کلیک کنید.
11. برای افزودن فیلدهای زیر، مکرراً روی + Add Field کلیک کنید:

    

12. روی Continue کلیک کنید.
13. در زیر Fire On ، روی Custom کلیک کنید.
14. ماشه سفارشی OpenScreenEvent را انتخاب کنید.
15. روی ذخیره کلیک کنید.
16. روی ایجاد برچسب کلیک کنید.

4. رویداد صفحه باز و نام صفحه را به لایه داده فشار دهید

کدی را به برنامه خود اضافه کنید تا یک رویداد openScreen و یک مقدار screenName را به لایه داده فشار دهید، به عنوان مثال:

import com.google.tagmanager.DataLayer;
import com.google.tagmanager.TagManager;

import android.app.Activity;
import android.os.Bundle;

public class MainActivity extends Activity {

  private static final String SCREEN_NAME = "Home Screen";
  private DataLayer mDataLayer;

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

  @Override
  public void onStart() {
    super.onStart();
    mDataLayer = TagManager.getInstance(this).getDataLayer();

    // Push an openScreen event and a screenName value to the data layer.
    // This call assumes the container has already been opened, otherwise events
    // pushed to the data layer will not fire tags in that container.
    mDataLayer.push(DataLayer.mapOf("event", "openScreen", "screenName", SCREEN_NAME));
  }
}

ارسال رویدادها

برای ارسال رویداد به Google Analytics هنگامی که کاربر با کنترل‌های UI یا محتوای برنامه شما تعامل دارد:

1. (اختیاری) متغیرهای رویداد را ایجاد کنید
2. یک محرک رویداد ایجاد کنید
3. یک تگ رویداد Universal Analytics ایجاد کنید
4. مقدار متغیر رویداد و رویداد را به لایه داده فشار دهید

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

1. (اختیاری) متغیرهای رویداد را ایجاد کنید

اگر رویداد از متغیرهای لایه داده برای نمایش فیلدهای دسته، عمل، برچسب یا مقدار خود استفاده می کند، ابتدا باید آن متغیرها را ایجاد کنید. در این مثال، تگ رویداد پخش ویدیو از یک متغیر لایه داده برای دریافت نام ویدیو استفاده می کند.

برای ایجاد یک متغیر نام ویدیو در GTM:

1. به حساب Google Tag Manager خود وارد شوید.
2. یک ظرف سیار انتخاب کنید.
3. در نوار پیمایش سمت چپ، روی متغیرها کلیک کنید.
4. در قسمت متغیرهای تعریف شده توسط کاربر ، روی New کلیک کنید.
5. برای وارد کردن نام متغیر نام ویدیو، روی Untitled Variable کلیک کنید.
6. متغیر لایه داده را به عنوان نوع متغیر انتخاب کنید.
7. videoName را به عنوان نام متغیر لایه داده وارد کنید و مقدار پیش‌فرض آن را روی ویدیوی ناشناخته تنظیم کنید.

   اسکرین شات ایجاد متغیر نام ویدیو را ببینید.

   

8. روی Create Variable کلیک کنید.

2. ایجاد یک رویداد

برای ایجاد یک راه‌انداز رویداد در GTM برای فعال کردن برچسب رویداد Universal Analytics :

1. به حساب Google Tag Manager خود وارد شوید.
2. یک ظرف سیار انتخاب کنید.
3. در نوار پیمایش سمت چپ، روی Triggers کلیک کنید.
4. روی New کلیک کنید.
5. روی Untitled Trigger کلیک کنید تا نام ماشه VideoPlayEvent را وارد کنید.
6. رویداد سفارشی را انتخاب کنید.
7. در زیر Fire On ، شرط زیر را وارد کنید:

   

8. روی Create Trigger کلیک کنید.

3. یک برچسب رویداد Universal Analytics ایجاد کنید

برای ایجاد یک برچسب رویداد Universal Analytics که توسط رویداد پخش ویدیو اجرا می شود:

1. به حساب Google Tag Manager خود وارد شوید.
2. یک ظرف سیار انتخاب کنید.
3. در نوار پیمایش سمت چپ، روی برچسب‌ها کلیک کنید.
4. روی New کلیک کنید.
5. روی Untitled Tag کلیک کنید تا نام تگ را وارد کنید Video Play Event .
6. محصول Google Analytics را انتخاب کنید.
7. شناسه پیگیری را وارد کنید.
8. رویداد را به عنوان نوع آهنگ انتخاب کنید.
9. پارامترهای ردیابی رویداد زیر را وارد کنید:

   

10. تنظیمات بیشتر را کلیک کنید.
11. روی فیلدها برای تنظیم کلیک کنید.
12. برای افزودن فیلدهای زیر، مکرراً روی + Add Field کلیک کنید:

    

13. روی Continue کلیک کنید.
14. در زیر Fire On ، روی Custom کلیک کنید.
15. ماشه سفارشی VideoPlayEvent را انتخاب کنید.
16. روی ذخیره کلیک کنید.
17. روی ایجاد برچسب کلیک کنید.

4. مقدار متغیر رویداد و رویداد را به لایه داده فشار دهید

برای فشار دادن یک رویداد videoPlay و یک مقدار videoName به لایه داده، کد بنویسید، به عنوان مثال:

import com.google.tagmanager.DataLayer;
import com.google.tagmanager.TagManager;

public class VideoPlayer {

  // Called when a user starts a video playback.
  public void onPlay(Video v) {
    DataLayer dataLayer = TagManager.getInstance(this).getDataLayer();

    // Push a videoPlay event and a videoName value to the data layer.
    // This call assumes the container has already been opened, otherwise events
    // pushed to the data layer will not fire tags in that container.
    dataLayer.push(DataLayer.mapOf("event", "videoPlay", "videoName", v.getName());
    play(v);
  }

  // Rest of the implementation.
  // ...
}

ارسال تراکنش های تجارت الکترونیک

هنگامی که کاربر یک خرید درون برنامه ای را تکمیل می کند، برای ارسال تراکنش و موارد مرتبط به Google Analytics:

1. یک محرک تراکنش ایجاد کنید
2. یک تگ تراکنش Universal Analytics ایجاد کنید
3. رویداد تراکنش، تراکنش و موارد را به لایه داده فشار دهید

برای لیستی از نام متغیرهای تراکنش و مورد پشتیبانی شده، به متغیرهای لایه داده تجارت الکترونیک پشتیبانی شده مراجعه کنید.

1. یک تراکنش ایجاد کنید

برای ایجاد محرک تراکنش در GTM برای فعال کردن برچسب تراکنش Universal Analytics :

1. به حساب Google Tag Manager خود وارد شوید.
2. یک ظرف سیار انتخاب کنید.
3. در نوار پیمایش سمت چپ، روی Triggers کلیک کنید.
4. روی New کلیک کنید.
5. برای وارد کردن نام ماشه TransactionCompleted روی Untitled Trigger کلیک کنید.
6. رویداد سفارشی را انتخاب کنید.
7. در زیر Fire On ، شرط زیر را وارد کنید:

   

8. روی Create Trigger کلیک کنید.

2. یک تگ تراکنش Universal Analytics ایجاد کنید

برای ایجاد یک تگ تراکنش Universal Analytics که توسط رویداد تراکنش فعال می شود:

1. به حساب Google Tag Manager خود وارد شوید.
2. یک ظرف سیار انتخاب کنید.
3. در نوار پیمایش سمت چپ، روی برچسب‌ها کلیک کنید.
4. روی New کلیک کنید.
5. روی Untitled Tag کلیک کنید تا نام برچسب را وارد کنید. Transaction Completed .
6. محصول Google Analytics را انتخاب کنید.
7. شناسه پیگیری را وارد کنید.
8. تراکنش را به عنوان نوع آهنگ انتخاب کنید.
9. تنظیمات بیشتر را کلیک کنید.
10. روی فیلدها برای تنظیم کلیک کنید.
11. برای افزودن فیلدهای زیر، مکرراً روی + Add Field کلیک کنید:

    

12. روی Continue کلیک کنید.
13. در زیر Fire On ، روی Custom کلیک کنید.
14. ماشه سفارشی TransactionCompleted را انتخاب کنید.
15. روی ذخیره کلیک کنید.
16. روی ایجاد برچسب کلیک کنید.

3. رویداد تراکنش، تراکنش و موارد را به لایه داده فشار دهید

کد بنویسید تا رویداد تراکنش، تراکنش و موارد مرتبط به لایه داده را فشار دهید. شما باید از نام متغیر مورد و تراکنش پشتیبانی شده استفاده کنید تا داده های تراکنش و آیتم را به لایه داده منتقل کنید. مثلا:

// Called when a user completes a transaction.
public void onPurchaseCompleted(Purchase p) {

  DataLayer dataLayer = TagManager.getInstance(this).getDataLayer();

  // Put maps of item data into an array to be pushed to the data layer.
  ArrayList<Map<String, String>> purchasedItems = new ArrayList<Map<String, String>>();
  for (Item i : p.items) {
    HashMap<String, String> currentItem = new HashMap<String, String>();

    currentItem.put("name", i.getProductName());
    currentItem.put("sku", i.getProductSku());
    currentItem.put("category", i.getProductCategory());
    currentItem.put("price", i.getProductPrice());
    currentItem.put("currency", "USD");
    currentItem.put("quantity", i.getProductQty());

    purchasedItems.add(currentItem);
  }

  // This call assumes the container has already been opened, otherwise events
  // pushed to the [DataLayer] data layer will not fire tags in that container.
  dataLayer.push(DataLayer.mapOf("event", "transaction",
                                 "transactionId", p.getTransId(),
                                 "transactionTotal", p.getTotal(),
                                 "transactionAffiliation", "In-app Store",
                                 "transactionTax", p.getTax(),
                                 "transactionShipping", p.getShippingCost(),
                                 "transactionCurrency", "USD",
                                 "transactionProducts", purchasedItems));

  // Because the data layer is persistent, you should reset fields to null
  // after you are done pushing the transaction.
  dataLayer.push(DataLayer.mapOf("transactionId", null,
                                 "transactionTotal", null,
                                 "transactionAffiliation", null,
                                 "transactionTax", null,
                                 "transactionShipping", null,
                                 "transactionCurrency", null,
                                 "transactionProducts", null));
}

برای اطلاعات بیشتر در مورد استفاده از Google Tag Manager SDK برای Android برای اجرای ویژگی‌های Universal Analytics Enhanced Ecommerce، به Enhanced Ecommerce مراجعه کنید.

پشتیبانی از متغیرهای لایه داده تجارت الکترونیک

تگ های تراکنش جهانی از نام های متغیر تراکنش و آیتم زیر پشتیبانی می کنند.

احتیاط : از آنجایی که لایه داده پایدار است، پس از اینکه تراکنش را به لایه داده فشار دادید، مقادیر متغیر تراکنش و آیتم را به null بازنشانی کنید.

متغیرهای معامله

نام متغیر	شرح	تایپ کنید	ضروری
transactionId	شناسه تراکنش منحصر به فرد	رشته	آره
transactionAffiliation	شریک یا فروشگاه	رشته	خیر
transactionTotal	ارزش کل معامله	رشته	خیر
transactionTax	مبلغ مالیات برای معامله	رشته	خیر
transactionShipping	هزینه حمل و نقل برای معامله	رشته	خیر
transactionCurrency	واحد پول معامله	رشته	خیر
transactionProducts	لیست اقلام خریداری شده در معامله	آرایه ای از متغیرهای آیتم.	خیر

متغیرهای آیتم

نام متغیر	شرح	تایپ کنید	ضروری
name	نام محصول	رشته	آره
sku	SKU محصول	رشته	خیر
category	رده محصولات	رشته	خیر
price	قیمت کالا	رشته	خیر
currency	نوع ارز price	رشته	خیر
quantity	تعداد اقلام	رشته	خیر

ارجاع ارجاع را نصب کنید

اگر سرویس و گیرنده زیر را در فایل AndroidManifest.xml خود ثبت کنید، داده های ارجاع دهنده نصب موجود به طور خودکار با هر بازدید Google Analytics یا درخواست پیکسل بازاریابی مجدد AdWords اضافه می شود:

<service android:name="com.google.tagmanager.InstallReferrerService" />
<receiver android:name="com.google.tagmanager.InstallReferrerReceiver" android:exported="true">
  <intent-filter>
    <action android:name="com.android.vending.INSTALL_REFERRER" />
  </intent-filter>
</receiver>

توجه : باید به جای Google Analytics CampaignTrackingReceiver ، گیرنده ارجاع دهنده نصب را ثبت کنید.