دليل البدء لـ Swift

يشرح هذا الدليل كيفية إنشاء تطبيق iOS وتنفيذه في Swift لتتبُّع الأحداث التي يتم فتحها وضغط على الأزرار باستخدام أداة "إدارة العلامات من Google" (GTM).

1- خطوات إنشاء مشروع جديد

1. افتح Xcode.
2. انقر على إنشاء مشروع Xcode جديد.
3. اختَر تطبيق عرض واحد.
4. انقر على التالي.
5. قم بتسمية مشروعك وتحديد خيارات إضافية له. سيكون اسم مشروعك واسم تطبيقك مطابقًا لاسم المنتج.
   
6. انقر على التالي.
7. اختَر موقعًا جغرافيًا للمشروع (دليل).
8. انقر على إنشاء.

2. تثبيت العناصر الاعتمادية لأداة "إدارة العلامات من Google"

1. عليك إنهاء Xcode.
2. في وحدة طرفية، شغِّل الأمر التالي لتثبيت Cocoapods:

   $ sudo gem install cocoapods
   

3. انتقِل إلى دليل مشروعك.
4. نفِّذ الأمر التالي لإنشاء ملف باسم Podfile:

   $ pod init
   

5. في Podfile، يمكنك إلغاء تعليق use_frameworks! وإضافة pod 'GoogleTagManager' إلى الهدف:

# Uncomment this line if you're using Swift
use_frameworks!

target 'GtmSwiftTutorial' do
  pod 'GoogleTagManager'
end

6. شغِّل الأمر التالي لتنزيل تبعيات أداة "إدارة العلامات من Google" (GTM) وتثبيتها على مشروعك:

   $ pod install
   

   يؤدي هذا الأمر أيضًا إلى إنشاء مساحة العمل GtmSwiftTutorial.xcworkspace. من الآن فصاعدًا، يمكنك استخدام مساحة العمل هذه لتطوير تطبيق "GtmSwiftTutorial".

3. إضافة عنوان جسر لمكتبات Object-C

لإنشاء ملف عنوان مشترك:

1. افتح Xcode.
2. انقر على ملف > جديد > ملف.
3. ضمن iOS > المصدر، اختَر ملف العنوان.
4. انقر على التالي.
5. أدخِل اسم ملف العنوان BridgingHeader.h.
   
6. انقر على إنشاء.
7. أضِف عبارات import هذه إلى ملف العنوان:

   #ifndef BridgingHeader_h
   #define BridgingHeader_h
   
   #import <GoogleTagManager/TAGManager.h>
   #import <GoogleTagManager/TAGContainer.h>
   #import <GoogleTagManager/TAGContainerOpener.h>
   #import <GoogleTagManager/TAGDataLayer.h>
   #import <GoogleTagManager/TAGLogger.h>
   
   #endif /* BridgingHeader_h */
   

لإضافة عنوان ربط Intent-C على إعدادات الإصدار:

1. في Xcode، انقر فوق مشروعك.
2. انقر على إعدادات الإصدار في منطقة المحرّر.
   
3. اختر الكل ومجمّعة وابحث عن ربط.
   
4. في العمود الأيسر من الصف الذي يحتوي على Goal-C Bridging Header، أدخِل BridgingHeader.h.
   

4. إضافة حاوية تلقائية إلى مشروعك

قبل إضافة حاوية تلقائية إلى مشروعك، نزِّل برنامجًا ثنائيًا لحاوية الأجهزة الجوّالة:

1. سجِّل الدخول إلى حسابك على أداة "إدارة العلامات من Google".
2. اختَر حاوية للأجهزة الجوّالة.
3. انقر على الإصدارات في شريط القوائم.
4. انقر على الإجراءات > تنزيل في إصدار الحاوية المحدّد.
اسم الملف الذي تم تنزيله هو رقم تعريف الحاوية، على سبيل المثال، GTM-PT3L9Z.

لإضافة برنامج ثنائي تلقائي للحاوية إلى مشروعك:

1. افتح Xcode.
2. انقر على رمز الباحث (Finder) على شريط الإرساء.
3. انقر على المجلد Downoloads.
4. اسحب الملف الثنائي للحاوية في المجلد Downloads وأفلِته في المجلد الجذر لمشروع Xcode.

5. ربط أداة "إدارة العلامات من Google" بتطبيقك

1. في Xcode، افتح الملف AppDelegate.swift.
2. اطلب من صف "AppDelegate" تمديد صف TAGContainerOpenerNotifier:

   import UIKit
   
   @UIApplicationMain
   class AppDelegate: UIResponder, UIApplicationDelegate, TAGContainerOpenerNotifier {
     // ...
   }
   

   بعد تمديد الصف، سيظهر لك الخطأ Type 'AppDelegate' does not conform to protocol 'TAGContainerOpenerNotifier'. ستؤدي الخطوة التالية إلى إصلاح هذا الخطأ.

