Method: customers.generateSuggestedTargetingInsights

แสดงผลคอลเล็กชันข้อมูลเชิงลึกในการกำหนดเป้าหมาย (เช่น กลุ่มเป้าหมายที่กำหนดเป้าหมายได้) ซึ่งเกี่ยวข้องกับกลุ่มเป้าหมายที่ขอ

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

คำขอ HTTP

POST https://googleads.googleapis.com/v16/customers/{customerId}:generateSuggestedTargetingInsights

URL ใช้ไวยากรณ์การแปลง gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
customerId

string

ต้องระบุ รหัสของลูกค้า

เนื้อหาของคำขอ

เนื้อหาของคำขอมีข้อมูลซึ่งมีโครงสร้างต่อไปนี้

การแสดง JSON 
{
  "audience": {
    object (InsightsAudience)
  },
  "baselineAudience": {
    object (InsightsAudience)
  },
  "dataMonth": string,
  "customerInsightsGroup": string
}
ช่อง
audience

object (InsightsAudience)

ต้องระบุ กลุ่มเป้าหมายที่สนใจซึ่งมีการขอข้อมูลเชิงลึก
baselineAudience

object (InsightsAudience)

ไม่บังคับ ฐานกลุ่มเป้าหมาย หากไม่ระบุ ค่าเริ่มต้นจะเป็นผู้ที่อยู่ในประเทศเดียวกับกลุ่มเป้าหมายที่สนใจ
dataMonth

string

ไม่บังคับ ข้อมูลประวัติช่วง 1 เดือนที่จะใช้สำหรับข้อมูลเชิงลึกในรูปแบบ "ปปปป-ดด" หากไม่ได้ตั้งค่า ระบบจะแสดงข้อมูลเชิงลึกสำหรับข้อมูลใน 30 วันล่าสุด
customerInsightsGroup

string

ไม่บังคับ ชื่อของลูกค้าที่จะวางแผน ค่านี้เป็นค่าที่ผู้ใช้กำหนด

เนื้อหาการตอบกลับ

ข้อความตอบกลับสำหรับ AudienceInsightsService.GenerateSuggestedTargetingInsights

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "suggestions": [
    {
      object (TargetingSuggestionMetrics)
    }
  ]
}
ช่อง
suggestions[]

object (TargetingSuggestionMetrics)

ข้อมูลเชิงลึกที่แนะนำสำหรับกลุ่มเป้าหมายที่กำหนดเป้าหมายได้

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

ต้องใช้ขอบเขต OAuth ต่อไปนี้

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

โปรดดูข้อมูลเพิ่มเติมที่ภาพรวมของ OAuth 2.0

TargetingSuggestionMetrics

กลุ่มเป้าหมายที่แนะนำได้ซึ่งเกี่ยวข้องกับกลุ่มเป้าหมายที่ขอ

การแสดง JSON 
{
  "locations": [
    {
      object (AudienceInsightsAttributeMetadata)
    }
  ],
  "ageRanges": [
    {
      object (AgeRangeInfo)
    }
  ],
  "gender": {
    object (GenderInfo)
  },
  "userInterests": [
    {
      object (AudienceInsightsAttributeMetadata)
    }
  ],
  "coverage": number,
  "index": number,
  "potentialYoutubeReach": string
}
ช่อง
locations[]

object (AudienceInsightsAttributeMetadata)

การกำหนดสถานที่เป้าหมายที่แนะนำ แอตทริบิวต์ทั้งหมดมีมิติข้อมูล GEO_TARGET_COUNTRY หรือ SUB_COUNTRY_LOCATION
ageRanges[]

object (AgeRangeInfo)

การกำหนดอายุเป้าหมายที่แนะนำ อาจว่างเปล่าหมายความว่าไม่มีการกำหนดอายุเป้าหมาย
gender

object (GenderInfo)

การกำหนดเป้าหมายตามเพศที่แนะนำ หากมี แอตทริบิวต์นี้จะมีมิติข้อมูล GENDER
userInterests[]

object (AudienceInsightsAttributeMetadata)

กลุ่มเป้าหมายที่แนะนำเพื่อกำหนดเป้าหมาย แอตทริบิวต์เหล่านี้ทั้งหมดมีมิติข้อมูล AFFINITY_USER_INTEREST หรือ IN_MARKET_USER_INTEREST
coverage

number

เศษส่วน (ตั้งแต่ 0 ถึง 1) ของกลุ่มเป้าหมายที่ขอซึ่งเข้าถึงได้โดยใช้การกำหนดเป้าหมายที่แนะนำ
index

number

อัตราส่วนของความครอบคลุมต่อความครอบคลุมของกลุ่มเป้าหมายฐาน หรือเป็น 0 หากไม่มีการกำหนดอัตราส่วนหรือไม่มีความหมาย
potentialYoutubeReach

string (int64 format)

จำนวนผู้คนโดยประมาณโดยประมาณที่เข้าถึงได้บน YouTube โดยใช้การกำหนดเป้าหมายนี้