analytics package

حزمة تطوير البرامج (SDK) على الويب لخدمة "إحصاءات Firebase" لا تعمل حزمة تطوير البرامج (SDK) هذه في بيئة Node.js.

الدوال

دالة الوصف
الدالّة(app, ...)
getAnalytics(app) عرض مثيل إحصاءات Google للتطبيق المحدّد.
إعداد "إحصاءات Google" (التطبيق، الخيارات) عرض مثيل إحصاءات Google للتطبيق المحدّد.
الدالّة(analyticsInstance, ...)
getGoogleAnalyticsClientId(analyticsInstance) استرداد معرّف "إحصاءات Google" فريد لعميل الويب. اطّلِع على client_id.
logEvent(analyticsInstance, eventName, eventParams, options) يتم إرسال حدث "إحصاءات Google" مع eventParams المحدّد. تربط هذه الطريقة تلقائيًا هذا الحدث المُسجَّل بمثيل تطبيق الويب Firebase هذا على هذا الجهاز.يمكن العثور على قائمة بمَعلمات الأحداث المُقترَحة في المستندات المرجعية لـ "إحصاءات Google 4".
logEvent(analyticsInstance, eventName, eventParams, options) يتم إرسال حدث "إحصاءات Google" مع eventParams المحدّد. تربط هذه الطريقة تلقائيًا هذا الحدث المُسجَّل بمثيل تطبيق الويب Firebase هذا على هذا الجهاز.يمكن العثور على قائمة بمَعلمات الأحداث المُقترَحة في المستندات المرجعية لـ "إحصاءات Google 4".
logEvent(analyticsInstance, eventName, eventParams, options) يتم إرسال حدث "إحصاءات Google" مع eventParams المحدّد. تربط هذه الطريقة تلقائيًا هذا الحدث المُسجَّل بمثيل تطبيق الويب Firebase هذا على هذا الجهاز.اطّلِع على تتبُّع مشاهدات الصفحة في التطبيق.
logEvent(analyticsInstance, eventName, eventParams, options) يتم إرسال حدث "إحصاءات Google" مع eventParams المحدّد. تربط هذه الطريقة تلقائيًا هذا الحدث المُسجَّل بمثيل تطبيق الويب Firebase هذا على هذا الجهاز.يمكن العثور على قائمة بمَعلمات الأحداث المُقترَحة في المستندات المرجعية لـ "إحصاءات Google 4".
logEvent(analyticsInstance, eventName, eventParams, options) يتم إرسال حدث "إحصاءات Google" مع eventParams المحدّد. تربط هذه الطريقة تلقائيًا هذا الحدث المُسجَّل بمثيل تطبيق الويب Firebase هذا على هذا الجهاز.يمكن العثور على قائمة بمَعلمات الأحداث المُقترَحة في المستندات المرجعية لـ "إحصاءات Google 4".
logEvent(analyticsInstance, eventName, eventParams, options) يتم إرسال حدث "إحصاءات Google" مع eventParams المحدّد. تربط هذه الطريقة تلقائيًا هذا الحدث المُسجَّل بمثيل تطبيق الويب Firebase هذا على هذا الجهاز.يمكن العثور على قائمة بمَعلمات الأحداث المُقترَحة في المستندات المرجعية لـ "إحصاءات Google 4".
logEvent(analyticsInstance, eventName, eventParams, options) يتم إرسال حدث "إحصاءات Google" مع eventParams المحدّد. تربط هذه الطريقة تلقائيًا هذا الحدث المُسجَّل بمثيل تطبيق الويب Firebase هذا على هذا الجهاز.يمكن العثور على قائمة بمَعلمات الأحداث المُقترَحة في المستندات المرجعية لـ "إحصاءات Google 4".
logEvent(analyticsInstance, eventName, eventParams, options) يتم إرسال حدث "إحصاءات Google" مع eventParams المحدّد. تربط هذه الطريقة تلقائيًا هذا الحدث المُسجَّل بمثيل تطبيق الويب Firebase هذا على هذا الجهاز.يمكن العثور على قائمة بمَعلمات الأحداث المُقترَحة في المستندات المرجعية لـ "إحصاءات Google 4".
logEvent(analyticsInstance, eventName, eventParams, options) يتم إرسال حدث "إحصاءات Google" مع eventParams المحدّد. تربط هذه الطريقة تلقائيًا هذا الحدث المُسجَّل بمثيل تطبيق الويب Firebase هذا على هذا الجهاز.يمكن العثور على قائمة بمَعلمات الأحداث المُقترَحة في المستندات المرجعية لـ "إحصاءات Google 4".
logEvent(analyticsInstance, eventName, eventParams, options) يتم إرسال حدث "إحصاءات Google" مع eventParams المحدّد. تربط هذه الطريقة تلقائيًا هذا الحدث المُسجَّل بمثيل تطبيق الويب Firebase هذا على هذا الجهاز.يمكن العثور على قائمة بمَعلمات الأحداث المُقترَحة في المستندات المرجعية لـ "إحصاءات Google 4".
logEvent(analyticsInstance, eventName, eventParams, options) يتم إرسال حدث "إحصاءات Google" مع eventParams المحدّد. تربط هذه الطريقة تلقائيًا هذا الحدث المُسجَّل بمثيل تطبيق الويب Firebase هذا على هذا الجهاز.يمكن العثور على قائمة بمَعلمات الأحداث المُقترَحة في المستندات المرجعية لـ "إحصاءات Google 4".
logEvent(analyticsInstance, eventName, eventParams, options) يتم إرسال حدث "إحصاءات Google" مع eventParams المحدّد. تربط هذه الطريقة تلقائيًا هذا الحدث المُسجَّل بمثيل تطبيق الويب Firebase هذا على هذا الجهاز.يمكن العثور على قائمة بمَعلمات الأحداث المُقترَحة في المستندات المرجعية لـ "إحصاءات Google 4".
logEvent(analyticsInstance, eventName, eventParams, options) يتم إرسال حدث "إحصاءات Google" مع eventParams المحدّد. تربط هذه الطريقة تلقائيًا هذا الحدث المُسجَّل بمثيل تطبيق الويب Firebase هذا على هذا الجهاز.يمكن العثور على قائمة بمَعلمات الأحداث المُقترَحة في المستندات المرجعية لـ "إحصاءات Google 4".
logEvent(analyticsInstance, eventName, eventParams, options) يتم إرسال حدث "إحصاءات Google" مع eventParams المحدّد. تربط هذه الطريقة تلقائيًا هذا الحدث المُسجَّل بمثيل تطبيق الويب Firebase هذا على هذا الجهاز.يمكن العثور على قائمة بمَعلمات الأحداث المُقترَحة في المستندات المرجعية لـ "إحصاءات Google 4".
logEvent(analyticsInstance, eventName, eventParams, options) يتم إرسال حدث "إحصاءات Google" مع eventParams المحدّد. تربط هذه الطريقة تلقائيًا هذا الحدث المُسجَّل بمثيل تطبيق الويب Firebase هذا على هذا الجهاز.يمكن العثور على قائمة بمَعلمات الأحداث المُقترَحة في المستندات المرجعية لـ "إحصاءات Google 4".
logEvent(analyticsInstance, eventName, eventParams, options) يتم إرسال حدث "إحصاءات Google" مع eventParams المحدّد. تربط هذه الطريقة تلقائيًا هذا الحدث المُسجَّل بمثيل تطبيق الويب Firebase هذا على هذا الجهاز.يمكن العثور على قائمة بمَعلمات الأحداث المُقترَحة في المستندات المرجعية لـ "إحصاءات Google 4".
logEvent(analyticsInstance, eventName, eventParams, options) يتم إرسال حدث "إحصاءات Google" مع eventParams المحدّد. تربط هذه الطريقة تلقائيًا هذا الحدث المُسجَّل بمثيل تطبيق الويب Firebase هذا على هذا الجهاز.يمكن العثور على قائمة بمَعلمات الأحداث المُقترَحة في المستندات المرجعية لـ "إحصاءات Google 4".
logEvent(analyticsInstance, eventName, eventParams, options) يتم إرسال حدث "إحصاءات Google" مع eventParams المحدّد. تربط هذه الطريقة تلقائيًا هذا الحدث المُسجَّل بمثيل تطبيق الويب Firebase هذا على هذا الجهاز.يمكن العثور على قائمة بمَعلمات الأحداث المُقترَحة في المستندات المرجعية لـ "إحصاءات Google 4".
logEvent(analyticsInstance, eventName, eventParams, options) يتم إرسال حدث "إحصاءات Google" مع eventParams المحدّد. تربط هذه الطريقة تلقائيًا هذا الحدث المُسجَّل بمثيل تطبيق الويب Firebase هذا على هذا الجهاز.يُرجى الاطّلاع على قياس الاستثناءات.
logEvent(analyticsInstance, eventName, eventParams, options) يتم إرسال حدث "إحصاءات Google" مع eventParams المحدّد. تربط هذه الطريقة تلقائيًا هذا الحدث المُسجَّل بمثيل تطبيق الويب Firebase هذا على هذا الجهاز.يمكن العثور على قائمة بمَعلمات الأحداث المُقترَحة في المستندات المرجعية لـ "إحصاءات Google 4".
logEvent(analyticsInstance, eventName, eventParams, options) يتم إرسال حدث "إحصاءات Google" مع eventParams المحدّد. تربط هذه الطريقة تلقائيًا هذا الحدث المُسجَّل بمثيل تطبيق الويب Firebase هذا على هذا الجهاز.يمكن العثور على قائمة بمَعلمات الأحداث المُقترَحة في المستندات المرجعية لـ "إحصاءات Google 4".
logEvent(analyticsInstance, eventName, eventParams, options) يتم إرسال حدث "إحصاءات Google" مع eventParams المحدّد. تربط هذه الطريقة تلقائيًا هذا الحدث المُسجَّل بمثيل تطبيق الويب Firebase هذا على هذا الجهاز.اطّلِع على مشاهدات الصفحة.
setAnalyticsCollectionEnabled(analyticsInstance, enabled) تحدِّد هذه السياسة ما إذا كان سيتم تفعيل جمع "إحصاءات Google" لهذا التطبيق على هذا الجهاز. تضبط window['ga-disable-analyticsId'] = true; على مستوى العالم
setCurrentscreen(analyticsInstance, screenName, options) استخدِم الأمر gtag config لضبط screen_name.
setUserId(analyticsInstance, id, options) استخدِم الأمر gtag config لضبط user_id.
setUserProperties(analyticsInstance, properties, options) استخدِم الأمر gtag config لضبط كل المَعلمات المحدَّدة.
دالّة()
issupported() هذه طريقة ثابتة وعامة يتم توفيرها للمستخدمين من أجل إكمال أربع عمليات تحقّق مختلفة:1. تحقَّق مما إذا لم تكن بيئة إضافة المتصفِّح. 2- تحقَّق مما إذا كانت ملفات تعريف الارتباط مفعّلة في المتصفح الحالي. 3- تحقَّق مما إذا كانت بيئة المتصفّح متوافقة مع IndexedDB. 4. تحقَّق مما إذا كان سياق المتصفِّح الحالي صالحًا لاستخدام IndexedDB.open().
الدالّة(consentSettings, ...)
setConsent(consentSettings) تحدِّد حالة موافقة المستخدم النهائي السارية لتطبيق الويب هذا في جميع مراجع gtag بعد إعداد "إحصاءات Firebase".استخدِم ConsentSettings لتحديد قيم نوع الموافقة الفردية. يتم ضبط أنواع الموافقة تلقائيًا على "ممنوحة".
الدالّة(customParams, ...)
setDefaultEventparams(customParams) تتم إضافة البيانات التي سيتم ضبطها في كل حدث يتم تسجيله من حزمة تطوير البرامج (SDK)، بما في ذلك الأحداث التلقائية. باستخدام قيمة "set" لعلامة gtag يستمر تمرير القيم في الصفحة الحالية ويتم تمريرها مع جميع الأحداث اللاحقة.
الدالّة(options, ...)
settings(options) تعمل هذه السياسة على ضبط "إحصاءات Firebase" لاستخدام أسماء gtag أو dataLayer مخصّصة. الغرض من استخدامها إذا تم تثبيت نص برمجي gtag.js على هذه الصفحة بشكل مستقل عن "إحصاءات Firebase"، ويستخدم أسماء غير تلقائية لدالة "gtag" أو لـ "dataLayer". يجب الاتصال قبل الاتصال بـ getAnalytics() وإلا لن يكون لذلك أي تأثير.

