Method: events.ingest

تحميل قائمة بموارد Event من Destination المقدَّم

طلب HTTP

POST https://datamanager.googleapis.com/v1/events:ingest

يستخدِم عنوان URL بنية تحويل الترميز إلى gRPC.

نص الطلب

يتضمن نص الطلب بيانات بالبنية التالية:

تمثيل JSON 
{
  "destinations": [
    {
      object (Destination)
    }
  ],
  "events": [
    {
      object (Event)
    }
  ],
  "consent": {
    object (Consent)
  },
  "validateOnly": boolean,
  "encoding": enum (Encoding),
  "encryptionInfo": {
    object (EncryptionInfo)
  }
}
الحقول
destinations[]

object (Destination)

الحقل مطلوب. قائمة الوجهات التي سيتم إرسال الأحداث إليها.
events[]

object (Event)

الحقل مطلوب. قائمة الأحداث المطلوب إرسالها إلى الوجهات المحدّدة يمكن إرسال 2,000 مرجع Event كحدّ أقصى في طلب واحد.
consent

object (Consent)

اختياريّ. موافقة على مستوى الطلب تنطبق على جميع المستخدمين في الطلب تتجاوز الموافقة على مستوى المستخدم الموافقة على مستوى الطلب، ويمكن تحديدها في كل Event.
validateOnly

boolean

اختياريّ. لأغراض الاختبار إذا كانت القيمة true، يتم التحقّق من صحة الطلب ولكن لا يتم تنفيذه. يتم عرض الأخطاء فقط، وليس النتائج.
encoding

enum (Encoding)

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

object (EncryptionInfo)

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

نص الاستجابة

ردّ من IngestEventsRequest

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "requestId": string
}
الحقل
requestId

string

المعرّف الذي يتم إنشاؤه تلقائيًا للطلب.

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/datamanager

الحدث

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

تمثيل JSON 
{
  "destinationReferences": [
    string
  ],
  "transactionId": string,
  "eventTimestamp": string,
  "lastUpdatedTimestamp": string,
  "userData": {
    object (UserData)
  },
  "consent": {
    object (Consent)
  },
  "adIdentifiers": {
    object (AdIdentifiers)
  },
  "currency": string,
  "eventSource": enum (EventSource),
  "eventDeviceInfo": {
    object (DeviceInfo)
  },
  "cartData": {
    object (CartData)
  },
  "customVariables": [
    {
      object (CustomVariable)
    }
  ],
  "experimentalFields": [
    {
      object (ExperimentalField)
    }
  ],
  "userProperties": {
    object (UserProperties)
  },
  "eventName": string,
  "clientId": string,
  "userId": string,
  "additionalEventParameters": [
    {
      object (EventParameter)
    }
  ],
  "thirdPartyUserData": {
    object (UserData)
  },
  "eventLocation": {
    object (EventLocation)
  },
  "appInstanceId": string,
  "conversionValue": number,
  "conversionCount": number
}
الحقول
destinationReferences[]

string

اختياريّ. سلسلة مرجعية تُستخدَم لتحديد الوجهة. إذا كان هذا الحقل فارغًا، سيتم إرسال الحدث إلى جميع destinations في الطلب.
transactionId

string

اختياريّ. المعرّف الفريد لهذا الحدث. مطلوب للأحداث التي يتم إرسالها كمصدر بيانات إضافي للإحالات الناجحة التي تحقّقها علامة التتبُّع.
eventTimestamp

string (Timestamp format)

الحقل مطلوب. الوقت الذي وقع فيه الحدث

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
lastUpdatedTimestamp

string (Timestamp format)

اختياريّ. يشير هذا الحقل إلى تاريخ آخر تعديل للحدث.

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
userData

object (UserData)

اختياريّ. أجزاء من البيانات المقدَّمة من المستخدِم، وتمثّل المستخدِم المرتبط بالحدث.
consent

object (Consent)

اختياريّ. معلومات عمّا إذا كان المستخدم المرتبط قد قدّم أنواعًا مختلفة من الموافقة.
adIdentifiers

object (AdIdentifiers)

