Method: customers.generateAudienceOverlapInsights

הפונקציה מחזירה אוסף של מאפייני קהלים, יחד עם אומדנים של החפיפה בין פוטנציאל החשיפה שלהם ב-YouTube לבין פוטנציאל החשיפה של מאפיין קלט נתון.

רשימת השגיאות שהושלחו: AudienceInsightsError AuthenticationError AuthorizationError FieldError HeaderError InternalError QuotaError RangeError RequestError

בקשת HTTP

POST https://googleads.googleapis.com/v17/customers/{customerId}:generateAudienceOverlapInsights

כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.

פרמטרים של נתיב

פרמטרים
customerId

string

חובה. המזהה של הלקוח.

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג ב-JSON 
{
  "countryLocation": {
    object (LocationInfo)
  },
  "primaryAttribute": {
    object (AudienceInsightsAttribute)
  },
  "dimensions": [
    enum (AudienceInsightsDimension)
  ],
  "customerInsightsGroup": string
}
שדות
countryLocation

object (LocationInfo)

חובה. המדינה שבה יתבצע החישוב של הגדלים והחפיפות של הקהלים.
primaryAttribute

object (AudienceInsightsAttribute)

חובה. מאפיין הקהל שצריך ליצור לו חפיפה עם כל שאר הקהלים שעומדים בדרישות. הערך הזה חייב להיות 'תחומי עניין' או 'תחומי עניין של משתמשים בשוק', 'טווח גיל' או 'מגדר'.
dimensions[]

enum (AudienceInsightsDimension)

חובה. סוגי המאפיינים שעבורם מחושב החפיפה ל-primaryAttribute. הערכים חייבים להיות קבוצת משנה של AFFINITY_USER_INTEREST, ‏ IN_MARKET_USER_INTEREST, ‏ AGE_RANGE ו-GENDER.
customerInsightsGroup

string

שם הלקוח שעבורו מתבצע התכנון. זהו ערך שהמשתמש מגדיר.

גוף התשובה

הודעת התשובה עבור AudienceInsightsService.GenerateAudienceOverlapInsights.

אם הפעולה מצליחה, גוף התגובה מכיל נתונים במבנה הבא:

ייצוג ב-JSON 
{
  "primaryAttributeMetadata": {
    object (AudienceInsightsAttributeMetadata)
  },
  "dimensionResults": [
    {
      object (DimensionOverlapResult)
    }
  ]
}
שדות
primaryAttributeMetadata

object (AudienceInsightsAttributeMetadata)

מטא-נתונים של המאפיין הראשי, כולל פוטנציאל החשיפה ב-YouTube.
dimensionResults[]

object (DimensionOverlapResult)

רשימות של מאפיינים והחפיפה שלהם למאפיין הראשי, רשימה אחת לכל מאפיין מבוקש.

היקפי הרשאה

נדרש היקף הרשאות OAuth הבא:

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

מידע נוסף זמין בOAuth 2.0 Overview.

DimensionOverlapResult

רשימה של מאפייני קהל של מאפיין יחיד, כולל החפיפה שלהם למאפיין ראשי, שמוחזרת כחלק מ-GenerateAudienceOverlapInsightsResponse.

ייצוג ב-JSON 
{
  "dimension": enum (AudienceInsightsDimension),
  "items": [
    {
      object (AudienceOverlapItem)
    }
  ]
}
שדות
dimension

enum (AudienceInsightsDimension)

המאפיין של כל המאפיינים בקטע הזה.
items[]

object (AudienceOverlapItem)

המאפיינים והחפיפה שלהם למאפיין הראשי.

AudienceOverlapItem

מאפיין של קהל, עם מטא-נתונים שכוללים את החפיפה בין פוטנציאל החשיפה של המאפיין הזה ב-YouTube לבין פוטנציאל החשיפה של מאפיין ראשי.

ייצוג ב-JSON 
{
  "attributeMetadata": {
    object (AudienceInsightsAttributeMetadata)
  },
  "potentialYoutubeReachIntersection": string
}
שדות
attributeMetadata

object (AudienceInsightsAttributeMetadata)

המאפיין והמטא-נתונים שלו, כולל פוטנציאל החשיפה ב-YouTube.
potentialYoutubeReachIntersection

string (int64 format)

הגודל המשוער של הצטלבות מאפיין הקהל הזה עם המאפיין הראשי, כלומר מספר משתמשי YouTube שאפשר להגיע אליהם ועומדים גם במאפיין הראשי וגם במאפיין הזה.