Uwaga: przeglądasz dokumentację interfejsu REST interfejsu API. Większość oficjalnych bibliotek klienta używa gRPC. Więcej informacji znajdziesz we wprowadzeniu do REST.

Ta strona została przetłumaczona przez Cloud Translation API.

CustomAudience

Zapis JSON
CustomAudienceStatus
CustomAudienceType
CustomAudienceMember
- Zapis JSON
CustomAudienceMemberType

Niestandardowa lista odbiorców. To jest lista zainteresowań użytkowników.

Zapis JSON

Zapis JSON
{ "resourceName": string, "id": string, "status": enum (`CustomAudienceStatus`), "name": string, "type": enum (`CustomAudienceType`), "description": string, "members": [ { object (`CustomAudienceMember`) } ] }

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

Pola
`resourceName`	`string` Niezmienne. Nazwa zasobu grupy odbiorców niestandardowych. Nazwy zasobów niestandardowych list odbiorców mają postać: `customers/{customerId}/customAudiences/{custom_audience_id}`
`id`	`string (int64 format)` Tylko dane wyjściowe. Identyfikator niestandardowej listy odbiorców.
`status`	`enum (CustomAudienceStatus)` Tylko dane wyjściowe. Stan tej niestandardowej listy odbiorców. Wskazuje, czy niestandardowa lista odbiorców jest włączona czy usunięta.
`name`	`string` Nazwa grupy odbiorców niestandardowych. Powinien on być niepowtarzalny w przypadku wszystkich list niestandardowych utworzonych przez klienta. To pole jest wymagane do tworzenia operacji.
`type`	`enum (CustomAudienceType)` Typ listy niestandardowych odbiorców. („INTEREST” LUB „PURCHASE_INTENT” nie jest dozwolone w przypadku nowo utworzonych grup odbiorców niestandardowych, ale opcja ta zostanie zachowana dla dotychczasowych odbiorców)
`description`	`string` Opis tej niestandardowej listy odbiorców.
`members[]`	`object (CustomAudienceMember)` Lista niestandardowych odbiorców, z których składa się ta grupa odbiorców. Członków można dodawać podczas tworzenia niestandardowych grup odbiorców. Jeśli członkowie są pokazani w operacji AKTUALIZACJA, istniejący członkowie zostaną zastąpione.

CustomAudienceStatus

Wartość zawierająca możliwe stany odbiorców niestandardowych.

Wartości w polu enum
`UNSPECIFIED`	Nie określono.
`UNKNOWN`	Służy tylko do zwracania wartości. Reprezentuje wartość nieznaną w tej wersji.
`ENABLED`	Stan „Włączono” – niestandardowa grupa odbiorców jest włączona i może być celem kierowania.
`REMOVED`	Stan usunięty – niestandardowa grupa odbiorców została usunięta i nie można jej używać do kierowania.

CustomAudienceType

Wyliczenie zawierające możliwe niestandardowe typy odbiorców.

Wartości w polu enum
`UNSPECIFIED`	Nie określono.
`UNKNOWN`	Służy tylko do zwracania wartości. Reprezentuje wartość nieznaną w tej wersji.
`AUTO`	Google Ads automatycznie wybierze najlepszą interpretację podczas wyświetlania.
`INTEREST`	Dopasowuje użytkowników według ich zainteresowań.
`PURCHASE_INTENT`	Dopasowuje użytkowników według tematów, których szukają, lub produktów, które rozważają zakup.
`SEARCH`	Dopasowuje użytkowników na podstawie haseł wyszukiwanych w wyszukiwarce Google.

CustomAudienceMember

Należy do niestandardowej grupy odbiorców. Użytkownik może to być: KEYWORD, URL, PLACE_CATEGORY lub APP. Można go tylko utworzyć lub usunąć, ale nie można go zmienić.

Zapis JSON

Zapis 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),

  // 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.
}

Pola
`memberType`	`enum (CustomAudienceMemberType)` Typ niestandardowego członka grupy odbiorców: KEYWORD, URL, PLACE_CATEGORY lub APP.
Pole sumy `value`. Wartość CustomAudienceMember. Jedno pole jest wypełniane na podstawie typu użytkownika. `value` może mieć tylko jedną z tych wartości:
`keyword`	`string` Słowo kluczowe lub wyrażenie kluczowe – maksymalnie 10 słów i 80 znaków. W przypadku języków ze znakami dwubajtowymi (takich jak chiński, japoński i koreański) dozwolone jest stosowanie 40 znaków opisujących zainteresowania lub działania użytkownika.
`url`	`string` Adres URL HTTP z uwzględnieniem protokołu – maksymalnie 2048 znaków, w tym treści interesujące użytkowników.
`placeCategory`	`string (int64 format)` Rodzaj miejsca opisany przez kategorię miejsca odwiedzaną przez użytkowników.
`app`	`string` nazwę pakietu aplikacji na Androida zainstalowanych przez użytkowników (np. com.google.example).

CustomAudienceMemberType

Wartość zawierająca możliwe niestandardowe typy członków grupy odbiorców.

Wartości w polu enum
`UNSPECIFIED`	Nie określono.
`UNKNOWN`	Służy tylko do zwracania wartości. Reprezentuje wartość nieznaną w tej wersji.
`KEYWORD`	Użytkownicy, których zainteresowania lub działania są opisane za pomocą słowa kluczowego.
`URL`	Użytkownicy, których zainteresowania są powiązane z treścią witryny.
`PLACE_CATEGORY`	Użytkownicy, którzy odwiedzają typy miejsc opisane według kategorii miejsc.
`APP`	Użytkownicy, którzy zainstalowali aplikację mobilną.