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

يمكنك ضبط تطبيقاتك على الأجهزة الجوّالة باستخدام حزمة تطوير البرامج (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" />
   

   ملاحظة: يجب أن يتضمّن <APP_PACKAGE_ID> أحرفًا صغيرة فقط. تتطلّب عملية مطابقة المخططات في إطار عمل Android مراعاة حالة الأحرف، على عكس RFC.

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

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

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

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

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

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

   

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

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

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

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

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

   

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

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

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

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

عليك بعد ذلك تحديد الوقت الذي يجب فيه إطلاق علامة "إحصاءات Google‏ 4". يحلّل عميل &quot;إحصاءات Google&quot;: &quot;إحصاءات Google‏ 4&quot; (تطبيق) الطلب الوارد إلى كائن بيانات حدث، وستكتسب العلامة قيمها. لذلك، من المفترض أن يتم تفعيل العلامة كلما ادّعى عميل "إحصاءات Google‏ 4" أنّه صاحب الطلب.

لإعداد المشغّلات، اتّبِع الخطوات التالية:

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

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

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

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

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

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

      

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

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

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

   

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

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

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

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

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

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

   ملاحظة: يجب أن يبدأ رقم تعريف التطبيق بحرف. بدلاً من ذلك، يمكنك استخدام أي معرّف فريد يبدأ بحرف طالما أنّه يتطابق مع المعرّف المستخدَم في ملف Info.plist أو AndroidManifest.xml.

   

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

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

نشر الحاوية

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

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

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

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

   

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

   

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

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

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

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

   

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

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

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

  • تعتمد عمليات الشراء داخل التطبيق التي يتم تسجيلها تلقائيًا على الدمج مع خادم الخلفية في Google Play، ولن يتم إرسالها إلى حاوية الخادم.
  • لن يتم تسجيل حدث app_remove على جهاز Android.

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

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

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

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

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