- درخواست HTTP
- پارامترهای مسیر
- درخواست بدن
- بدن پاسخگو
- محدوده مجوز
- بخش ترکیب مخاطب
- AudienceCompositionAttribute
- AudienceCompositionMetrics
- AudienceCompositionAttributeCluster
- آن را امتحان کنید!
مجموعهای از ویژگیها را برمیگرداند که در یک مخاطب مورد علاقه نشان داده شدهاند، با معیارهایی که سهم هر ویژگی از مخاطب را با سهم آن از مخاطبان پایه مقایسه میکند.
فهرست خطاهای پرتاب شده: AudienceInsightsError AuthenticationError AuthorizationError FieldError HeaderError داخلی خطا QuotaError RangeError RequestError
درخواست HTTP
POST https://googleads.googleapis.com/v15/customers/{customerId}:generateAudienceCompositionInsights
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
مولفه های | |
---|---|
customerId | ضروری. شناسه مشتری. |
درخواست بدن
بدنه درخواست حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{ "audience": { object ( |
زمینه های | |
---|---|
audience | ضروری. مخاطب مورد علاقه که بینش برای آنها درخواست شده است. |
baselineAudience | مخاطب اصلی که مخاطب مورد علاقه با آن مقایسه می شود. |
dataMonth | محدوده یک ماهه دادههای تاریخی که برای اطلاعات آماری استفاده میشود، در قالب «yyyy-mm». اگر تنظیم نشود، اطلاعات آماری برای دادههای سی روز گذشته بازگردانده میشود. |
dimensions[] | ضروری. ابعاد مخاطبی که بینش ترکیب باید برای آنها برگردانده شود. |
customerInsightsGroup | نام مشتری که برای آن برنامه ریزی شده است. این یک مقدار تعریف شده توسط کاربر است. |
بدن پاسخگو
پیام پاسخ برای AudienceInsightsService.GenerateAudienceCompositionInsights
.
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{
"sections": [
{
object ( |
زمینه های | |
---|---|
sections[] | محتوای گزارش بینش، در بخشهایی سازماندهی شده است. هر بخش با یکی از مقادیر AudienceInsightsDimension در درخواست مرتبط است. ممکن است در هر بعد بیش از یک بخش وجود داشته باشد. |
محدوده مجوز
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/adwords
برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.
بخش ترکیب مخاطب
مجموعه ای از ویژگی های مرتبط از یک نوع در گزارش بینش ترکیب مخاطب.
نمایندگی JSON |
---|
{ "dimension": enum ( |
زمینه های | |
---|---|
dimension | نوع ویژگی های این بخش. |
topAttributes[] | مرتبط ترین بخش ها برای این مخاطبان. اگر بعد GENDER، AGE_RANGE یا PARENTAL_STATUS باشد، این لیست از ویژگی ها جامع است. |
clusteredAttributes[] | ویژگیهای اضافی برای این مخاطب، در خوشهها گروهبندی شدهاند. فقط در صورتی پر می شود که بعد YOUTUBE_CHANNEL باشد. |
AudienceCompositionAttribute
ویژگی مخاطب با فراداده و معیارها.
نمایندگی JSON |
---|
{ "attributeMetadata": { object ( |
زمینه های | |
---|---|
attributeMetadata | ویژگی با ابرداده هایش. |
metrics | معیارهای به اشتراک گذاری و فهرست بندی برای ویژگی. |
AudienceCompositionMetrics
معیارهای سهم و شاخص مرتبط با یک ویژگی در گزارش بینش ترکیب مخاطب.
نمایندگی JSON |
---|
{ "baselineAudienceShare": number, "audienceShare": number, "index": number, "score": number } |
زمینه های | |
---|---|
baselineAudienceShare | کسری (از 0 تا 1 شامل) از مخاطبان پایه که با ویژگی مطابقت دارد. |
audienceShare | کسری (از 0 تا 1 شامل) از مخاطب خاص که با ویژگی مطابقت دارد. |
index | نسبت مخاطبین به اشتراک مخاطب پایه، یا اگر این نسبت تعریف نشده باشد یا معنی دار نباشد، صفر است. |
score | یک امتیاز مرتبط از 0 تا 1 شامل. |
AudienceCompositionAttributeCluster
مجموعه ای از ویژگی های مرتبط، با فراداده و معیارها، در گزارش بینش ترکیب مخاطب.
نمایندگی JSON |
---|
{ "clusterDisplayName": string, "clusterMetrics": { object ( |
زمینه های | |
---|---|
clusterDisplayName | نام این خوشه از صفات |
clusterMetrics | اگر بعد مرتبط با این خوشه YOUTUBE_CHANNEL باشد، ClusterMetrics معیارهایی است که با کل خوشه مرتبط است. برای سایر ابعاد، این فیلد تنظیم نشده است. |
attributes[] | ویژگی های فردی که این خوشه را با متادیتا و معیارها تشکیل می دهند. |