وضع العلامات من جهة الخادم لتطبيقات الأجهزة الجوّالة

يمكنك ضبط تطبيقاتك المتوافقة مع الأجهزة الجوّالة باستخدام حزمة تطوير البرامج (SDK) لخدمة "إحصاءات Google لبرنامج Firebase" للعمل مع وضع العلامات من جهة الخادم في أداة "إدارة العلامات من Google".

تتيح لك ميزة وضع العلامات من جهة الخادم إعداد بياناتك وإخفاء محتواها وتعزيزها قبل إرسالها إلى المنتجات المقصودة، مثل "إحصاءات Google". اطّلِع على مزيد من المعلومات عن وضع العلامات من جهة الخادم.

لإعداد ميزة وضع العلامات من جهة الخادم للتطبيقات المتوافقة مع الأجهزة الجوّالة، اتّبِع الخطوات التالية:

1. تجهيز تطبيقك لاستخدام ميزة "وضع العلامات من جهة الخادم"
2. ضبط حاوية الخادم لتتوافق مع الزيارات من الأجهزة الجوّالة
3. تفعيل وضع العلامات من جهة الخادم في موقعك على "إحصاءات Google‏ 4"

المتطلبات الأساسية

• عليك تضمين حزمة تطوير البرامج (SDK) لخدمة "إحصاءات Google لبرنامج Firebase" في تطبيقك وربطها بموقعك على "إحصاءات Google‏ 4". مزيد من المعلومات عن حزمة تطوير البرامج (SDK) لخدمة "إحصاءات Google لبرنامج Firebase"
• تحتاج إلى حساب على أداة "إدارة العلامات من Google" وحاوية خادم. أنشئ حسابًا وحاوية جديدتَين على أداة "إدارة العلامات من Google" إذا لم يكن لديك حساب.
• عليك إعداد خادم وضع العلامات.

الخطوة 1: تجهيز تطبيقك لاستخدام ميزة وضع العلامات من جهة الخادم

iOS

1. فعِّل ميزة تحميل وضع وضع العلامات من جهة الخادم وإعداد تنسيق عنوان URL المخصّص لوضع تصحيح الأخطاء في وضع وضع العلامات من جهة الخادم في ملف Info.plist. استبدِل BUNDLE_ID في ما يلي بمعرّف حِزمة التطبيق.

   <?xml version="1.0" encoding="UTF-8"?>
   <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
   <plist version="1.0">
   <dict>
   ...
           <key>CFBundleURLTypes</key>
           <array>
                   <dict>
                           <key>CFBundleTypeRole</key>
                           <string>None</string>
                           <key>CFBundleURLName</key>
                           <string>BUNDLE_ID</string>
                           <key>CFBundleURLSchemes</key>
                           <array>
                                   <string>tagmanager.sgtm.c.BUNDLE_ID</string>
                           </array>
                   </dict>
           </array>
           <key>GOOGLE_ANALYTICS_SGTM_UPLOAD_ENABLED</key>
           <true/>
   </dict>
   </plist>
   

2. لتفعيل وضع تصحيح الأخطاء أو وضع المعاينة، أضِف طلبًا إلى Analytics.handleOpen(_:) في إحدى طرق دورة الحياة لتمرير عنوان URL لبدء التطبيق.

   SwiftUI

   @main
   struct MyApplication: App {
     var body: some Scene {
       WindowGroup {
         ContentView()
           .onOpenURL { url in
             Analytics.handleOpen(url)
           }
       }
     }
   }
   

   UIScene

   class SceneDelegate: UIResponder, UIWindowSceneDelegate {
   func scene(_ scene: UIScene, willConnectTo session: UISceneSession,
           options connectionOptions: UIScene.ConnectionOptions) {
   ...
       if let urlContext = connectionOptions.urlContexts.first {
           let url = urlContext.url
           Analytics.handleOpen(url)
       }
     }
   }
   

   بالنسبة إلى التطبيقات التي لا تستخدم SwiftUI أو UIScene، ليس عليك اتّخاذ أي إجراء. تتلقّى حزمة SDK عنوان URL لبدء التطبيق منApplicationDidFinishLaunchingNotification.

Android

1. ثبِّت أحدث إصدار من حزمة تطوير البرامج (SDK) لخدمة "إحصاءات Google لبرنامج Firebase".