واجهات

الواجهة الوصف
إحصاءات Google مثال على "إحصاءات Firebase"
AnalyticsCallOptions الخيارات الإضافية التي يمكن تمريرها إلى طلبات طريقة "إحصاءات Google"، مثل logEvent، إلخ.
إعدادات "إحصاءات Google" خيارات إعداد مثيل إحصاءات Google.
ConsentSettings (إعدادات الموافقة) إعدادات حالة الموافقة لكل نوع من أنواع الموافقة لمزيد من المعلومات، اطّلِع على المستندات المرجعية التي تخصّ "إحصاءات Google 4" لحالة الموافقة وأنواع الموافقة.
عناصر التحكم مَعلمات التحكّم العادية الخاصة بـ "gtag.js" ولمزيد من المعلومات، اطّلِع على المستندات المرجعية في "إحصاءات Google 4".
المَعلمات المخصَّصة أي مَعلمات مخصّصة يمكن للمستخدم تمريرها إلى gtag
EventParams مَعلمات أحداث "gtag.js" العادية ولمزيد من المعلومات، اطّلِع على المستندات المرجعية في "إحصاءات Google 4".
GtagConfigParams مجموعة من الإعدادات الشائعة في "إحصاءات Google" التي يتعرّف عليها gtag.js.
السلعة النوع العادي من النوع Item في "إحصاءات Google"
العروض الترويجية الحقل سبق أن استخدمته بعض أحداث "إحصاءات Google".
خيارات الإعدادات تُحدِّد الخيارات المخصَّصة لمثيل "إحصاءات Firebase". ويجب ضبط هذه الإعدادات قبل إعداد firebase.analytics().

