Method: customers.generateInsightsFinderReport

یک گزارش ذخیره شده ایجاد می کند که می تواند در ابزار Insights Finder مشاهده شود.

لیست خطاهای پرتاب شده: AuthenticationError AuthorizationError FieldError HeaderError داخلی خطا QuotaError RangeError RequestError

درخواست HTTP

POST https://googleads.googleapis.com/v14/customers/{customerId}:generateInsightsFinderReport

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

مولفه های
customerId

string

ضروری. شناسه مشتری.

درخواست بدن

بدنه درخواست حاوی داده هایی با ساختار زیر است:

نمایندگی JSON
{
  "baselineAudience": {
    object (BasicInsightsAudience)
  },
  "specificAudience": {
    object (BasicInsightsAudience)
  },
  "customerInsightsGroup": string
}
زمینه های
baselineAudience

object ( BasicInsightsAudience )

ضروری. مخاطبان اصلی این گزارش، معمولاً همه مردم یک منطقه.

specificAudience

object ( BasicInsightsAudience )

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

customerInsightsGroup

string

نام مشتری که برای آن برنامه ریزی شده است. این یک مقدار تعریف شده توسط کاربر است.

بدن پاسخگو

پیام پاسخ برای AudienceInsightsService.GenerateInsightsFinderReport ، حاوی URL قابل اشتراک‌گذاری برای گزارش.

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:

نمایندگی JSON
{
  "savedReportUrl": string
}
زمینه های
savedReportUrl

string

یک نشانی وب HTTPS که یک پیوند عمیق به رابط کاربری Insights Finder ارائه می‌کند که ورودی‌های گزارش مطابق درخواست پر شده است.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/adwords

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.

BasicInsightsAudience

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

نمایندگی JSON
{
  "countryLocation": [
    {
      object (LocationInfo)
    }
  ],
  "subCountryLocations": [
    {
      object (LocationInfo)
    }
  ],
  "gender": {
    object (GenderInfo)
  },
  "ageRanges": [
    {
      object (AgeRangeInfo)
    }
  ],
  "userInterests": [
    {
      object (UserInterestInfo)
    }
  ],
  "topics": [
    {
      object (AudienceInsightsTopic)
    }
  ]
}
زمینه های
countryLocation[]

object ( LocationInfo )

ضروری. کشورهای برای این مخاطب.

subCountryLocations[]

object ( LocationInfo )

ویژگی های موقعیت جغرافیایی زیرکشور در صورت وجود، هر یک از اینها باید در یکی از کشورهای این مخاطبین موجود باشد.

gender

object ( GenderInfo )

جنسیت برای مخاطب در صورت عدم حضور، مخاطب بر اساس جنسیت محدودیت ایجاد نمی کند.

ageRanges[]

object ( AgeRangeInfo )

محدوده سنی برای مخاطب در صورت عدم حضور، مخاطب نماینده همه افراد بالای 18 سال است که با سایر ویژگی ها مطابقت دارند.

userInterests[]

object ( UserInterestInfo )

علایق کاربر این مخاطب را تعریف می کند. مخاطبان Affinity و In-Market پشتیبانی می شوند.

topics[]

object ( AudienceInsightsTopic )

موضوعاتی که توسط نهادهای نمودار دانش و/یا دسته‌های محصول و خدمات ارائه می‌شوند و این مخاطبان به آن‌ها علاقه دارند.

AudienceInsightsTopic

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

نمایندگی JSON
{

  // Union field topic can be only one of the following:
  "entity": {
    object (AudienceInsightsEntity)
  },
  "category": {
    object (AudienceInsightsCategory)
  }
  // End of list of possible types for union field topic.
}
زمینه های
topic حوزه اتحادیه . یک موجودیت یا ویژگی دسته. topic می تواند تنها یکی از موارد زیر باشد:
entity

object ( AudienceInsightsEntity )

یک موجودیت نمودار دانش

category

object ( AudienceInsightsCategory )

دسته بندی محصولات و خدمات