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

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

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

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

نظرة عامة

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

  1. يمكنك الاتصال بالرقم audienceExports.create. لإنشاء تصدير للجمهور.
  2. يمكنك الاتصال بالرقم audienceExports.query. تُستخدم لاسترداد المستخدمين في الجمهور.

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

اختيار كيان قائم بالإبلاغ

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

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

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

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

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

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

  • اسم جمهور صالح في audience بتنسيق properties/{propertyId}/audiences/{audienceId}. يمكنك استخدام audiences.list Google Analytics Admin API v1 للحصول على هذه القيمة. تشير رسالة الأشكال البيانية 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
}