2. فعِّل sGTM من خلال إضافة ما يلي إلى ملف AndroidManifest.xml في التطبيق.

   <!-- Preview Activity to enable preview mode –->
     <activity
         android:name="com.google.firebase.analytics.GoogleAnalyticsServerPreviewActivity"
         android:exported="true"
         android:noHistory="true" >
       <intent-filter>
         <action android:name="android.intent.action.VIEW" />
         <category android:name="android.intent.category.DEFAULT" />
         <category android:name="android.intent.category.BROWSABLE" />
         <data android:scheme="tagmanager.sgtm.c.<APP_PACKAGE_ID>" />
       </intent-filter>
     </activity>
   
   <!-- Meta-data that enables uploads to sGTM –->
     <meta-data android:name="google_analytics_sgtm_upload_enabled" android:value="true" />
   

الخطوة 2: ضبط حاوية الخادم لتتوافق مع الزيارات من الأجهزة الجوّالة

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

إعداد عميل "إحصاءات Google": "إحصاءات Google‏ 4" (التطبيق)

العميل هو نوع مورد في أداة "إدارة العلامات من Google" يعترض أنواعًا معيّنة من الطلبات الواردة وينشئ أحداثًا يمكن تمريرها إلى وجهة، مثل "إحصاءات Google‏ 4". في هذه الحالة، يكون طلب HTTP حدثًا في "إحصاءات Google‏ 4"، لذا عليك ضبط العميل المضمّن في "إحصاءات Google‏ 4": "إحصاءات Google‏ 4 (التطبيق)". تحتاج إلى عميل واحد فقط من "إحصاءات Google‏ 4" لكلّ مصدر بيانات، مثل حزمة تطوير البرامج (SDK) لخدمة "إحصاءات Google" والموقع الإلكتروني. اطّلِع على مزيد من المعلومات عن طريقة عمل العملاء.

1. في حاوية الخادم، انتقِل إلى العملاء وانقر على جديد.

2. انقر على إعدادات العميل، ثم اختَر "إحصاءات Google": "إحصاءات Google‏ 4" (التطبيق).

   

3. أدخِل اسمًا لعميلك وانقر على حفظ.

ضبط علامة "إحصاءات Google‏ 4"

لإرسال البيانات إلى "إحصاءات Google"، عليك إنشاء علامة "إحصاءات Google‏ 4" في حاوية الخادم. يُحلّل العميل طلب HTTP الوارد إلى ملف شخصي لبيانات الحدث. ستأخذ العلامة عنصر بيانات الحدث هذا وتربطه بالتنسيق الصحيح، ثم ترسله إلى "إحصاءات Google‏ 4".

1. في حاوية الخادم، انتقِل إلى العلامات وانقر على جديد.

2. انقر على إعدادات العلامة، ثم اختَر إحصاءات Google: إحصاءات Google‏ 4.

   

سترث العلامة تلقائيًا جميع الحقول والمَعلمات ذات الصلة من عنصر بيانات الحدث الذي أنشأه العميل:

• إذا مرّ طلب "إحصاءات Google‏ 4" الوافد من خلال العميل إحصاءات Google: إحصاءات Google‏ 4 (التطبيق)، تكتسِب العلامة مَعلمتَي معرّف التطبيق والحدث.
• إذا مرت طلبات "إحصاءات Google‏ 4" الواردة من خلال العميل "إحصاءات Google‏ 4 (الويب)"، تكتسِب العلامة رقم تعريف القياس ومقاييد الحدث.

ملاحظة: يمكنك اختياريًا استخدام عمليات التحويل لتضمين مَعلمات الأحداث التي يتم عرضها من العميل أو استبعادها أو تعديلها قبل عرضها على العلامات. ومن خلال عمليات التحويل، يمكنك حماية المعلومات الحسّاسة والتحكّم بشكلٍ دقيق في مَعلمات الأحداث المتاحة لعمليات معالجة إضافية.

إعداد عوامل التشغيل لزيارات الأجهزة الجوّالة

بعد ذلك، عليك تحديد وقت تنشيط علامة "إحصاءات Google‏ 4". يُحلّل عميل "إحصاءات Google‏ 4": (التطبيق) الطلب الوافد إلى كائن بيانات حدث، وستكتسِب العلامة قيمه. لذلك، ستريد عادةً تنشيط العلامة عندما يطالب عميل "إحصاءات Google‏ 4" بالطلب.