كتابة العناوين البديلة للبريد الإلكتروني

اكتب العنوان البديل للبريد الإلكتروني الوصف
ConsentStatusString ما إذا كان قد تم منح نوع معيّن من الموافقة أو رفضه.
العملة نوع العملة العادي في "إحصاءات Google".
CustomEventName أيّ سلسلة اسم حدث مخصّص غير مدرَجة في القائمة العادية لأسماء الأحداث المقترَحة.
EventNameString اكتب أسماء أحداث "إحصاءات Google" العادية. تقبل logEvent أيضًا أي سلسلة مخصّصة وتفسرها على أنّها اسم حدث مخصّص.

function(app, ...)

getAnalytics(app)

عرض مثيل إحصاءات Google للتطبيق المحدّد.

Signature:

export declare function getAnalytics(app?: FirebaseApp): Analytics;

المَعلمات

المعلمة النوع الوصف
التطبيق تطبيق Firebase FirebaseApp المطلوب استخدامه.

المرتجعات:

إحصاءات Google

startizeAnalytics(app, options)

عرض مثيل إحصاءات Google للتطبيق المحدّد.

Signature:

export declare function initializeAnalytics(app: FirebaseApp, options?: AnalyticsSettings): Analytics;

المَعلمات

المعلمة النوع الوصف
التطبيق تطبيق Firebase FirebaseApp المطلوب استخدامه.
خيارات إعدادات "إحصاءات Google"

المرتجعات:

إحصاءات Google

function(analyticsInstance, ...)

getGoogleAnalyticsClientId(analyticsInstance)

استرداد معرّف "إحصاءات Google" فريد لعميل الويب. اطّلِع على client_id.

Signature:

export declare function getGoogleAnalyticsClientId(analyticsInstance: Analytics): Promise<string>;

المَعلمات

المعلمة النوع الوصف
مثيل التحليلات إحصاءات Google

المرتجعات:

وعود<string>

LogEvent(analyticsInstance, eventName, eventParams, options)

تُرسِل حدث "إحصاءات Google" مع eventParams المحدّد. تربط هذه الطريقة تلقائيًا هذا الحدث المُسجَّل بمثيل تطبيق الويب Firebase هذا على هذا الجهاز.

يمكن العثور على قائمة مَعلمات الأحداث المقترَحة في المستندات المرجعية في "إحصاءات Google 4".

Signature:

export declare function logEvent(analyticsInstance: Analytics, eventName: 'add_payment_info', eventParams?: {
    coupon?: EventParams['coupon'];
    currency?: EventParams['currency'];
    items?: EventParams['items'];
    payment_type?: EventParams['payment_type'];
    value?: EventParams['value'];
    [key: string]: any;
}, options?: AnalyticsCallOptions): void;

المَعلمات

المعلمة النوع الوصف
مثيل التحليلات إحصاءات Google
اسم الحدث "add_payment_info"
إدارة الأحداث { القسيمة؟: EventParams['coupon']; العملة؟: EventParams['currency']; ؟: EventParams['items']; payment_type?: EventParams['payment_type']; ؟: EventParams['value']; [key: string]: any; }
خيارات AnalyticsCallOptions

المرتجعات:

فراغ

LogEvent(analyticsInstance, eventName, eventParams, options)

تُرسِل حدث "إحصاءات Google" مع eventParams المحدّد. تربط هذه الطريقة تلقائيًا هذا الحدث المُسجَّل بمثيل تطبيق الويب Firebase هذا على هذا الجهاز.

