Method: advertisers.reachForecast.retrievePlannableUserInterests

ดึงข้อมูลกลุ่มเป้าหมายของ Google (ความสนใจของผู้ใช้) ที่พร้อมใช้งานสำหรับการคาดการณ์

คำขอ HTTP

GET https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/reachForecast:retrievePlannableUserInterests

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

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

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

string (int64 format)

ต้องระบุ รหัสของผู้ลงโฆษณาที่จะแสดงความสนใจของผู้ใช้ที่วางแผนได้

พารามิเตอร์การค้นหา

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

enum (PlannableProductCategory)

ต้องระบุ หมวดหมู่สินค้าที่จะดึงความสนใจของผู้ใช้ที่วางแผนได้

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

เนื้อหาของคำขอต้องว่างเปล่า

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

การตอบกลับสำหรับ reachForecast.retrievePlannableUserInterests

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

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

object (PlannableUserInterest)

รายการความสนใจของผู้ใช้ที่วางแผนได้ (กลุ่มเป้าหมาย Google)

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

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

  • https://www.googleapis.com/auth/display-video

ดูข้อมูลเพิ่มเติมได้ที่ OAuth 2.0 Overview

PlannableUserInterest

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

การแสดง JSON 
{
  "userInterestDisplayName": string,
  "userInterestPath": string,
  "userInterestType": string,
  "userInterest": {
    object (UserInterest)
  }
}
ช่อง
userInterestDisplayName

string

เอาต์พุตเท่านั้น ชื่อที่แสดงของความสนใจ เช่น "ผู้ที่ชื่นชอบกิจกรรมกลางแจ้ง"
userInterestPath

string

เอาต์พุตเท่านั้น เส้นทางหมวดหมู่ของความสนใจ
userInterestType

string

เอาต์พุตเท่านั้น ประเภทกลุ่มเป้าหมาย เช่น "AFFINITY" "IN_MARKET"
userInterest

object (UserInterest)

เอาต์พุตเท่านั้น ตัวระบุสำหรับความสนใจของผู้ใช้

[productCategory][] ที่ระบุในคำขอจะกำหนดฟิลด์ที่กรอกข้อมูลในออบเจ็กต์

  • ระบบจะป้อนข้อมูล [userInterestCategory][] สำหรับ "Youtube"
  • ระบบจะป้อนข้อมูล [userInterestUserList][] สำหรับ "การประมูลแบบเปิด"

ความสนใจของผู้ใช้

ตัวระบุสำหรับความสนใจของผู้ใช้

การแสดง JSON 
{
  "userInterestCategory": string,
  "userInterestUserList": string
}
ช่อง
userInterestCategory

string

เอาต์พุตเท่านั้น ชื่อทรัพยากรของหมวดหมู่ความสนใจ จะมีการป้อนข้อมูลเมื่อ productCategory เป็น "Youtube" รูปแบบ: customers/{customerId}/userInterests/{user_interest_id}
userInterestUserList

string

เอาต์พุตเท่านั้น ชื่อทรัพยากรของกลุ่มเป้าหมายตามรายการผู้ใช้ ระบบจะป้อนข้อมูลเมื่อ productCategory เป็น "การประมูลแบบเปิด" รูปแบบ: customers/{customerId}/userLists/{user_list_id}