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.

AdGroup

Zapis JSON
AdGroupStatus
AdGroupType
AdGroupAdRotationMode
AudienceSetting
- Zapis JSON

Grupa reklam.

Zapis JSON

Zapis JSON
{ "resourceName": string, "status": enum (`AdGroupStatus`), "type": enum (`AdGroupType`), "adRotationMode": enum (`AdGroupAdRotationMode`), "urlCustomParameters": [ { object (`CustomParameter`) } ], "optimizedTargetingEnabled": boolean, "displayCustomBidDimension": enum (`TargetingDimension`), "targetingSetting": { object (`TargetingSetting`) }, "audienceSetting": { object (`AudienceSetting`) }, "effectiveTargetCpaSource": enum (`BiddingSource`), "effectiveTargetRoasSource": enum (`BiddingSource`), "labels": [ string ], "excludedParentAssetFieldTypes": [ enum (`AssetFieldType`) ], "excludedParentAssetSetTypes": [ enum (`AssetSetType`) ], "id": string, "name": string, "baseAdGroup": string, "trackingUrlTemplate": string, "campaign": string, "cpcBidMicros": string, "effectiveCpcBidMicros": string, "cpmBidMicros": string, "targetCpaMicros": string, "cpvBidMicros": string, "targetCpmMicros": string, "targetRoas": number, "percentCpcBidMicros": string, "finalUrlSuffix": string, "effectiveTargetCpaMicros": string, "effectiveTargetRoas": number }

{
  "resourceName": string,
  "status": enum (AdGroupStatus),
  "type": enum (AdGroupType),
  "adRotationMode": enum (AdGroupAdRotationMode),
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "optimizedTargetingEnabled": boolean,
  "displayCustomBidDimension": enum (TargetingDimension),
  "targetingSetting": {
    object (TargetingSetting)
  },
  "audienceSetting": {
    object (AudienceSetting)
  },
  "effectiveTargetCpaSource": enum (BiddingSource),
  "effectiveTargetRoasSource": enum (BiddingSource),
  "labels": [
    string
  ],
  "excludedParentAssetFieldTypes": [
    enum (AssetFieldType)
  ],
  "excludedParentAssetSetTypes": [
    enum (AssetSetType)
  ],
  "id": string,
  "name": string,
  "baseAdGroup": string,
  "trackingUrlTemplate": string,
  "campaign": string,
  "cpcBidMicros": string,
  "effectiveCpcBidMicros": string,
  "cpmBidMicros": string,
  "targetCpaMicros": string,
  "cpvBidMicros": string,
  "targetCpmMicros": string,
  "targetRoas": number,
  "percentCpcBidMicros": string,
  "finalUrlSuffix": string,
  "effectiveTargetCpaMicros": string,
  "effectiveTargetRoas": number
}

