أساسيات تصدير الجمهور

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

باستخدام الإصدار 1 من Google Analytics Data API، يمكنك إنشاء عمليات تصدير لشرائح الجمهور والتي تتضمّن نبذة عن المستخدِمين في شريحة الجمهور.

إنشاء عملية تصدير للجمهور

يستخدِم الإصدار الأول من Data API على "إحصاءات Google" منهجًا غير متزامن لإنشاء عمليات تصدير شرائح الجمهور. أولاً، من الضروري إرسال طلب إلى طريقة audienceExports.create لإنشاء بيانات تصدير للجمهور من المستخدمين. بعد ذلك، يتم استخدام الإجراء audienceExports.query لاسترداد المستخدمين في الجمهور.

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

اختيار جهة إعداد التقارير

تتطلّب جميع طرق الإصدار 1 من Data API تحديد معرّف الموقع على "إحصاءات Google 4" داخل مسار طلب عنوان URL على شكل properties/GA4_PROPERTY_ID، مثل:

  POST  https://analyticsdata.googleapis.com/v1beta/properties/GA4_PROPERTY_ID/audienceExports

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

وإذا كنت تستخدم إحدى مكتبات عملاء واجهة برمجة التطبيقات للبيانات، لن تكون هناك حاجة لمعالجة مسار عنوان URL للطلب يدويًا. توفّر معظم برامج واجهة برمجة التطبيقات معلَمة property التي تتوقع سلسلة في شكل properties/GA4_PROPERTY_ID. راجع دليل البدء السريع للحصول على أمثلة على استخدام مكتبات العملاء.

طلب إنشاء عملية تصدير شرائح الجمهور

لإنشاء عملية تصدير من الجمهور، يمكنك استدعاء طريقة audienceExports.create باستخدام كائن AudienceExport في طلب. المَعلمات التالية مطلوبة:

• اسم شريحة جمهور صالح في الحقل audience، بتنسيق properties/{propertyId}/audiences/{audienceId}. ويمكنك استخدام طريقة audiences.list من الإصدار 1 من Google Analytics Admin API للحصول على هذه القيمة. يحتوي الحقل Audience.name للاستجابة audiences.list على اسم شريحة الجمهور.
• قائمة صالحة بالسمات في الحقل dimensions. يمكن العثور على قائمة السمات المتوافقة مع هذه الطريقة في مستندات مخطط تصدير الجمهور. لا يتم تضمين سوى بيانات السمات المذكورة في هذا الحقل في عملية تصدير شرائح الجمهور.

مثال على طلب إنشاء تصدير الجمهور:

POST https://analyticsdata.googleapis.com/v1beta/properties/1234567/audienceExports
{
  "audience": "properties/1234567/audiences/12345",
  "dimensions": [
    {
      "dimensionName": "deviceId"
    }
  ]
}

تحتوي الاستجابة لطريقة audienceExports.create على اسم تصدير الجمهور في حقل name (مثل properties/1234567/audienceExports/123)، والذي يمكن استخدامه في طلبات البحث اللاحقة لاسترداد المستخدمين من تصدير الجمهور.

{
  "response": {
    "@type": "type.googleapis.com/google.analytics.data.v1alpha.AudienceExport",
    "name": "properties/1234567/audienceExports/123",
    "audience": "properties/1234567/audiences/12345",
    "audienceDisplayName": "Purchasers",
    "dimensions": [
      {
        "dimensionName": "deviceId"
      }
    ],
    "state": "CREATING",
    "beginCreatingTime": "2023-06-22T23:35:28.787910949Z"
  }
}

طلب بحث عن حالة جاهزية تصدير الجمهور

قد يستغرِق إنشاء "تصدير الجمهور" عدّة دقائق بعد مكالمة audienceExports.create. يمكنك الحصول على حالة الجاهزية لتصدير بيانات الجمهور من خلال استدعاء طريقة audienceExports.get.

استخدِم اسم تصدير شريحة الجمهور (مثل properties/1234567/audienceExports/123) الذي تلقّيته من ردّ audienceExports.create لتحديد عملية تصدير الجمهور.

مثال:

GET https://analyticsdata.googleapis.com/v1beta/properties/1234567/audienceExports/123

يتم عرض حالة الجاهزية لتصدير بيانات الجمهور في حقل state ضمن الردّ. بعد اكتمال عملية إنشاء تصدير بيانات الجمهور، تتغيّر حالتها من "CREATING" إلى "ACTIVE".

{
  "name": "properties/1234567/audienceExports/123",
  "audience": "properties/1234567/audiences/12345",
  "audienceDisplayName": "Purchasers",
  "dimensions": [
    {
      "dimensionName": "deviceId"
    }
  ],
  "state": "CREATING",
  "beginCreatingTime": "2023-06-22T23:35:28.787910949Z"
}

يمكنك التعرّف على حالة جميع عمليات تصدير بيانات الجمهور عن طريق استدعاء الطريقة audienceExports.list.

استرداد المستخدِمين في عملية تصدير للجمهور

بعد إنشاء بيانات Audience Export التي تم إنشاؤها باستخدام طريقة audienceExports.create، يمكنك استدعاء طريقة audienceExports.query وتحديد اسم تصدير شريحة الجمهور (مثل properties/1234567/audienceExports/123).

POST https://analyticsdata.googleapis.com/v1beta/properties/1234567/audienceExports/123:query

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

{
  "audienceExport": {
    "name": "properties/1234567/audienceExports/123",
    "audience": "properties/1234567/audiences/12345",
    "audienceDisplayName": "Purchasers",
    "dimensions": [
      {
        "dimensionName": "deviceId"
      }
    ],
    "state": "ACTIVE",
    "beginCreatingTime": "2023-06-22T23:35:28.787910949Z"
  },
  "audienceRows": [
    {
      "dimensionValues": [
        {
          "value": "1000276123.1681742376"
        }
      ]
    },
    {
      "dimensionValues": [
        {
          "value": "1000374452.1668627377"
        }
      ]
    },
    {
      "dimensionValues": [
        {
          "value": "1000391956.1652750758"
        }
      ]
    },
    {
      "dimensionValues": [
        {
          "value": "1000410539.1682018694"
        }
      ]
    },
    {
      "dimensionValues": [
        {
          "value": "1000703969.1666725875"
        }
      ]
    }
  ],
  "rowCount": 5
}

توقعات بيانات تصدير الجمهور

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

حداثة البيانات

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

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

عمليات تصدير الجمهور هي لقطات

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

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

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

انتهاء صلاحية عمليات تصدير الجمهور

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

الحدود القصوى لعدد المستخدمين الذين يصدّرون شرائح الجمهور

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

اتساق المعلومات التعريفية في التقارير

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

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

الاتّساق عند إضافة البيانات السابقة

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

على سبيل المثال، إذا سجَّل أحد المستخدِمين حدث شراء في 20 حزيران (يونيو) وأنشأتَ شريحة جمهور باسم "المشترون" في 21 حزيران (يونيو)، عليك على الأرجح الانتظار حتى 22 حزيران (يونيو) لكي يظهر هذا المستخدِم في "عمليات تصدير شرائح الجمهور" الجديدة. في المقابل، لن يكون هذا المستخدِم مُدرَجًا في تقرير "تصدير البيانات إلى الجمهور" إلا إذا سجَّل أي حدث في 21 حزيران (يونيو).