يمكن العثور على قائمة مَعلمات الأحداث المقترَحة في المستندات المرجعية في "إحصاءات Google 4".

Signature:

export declare function logEvent(analyticsInstance: Analytics, eventName: 'purchase' | 'refund', eventParams?: {
    value?: EventParams['value'];
    currency?: EventParams['currency'];
    transaction_id: EventParams['transaction_id'];
    tax?: EventParams['tax'];
    shipping?: EventParams['shipping'];
    items?: EventParams['items'];
    coupon?: EventParams['coupon'];
    affiliation?: EventParams['affiliation'];
    [key: string]: any;
}, options?: AnalyticsCallOptions): void;

المَعلمات

المعلمة النوع الوصف
مثيل التحليلات إحصاءات Google
اسم الحدث "purchase" | "ردّ الأموال"
إدارة الأحداث { value?: EventParams['value']; العملة؟: EventParams['currency']; transaction_id: EventParams['transaction_id']; الضريبة؟: EventParams['tax']; الشحن؟: EventParams['shipping']; ؟: EventParams['items']; القسيمة؟: EventParams['coupon']; الشركة؟: EventParams['affiliation']; [key: string]: any; }
خيارات AnalyticsCallOptions

المرتجعات:

فراغ

LogEvent(analyticsInstance, eventName, eventParams, options)

تُرسِل حدث "إحصاءات Google" مع eventParams المحدّد. تربط هذه الطريقة تلقائيًا هذا الحدث المُسجَّل بمثيل تطبيق الويب Firebase هذا على هذا الجهاز.

راجِع تتبُّع مشاهدات الصفحة في التطبيق.

Signature:

export declare function logEvent(analyticsInstance: Analytics, eventName: 'screen_view', eventParams?: {
    firebase_screen: EventParams['firebase_screen'];
    firebase_screen_class: EventParams['firebase_screen_class'];
    [key: string]: any;
}, options?: AnalyticsCallOptions): void;

المَعلمات

المعلمة النوع الوصف
مثيل التحليلات إحصاءات Google
اسم الحدث 'screen_view'
إدارة الأحداث { firebase_screen: EventParams['firebase_screen']; firebase_screen_class: EventParams['firebase_screen_class']; [key: string]: any; }
خيارات AnalyticsCallOptions

المرتجعات:

فراغ

LogEvent(analyticsInstance, eventName, eventParams, options)

تُرسِل حدث "إحصاءات Google" مع eventParams المحدّد. تربط هذه الطريقة تلقائيًا هذا الحدث المُسجَّل بمثيل تطبيق الويب Firebase هذا على هذا الجهاز.

يمكن العثور على قائمة مَعلمات الأحداث المقترَحة في المستندات المرجعية في "إحصاءات Google 4".

Signature:

export declare function logEvent(analyticsInstance: Analytics, eventName: 'search' | 'view_search_results', eventParams?: {
    search_term?: EventParams['search_term'];
    [key: string]: any;
}, options?: AnalyticsCallOptions): void;

المَعلمات

المعلمة النوع الوصف
مثيل التحليلات إحصاءات Google
اسم الحدث "بحث" | "view_search_results'"
إدارة الأحداث { search_term?: EventParams['search_term']; [key: string]: any; }
خيارات AnalyticsCallOptions

المرتجعات:

فراغ

LogEvent(analyticsInstance, eventName, eventParams, options)

تُرسِل حدث "إحصاءات Google" مع eventParams المحدّد. تربط هذه الطريقة تلقائيًا هذا الحدث المُسجَّل بمثيل تطبيق الويب Firebase هذا على هذا الجهاز.

يمكن العثور على قائمة مَعلمات الأحداث المقترَحة في المستندات المرجعية في "إحصاءات Google 4".

Signature:

export declare function logEvent(analyticsInstance: Analytics, eventName: 'select_content', eventParams?: {
    content_type?: EventParams['content_type'];
    item_id?: EventParams['item_id'];
    [key: string]: any;
}, options?: AnalyticsCallOptions): void;

المَعلمات

المعلمة النوع الوصف
مثيل التحليلات إحصاءات Google
اسم الحدث "select_content"
إدارة الأحداث { content_type?: EventParams['content_type']; item_id?: EventParams['item_id']; [key: string]: any; }
خيارات AnalyticsCallOptions

المرتجعات:

فراغ

LogEvent(analyticsInstance, eventName, eventParams, options)

تُرسِل حدث "إحصاءات Google" مع eventParams المحدّد. تربط هذه الطريقة تلقائيًا هذا الحدث المُسجَّل بمثيل تطبيق الويب Firebase هذا على هذا الجهاز.

يمكن العثور على قائمة مَعلمات الأحداث المقترَحة في المستندات المرجعية في "إحصاءات Google 4".

Signature:

export declare function logEvent(analyticsInstance: Analytics, eventName: 'select_item', eventParams?: {
    items?: EventParams['items'];
    item_list_name?: EventParams['item_list_name'];
    item_list_id?: EventParams['item_list_id'];
    [key: string]: any;
}, options?: AnalyticsCallOptions): void;

المَعلمات

المعلمة النوع الوصف
مثيل التحليلات إحصاءات Google
اسم الحدث "select_item"
إدارة الأحداث { عنصر؟: EventParams['items']; item_list_name?: EventParams['item_list_name']; item_list_id?: EventParams['item_list_id']; [key: string]: any; }
خيارات AnalyticsCallOptions

المرتجعات:

فراغ

LogEvent(analyticsInstance, eventName, eventParams, options)

تُرسِل حدث "إحصاءات Google" مع eventParams المحدّد. تربط هذه الطريقة تلقائيًا هذا الحدث المُسجَّل بمثيل تطبيق الويب Firebase هذا على هذا الجهاز.

يمكن العثور على قائمة مَعلمات الأحداث المقترَحة في المستندات المرجعية في "إحصاءات Google 4".

Signature:

