إضافة جدول بيانات "إحصاءات Google"

فيليب والتون، مهندس برامج مطوّري برامج "إحصاءات Google" – آذار (مارس) 2014

تُسهِّل إضافة جدول بيانات "إحصاءات Google" على مستخدمي "إحصاءات Google" الوصول إلى بياناتهم في تمثيل جداول البيانات في Google Analytics وعرضها ومشاركتها ومعالجتها.

المقدمة

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

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

مقاطع فيديو تعليمية

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

إضافة إضافة جدول بيانات "إحصاءات Google"

إنشاء لوحة بيانات باستخدام إضافة جدول بيانات "إحصاءات Google"

تثبيت الإضافة

لاستخدام إضافة "إحصاءات Google"، عليك أولاً إضافتها إلى جدول البيانات. سترشدك التعليمات التالية خلال العملية:

  1. أنشئ جدول بيانات Google جديدًا (أو افتح جدول بيانات حاليًا).
  2. من شريط القوائم، اختر: الإضافات &gt؛ الحصول على الإضافات...
  3. ابحث عن إضافة "إحصاءات Google" من معرض الإضافات واختَرها.
  4. من صفحة وصف الإضافة، انقر على &"+" في أعلى يسار الصفحة لإضافة هذه الإضافة إلى جدول البيانات.
  5. من المفترض أن يظهر مربع حوار يطلب إذنًا للإضافة من أجل الوصول إلى بيانات "إحصاءات Google". انقر على "قبول&quot:
  6. تم تثبيت الإضافة الآن. من المفترض أن تظهر القائمة الفرعية &quotإحصاءات Google&quot، في قائمة "الإضافات".

إنشاء التقارير

يمكن إنشاء التقارير يدويًا أو بمساعدة أداة إنشاء التقارير في الإضافات. لاستخدام الأداة، اختَر "إضافات" > "Google Analytics" > "إنشاء تقرير جديد"من شريط القوائم. سيعرض هذا الشريط الجانبي على يسار الصفحة، ما يسمح لك بالبحث بسهولة عن معلومات حسابك على "إحصاءات Google" بالإضافة إلى اختيار الأبعاد والمقاييس التي تريد طلبها. عند الانتهاء، انقر على الزر "إنشاء تقرير" &quot، وستظهر معلومات تقريرك في ورقة باسم "الضبط وإعداد التقارير"، (إذا لم تكن الورقة متوفرة)، سيتم إنشاؤها).

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

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

التقارير الجارية

لتشغيل جميع التقارير التي أنشأتها، اختَر &quot>إضافة "> "Google Analytics &&;; > "تشغيل التقارير"من شريط القوائم.

استثناء تقرير

ستدير الإضافة كل تقرير باسم تلقائيًا، لذلك إذا كنت تريد استبعاد تقرير مؤقتًا بدون حذفه، ما عليك سوى إزالة كل النص من الخلية التي تنتقل إليها قيمة الاسم.

اختيار ورقة بيانات الإخراج

سيؤدي تشغيل التقارير إلى إرسال طلب إلى Google Analytics API وطباعة النتائج إلى ورقة من اختيارك. يمكن أن يكون جدول بيانات في جدول البيانات الذي تستخدمه حاليًا أو في جدول بيانات مختلف تمامًا (طالما أنك تملك الإذن بتعديل المحتوى في جدول البيانات هذا). لطباعة النتائج إلى جدول بيانات مختلف، انسخ عنوان URL لجدول البيانات والصقه في الخلية على يسار المعلمة "spreadsheet-url".

جدولة التقارير لتشغيلها تلقائيًا

يمكنك تفعيل التقارير تلقائيًا عن طريق اختيار "إضافة إضافات" > "Google Analytics" > "جدولة التقارير"من شريط القوائم. سيؤدي هذا إلى فتح مربّع حوار لجدولة التقارير يمكنك من خلاله تفعيل الجدولة وإيقافها، وإعداد عدد مرات تشغيل تقريرك.

