توقّفت مواقع Universal Analytics العادية (UA) عن معالجة البيانات في 1 تموز (يوليو) 2023. ستتوقّف مواقع Universal Analytics 360 عن معالجة البيانات في 1 تموز (يوليو) 2024، وسيتم إيقاف بعض ميزات Universal Analytics 360 نهائيًا قبل ذلك، وذلك بسبب نقلنا البيانات إلى "إحصاءات Google 4". لاستخدام "إحصاءات Google 4"، يجب نقل البيانات إلى Firebase.

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

تتبُّع التجارة الإلكترونية المحسَّنة - حزمة تطوير البرامج (SDK) لنظام التشغيل iOS

يقدّم هذا المستند نظرة عامة عن كيفية قياس الإجراءات ومرات الظهور ذات الصلة بالتجارة الإلكترونية داخل التطبيق باستخدام الإصدار 3 من حزمة تطوير البرامج (SDK) لخدمة "إحصاءات Google" لنظام التشغيل iOS.

نظرة عامة

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

ملاحظة مهمّة: تتطلّب التجارة الإلكترونية المحسَّنة استخدام المكتبات والحقول الخاصة بالتجارة الإلكترونية المحسَّنة المضمّنة في حزمة تطوير البرامج (SDK) لنظام التشغيل iOS. يتمّ إرسال قيم التجارة الإلكترونية المحسَّنة مع نتائج حالية مثل screenviews وevents. ينبغي لك عدم إرسال transaction وitem النتائج الخاصة بالنتائج العادية.

التنفيذ

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

بعد إعداد تطبيقك لاستخدام التجارة الإلكترونية المحسَّنة، يمكنك إجراء ما يلي:

قياس أنشطة التجارة الإلكترونية
قياس المعاملات
قياس عمليات ردّ الأموال
قياس عملية الدفع
قياس عمليات الترويج الداخلية

قياس أنشطة التجارة الإلكترونية

سيقيس تنفيذ التجارة الإلكترونية المحسَّنة النموذجي مرّات ظهور المنتجات، بالإضافة إلى أيّ من الإجراءات التالية:

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

قياس مرات الظهور

لقياس ظهور منتج ما، حدد قيم المنتج ومرّات الظهور وأرسِله مع نتيجة:

id tracker = [[GAI sharedInstance] trackerWithTrackingId:@"MyTrackingId"];
GAIEcommerceProduct *product = [[GAIEcommerceProduct alloc] init];
[product setId:@"P12345"];
[product setName:@"Android Warhol T-Shirt"];
[product setCategory:@"Apparel/T-Shirts"];
[product setBrand:@"Google"];
[product setVariant:@"Black"];
[product setCustomDimension:1 value:@"Member"];
GAIDictionaryBuilder *builder = [GAIDictionaryBuilder createScreenView];

// Sets the product impression for the next available slot, starting with 1.
[builder addProductImpression:product
               impressionList:@"Search Results"
             impressionSource:@"From Search"];
[tracker set:kGAIScreenName value:@"My Impression Screen"];
[tracker send:[builder build]];

يجب أن يحتوي المنتج على اسم أو قيمة معرّف. وجميع القيم الأخرى اختيارية ولا تحتاج إلى ضبطها.

قياس الإجراءات

يتم قياس الإجراءات من خلال تحديد قيم المنتجات، ثم تحديد قيم إجراءات المنتجات لتحديد الإجراء الذي يتم تنفيذه.

على سبيل المثال، يقيس الرمز التالي اختيار منتج معروض في قائمة نتائج البحث:

id<GAITracker> tracker = [[GAI sharedInstance] trackerWithTrackingId:@"MyTrackingId"];
GAIEcommerceProduct *product = [[GAIEcommerceProduct alloc] init];
[product setId:@"P12345"];
[product setName:@"Android Warhol T-Shirt"];
[product setCategory:@"Apparel/T-Shirts"];
[product setBrand:@"Google"];
[product setVariant:@"Black"];
[product setCustomDimension:1 value:@"Member"];

GAIEcommerceProductAction *action = [[GAIEcommerceProductAction alloc] init];
[action setAction:kGAIPAClick];
[action setProductActionList:@"Search Results"];
GAIDictionaryBuilder *builder = [GAIDictionaryBuilder createScreenView];
[builder setProductAction:action];

