تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

التجارة الإلكترونية المحسَّنة في Universal Analytics لنظام التشغيل Android

تتيح "إحصاءات Google" استخدام التجارة الإلكترونية المحسَّنة في مواقع Universal Analytics. تتيح التجارة الإلكترونية المحسّنة قياس تفاعلات المستخدم مع المنتجات عبر تجربة التسوق الخاصة به. ويمكن أن يشمل ذلك مرّات ظهور العرض الترويجي، والنقرات على العرض الترويجي، ومرات ظهور المنتجات، والنقرات على المنتجات، ومشاهدات تفاصيل المنتج، وإضافة سلع إلى سلة التسوّق، وإزالة سلع من سلة التسوّق، وبدء عمليات الدفع، والمعاملات، وعمليات ردّ الأموال.

يعمل أحدث إصدار من "إدارة العلامات من Google" و"إحصاءات Google" لتطبيقات الأجهزة الجوّالة مع Firebase، وهو النظام الأساسي لتطبيقات الأجهزة الجوّالة من Google. عند قياس التطبيقات باستخدام حزمة تطوير البرامج (SDK) لمنصّة Firebase، ستتمكّن من الوصول إلى مجموعة كبيرة من تقارير التطبيقات المتوافقة مع الأجهزة الجوّالة التي تمّ إنشاؤها تلقائيًا، والتي يمكن تخصيصها وإضافتها إلى رمز داخل التطبيق. ستتضمّن هذه التقارير تلقائيًا بيانات حول عمليات الشراء داخل التطبيق التي تتم معالجتها في App Store على iTunes وGoogle Play. يمكن إنشاء تقارير إضافية مرتبطة بالتجارة الإلكترونية من خلال تنفيذ الأحداث المقترَحة لتطبيقات التجارة الإلكترونية. لا تتوفر التقارير المتعمقة عن سلوك التسوق (أي التجارة الإلكترونية المحسَّنة) حاليًا إلا في مواقع Universal Analytics.

يوضِّح هذا المستند كيفية استخدام أداة "إدارة العلامات من Google" للتطبيقات المتوافقة مع الأجهزة الجوّالة مع حزمة تطوير البرامج (SDK) لمنصّة Firebase لإرسال بيانات التجارة الإلكترونية المحسَّنة إلى مواقع Universal Analytics.

الخطوات الأولى

قبل البدء، يجب إعداد المتطلبات الأساسية التالية لتطبيقك:

يجب تثبيت وإعداد Firebase و"إدارة العلامات من Google" في تطبيقك. احرص على استخدام الإصدار 11 أو الإصدارات الأحدث من حزمة تطوير البرامج (SDK) لمنصة Firebase لنظام التشغيل Android.
استيراد هاتين الحزمتين:
- import com.google.firebase.analytics.FirebaseAnalytics.Event;
- import com.google.firebase.analytics.FirebaseAnalytics.Param;
في حاوية أداة "إدارة العلامات من Google"، أنشئ متغيّرًا من تحديد المستخدِم يُسمى "العروض الترويجية" باستخدام الإعدادات التالية:
- نوع الحدث: المَعلمة المخصّصة
- مفتاح مَعلمة الحدث: العروض الترويجية
- القيمة التلقائية: غير محدّدة

التنفيذ

توضّح الأقسام التالية كيفية تسجيل الأحداث باستخدام المَعلمات اللازمة لقياس أنشطة التجارة الإلكترونية المحسَّنة مثل:

مرات ظهور المنتجات
النقرات أو الاختيارات على المنتجات
مرّات مشاهدة تفاصيل المنتج
الإضافات إلى سلة التسوّق
عمليات الإزالة من سلة التسوّق
مرّات ظهور العرض الترويجي
النقرات على العروض الترويجية أو اختيارها
عملية الدفع
عمليات الشراء
عمليات ردّ الأموال

مرات ظهور المنتجات

يمكنك قياس مرّات ظهور المنتجات عن طريق تسجيل حدث باستخدام مَعلمة ITEM_LIST وعنصر واحد أو أكثر (أي منتجات) تمّ تحديده باستخدام الحقول ذات الصلة.

