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 użytkowników według ich zainteresowań.

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` Stałe. Nazwa zasobu listy odbiorców niestandardowych. Nazwy zasobów niestandardowych 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 grupa odbiorców jest włączona czy usunięta.
`name`	`string` Nazwa niestandardowej listy odbiorców. Powinien on być niepowtarzalny dla wszystkich list niestandardowych utworzonych przez klienta. To pole jest wymagane do tworzenia operacji.
`type`	`enum (CustomAudienceType)` Typ listy niestandardowych odbiorców. (wartość „INTEREST” LUB „PURCHASE_INTENT” nie jest dozwolona w przypadku nowo utworzonych list niestandardowych odbiorców, ale została zachowana dla dotychczasowych odbiorców)
`description`	`string` Opis tej niestandardowej listy odbiorców.
`members[]`	`object (CustomAudienceMember)` Lista niestandardowych członków grupy odbiorców, z których składa się dana lista odbiorców. Członków można dodawać podczas tworzenia niestandardowych grup odbiorców. Jeśli w operacji AKTUALIZACJA zostaną pokazani członkowie, istniejący członkowie zostaną zastąpione.

CustomAudienceStatus

Wyliczenie zawierające możliwe stany niestandardowych odbiorców.

Wartości w polu enum
`UNSPECIFIED`	Nie określono.
`UNKNOWN`	Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
`ENABLED`	Stan „Włączono” – niestandardowa lista odbiorców jest włączona i można na nią kierować reklamy.
`REMOVED`	Stan usunięty – niestandardowa lista 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`	Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
`AUTO`	Google Ads automatycznie wybierze najlepszą interpretację podczas wyświetlania reklamy.
`INTEREST`	Dopasowuje użytkowników według ich zainteresowań.
`PURCHASE_INTENT`	Dopasowanie użytkowników do tematów, nad którymi szukają informacji lub które produkty rozważają przed zakupem.
`SEARCH`	Dopasowuje użytkowników na podstawie haseł wyszukiwanych w wyszukiwarce Google.

CustomAudienceMember

Należy do grupy odbiorców niestandardowych. Użytkownikiem może być KEYWORD, URL, PLACE_CATEGORY lub aplikacja. 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 w zależności od typu użytkownika. `value` może być 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, w których stosowane są znaki o podwójnej szerokości, takich jak chiński, japoński i koreański, obowiązuje limit 40 znaków, które opisują zainteresowania lub działania użytkownika.
`url`	`string` Adres URL HTTP z uwzględnieniem protokołu — maksymalnie 2048 znaków łącznie z zainteresowaniami użytkowników.
`placeCategory`	`string (int64 format)` Typ miejsca opisany przez kategorię miejsca odwiedzaną przez użytkowników.
`app`	`string` nazwy pakietu aplikacji na Androida zainstalowanych przez użytkowników, np. com.google.example.

CustomAudienceMemberType

Wyliczenie zawierające możliwe niestandardowe typy członków grupy odbiorców.

Wartości w polu enum
`UNSPECIFIED`	Nie określono.
`UNKNOWN`	Używana tylko w przypadku wartości zwracanej. 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 miejsca.
`APP`	Użytkownicy, którzy zainstalowali aplikację mobilną.