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

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

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

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

نظرة عامة

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

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

لمزيد من المعلومات، يمكنك الاتصال بالرقم audienceExports.get ل retrieving metadata about a specific audience export، وaudienceExports.list ل listing all your audience exports for a specific property.

اختيار كيان إعداد التقارير

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

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

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

إذا كنت تستخدِم إحدى مكتبات عملاء Data API، لست بحاجة إلى تغيير مسار عنوان URL للطلب. يقدّم معظم عملاء واجهة برمجة التطبيقات مَعلمة 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 يمكن العثور على قائمة السمات المتوافقة مع هذه الطريقة في مستندات مخطّط تصدير شرائح الجمهور. لا يتم تضمين سوى بيانات السمات المذكورة في هذا الحقل في عملية تصدير ملف تعريف الجمهور.

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

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

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

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

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

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

استخدِم اسم تصدير شريحة الجمهور من استجابة 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.

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

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

في ما يلي نموذج طلب:

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
}