اختياريّ. المعرّفات والمعلومات الأخرى المستخدَمة لمطابقة حدث الإحالة الناجحة مع النشاط الآخر على الإنترنت (مثل النقرات على الإعلانات)
currency

string

اختياريّ. رمز العملة المرتبط بجميع القيم النقدية ضِمن هذا الحدث.
eventSource

enum (EventSource)

اختياريّ. إشارة إلى مكان وقوع الحدث (على الويب أو في التطبيق أو داخل المتجر أو غير ذلك)
eventDeviceInfo

object (DeviceInfo)

اختياريّ. معلومات يتم جمعها عن الجهاز المستخدَم (إن وُجد) عند وقوع الحدث
cartData

object (CartData)

اختياريّ. معلومات عن المعاملة والسلع المرتبطة بالحدث
customVariables[]

object (CustomVariable)

اختياريّ. معلومات إضافية عن أزواج المفاتيح/القيم لإرسالها إلى حاويات الإحالات الناجحة (إجراء الإحالة الناجحة أو نشاط Floodlight).
experimentalFields[]

object (ExperimentalField)

اختياريّ. قائمة بأزواج المفتاح/القيمة للحقول التجريبية التي قد تتم ترقيتها في النهاية لتصبح جزءًا من واجهة برمجة التطبيقات.
userProperties

object (UserProperties)

اختياريّ. معلومات يقدّمها المعلِن عن المستخدِم في وقت وقوع الحدث.
eventName

string

اختياريّ. اسم الحدث مطلوب لأحداث "إحصاءات Google‏ 4".
clientId

string

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

string

اختياريّ. معرّف فريد للمستخدِم، كما يحدّده المعلِن.
additionalEventParameters[]

object (EventParameter)

اختياريّ. مجموعة من أي مَعلمات أحداث سيتم تضمينها في الحدث ولم يتم تحديدها من قبل باستخدام حقول منظَّمة أخرى
thirdPartyUserData

object (UserData)

اختياريّ. هو النوع نفسه من البيانات المقدَّمة في userData، ولكن يتم وضع علامة صريحة عليها للإشارة إلى أنّها مقدَّمة من جهة خارجية وليست بيانات معلِن تابع للطرف الأول.
eventLocation

object (EventLocation)

اختياريّ. معلومات تم جمعها عن الموقع الجغرافي للمستخدم عند وقوع هذا الحدث.
appInstanceId

string

اختياريّ. معرّف فريد لمثيل المستخدم من عميل تطبيق لتدفّق تطبيق GA4 هذا
conversionValue

number

اختياريّ. قيمة الإحالة الناجحة المرتبطة بالحدث، وذلك للإحالات الناجحة المستندة إلى القيمة
conversionCount

number

اختياريّ. كمية الإحالة الناجحة المرتبطة بالحدث، وذلك للإحالات الناجحة المستندة إلى العدّ

AdIdentifiers

المعرّفات والمعلومات الأخرى المستخدَمة لمطابقة حدث الإحالة الناجحة مع النشاط الآخر على الإنترنت (مثل النقرات على الإعلانات)

تمثيل JSON 
{
  "sessionAttributes": string,
  "gclid": string,
  "gbraid": string,
  "wbraid": string,
  "landingPageDeviceInfo": {
    object (DeviceInfo)
  },
  "mobileDeviceId": string,
  "dclid": string,
  "impressionId": string,
  "matchId": string,
  "encryptedUserIds": [
    {
      object (EncryptedUserId)
    }
  ]
}
الحقول
sessionAttributes

string

اختياريّ. سمات الجلسة لتحديد مصدر الأحداث ووضع نماذج لها
gclid

string

اختياريّ. معرّف النقرة من Google ‏ (gclid) المرتبط بهذا الحدث.
gbraid

string

اختياريّ. معرّف النقرة للنقرات المرتبطة بأحداث التطبيق والتي تأتي من أجهزة iOS بدءًا من الإصدار 14 من نظام التشغيل iOS
wbraid

string

اختياريّ. معرّف النقرة للنقرات المرتبطة بالأحداث على الموقع الإلكتروني والتي تأتي من أجهزة iOS بدءًا من الإصدار 14 من نظام التشغيل iOS
landingPageDeviceInfo

