Method: customers.generateSuggestedTargetingInsights

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

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

คำขอ HTTP

POST https://googleads.googleapis.com/v15/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 โดยใช้การกำหนดเป้าหมายนี้