لإعداد العوامل المشغِّلة:

1. في إعدادات العلامة، انقر على التشغيل.
2. لإنشاء عامل تشغيل جديد، انقر على رمز + في أعلى يسار الصفحة.
3. انقر على ضبط المشغِّل لاختيار نوع المشغِّل.

4. اختَر مخصّص أو حدث مخصّص من القائمة.

   • يُطلق نوع العامل المشغِّل المخصّص العلامة تلقائيًا عند توليد أيّ حدث من قِبل عميل من جهة الخادم.
   • يمكن استخدام نوع عامل التشغيل الحدث المخصّص لتشغيل العلامة عند تحديد اسم حدث معيّن أو حدث يتطابق مع نمط تعبير عادي.

5. لتفعيل قائمة شروط التفعيل لهذا المشغِّل، مثل التفعيل فقط في بيانات أحداث الأجهزة الجوّالة أو الويب، اختَر بعض الأحداث.

   1. سيظهر لك اسم الحدث محدّدًا مسبقًا. انقر على هذا العنصر الاختياري واختَر اختيار متغيّر مضمّن من القائمة.
   2. لعرض اسم العميل الذي أنشأ الحدث تلقائيًا، اختَر اسم العميل.

   3. استخدِم اسم العميل الذي أعددته سابقًا لضبط الشرط وفقًا لذلك. يجب أن يظهر عامل التفعيل على النحو التالي:

      

      ملاحظة: اسم العميل هو الاسم الذي حدّدته في الخطوة السابقة. نوع العميل هو "إحصاءات Google": "إحصاءات Google‏ 4" (التطبيق). يعرض المتغيّر "اسم العميل" الاسم وليس نوع العميل.

6. احفظ العامل المشغِّل وأدخِل اسمًا وصفيًا. على سبيل المثال، يمكنك استخدام "كل أحداث تطبيقات "إحصاءات Google‏ 4".

7. من المفترض أن تكون الآن قد عدت إلى إعدادات العلامة مع إضافة العامل المشغِّل الجديد. احفظ العلامة وأدخِل اسمًا وصفيًا، مثل "إحصاءات Google‏ 4". من المفترض أن تبدو علامتك على النحو التالي:

   

ملاحظة: لحذف أحداث معيّنة من الإرسال، يمكنك اختيار استخدام عوامل تدوير مخصّصة باستخدام منطق شرطي استنادًا إلى اسم الحدث (أو متغيّر آخر) أو إضافة استثناءات عوامل التشغيل. اطّلِع على مزيد من المعلومات عن عوامل التفعيل واستثناءات عوامل التفعيل.

معاينة الحاوية

يمكنك استخدام أداة "إدارة العلامات من Google" لمعاينة حاوية الخادم وتصحيح الأخطاء فيها قبل نشر التغييرات. يُرجى العِلم أنّ ميزة المعاينة لن تعمل إلى أن تتم تفعيل وضع العلامات من جهة الخادم في موقعك على "إحصاءات Google‏ 4".

لكي تؤدي طلبات تطبيقك إلى تفعيل إعدادات المعاينة، عليك إجراء ما يلي:

1. اختَر معاينة أثناء الانتقال إلى حاوية خادم "إدارة العلامات من Google".
2. انقر على رمز المزيد من الإجراءات ⋮ في أعلى يسار الصفحة واختَر إرسال طلبات من تطبيق.

3. أدخِل رقم تعريف تطبيقك وانقر على إنشاء رمز استجابة سريعة.

   

4. امسح رمز الاستجابة السريعة ضوئيًا باستخدام تطبيق كاميرا هاتفك. واصِل التفاعل مع تطبيقك كالمعتاد لإنشاء أحداث معاينة.

5. انقر على حسنًا لإغلاق مربّع الحوار.

نشر الحاوية

بعد التأكّد من التغييرات، انشر الحاوية لتطبيق هذه التغييرات على جميع الزيارات. مزيد من المعلومات حول النشر والإصدارات والموافقات

الخطوة 3: تفعيل وضع العلامات من جهة الخادم في موقعك على "إحصاءات Google‏ 4"