export declare function logEvent(analyticsInstance: Analytics, eventName: 'select_promotion' | 'view_promotion', eventParams?: {
    items?: EventParams['items'];
    promotion_id?: EventParams['promotion_id'];
    promotion_name?: EventParams['promotion_name'];
    [key: string]: any;
}, options?: AnalyticsCallOptions): void;

المَعلمات

المعلمة النوع الوصف
مثيل التحليلات إحصاءات Google
اسم الحدث "select_promotion" | 'view_promotion'
إدارة الأحداث { عنصر؟: EventParams['items']; promotion_id?: EventParams['promotion_id']; promotion_name?: EventParams['promotion_name']; [key: string]: any; }
خيارات AnalyticsCallOptions

المرتجعات:

فراغ

LogEvent(analyticsInstance, eventName, eventParams, options)

تُرسِل حدث "إحصاءات Google" مع eventParams المحدّد. تربط هذه الطريقة تلقائيًا هذا الحدث المُسجَّل بمثيل تطبيق الويب Firebase هذا على هذا الجهاز.

يمكن العثور على قائمة مَعلمات الأحداث المقترَحة في المستندات المرجعية في "إحصاءات Google 4".

Signature:

export declare function logEvent(analyticsInstance: Analytics, eventName: 'set_checkout_option', eventParams?: {
    checkout_step?: EventParams['checkout_step'];
    checkout_option?: EventParams['checkout_option'];
    [key: string]: any;
}, options?: AnalyticsCallOptions): void;

المَعلمات

المعلمة النوع الوصف
مثيل التحليلات إحصاءات Google
اسم الحدث 'set_checkout_option'
إدارة الأحداث { Checkout_step?: EventParams['checkout_step']; Checkout_option?: EventParams['checkout_option']; [key: string]: any; }
خيارات AnalyticsCallOptions

المرتجعات:

فراغ

LogEvent(analyticsInstance, eventName, eventParams, options)

تُرسِل حدث "إحصاءات Google" مع eventParams المحدّد. تربط هذه الطريقة تلقائيًا هذا الحدث المُسجَّل بمثيل تطبيق الويب Firebase هذا على هذا الجهاز.

يمكن العثور على قائمة مَعلمات الأحداث المقترَحة في المستندات المرجعية في "إحصاءات Google 4".

Signature:

export declare function logEvent(analyticsInstance: Analytics, eventName: 'share', eventParams?: {
    method?: EventParams['method'];
    content_type?: EventParams['content_type'];
    item_id?: EventParams['item_id'];
    [key: string]: any;
}, options?: AnalyticsCallOptions): void;

المَعلمات

المعلمة النوع الوصف
مثيل التحليلات إحصاءات Google
اسم الحدث "مشاركة"
إدارة الأحداث { الطريقة?: EventParams['method']; content_type?: EventParams['content_type']; item_id?: EventParams['item_id']; [key: string]: any; }
خيارات AnalyticsCallOptions

المرتجعات:

فراغ

LogEvent(analyticsInstance, eventName, eventParams, options)

تُرسِل حدث "إحصاءات Google" مع eventParams المحدّد. تربط هذه الطريقة تلقائيًا هذا الحدث المُسجَّل بمثيل تطبيق الويب Firebase هذا على هذا الجهاز.

يمكن العثور على قائمة مَعلمات الأحداث المقترَحة في المستندات المرجعية في "إحصاءات Google 4".

Signature:

export declare function logEvent(analyticsInstance: Analytics, eventName: 'sign_up', eventParams?: {
    method?: EventParams['method'];
    [key: string]: any;
}, options?: AnalyticsCallOptions): void;

المَعلمات

المعلمة النوع الوصف
مثيل التحليلات إحصاءات Google
اسم الحدث 'sign_up'
إدارة الأحداث { الطريقة?: EventParams['method']; [key: string]: any; }
خيارات AnalyticsCallOptions

المرتجعات:

فراغ

LogEvent(analyticsInstance, eventName, eventParams, options)

تُرسِل حدث "إحصاءات Google" مع eventParams المحدّد. تربط هذه الطريقة تلقائيًا هذا الحدث المُسجَّل بمثيل تطبيق الويب Firebase هذا على هذا الجهاز.

يمكن العثور على قائمة مَعلمات الأحداث المقترَحة في المستندات المرجعية في "إحصاءات Google 4".

Signature:

export declare function logEvent(analyticsInstance: Analytics, eventName: 'timing_complete', eventParams?: {
    name: string;
    value: number;
    event_category?: string;
    event_label?: string;
    [key: string]: any;
}, options?: AnalyticsCallOptions): void;

المَعلمات

المعلمة النوع الوصف
مثيل التحليلات إحصاءات Google
اسم الحدث "إكمال_الوقت"
إدارة الأحداث { الاسم: سلسلة؛ value: رقم؛ event_category?: string; event_label?: string; [key: string]: any; }
خيارات AnalyticsCallOptions

المرتجعات:

فراغ

LogEvent(analyticsInstance, eventName, eventParams, options)

تُرسِل حدث "إحصاءات Google" مع eventParams المحدّد. تربط هذه الطريقة تلقائيًا هذا الحدث المُسجَّل بمثيل تطبيق الويب Firebase هذا على هذا الجهاز.

يمكن العثور على قائمة مَعلمات الأحداث المقترَحة في المستندات المرجعية في "إحصاءات Google 4".

Signature:

export declare function logEvent(analyticsInstance: Analytics, eventName: 'add_shipping_info', eventParams?: {
    coupon?: EventParams['coupon'];
    currency?: EventParams['currency'];
    items?: EventParams['items'];
    shipping_tier?: EventParams['shipping_tier'];
    value?: EventParams['value'];
    [key: string]: any;
}, options?: AnalyticsCallOptions): void;

المَعلمات

