CustomAudience

Özel bir 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

Sabit. Özel kitlenin kaynak adı. Özel kitle kaynağı 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. İşlem oluşturmak için bu alan gereklidir.
type

enum (CustomAudienceType)

Özel kitlenin türü. (Yeni oluşturulan özel kitlelerde "INTEREST" VEYA "PURCHASE_INTENT"e izin verilmez ancak mevcut kitleler için saklanır)
description

string

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

object (CustomAudienceMember)

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

CustomAudienceStatus

Olası özel kitle durumlarını içeren sıralama.

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 etkinleştirildi 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. Üye 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).
value alanı. CustomAudienceMember değeri. Üye türüne bağlı olarak bir alan 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 bir HTTP URL'si. En fazla 2048 karakter uzunluğunda ve kullanıcıların ilgi gösterdiği içerikleri kapsar.
placeCategory

string (int64 format)

Kullanıcıların ziyaret ettiği 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 sıralama.

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 kelimeyle 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ş olan kullanıcılar