3. أضِف الدالة التالية إلى أسفل تعريف فئة AppDelegate:

   func containerAvailable(container: TAGContainer!) {
     container.refresh()
   }
   

4. في الدالة application، أضِف الرمز التالي قبل عبارة return true:

   let GTM = TAGManager.instance()
   GTM.logger.setLogLevel(kTAGLoggerLogLevelVerbose)
   
   TAGContainerOpener.openContainerWithId("GTM-PT3L9Z",  // change the container ID "GTM-PT3L9Z" to yours
       tagManager: GTM, openType: kTAGOpenTypePreferFresh,
       timeout: nil,
       notifier: self)
   

6. تتبُّع حدث فتح الشاشة

لتتبُّع حدث مفتوح الشاشة:

1. أنشئ متغيّرًا لتخزين رقم تعريف التتبّع.
2. أنشئ متغيّر طبقة البيانات باسم screenName.
3. أنشئ علامة "إدارة العلامات من Google" بعنوان مشاهدة الشاشة.
4. إضافة رمز تتبّع الشاشة

a. إنشاء متغيّر لتخزين رقم تعريف التتبّع

1. سجِّل الدخول إلى حسابك على إدارة العلامات من Google.
2. اختَر حاوية للأجهزة الجوّالة.
3. في شريط التنقّل الأيمن، انقر على المتغيّرات.
4. ضمن متغيّرات من تحديد المستخدِم، انقر على جديد.
5. انقر على متغيّر بلا عنوان لإدخال اسم المتغيّر رقم تعريف التتبّع.
6. اختَر ثابت كنوع المتغيّر.
7. أدخِل رقم تعريف التتبّع (على شكل UA-XXXXXXXX-X، حيث يكون X رقمًا) كقيمة للمتغيّر.
   استخدِم UA-47605289-5 (ليتم حذفه).
8. انقر على إنشاء متغيّر.

b. إنشاء متغيّر طبقة البيانات باسم screenName

1. سجِّل الدخول إلى حسابك على إدارة العلامات من Google.
2. اختَر حاوية للأجهزة الجوّالة.
3. في شريط التنقّل الأيمن، انقر على المتغيّرات.
4. ضمن متغيّرات من تحديد المستخدِم، انقر على جديد.
5. انقر على متغيّر بلا عنوان لإدخال عنوان اسم الشاشة.
6. اختَر متغيّر طبقة البيانات كنوع المتغيّر.
7. أدخِل screenName في حقل اسم متغير طبقة البيانات.
8. انقر على ضبط القيمة التلقائية.
9. أدخِل القيمة التلقائية شاشة غير معروفة.
10. انقر على إنشاء متغيّر.

ج- إنشاء علامة "إدارة العلامات من Google" بعنوان "مشاهدة الشاشة"

1. سجِّل الدخول إلى حسابك على إدارة العلامات من Google.
2. اختَر حاوية للأجهزة الجوّالة.
3. في شريط التنقّل الأيمن، انقر على العلامات.
4. انقر على جديد.
5. انقر على علامة بلا عنوان لإدخال اسم العلامة مشاهدة الشاشة.
6. اختر المنتج إحصاءات Google.
7. اختَر رقم تعريف التتبّع من القائمة.
8. اختَر مشاهدة التطبيق على أنّه نوع التتبّع.
9. انقر على مزيد من الإعدادات.
10. انقر على الحقول المطلوب إعدادها.
11. انقر على + إضافة حقل.
12. اختَر اسم الحقل screenName وقيمته اسم الشاشة.
13. انقر على متابعة.
14. ضِمن إطلاق النار، اختَر أي حدث.
15. انقر على إنشاء علامة.

اطّلِع على لقطة الشاشة لإنشاء علامة GTM لمشاهدة الشاشة.

د- إضافة رمز تتبّع الشاشة

1. فتح الملف ViewController.swift في Xcode
2. حدِّد متغيّرًا باسم dataLayer في الفئة ViewController:

   var dataLayer: TAGDataLayer = TAGManager.instance().dataLayer
   

3. في الدالة viewDidLoad()، أرسِل الحدث OpenScreen إلى طبقة البيانات:

   dataLayer.push(["event": "OpenScreen", "screenName": "Home Screen"])
   

يبدو تعريف الفئة ViewController على النحو التالي:

import UIKit

class ViewController: UIViewController {
  var dataLayer: TAGDataLayer = TAGManager.instance().dataLayer

  override func viewDidLoad() {
    super.viewDidLoad()
    dataLayer.push(["event": "OpenScreen", "screenName": "Home Screen"])
  }

