إرسال خصائص المستخدمين

تصف خصائص المستخدمين شرائح قاعدة المستخدمين، مثل الإعدادات المفضّلة للغة. أو موقع جغرافي محدد. تسجِّل "إحصاءات Google" بعض خصائص المستخدمين تلقائيًا. في حال حذف كنت تريد جمع خصائص إضافية، يمكنك إعداد ما يصل إلى 25 مستخدمًا إضافيًا الخصائص لكل مشروع. اطّلِع على خصائص المستخدِمين المخصّصة لمعرفة كيفية إعداد لتسجيل خصائص المستخدمين.

تعمل خصائص المستخدِمين على تحسين تصنيف المستخدِمين إلى شرائح، ولكن بيانات خصائص المستخدِمين غالبًا ما تكون فقط. المتوفرة من جانب الخادم. يتيح لك Measurement Protocol زيادة إجراء القياسات من جانب العميل باستخدام بيانات من جانب الخادم، الأمر الذي عادةً ما يكون غير قابل للتطبيق باستخدام الحلول من جانب العميل فقط.

الأسماء المحجوزة

بعض أسماء خصائص المستخدمِين محجوزة ولا يمكن استخدامها في القياسات:

  • first_open_time
  • first_visit_time
  • last_deep_link_referrer
  • user_id
  • first_open_after_install

بالإضافة إلى ذلك، لا يمكن أن تبدأ أسماء خصائص المستخدمِين بما يلي:

  • google_
  • ga_
  • firebase_

مثال على الاستخدام

في المثال التالي، يحتوي نظام إدارة علاقات العملاء (CRM) الذي تستخدِمه على خاصيّة مستخدِم (customer_tier) التي تريد إضافتها إلى قياساتك. يمكن ضبط customer_tier على واحد من premium أو standard. للحصول على خاصيّة المستخدم هذه في تقاريرك، عليك إجراء ما يلي:

أولاً، اطلب من العميل إرسال حدث add_payment_info مع مكالمة إلى واجهة برمجة تطبيقات الخادم التي يمكنها الوصول إلى نظام إدارة علاقات العملاء:

رمز العميل

يزيد الخادم بعد ذلك القياس باستخدام خاصيّة المستخدِم "customer_tier" باستخدام Measurement Protocol:

رمز الخادم

تسجِّل خاصيّة المستخدِم هذه الشريحتَين premium وstandard.

راجع إرسال الأحداث للحصول على التفاصيل الكاملة حول كيفية إرسال الأحداث باستخدام Measurement Protocol.

الطابع الزمني للإلغاء

يستخدم Measurement Protocol الطابع الزمني الأول الذي يعثر عليه في ما يلي قائمة لكل خاصيّة مستخدم في الطلب:

  1. تمثّل هذه السمة timestamp_micros للإدخال في user_properties.
  2. تمثّل هذه السمة timestamp_micros للطلب.
  3. الوقت الذي يتلقى فيه Measurement Protocol الطلب.

يرسل المثال التالي طابعًا زمنيًا على مستوى الطلب ينطبق على جميع خصائص المستخدمين في الطلب. ونتيجةً لذلك، يعيّن Measurement Protocol كلّ من خصائص المستخدمين customer_tier وcustomer_group بطابع زمني requestUnixEpochTimeInMicros

{
  "timestamp_micros": requestUnixEpochTimeInMicros,
  "user_properties": {
      "customer_tier": {
        "value": customerTierValue
      },
      "customer_group": {
        "value": customerGroupValue
      }
  }
}

يرسل المثال التالي طابعًا زمنيًا على مستوى الطلب وطابعًا زمنيًا خاصيّة المستخدِم على customer_tier. ونتيجةً لذلك، يعيّن Measurement Protocol الطابع الزمني للحقل "customer_tier" بالقيمة "customerTierUnixEpochTimeInMicros" customer_group طابع زمني لـ requestUnixEpochTimeInMicros.

"timestamp_micros": requestUnixEpochTimeInMicros,
"user_properties": {
    "customer_tier": {
      "value": customerTierValue,
      "timestamp_micros": customerTierUnixEpochTimeInMicros
    },
    "customer_group": {
      "value": customerGroupValue
    }
}