1. في موقعك على "إحصاءات Google‏ 4"، انتقِل إلى المشرف.
2. افتح مصادر البيانات.

3. اختَر إعدادات مصدر بيانات تطبيقك من علامة التبويب iOS أو Android.

   

4. انقر على ضبط إعدادات حزمة تطوير البرامج (SDK)، ثمّ ضبط "إدارة العلامات من Google" من جهة الخادم.

   

5. لتفعيل حزمة SDK لإرسال بيانات القياس إلى عنوان URL لحاوية الخادم:

   1. فعِّل الخيار إرسال البيانات إلى حاوية "إدارة العلامات من Google" من جهة الخادم.
   2. انسخ عنوان URL لحاوية الخادم. يمكنك العثور على هذا الإعداد في أداة "إدارة العلامات من Google" من خلال الانتقال إلى المشرف > إعدادات الحاوية > عناوين URL لحاويات الخادم.

   3. اختَر النسبة المئوية للزيارات التي تريد توجيهها إلى حاوية السيرفر. يمكنك اختيار خيار أقل من% 100 للتحقّق من إعدادات الخادم وضبطه قبل استخدام وضع وضع العلامات من جهة الخادم لجميع الزيارات.

      ملاحظة: استخدِم خيار "أجهزة تصحيح الأخطاء فقط" لتفعيل التطبيقات التي يتم فتحها باستخدام وضع المعاينة فقط لإرسال البيانات إلى الخادم.

   

6. انقر على حفظ. ستسترجع حزمة SDK عنوان URL المعدَّل لحاوية الخادم وستُوجّه بيانات القياس إليه.

القيود المعروفة

• بالنسبة إلى تطبيقات Android:

  • لتجنُّب الثغرات الأمنية المحتمَلة التي تتضمن حاويات الخوادم و"خدمات Google Play"، ستتمّ معالجة الأحداث من خلال خادم وكيل لا يعتمد على الحالة بين حزمة تطوير البرامج (SDK) وحاوية الخادم. سيتحقّق هذا الخادم الوكيل من مصدر الطلب ونقطة انتهائه، ولكنّه لن يفحص أي بيانات عن الأحداث أو يخزّنها. بما يتوافق مع كيفية جمع "إحصاءات Google‏ 4" للبيانات من الأجهزة في الاتحاد الأوروبي، سيكون الخادم الوكيل في الاتحاد الأوروبي للزيارات الواردة من الاتحاد الأوروبي.
  • تعتمد عمليات الشراء داخل التطبيق التي يتم تسجيلها تلقائيًا على الدمج مع الخلفية في Google Play ولن يتم إرسالها إلى حاوية الخادم.
  • لن يتم تسجيل الحدث app_remove على Android.

• لا يزال ربط مصادر بيانات تطبيقك في "إحصاءات Google" بحسابك على "إعلانات Google" ضروريًا لضمان استيراد بيانات حِزم تطوير البرامج (SDK) والإحالات الناجحة إلى "إعلانات Google". لا توفّر ميزة وضع العلامات من جهة الخادم أي دمج متأصل بين حزمة تطوير البرامج (SDK) و"إعلانات Google".

ملاحظة: تم تصميم حزمة تطوير البرامج (SDK) لخدمة "إحصاءات Google لبرنامج Firebase" وتحسينها لإرسال data إلى "إحصاءات Google‏ 4". يمكن بعد ذلك ربط "إحصاءات Google‏ 4" بخدمة "إعلانات Google" لإعداد تقارير الإحالات الناجحة وإنشاء شرائح الجمهور وتحسين الحملات و وضع النماذج. ويشمل ذلك وضع العلامات من جهة الخادم للتطبيقات، ونشجّع العملاء على الاستفادة من عملية الدمج بين "إحصاءات Google" ووضع العلامات من جهة الخادم في أداة "إدارة العلامات من Google".

واجهة برمجة التطبيقات

يمكنك استخدام Tag Manager REST API للوصول إلى data إعدادات أداة "إدارة العلامات من Google". لمزيد من المعلومات عن واجهة برمجة التطبيقات:

• يُرجى الرجوع إلى دليل المطوّر للتعرّف على كيفية استخدام واجهة برمجة التطبيقات.
• راجِع مرجع Tag Manager API للتعرّف على موارد أداة "إدارة العلامات من Google" والعمليات المتاحة.