// Define products with relevant parameters

Bundle product1 = new Bundle();
product1.putString( Param.ITEM_ID, "sku1234");  // ITEM_ID or ITEM_NAME is required
product1.putString( Param.ITEM_NAME, "Donut Friday Scented T-Shirt");
product1.putString( Param.ITEM_CATEGORY, "Apparel/Men/Shirts");
product1.putString( Param.ITEM_VARIANT, "Blue");
product1.putString( Param.ITEM_BRAND, "Google");
product1.putDouble( Param.PRICE, 29.99 );
product1.putString( Param.CURRENCY, "USD" );
product1.putLong( Param.INDEX, 1 );     // Position of the item in the list

Bundle product2 = new Bundle();
product2.putString( Param.ITEM_ID, "sku5678");
product2.putString( Param.ITEM_NAME, "Android Workout Capris");
product2.putString( Param.ITEM_CATEGORY, "Apparel/Women/Pants");
product2.putString( Param.ITEM_VARIANT, "Black");
product2.putString( Param.ITEM_BRAND, "Google");
product2.putDouble( Param.PRICE, 39.99 );
product2.putString( Param.CURRENCY, "USD" );
product2.putLong( Param.INDEX, 2 );

// Prepare ecommerce bundle

ArrayList <bundle>items = new ArrayList<bundle>();
items.add(product1);
items.add(product2);

Bundle ecommerceBundle = new Bundle();
ecommerceBundle.putParcelableArrayList( "items", items );

// Set relevant bundle-level parameters

ecommerceBundle.putString( Param.ITEM_LIST, "Search Results" ); // List name

// Log view_search_results or view_item_list event with ecommerce bundle

mFirebaseAnalytics.logEvent( Event.VIEW_SEARCH_RESULTS, ecommerceBundle );

اطّلِع على إعدادات العلامة في هذا المثال:

نوع العلامة: Universal Analytics
نوع التتبّع: مشاهدة صفحة في التطبيق
الحقول المطلوب ضبطها: (اسم الحقل) screenName (القيمة، مثلاً) شاشة نتائج البحث
تفعيل ميزات التجارة الإلكترونية المحسَّنة: صحيح
قراءة البيانات من: حدث Firebase
عامل التشغيل، على سبيل المثال: (مخصّص > بعض الأحداث) اسم الحدث يساوي view_search_results

النقرات/الاختيارات على المنتجات

يمكنك قياس عدد النقرات على المنتجات عن طريق تسجيل حدث SELECT_CONTENT باستخدام سلعة (أي منتج) محدّدة في الحقول ذات الصلة:

// Define product with relevant parameters

Bundle product1 = new Bundle();
product1.putString( Param.ITEM_ID, "sku1234"); // ITEM_ID or ITEM_NAME is required
product1.putString( Param.ITEM_NAME, "Donut Friday Scented T-Shirt");
product1.putString( Param.ITEM_CATEGORY, "Apparel/Men/Shirts");
product1.putString( Param.ITEM_VARIANT, "Blue");
product1.putString( Param.ITEM_BRAND, "Google");
product1.putDouble( Param.PRICE, 29.99 );
product1.putString( Param.CURRENCY, "USD" ); // Item-level currency unused today
product1.putLong( Param.INDEX, 1 ); // Position of the item in the list

// Prepare ecommerce bundle

Bundle ecommerceBundle = new Bundle();
ecommerceBundle.putBundle( "items", product1 );

// Set relevant action-level parameters

ecommerceBundle.putString( Param.ITEM_LIST, "Search Results" ); // Optional list name

// Log select_content event with ecommerce bundle

mFirebaseAnalytics.logEvent( Event.SELECT_CONTENT, ecommerceBundle );

اطّلِع على إعدادات العلامة في هذا المثال:

