CustomAudience

Özel kitle. Bu, ilgi alanına göre kullanıcıların listesidir.

JSON gösterimi 
{
  "resourceName": string,
  "id": string,
  "status": enum (CustomAudienceStatus),
  "name": string,
  "type": enum (CustomAudienceType),
  "description": string,
  "members": [
    {
      object (CustomAudienceMember)
    }
  ]
}
Alanlar
resourceName

string

Değişmez. Özel kitlenin kaynak adı. Özel kitle kaynak adları şu biçimdedir:

customers/{customerId}/customAudiences/{custom_audience_id}
id

string (int64 format)

Yalnızca çıkış. Özel kitlenin kimliği.
status

enum (CustomAudienceStatus)

Yalnızca çıkış. Bu özel kitlenin durumu. Özel kitlenin etkin olup olmadığını veya kaldırılıp kaldırılmadığını belirtir.
name

string

Özel kitlenin adı. Müşteri tarafından oluşturulan tüm özel kitleler için benzersiz olmalıdır. Bu alan, işlem oluşturmak için gereklidir.
type

enum (CustomAudienceType)

Özel kitlenin türü. ("INTEREST" VEYA "PURCHASE_INTENT" yeni oluşturulan özel kitleler için izin verilmez ancak mevcut kitleler için korunur)
description

string

Bu özel kitlenin açıklaması.
members[]

object (CustomAudienceMember)

Bu özel kitlenin oluştuğu özel kitle üyelerinin listesi. Özel kitle oluşturulurken üyeler eklenebilir. Üyeler UPDATE işleminde sunulursa mevcut üyeler geçersiz kılınır.

CustomAudienceStatus

Olası özel kitle durumlarını içeren bir enum.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca döndürülen değer için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
ENABLED Etkin durum: Özel kitle etkindir ve hedeflenebilir.
REMOVED Kaldırıldı durumu: Özel kitle kaldırılır ve hedefleme için kullanılamaz.

CustomAudienceType

Olası özel kitle türlerini içeren bir enum.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca döndürülen değer için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
AUTO Google Ads, yayınlama sırasında en iyi yorumu otomatik olarak seçer.
INTEREST Kullanıcıları ilgi alanlarına göre eşleştirir.
PURCHASE_INTENT Kullanıcıları, araştırdıkları konulara veya satın almayı düşündükleri ürünlere göre eşleştirir.
SEARCH Kullanıcıları Google Arama'da aradıklarıyla eşleştirir.

CustomAudienceMember

Özel kitlenin bir üyesi. Üyeler KEYWORD, URL, PLACE_CATEGORY veya APP olabilir. Yalnızca oluşturulabilir veya kaldırılabilir ancak değiştirilemez.

JSON gösterimi 
{
  "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.
}
Alanlar
memberType

enum (CustomAudienceMemberType)

Özel kitle üyesinin türü: ANAHTAR_KELIME, URL, YER_KATEGORISI veya UYGULAMA.
Birlik alanı value. CustomAudienceMember değeri. Üye türüne bağlı olarak bir alan doldurulur. value yalnızca aşağıdakilerden biri olabilir:
keyword

string

Anahtar kelime veya anahtar kelime öbeği (en fazla 10 kelime ve 80 karakter). Çince, Japonca veya Korece gibi çift genişlikli karakterler içeren dillerde, kullanıcının ilgi alanlarını veya işlemlerini tanımlayan 40 karaktere izin verilir.
url

string

Protokol dahil olmak üzere bir HTTP URL'si (en fazla 2.048 karakter). Kullanıcıların ilgilendiği içerikleri içerir.
placeCategory

string (int64 format)

Kullanıcıların ziyaret ettiği bir yer kategorisi tarafından tanımlanan yer türü.
app

string

Kullanıcıların yüklediği Android uygulamalarının paket adı (ör. com.google.example).

CustomAudienceMemberType

Olası özel kitle üyesi türlerini içeren bir enum.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca döndürülen değer için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
KEYWORD İlgi alanları veya işlemleri bir anahtar kelimeyle tanımlanan kullanıcılar.
URL Web sitesinin içeriğiyle ilgili ilgi alanları olan kullanıcılar.
PLACE_CATEGORY Bir yer kategorisiyle tanımlanan yer türlerini ziyaret eden kullanıcılar.
APP Mobil uygulama yüklemiş olan kullanıcılar.