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)

חובה. סוגי המאפיינים שעבורם צריך לחשב את החפיפה עם המאפיין הראשי. הערכים חייבים להיות קבוצת משנה של 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.

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 שאפשר להגיע אליהם ועומדים גם במאפיין הראשי וגם במאפיין הזה.