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)

ต้องระบุ ประเภทของแอตทริบิวต์ที่จะคำนวณการซ้อนทับกับแอตทริบิวต์หลัก ค่าต้องเป็นชุดย่อยของ 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 ที่เข้าถึงได้ซึ่งตรงกับทั้งแอตทริบิวต์หลักและแอตทริบิวต์นี้