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
AdGroupAdRotationMode
AudienceSetting
- Zapis JSON
AdGroupPrimaryStatus
AdGroupPrimaryStatusReason

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`) ], "primaryStatus": enum (`AdGroupPrimaryStatus`), "primaryStatusReasons": [ enum (`AdGroupPrimaryStatusReason`) ], "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)
  ],
  "primaryStatus": enum (AdGroupPrimaryStatus),
  "primaryStatusReasons": [
    enum (AdGroupPrimaryStatusReason)
  ],
  "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` Stałe. Nazwa zasobu grupy reklam. Nazwy zasobów grupy reklam mają postać: `customers/{customerId}/adGroups/{adGroupId}`
`status`	`enum (AdGroupStatus)` Stan grupy reklam.
`type`	`enum (AdGroupType)` Stałe. 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 tagach `trackingUrlTemplate`, `finalUrls` lub `mobile_final_urls`.
`optimizedTargetingEnabled`	`boolean` Prawda, jeśli kierowanie zoptymalizowane jest włączone. 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 chcą ustalać stawki bezwzględne. Dotyczy to jedynie kampanii kierowanych na sieć reklamową, a nie na sieć wyszukiwania.
`targetingSetting`	`object (TargetingSetting)` Ustawienie funkcji związanych z kierowaniem.
`audienceSetting`	`object (AudienceSetting)` Stałe. Ustawienie funkcji związanych z odbiorcami.
`effectiveTargetCpaSource`	`enum (BiddingSource)` Tylko dane wyjściowe. Źródło rzeczywistego 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 powinny zostać wykluczone z tej grupy reklam. Linki do zasobó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 powinny zostać wykluczone z tej grupy reklam. Nie będą one 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 opcję LOCATION_SYNC, nie będzie można połączyć z tą grupą reklam żadnych zestawów komponentów grupy lokalizacji, a żadne rozszerzenia lokalizacji (LE) ani rozszerzenia powiązanej lokalizacji nie będą wyświetlane w ramach tej grupy reklam. Obecnie obsługiwana jest tylko funkcja LOCATION_SYNC.
`primaryStatus`	`enum (AdGroupPrimaryStatus)` Tylko dane wyjściowe. Udostępnia zbiorcze informacje o tym, dlaczego grupa reklam nie wyświetla reklam lub nie wyświetla ich w optymalny sposób.
`primaryStatusReasons[]`	`enum (AdGroupPrimaryStatusReason)` Tylko dane wyjściowe. Podaje przyczyny, dla których grupa reklam nie wyświetla reklam lub nie wyświetla ich w optymalny sposób.
`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ć żadnych znaków null (punkt kodowy 0x0), przejścia do nowej linii NL (punkt kodowy 0xA) ani przejścia do nowej linii (punkt kodowy 0xD).
`baseAdGroup`	`string` Tylko dane wyjściowe. W przypadku roboczych lub eksperymentalnych grup reklam 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 to pole odpowiada 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` Stałe. 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. Wartość będzie taka sama jak wartość stawki CPC (kosztu kliknięcia), jeśli strategia ustalania stawek to CPC ustawiany samodzielnie, Ulepszony CPC, Promowana strona na pierwszej stronie lub Docelowy udział wygranych aukcji. W przeciwnym razie wartość będzie mieć wartość null.
`cpmBidMicros`	`string (int64 format)` Maksymalna stawka CPM (koszt tysiąca widocznych wyświetleń).
`targetCpaMicros`	`string (int64 format)` Docelowy CPA (koszt pozyskania). Jeśli w kampanii w grupie reklam wybrano strategię Docelowy CPA lub Maksymalizacja liczby konwersji (z ustawionym polem Docelowy CPA), to pole zastępuje docelowy CPA określony w strategii ustalania stawek w kampanii. W przeciwnym razie wartość ta jest ignorowana.
`cpvBidMicros`	`string (int64 format)` Stawka CPV (koszt obejrzenia).
`targetCpmMicros`	`string (int64 format)` Średnia kwota (w mikro), którą reklamodawca jest skłonny 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 „targetRoas”), to pole zastępuje docelowy ROAS określony w strategii ustalania stawek w kampanii. W przeciwnym razie wartość ta jest ignorowana.
`percentCpcBidMicros`	`string (int64 format)` Procentowa kwota stawki CPC wyrażona jako ułamek reklamowanej ceny za produkt lub usługę. Prawidłowy zakres tego ułamka to [0,1), a przechowywana tutaj 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. Rzeczywisty docelowy CPA (koszt pozyskania). To pole jest tylko do odczytu.
`effectiveTargetRoas`	`number` Tylko dane wyjściowe. Efektywny 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 z odpowiedzią.
`ENABLED`	Grupa reklam jest włączona.
`PAUSED`	Grupa reklam jest wstrzymana.
`REMOVED`	Grupa reklam została usunięta.

AdGroupAdRotationMode