object (DeviceInfo)

اختياريّ. المعلومات التي يتم جمعها عن الجهاز المستخدَم (إن وُجد) عند الوصول إلى موقع المعلِن الإلكتروني بعد التفاعل مع الإعلان
mobileDeviceId

string

اختياريّ. المعرّف الإعلاني على الأجهزة الجوّالة سيكون هذا المعرّف هو معرّف المعلِنين (IDFA) على iOS أو المعرّف الإعلاني (AdID) على Android أو معرّفات المعلِنين على المنصات الأخرى.
dclid

string

اختياريّ. معرّف النقرة على الإعلان الصوري المرتبط بهذا الحدث.
impressionId

string

اختياريّ. تمثّل هذه السمة معرّف مرّة الظهور المرتبط بهذا الحدث.
matchId

string

اختياريّ. حقل رقم تعريف المطابقة المستخدَم لربط هذا الحدث بحدث سابق
encryptedUserIds[]

object (EncryptedUserId)

اختياريّ. أي عدد من أرقام تعريف المستخدمين المشفرة

DeviceInfo

معلومات عن الجهاز المستخدَم (إن وُجد) عند وقوع الحدث

تمثيل JSON 
{
  "userAgent": string,
  "ipAddress": string,
  "category": string,
  "languageCode": string,
  "screenHeight": integer,
  "screenWidth": integer,
  "operatingSystem": string,
  "operatingSystemVersion": string,
  "model": string,
  "brand": string,
  "browser": string,
  "browserVersion": string
}
الحقول
userAgent

string

اختياريّ. سلسلة وكيل المستخدم للجهاز في السياق المحدّد
ipAddress

string

اختياريّ. عنوان IP للجهاز في السياق المحدّد

ملاحظة: لا تتيح "إعلانات Google" مطابقة عناوين IP للمستخدِمين النهائيين في المنطقة الاقتصادية الأوروبية أو المملكة المتحدة أو سويسرا. أضِف منطقًا لاستبعاد مشاركة عناوين IP من المستخدِمين في هذه المناطق بشكلٍ مشروط، وتأكَّد من تزويد المستخدِمين بمعلومات واضحة وشاملة حول البيانات التي تجمعها على مواقعك الإلكترونية وتطبيقاتك والمواقع الأخرى، والحصول على موافقتهم حيثما يقتضي القانون أو أي سياسات سارية من Google. اطّلِع على صفحة لمحة عن عمليات استيراد الإحالات الناجحة غير الإلكترونية لمزيد من التفاصيل.
category

string

اختياريّ. فئة الجهاز على سبيل المثال، "كمبيوتر مكتبي" أو "جهاز لوحي" أو "جهاز جوّال" أو "تلفزيون ذكي".
languageCode

string

اختياريّ. اللغة التي يستخدمها الجهاز بتنسيق ISO 639-1
screenHeight

integer

اختياريّ. تمثّل هذه السمة ارتفاع الشاشة بالبكسل.
screenWidth

integer

اختياريّ. تمثّل هذه السمة عرض الشاشة بالبكسل.
operatingSystem

string

اختياريّ. نظام التشغيل أو النظام الأساسي للجهاز
operatingSystemVersion

string

اختياريّ. إصدار نظام التشغيل أو النظام الأساسي
model

string

اختياريّ. طراز الجهاز
brand

string

اختياريّ. تمثّل هذه السمة العلامة التجارية للجهاز.
browser

string

اختياريّ. تمثّل هذه السمة العلامة التجارية للمتصفّح أو نوعه.
browserVersion

string

اختياريّ. إصدار المتصفّح

EncryptedUserId

معرّف مستخدم يتم إصداره لاستخدامه في تحديد المصدر. يجب ملء جميع الحقول في حال استخدام هذا الخيار.

تمثيل JSON 
{
  "encryptedId": string,
  "entityType": enum (EncryptionEntityType),
  "entityId": string,
  "source": enum (EncryptionSource)
}
الحقول
encryptedId

string

الحقل مطلوب. المعرّف المشفّر الأبجدي الرقمي
entityType

