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

تصف خصائص المستخدِمين شرائح من قاعدة المستخدِمين لديك، مثل اللغة المفضَّلة أو الموقع الجغرافي. تعمل "إحصاءات 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 مع طلب إلى واجهة برمجة تطبيقات خادم يمكنها الوصول إلى نظام إدارة علاقات العملاء:

رمز العميل

FirebaseAnalytics.logEvent("add_payment_info")
ServerAPI.addCustomerTier(
  FirebaseAnalytics.getAppInstanceId(),
  "[{name: \"add_payment_info\"}"]
);

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

رمز الخادم

const firebaseAppId = "FIREBASE_APP_ID";
const apiSecret = "API_SECRET";

function addCustomerTier(appInstanceId, events) {

  // Request the customer tier from the CRM.
  const customerTier = getCustomerTier(appInstanceId);

  const queryParams = `?firebase_app_id=${firebaseAppId}&api_secret=${apiSecret}`;
  fetch(`https://www.google-analytics.com/mp/collect${queryParams}`, {
    method: "POST",
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "app_instance_id": "APP_INSTANCE_ID",
      "user_properties": {
        "customer_tier": {
          "value": "CUSTOMER_TIER"
        }
      },
      "events": JSON.parse(events)
    })
  });
}

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

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

تجاهُل الطابع الزمني

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

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

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

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

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

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