Method: insights.retrieveInsights

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

คำขอ HTTP

POST https://datamanager.googleapis.com/v1/insights:retrieveInsights

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

เนื้อความของคำขอ

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

การแสดง JSON 
{
  "destination": {
    object (Destination)
  },
  "baseline": {
    object (Baseline)
  }
}
ช่อง
destination

object (Destination)

ต้องระบุ ปลายทางที่จะดึงข้อมูลเชิงลึก
baseline

object (Baseline)

ต้องระบุ ค่าพื้นฐานสำหรับข้อมูลเชิงลึกที่ขอ

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

ข้อความตอบกลับสำหรับ DM API MarketingDataInsightsService.RetrieveInsights

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

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

object (MarketingDataInsight)

มีข้อมูลเชิงลึกสำหรับข้อมูลการตลาด

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

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

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

เกณฑ์พื้นฐาน

เกณฑ์พื้นฐานที่ใช้เปรียบเทียบข้อมูลเชิงลึก

การแสดง JSON 
{

  // Union field baseline can be only one of the following:
  "baselineLocation": {
    object (Location)
  },
  "locationAutoDetectionEnabled": boolean
  // End of list of possible types for union field baseline.
}
ช่อง
ฟิลด์ Union baseline สถานที่ตั้งพื้นฐานที่ใช้เปรียบเทียบข้อมูลเชิงลึก baseline ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
baselineLocation

object (Location)

ตำแหน่งพื้นฐานของคำขอ ตำแหน่งพื้นฐานคือรายการ OR ของภูมิภาคที่ขอ
locationAutoDetectionEnabled

boolean

หากตั้งค่าเป็นจริง บริการจะพยายามตรวจหาตำแหน่งพื้นฐานสำหรับข้อมูลเชิงลึกโดยอัตโนมัติ

ตำแหน่ง

ตำแหน่งพื้นฐานของคำขอ สถานที่ตั้งพื้นฐานอยู่ในรายการ OR ของรหัสภูมิภาค ISO 3166-1 alpha-2 ของภูมิภาคที่ขอ

การแสดง JSON 
{
  "regionCodes": [
    string
  ]
}
ช่อง
regionCodes[]

string

รายการรหัสภูมิภาคแบบ ISO 3166-1 Alpha-2

MarketingDataInsight

ข้อมูลเชิงลึกสำหรับข้อมูลการตลาด

การแสดง JSON 
{
  "dimension": enum (AudienceInsightsDimension),
  "attributes": [
    {
      object (MarketingDataInsightsAttribute)
    }
  ]
}
ช่อง
dimension

enum (AudienceInsightsDimension)

มิติข้อมูลที่ข้อมูลเชิงลึกเป็นของ
attributes[]

object (MarketingDataInsightsAttribute)

ข้อมูลเชิงลึกสำหรับค่าของมิติข้อมูลที่ระบุ

AudienceInsightsDimension

มิติข้อมูลที่ใช้ได้ในการสร้างข้อมูลเชิงลึก

Enum
AUDIENCE_INSIGHTS_DIMENSION_UNSPECIFIED ไม่ได้ระบุ
AUDIENCE_INSIGHTS_DIMENSION_UNKNOWN ค่านี้ไม่รู้จักในเวอร์ชันนี้
AFFINITY_USER_INTEREST ความสนใจของผู้ใช้ตามกลุ่มความสนใจ
IN_MARKET_USER_INTEREST ความสนใจของผู้ใช้ที่มีแผนจะซื้อ
AGE_RANGE ช่วงอายุ
GENDER เพศ

MarketingDataInsightsAttribute

ข้อมูลเชิงลึกสำหรับชุดแอตทริบิวต์ที่เกี่ยวข้องของมิติข้อมูลเดียวกัน

การแสดง JSON 
{
  "userInterestId": string,
  "lift": number,
  "ageRange": enum (AgeRange),
  "gender": enum (Gender)
}
ช่อง
userInterestId

string (int64 format)

รหัสความสนใจของผู้ใช้
lift

number

การวัดการเพิ่มที่กลุ่มเป้าหมายมีต่อค่าแอตทริบิวต์เมื่อเทียบกับค่าพื้นฐาน ช่วง [0-1]
ageRange

enum (AgeRange)

ช่วงอายุของกลุ่มเป้าหมายที่มีการวัดการเพิ่ม
gender

enum (Gender)

เพศของกลุ่มเป้าหมายที่มีการวัดการเพิ่ม

ช่วงอายุ

ช่วงอายุตามข้อมูลประชากร

Enum
AGE_RANGE_UNSPECIFIED ไม่ได้ระบุ
AGE_RANGE_UNKNOWN ไม่รู้จัก
AGE_RANGE_18_24 อายุระหว่าง 18 ถึง 24 ปี
AGE_RANGE_25_34 อายุระหว่าง 25 ถึง 34 ปี
AGE_RANGE_35_44 อายุระหว่าง 35 ถึง 44 ปี
AGE_RANGE_45_54 อายุระหว่าง 45 ถึง 54 ปี
AGE_RANGE_55_64 อายุระหว่าง 55 ถึง 64 ปี
AGE_RANGE_65_UP อายุ 65 ปีขึ้นไป

เพศ

ประเภทของเพศตามข้อมูลประชากร (เช่น หญิง)

Enum
GENDER_UNSPECIFIED ไม่ได้ระบุ
GENDER_UNKNOWN ไม่รู้จัก
GENDER_MALE ชาย
GENDER_FEMALE หญิง