نوع العلامة: Universal Analytics
نوع التتبّع: حدث
فئة الحدث، على سبيل المثال: التجارة الإلكترونية
إجراء الحدث، مثل: النقر على المنتج
تفعيل ميزات التجارة الإلكترونية المحسَّنة: صحيح
قراءة البيانات من: حدث Firebase
عامل التشغيل، على سبيل المثال: (مخصّص > بعض الأحداث) اسم الحدث يساوي select_content و {{promotions}} يساوي غير محدّد

مرات مشاهدة تفاصيل المنتج

يمكنك قياس مرّات مشاهدة تفاصيل المنتج من خلال تسجيل حدث VIEW_ITEM باستخدام سلعة (أي منتج) تم تحديدها باستخدام الحقول ذات الصلة:

// Define product with relevant parameters

Bundle product1 = new Bundle();
product1.putString( Param.ITEM_ID, "sku1234"); // ITEM_ID or ITEM_NAME is required
product1.putString( Param.ITEM_NAME, "Donut Friday Scented T-Shirt");
product1.putString( Param.ITEM_CATEGORY, "Apparel/Men/Shirts");
product1.putString( Param.ITEM_VARIANT, "Blue");
product1.putString( Param.ITEM_BRAND, "Google");
product1.putDouble( Param.PRICE, 29.99 );
product1.putString( Param.CURRENCY, "USD" ); // Item-level currency unused today

// Prepare ecommerce bundle

Bundle ecommerceBundle = new Bundle();
ecommerceBundle.putBundle( "items", product1 );

// Log view_item event with ecommerce bundle

mFirebaseAnalytics.logEvent( Event.VIEW_ITEM, ecommerceBundle );

اطّلِع على إعدادات العلامة في هذا المثال:

نوع العلامة: Universal Analytics
نوع التتبّع: مشاهدة صفحة في التطبيق
الحقول المطلوب ضبطها: (اسم الحقل) screenName (القيمة، مثلاً) شاشة تفاصيل المنتج
تفعيل ميزات التجارة الإلكترونية المحسَّنة: صحيح
قراءة البيانات من: حدث Firebase
عامل التشغيل، على سبيل المثال: (مخصّص > بعض الأحداث) اسم الحدث يساوي view_item AND
{{العروض الترويجية}} تساوي غير محدّد

الإضافات إلى سلة التسوّق

يمكنك قياس منتج تتم إضافته إلى سلّة التسوّق عن طريق تسجيل حدث ADD_TO_CART مع سلعة (أي منتج) محدّدة في الحقول ذات الصلة:

// Define product with relevant parameters

Bundle product1 = new Bundle();
product1.putString( Param.ITEM_ID, "sku1234"); // ITEM_ID or ITEM_NAME is required
product1.putString( Param.ITEM_NAME, "Donut Friday Scented T-Shirt");
product1.putString( Param.ITEM_CATEGORY, "Apparel/Men/Shirts");
product1.putString( Param.ITEM_VARIANT, "Blue");
product1.putString( Param.ITEM_BRAND, "Google");
product1.putDouble( Param.PRICE, 29.99 );
product1.putString( Param.CURRENCY, "USD" ); // Item-level currency unused today
product1.putLong( Param.QUANTITY, 1 );

// Prepare ecommerce bundle

Bundle ecommerceBundle = new Bundle();
ecommerceBundle.putBundle( "items", product1 );

// Log add_to_cart event with ecommerce bundle

mFirebaseAnalytics.logEvent( Event.ADD_TO_CART, ecommerceBundle );

اطّلِع على إعدادات العلامة في هذا المثال:

نوع العلامة: Universal Analytics
نوع التتبّع: حدث
فئة الحدث، على سبيل المثال: التجارة الإلكترونية
إجراء الحدث، مثل: إضافة إلى سلة التسوّق
تفعيل ميزات التجارة الإلكترونية المحسَّنة: صحيح
قراءة البيانات من: حدث Firebase
عامل التشغيل، على سبيل المثال: (مخصّص > بعض الأحداث) اسم الحدث يساوي add_to_cart

عمليات الإزالة من سلة التسوّق

يمكنك قياس منتج تتم إزالته من سلّة التسوّق عن طريق تسجيل حدث REMOVE_FROM_CART يتضمّن سلعة (أي منتج) معرّفة باستخدام الحقول ذات الصلة:

// Define product with relevant parameters

Bundle product1 = new Bundle();
product1.putString( Param.ITEM_ID, "sku1234"); // ITEM_ID or ITEM_NAME is required
product1.putString( Param.ITEM_NAME, "Donut Friday Scented T-Shirt");
product1.putString( Param.ITEM_CATEGORY, "Apparel/Men/Shirts");
product1.putString( Param.ITEM_VARIANT, "Blue");
product1.putString( Param.ITEM_BRAND, "Google");
product1.putDouble( Param.PRICE, 29.99 );
product1.putString( Param.CURRENCY, "USD" ); // Item-level currency unused today
product1.putLong( Param.QUANTITY, 1 );

// Prepare ecommerce bundle

Bundle ecommerceBundle = new Bundle();
ecommerceBundle.putBundle( "items", product1 );

// Log remove_from_cart event with ecommerce bundle

mFirebaseAnalytics.logEvent( Event.REMOVE_FROM_CART, ecommerceBundle );

اطّلِع على إعدادات العلامة في هذا المثال:

نوع العلامة: Universal Analytics
نوع التتبّع: حدث
فئة الحدث، على سبيل المثال: التجارة الإلكترونية
إجراء الحدث، مثل: إزالة من سلة التسوق
تفعيل ميزات التجارة الإلكترونية المحسَّنة: صحيح
قراءة البيانات من: حدث Firebase
عامل التشغيل، على سبيل المثال: (مخصّص > بعض الأحداث) اسم الحدث يساوي remove_from_cart

مرّات ظهور الإعلان الترويجي

يمكنك قياس مرّات ظهور العرض الترويجي من خلال تسجيل حدث VIEW_ITEM أو VIEW_ITEM_LIST أو VIEW_SEARCH_RESULTS باستخدام عنصر عرض ترويجي محدّد في الحقول ذات الصلة:

// Define promotion with relevant parameters

Bundle promotion = new Bundle();
promotion.putString( Param.ITEM_ID, "PROMO_1234" ); // promotion ID; either ITEM_ID or ITEM_NAME is required
promotion.putString( Param.ITEM_NAME, "Summer Sale" ); // promotion name
promotion.putString( Param.CREATIVE_NAME, "summer_banner2" );
promotion.putString( Param.CREATIVE_SLOT, "banner_slot1" );

// Prepare ecommerce bundle

ArrayList <bundle>promotions = new ArrayList<bundle>();
promotions.add(promotion);

Bundle ecommerceBundle = new Bundle();
ecommerceBundle.putParcelableArrayList("promotions", promotions );

// Log view_item, view_item_list, or view_search_results event with ecommerce bundle

mFirebaseAnalytics.logEvent(Event.VIEW_ITEM, ecommerceBundle );

اطّلِع على إعدادات العلامة في هذا المثال:

نوع العلامة: Universal Analytics
نوع التتبّع: حدث
فئة الحدث، على سبيل المثال: الترويج الداخلي
إجراء الحدث، على سبيل المثال: الظهور
نتيجة بلا تفاعل: صحيح
تفعيل ميزات التجارة الإلكترونية المحسَّنة: صحيح
قراءة البيانات من: حدث Firebase
عامل التشغيل، على سبيل المثال: (مخصّص > بعض الأحداث) اسم الحدث يساوي view_item AND
{{promotions}} لا يساوي غير محدّد

النقرات/الاختيارات على العروض الترويجية

يمكنك قياس النقرات على العروض الترويجية من خلال تسجيل حدث "SELECT_CONTENT" مع عرض ترويجي محدّد في الحقول ذات الصلة:

// Define promotion with relevant parameters

Bundle promotion = new Bundle();
promotion.putString( Param.ITEM_ID, "PROMO_1234"); // promotion ID; either ITEM_ID or ITEM_NAME is required
promotion.putString( Param.ITEM_NAME, "Summer Sale"); // promotion name
promotion.putString( Param.CREATIVE_NAME, "summer_banner2");
promotion.putString( Param.CREATIVE_SLOT, "banner_slot1");