// Sets the product for the next available slot, starting with 1
[builder addProduct:product];
[tracker set:kGAIScreenName value:@"My Impression Screen"];
[tracker send:[builder build]];

يجب أن يحتوي المنتج على اسم أو قيمة معرّف. وجميع القيم الأخرى اختيارية ولا تحتاج إلى ضبطها.

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

في الحالات التي يكون فيها لديك إجراء ومرّات ظهور للمنتج معًا، من الممكن دمج ذلك وقياسه في نتيجة واحدة.

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

// The product from the related products section.
id tracker = [[GAI sharedInstance] trackerWithTrackingId:@"MyTrackingId"];
GAIEcommerceProduct *product = [[GAIEcommerceProduct alloc] init];
[product setId:@"P12346"];
[product setName:@"Android Warhol T-Shirt"];
[product setCategory:@"Apparel/T-Shirts"];
[product setBrand:@"Google"];
[product setVariant:@"White"];
GAIDictionaryBuilder *builder = [GAIDictionaryBuilder createScreenView];

// Sets the product impression for the next available slot, starting with 1.
[builder addProductImpression:product
               impressionList:@"Related Products"
             impressionSource:@"From Related"];

// The product being viewed.
product = [[GAIEcommerceProduct alloc] init];
[product setId:@"P12345"];
[product setName:@"Android Warhol T-Shirt"];
[product setCategory:@"Apparel/T-Shirts"];
[product setBrand:@"Google"];
[product setVariant:@"Black"];

GAIEcommerceProductAction *action = [[GAIEcommerceProductAction alloc] init];
[action setAction:kGAIPADetail];
[builder setProductAction:action];
// Sets the product for the next available slot, starting with 1.
[builder addProduct:product];
[tracker set:kGAIScreenName value:@"Related Products Screen"];
[tracker send:[builder build]];

قياس المعاملات

قِس معاملة عن طريق تعيين قيم المنتجات ثم تعيين قيم إجراءات المنتج لتحديد إجراء شراء. يتم تعيين تفاصيل مستوى المعاملة مثل إجمالي الإيرادات والضريبة والشحن مع قيم إجراء المنتج.

id<GAITracker> tracker = [[GAI sharedInstance] trackerWithTrackingId:@"MyTrackingId"];
GAIEcommerceProduct *product = [[GAIEcommerceProduct alloc] init];
[product setId:@"P12345"];
[product setName:@"Android Warhol T-Shirt"];
[product setCategory:@"Apparel/T-Shirts"];
[product setBrand:@"Google"];
[product setVariant:@"Black"];
[product setPrice:@29.20];
[product setCouponCode:@"APPARELSALE"];
[product setQuantity:@1];
GAIDictionaryBuilder *builder = [GAIDictionaryBuilder createEventWithCategory:@"Ecommerce"
                                                                       action:@"Purchase"
                                                                        label:nil
                                                                        value:nil];
GAIEcommerceProductAction *action = [[GAIEcommerceProductAction alloc] init];
[action setAction:kGAIPAPurchase];
[action setTransactionId:@"T12345"];
[action setAffiliation:@"Google Store - Online"];
[action setRevenue:@37.39];
[action setTax:@2.85];
[action setShipping:@5.34];
[action setCouponCode:@"SUMMER2013"];
[builder setProductAction:action];

// Sets the product for the next available slot, starting with 1
[builder addProduct:product];
[tracker send:[builder build]];

تحديد العملة

بشكل تلقائي، يمكنك ضبط عملة مشتركة وعالمية لجميع المعاملات والعناصر من خلال واجهة الويب لإدارة "إحصاءات Google".

يجب تحديد العملة المحلية في معيار ISO 4217. اقرأ مستند مرجع رموز العملات للحصول على قائمة كاملة بعملات التحويل المتوافقة.

يتم تحديد العملات المحلية من خلال ضبط قيمة رمز العملة في أداة التتبُّع. على سبيل المثال، سيرسل برنامج التتبُّع هذا قيم العملة مثل اليورو:

id<GAITracker> tracker = [[GAI sharedInstance] trackerWithTrackingId:@"MyTracker"];
[tracker set:kGAIScreenName value:@"transaction"];
[tracker set:kGAICurrencyCode value:@"EUR"]; // Set tracker currency to Euros.
GAIDictionaryBuilder *builder = [GAIDictionaryBuilder createScreenView];
[tracker send:[builder build]];