Możliwe tryby rotacji reklam w 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 z odpowiedzią.
`OPTIMIZE`	Optymalizuj reklamy w grupie reklam pod kątem 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` Stałe. Jeśli ma wartość prawda, ta grupa reklam będzie korzystać z zasobu odbiorców na potrzeby kierowania na odbiorców. Jeśli ma wartość Fałsz, ta grupa reklam może zamiast tego używać kryteriów segmentu odbiorców.

useAudienceGrouped

boolean

Stałe. Jeśli ma wartość prawda, ta grupa reklam będzie korzystać z zasobu odbiorców na potrzeby kierowania na odbiorców. Jeśli ma wartość Fałsz, ta grupa reklam może zamiast tego używać kryteriów segmentu odbiorców.

AdGroupPrimaryStatus

Możliwe stany grupy reklam.

Wartości w polu enum
`UNSPECIFIED`	Nie określono.
`UNKNOWN`	Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
`ELIGIBLE`	Grupa reklam może się wyświetlać.
`PAUSED`	Grupa reklam jest wstrzymana.
`REMOVED`	Grupa reklam została usunięta.
`PENDING`	Grupa reklam może się wyświetlać w przyszłości.
`NOT_ELIGIBLE`	Grupa reklam nie kwalifikuje się do wyświetlania.
`LIMITED`	Grupa reklam ma ograniczoną możliwość wyświetlania.

AdGroupPrimaryStatusReason

Możliwe przyczyny stanu grupy reklam.

Wartości w polu enum
`UNSPECIFIED`	Nie określono.
`UNKNOWN`	Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
`CAMPAIGN_REMOVED`	Stan kampanii określony przez użytkownika zostanie usunięty. Uczestniczy w atrybucie AdvertiserPrimaryStatus.NOT_ELIGIBLE.
`CAMPAIGN_PAUSED`	Określony przez użytkownika stan kampanii jest wstrzymany. Uczestniczy w atrybucie AdvertiserPrimaryStatus.NOT_ELIGIBLE.
`CAMPAIGN_PENDING`	Określony przez użytkownika czas rozpoczęcia tej kampanii przypada w przyszłości. Uczestniczy w elemencie AdvertiserPrimaryStatus.NOT_ELIGIBLE
`CAMPAIGN_ENDED`	Określony przez użytkownika czas zakończenia tej kampanii minął. Uczestniczy w atrybucie AdvertiserPrimaryStatus.NOT_ELIGIBLE.
`AD_GROUP_PAUSED`	Określony przez użytkownika stan grupy reklam jest wstrzymany. Przyczynia się do parametru AdvertiserPrimaryStatus.PAUSED.
`AD_GROUP_REMOVED`	Określony przez użytkownika stan grupy reklam zostanie usunięty. Uczestniczy w kolumnie AdvertiserPrimaryStatus.REMOVED.
`AD_GROUP_INCOMPLETE`	Tworzenie tej grupy reklam nie zostało jeszcze ukończone. Uczestniczy w atrybucie AdvertiserPrimaryStatus.NOT_ELIGIBLE.
`KEYWORDS_PAUSED`	Określone przez użytkownika stany słów kluczowych w tej grupie reklam są wstrzymane. Uczestniczy w atrybucie AdvertiserPrimaryStatus.NOT_ELIGIBLE.
`NO_KEYWORDS`	W tej grupie reklam nie ma odpowiednich słów kluczowych. Uczestniczy w atrybucie AdvertiserPrimaryStatus.NOT_ELIGIBLE.
`AD_GROUP_ADS_PAUSED`	Określone przez użytkownika stany reklam w tej grupie reklam są wstrzymane. Uczestniczy w atrybucie AdvertiserPrimaryStatus.NOT_ELIGIBLE.
`NO_AD_GROUP_ADS`	W tej grupie reklam nie ma odpowiednich reklam z grupy reklam. Uczestniczy w atrybucie AdvertiserPrimaryStatus.NOT_ELIGIBLE.
`HAS_ADS_DISAPPROVED`	Stan zgodności z zasadami w przypadku odrzucenia co najmniej 1 reklamy. Uczestniczy w wielu elementach GroupPrimaryStatus.
`HAS_ADS_LIMITED_BY_POLICY`	Stan zgodności z zasadami, gdy co najmniej 1 reklama jest ograniczona przez zasady. Uczestniczy w wielu elementach GroupPrimaryStatus.
`MOST_ADS_UNDER_REVIEW`	Stan zgodności z zasadami, gdy większość reklam oczekuje na sprawdzenie. Uczestniczą w sposobie Stanu głównego grupy reklam.OCZEKUJĄCE.
`CAMPAIGN_DRAFT`	Grupa reklam należy do roboczej wersji kampanii. Uczestniczy w atrybucie AdvertiserPrimaryStatus.NOT_ELIGIBLE.
`AD_GROUP_PAUSED_DUE_TO_LOW_ACTIVITY`	Grupa reklam została wstrzymana z powodu długotrwałej niskiej aktywności w zakresie wyświetlania reklam. Przyczynia się do parametru AdvertiserPrimaryStatus.PAUSED.