// Prepare ecommerce bundle

ArrayList <bundle>promotions = new ArrayList<bundle>();
promotions.add(promotion);

Bundle ecommerceBundle = new Bundle();
ecommerceBundle.putParcelableArrayList("promotions", promotions );

// Set properties for the event to be shown in the Google Analytics (Firebase) reports.
// These properties will not impact the Universal Analytics reporting.

ecommerceBundle.putString( Param.CONTENT_TYPE, “Internal Promotions” );
ecommerceBundle.putString( Param.ITEM_ID, "PROMO_1234" );

// Log select_content, view_item_list, or view_search_results event with ecommerce bundle

mFirebaseAnalytics.logEvent( Event.SELECT_CONTENT, ecommerceBundle );

اطّلِع على إعدادات العلامة في هذا المثال:

نوع العلامة: Universal Analytics
نوع التتبّع: حدث
فئة الحدث، على سبيل المثال: الترويج الداخلي
إجراء الحدث، مثل : نقرة
تفعيل ميزات التجارة الإلكترونية المحسَّنة: صحيح
قراءة البيانات من: حدث Firebase
عامل التشغيل، على سبيل المثال: (مخصّص > بعض الأحداث) اسم الحدث يساوي select_content و {{promotions}} لا يساوي غير محدّد

عملية الدفع

بدء إجراء إكمال الدفع

يمكنك قياس الخطوة الأولى في عملية الدفع من خلال تسجيل حدث BEGIN_CHECKOUT يتضمّن سلعة واحدة أو أكثر (أي منتجات) محدّدة في الحقول ذات الصلة:

// Define products with relevant parameters

Bundle product1 = new Bundle();
product1.putString( Param.ITEM_ID, "sku1234"); // ITEM_ID or ITEM_NAME is required
product1.putString( Param.ITEM_NAME, "Donut Friday Scented T-Shirt");
product1.putString( Param.ITEM_CATEGORY, "Apparel/Men/Shirts");
product1.putString( Param.ITEM_VARIANT, "Blue");
product1.putString( Param.ITEM_BRAND, "Google");
product1.putDouble( Param.PRICE, 29.99 );
product1.putString( Param.CURRENCY, "USD" ); // Item-level currency unused today
product1.putLong( Param.QUANTITY, 1 );

// Prepare ecommerce bundle

ArrayList <bundle>items = new ArrayList<bundle>();
items.add(product1);

Bundle ecommerceBundle = new Bundle();
ecommerceBundle.putParcelableArrayList( "items", items );

// Set checkout step and optional checkout option

ecommerceBundle.putLong( Param.CHECKOUT_STEP, 1 ); // Optional for first step
ecommerceBundle.putString( Param.CHECKOUT_OPTION, "Visa" ); // Optional

// Log BEGIN_CHECKOUT event with ecommerce bundle

mFirebaseAnalytics.logEvent( Event.BEGIN_CHECKOUT, ecommerceBundle );

اطّلِع على إعدادات العلامة في هذا المثال:

نوع العلامة: Universal Analytics
نوع التتبّع: مشاهدة صفحة في التطبيق
الحقول المطلوب ضبطها: (اسم الحقل) screenName (القيمة، مثلاً) شاشة سلة التسوق
تفعيل ميزات التجارة الإلكترونية المحسَّنة: صحيح
قراءة البيانات من: حدث Firebase
عامل التشغيل، على سبيل المثال: (مخصّص > بعض الأحداث) اسم الحدث يساوي start_checkout

خطوات إضافية للدفع

يمكنك قياس الخطوات الإضافية في عملية الدفع من خلال تسجيل حدث CHECKOUT_PROGRESS يتضمّن عنصرًا واحدًا أو أكثر (أي منتجات) محدّدة في الحقول ذات الصلة:

// Define products with relevant parameters