قياس عمليات ردّ الأموال

لرد أموال معاملة بأكملها، اضبط قيم إجراءات المنتج لتحديد معرّف المعاملة ونوع إجراء رد الأموال:

// Refund an entire transaction.
id<GAITracker> tracker = [[GAI sharedInstance] trackerWithTrackingId:@"MyTrackingId"];
GAIDictionaryBuilder *builder = [GAIDictionaryBuilder createEventWithCategory:@"Ecommerce"
                                                                       action:@"Refund"
                                                                        label:nil
                                                                        value:nil];
GAIEcommerceProductAction *action = [[GAIEcommerceProductAction alloc] init];
[action setAction:kGAIPARefund];
[action setTransactionId:@"T12345"];
[builder setProductAction:action];
[tracker send:[builder build]];

إذا لم يتم العثور على أي معاملة مطابقة، لن تتم معالجة عملية ردّ الأموال.

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

// Refund a single product.
id<GAITracker> tracker = [[GAI sharedInstance] trackerWithTrackingId:@"MyTrackingId"];
GAIDictionaryBuilder *builder = [GAIDictionaryBuilder createEventWithCategory:@"Ecommerce"
                                                                       action:@"Refund"
                                                                        label:nil
                                                                        value:nil];
GAIEcommerceProduct *product = [[GAIEcommerceProduct alloc] init];
[product setId:@"P12345"]; // Product ID is required for partial refund.
[product setQuantity:@1]; // Quanity is required for partial refund.
[builder addProduct:product];

GAIEcommerceProductAction *action = [[GAIEcommerceProductAction alloc] init];
[action setAction:kGAIPARefund];
[action setTransactionId:@"T12345"]; // Transaction ID is required for partial refund.
[builder setProductAction:action];
[tracker send:[builder build]];

استخدام أحداث عدم التفاعل لعمليات ردّ الأموال

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

// Refund an entire transaction.
id<GAITracker> tracker = [[GAI sharedInstance] trackerWithTrackingId:@"MyTrackingId"];
GAIDictionaryBuilder *builder = [GAIDictionaryBuilder createEventWithCategory:@"Ecommerce"
                                                                       action:@"Refund"
                                                                        label:nil
                                                                        value:nil];

[builder set:@"1" forKey:kGAINonInteraction];

GAIEcommerceProductAction *action = [[GAIEcommerceProductAction alloc] init];
[action setAction:kGAIPARefund];
[action setTransactionId:@"T12345"];

[builder setProductAction:action];
[tracker send:[builder build]];

قياس عملية الدفع

لقياس كل خطوة في عملية الدفع:

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

1- قياس خطوات الدفع

وفي كل خطوة في عملية الدفع، يجب تنفيذ رمز التتبّع المقابل لإرسال البيانات إلى "إحصاءات Google".

حقل `Step`

عليك تضمين قيمة step لكل خطوة تقيسها في الدفع. تُستخدم هذه القيمة لربط إجراءات الدفع الخاصة بك بالتصنيفات التي ضبطتها لكل خطوة في إعدادات التجارة الإلكترونية.

حقل `Option`

إذا كانت لديك معلومات إضافية حول خطوة الدفع المحددة في وقت قياس الخطوة، يمكنك ضبط حقل خيار الدفع باستخدام إجراء دفع لتسجيل هذه المعلومات. على سبيل المثال، نوع الدفع التلقائي للمستخدم (على سبيل المثال، "Visa").

قياس خطوة الدفع

لقياس خطوة دفع، حدِّد قيم المنتجات، ثم اضبط قيم إجراءات المنتج للإشارة إلى إجراء دفع. إذا كان ذلك ممكنًا، يمكنك أيضًا ضبط قيمة خطوة الدفع وخيار الدفع مع عملية الدفع.

يوضح المثال التالي كيفية قياس الخطوة الأولى في عملية الدفع باستخدام منتج واحد، وبعض المعلومات الإضافية حول نوع الدفع:

id<GAITracker> tracker = [[GAI sharedInstance] trackerWithTrackingId:@"MyTrackingId"];
GAIEcommerceProduct *product = [[GAIEcommerceProduct alloc] init];
[product setId:@"P12345"];
[product setName:@"Android Warhol T-Shirt"];
[product setCategory:@"Apparel/T-Shirts"];
[product setBrand:@"Google"];
[product setVariant:@"Black"];
[product setPrice:@29.20];
[product setCouponCode:@"APPARELSALE"];
[product setQuantity:@1];

