برچسب های Universal Analytics

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

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

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

توجه : این راهنما فرض می‌کند که از راهنمای شروع برای پیاده‌سازی Google Tag Manager برای iOS پیروی کرده‌اید.

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

برای ارسال نمای صفحه هر بار که صفحه جدیدی در برنامه شما باز می شود به 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 را به لایه داده فشار دهید، به عنوان مثال:

//  ViewController.m
//  Push an 'openScreen' event to the data layer.
//
#import "ViewController.h"
#import "TAGDataLayer.h"
#import "TAGManager.h"

@implementation ViewController

- (void)viewDidAppear {
    [super viewDidAppear];

    // NOTE: A GTM container should already have been opened, otherwise events
    //     pushed to the DataLayer will not fire tags in that container.
    TAGDataLayer *dataLayer = [TAGManager instance].dataLayer;

    [dataLayer push:@{@"event": @"openScreen",          // Event, name of Open Screen Event.
                      @"screenName": @"Home Screen"}];  // Name of the screen name field, screen name value.
}

// Rest of the ViewController implementation

@end

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

برای ارسال رویداد به 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 به لایه داده، کد بنویسید، به عنوان مثال:

//  VideoPlayer.m
//  Push a 'videoPlay' event to the data layer.
//
#import "TAGDataLayer.h"
#import "TAGManager.h"
#import "Video.h"
#import "VideoPlayer.h"

@implementation VideoPlayer
// Called when a user initiates a video playback.
- (void)onPlay:(Video *)video {

    TAGDataLayer *dataLayer = [TAGManager instance].dataLayer;

    // This call assumes the container has already been opened, otherwise events
    // pushed to the DataLayer will not fire tags in that container.
    [dataLayer push:@{@"event": @"videoPlay",          // Event, name of Video Play Event.
                      @"videoName": video.title,       // Additional data layer variables used by the event tag.
                      @"screenName": @"Home Screen"}];

    [self play:video];
}

// Rest of the implementation
@end

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

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

هنگامی که کاربر یک خرید درون برنامه ای را تکمیل می کند، برای ارسال تراکنش و موارد مرتبط به 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.
- (void)onPurchaseCompleted:(Purchase *)purchase {

  TAGDataLayer *dataLayer = [TAGManager instance].dataLayer;

  // An array to store dictionaries of item data.
  NSMutableArray *purchasedItems = [NSMutableArray array];

  // Push item data into dictionaries and store in the purchasedItems array.
  // Note that item.price and item.quantity must be of type NSString.
  for (id item in purchase.items) {
    [purchasedItems addObject:@{@"name": item.name,
                                @"sku": item.sku,
                                @"category": item.category,
                                @"price": item.price,
                                @"currency": @"USD",
                                @"quantity": item.quantity}];
  }

  // This call assumes the container has already been opened, otherwise events
  // pushed to the DataLayer will not fire tags in that container.
  // Note that purchase.tax, purchase.shipping, and purchase.total must be of type NSString.
  [dataLayer push:@{@"event": @"transaction",                  // Event, name of Transaction Event.
                    @"transactionId": purchase.transactionId,  // Additional fields required by the tag.
                    @"transactionTotal": purchase.total,
                    @"transactionAffiliation": @"In-app Store",
                    @"transactionTax": purchase.tax,
                    @"transactionShipping": purchase.shipping,
                    @"transactionCurrency": @"USD",
                    @"transactionProducts": purchasedItems}];

  // Since the data layer is persistent, you should reset fields to [NSNull null] after
  // you are done pushing the transaction.
  [dataLayer push:@{@"transactionId": [NSNull null],
                    @"transactionTotal": [NSNull null],
                    @"transactionAffiliation": [NSNull null],
                    @"transactionTax": [NSNull null],
                    @"transactionShipping": [NSNull null],
                    @"transactionCurrency": [NSNull null],
                    @"transactionProducts": [NSNull null]}];
}