REST Resource: properties.recurringAudienceLists

منبع: RecurringAudienceList

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

نمایندگی JSON 
{
  "name": string,
  "audience": string,
  "audienceDisplayName": string,
  "dimensions": [
    {
      object (AudienceDimension)
    }
  ],
  "audienceLists": [
    string
  ],
  "activeDaysRemaining": integer,
  "webhookNotification": {
    object (WebhookNotification)
  }
}
فیلدها
name

string

فقط خروجی شناسه. نام منبع فهرست مخاطبان تکراری که در حین ایجاد اختصاص داده شده است. این نام منبع این RecurringAudienceList را مشخص می کند.

قالب: properties/{property}/recurringAudienceLists/{recurringAudienceList}

audience

string

مورد نیاز. نام منبع مخاطب این نام منبع، مخاطبین لیست شده را شناسایی می کند و بین APIهای Analytics Data و Admin به اشتراک گذاشته می شود.

قالب: properties/{property}/audiences/{audience}

audienceDisplayName

string

فقط خروجی نام نمایشی توصیفی برای این مخاطب. مثلاً «خریداران».

dimensions[]

object ( AudienceDimension )

مورد نیاز. ابعاد درخواست شده و در پاسخ لیست مخاطبان نمایش داده می شود.

audienceLists[]

string

فقط خروجی نام‌های منابع فهرست مخاطبان برای نمونه‌های فهرست مخاطبان ایجاد شده برای این فهرست مخاطب تکراری. برای هر روز یک لیست مخاطب ایجاد می شود و لیست مخاطبان در اینجا فهرست می شود.

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

activeDaysRemaining

integer

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

درخواست لیست مخاطب تکراری برای ویژگی های Analytics 360 به طور پیش فرض ۱۸۰ روز و حداکثر ۳۶۵ روز است. درخواست‌های خصوصیات استاندارد Analytics به‌طور پیش‌فرض ۱۴ روز و حداکثر ۳۰ روز است.

حداقل مقدار مجاز در هنگام ایجاد 1 است. درخواست‌های بالاتر از حداکثر مربوطه به حداکثر خود اجباری می‌شوند.

webhookNotification

object ( WebhookNotification )

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

هر بار که یک لیست مخاطب تکراری یک لیست مخاطب ایجاد می کند، دو درخواست POST ارسال می شود. این یک بار در روز اتفاق می‌افتد تا زمانی که فهرست مخاطبان تکراری به 0 روز باقی‌مانده فعال برسد. اولین درخواست ارسال می‌شود که فهرست مخاطبان جدید ایجاد شده را در حالت ایجاد آن نشان می‌دهد. درخواست دوم پس از تکمیل لیست مخاطبان (حالت فعال یا FAILED) ارسال می شود.

روش ها

create

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

get

 فراداده پیکربندی را در مورد یک لیست مخاطب خاص تکراری دریافت می کند.

list

 همه فهرست‌های تکراری مخاطبان یک ملک را فهرست می‌کند.