الإصدار الثالث من نظام التشغيل iOS - التجارة الإلكترونية المحسَّنة

يوضِّح هذا الدليل كيفية تنفيذ التجارة الإلكترونية المحسَّنة في Universal Analytics. باستخدام حزمة تطوير البرامج (SDK) لإدارة العلامات من Google لنظام التشغيل iOS.

نظرة عامة

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

قبل البدء

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

التنفيذ

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

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

  • قياس التجارة الإلكترونية: impressions
  • يتم قبول البيانات: مصفوفة impressionFieldObjects

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

// Product impressions are sent by pushing an impressions object
// containing one or more impressionFieldObjects.
[dataLayer push:@{@"ecommerce": @{
                    @"currencyCode": @"EUR",                      // Local currency is optional.
                    @"impressions": @[
                      @{@"name": @"Triblend Android T-Shirt",     // Name or ID is required.
                        @"id": @"12345",
                        @"price": @"15.25",
                        @"brand": @"Google",
                        @"category": @"Apparel",
                        @"variant": @"Gray",
                        @"list": @"Search Results",
                        @"position": @1},
                      @{@"name": @"Donut Friday Scented T-Shirt",
                        @"id": @"67890",
                        @"price": @"33.75",
                        @"brand": @"Google",
                        @"category": @"Apparel",
                        @"variant": @"Black",
                        @"list": @"Search Results",
                        @"position": @2}]}}];

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

  • قياس التجارة الإلكترونية: click
  • يتم قبول البيانات: list، مصفوفة من productFieldObjects

يمكنك قياس اختيارات المنتجات من خلال إرسال إجراء click إلى البيانات. مع productFieldObject لتمثيل الطبقة المحددة المنتج:

[dataLayer push:@{@"event": @"productClick",
                  @"ecommerce": @{
                    @"click": @{
                      @"actionField": @{
                        @"list": @"Search Results"},              // Optional list property.
                      @"products": @[
                        @{@"name": @"Triblend Android T-Shirt",   // Name or ID is required.
                          @"id": @"12345",
                          @"price": @"15.25",
                          @"brand": @"Google",
                          @"category": @"Apparel",
                          @"variant": @"Gray"}]}}}];

قياس مشاهدات تفاصيل المنتج

  • قياس التجارة الإلكترونية: detail
  • يتم قبول البيانات: list، مصفوفة من productFieldObjects

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

// Measure a view of product details.
[dataLayer push:@{@"ecommerce": @{
                    @"detail": @{
                      @"actionField": @{
                        @"list": @"Apparel Gallery"},             // 'detail' actions have an optional list property.
                      @"products": @[
                        @{@"name": @"Triblend Android T-Shirt",   // Name or ID is required.
                          @"id": @"12345",
                          @"price": @"15.25",
                          @"brand": @"Google",
                          @"category": @"Apparel",
                          @"variant": @"Gray"}]}}}];

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

  • قياس التجارة الإلكترونية: add، remove
  • يتم قبول البيانات: list، مصفوفة من productFieldObjects

يمكنك قياس الإضافات أو عمليات الإزالة من سلة التسوق باستخدام add أو remove actionFieldObject قائمة من productFieldObjects:

إضافة منتج إلى سلة التسوق

// Measure adding a product to a shopping cart by using an "add"
// actionFieldObject and a list of productFieldObjects.
[dataLayer push:@{@"event": @"addToCart",
                  @"ecommerce": @{
                    @"currencyCode": @"EUR",
                    @"add": @{                                  // 'add' actionFieldObject measures.
                      @"products": @[
                        @{@"name": @"Triblend Android T-Shirt",
                          @"id": @"12345",
                          @"price": @"15.25",
                          @"brand": @"Google",
                          @"category": @"Apparel",
                          @"variant": @"Gray",
                          @"quantity": @1}]}}}];

إزالة منتج من سلة التسوق