Bundle product1 = new Bundle();
product1.putString( Param.ITEM_ID, "sku1234"); // ITEM_ID or ITEM_NAME is required
product1.putString( Param.ITEM_NAME, "Donut Friday Scented T-Shirt");
product1.putString( Param.ITEM_CATEGORY, "Apparel/Men/Shirts");
product1.putString( Param.ITEM_VARIANT, "Blue");
product1.putString( Param.ITEM_BRAND, "Google");
product1.putDouble( Param.PRICE, 29.99 );
product1.putString( Param.CURRENCY, "USD" ); // Item-level currency unused today
product1.putLong( Param.QUANTITY, 1 );

// Prepare ecommerce bundle

ArrayList <bundle>items = new ArrayList<bundle>();
items.add(product1);

Bundle ecommerceBundle = new Bundle();
ecommerceBundle.putParcelableArrayList( "items", items );

// Set checkout step and optional checkout option

ecommerceBundle.putLong( Param.CHECKOUT_STEP, 2 );
ecommerceBundle.putString( Param.CHECKOUT_OPTION, "Visa" ); // Optional

// Log CHECKOUT_PROGRESS event with ecommerce bundle

mFirebaseAnalytics.logEvent( Event.CHECKOUT_PROGRESS, ecommerceBundle );

اطّلِع على إعدادات العلامة في هذا المثال:

نوع العلامة: Universal Analytics
نوع التتبّع: مشاهدة صفحة في التطبيق
الحقول المطلوب ضبطها: (اسم الحقل) screenName (القيمة، مثلاً) خطوة الدفع 2 الشاشة
تفعيل ميزات التجارة الإلكترونية المحسَّنة: صحيح
قراءة البيانات من: حدث Firebase
عامل التشغيل، على سبيل المثال: (مخصّص > بعض الأحداث) اسم الحدث يساوي Checkout_progress

خيارات إكمال الدفع

تتيح لك خيارات الدفع قياس معلومات إضافية حول حالة عملية الدفع. يمكنك قياس خيارات الدفع إما كجزء من حدث لخطوة الدفع (كما هو موضح أعلاه) أو عند تحديد المستخدم لخيار بعد تسجيل الحدث لخطوة دفع معينة.

يمكنك قياس خيارات الدفع بعد خطوة الدفع من خلال تسجيل حدث SET_CHECKOUT_OPTION باستخدام المَعلمتَين CHECKOUT_STEP وCHECKOUT_OPTION المقابلتَين:

Bundle ecommerceBundle = new Bundle();
ecommerceBundle.putLong( Param.CHECKOUT_STEP, 2 );
ecommerceBundle.putString( Param.CHECKOUT_OPTION, "Mastercard" );
mFirebaseAnalytics.logEvent( Event.SET_CHECKOUT_OPTION, ecommerceBundle );

اطّلِع على إعدادات العلامة في هذا المثال:

نوع العلامة: Universal Analytics
نوع التتبّع: حدث
فئة الحدث، على سبيل المثال: التجارة الإلكترونية
إجراء الحدث، مثل : ضبط خيار الدفع
تفعيل ميزات التجارة الإلكترونية المحسَّنة: صحيح
قراءة البيانات من: حدث Firebase
عامل التشغيل، على سبيل المثال: (مخصّص > بعض الأحداث) اسم الحدث يساوي set_checkout_option

عمليات الشراء

يمكنك قياس عمليات الشراء من خلال تسجيل حدث ECOMMERCE_PURCHASE يتضمّن عنصرًا واحدًا أو أكثر (أي منتجات) محدّدًا في الحقول ذات الصلة:

// Define product with relevant parameters

Bundle product1 = new Bundle();
product1.putString( Param.ITEM_ID, "sku1234"); // ITEM_ID or ITEM_NAME is required
product1.putString( Param.ITEM_NAME, "Donut Friday Scented T-Shirt");
product1.putString( Param.ITEM_CATEGORY, "Apparel/Men/Shirts");
product1.putString( Param.ITEM_VARIANT, "Blue");
product1.putString( Param.ITEM_BRAND, "Google");
product1.putDouble( Param.PRICE, 29.99 );
product1.putString( Param.CURRENCY, "USD" ); // Item-level currency unused today
product1.putLong( Param.QUANTITY, 1 );