لتفعيل الجدولة، ضَع علامة في المربّع "&& مفعّلة، فعِّل التقارير لتشغيلها تلقائيًا." بعد تفعيل الجدولة، يمكنك استخدام القائمة المنسدلة المحدّدة للتحكّم في الوقت ومعدل التكرار. يمكن جدولة التقارير لتشغيلها كل ساعة أو يوم أو أسبوع أو شهر.

لإيقاف الجدولة، أزِل العلامة من المربّع المسمى "تفعيل التقارير لتشغيلها تلقائيًا."

حالات الاستخدام الشائعة

طلب البحث للبيانات من ملفات شخصية متعددة

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

إنشاء عمليات حسابية مخصّصة باستخدام بيانات "إحصاءات Google"

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

إنشاء لوحات البيانات مع تمثيلات بصرية مضمّنة

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

التحكم بسهولة في الأشخاص الذين يمكنهم رؤية بياناتك في "إحصاءات Google"

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

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

تعديل بياناتك والرسوم البيانية تلقائيًا

بعد إنشاء التقارير أو تضمين تمثيل مرئي على موقع إلكتروني تابع لجهة خارجية، يمكنك ضمان تحديث بياناتك دائمًا من خلال جدولة التقارير لتشغيلها تلقائيًا.

الأسئلة الشائعة

كيف يمكنني معرفة الوقت الذي سيتم فيه تشغيل تقاريري المجدولة التالية؟

وسيتم إجراء أول تقرير من التقارير المجدولة بشكل عشوائي خلال الفترة الزمنية التي تحدّدها. ومن المتوقّع حدوث عمليات لاحقة في الوقت نفسه، مع الفصل بينها وبين الفاصل الزمني الذي اخترته. على سبيل المثال، إذا حددت موعدًا لإعداد التقارير يوميًا بين الساعة 4 صباحًا و5 صباحًا، وحدث العرض الأول في الساعة 4:12 صباحًا، ستظهر جميع عمليات التشغيل اللاحقة في الساعة 4:12 صباحًا.

لم يتم تشغيل تقاريري المجدوَلة في الوقت الذي كان من المفترض أن تظهر فيه، هل معطّل؟

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

هل يمكنني إعداد جداول زمنية مختلفة للتقارير المختلفة؟

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

لماذا تظهر بيانات تقاريري بتنسيق غير صحيح؟

تعرض واجهات برمجة التطبيقات لإعداد التقارير في "إحصاءات Google" جميع القيم بتنسيق الولايات المتحدة. وفي حال ضبط جدول البيانات على لغة مختلفة، سيحاول تطبيق "جداول بيانات Google" إجراء إحالة ناجحة نيابةً عنك، ما قد يؤدي في بعض الأحيان إلى نتائج غير متوقعة.

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

الحصول على المساعدة

لطرح سؤال عن الإضافة أو للإبلاغ عن خطأ، انشر رسالة إلى مجموعة Google google-analytics-spreadsheet-add-on. ابحث في المجموعة قبل نشرها، إذ ربما تمت الإجابة عن سؤالك.

مرجع مَعلمة الضبط

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

المعلمات المطلوبة

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

تاريخ بدء جلب بيانات "إحصاءات Google". يمكن أن تحدّد الطلبات تاريخ البدء بالتنسيق YYYY-MM-DD أو تاريخ نسبي (على سبيل المثال، today أو yesterday أو NdaysAgo حيث يكون N عددًا صحيحًا موجبًا.

يمكنك أيضًا استخدام دوال تاريخ "جداول بيانات Google" لتحديد هذه القيمة آليًا. على سبيل المثال، يعرض التعبير التالي اليوم الأخير من الشهر السابق:

=EOMONTH(TODAY(), -1)
تاريخ الانتهاء

تاريخ الانتهاء لجلب بيانات "إحصاءات Google". يمكن أن تحدّد الطلبات تاريخ الانتهاء بتنسيق YYYY-MM-DD أو تاريخ نسبي (على سبيل المثال، today أو yesterday أو NdaysAgo حيث يكون N عددًا صحيحًا موجبًا.

يمكنك أيضًا استخدام دوال تاريخ "جداول بيانات Google" لتحديد هذه القيمة آليًا. على سبيل المثال، يعرض التعبير التالي اليوم الأخير من الشهر السابق:

=EOMONTH(TODAY(), -1)
المقاييس

قائمة المقاييس المطلوب إجراء طلب بحث بشأنها. يمكن تحديد المقاييس بأحد التنسيقين:

على سبيل المثال، جميع ما يلي هي قيم صالحة لمعلّمة المقاييس.

ga:sessions,ga:bounces
ga:sessions
ga:bounces
[{
  "expression": "ga:sessions/ga:users",
  "alias": "Sessions per User",
  "formattingType": "FLOAT"
}, {
  "expression": "ga:totalEvents/ga:pageviews",
  "alias": "Events per Pageview",
  "formattingType": "FLOAT"
}]

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

تتوفّر القائمة الكاملة للسمات والمقاييس ومجموعاتها الصالحة باستخدام مستكشف السمات والمقاييس.

المعلمات الاختيارية

الاسم الوصف
الأبعاد

قائمة بالأبعاد لطلب البحث. يمكن تحديد الأبعاد بأحد التنسيقَين:

على سبيل المثال، جميع ما يلي هي قيم صالحة لمعلّمة المقاييس.

ga:source,ga:deviceCategory
ga:source
ga:deviceCategory
[{
  "name": "ga:source"
}, {
  "name": "ga:deviceCategory"
}]

في معظم حالات الاستخدام، تُعدّ قائمة أرقام تعريف السمات أسهل طريقة لتحديد معلّمة السمات.

تتوفّر القائمة الكاملة للسمات والمقاييس ومجموعاتها الصالحة باستخدام مستكشف السمات والمقاييس.
الطلب

نظام ترتيب النتائج حسب العمود (رقم تعريف المقياس أو المكوّن) والاتجاه (تصاعدي أو تنازلي). ويمكن تحديد الطلب بأحد التنسيقين التاليين:

على سبيل المثال، جميع ما يلي هي قيم صالحة لمعلمة الطلب.

-ga:sessions,ga:eventLabel
-ga:sessions
ga:eventLabel
[{
  "fieldName": "ga:sessions",
  "sortOrder": "DESCENDING"
}, {
  "fieldName": "ga:eventLabel",
  "sortOrder": "ASCENDING",
  "orderType": "DIMENSION_AS_INTEGER"
}]

بالنسبة إلى معظم حالات الاستخدام، يمثّل التنسيق القديم أسهل طريقة لتحديد معلّمة الطلب. إذا كنت تريد استخدام مَعلمة orderType، عليك تحديد القيمة على أنها JSON.
الفلاتر

الشروط التي تتيح لك تقييد مجموعة النتائج التي يتم عرضها يمكن تحديد الفلاتر بأحد التنسيقَين:

على سبيل المثال، أي مما يلي عبارة عن قيم صالحة لمعلمة الفلاتر.

ga:sessions>10;ga:country==United States
{
  "metricFilterClauses": [{
    "filters": [
      {
        "metricName": "ga:totalEvents",
        "operator": "GREATER_THAN",
        "comparisonValue": "100"
      }
    ]
  }],
  "dimensionFilterClauses": [{
    "operator": "AND",
    "filters": [
      {
        "dimensionName": "ga:eventCategory",
        "operator": "EXACT",
        "expressions": ["Outbound Link"]
      }
    ],
    "filters": [
      {
        "dimensionName": "ga:eventAction",
        "operator": "EXACT",
        "expressions": ["click"]
      }
    ]
  }]
}

بالنسبة إلى معظم حالات الاستخدام، يمثّل التنسيق القديم أسهل طريقة لتحديد معلّمة الفلاتر. إذا كنت بحاجة إلى إجراء فلترة متقدمة (على سبيل المثال، استخدام عوامل تشغيل المقارنة في الأبعاد)، يجب تحديد القيمة في صورة JSON.
الشرائح

الشروط التي تسمح لك بتقييد مجموعة الجلسات أو المستخدمين الذين ينطبق عليهم طلب بحثك. يمكن تحديد الشرائح بأحد التنسيقين التاليين:

على سبيل المثال، أيٌّ من القيم التالية يمثّل قيمًا صالحة لمعلّمة الشرائح.

gaid::-1,sessions::condition::ga:city==New York
gaid::-1,
sessions::condition::ga:city==New York
[{
  "dynamicSegment": {
    "name": "New York Sessions",
    "sessionSegment": {
      "segmentFilters": [{
        "simpleSegment": {
          "orFiltersForSegment": [{
            "segmentFilterClauses":[{
              "dimensionFilter": {
                "dimensionName": "ga:city",
                "expressions": ["New York"]
              }
            }]
          }]
        }
      }]
    }
  }
}, {
  "dynamicSegment": {
    "name": "Non-referral Sessions",
    "sessionSegment": {
      "segmentFilters": [{
        "simpleSegment": {
          "orFiltersForSegment": [{
            "segmentFilterClauses": [{
              "dimensionFilter": {
                "dimensionName": "ga:medium",
                "operator": "EXACT",
                "expressions": [ "referral" ]
              }
            }]
          }]
        },
        "not": "True"
      }]
    }
  }
}]

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

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

عندما TRUE لن يتم تشغيل التقرير في العمود المقابل. يكون هذا الخيار مفيدًا إذا كنت تجرِّب تقريرًا جديدًا ولا تريد تشغيل جميع تقاريرك إلى أن تنتهي. وقد يكون من المفيد أيضًا تحديد ما إذا كنت تريد إيقاف تنفيذ التقارير الموجودة من قبل ولن يتم تغيير البيانات.

ملاحظة: يمكن إعداد هذا الحقل آليًا باستخدام صيغة. على سبيل المثال، سيتخطى التعبير التالي التقرير إذا كانت قيمة تاريخ الانتهاء (خلية "B5") في الماضي:

=IF(B5 < TODAY(), TRUE, FALSE)

المعلمات المخفية

الاسم ملخّص
نوع التقرير

بشكل تلقائي (أو عند ترك هذا الحقل فارغًا)، سيقدّم هذا التقرير طلب البحث عن الإصدار 4 من واجهة برمجة التطبيقات لإعداد التقارير في "إحصاءات Google". للاستعلام عن واجهة برمجة التطبيقات لإعداد تقارير المسارات المتعددة القنوات، يمكنك ضبط القيمة على "mcf".

لاحظ أنه عند استخدام واجهة برمجة تطبيقات MCF، يجب أيضًا استخدام أبعاد ومقاييس MCF. إضافةً إلى ذلك، لا تتوفّر بعض الميزات الأخرى (مثل الشرائح) في تقارير المسارات المتعددة القنوات.
مستوى أخذ العينات حجم نموذج التقرير المطلوب القيم المحتملة هي ";;Default" (كما هو الحال إذا تركتها فارغة) أو ";;;;;;; الدفعاتـ;;أو &;;LARGE&quot:
استخدام حصص الموارد نظام الحصة المستندة إلى الموارد هو نظام حصة جديد سيسمح لبعض حسابات "إحصاءات 360" بحدود أخذ عينات أعلى أثناء استخدام واجهة برمجة التطبيقات لإعداد التقارير في "إحصاءات Google". إذا كانت هذه الميزة متاحة لك، يمكنك تفعيلها من خلال ضبط هذه المعلّمة على TRUE.
استبعاد الصفوف الفارغ

تسمح لك هذه المعلّمة باستبعاد صفوف من التقرير إذا كانت جميع قيم المقياس في الصف صفرًا. السلوك التلقائي (أو عند تركه فارغًا) هو عرض كل الصفوف (يُنصح به).

تجدر الإشارة إلى أن هذه المعلّمة تتطابق مع المعلّمة includeEmptyRows في الإصدار 4 من واجهة برمجة التطبيقات لإعداد التقارير في "إحصاءات Google" ولكن تمت إعادة تسميتها من &"include;include" &"exclude"; لتسهيل فهم سلوكها المقصود.