لیست مخاطبان تکراری

این سند فهرست‌های مخاطبین تکرارشونده را توصیف می‌کند که یکی از ویژگی‌های پیشرفته Google Analytics Data API v1 است. برای آشنایی با ویژگی صادرات فهرست مخاطبان، به راهنمای اصول صادرات مخاطب مراجعه کنید.

با تغییر عضویت مخاطبان، فهرست‌های تکراری مخاطبان، روزانه فهرست‌های مخاطبان را تولید می‌کنند تا اطمینان حاصل شود که با جدیدترین داده‌ها کار می‌کنید.

فهرست‌های مخاطبین معمولی (غیر تکرارشونده) فهرست‌های ثابتی از کاربران در مخاطبان در زمان تولید فهرست هستند.

روزانه یک لیست مخاطب جدید ایجاد کنید

پردازش داده‌های مخاطب یک روز و به‌روزرسانی عضویت، زمان متغیری را می‌طلبد. هیچ راهی برای اطمینان از به‌روزرسانی داده‌های فهرست مخاطبان در 24 ساعت وجود ندارد.

به عنوان مثال، حتی اگر هر روز در همان ساعت یک لیست مخاطبان درخواست کنید، در برخی از روزها لیست مخاطبان مانند روز قبل خواهد بود و در روزهای دیگر، فهرست مخاطبان متفاوت خواهد بود و شامل یک روز عضویت اضافی است. تغییر می کند.

فهرست مخاطبان بر اساس داده‌های رویداد یک روز قبل از آخرین تغییرات عضویت است. اگر قبل از به‌روزرسانی روزانه عضویت، فهرست مخاطبان ایجاد کنید، از داده‌های دو روز قبل استفاده می‌کند. اگر پس از به‌روزرسانی‌های عضویت روزانه، فهرستی از مخاطبان ایجاد کنید، از داده‌های دیروز استفاده می‌کند.

به صورت دوره‌ای از فهرست مخاطبان تکراری نظرسنجی کنید

فهرست‌های مخاطب تکراری تنها زمانی فهرست مخاطبان را تولید می‌کنند که داده‌های یک روز اضافی در دسترس باشد. این کار حدس و گمان تصمیم گیری در مورد زمان ایجاد فهرست مخاطبان جدید را حذف می کند. درعوض، می‌توانید در طول روز از فهرست مخاطبان تکراری نظرسنجی کنید تا ببینید آیا داده‌های اضافی در دسترس است یا خیر.

فهرست مخاطبان تکرارشونده ایجاد کنید

برای ایجاد یک لیست مخاطب تکرارشونده، با استفاده از شی RecurringAudienceList در یک درخواست، متد recurringAudienceLists.create را فراخوانی کنید. پارامترهای زیر مورد نیاز است:

• یک نام مخاطب معتبر در فیلد 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 برای فهرست کردن همه فهرست‌های تکرارشونده مخاطب برای یک ملک استفاده کنید.

از Webhooks برای دریافت اعلان‌های ناهمزمان درباره فهرست‌های مخاطبان جدید استفاده کنید

به‌جای نظرسنجی دوره‌ای فراداده‌های پیکربندی درباره فهرست مخاطبان تکرارشونده خاص با استفاده از روش recurringAudienceLists.get ، می‌توانید به صورت ناهمزمان اعلان‌های Webhook را هنگامی که فهرست مخاطبان در دسترس قرار می‌گیرد دریافت کنید.

برای پیکربندی اعلان‌های Webhook، فیلد webhookNotification را هنگام ایجاد فهرست مخاطبان تکراری جدید مشخص کنید.

برای اطلاعات بیشتر در مورد استفاده از Webhooks در Google Analytics Data API v1 Async audience lists with webhooks دنبال کنید.

بازیابی کاربران در صادرات مخاطب

برای بازیابی کاربران در Audience Export، روش audienceExports.query را فراخوانی کنید و نام Audience Export بازیابی شده از فراداده پیکربندی ارائه شده توسط recurringAudienceLists.get یا recurringAudienceLists.list را مشخص کنید.

درخواست HTTP

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

اگر Audience Export آماده باشد، پاسخی حاوی لیست کاربران در یک مخاطب برگردانده می شود:

پاسخ 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
}