enum (EncryptionEntityType)

الحقل مطلوب. نوع كيان التشفير. يجب أن يتطابق ذلك مع إعدادات التشفير لعرض الإعلانات أو "نقل البيانات".
entityId

string (int64 format)

الحقل مطلوب. رقم تعريف جهة التشفير يجب أن يتطابق ذلك مع إعدادات التشفير لعرض الإعلانات أو "نقل البيانات".
source

enum (EncryptionSource)

الحقل مطلوب. توضّح هذه السمة ما إذا كان قد تم تلقّي ملف تعريف الارتباط المشفّر من عرض الإعلانات (وحدة الماكرو %m) أو من "نقل البيانات".

EncryptionEntityType

نوع كيان التشفير.

عمليات التعداد
ENCRYPTION_ENTITY_TYPE_UNSPECIFIED نوع كيان التشفير غير محدَّد.
CAMPAIGN_MANAGER_ACCOUNT حساب على "مدير الحملة 360"
CAMPAIGN_MANAGER_ADVERTISER معلِن في "مدير الحملة 360"
DISPLAY_VIDEO_PARTNER شريك "مساحة العرض والفيديو 360"
DISPLAY_VIDEO_ADVERTISER مُعلِن على "مساحة العرض والفيديو 360"
GOOGLE_ADS_CUSTOMER عميل "إعلانات Google"
GOOGLE_AD_MANAGER_NETWORK_CODE معرِّف شبكة "إدارة إعلانات Google"

EncryptionSource

مصدر التشفير

عمليات التعداد
ENCRYPTION_SOURCE_UNSPECIFIED مصدر التشفير غير محدّد.
AD_SERVING مصدر تشفير عرض الإعلانات
DATA_TRANSFER مصدر تشفير نقل البيانات

EventSource

تمثّل هذه السمة مصدر الحدث.

عمليات التعداد
EVENT_SOURCE_UNSPECIFIED لم يتم تحديد EventSource. يجب عدم استخدامها مطلقًا.
WEB تم إنشاء الحدث من متصفّح ويب.
APP تم إنشاء الحدث من تطبيق.
IN_STORE تم إنشاء الحدث من معاملة داخل المتجر.
PHONE تم إنشاء الحدث من مكالمة هاتفية.
MESSAGE تم إنشاء الحدث من رسالة.
OTHER تم إنشاء الحدث من مصادر أخرى.

CartData

بيانات سلة التسوّق المرتبطة بالحدث.

تمثيل JSON 
{
  "merchantId": string,
  "merchantFeedLabel": string,
  "merchantFeedLanguageCode": string,
  "transactionDiscount": number,
  "items": [
    {
      object (Item)
    }
  ],
  "couponCodes": [
    string
  ]
}
الحقول
merchantId

string

اختياريّ. معرّف Merchant Center المرتبط بالسلع.
merchantFeedLabel

string

اختياريّ. تصنيف الخلاصة في Merchant Center المرتبط بخلاصة السلع
merchantFeedLanguageCode

string

اختياريّ. رمز اللغة في معيار ISO 639-1 المرتبط بخلاصة Merchant Center الخاصة بالسلع التي يتم تحميلها.
transactionDiscount

number

اختياريّ. مجموع كل الخصومات المرتبطة بالمعاملة.
items[]

object (Item)

اختياريّ. قائمة السلع المرتبطة بالحدث
couponCodes[]

string

اختياريّ. قائمة رموز القسائم التي تم تطبيقها على سلة التسوّق. رموز القسائم على مستوى سلة التسوّق وعلى مستوى السلعة مستقلة عن بعضها.

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

العنصر

تمثّل هذه السمة سلعة في سلّة التسوّق مرتبطة بالحدث.

تمثيل JSON 
{
  "merchantProductId": string,
  "quantity": string,
  "unitPrice": number,
  "itemId": string,
  "additionalItemParameters": [
    {
      object (ItemParameter)
    }
  ],
  "merchantId": string,
  "merchantFeedLabel": string,
  "merchantFeedLanguageCode": string,
  "customVariables": [
    {
      object (ItemCustomVariable)
    }
  ],
  "conversionValue": number
}
الحقول
merchantProductId

