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

مخاطبان در گوگل آنالیتیکس به شما این امکان را می دهند که کاربران خود را به روش هایی که برای کسب و کار شما مهم هستند تقسیم بندی کنید. با مخاطبین، می توانید کاربران سایت یا برنامه خود را بر اساس ویژگی های مشترک گروه بندی کنید.

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

برای اطلاعات مهم در مورد داده هایی که در صادرات مخاطب می بینید، به راهنمای انتظارات داده صادرات مخاطب مراجعه کنید.

نمای کلی

درخواست های Data API زیر را برای ایجاد و پرس و جو صادرات مخاطب انجام دهید:

  1. برای ایجاد صادرات مخاطب، متد audienceExports.create را صدا بزنید.
  2. برای بازیابی کاربران مخاطب از روش audienceExports.query فراخوانی کنید.

برای کسب اطلاعات بیشتر، می‌توانید برای بازیابی فراداده‌های پیکربندی در مورد صادرات مخاطب خاص audienceExports.get و برای فهرست کردن تمام صادرات مخاطبان خود برای یک ویژگی خاص با مخاطبان audienceExports.list تماس بگیرید.

یک نهاد گزارشگر را انتخاب کنید

همه روش‌های Data API نیاز دارند که شناسه ویژگی Google Analytics در یک مسیر درخواست URL، به شکل properties/GA_PROPERTY_ID مشخص شود. در اینجا یک مثال است:

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

گزارش بر اساس داده‌های رویداد Google Analytics جمع‌آوری‌شده در ویژگی Google Analytics مشخص شده ایجاد می‌شود.

اگر از یکی از کتابخانه های سرویس گیرنده Data API استفاده می کنید، نیازی به تغییر مسیر URL درخواست ندارید. اکثر کلاینت‌های API یک پارامتر property ارائه می‌کنند که انتظار رشته‌ای به شکل properties/GA_PROPERTY_ID را دارد. برای مثال هایی از استفاده از کتابخانه های سرویس گیرنده ، راهنمای شروع سریع را ببینید.

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

برای ایجاد صادرات مخاطب، با استفاده از شی AudienceExport در درخواست خود، متد audienceExports.create را فراخوانی کنید. پارامترهای زیر مورد نیاز است:

  • یک نام مخاطب معتبر در فیلد 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
}