  override func didReceiveMemoryWarning() {
    super.didReceiveMemoryWarning()
    // Dispose of any resources that cant be recreated
  }
}

7. حدث تم الضغط على زر التتبّع

لتتبُّع حدث تم الضغط على زر فيه:

1. أنشئ متغيّرًا في طبقة البيانات باسم eventAction.
2. أنشئ متغيّر حدث مخصَّص باسم الحدث.
3. أنشئ علامة "إدارة العلامات من Google" بعنوان تم الضغط على الزر.
4. أنشئ زرًا وأضِف رمزًا لتتبّع الضغط على الزر.

a. إنشاء متغيّر طبقة البيانات باسم eventAction

1. سجِّل الدخول إلى حسابك على إدارة العلامات من Google.
2. اختَر حاوية للأجهزة الجوّالة.
3. في شريط التنقّل الأيمن، انقر على المتغيّرات.
4. ضمن متغيّرات من تحديد المستخدِم، انقر على جديد.
5. انقر على متغيّر بلا عنوان لإدخال العنوان إجراء الحدث.
6. اختَر متغيّر طبقة البيانات كنوع المتغيّر.
7. أدخِل eventAction باعتباره اسم متغير طبقة البيانات.
8. انقر على ضبط القيمة التلقائية.
9. أدخِل القيمة التلقائية حدث غير معروف.
10. انقر على إنشاء متغيّر.

b. إنشاء متغيّر حدث مخصّص باسم "الحدث"

1. سجِّل الدخول إلى حسابك على إدارة العلامات من Google.
2. اختَر حاوية للأجهزة الجوّالة.
3. في شريط التنقّل الأيمن، انقر على المتغيّرات.
4. ضمن متغيّرات من تحديد المستخدِم، انقر على جديد.
5. انقر على متغيّر بلا عنوان لإدخال اسم المتغيّر الحدث.
6. اختَر الحدث المخصّص كنوع المتغيّر.
7. انقر على إنشاء متغيّر.

ج- إنشاء علامة "إدارة العلامات من Google" بعنوان "الضغط على الزر"

1. سجِّل الدخول إلى حسابك على إدارة العلامات من Google.
2. اختَر حاوية للأجهزة الجوّالة.
3. في شريط التنقّل الأيمن، انقر على العلامات.
4. انقر على جديد.
5. انقر على علامة بلا عنوان لإدخال اسم العلامة تم الضغط على الزر.
6. اختر المنتج إحصاءات Google.
7. اختَر رقم تعريف التتبّع من القائمة.
8. اختَر الحدث باعتباره نوع التتبّع.
9. اختر فئة الحدث.
10. اختَر إجراء الحدث.
11. انقر على متابعة.
12. ضِمن إطلاق النار، اختَر أي حدث.
13. انقر على إنشاء علامة.

اطّلِع على لقطة الشاشة لإنشاء علامة GTM الضغط على الأزرار.

د- إنشاء زر وإضافة رمز لتتبُّع أنه تم الضغط على الزر

1. افتح مشروع Xcode.
2. فتح "Main.storyboard"
3. انقر على الزر العلوي الأيسر في شريط أدوات Xcode لفتح منطقة الأداة المساعدة (الشريط الجانبي الأيسر).
4. في أسفل منطقة المرافق،
   

   انقر على الزر Show the Object Library (إظهار مكتبة العناصر) (الزر الأزرق):

   
5. أدخِل الزر في مربّع البحث.
   
6. اسحب الزر إلى لوحة العمل وأفلِته في الزاوية العلوية اليمنى.
   
7. انقر على زر محرِّر المساعد في شريط أدوات Xcode.
8. أثناء الضغط مع الاستمرار على مفتاح Ctrl، اسحب الزر وأفلِته إلى أسفل تعريف الفئة ViewController.
   
9. في مربّع الحوار، اختَر اتصال Action، وأدخِل اسم الدالة buttonPressed، ثم انقر على ربط.
   

   يؤدي ذلك إلى إضافة الدالة التالية إلى نهاية تعريف فئة ViewController:

   @IBAction func buttonPressed(sender: AnyObject) {
   }
   

   يتم تنفيذ الدالة في كل مرة يتم فيها الضغط على الزر.

10. في دالة buttonPressed، أضِف الرمز التالي لدفع الحدث ButtonPressed إلى طبقة اليوم:

    @IBAction func buttonPressed(sender: AnyObject) {
      dataLayer.push(["event": "ButtonPressed", "eventAction": "Test Event"])
    }
    

8. إنشاء تطبيقك وتشغيله

في Xcode، انقر على المنتج > تشغيل. سينشئ Xcode التطبيق ويشغِّله: