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

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

يمكنك تصدير شرائح جمهورك، بما في ذلك لقطة للمستخدمين، باستخدام Data API.

راجِع دليل توقّعات بيانات تصدير شرائح الجمهور للحصول على معلومات مهمة حول البيانات التي تظهر لك في عمليات تصدير شرائح الجمهور.

نظرة عامة

أرسِل طلبات Data API التالية لإنشاء عملية تصدير شرائح الجمهور والاستعلام عنها:

  1. استدعِ طريقة audienceExports.create لإنشاء عملية تصدير لشرائح الجمهور.
  2. يتم استخدام طريقة audienceExports.query لاسترداد المستخدمين في شريحة الجمهور.

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

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

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

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

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

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

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

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

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

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

طلب HTTP

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

يتضمّن ردّ الطريقة audienceExports.create اسم عملية تصدير شرائح الجمهور في الحقل name، مثل properties/1234567/audienceExports/123. في ما يلي نموذج ردّ:

استجابة HTTP

{
  "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"
  }
}

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

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

قد يستغرق إنشاء عملية تصدير شرائح الجمهور عدة دقائق بعد إجراء طلب audienceExports.create.

يمكنك التحقّق من حالة الاستعداد لتصدير شرائح الجمهور من خلال استدعاء طريقة audienceExports.get.

استخدِم اسم تصدير شريحة الجمهور من ردّ audienceExports.create لتحديد عملية تصدير شريحة الجمهور في طلبك.

إليك نموذج طلب:

طلب HTTP

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

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

في ما يلي نموذج ردّ:

استجابة HTTP

{
  "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.

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

بعد إنشاء عملية تصدير شرائح الجمهور، استخدِم طريقة audienceExports.query، وحدِّد name لعملية تصدير شرائح الجمهور في الطلب.

إليك نموذج طلب:

طلب HTTP

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

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

في ما يلي نموذج ردّ:

استجابة HTTP

{
  "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
}