المعلمة النوع الوصف
مثيل التحليلات إحصاءات Google
اسم الحدث "add_shipping_info"
إدارة الأحداث { القسيمة؟: EventParams['coupon']; العملة؟: EventParams['currency']; ؟: EventParams['items']; shipping_tier?: EventParams['shipping_tier']; ؟: EventParams['value']; [key: string]: any; }
خيارات AnalyticsCallOptions

المرتجعات:

فراغ

LogEvent(analyticsInstance, eventName, eventParams, options)

تُرسِل حدث "إحصاءات Google" مع eventParams المحدّد. تربط هذه الطريقة تلقائيًا هذا الحدث المُسجَّل بمثيل تطبيق الويب Firebase هذا على هذا الجهاز.

يمكن العثور على قائمة مَعلمات الأحداث المقترَحة في المستندات المرجعية في "إحصاءات Google 4".

Signature:

export declare function logEvent(analyticsInstance: Analytics, eventName: 'view_cart' | 'view_item', eventParams?: {
    currency?: EventParams['currency'];
    items?: EventParams['items'];
    value?: EventParams['value'];
    [key: string]: any;
}, options?: AnalyticsCallOptions): void;

المَعلمات

المعلمة النوع الوصف
مثيل التحليلات إحصاءات Google
اسم الحدث 'view_cart' | "view_item"
إدارة الأحداث { العملة؟: EventParams['currency']; ؟: EventParams['items']; ؟: EventParams['value']; [key: string]: any; }
خيارات AnalyticsCallOptions

المرتجعات:

فراغ

LogEvent(analyticsInstance, eventName, eventParams, options)

تُرسِل حدث "إحصاءات Google" مع eventParams المحدّد. تربط هذه الطريقة تلقائيًا هذا الحدث المُسجَّل بمثيل تطبيق الويب Firebase هذا على هذا الجهاز.

يمكن العثور على قائمة مَعلمات الأحداث المقترَحة في المستندات المرجعية في "إحصاءات Google 4".

Signature:

export declare function logEvent(analyticsInstance: Analytics, eventName: 'view_item_list', eventParams?: {
    items?: EventParams['items'];
    item_list_name?: EventParams['item_list_name'];
    item_list_id?: EventParams['item_list_id'];
    [key: string]: any;
}, options?: AnalyticsCallOptions): void;

المَعلمات

المعلمة النوع الوصف
مثيل التحليلات إحصاءات Google
اسم الحدث 'view_item_list'
إدارة الأحداث { عنصر؟: EventParams['items']; item_list_name?: EventParams['item_list_name']; item_list_id?: EventParams['item_list_id']; [key: string]: any; }
خيارات AnalyticsCallOptions

المرتجعات:

فراغ

LogEvent(analyticsInstance, eventName, eventParams, options)

تُرسِل حدث "إحصاءات Google" مع eventParams المحدّد. تربط هذه الطريقة تلقائيًا هذا الحدث المُسجَّل بمثيل تطبيق الويب Firebase هذا على هذا الجهاز.

يمكن العثور على قائمة مَعلمات الأحداث المقترَحة في المستندات المرجعية في "إحصاءات Google 4".

Signature:

export declare function logEvent<T extends string>(analyticsInstance: Analytics, eventName: CustomEventName<T>, eventParams?: {
    [key: string]: any;
}, options?: AnalyticsCallOptions): void;

المَعلمات

المعلمة النوع الوصف
مثيل التحليلات إحصاءات Google
اسم الحدث CustomEventName <T>
إدارة الأحداث { [key: string]: any; }
خيارات AnalyticsCallOptions

المرتجعات:

فراغ

LogEvent(analyticsInstance, eventName, eventParams, options)

تُرسِل حدث "إحصاءات Google" مع eventParams المحدّد. تربط هذه الطريقة تلقائيًا هذا الحدث المُسجَّل بمثيل تطبيق الويب Firebase هذا على هذا الجهاز.

يمكن العثور على قائمة مَعلمات الأحداث المقترَحة في المستندات المرجعية في "إحصاءات Google 4".

Signature:

export declare function logEvent(analyticsInstance: Analytics, eventName: 'add_to_cart' | 'add_to_wishlist' | 'remove_from_cart', eventParams?: {
    currency?: EventParams['currency'];
    value?: EventParams['value'];
    items?: EventParams['items'];
    [key: string]: any;
}, options?: AnalyticsCallOptions): void;

المَعلمات

المعلمة النوع الوصف
مثيل التحليلات إحصاءات Google
اسم الحدث "add_to_cart" | 'add_to_wishlist' | 'remove_from_cart'
إدارة الأحداث { العملة؟: EventParams['currency']; ؟: EventParams['value']; ؟: EventParams['items']; [key: string]: any; }
خيارات AnalyticsCallOptions

المرتجعات:

فراغ

LogEvent(analyticsInstance, eventName, eventParams, options)

تُرسِل حدث "إحصاءات Google" مع eventParams المحدّد. تربط هذه الطريقة تلقائيًا هذا الحدث المُسجَّل بمثيل تطبيق الويب Firebase هذا على هذا الجهاز.

يمكن العثور على قائمة مَعلمات الأحداث المقترَحة في المستندات المرجعية في "إحصاءات Google 4".

Signature:

export declare function logEvent(analyticsInstance: Analytics, eventName: 'begin_checkout', eventParams?: {
    currency?: EventParams['currency'];
    coupon?: EventParams['coupon'];
    value?: EventParams['value'];
    items?: EventParams['items'];
    [key: string]: any;
}, options?: AnalyticsCallOptions): void;

المَعلمات

المعلمة النوع الوصف
مثيل التحليلات إحصاءات Google
اسم الحدث 'begin_checkout'
إدارة الأحداث { العملة؟: EventParams['currency']; القسيمة؟: EventParams['coupon']; ؟: EventParams['value']; ؟: EventParams['items']; [key: string]: any; }
خيارات AnalyticsCallOptions

المرتجعات:

فراغ

LogEvent(analyticsInstance, eventName, eventParams, options)