// Measure the removal of a product from a shopping cart.
[dataLayer push:@{@"event": @"removeFromCart",
                  @"ecommerce": @{
                    @"remove": @{                               // 'remove' actionFieldObject measures.
                      @"products": @[
                        @{@"name": @"Triblend Android T-Shirt",
                          @"id": @"12345",
                          @"price": @"15.25",
                          @"brand": @"Google",
                          @"category": @"Apparel",
                          @"variant": @"Gray",
                          @"quantity": @1}]}}}];

قياس عمليات الترويج

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

قياس مرات ظهور العروض الترويجية

  • قياس التجارة الإلكترونية: promoView
  • يتم قبول البيانات: مصفوفة promoFieldObjects

لقياس مرّة ظهور إعلان ترويجي، اضبط المفتاح promoView في طبقة بيانات التجارة الإلكترونية إلى promoFieldObject التي تصف العروض الترويجية التي تظهر للمستخدمين على الشاشة:

// An example of measuring promotion views. This example assumes that
// information about the promotions displayed is available when the screen is
// displayed.
[dataLayer push:@{@"ecommerce": @{
                    @"promoView": @{
                      @"promotions": @[                     // Array of promoFieldObjects.
                        @{@"id": @"JUNE_PROMO13",           // ID or Name is required.
                          @"name": @"June Sale",
                          @"creative": @"banner1",
                          @"position": @"slot1"},
                        @{@"id": @"FREE_SHIP13",
                          @"name": @"Free Shipping Promo",
                          @"creative": @"skyscraper1",
                          @"position": @"slot2"}]}}}];

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

لقياس مجموعة من العروض الترويجية، عليك دفع الإجراء promoClick إلى طبقة البيانات مع مصفوفة تحتوي على promoFieldObject يصف العرض الترويجي الذي اخترته:

[dataLayer push:@{@"event": @"promotionClick",
                  @"ecommerce": @{
                    @"promoClick": @{
                      @"promotions": @[
                        @{@"id":  @"JUNE_PROMO13",          // Name or ID is required.
                          @"name": @"June Sale",
                          @"creative": @"banner1",
                          @"position": @"slot1"}]}}}];

قياس Checkout

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

  1. قياس كل خطوة من خطوات عملية الدفع باستخدام "checkout" اتخاذ القرار.
  2. قياس خيارات الدفع باستخدام الإجراء checkout_option.
  3. اختياريًا، يمكنك تحديد أسماء خطوات سهلة الاستخدام لتقرير مسار الدفع على النحو التالي: ضبط إعدادات التجارة الإلكترونية في قسم المشرف في واجهة الويب.

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

  • قياس التجارة الإلكترونية: checkout
  • يتم قبول البيانات: step، مصفوفة من productFieldObjects

لقياس عملية الدفع، والتي قد تتضمن زر الدفع شاشة دفع واحدة أو أكثر يُدخل فيها المستخدمون معلومات الشحن والدفع المعلومات، يمكنك استخدام إجراء checkout وstep للإشارة إلى المرحلة التي يتم قياسها من عملية الدفع. يمكنك أيضًا استخدام الحقل option لتقديم جزء من بيانات إضافية حول عملية الدفع، مثل نوع الدفع المحددة من قبل المستخدم.

[dataLayer push:@{@"event": @"checkout",
                  @"ecommerce": @{
                    @"checkout": @{
                      @"actionField": @{
                        @"step": @1,
                        @"option": @"Visa"},
                      @"products": @[
                        @{@"name": @"Triblend Android T-Shirt",
                          @"id": @"12345",
                          @"price": @"15.25",
                          @"brand": @"Google",
                          @"category": @"Apparel",
                          @"variant": @"Gray",
                          @"quantity": @1}]}}}];

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

  • قياس التجارة الإلكترونية: checkout_option
  • يتم قبول البيانات: step، option

يُعد خيار الدفع مفيدًا في الحالات التي قمت فيها بالفعل بقياس الدفع، ولكنك تريد الحصول على معلومات إضافية حول الدفع. على سبيل المثال، طريقة الشحن التي اختارها المستخدم. لتحديد هذه البيانات، استخدِم الإجراء checkout_option. إلى جانب الحقلين step وoption.

