Method: customers.generateAudienceOverlapInsights

แสดงผลกลุ่มแอตทริบิวต์กลุ่มเป้าหมายพร้อมกับค่าประมาณของการทับซ้อนกันระหว่างโอกาสในการเข้าถึงบน YouTube กับแอตทริบิวต์อินพุตที่ระบุ

รายการข้อผิดพลาดที่แสดง: AudienceInsightsError AuthenticationError AuthorizationError FieldError HeaderError InternalError QuotaError RangeError RequestError

คำขอ HTTP

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

URL ใช้ไวยากรณ์การแปลง 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)

รายการแอตทริบิวต์และความทับซ้อนกับแอตทริบิวต์หลัก โดยให้มี 1 รายการต่อมิติข้อมูลที่ขอ

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต 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 ที่เข้าถึงได้ซึ่งตรงกับทั้งแอตทริบิวต์หลักและแอตทริบิวต์นี้