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

تتيح لك شرائح الجمهور في "إحصاءات 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
}