GAIDictionaryBuilder *builder = [GAIDictionaryBuilder createEventWithCategory:@"Ecommerce"
                                                                       action:@"Checkout"
                                                                        label:nil
                                                                        value:nil];

// Add the step number and additional info about the checkout to the action.
GAIEcommerceProductAction *action = [[GAIEcommerceProductAction alloc] init];
[action setAction:kGAIPACheckout];
[action setCheckoutStep:@1];
[action setCheckoutOption:@"Visa"];

[builder addProduct:product];
[builder setProductAction:action];
[tracker send:[builder build]];

2. قياس خيارات الدفع

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

لقياس خيار الدفع، اضبط قيم الإجراءات المتعلقة بالمنتج للإشارة إلى خيار الدفع وأدرِج رقم الخطوة ووصف الخيار.

من المحتمل أن ترغب في قياس هذا الإجراء بمجرد أن يتخذ المستخدم إجراءًا للانتقال إلى الخطوة التالية في عملية الدفع. مثال:

// (On "Next" button click.)
id<GAITracker> tracker = [[GAI sharedInstance] trackerWithTrackingId:@"MyTrackingId"];
GAIDictionaryBuilder *builder = [GAIDictionaryBuilder createEventWithCategory:@"Ecommerce"
                                                                       action:@"CheckoutOption"
                                                                        label:nil
                                                                        value:nil];

GAIEcommerceProductAction *action = [[GAIEcommerceProductAction alloc] init];
[action setAction:kGAIPACheckoutOption];
[action setCheckoutStep:@1];
[action setCheckoutOption:@"Fedex"];

[builder setProductAction:action];
[tracker send:[builder build]];
// Advance to next page.

3- إعداد مسار الدفع

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

إعدادات التجارة الإلكترونية في قسم "المشرف" في واجهة "إحصاءات Google" على الويب. تم تفعيل التجارة الإلكترونية وإضافة 4 تصنيفات لخطوات مسار الدفع: 1. مراجعة سلة التسوق، 2. جمع معلومات الدفع، 3. أكِّد تفاصيل
الشراء، 4- إيصال — **الشكل 1**: إعداد التجارة الإلكترونية - مسار الدفع

قياس عمليات الترويج الداخلية

تشمل التجارة الإلكترونية المحسَّنة إمكانية قياس مرّات الظهور واختيارات العروض الترويجية الداخلية، مثل إعلانات البانر المعروضة للترويج لتخفيضات.

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

id<GAITracker> tracker = [[GAI sharedInstance] trackerWithTrackingId:@"MyTrackingId"];
GAIEcommercePromotion *promotion = [[GAIEcommercePromotion alloc] init];
[promotion setId:@"PROMO_1234"];
[promotion setName:@"Summer Sale"];
[promotion setCreative:@"summer_banner2"];
[promotion setPosition:@"banner_slot1"];

GAIDictionaryBuilder *builder = [GAIDictionaryBuilder createEventWithCategory:@"Ecommerce"
                                                                       action:@"Promotion"
                                                                        label:nil
                                                                        value:nil];

[builder addPromotion:promotion];
[tracker send:[builder build]];

يمكن قياس عدد النقرات على العروض الترويجية الداخلية باستخدام قيم العروض الترويجية، ثم ضبط قيم الإجراءات المتعلقة بالمنتج للإشارة إلى نقرة على عرض ترويجي. مثال:

id<GAITracker> tracker = [[GAI sharedInstance] trackerWithTrackingId:@"MyTrackingId"];
GAIEcommercePromotion *promotion = [[GAIEcommercePromotion alloc] init];
[promotion setId:@"PROMO_1234"];
[promotion setName:@"Summer Sale"];
[promotion setCreative:@"summer_banner2"];
[promotion setPosition:@"banner_slot1"];

GAIDictionaryBuilder *builder = [GAIDictionaryBuilder createEventWithCategory:@"Internal Promotions"
                                                                       action:@"click"
                                                                        label:@"Summer Sale"
                                                                        value:nil];

[builder set:kGAIPromotionClick forKey:kGAIPromotionAction];
[builder addPromotion:promotion];
[tracker send:[builder build]];

مساعدة "التجارة الإلكترونية المحسَّنة" في "إحصاءات Google"