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

مخاطبان در Google Analytics 4 به شما امکان می دهند کاربران خود را به روش هایی که برای تجارت شما مهم هستند تقسیم بندی کنید. با مخاطبین، می توانید کاربران سایت یا برنامه خود را بر اساس ویژگی های مشترک گروه بندی کنید.

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

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

بررسی اجمالی

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

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

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

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

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

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

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

اگر از یکی از کتابخانه های سرویس گیرنده Data API استفاده می کنید، نیازی به تغییر مسیر URL درخواست ندارید. اکثر سرویس گیرندگان API یک پارامتر property را ارائه می دهند که انتظار رشته ای به شکل properties/GA4_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
}