Pola
`resourceName`	`string` Niezmienne. Nazwa zasobu grupy reklam. Nazwy zasobów grupy reklam mają postać: `customers/{customerId}/adGroups/{adGroupId}`
`status`	`enum (AdGroupStatus)` Stan grupy reklam.
`type`	`enum (AdGroupType)` Niezmienne. Typ grupy reklam.
`adRotationMode`	`enum (AdGroupAdRotationMode)` Tryb rotacji reklam w grupie reklam.
`urlCustomParameters[]`	`object (CustomParameter)` Lista mapowań używanych do zastępowania tagów parametrów niestandardowych w elementach `trackingUrlTemplate`, `finalUrls` lub `mobile_final_urls`.
`optimizedTargetingEnabled`	`boolean` Prawda, jeśli jest włączone kierowanie zoptymalizowane. Kierowanie zoptymalizowane zastępuje poszerzenie zasięgu wśród odbiorców.
`displayCustomBidDimension`	`enum (TargetingDimension)` Umożliwia reklamodawcom określenie wymiaru kierowania, dla którego będą ustalać stawki bezwzględne. Dotyczy to wyłącznie kampanii kierowanych na sieć reklamową, a nie na sieć wyszukiwania.
`targetingSetting`	`object (TargetingSetting)` Ustawienie kierowania na powiązane funkcje.
`audienceSetting`	`object (AudienceSetting)` Niezmienne. Ustawienie funkcji związanych z odbiorcami.
`effectiveTargetCpaSource`	`enum (BiddingSource)` Tylko dane wyjściowe. Źródło efektywnego docelowego CPA. To pole jest tylko do odczytu.
`effectiveTargetRoasSource`	`enum (BiddingSource)` Tylko dane wyjściowe. Źródło efektywnego docelowego ROAS. To pole jest tylko do odczytu.
`labels[]`	`string` Tylko dane wyjściowe. Nazwy zasobów etykiet dołączonych do tej grupy reklam.
`excludedParentAssetFieldTypes[]`	`enum (AssetFieldType)` Typy pól komponentów, które należy wykluczyć z tej grupy reklam. Powiązania komponentów z tymi typami pól nie będą dziedziczone przez tę grupę reklam z wyższych poziomów.
`excludedParentAssetSetTypes[]`	`enum (AssetSetType)` Typy zestawów komponentów, które należy wykluczyć z tej grupy reklam. Połączenia w zestawach komponentów z tymi typami nie będą dziedziczone przez tę grupę reklam z wyższych poziomów. Typy grup lokalizacji (GMB_DYNAMIC_LOCATION_GROUP, CHAIN_DYNAMIC_LOCATION_GROUP i STATIC_LOCATION_GROUP) są typami grup podrzędnych LOCATION_SYNC. Dlatego, jeśli w tym polu ustawiono funkcję LOCATION_SYNC, nie można połączyć z tą grupą reklam żadnych zestawów komponentów grupy lokalizacji, a rozszerzenia lokalizacji (LE) i rozszerzenia powiązanej lokalizacji (ALE) nie będą wyświetlane w ramach tej grupy reklam. Obecnie obsługiwana jest tylko opcja LOCATION_SYNC.
`id`	`string (int64 format)` Tylko dane wyjściowe. Identyfikator grupy reklam.
`name`	`string` Nazwa grupy reklam. To pole jest wymagane i nie powinno być puste podczas tworzenia nowych grup reklam. Musi zawierać mniej niż 255 znaków UTF-8 o pełnej szerokości. Nie może zawierać znaków null (punkt kodowy 0x0), przejścia do nowej linii NL (punkt kodowy 0xA) ani znaków przejścia do nowej linii (punkt kodowy 0xD).
`baseAdGroup`	`string` Tylko dane wyjściowe. W przypadku grup reklam w wersjach roboczych lub eksperymentalnych to pole zawiera nazwę zasobu podstawowej grupy reklam, na podstawie której utworzono daną grupę reklam. Jeśli wersja robocza lub eksperymentalna grupa reklam nie ma podstawowej grupy reklam, to pole ma wartość null. W przypadku podstawowych grup reklam pole to jest równa nazwie zasobu grupy reklam. To pole jest tylko do odczytu.
`trackingUrlTemplate`	`string` Szablon adresu URL służący do tworzenia linku monitorującego.
`campaign`	`string` Niezmienne. Kampania, do której należy grupa reklam.
`cpcBidMicros`	`string (int64 format)` Maksymalna stawka CPC (kosztu kliknięcia).
`effectiveCpcBidMicros`	`string (int64 format)` Tylko dane wyjściowe. Będzie się ona różnić od wartości stawki CPC (kosztu kliknięcia), jeśli strategia ustalania stawek to CPC ustawiany samodzielnie, Ulepszony CPC, Promowany lub Docelowy udział wygranych aukcji na pierwszej stronie. W przeciwnym razie wartość będzie równa zero.
`cpmBidMicros`	`string (int64 format)` Maksymalna stawka CPM (koszt tysiąca widocznych wyświetleń).
`targetCpaMicros`	`string (int64 format)` Docelowy CPA (koszt pozyskania). Jeśli w grupie reklam masz ustawioną strategię ustalania stawek Docelowy CPA lub Maksymalizacja liczby konwersji (z ustawionym polem Docelowy CPA), to pole zastępuje docelowy CPA określony w strategii ustalania stawek kampanii. W przeciwnym razie ta wartość jest ignorowana.
`cpvBidMicros`	`string (int64 format)` Stawka CPV (kosztu obejrzenia).
`targetCpmMicros`	`string (int64 format)` Średnia kwota (w mikro), którą reklamodawca jest gotowy zapłacić za każdy tysiąc wyświetleń reklamy.
`targetRoas`	`number` Zastąpienie docelowego ROAS (zwrotu z nakładów na reklamę). Jeśli strategia ustalania stawek w kampanii w grupie reklam to DocelowyRoas lub Maksymalizacja wartości konwersji (z ustawionym polem Docelowy ROAS), to pole zastępuje docelowy ROAS określony w strategii ustalania stawek kampanii. W przeciwnym razie ta wartość jest ignorowana.
`percentCpcBidMicros`	`string (int64 format)` Procentowa stawka CPC wyrażona jako ułamek reklamowanej ceny danego towaru lub usługi. Prawidłowy zakres tego ułamka to [0,1), a zapisana wartość to 1 000 000 * [ułamek].
`finalUrlSuffix`	`string` Szablon adresu URL służący do dołączania parametrów do końcowego adresu URL.
`effectiveTargetCpaMicros`	`string (int64 format)` Tylko dane wyjściowe. Efektywny docelowy CPA (koszt pozyskania). To pole jest tylko do odczytu.
`effectiveTargetRoas`	`number` Tylko dane wyjściowe. Rzeczywisty docelowy ROAS (zwrot z nakładów na reklamę) To pole jest tylko do odczytu.

