Mengirim properti pengguna

Properti pengguna menjelaskan segmen basis pengguna Anda, seperti preferensi bahasa atau lokasi geografis. Analytics secara otomatis mencatat beberapa properti pengguna. Jika Anda ingin mengumpulkan properti tambahan, Anda dapat menyiapkan hingga 25 properti pengguna tambahan per project. Lihat Properti pengguna kustom untuk mempelajari cara menetapkan dan mendaftarkan properti pengguna.

Properti pengguna meningkatkan segmentasi pengguna, tetapi data properti pengguna sering kali hanya tersedia untuk sisi server. Measurement Protocol memungkinkan Anda meningkatkan pengukuran sisi klien dengan data sisi server, yang biasanya tidak mungkin dengan hanya menggunakan solusi sisi klien.

Nama yang dicadangkan

Beberapa nama properti pengguna dicadangkan dan tidak dapat digunakan dalam pengukuran:

  • first_open_time
  • first_visit_time
  • last_deep_link_referrer
  • user_id
  • first_open_after_install

Selain itu, nama properti pengguna tidak dapat diawali dengan:

  • google_
  • ga_
  • firebase_

Contoh penggunaan

Pada contoh berikut, CRM Anda memiliki properti pengguna (customer_tier) yang ingin Anda tambahkan ke pengukuran. customer_tier dapat ditetapkan ke salah satu premium atau standard. Untuk mendapatkan properti pengguna ini dalam laporan, Anda harus melakukan langkah berikut:

Pertama, minta klien mengirim peristiwa add_payment_info bersama dengan panggilan ke yang memiliki akses ke sistem CRM Anda:

kode klien

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

Server Anda kemudian meningkatkan pengukuran dengan properti pengguna customer_tier menggunakan Measurement Protocol:

kode server

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",
    body: JSON.stringify({
      "app_instance_id": "APP_INSTANCE_ID",
      "user_properties": {
        "customer_tier": {
          "value": "CUSTOMER_TIER"
        }
      },
      "events": JSON.parse(events)
    })
  });
}

Properti pengguna ini melaporkan dua segmen premium dan standard.

Lihat Mengirim peristiwa untuk detail selengkapnya tentang cara mengirim peristiwa menggunakan {i>Measurement Protocol<i}.

Ganti stempel waktu

Measurement Protocol menggunakan stempel waktu pertama yang ditemukannya pada untuk setiap properti pengguna dalam permintaan:

  1. timestamp_micros dari entri di user_properties.
  2. timestamp_micros permintaan.
  3. Waktu Measurement Protocol menerima permintaan.

Contoh berikut mengirimkan stempel waktu tingkat permintaan yang berlaku untuk semua properti pengguna di permintaan. Akibatnya, Measurement Protocol menetapkan properti pengguna customer_tier dan customer_group. stempel waktu requestUnixEpochTimeInMicros.

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

Contoh berikut mengirimkan stempel waktu tingkat permintaan dan stempel waktu untuk properti pengguna customer_tier. Akibatnya, Measurement Protocol menetapkan customer_tier, stempel waktu customerTierUnixEpochTimeInMicros, dan customer_group stempel waktu requestUnixEpochTimeInMicros.

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