تُرسِل حدث "إحصاءات Google" مع eventParams المحدّد. تربط هذه الطريقة تلقائيًا هذا الحدث المُسجَّل بمثيل تطبيق الويب Firebase هذا على هذا الجهاز.

يمكن العثور على قائمة مَعلمات الأحداث المقترَحة في المستندات المرجعية في "إحصاءات Google 4".

Signature:

export declare function logEvent(analyticsInstance: Analytics, eventName: 'checkout_progress', eventParams?: {
    currency?: EventParams['currency'];
    coupon?: EventParams['coupon'];
    value?: EventParams['value'];
    items?: EventParams['items'];
    checkout_step?: EventParams['checkout_step'];
    checkout_option?: EventParams['checkout_option'];
    [key: string]: any;
}, options?: AnalyticsCallOptions): void;

المَعلمات

المعلمة النوع الوصف
مثيل التحليلات إحصاءات Google
اسم الحدث "checkout_progress"
إدارة الأحداث { العملة؟: EventParams['currency']; القسيمة؟: EventParams['coupon']; ؟: EventParams['value']; ؟: EventParams['items']; Checkout_step?: EventParams['checkout_step']; Checkout_option?: EventParams['checkout_option']; [key: string]: any; }
خيارات AnalyticsCallOptions

المرتجعات:

فراغ

LogEvent(analyticsInstance, eventName, eventParams, options)

تُرسِل حدث "إحصاءات Google" مع eventParams المحدّد. تربط هذه الطريقة تلقائيًا هذا الحدث المُسجَّل بمثيل تطبيق الويب Firebase هذا على هذا الجهاز.

راجِع قياس الاستثناءات.

Signature:

export declare function logEvent(analyticsInstance: Analytics, eventName: 'exception', eventParams?: {
    description?: EventParams['description'];
    fatal?: EventParams['fatal'];
    [key: string]: any;
}, options?: AnalyticsCallOptions): void;

المَعلمات

المعلمة النوع الوصف
مثيل التحليلات إحصاءات Google
اسم الحدث "استثناء"
إدارة الأحداث { الوصف؟: EventParams['description']; فادحة؟: EventParams['fatal']; [key: string]: any; }
خيارات AnalyticsCallOptions

المرتجعات:

فراغ

LogEvent(analyticsInstance, eventName, eventParams, options)

تُرسِل حدث "إحصاءات Google" مع eventParams المحدّد. تربط هذه الطريقة تلقائيًا هذا الحدث المُسجَّل بمثيل تطبيق الويب Firebase هذا على هذا الجهاز.

يمكن العثور على قائمة مَعلمات الأحداث المقترَحة في المستندات المرجعية في "إحصاءات Google 4".

Signature:

export declare function logEvent(analyticsInstance: Analytics, eventName: 'generate_lead', eventParams?: {
    value?: EventParams['value'];
    currency?: EventParams['currency'];
    [key: string]: any;
}, options?: AnalyticsCallOptions): void;

المَعلمات

المعلمة النوع الوصف
مثيل التحليلات إحصاءات Google
اسم الحدث "generate_lead"
إدارة الأحداث { value?: EventParams['value']; العملة؟: EventParams['currency']; [key: string]: any; }
خيارات AnalyticsCallOptions

المرتجعات:

فراغ

LogEvent(analyticsInstance, eventName, eventParams, options)

تُرسِل حدث "إحصاءات Google" مع eventParams المحدّد. تربط هذه الطريقة تلقائيًا هذا الحدث المُسجَّل بمثيل تطبيق الويب Firebase هذا على هذا الجهاز.

يمكن العثور على قائمة مَعلمات الأحداث المقترَحة في المستندات المرجعية في "إحصاءات Google 4".

Signature:

export declare function logEvent(analyticsInstance: Analytics, eventName: 'login', eventParams?: {
    method?: EventParams['method'];
    [key: string]: any;
}, options?: AnalyticsCallOptions): void;

المَعلمات

المعلمة النوع الوصف
مثيل التحليلات إحصاءات Google
اسم الحدث "تسجيل الدخول"
إدارة الأحداث { الطريقة?: EventParams['method']; [key: string]: any; }
خيارات AnalyticsCallOptions

المرتجعات:

فراغ

LogEvent(analyticsInstance, eventName, eventParams, options)

تُرسِل حدث "إحصاءات Google" مع eventParams المحدّد. تربط هذه الطريقة تلقائيًا هذا الحدث المُسجَّل بمثيل تطبيق الويب Firebase هذا على هذا الجهاز.

اطّلِع على مشاهدات الصفحة على الويب.

Signature:

export declare function logEvent(analyticsInstance: Analytics, eventName: 'page_view', eventParams?: {
    page_title?: string;
    page_location?: string;
    page_path?: string;
    [key: string]: any;
}, options?: AnalyticsCallOptions): void;

المَعلمات

المعلمة النوع الوصف
مثيل التحليلات إحصاءات Google
اسم الحدث "page_view"
إدارة الأحداث { page_title?: سلسلة؛ page_location?: string; page_path?: string; [key: string]: any; }
خيارات AnalyticsCallOptions

المرتجعات:

فراغ

setAnalyticsCollectionEnabled(analyticsInstance, enabled)

تحدِّد هذه السياسة ما إذا كان سيتم تفعيل جمع "إحصاءات Google" لهذا التطبيق على هذا الجهاز. تضبط window['ga-disable-analyticsId'] = true; على مستوى العالم

Signature:

export declare function setAnalyticsCollectionEnabled(analyticsInstance: Analytics, enabled: boolean): void;

المَعلمات

المعلمة النوع الوصف
مثيل التحليلات إحصاءات Google مثيل إحصاءات Google
ممكّنة قيمة منطقية في حال اختيار القيمة "صحيح"، سيتم تفعيل جمع البيانات، وفي حال كانت القيمة "خطأ"، سيتم إيقافها.

المرتجعات:

فراغ

setCurrentscreen(analyticsInstance, screenName, options)