Bundle product2 = new Bundle();
product2.putString( Param.ITEM_ID, "sku5678");
product2.putString( Param.ITEM_NAME, "Android Workout Capris");
product2.putString( Param.ITEM_CATEGORY, "Apparel/Women/Pants");
product2.putString( Param.ITEM_VARIANT, "Black");
product2.putString( Param.ITEM_BRAND, "Google");
product2.putDouble( Param.PRICE, 39.99 );
product2.putString( Param.CURRENCY, "USD" ); // Item-level currency unused today
product2.putLong( Param.QUANTITY, 1 );

// Prepare ecommerce bundle

ArrayList <bundle>items = new ArrayList<bundle>();
items.add(product1);
items.add(product2);

Bundle ecommerceBundle = new Bundle();
ecommerceBundle.putParcelableArrayList( "items", items );

// Set relevant transaction-level parameters

ecommerceBundle.putString( Param.TRANSACTION_ID, "T12345" );
ecommerceBundle.putString( Param.AFFILIATION, "Google Store - Online" );
ecommerceBundle.putDouble( Param.VALUE, 37.39 );    // Revenue
ecommerceBundle.putDouble( Param.TAX, 2.85 );
ecommerceBundle.putDouble( Param.SHIPPING, 5.34 );
ecommerceBundle.putString( Param.CURRENCY, "USD" );
ecommerceBundle.putString( Param.COUPON, "SUMMER2017" );

// Log ecommerce_purchase event with ecommerce bundle

mFirebaseAnalytics.logEvent( Event.ECOMMERCE_PURCHASE, ecommerceBundle );

اطّلِع على إعدادات العلامة في هذا المثال:

نوع العلامة: Universal Analytics
نوع التتبّع: مشاهدة صفحة في التطبيق
الحقول المطلوب ضبطها: (اسم الحقل) screenName (القيمة، مثلاً) شاشة الشكر
تفعيل ميزات التجارة الإلكترونية المحسَّنة: صحيح
قراءة البيانات من: حدث Firebase
عامل التشغيل، على سبيل المثال: (مخصّص > بعض الأحداث) اسم الحدث يساوي ecommerce_purchase

ردّ الأموال

يمكنك قياس عمليات ردّ الأموال عن طريق تسجيل حدث "PURCHASE_REFUND" باستخدام معرّف المعاملة ذي الصلة المحدّد، واختياريًا سلعة واحدة أو أكثر (أي المنتجات) المحدّدة باستخدام معرّفات السلع والكميات (في عمليات ردّ جزء من الأموال):

// Prepare ecommerce bundle with transaction ID to be refunded

Bundle ecommerceBundle = new Bundle();
ecommerceBundle.putString( Param.TRANSACTION_ID, "T12345" ); // Required
ecommerceBundle.putDouble( Param.VALUE, 37.39 ); // Optional in Universal Analytics

// (OPTIONAL) For partial refunds, define the item IDs and quantities of products being refunded

Bundle refundedProduct = new Bundle();
refundedProduct.putString( Param.ITEM_ID, "sku1234" ); // Required for partial refund
refundedProduct.putLong( Param.QUANTITY, 1 ); // Required for partial refund

ArrayList <bundle>items = new ArrayList<bundle>();
items.add(refundedProduct);
ecommerceBundle.putParcelableArrayList( "items", items );

// Log purchase_refund event with ecommerce bundle

mFirebaseAnalytics.logEvent( Event.PURCHASE_REFUND, ecommerceBundle );

اطّلِع على إعدادات العلامة في هذا المثال:

نوع العلامة: Universal Analytics
نوع التتبّع: حدث
فئة الحدث، على سبيل المثال: التجارة الإلكترونية
إجراء الحدث، مثل: ردّ الأموال
تفعيل ميزات التجارة الإلكترونية المحسَّنة: صحيح
قراءة البيانات من: حدث Firebase
عامل التشغيل، على سبيل المثال: (مخصّص > بعض الأحداث) اسم الحدث يساوي purchase_refund