قوائم المستخدِمين المتكرّرة

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

تنتج قوائم المستخدمين المتكرّرة قوائم المستخدمين يوميًا تتغير عضويات الجمهور، لضمان أنّك تستخدم أحدث البيانات.

قوائم المستخدمين العادية (غير المتكرّرة) هي قوائم ثابتة للمستخدمين في شريحة الجمهور. في وقت إنشاء القائمة.

إنشاء قائمة مستخدمين جديدة يوميًا

تستغرق معالجة بيانات الجمهور ليوم واحد وتعديلها مدّة متغيرة من الوقت. العضوية. وليست هناك طريقة للتأكّد من تعديل بيانات قائمة المستخدمين في كل 24 ساعة.

على سبيل المثال، حتى إذا طلبت قائمة مستخدمين في الوقت نفسه كل يوم، في بعض الأيام ستكون قائمة المستخدمين هي نفسها في اليوم السابق، وفي أيام أخرى، ستكون قائمة الجمهور مختلفة يحتوي على يوم إضافي من تغييرات العضوية.

تستند قوائم المستخدمين إلى بيانات الأحداث قبل يوم واحد من آخر يوم. تغييرات العضوية. في حال إنشاء قائمة مستخدمين قبل الاشتراك اليومي حدوث تحديثات، فسيستخدم البيانات من اليومين السابقين. إذا قمت بإنشاء المستخدمين بعد تحديثات الاشتراكات اليومية، ستستخدم البيانات من أمس.

إجراء استطلاع دوري لقائمة مستخدمين متكرّرة

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

إنشاء قائمة مستخدمين متكرّرة

لإنشاء قائمة مستخدمين متكرّرة، يُرجى الاتصال بالرقم recurringAudienceLists.create باستخدام RecurringAudienceList كائن في الطلب. المعلمات التالية مطلوبة:

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

في ما يلي نموذج لطلب إنشاء قائمة مستخدمين متكرّرة:

طلب HTTP

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

تحتوي استجابة الطريقة recurringAudienceLists.create على اسم في الحقل name (مثل properties/1234567/recurringAudienceLists/123)، والتي يمكن استخدامها في الاستعلامات اللاحقة لاسترداد بيانات التعريف الخاصة بالتهيئة لقائمة المستخدمين المتكررة هذه. تحتوي أيضًا بيانات التعريف للتهيئة على أسماء الموارد لمثيلات قائمة المستخدمين تم إنشاؤه لقائمة المستخدمين المتكررة هذه.

استجابة HTTP

{
  "name": "properties/1234567/recurringAudienceLists/123",
  "audience": "properties/1234567/audiences/12345",
  "audienceDisplayName": "Purchasers",
  "dimensions": [
    {
      "dimensionName": "deviceId"
    }
  ],
  "activeDaysRemaining": 180,
  "audienceLists": [
    "properties/1234567/audienceLists/45678"
  ]
}

البيانات الوصفية لإعدادات الاستطلاع

يمكنك استخدام recurringAudienceLists.get لاسترداد بيانات التعريف حول عنصر معين قائمة المستخدمين المتكرّرين تحتوي بيانات التعريف للتهيئة على أسماء الموارد لمثيلات قائمة المستخدمين تم إنشاؤه لقائمة المستخدمين المتكررة هذه.

وفي ما يلي مثال لذلك:

طلب HTTP

GET https://analyticsdata.googleapis.com/v1alpha/properties/1234567/recurringAudienceLists/123

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

استجابة HTTP

{
  "name": "properties/1234567/recurringAudienceLists/123",
  "audience": "properties/1234567/audiences/12345",
  "audienceDisplayName": "Purchasers",
  "dimensions": [
    {
      "dimensionName": "deviceId"
    }
  ],
  "activeDaysRemaining": 180,
  "audienceLists": [
    "properties/1234567/audienceLists/45678"
  ]
}

يمكنك استخدام recurringAudienceLists.list لإدراج جميع قوائم المستخدمين المتكرّرة لأحد المواقع.

استخدام الردود التلقائية على الويب لتلقّي إشعارات غير متزامنة حول قوائم المستخدمين الجديدة

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

لضبط إشعارات الرد التلقائي على الويب، حدِّد webhookNotification عند إنشاء قائمة مستخدمين متكرّرة جديدة.

اتّباع دليل Async audience lists with webhooks للحصول على مزيد من المعلومات عن استخدام الردود التلقائية على الويب في الإصدار 1 من Google Analytics Data API.

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

لاسترداد المستخدمين في عملية تصدير بيانات الجمهور، يمكنك استدعاء دالة الرسم audienceExports.query وتحديد اسم تصدير الجمهور من بيانات التعريف الخاصة بالتهيئة التي يوفرها recurringAudienceLists.get أو recurringAudienceLists.list.

طلب 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
}