string

اختياريّ. معرّف المنتج في حساب Merchant Center
quantity

string (int64 format)

اختياريّ. عدد هذه السلعة المرتبطة بالحدث
unitPrice

number

اختياريّ. سعر الوحدة غير شامل للضرائب أو تكاليف الشحن أو أيّ خصومات على مستوى المُعاملة.
itemId

string

اختياريّ. معرّف فريد للإشارة إلى السلعة
additionalItemParameters[]

object (ItemParameter)

اختياريّ. مجموعة من أي مَعلمات أحداث ذات صلة بسلعة سيتم تضمينها في الحدث ولم يتم تحديدها من قبل باستخدام حقول منظَّمة أخرى
merchantId

string

اختياريّ. معرّف Merchant Center المرتبط بالسلعة. بالنسبة إلى أحداث "المبيعات في المتجر"، سيؤدي ذلك إلى إلغاء القيمة التي تمّ ضبطها على مستوى سلة التسوّق. ويتم تجاهل هذا الحقل للأحداث الأخرى.
merchantFeedLabel

string

اختياريّ. تصنيف الخلاصة في Merchant Center إذا كان يتم استخدام البلدان، يمكن استخدام رمز البلد المكوّن من حرفَين حسب المعيار ISO-3166-1 alpha-2 بدلاً من ذلك. بالنسبة إلى أحداث "المبيعات في المتجر"، سيؤدي ذلك إلى إلغاء القيمة التي تمّ ضبطها على مستوى سلة التسوّق. ويتم تجاهل هذا الحقل للأحداث الأخرى.
merchantFeedLanguageCode

string

اختياريّ. رمز اللغة في ISO 639-1 المرتبط بخلاصة Merchant Center التي يتم تحميل سلعك فيها
customVariables[]

object (ItemCustomVariable)

اختياريّ. معلومات إضافية عن أزواج المفاتيح والقيم لإرسالها إلى حاويات الإحالات الناجحة (إجراء الإحالة الناجحة أو نشاط Floodlight)، عند تتبُّع الإحالات الناجحة لكل عنصر.
conversionValue

number

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

ItemParameter

مجموعة من أي مَعلمات أحداث ذات صلة بسلعة سيتم تضمينها في الحدث ولم يتم تحديدها من قبل باستخدام حقول منظَّمة أخرى

تمثيل JSON 
{
  "parameterName": string,
  "value": string
}
الحقول
parameterName

string

الحقل مطلوب. اسم المَعلمة التي سيتم استخدامها.
value

string

الحقل مطلوب. تمثيل السلسلة لقيمة المَعلمة المطلوب ضبطها.

ItemCustomVariable

متغيّر مخصّص على مستوى المنتج للإحالات الناجحة من الإعلانات

تمثيل JSON 
{
  "variable": string,
  "value": string,
  "destinationReferences": [
    string
  ]
}
الحقول
variable

string

اختياريّ. اسم المتغيّر المخصّص الذي سيتمّ ضبطه. في حال عدم العثور على المتغيّر للوجهة المحدّدة، سيتم تجاهله.
value

string

اختياريّ. القيمة المطلوب تخزينها للمتغير المخصّص.
destinationReferences[]

string

اختياريّ. سلسلة مرجعية تُستخدَم لتحديد Event.destination_references التي يجب إرسال المتغيّر المخصّص إليها. إذا كان الحقل فارغًا، سيتم استخدام Event.destination_references.

المتغيّر المخصّص

متغيّر مخصّص للإحالات الناجحة من الإعلانات

تمثيل JSON 
{
  "variable": string,
  "value": string,
  "destinationReferences": [
    string
  ]
}
الحقول
variable

string

اختياريّ. اسم المتغيّر المخصّص الذي سيتمّ ضبطه. في حال عدم العثور على المتغيّر للوجهة المحدّدة، سيتم تجاهله.
value

string

اختياريّ. القيمة المطلوب تخزينها للمتغير المخصّص.
destinationReferences[]

string