[dataLayer push:@{@"event": @"checkoutOption",
                  @"ecommerce": @{
                    @"checkout_option": @{
                      @"actionField": @{
                        @"step": @1,
                        @"option": @"Express"}}}}];

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

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

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

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

  • قياس التجارة الإلكترونية: purchase
  • يتم قبول البيانات: id (معرّف المعاملة)، مصفوفة من productFieldObjects

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

// Send transaction data with a screenview if possible.
// Otherwise, use an event when the transaction data becomes available.
[dataLayer push:@{@"ecommerce": @{
                    @"purchase": @{
                      @"actionField": @{
                        @"id": @"T12345",                         // Transaction ID. Required for purchases and refunds.
                        @"affiliation": @"Online Store",
                        @"revenue": @"35.43",                     // Total transaction value (incl. tax and shipping)
                        @"tax":"4.90",
                        @"shipping": @"5.99",
                        @"coupon": @"SUMMER_SALE"},
                      @"products": @[                             // List of productFieldObjects.
                        @{@"name": @"Triblend Android T-Shirt",   // Name or ID is required.
                          @"id": @"12345",
                          @"price": @"15.25",
                          @"brand": @"Google",
                          @"category": @"Apparel",
                          @"variant": @"Gray",
                          @"quantity": @1,
                          @"coupon": @""},                        // Optional fields may be omitted or set to empty string.
                        @{@"name": @"Donut Friday Scented T-Shirt",
                          @"id": @"67890",
                          @"price": @"33.75",
                          @"brand": @"Google",
                          @"category": @"Apparel",
                          @"variant": @"Black",
                          @"quantity": @1}]}}}];

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

  • قياس التجارة الإلكترونية: refund
  • يتم قبول البيانات: id (معرّف المعاملة)، مصفوفة من productFieldObjects

لقياس عملية ردّ الأموال بالكامل لعملية شراء، اضغط refund actionFieldObject مع المعاملة معرّف المعاملة التي يتم ردّ الأموال المدفوعة فيها:

// Refund an entire transaction by providing the transaction ID. This example
// assumes the details of the completed refund are available when the screen
// is displayed:
[dataLayer push:@{@"ecommerce": @{
                    @"refund": @{
                      @"actionField": @{
                        @"id": @"T12345"}}}}];  // Transaction ID. Required for refunds.

لقياس عملية ردّ جزء من الأموال، أضِف قائمة productFieldObjects، بما في ذلك معرّفات المنتجات والكميات المعروضة تم رد الأموال:

// Measure a partial refund by providing an array of productFieldObjects and
// specifying the ID and quantity of each product being returned. This example
// assumes the partial refund details are known at the time the screen is
// displayed:
[dataLayer push:@{@"ecommerce": @{
                    @"refund": @{
                      @"actionField": @{
                        @"id": @"T12345"},      // Transaction ID.
                      @"products": @[
                        @{@"id": @"P4567",
                          @"quantity": @1},     // Product ID & quantity. Required for partial refunds.
                        @{@"id": @"P8901",
                          @"quantity": @2}]}}}];

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

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

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

[dataLayer push:@{@"ecommerce": @{
                    @"impressions": @[
                      @{@"name": @"Triblend Android T-Shirt",       // Name or ID is required.
                        @"id": @"12345",
                        @"price": @"15.25",
                        @"brand": @"Google",
                        @"category": @"Apparel",
                        @"variant": @"Gray",
                        @"list": @"Related Products",
                        @"position": @1},
                      @{@"name": @"Donut Friday Scented T-Shirt",
                        @"id": @"67890",
                        @"price": @"33.75",
                        @"brand": @"Google",
                        @"category": @"Apparel",
                        @"variant": @"Black",
                        @"list": @"Related Products",
                        @"position": @2}],
                    @"detail": @{
                      @"actionField": @{
                        @"list": @"Apparel Gallery"},               // 'detail' actions have an optional list property.
                      @"products": @[
                        @{@"name": @"Triblend Android T-Shirt",     // Name or ID is required.
                          @"id": @"12345",
                          @"price": @"15.25",
                          @"brand": @"Google",
                          @"category": @"Apparel",
                          @"variant": @"Gray"}]}}}];