CustomAudience

กลุ่มเป้าหมายที่กําหนดเอง นี่เป็นรายการผู้ใช้ตามความสนใจ

การแสดง JSON
{
  "resourceName": string,
  "id": string,
  "status": enum (CustomAudienceStatus),
  "name": string,
  "type": enum (CustomAudienceType),
  "description": string,
  "members": [
    {
      object (CustomAudienceMember)
    }
  ]
}
ช่อง
resourceName

string

เปลี่ยนแปลงไม่ได้ ชื่อทรัพยากรของกลุ่มเป้าหมายที่กําหนดเอง ชื่อทรัพยากรกลุ่มเป้าหมายที่กําหนดเองมีรูปแบบดังนี้

customers/{customerId}/customAudiences/{custom_audience_id}

id

string (int64 format)

เอาต์พุตเท่านั้น รหัสของกลุ่มเป้าหมายที่กําหนดเอง

status

enum (CustomAudienceStatus)

เอาต์พุตเท่านั้น สถานะของกลุ่มเป้าหมายที่กําหนดเองนี้ ระบุว่าเปิดใช้หรือนํากลุ่มเป้าหมายที่กําหนดเองออกแล้ว

name

string

ชื่อกลุ่มเป้าหมายที่กําหนดเอง โดยควรไม่ซ้ำกันสำหรับกลุ่มเป้าหมายที่กําหนดเองทั้งหมดที่ลูกค้าสร้างขึ้น ต้องระบุข้อมูลในช่องนี้เพื่อสร้างการดำเนินการ

type

enum (CustomAudienceType)

ประเภทของกลุ่มเป้าหมายที่กําหนดเอง ("INTEREST" หรือ "PURCHASE_INTENT" ไม่อนุญาตสําหรับกลุ่มเป้าหมายที่กําหนดเองที่สร้างขึ้นใหม่ แต่เก็บไว้สําหรับกลุ่มเป้าหมายที่มีอยู่)

description

string

คําอธิบายกลุ่มเป้าหมายที่กําหนดเองนี้

members[]

object (CustomAudienceMember)

รายชื่อสมาชิกกลุ่มเป้าหมายที่กําหนดเองที่ประกอบกันเป็นกลุ่มเป้าหมายที่กําหนดเองนี้ คุณสามารถเพิ่มสมาชิกได้ในระหว่างการสร้าง CustomAudience หากสมาชิกแสดงในการดำเนินการ "อัปเดต" ระบบจะลบล้างสมาชิกที่มีอยู่

CustomAudienceStatus

Enum ที่มีสถานะกลุ่มเป้าหมายที่กําหนดเองที่เป็นไปได้

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่แสดงผลเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
ENABLED สถานะเปิดใช้ - กลุ่มเป้าหมายที่กำหนดเองเปิดใช้และกำหนดเป้าหมายได้
REMOVED สถานะ "นําออกแล้ว" - นํากลุ่มเป้าหมายที่กําหนดเองออกแล้ว และใช้เพื่อกําหนดเป้าหมายไม่ได้

CustomAudienceType

Enum ที่มีประเภทกลุ่มเป้าหมายที่กําหนดเองได้

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่แสดงผลเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
AUTO Google Ads จะเลือกการตีความที่ดีที่สุดโดยอัตโนมัติ ณ เวลาที่แสดง
INTEREST จับคู่ผู้ใช้ตามความสนใจ
PURCHASE_INTENT จับคู่ผู้ใช้ตามหัวข้อที่กําลังค้นหาหรือผลิตภัณฑ์ที่กําลังพิจารณาซื้อ
SEARCH จับคู่ผู้ใช้ตามสิ่งที่ค้นหาใน Google Search

CustomAudienceMember

สมาชิกของกลุ่มเป้าหมายที่กำหนดเอง สมาชิกอาจเป็นคีย์เวิร์ด, URL, PLACE_CATEGORY หรือ APP โดยคุณจะสร้างหรือนําออกได้เท่านั้น แต่เปลี่ยนแปลงไม่ได้

การแสดง JSON
{
  "memberType": enum (CustomAudienceMemberType),

  // Union field value can be only one of the following:
  "keyword": string,
  "url": string,
  "placeCategory": string,
  "app": string
  // End of list of possible types for union field value.
}
ช่อง
memberType

enum (CustomAudienceMemberType)

ประเภทสมาชิกกลุ่มเป้าหมายที่กําหนดเอง คีย์เวิร์ด, URL, PLACE_CATEGORY หรือ APP

ฟิลด์สหภาพ value ค่า CustomAudienceMember ระบบจะป้อนข้อมูลในช่องเดียวโดยขึ้นอยู่กับประเภทสมาชิก value ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
keyword

string

คีย์เวิร์ดหรือวลีคีย์เวิร์ด - ไม่เกิน 10 คำและ 80 อักขระ ภาษาที่มีอักขระแบบ Double-width เช่น จีน ญี่ปุ่น หรือเกาหลี จะใช้ได้ 40 อักขระ ซึ่งจะอธิบายความสนใจหรือการกระทำของผู้ใช้

url

string

URL ของ HTTP ที่มีโปรโตคอล - ไม่เกิน 2,048 อักขระ ซึ่งรวมถึงเนื้อหาที่ผู้ใช้สนใจ

placeCategory

string (int64 format)

ประเภทสถานที่ที่อธิบายโดยหมวดหมู่สถานที่ซึ่งผู้ใช้เข้าชม

app

string

ชื่อแพ็กเกจของแอป Android ที่ผู้ใช้ติดตั้ง เช่น com.google.example

CustomAudienceMemberType

Enum ที่มีประเภทสมาชิกกลุ่มเป้าหมายที่กําหนดเองได้

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่แสดงผลเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
KEYWORD ผู้ใช้ที่มีความสนใจหรือการกระทำที่อธิบายโดยคีย์เวิร์ด
URL ผู้ใช้ที่มีความสนใจเกี่ยวข้องกับเนื้อหาของเว็บไซต์
PLACE_CATEGORY ผู้ใช้ที่เข้าชมสถานที่ประเภทต่างๆ ที่อธิบายโดยหมวดหมู่สถานที่
APP ผู้ใช้ที่ติดตั้งแอปบนอุปกรณ์เคลื่อนที่