اختياريّ. سلسلة مرجعية تُستخدَم لتحديد Event.destination_references التي يجب إرسال المتغيّر المخصّص إليها. إذا كان هذا الحقل فارغًا، سيتم استخدام Event.destination_references.

ExperimentalField

حقل تجريبي يمثّل الحقول غير الرسمية.

تمثيل JSON 
{
  "field": string,
  "value": string
}
الحقول
field

string

اختياريّ. اسم الحقل المطلوب استخدامه
value

string

اختياريّ. قيمة الحقل المطلوب ضبطه.

UserProperties

معلومات يقدّمها المعلِن عن المستخدِم في وقت وقوع الحدث. لمزيد من التفاصيل، يُرجى الانتقال إلى https://support.google.com/google-ads/answer/14007601.

تمثيل JSON 
{
  "customerType": enum (CustomerType),
  "customerValueBucket": enum (CustomerValueBucket),
  "additionalUserProperties": [
    {
      object (UserProperty)
    }
  ]
}
الحقول
customerType

enum (CustomerType)

اختياريّ. نوع العميل المرتبط بالحدث.
customerValueBucket

enum (CustomerValueBucket)

اختياريّ. قيمة العميل التي يحدّدها المعلِن
additionalUserProperties[]

object (UserProperty)

اختياريّ. مجموعة من أي خصائص مستخدم إضافية للمستخدم المرتبط بهذا الحدث.

CustomerType

نوع العميل المرتبط بالحدث.

عمليات التعداد
CUSTOMER_TYPE_UNSPECIFIED Unspecified CustomerType. يجب عدم استخدامها مطلقًا.
NEW العميل جديد بالنسبة إلى المعلِن.
RETURNING يعود العميل إلى المعلِن.
REENGAGED تفاعل العميل مجددًا مع المعلِن.

CustomerValueBucket

قيمة العميل التي يحدّدها المعلِن

عمليات التعداد
CUSTOMER_VALUE_BUCKET_UNSPECIFIED Unspecified CustomerValueBucket. يجب عدم استخدامها مطلقًا.
LOW العميل ذو قيمة منخفضة.
MEDIUM العميل متوسط القيمة.
HIGH العميل بارز.

UserProperty

مجموعة من أي خصائص مستخدم إضافية للمستخدم المرتبط بهذا الحدث.

تمثيل JSON 
{
  "propertyName": string,
  "value": string
}
الحقول
propertyName

string

الحقل مطلوب. اسم خاصيّة المستخدِم المطلوب استخدامها
value

string

الحقل مطلوب. تمثّل هذه السلسلة قيمة خاصية المستخدم التي سيتم استخدامها.

EventParameter

مَعلمة خاصة بالحدث لأحداث "إحصاءات Google‏ 4".

تمثيل JSON 
{
  "parameterName": string,
  "value": string
}
الحقول
parameterName

string

الحقل مطلوب. اسم المَعلمة التي سيتم استخدامها.
value

string

الحقل مطلوب. تمثيل السلسلة لقيمة المَعلمة المطلوب ضبطها.

EventLocation

تمثّل هذه السمة الموقع الجغرافي حيث وقع الحدث.

تمثيل JSON 
{
  "storeId": string,
  "city": string,
  "subdivisionCode": string,
  "regionCode": string,
  "subcontinentCode": string,
  "continentCode": string
}
الحقول
storeId

string

اختياريّ. هذه السمة مطلوبة في "مبيعات المتجر". المعرّف الذي يمثّل متجرًا فعليًا حدث فيه الحدث.
city

string

اختياريّ. اسم المدينة التي وقع فيها الحدث
subdivisionCode

string

اختياريّ. رمز التقسيم الفرعي وفقًا لمعيار ISO 3166-2 الذي حدث فيه الحدث.
regionCode

string

اختياريّ. يشير ذلك إلى رمز CLDR للمنطقة المكوّن من حرفَين الخاص بعنوان المستخدِم.
subcontinentCode

string

اختياريّ. رمز شبه القارة بتنسيق UN M49 حيث وقع الحدث
continentCode

string

اختياريّ. رمز القارة بتنسيق UN M49 حيث وقع الحدث.