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

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

1. إنشاء مشروع جديد

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

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

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

   $ 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- إضافة عنوان وصل لمكتبات Objective-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 */

لإضافة عنوان جسر هدف-ج في إعدادات الإصدار:

1. في Xcode، انقر على مشروعك.
2. انقر على إنشاء الإعدادات في منطقة المحرّر.
   
3. اختَر الكل ومدمجة وابحث عن جسر.
   
4. في العمود الأيمن من الصف الذي يحتوي على سبب جسر الهدف-ج، أدخِل 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. أضِف رمز تتبُّع الشاشة.

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

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

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

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

ج. إنشاء علامة GTM بعنوان Screen View

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

يُرجى الاطّلاع على لقطة شاشة لإنشاء علامة "إدارة العلامات من Google" لـ عرض الشاشة.

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

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. إنشاء زر وإضافة رمز لتتبّع الضغط على الزر

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

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

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

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

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

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

اطّلِع على لقطة شاشة لإنشاء علامة GTM التي يتم الضغط عليها باستخدام الزر.

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

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

   انقر على الزر عرض مكتبة العناصر (الزر الأزرق):

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

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

   @IBAction func buttonPressed(sender: AnyObject) {
   }

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

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

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

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

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