الاستخدام مع "eventName" كـ screen_view وإضافة eventParams ذات صلة راجِع تتبُّع مشاهدات الصفحة في التطبيق.

استخدِم الأمر gtag config لضبط screen_name.

Signature:

export declare function setCurrentScreen(analyticsInstance: Analytics, screenName: string, options?: AnalyticsCallOptions): void;

المَعلمات

المعلمة النوع الوصف
مثيل التحليلات إحصاءات Google مثيل إحصاءات Google
اسم الشاشة السلسلة اسم الشاشة المطلوب ضبطه
خيارات AnalyticsCallOptions

المرتجعات:

فراغ

setUserId(analyticsInstance, id, options)

استخدِم الأمر gtag config لضبط user_id.

Signature:

export declare function setUserId(analyticsInstance: Analytics, id: string | null, options?: AnalyticsCallOptions): void;

المَعلمات

المعلمة النوع الوصف
مثيل التحليلات إحصاءات Google مثيل إحصاءات Google
id سلسلة | فارغ رقم تعريف المستخدم المطلوب ضبطه
خيارات AnalyticsCallOptions

المرتجعات:

فراغ

setUserProperties(analyticsInstance, properties, options)

استخدِم الأمر gtag config لضبط كل المَعلمات المحدَّدة.

Signature:

export declare function setUserProperties(analyticsInstance: Analytics, properties: CustomParams, options?: AnalyticsCallOptions): void;

المَعلمات

المعلمة النوع الوصف
مثيل التحليلات إحصاءات Google
المواقع المَعلمات المخصَّصة
خيارات AnalyticsCallOptions

المرتجعات:

فراغ

الدالة()

issupported()

هذه طريقة ثابتة عامة يتم توفيرها للمستخدمين والتي تتضمن أربع عمليات تحقق مختلفة:

  1. تحقَّق مما إذا لم تكن هذه البيئة ضِمن بيئة إضافة المتصفِّح. 2- تحقَّق من تفعيل ملفات تعريف الارتباط في المتصفّح الحالي. 3- تحقَّق مما إذا كانت بيئة المتصفّح متوافقة مع IndexedDB. 4. تحقَّق مما إذا كان سياق المتصفِّح الحالي صالحًا لاستخدام IndexedDB.open().

Signature:

export declare function isSupported(): Promise<boolean>;

المرتجعات:

Promise&lt;boolean&gt;

function(consentSettings, ...)

setConsent(consentSettings)

تضبط حالة موافقة المستخدِم النهائي السارية لتطبيق الويب هذا في جميع مراجع gtag بعد إعداد "إحصاءات Firebase".

استخدِم ConsentSettings لتحديد قيم أنواع الموافقة الفردية. يتم ضبط أنواع الموافقة تلقائيًا على "ممنوحة".

Signature:

export declare function setConsent(consentSettings: ConsentSettings): void;

المَعلمات

المعلمة النوع الوصف
إعدادات الموافقة ConsentSettings (إعدادات الموافقة) تربط حالة موافقة المستخدم النهائي السارية على gtag.js.

المرتجعات:

فراغ

function(customParams, ...)

setDefaultEventparams(customParams)

تتم إضافة البيانات التي سيتم ضبطها في كل حدث يتم تسجيله من حزمة تطوير البرامج (SDK)، بما في ذلك الأحداث التلقائية. باستخدام قيمة "set" لعلامة gtag يستمر تمرير القيم في الصفحة الحالية ويتم تمريرها مع جميع الأحداث اللاحقة.

Signature:

export declare function setDefaultEventParameters(customParams: CustomParams): void;

المَعلمات

المعلمة النوع الوصف
مَعلمات مخصّصة المَعلمات المخصَّصة أي مَعلمات مخصّصة يمكن للمستخدم تمريرها إلى gtag.js.

المرتجعات:

فراغ

الدالة(options, ...)

الإعدادات(خيارات)

تعمل هذه السياسة على ضبط "إحصاءات Firebase" لاستخدام أسماء gtag أو dataLayer مخصّصة. الغرض من استخدامها إذا تم تثبيت نص برمجي gtag.js على هذه الصفحة بشكلٍ مستقل عن "إحصاءات Firebase"، ويستخدم أسماء غير تلقائية إما لدالة gtag أو لـ dataLayer. يجب الاتصال قبل الاتصال بـ getAnalytics() وإلا لن يكون لذلك أي تأثير.

Signature:

export declare function settings(options: SettingsOptions): void;

المَعلمات

المعلمة النوع الوصف
خيارات خيارات الإعدادات أسماء gtag وdataLayer المخصصة.

المرتجعات:

فراغ

ConsentStatusString

ما إذا كان قد تم منح نوع معيّن من الموافقة أو رفضه.

Signature:

export declare type ConsentStatusString = 'granted' | 'denied';

العملة

نوع العملة العادي في "إحصاءات Google".

Signature:

export declare type Currency = string | number;

اسم الحدث المخصص

أيّ سلسلة اسم حدث مخصّص غير مدرَجة في القائمة العادية لأسماء الأحداث المقترَحة.

Signature:

export declare type CustomEventName<T> = T extends EventNameString ? never : T;

سلسلة EventNameString

اكتب أسماء أحداث "إحصاءات Google" العادية. تقبل logEvent أيضًا أي سلسلة مخصّصة وتفسرها على أنّها اسم حدث مخصّص.

Signature:

export declare type EventNameString = 'add_payment_info' | 'add_shipping_info' | 'add_to_cart' | 'add_to_wishlist' | 'begin_checkout' | 'checkout_progress' | 'exception' | 'generate_lead' | 'login' | 'page_view' | 'purchase' | 'refund' | 'remove_from_cart' | 'screen_view' | 'search' | 'select_content' | 'select_item' | 'select_promotion' | 'set_checkout_option' | 'share' | 'sign_up' | 'timing_complete' | 'view_cart' | 'view_item' | 'view_item_list' | 'view_promotion' | 'view_search_results';