CustomAudience

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

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

string

Sabit. Ö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 mi yoksa kaldırılmış mı olduğunu belirtir.
name

string

Özel kitlenin adı. Bir 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" OR "PURCHASE_INTENT" yeni oluşturulan özel kitle için kullanılamaz, ancak mevcut kitleler için tutulur)
description

string

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

object (CustomAudienceMember)

Bu özel kitlenin oluştuğu özel kitle üyelerinin listesi. Üyeler, CustomAudience oluşturma işlemi sırasında eklenebilir. Üyeler UPDATE işleminde sunulursa mevcut üyeler geçersiz kılınır.

CustomAudienceStatus

Olası özel kitle durumlarını içeren 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 Etkinleştirildi durumu: Özel kitle etkindir ve hedeflenebilir.
REMOVED Kaldırıldı durumu: Özel kitle kaldırıldı ve hedefleme için kullanılamaz.

CustomAudienceType

Olası özel kitle türlerini içeren 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ın 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 yaptıkları aramalara göre eşleştirir.

CustomAudienceMember

Özel kitlenin üyesi. Üye 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 üyesi türü, KEYWORD, URL, PLACE_CATEGORY veya APP.
Birleştirme alanı value. CustomAudienceMember değeri. Alanlardan biri üye türüne göre doldurulur. value şunlardan yalnızca biri olabilir:
keyword

string

Bir anahtar kelime veya anahtar kelime öbeği - en fazla 10 kelime ve 80 karakter. Çince, Japonca veya Korece gibi çift genişlikli karakterlerin kullanıldığı dillerde, kullanıcının ilgi alanlarını veya işlemlerini açıklayan 40 karaktere izin verilir.
url

string

Protokol dahil olan bir HTTP URL'si. En fazla 2.048 karakter uzunluğunda ve kullanıcıların ilgi gösterdiği içerikleri barındıran.
placeCategory

string (int64 format)

Kullanıcıların ziyaret ettiği yer kategorisi tarafından tanımlanan bir 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 üye türlerini içeren 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 eylemleri bir anahtar kelime ile tanımlanan kullanıcılar.
URL Web sitesinin içeriğiyle alakalı ilgi alanlarına sahip kullanıcılar.
PLACE_CATEGORY Bir yer kategorisi tarafından tanımlanan yer türlerini ziyaret eden kullanıcılar.
APP Mobil uygulama yüklemiş kullanıcılar