AdGroupStatus

Możliwe stany grupy reklam.

Wartości w polu enum
`UNSPECIFIED`	Stan nie został określony.
`UNKNOWN`	Otrzymana wartość nie jest znana w tej wersji. To jest wartość tylko na odpowiedź.
`ENABLED`	Grupa reklam jest włączona.
`PAUSED`	Grupa reklam jest wstrzymana.
`REMOVED`	Grupa reklam zostanie usunięta.

AdGroupType

Wyliczenie możliwych typów grupy reklam.

Wartości w polu enum
`UNSPECIFIED`	Nie określono typu.
`UNKNOWN`	Otrzymana wartość nie jest znana w tej wersji. To jest wartość tylko na odpowiedź.
`SEARCH_STANDARD`	Domyślny typ grupy reklam w kampaniach w sieci wyszukiwania.
`DISPLAY_STANDARD`	Domyślny typ grupy reklam w kampaniach w sieci reklamowej.
`SHOPPING_PRODUCT_ADS`	Typ grupy reklam używany w kampaniach produktowych, które wyświetlają standardowe reklamy produktów.
`HOTEL_ADS`	Domyślny typ grupy reklam w kampaniach reklam hoteli.
`SHOPPING_SMART_ADS`	Typ grup reklam w inteligentnych kampaniach produktowych.
`VIDEO_BUMPER`	Krótkie reklamy In-Stream, których nie można pominąć.
`VIDEO_TRUE_VIEW_IN_STREAM`	Reklamy wideo TrueView (możliwe do pominięcia) In-Stream.
`VIDEO_TRUE_VIEW_IN_DISPLAY`	reklam wideo TrueView In-Display.
`VIDEO_NON_SKIPPABLE_IN_STREAM`	Reklamy wideo In-Stream niemożliwe do pominięcia.
`VIDEO_OUTSTREAM`	Reklamy wideo typu Out-Stream.
`SEARCH_DYNAMIC_ADS`	Typ grupy reklam dynamicznych w wyszukiwarce.
`SHOPPING_COMPARISON_LISTING_ADS`	Typ grup reklam w kampaniach produktowych z porównaniem informacji o produktach.
`PROMOTED_HOTEL_ADS`	Typ grupy reklam w grupach reklam promowanych hoteli.
`VIDEO_RESPONSIVE`	Grupy reklam wideo.
`VIDEO_EFFICIENT_REACH`	Grupy reklam wideo Skuteczny zasięg.
`SMART_CAMPAIGN_ADS`	Typ grupy reklam w kampaniach inteligentnych.
`TRAVEL_ADS`	Typ grupy reklam w kampaniach dotyczących podróży.

AdGroupAdRotationMode

Możliwe tryby rotacji reklam w danej grupie reklam.

Wartości w polu enum
`UNSPECIFIED`	Tryb rotacji reklam nie został określony.
`UNKNOWN`	Otrzymana wartość nie jest znana w tej wersji. To jest wartość tylko na odpowiedź.
`OPTIMIZE`	Optymalizuj reklamy w grupie reklam na podstawie kliknięć lub konwersji.
`ROTATE_FOREVER`	Wyświetlaj naprzemiennie w nieskończoność.

AudienceSetting

Ustawienia kierowania na odbiorców.

Zapis JSON
{ "useAudienceGrouped": boolean }

Pola

Pola
`useAudienceGrouped`	`boolean` Niezmienne. Jeśli ma wartość prawda, ta grupa reklam wykorzystuje zasób Odbiorcy do kierowania na odbiorców. Jeśli ma wartość fałsz, ta grupa reklam może używać kryteriów segmentu odbiorców.

useAudienceGrouped

boolean

Niezmienne. Jeśli ma wartość prawda, ta grupa reklam wykorzystuje zasób Odbiorcy do kierowania na odbiorców. Jeśli ma wartość fałsz, ta grupa reklam może używać kryteriów segmentu odbiorców.