SearchAds360Row

Wiersz zwrócony z zapytania.

Zapis JSON 
{
  "adGroup": {
    object (AdGroup)
  },
  "adGroupAd": {
    object (AdGroupAd)
  },
  "adGroupAdLabel": {
    object (AdGroupAdLabel)
  },
  "adGroupAsset": {
    object (AdGroupAsset)
  },
  "adGroupAssetSet": {
    object (AdGroupAssetSet)
  },
  "adGroupAudienceView": {
    object (AdGroupAudienceView)
  },
  "adGroupBidModifier": {
    object (AdGroupBidModifier)
  },
  "adGroupCriterion": {
    object (AdGroupCriterion)
  },
  "adGroupCriterionLabel": {
    object (AdGroupCriterionLabel)
  },
  "adGroupLabel": {
    object (AdGroupLabel)
  },
  "ageRangeView": {
    object (AgeRangeView)
  },
  "asset": {
    object (Asset)
  },
  "assetGroupAsset": {
    object (AssetGroupAsset)
  },
  "assetGroupSignal": {
    object (AssetGroupSignal)
  },
  "assetGroupListingGroupFilter": {
    object (AssetGroupListingGroupFilter)
  },
  "assetGroupTopCombinationView": {
    object (AssetGroupTopCombinationView)
  },
  "assetGroup": {
    object (AssetGroup)
  },
  "assetSetAsset": {
    object (AssetSetAsset)
  },
  "assetSet": {
    object (AssetSet)
  },
  "biddingStrategy": {
    object (BiddingStrategy)
  },
  "campaignBudget": {
    object (CampaignBudget)
  },
  "campaign": {
    object (Campaign)
  },
  "campaignAsset": {
    object (CampaignAsset)
  },
  "campaignAssetSet": {
    object (CampaignAssetSet)
  },
  "campaignAudienceView": {
    object (CampaignAudienceView)
  },
  "campaignCriterion": {
    object (CampaignCriterion)
  },
  "campaignLabel": {
    object (CampaignLabel)
  },
  "cartDataSalesView": {
    object (CartDataSalesView)
  },
  "audience": {
    object (Audience)
  },
  "conversionAction": {
    object (ConversionAction)
  },
  "conversionCustomVariable": {
    object (ConversionCustomVariable)
  },
  "customer": {
    object (Customer)
  },
  "customerAsset": {
    object (CustomerAsset)
  },
  "customerAssetSet": {
    object (CustomerAssetSet)
  },
  "accessibleBiddingStrategy": {
    object (AccessibleBiddingStrategy)
  },
  "customerManagerLink": {
    object (CustomerManagerLink)
  },
  "customerClient": {
    object (CustomerClient)
  },
  "dynamicSearchAdsSearchTermView": {
    object (DynamicSearchAdsSearchTermView)
  },
  "genderView": {
    object (GenderView)
  },
  "geoTargetConstant": {
    object (GeoTargetConstant)
  },
  "keywordView": {
    object (KeywordView)
  },
  "label": {
    object (Label)
  },
  "languageConstant": {
    object (LanguageConstant)
  },
  "locationView": {
    object (LocationView)
  },
  "productBiddingCategoryConstant": {
    object (ProductBiddingCategoryConstant)
  },
  "productGroupView": {
    object (ProductGroupView)
  },
  "shoppingPerformanceView": {
    object (ShoppingPerformanceView)
  },
  "userList": {
    object (UserList)
  },
  "webpageView": {
    object (WebpageView)
  },
  "visit": {
    object (Visit)
  },
  "conversion": {
    object (Conversion)
  },
  "metrics": {
    object (Metrics)
  },
  "segments": {
    object (Segments)
  },
  "customColumns": [
    {
      object (Value)
    }
  ]
}
Pola
adGroup

object (AdGroup)

Grupa reklam, do której odwołuje się zapytanie.
adGroupAd

object (AdGroupAd)

Reklama, do której odwołuje się zapytanie.
adGroupAdLabel

object (AdGroupAdLabel)

Etykieta grupy reklam, do której odwołuje się zapytanie.
adGroupAsset

object (AdGroupAsset)

Komponent z grupą reklam, do którego odwołuje się zapytanie.
adGroupAssetSet

object (AdGroupAssetSet)

Zestaw komponentów grupy reklam, do którego odwołuje się zapytanie.
adGroupAudienceView

object (AdGroupAudienceView)

Widok listy odbiorców grupy reklam, do którego odwołuje się zapytanie.
adGroupBidModifier

object (AdGroupBidModifier)

Modyfikator stawek, do którego odwołuje się zapytanie.
adGroupCriterion

object (AdGroupCriterion)

Kryterium, do którego odwołuje się zapytanie.
adGroupCriterionLabel

object (AdGroupCriterionLabel)

Etykieta kryterium grupy reklam, do której odwołuje się zapytanie.
adGroupLabel

object (AdGroupLabel)

Etykieta grupy reklam, do której odwołuje się zapytanie.
ageRangeView

object (AgeRangeView)

Widok przedziału wiekowego, do którego odwołuje się zapytanie.
asset

object (Asset)

Zasób, do którego odwołuje się zapytanie.
assetGroupAsset

object (AssetGroupAsset)

Zasób grupy plików, do którego odwołuje się zapytanie.
assetGroupSignal

object (AssetGroupSignal)

Sygnał grupy plików, do którego odwołuje się zapytanie.
assetGroupListingGroupFilter

object (AssetGroupListingGroupFilter)

Filtr grupy informacji o produktach w grupie plików, do którego odwołuje się zapytanie.
assetGroupTopCombinationView

object (AssetGroupTopCombinationView)

Widok najpopularniejszej kombinacji grupy plików, do której odwołuje się zapytanie.
assetGroup

object (AssetGroup)

Grupa plików, do której odwołuje się zapytanie.
assetSetAsset

object (AssetSetAsset)

Zasób zestawu zasobów, do którego odwołuje się zapytanie.
assetSet

object (AssetSet)

Zbiór zasobów, do którego odwołuje się zapytanie.
biddingStrategy

object (BiddingStrategy)

Strategia ustalania stawek, do której odwołuje się zapytanie.
campaignBudget

object (CampaignBudget)

Budżet kampanii, do którego odwołuje się zapytanie.
campaign

object (Campaign)

Kampania, do której odwołuje się zapytanie.
campaignAsset

object (CampaignAsset)

Komponent kampanii, do którego odwołuje się zapytanie.
campaignAssetSet

object (CampaignAssetSet)

Zestaw komponentów kampanii, do którego odwołuje się zapytanie.
campaignAudienceView

object (CampaignAudienceView)

Widok odbiorców na poziomie kampanii, do którego odwołuje się zapytanie.
campaignCriterion

object (CampaignCriterion)

Kryterium kampanii, do którego odwołuje się zapytanie.
campaignLabel

object (CampaignLabel)

Etykieta kampanii, do której odwołuje się zapytanie.
cartDataSalesView

object (CartDataSalesView)

Widok sprzedaży danych koszyka, do którego odwołuje się zapytanie.
audience

object (Audience)

Lista odbiorców wymieniona w zapytaniu.
conversionAction

object (ConversionAction)

Działanie powodujące konwersję, do którego odwołuje się zapytanie.
conversionCustomVariable

object (ConversionCustomVariable)

Niestandardowa zmienna konwersji, do której odwołuje się zapytanie.
customer

object (Customer)

Klient wskazany w zapytaniu.
customerAsset

object (CustomerAsset)

Komponent klienta, do którego odwołuje się zapytanie.
customerAssetSet

object (CustomerAssetSet)

Zestaw komponentów klienta, do którego odwołuje się zapytanie.
accessibleBiddingStrategy

object (AccessibleBiddingStrategy)

Dostępna strategia ustalania stawek, do której odwołuje się zapytanie.
customerClient

object (CustomerClient)

Klient CustomerClient, do którego odwołuje się zapytanie.
dynamicSearchAdsSearchTermView

object (DynamicSearchAdsSearchTermView)

Widok wyszukiwanych haseł w dynamicznych reklamach w wyszukiwarce, do którego odwołuje się zapytanie.
genderView

object (GenderView)

Widok płci, do którego odwołuje się zapytanie.
geoTargetConstant

object (GeoTargetConstant)

Stała celu geograficznego, do którego odwołuje się zapytanie.
keywordView

object (KeywordView)

Widok słów kluczowych, do którego odwołuje się zapytanie.
label

object (Label)

Etykieta, do której odwołuje się zapytanie.
languageConstant

object (LanguageConstant)

Stała języka, do której odwołuje się zapytanie.
locationView

object (LocationView)

Widok lokalizacji, do którego odwołuje się zapytanie.
productBiddingCategoryConstant

object (ProductBiddingCategoryConstant)

Kategoria określania stawek za produkt, do której odwołuje się zapytanie.
productGroupView

object (ProductGroupView)

Widok grupy produktów, do którego odwołuje się zapytanie.
shoppingPerformanceView

object (ShoppingPerformanceView)

Widok skuteczności zakupów, do którego odwołuje się zapytanie.
userList

object (UserList)

Lista użytkowników, do której odwołuje się zapytanie.
webpageView

object (WebpageView)

Widok strony internetowej, do którego odwołuje się zapytanie.
visit

object (Visit)

Wizyta na poziomie zdarzenia, do której odwołuje się zapytanie.
conversion

object (Conversion)

Konwersja na poziomie zdarzenia, do której odwołuje się zapytanie.
metrics

object (Metrics)

Dane.
segments

object (Segments)

Segmenty.
customColumns[]

object (Value)

Kolumny niestandardowe.

AdGroup

Grupa reklam.

Zapis JSON 
{
  "resourceName": string,
  "status": enum (AdGroupStatus),
  "type": enum (AdGroupType),
  "adRotationMode": enum (AdGroupAdRotationMode),
  "creationTime": string,
  "targetingSetting": {
    object (TargetingSetting)
  },
  "labels": [
    string
  ],
  "engineId": string,
  "startDate": string,
  "endDate": string,
  "languageCode": string,
  "lastModifiedTime": string,
  "id": string,
  "name": string,
  "cpcBidMicros": string,
  "engineStatus": enum (AdGroupEngineStatus)
}
Pola
resourceName

string

Nazwa zasobu grupy reklam. Nazwy zasobów grupy reklam mają postać:

customers/{customerId}/adGroups/{ad_group_id}
status

enum (AdGroupStatus)

Stan grupy reklam.
type

enum (AdGroupType)

Typ grupy reklam.
adRotationMode

enum (AdGroupAdRotationMode)

Tryb rotacji reklam w grupie reklam.
creationTime

string

Sygnatura czasowa utworzenia tej grupy reklam. Sygnatura czasowa jest podana w strefie czasowej klienta i w formacie „rrrr-MM-dd GG:mm:ss”.
targetingSetting

object (TargetingSetting)

Ustawienie funkcji związanych z kierowaniem.
labels[]

string

Nazwy zasobów etykiet dołączonych do tej grupy reklam.
engineId

string

Identyfikator grupy reklam na zewnętrznym koncie wyszukiwarki. To pole dotyczy tylko kont innych niż Google Ads, np. Yahoo Japan, Microsoft czy Baidu. W przypadku elementu Google Ads użyj „adGroup.id”.
startDate

string

Data rozpoczęcia wyświetlania reklam przez tę grupę reklam. Domyślnie grupa reklam zaczyna się teraz lub w dniu rozpoczęcia grupy reklam (w zależności od tego, która data przypada później). Jeśli to pole jest skonfigurowane, grupa reklam rozpoczyna się od początku wybranego dnia w strefie czasowej klienta. To pole jest dostępne tylko w przypadku kont bram Microsoft Advertising i Facebooka.

Format: RRRR-MM-DD Przykład: 2019-03-14
endDate

string

Data zakończenia wyświetlania reklam z grupy. Grupa reklam kończy się domyślnie w dniu jej zakończenia. Jeśli to pole jest skonfigurowane, grupa reklam kończy się z końcem określonej daty w strefie czasowej klienta. To pole jest dostępne tylko w przypadku kont bram Microsoft Advertising i Facebooka.

Format: RRRR-MM-DD Przykład: 2019-03-14
languageCode

string

Język reklam i słów kluczowych w grupie reklam. To pole jest dostępne tylko na kontach Microsoft Advertising. Więcej informacji: https://docs.microsoft.com/en-us/advertising/guides/ad-languages?view=bingads-13#adlanguage
lastModifiedTime

string

Data i godzina ostatniej modyfikacji tej grupy reklam. Data i godzina są podane w strefie czasowej klienta i w formacie „rrrr-MM-dd GG:mm:ss.ssssss”.
id

string (int64 format)

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).
cpcBidMicros

string (int64 format)

Maksymalna stawka CPC (kosztu kliknięcia).
engineStatus

enum (AdGroupEngineStatus)

Stan wyszukiwarki dla grupy reklam.

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.

AdGroupType

Lista możliwych typów grup reklam.

Wartości w polu enum
UNSPECIFIED Nie określono typu.
UNKNOWN

Otrzymana wartość nie jest znana w tej wersji.

To jest wartość tylko z odpowiedzią.
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 w kampaniach produktowych, w których wyświetlane są standardowe reklamy produktów.
SHOPPING_SHOWCASE_ADS Typ grup reklam, które są ograniczone do wyświetlania reklam z funkcją prezentacji lub reklam sprzedawcy w wynikach wyszukiwania w Zakupach Google.
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 dla grup dynamicznych reklam w wyszukiwarce.
SHOPPING_COMPARISON_LISTING_ADS Typ grup reklam w kampaniach z porównaniem produktów w Zakupach Google.
PROMOTED_HOTEL_ADS Typ grupy reklam w grupach reklam promowanych hoteli.
VIDEO_RESPONSIVE Grupy elastycznych reklam wideo.
VIDEO_EFFICIENT_REACH Grupy reklam wideo typu „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 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ść.

AdGroupEngineStatus

Stan wyszukiwarki 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.
AD_GROUP_ELIGIBLE

Rola wycofana. Nie używać.
AD_GROUP_EXPIRED W tej grupie reklam nie są wyświetlane żadne reklamy, ponieważ minęła data jej zakończenia.
AD_GROUP_REMOVED Grupa reklam została usunięta.
AD_GROUP_DRAFT W tej grupie reklam nie wyświetlają się żadne reklamy, ponieważ powiązana z nią grupa reklam jest nadal w wersji roboczej.
AD_GROUP_PAUSED Grupa reklam została wstrzymana.
AD_GROUP_SERVING Grupa reklam jest aktywna i aktualnie wyświetla reklamy.
AD_GROUP_SUBMITTED Grupa reklam została przesłana (starszy stan Microsoft Bing Ads).
CAMPAIGN_PAUSED W tej grupie reklam nie są wyświetlane żadne reklamy, ponieważ kampania została wstrzymana.
ACCOUNT_PAUSED W tej grupie reklam nie są wyświetlane żadne reklamy, ponieważ konto zostało wstrzymane.

TargetingSetting

Ustawienia funkcji związanych z kierowaniem na poziomie kampanii i grupy reklam. Więcej informacji o ustawieniu kierowania znajdziesz na stronie https://support.google.com/google-ads/answer/7365594

Zapis JSON 
{
  "targetRestrictions": [
    {
      object (TargetRestriction)
    }
  ]
}
Pola
targetRestrictions[]

object (TargetRestriction)

Ustawienie według wymiaru kierowania ograniczające zasięg kampanii lub grupy reklam.

TargetRestriction

Lista ustawień kierowania na wymiar kierowania.

Zapis JSON 
{
  "targetingDimension": enum (TargetingDimension),
  "bidOnly": boolean
}
Pola
targetingDimension

enum (TargetingDimension)

Wymiar kierowania, do którego mają zastosowanie te ustawienia.
bidOnly

boolean

Wskazuje, czy ograniczyć wyświetlanie reklam tylko do kryteriów wybranych dla tego wymiaru kierowania, czy też na kierowanie wszystkich wartości tego wymiaru kierowania i wyświetlanie reklam na podstawie kierowania w innych wymiarach kierowania. Wartość true oznacza, że te kryteria będą stosować tylko modyfikatory stawek i nie będą miały wpływu na kierowanie. Wartość false oznacza, że kryteria te będą ograniczać kierowanie oraz stosować modyfikatory stawek.

TargetingDimension

Wyliczenie opisujące możliwe wymiary kierowania.

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 Kryteria słowa kluczowego, na przykład „rejs po marsie”. Słowo kluczowe KEYWORD można użyć jako wymiaru stawki niestandardowej. Słowa kluczowe są zawsze wymiarami kierowania, więc nie można ich ustawić jako wymiaru docelowego „WSZYSTKO” z ograniczeniem kierowania.
AUDIENCE Kryteria odbiorców, które obejmują listę użytkowników, zainteresowania użytkowników, niestandardowe podobieństwo i niestandardowe grupy odbiorców na rynku.
TOPIC Kryteria tematyczne do kierowania na kategorie treści, np. „category::Zwierzęta>Zwierzęta domowe” używane do kierowania reklam displayowych i wideo.
GENDER Kryteria kierowania na płeć.
AGE_RANGE Kryteria kierowania na przedziały wiekowe.
PLACEMENT Kryteria miejsc docelowych obejmujące witryny takie jak „www.wyprzedaż4kwiaty.pl”, a także aplikacje mobilne, kategorie aplikacji mobilnych, filmy w YouTube i kanały w YouTube.
PARENTAL_STATUS Kryteria kierowania na status rodzicielski.
INCOME_RANGE Kryteria kierowania na przedział dochodu.

AdGroupAd

Reklamę z grupy reklam.

Zapis JSON 
{
  "resourceName": string,
  "status": enum (AdGroupAdStatus),
  "ad": {
    object (Ad)
  },
  "creationTime": string,
  "labels": [
    string
  ],
  "engineId": string,
  "engineStatus": enum (AdGroupAdEngineStatus),
  "lastModifiedTime": string
}
Pola
resourceName

string

Nazwa zasobu reklamy. Nazwy zasobów reklamowych grupy reklam mają postać:

customers/{customerId}/adGroupAds/{ad_group_id}~{adId}
status

enum (AdGroupAdStatus)

Stan reklamy.
ad

object (Ad)

Reklama.
creationTime

string

Sygnatura czasowa utworzenia tej reklamy z grupy reklam. Data i godzina są podane w strefie czasowej klienta i w formacie „rrrr-MM-dd GG:mm:ss.ssssss”.
labels[]

string

Nazwy zasobów etykiet dołączonych do tej reklamy z grupy reklam.
engineId

string

Identyfikator reklamy na zewnętrznym koncie wyszukiwarki. To pole dotyczy tylko konta Search Ads 360, np. Yahoo Japan, Microsoft, Baidu itp. W przypadku jednostek spoza Search Ads 360 użyj „adGroupAd.ad.id”.
engineStatus

enum (AdGroupAdEngineStatus)

Dodatkowy stan reklamy na zewnętrznym koncie wyszukiwarki. Możliwe stany (w zależności od typu konta zewnętrznego) to: aktywne, odpowiednie, oczekujące na sprawdzenie itp.
lastModifiedTime

string

Data i godzina ostatniej modyfikacji tej reklamy należącej do grupy reklam. Data i godzina są podane w strefie czasowej klienta i w formacie „rrrr-MM-dd GG:mm:ss.ssssss”.

AdGroupAdStatus

Możliwe stany reklamy w grupie reklam.

Wartości w polu enum
UNSPECIFIED Nie określono wartości.
UNKNOWN

Otrzymana wartość nie jest znana w tej wersji.

To jest wartość tylko z odpowiedzią.
ENABLED Reklama w grupie reklam jest włączona.
PAUSED Reklama grupy reklam jest wstrzymana.
REMOVED Reklama z grupy reklam została usunięta.

AdType

Możliwe typy reklamy.

Wartości w polu enum
UNSPECIFIED Nie określono wartości.
UNKNOWN

Otrzymana wartość nie jest znana w tej wersji.

To jest wartość tylko z odpowiedzią.
TEXT_AD Jest to reklama tekstowa.
EXPANDED_TEXT_AD Jest to rozszerzona reklama tekstowa.
CALL_ONLY_AD Reklama typu „tylko połączenie”.
EXPANDED_DYNAMIC_SEARCH_AD Reklama jest rozszerzoną dynamiczną reklamą w wyszukiwarce.
HOTEL_AD Reklama to reklama hotelu.
SHOPPING_SMART_AD To inteligentna reklama produktowa.
SHOPPING_PRODUCT_AD To standardowa reklama produktowa.
VIDEO_AD Jest to reklama wideo.
GMAIL_AD Ta reklama to reklama w Gmailu.
IMAGE_AD Ta reklama jest reklamą graficzną.
RESPONSIVE_SEARCH_AD Jest to elastyczna reklama w wyszukiwarce.
LEGACY_RESPONSIVE_DISPLAY_AD To starsza, elastyczna reklama displayowa.
APP_AD Reklama jest reklamą aplikacji.
LEGACY_APP_INSTALL_AD To starsza reklama promująca instalacje aplikacji.
RESPONSIVE_DISPLAY_AD Jest to elastyczna reklama displayowa.
LOCAL_AD Jest to reklama lokalna.
HTML5_UPLOAD_AD Jest to reklama displayowa z typem produktu HTML5_UPLOAD_AD.
DYNAMIC_HTML5_AD Jest to reklama displayowa przesyłana z jednym z typów produktów DYNAMIC_HTML5_*.
APP_ENGAGEMENT_AD Reklama angażująca w aplikację.
SHOPPING_COMPARISON_LISTING_AD Reklama jest reklamą z porównaniem produktów w Zakupach Google.
VIDEO_BUMPER_AD Bumper reklamowy wideo.
VIDEO_NON_SKIPPABLE_IN_STREAM_AD Reklama wideo In-Stream niemożliwa do pominięcia.
VIDEO_OUTSTREAM_AD Reklama wideo Out-Stream.
VIDEO_TRUEVIEW_DISCOVERY_AD Reklama wideo TrueView In-Display.
VIDEO_TRUEVIEW_IN_STREAM_AD Reklama wideo TrueView In-Stream.
VIDEO_RESPONSIVE_AD Elastyczna reklama wideo.
SMART_CAMPAIGN_AD Reklama z kampanii inteligentnej.
APP_PRE_REGISTRATION_AD Uniwersalna reklama promująca aplikację z wcześniejszą rejestracją.
DISCOVERY_MULTI_ASSET_AD Reklama Discovery z wieloma zasobami.
TRAVEL_AD Reklama dotycząca podróży.
DISCOVERY_VIDEO_RESPONSIVE_AD Elastyczna reklama wideo Discovery.

SearchAds360TextAdInfo

Reklama tekstowa w Search Ads 360.

Zapis JSON 
{
  "headline": string,
  "description1": string,
  "description2": string,
  "displayUrl": string,
  "displayMobileUrl": string,
  "adTrackingId": string
}
Pola
headline

string

Nagłówek reklamy.
description1

string

Pierwszy wiersz tekstu reklamy.
description2

string

Drugi wiersz tekstu reklamy.
displayUrl

string

Wyświetlany adres URL reklamy.
displayMobileUrl

string

Wyświetlany mobilny adres URL reklamy.
adTrackingId

string (int64 format)

Identyfikator śledzenia reklamy.

SearchAds360ExpandedTextAdInfo

Rozszerzona reklama tekstowa w Search Ads 360.

Zapis JSON 
{
  "headline": string,
  "headline2": string,
  "headline3": string,
  "description1": string,
  "description2": string,
  "path1": string,
  "path2": string,
  "adTrackingId": string
}
Pola
headline

string

Nagłówek reklamy.
headline2

string

Drugi nagłówek reklamy.
headline3

string

Trzeci nagłówek reklamy.
description1

string

Pierwszy wiersz tekstu reklamy.
description2

string

Drugi wiersz tekstu reklamy.
path1

string

Tekst dołączany do automatycznie wygenerowanego widocznego adresu URL za pomocą separatora.
path2

string

Tekst został dołączony do ścieżki 1 separatorem.
adTrackingId

string (int64 format)

Identyfikator śledzenia reklamy.

SearchAds360ResponsiveSearchAdInfo

Elastyczna reklama w wyszukiwarce w Search Ads 360.

Zapis JSON 
{
  "path1": string,
  "path2": string,
  "adTrackingId": string
}
Pola
path1

string

Tekst dołączany do automatycznie wygenerowanego widocznego adresu URL za pomocą separatora.
path2

string

Tekst został dołączony do ścieżki 1 separatorem.
adTrackingId

string (int64 format)

Identyfikator śledzenia reklamy.

SearchAds360ProductAdInfo

Ten typ nie ma żadnych pól.

Reklama produktu w Search Ads 360.

SearchAds360ExpandedDynamicSearchAdInfo

Rozszerzona dynamiczna reklama w wyszukiwarce.

Zapis JSON 
{
  "description1": string,
  "description2": string,
  "adTrackingId": string
}
Pola
description1

string

Pierwszy wiersz tekstu reklamy.
description2

string

Drugi wiersz tekstu reklamy.
adTrackingId

string (int64 format)

Identyfikator śledzenia reklamy.

AdGroupAdEngineStatus

Liczy stany wyszukiwarki reklam w grupie reklam.

Wartości w polu enum
UNSPECIFIED Nie określono wartości.
UNKNOWN Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
AD_GROUP_AD_ELIGIBLE

Rola wycofana. Nie używać.
AD_GROUP_AD_INAPPROPRIATE_FOR_CAMPAIGN Baidu: kreacja nie została zatwierdzona.
AD_GROUP_AD_MOBILE_URL_UNDER_REVIEW Baidu: mobilny adres URL oczekuje na sprawdzenie.
AD_GROUP_AD_PARTIALLY_INVALID Baidu: kreacja jest nieprawidłowa na urządzeniu mobilnym, ale prawidłowa na komputerze.
AD_GROUP_AD_TO_BE_ACTIVATED Baidu: kreacja jest gotowa do aktywacji.
AD_GROUP_AD_NOT_REVIEWED Baidu: kreacja nie została sprawdzona.
AD_GROUP_AD_ON_HOLD

Rola wycofana. Nie używać. Używany wcześniej przez Gemini
AD_GROUP_AD_PAUSED Kreacja została wstrzymana.
AD_GROUP_AD_REMOVED Kreacja została usunięta.
AD_GROUP_AD_PENDING_REVIEW Kreacja oczekuje na sprawdzenie.
AD_GROUP_AD_UNDER_REVIEW Kreacja jest w trakcie sprawdzania.
AD_GROUP_AD_APPROVED Kreacja została zatwierdzona.
AD_GROUP_AD_DISAPPROVED Kreacja została odrzucona.
AD_GROUP_AD_SERVING Kreacja jest wyświetlana.
AD_GROUP_AD_ACCOUNT_PAUSED Kreacja została wstrzymana, ponieważ konto jest wstrzymane.
AD_GROUP_AD_CAMPAIGN_PAUSED Kreacja została wstrzymana, ponieważ kampania jest wstrzymana.
AD_GROUP_AD_AD_GROUP_PAUSED Kreacja została wstrzymana, ponieważ grupa reklam jest wstrzymana.

AdGroupAdLabel

Związek między reklamą w grupie reklam a etykietą.

Zapis JSON 
{
  "resourceName": string,
  "adGroupAd": string,
  "label": string
}
Pola
resourceName

string

Nazwa zasobu etykiety reklamy grupy reklam. Nazwy zasobów etykiet reklam w grupie reklam mają postać: customers/{customerId}/adGroupAdLabels/{ad_group_id}~{adId}~{label_id}
adGroupAd

string

Reklama w grupie reklam, do której jest dołączona etykieta.
label

string

Etykieta przypisana do reklamy z grupy reklam.

AdGroupAsset

Połączenie między grupą reklam a komponentem.

Zapis JSON 
{
  "resourceName": string,
  "adGroup": string,
  "asset": string,
  "status": enum (AssetLinkStatus)
}
Pola
resourceName

string

Nazwa zasobu grupy reklam. Nazwy zasobów GroupAsset mają postać:

customers/{customerId}/adGroupAssets/{ad_group_id}~{assetId}~{fieldType}
adGroup

string

Wymagane. Grupa reklam, z którą komponent jest połączony.
asset

string

Wymagane. Komponent połączony z grupą reklam.
status

enum (AssetLinkStatus)

Stan komponentu grupy reklam.

AssetLinkStatus

Wyliczenie opisujące stan linku zasobu.

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 Link do zasobu jest włączony.
REMOVED Link do zasobu został usunięty.
PAUSED Link do zasobu jest wstrzymany.

AdGroupAssetSet

Grupa reklam i zestaw zasobów to połączenie między grupą reklam a zbiorem komponentów. Utworzenie obiektu GroupAssetSet powoduje połączenie zestawu komponentów z grupą reklam.

Zapis JSON 
{
  "resourceName": string,
  "adGroup": string,
  "assetSet": string,
  "status": enum (AssetSetLinkStatus)
}
Pola
resourceName

string

Nazwa zasobu zestawu komponentów grupy reklam. Nazwy zasobów zestawu komponentów grupy reklam mają postać:

customers/{customerId}/adGroupAssetSets/{ad_group_id}~{asset_set_id}
adGroup

string

Grupa reklam, z którą połączony jest ten zestaw komponentów.
assetSet

string

Zestaw komponentów połączony z grupą reklam.
status

enum (AssetSetLinkStatus)

Stan zestawu komponentów grupy reklam. Tylko do odczytu.

AssetSetLinkStatus

Możliwe stany połączenia zestawu zasobów z jego kontenerem.

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 Włączone jest łączenie zestawu zasobów z jego kontenerem.
REMOVED Połączenie między zestawem zasobów a jego kontenerem zostanie usunięte.

AdGroupAudienceView

Widok odbiorców grupy reklam. Zawiera dane o skuteczności pochodzące z zainteresowań i list remarketingowych dla reklam w sieci reklamowej i w YouTube oraz listy remarketingowe dla reklam w wyszukiwarce (RLSA) zebrane na poziomie odbiorców.

Zapis JSON 
{
  "resourceName": string
}
Pola
resourceName

string

Nazwa zasobu widoku odbiorców na poziomie grupy reklam. Nazwy zasobów widoku listy odbiorców w grupie reklam mają postać:

customers/{customerId}/adGroupAudienceViews/{ad_group_id}~{criterionId}

AdGroupBidModifier

Reprezentuje modyfikator stawek grupy reklam.

Zapis JSON 
{
  "resourceName": string,
  "bidModifier": number,

  // Union field criterion can be only one of the following:
  "device": {
    object (DeviceInfo)
  }
  // End of list of possible types for union field criterion.
}
Pola
resourceName

string

Nazwa zasobu modyfikatora stawki grupy reklam. Nazwy zasobów modyfikatora stawek grupy reklam mają postać:

customers/{customerId}/adGroupBidModifiers/{ad_group_id}~{criterionId}
bidModifier

number

Modyfikator stawki, gdy kryterium spełnia kryterium. Modyfikator musi mieścić się w zakresie: 0,1 - 10,0. Zakres to 1,0–6,0 dla PreferredContent. Aby zrezygnować z danego typu urządzenia, wpisz 0.

Pole sumy criterion. Kryterium tego modyfikatora stawek grupy reklam.

Wymagane przy operacjach tworzenia począwszy od wersji 5. criterion może być tylko jedną z tych wartości:
device

object (DeviceInfo)

Kryterium urządzenia.

DeviceInfo

Kryterium urządzenia.

Zapis JSON 
{
  "type": enum (Device)
}
Pola
type

enum (Device)

Typ urządzenia.

Urządzenie

Określa urządzenia Google Ads, na które można kierować reklamy.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Wartość jest nieznana w tej wersji.
MOBILE Komórki wyposażone w przeglądarkę z pełną funkcjonalnością.
TABLET Tablety wyposażone w przeglądarkę z pełną funkcjonalnością.
DESKTOP Komputery.
CONNECTED_TV Telewizory smart TV i konsole do gier
OTHER Inne typy urządzeń.

AdGroupCriterion

Kryterium grupy reklam. Raport adGroupCriterion zwraca tylko te kryteria, które zostały bezpośrednio dodane do grupy reklam.

Zapis JSON 
{
  "resourceName": string,
  "creationTime": string,
  "status": enum (AdGroupCriterionStatus),
  "qualityInfo": {
    object (QualityInfo)
  },
  "type": enum (CriterionType),
  "labels": [
    string
  ],
  "positionEstimates": {
    object (PositionEstimates)
  },
  "finalUrls": [
    string
  ],
  "engineId": string,
  "lastModifiedTime": string,
  "criterionId": string,
  "adGroup": string,
  "negative": boolean,
  "bidModifier": number,
  "cpcBidMicros": string,
  "effectiveCpcBidMicros": string,
  "engineStatus": enum (AdGroupCriterionEngineStatus),
  "finalUrlSuffix": string,
  "trackingUrlTemplate": string,

  // Union field criterion can be only one of the following:
  "keyword": {
    object (KeywordInfo)
  },
  "listingGroup": {
    object (ListingGroupInfo)
  },
  "ageRange": {
    object (AgeRangeInfo)
  },
  "gender": {
    object (GenderInfo)
  },
  "userList": {
    object (UserListInfo)
  },
  "webpage": {
    object (WebpageInfo)
  },
  "location": {
    object (LocationInfo)
  }
  // End of list of possible types for union field criterion.
}
Pola
resourceName

string

Nazwa zasobu kryterium grupy reklam. Nazwy zasobów kryterium w grupie reklam mają postać:

customers/{customerId}/adGroupCriteria/{ad_group_id}~{criterionId}
creationTime

string

Sygnatura czasowa utworzenia tego kryterium w grupie reklam. Sygnatura czasowa jest podana w strefie czasowej klienta i w formacie „rrrr-MM-dd GG:mm:ss”.
status

enum (AdGroupCriterionStatus)

Stan kryterium.

To jest stan elementu kryterium grupy reklam ustawiony przez klienta. Uwaga: raporty interfejsu mogą zawierać dodatkowe informacje, które wpływają na to, czy kryterium może zostać uruchomione. W niektórych przypadkach kryterium USUNIĘTE w interfejsie API może być nadal wyświetlane w interfejsie jako włączone. Na przykład kampanie domyślnie wyświetlają się użytkownikom ze wszystkich przedziałów wiekowych, chyba że zostaną wykluczone. Każdy przedział wiekowy będzie widoczny w interfejsie jako „włączony”, ponieważ reklamy mogą być dla nich widoczne. Jednakże w przypadku grupy reklamCriterion.status będzie widoczna wartość „usunięta”, ponieważ nie dodano żadnego niewykluczającego kryterium.
qualityInfo

object (QualityInfo)

Informacje o jakości kryterium.
type

enum (CriterionType)

Rodzaj kryterium.
labels[]

string

Nazwy zasobów etykiet dołączonych do tego kryterium grupy reklam.
positionEstimates

object (PositionEstimates)

Szacunki dla stawek dla różnych kryteriów na różnych pozycjach.
finalUrls[]

string

Lista możliwych końcowych adresów URL po wszystkich przekierowaniach między domenami w reklamie.
engineId

string

Identyfikator kryterium grupy reklam na zewnętrznym koncie wyszukiwarki. To pole dotyczy tylko kont innych niż Google Ads, np. Yahoo Japan, Microsoft czy Baidu. W przypadku elementu Google Ads użyj „adGroupCriterion.criterion_id”.
lastModifiedTime

string

Data i godzina ostatniej modyfikacji tego kryterium w grupie reklam. Data i godzina są podane w strefie czasowej klienta i w formacie „rrrr-MM-dd GG:mm:ss.ssssss”.
criterionId

string (int64 format)

Identyfikator kryterium.
adGroup

string

Grupa reklam, do której należy kryterium.
negative

boolean

Określa, czy kryterium ma być celem kierowania (false) czy wykluczonym (true).

Tego pola nie można zmienić. Aby zmienić kryterium z dodatnie na wykluczające, usuń je i dodaj ponownie.
bidModifier

number

Modyfikator stawki, gdy kryterium spełnia kryterium. Modyfikator musi mieścić się w zakresie: 0,1 - 10,0. Większość typów kryteriów kierowania obsługuje modyfikatory.
cpcBidMicros

string (int64 format)

Stawka CPC (kosztu kliknięcia).
effectiveCpcBidMicros

string (int64 format)

Efektywna stawka CPC (koszt kliknięcia).
engineStatus

enum (AdGroupCriterionEngineStatus)

Stan wyszukiwarki dla kryterium grupy reklam.
finalUrlSuffix

string

Szablon adresu URL służący do dołączania parametrów do końcowego adresu URL.
trackingUrlTemplate

string

Szablon adresu URL służący do tworzenia linku monitorującego.

Pole sumy criterion. Kryterium grupy reklam.

Musisz ustawić dokładnie jeden. criterion może być tylko jedną z tych wartości:
keyword

object (KeywordInfo)

Słowo kluczowe.
listingGroup

object (ListingGroupInfo)

Grupa informacji o produktach.
ageRange

object (AgeRangeInfo)

Przedział wiekowy.
gender

object (GenderInfo)

Płeć.
userList

object (UserListInfo)

Lista użytkowników.
webpage

object (WebpageInfo)

Strona internetowa
location

object (LocationInfo)

Lokalizacja.

AdGroupCriterionStatus

Możliwe stany kryterium grupy reklam.

Wartości w polu enum
UNSPECIFIED Nie określono wartości.
UNKNOWN

Otrzymana wartość nie jest znana w tej wersji.

To jest wartość tylko z odpowiedzią.
ENABLED Kryterium w grupie reklam jest włączone.
PAUSED Kryterium w grupie reklam jest wstrzymane.
REMOVED Kryterium w grupie reklam zostało usunięte.

QualityInfo

Kontener informacji dotyczących jakości kryterium grupy reklam.

Zapis JSON 
{
  "qualityScore": integer
}
Pola
qualityScore

integer

Wynik jakości.

To pole może nie być wypełniane, jeśli Google nie ma wystarczających informacji do określenia wartości.

CriterionType

Wyliczenie opisujące możliwe typy kryterió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 Słowo kluczowe na przykład „rejs po marsie”.
PLACEMENT Miejsce docelowe, znane również jako witryna, np. „www.wyprzedaż4kwiatów.com”
MOBILE_APP_CATEGORY Kategorie aplikacji mobilnych, na które chcesz kierować reklamy.
MOBILE_APPLICATION Aplikacje mobilne, na które chcesz kierować reklamy.
DEVICE Urządzenia, na które chcesz kierować reklamy.
LOCATION Lokalizacje, na które mają być kierowane reklamy.
LISTING_GROUP Grupy informacji o produktach, na które mają być kierowane reklamy.
AD_SCHEDULE Harmonogram reklam.
AGE_RANGE Przedział wiekowy.
GENDER Płeć.
INCOME_RANGE Zakres przychodu.
PARENTAL_STATUS Status rodzicielski.
YOUTUBE_VIDEO Film w YouTube.
YOUTUBE_CHANNEL Kanał w YouTube.
USER_LIST Lista użytkowników.
PROXIMITY Bliskość.
TOPIC Kierowanie na temat w sieci reklamowej (np. „Zwierzęta dzikie i domowe”).
LISTING_SCOPE Zakres informacji o aplikacji, na który chcesz kierować reklamy.
LANGUAGE Językiem
IP_BLOCK IPBlock.
CONTENT_LABEL Etykieta treści dla wykluczenia kategorii.
CARRIER Operator.
USER_INTEREST Kategoria, którą interesuje użytkownika.
WEBPAGE Kryterium strony internetowej dla dynamicznych reklam w wyszukiwarce.
OPERATING_SYSTEM_VERSION Wersja systemu operacyjnego.
APP_PAYMENT_MODEL Model płatności za aplikację.
MOBILE_DEVICE Urządzenie mobilne.
CUSTOM_AFFINITY Niestandardowe podobieństwo.
CUSTOM_INTENT Niestandardowi odbiorcy o podobnych zamiarach.
LOCATION_GROUP Grupa lokalizacji.
CUSTOM_AUDIENCE Niestandardowa lista odbiorców
COMBINED_AUDIENCE Odbiorcy z połączonych list
KEYWORD_THEME Kampania inteligentna – grupa tematyczna słów kluczowych
AUDIENCE Odbiorcy
LOCAL_SERVICE_ID Identyfikator usługi Reklam Usług Lokalnych.
BRAND Marka
BRAND_LIST Lista marek
LIFE_EVENT Zdarzenie z życia

PositionEstimates

Szacunki dla stawek dla różnych kryteriów na różnych pozycjach.

Zapis JSON 
{
  "topOfPageCpcMicros": string
}
Pola
topOfPageCpcMicros

string (int64 format)

Szacunkowa stawka CPC wymagana do wyświetlenia reklamy na górze pierwszej strony wyników wyszukiwania.

AdGroupCriterionEngineStatus

Wylicza stany wyszukiwarki GroupCriterion.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
AD_GROUP_CRITERION_ELIGIBLE

Rola wycofana. Nie używać.
AD_GROUP_CRITERION_INAPPROPRIATE_FOR_CAMPAIGN Baidu: stawka lub jakość są za niskie, aby reklama mogła się wyświetlać.
AD_GROUP_CRITERION_LOW_SEARCH_VOLUME Baidu: reklama wstrzymana przez Baidu z powodu małej liczby wyszukiwań.
AD_GROUP_CRITERION_MOBILE_URL_UNDER_REVIEW Baidu: mobilny adres URL oczekuje na sprawdzenie.
AD_GROUP_CRITERION_PARTIALLY_INVALID Baidu: strona docelowa jednego urządzenia jest nieprawidłowa, a strona docelowa na drugim urządzeniu jest prawidłowa.
AD_GROUP_CRITERION_TO_BE_ACTIVATED Baidu: słowo kluczowe zostało utworzone i wstrzymane przez funkcję zarządzania kontem Baidu i możesz je teraz aktywować.
AD_GROUP_CRITERION_UNDER_REVIEW Baidu: oczekuje na sprawdzenie przez Baidu. Gemini: kryterium w trakcie sprawdzania.
AD_GROUP_CRITERION_NOT_REVIEWED Baidu: kryterium do sprawdzenia.
AD_GROUP_CRITERION_ON_HOLD

Rola wycofana. Nie używać. Używany wcześniej przez Gemini
AD_GROUP_CRITERION_PENDING_REVIEW Y!J : kryterium oczekuje na sprawdzenie
AD_GROUP_CRITERION_PAUSED Kryterium zostało wstrzymane.
AD_GROUP_CRITERION_REMOVED Kryterium zostało usunięte.
AD_GROUP_CRITERION_APPROVED Kryterium zostało zatwierdzone.
AD_GROUP_CRITERION_DISAPPROVED Kryterium zostało odrzucone.
AD_GROUP_CRITERION_SERVING Kryterium jest aktywne i powoduje wyświetlanie reklam.
AD_GROUP_CRITERION_ACCOUNT_PAUSED Kryterium zostało wstrzymane, ponieważ konto jest wstrzymane.

KeywordInfo

Kryterium słowa kluczowego.

Zapis JSON 
{
  "matchType": enum (KeywordMatchType),
  "text": string
}
Pola
matchType

enum (KeywordMatchType)

Typ dopasowania słowa kluczowego.
text

string

Tekst słowa kluczowego (maksymalnie 80 znaków i 10 słów).

KeywordMatchType

Możliwe typy dopasowania słów kluczowych.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
EXACT Dopasowanie ścisłe.
PHRASE Dopasowanie do wyrażenia.
BROAD Dopasowanie przybliżone.

ListingGroupInfo

Kryterium grupy informacji o produktach.

Zapis JSON 
{
  "type": enum (ListingGroupType)
}
Pola
type

enum (ListingGroupType)

Typ grupy informacji o produktach.

ListingGroupType

Typ grupy informacji o produktach.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
SUBDIVISION Podział produktów według niektórych wymiarów informacji o produkcie. Te węzły nie są używane do kierowania na wpisy z listą, ale służą tylko do definiowania struktury drzewa.
UNIT Jednostka grupy informacji o produktach określająca stawkę.

AgeRangeInfo

Kryterium przedziału wiekowego.

Zapis JSON 
{
  "type": enum (AgeRangeType)
}
Pola
type

enum (AgeRangeType)

Typ przedziału wiekowego.

AgeRangeType

Rodzaj grupy demograficznej przedziałów wiekowych (na przykład od 18 do 24 lat).

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
AGE_RANGE_18_24 między 18 a 24 rokiem życia.
AGE_RANGE_25_34 między 25 a 34 rokiem życia;
AGE_RANGE_35_44 Między 35 a 44 rokiem życia.
AGE_RANGE_45_54 między 45 a 54 rokiem życia.
AGE_RANGE_55_64 Między 55 a 64 rokiem życia.
AGE_RANGE_65_UP 65 lat i więcej.
AGE_RANGE_UNDETERMINED Nieokreślony przedział wiekowy.

GenderInfo

Kryterium płci.

Zapis JSON 
{
  "type": enum (GenderType)
}
Pola
type

enum (GenderType)

Rodzaj płci.

GenderType

Rodzaj płci (np. kobiety).

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
MALE Mężczyzna.
FEMALE Kobieta.
UNDETERMINED Nie określono płci.

UserListInfo

Kryterium listy użytkowników. Reprezentuje listę użytkowników zdefiniowaną przez reklamodawcę, na którą ma być kierowana reklama.

Zapis JSON 
{
  "userList": string
}
Pola
userList

string

Nazwa zasobu listy użytkowników.

WebpageInfo

Reprezentuje kryterium kierowania reklam na strony internetowe w witrynie reklamodawcy.

Zapis JSON 
{
  "conditions": [
    {
      object (WebpageConditionInfo)
    }
  ],
  "coveragePercentage": number,
  "criterionName": string
}
Pola
conditions[]

object (WebpageConditionInfo)

Warunki lub wyrażenia logiczne na potrzeby kierowania na strony internetowe. Lista warunków kierowania na strony internetowe jest i jest łączona podczas oceny kierowania. Pusta lista warunków oznacza, że reklamy są kierowane na wszystkie strony witryny kampanii.

To pole jest wymagane w przypadku operacji CREATE i jest niedozwolone w przypadku operacji UPDATE.
coveragePercentage

number

Procent pokrycia kryteriów witryny. To obliczony odsetek pokrycia witryny obliczony na podstawie celu witryny, wykluczonej witryny docelowej i wykluczających słów kluczowych w grupie reklam i kampanii. Jeśli na przykład pokrycie zwraca wartość 1, oznacza to, że ma 100% pokrycia. To pole jest tylko do odczytu.
criterionName

string

Nazwa kryterium określona przez ten parametr. Wartość nazwy służy do identyfikowania, sortowania i filtrowania kryteriów związanych z tym typem parametrów.

To pole jest wymagane w przypadku operacji CREATE i jest niedozwolone w przypadku operacji UPDATE.

WebpageConditionInfo

Wyrażenie logiczne służące do kierowania reklam na strony internetowe w witrynie reklamodawcy.

Zapis JSON 
{
  "operand": enum (WebpageConditionOperand),
  "operator": enum (WebpageConditionOperator),
  "argument": string
}
Pola
operand

enum (WebpageConditionOperand)

Parametr warunku kierowania na stronę internetową.
operator

enum (WebpageConditionOperator)

Operator warunku kierowania na stronę internetową.
argument

string

Argument warunku kierowania na stronę internetową.

WebpageConditionOperand

Argument warunku strony internetowej w kryterium strony internetowej.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
URL Komentarz określający warunek kierowania na adres URL strony internetowej.
CATEGORY Komentarz określający warunek kierowania na kategorię stron internetowych.
PAGE_TITLE Komentarz określający warunek kierowania na tytuł strony internetowej.
PAGE_CONTENT Komentarz określający warunek kierowania na treść strony internetowej.
CUSTOM_LABEL Komentarz określający warunek kierowania etykiety własnej na stronie internetowej.

WebpageConditionOperator

Operator warunku strony internetowej w kryterium strony.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
EQUALS Warunek internetowy argumentu jest równy porównywanym warunkom sieciowym.
CONTAINS Warunek internetowy argumentu jest częścią porównywanego warunku internetowego.

LocationInfo

Kryterium lokalizacji.

Zapis JSON 
{
  "geoTargetConstant": string
}
Pola
geoTargetConstant

string

Nazwa stałego zasobu kierowania geograficznego.

AdGroupCriterionLabel

Związek między kryterium grupy reklam a etykietą.

Zapis JSON 
{
  "resourceName": string,
  "adGroupCriterion": string,
  "label": string
}
Pola
resourceName

string

Nazwa zasobu etykiety kryterium grupy reklam. Nazwy zasobów etykiety kryterium w grupie reklam mają postać: customers/{customerId}/adGroupCriterionLabels/{ad_group_id}~{criterionId}~{label_id}
adGroupCriterion

string

Kryterium grupy reklam, do którego jest dołączona etykieta.
label

string

Etykieta przypisana do kryterium w grupie reklam.

AdGroupLabel

Związek między grupą reklam a etykietą.

Zapis JSON 
{
  "resourceName": string,
  "adGroup": string,
  "label": string
}
Pola
resourceName

string

Nazwa zasobu etykiety grupy reklam. Nazwy zasobów etykiet grupy reklam mają postać: customers/{customerId}/adGroupLabels/{ad_group_id}~{label_id}
adGroup

string

Grupa reklam, do której jest dołączona etykieta.
label

string

Etykieta przypisana do grupy reklam.

AgeRangeView

Widok przedziału wiekowego.

Zapis JSON 
{
  "resourceName": string
}
Pola
resourceName

string

Nazwa zasobu widoku przedziału wiekowego. Nazwy zasobów widoku przedziału wiekowego mają postać:

customers/{customerId}/ageRangeViews/{ad_group_id}~{criterionId}

Zasób

Zasób to część reklamy, która może być współużytkowana przez wiele reklam. Może to być obraz (ImageAsset), film (YouTubeVideoAsset) itp. Komponentów nie można zmienić i nie można ich usunąć. Aby zatrzymać wyświetlanie komponentu, usuń go z elementu, który z niego korzysta.

Zapis JSON 
{
  "resourceName": string,
  "type": enum (AssetType),
  "finalUrls": [
    string
  ],
  "status": enum (AssetStatus),
  "creationTime": string,
  "lastModifiedTime": string,
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "engineStatus": enum (AssetEngineStatus),

  // Union field asset_data can be only one of the following:
  "youtubeVideoAsset": {
    object (YoutubeVideoAsset)
  },
  "imageAsset": {
    object (ImageAsset)
  },
  "textAsset": {
    object (TextAsset)
  },
  "calloutAsset": {
    object (UnifiedCalloutAsset)
  },
  "sitelinkAsset": {
    object (UnifiedSitelinkAsset)
  },
  "pageFeedAsset": {
    object (UnifiedPageFeedAsset)
  },
  "mobileAppAsset": {
    object (MobileAppAsset)
  },
  "callAsset": {
    object (UnifiedCallAsset)
  },
  "callToActionAsset": {
    object (CallToActionAsset)
  },
  "locationAsset": {
    object (UnifiedLocationAsset)
  }
  // End of list of possible types for union field asset_data.
}
Pola
resourceName

string

Nazwa zasobu. Nazwy zasobów zasobów mają postać:

customers/{customerId}/assets/{assetId}
type

enum (AssetType)

Typ zasobu.
finalUrls[]

string

Lista możliwych końcowych adresów URL po wszystkich przekierowaniach między domenami.
status

enum (AssetStatus)

Stan zasobu.
creationTime

string

Sygnatura czasowa utworzenia tego zasobu. Sygnatura czasowa jest podana w strefie czasowej klienta i w formacie „rrrr-MM-dd GG:mm:ss”.
lastModifiedTime

string

Data i godzina ostatniej modyfikacji zasobu. Data i godzina są podane w strefie czasowej klienta i w formacie „rrrr-MM-dd GG:mm:ss.ssssss”.
id

string (int64 format)

Identyfikator zasobu.
name

string

Opcjonalna nazwa zasobu.
trackingUrlTemplate

string

Szablon URL do tworzenia linku monitorującego.
engineStatus

enum (AssetEngineStatus)

Stan wyszukiwarki zasobu.
Pole sumy asset_data. Konkretny typ zasobu. asset_data może być tylko jedną z tych wartości:
youtubeVideoAsset

object (YoutubeVideoAsset)

Komponent wideo w YouTube.
imageAsset

object (ImageAsset)

Komponent z obrazem.
textAsset

object (TextAsset)

Komponent tekstowy.
calloutAsset

object (UnifiedCalloutAsset)

Ujednolicony komponent z objaśnieniami.
pageFeedAsset

object (UnifiedPageFeedAsset)

Komponent z ujednoliconym plikiem z adresami stron docelowych.
mobileAppAsset

object (MobileAppAsset)

Komponent z linkiem do aplikacji mobilnej.
callAsset

object (UnifiedCallAsset)

Ujednolicony komponent do wykonywania połączeń.
callToActionAsset

object (CallToActionAsset)

Komponent z wezwaniem do działania.
locationAsset

object (UnifiedLocationAsset)

Ujednolicony komponent z lokalizacją.

AssetType

Wartość Enum opisująca możliwe typy zasobu.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
YOUTUBE_VIDEO Komponent wideo w YouTube.
MEDIA_BUNDLE Zasób pakietu kreacji multimedialnych.
IMAGE Komponent z obrazem.
TEXT Komponent tekstowy.
LEAD_FORM Komponent z formularzem kontaktowym.
BOOK_ON_GOOGLE Komponent Zarezerwuj z Google.
PROMOTION Komponent z promocją.
CALLOUT Komponent z objaśnieniem.
STRUCTURED_SNIPPET Komponent z rozszerzeniem informacji.
PAGE_FEED Komponent z plikiem z adresami stron docelowych.
DYNAMIC_EDUCATION Dynamiczny zasób edukacyjny.
MOBILE_APP Komponent z linkiem do aplikacji mobilnej.
HOTEL_CALLOUT Komponent z objaśnieniem dotyczącym hoteli.
CALL Komponent do wykonywania połączeń.
PRICE Komponent z cenami.
CALL_TO_ACTION Komponent z wezwaniem do działania.
DYNAMIC_REAL_ESTATE Dynamiczny zasób związany z nieruchomościami.
DYNAMIC_CUSTOM Dynamiczny zasób niestandardowy.
DYNAMIC_HOTELS_AND_RENTALS Dynamiczny zasób dotyczący hoteli i wynajmu.
DYNAMIC_FLIGHTS Zasób dynamicznych lotów.
DYNAMIC_TRAVEL Dynamiczny komponent związany z podróżami.
DYNAMIC_LOCAL Dynamiczny zasób lokalny.
DYNAMIC_JOBS Dynamiczny zasób z ofertami pracy.
LOCATION Komponent z lokalizacją.
HOTEL_PROPERTY Komponent dotyczący obiektu hotelowego.

AssetStatus

Możliwe stany komponentu.

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 Komponent jest włączony.
REMOVED Komponent zostanie usunięty.
ARCHIVED Zasób został zarchiwizowany.
PENDING_SYSTEM_GENERATED Zasób został wygenerowany przez system i oczekuje na sprawdzenie przez użytkownika.

AssetEngineStatus

Następny identyfikator = 11

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
SERVING Zasób jest aktywny.
SERVING_LIMITED Zasób jest aktywny i ograniczony.
DISAPPROVED Komponent został odrzucony (nieodpowiedni).
DISABLED Komponent jest nieaktywny (oczekujący).
REMOVED Komponent został usunięty.

YoutubeVideoAsset

Zasób YouTube.

Zapis JSON 
{
  "youtubeVideoTitle": string,
  "youtubeVideoId": string
}
Pola
youtubeVideoTitle

string

Tytuł filmu w YouTube.
youtubeVideoId

string

Identyfikator filmu w YouTube. Jest to ciąg 11 znaków używany w adresie URL filmu w YouTube.

ImageAsset

Komponent z obrazem.

Zapis JSON 
{
  "mimeType": enum (MimeType),
  "fullSize": {
    object (ImageDimension)
  },
  "fileSize": string
}
Pola
mimeType

enum (MimeType)

Typ MIME zasobu graficznego.
fullSize

object (ImageDimension)

Metadane tego obrazu w oryginalnym rozmiarze.
fileSize

string (int64 format)

Rozmiar pliku komponentu z obrazem w bajtach.

MimeType

typ MIME.

Wartości w polu enum
UNSPECIFIED Typ MIME nie został określony.
UNKNOWN

Otrzymana wartość nie jest znana w tej wersji.

To jest wartość tylko z odpowiedzią.
IMAGE_JPEG Typ MIME obrazu/jpeg.
IMAGE_GIF Typ MIME obrazu/GIF-a.
IMAGE_PNG Typ MIME obrazu/png.
FLASH Typ MIME pliku application/x-shockwave-flash.
TEXT_HTML Typ MIME pliku text/html.
PDF Typ MIME aplikacji/pdf.
MSWORD Typ MIME aplikacji/msword.
MSEXCEL Typ MIME pliku application/vnd.ms-excel.
RTF Typ MIME pliku application/rtf.
AUDIO_WAV Typ MIME pliku audio/WAV.
AUDIO_MP3 Typ MIME pliku audio/mp3.
HTML5_AD_ZIP Typ MIME pliku application/x-html5-ad-zip.

ImageDimension

Metadane obrazu w określonym rozmiarze (oryginalne lub zmienione).

Zapis JSON 
{
  "heightPixels": string,
  "widthPixels": string,
  "url": string
}
Pola
heightPixels

string (int64 format)

Wysokość obrazu.
widthPixels

string (int64 format)

Szerokość obrazu.
url

string

Adres URL, który zwraca obraz o tej wysokości i szerokości.

TextAsset

Komponent tekstowy.

Zapis JSON 
{
  "text": string
}
Pola
text

string

Treść tekstowa komponentu tekstowego.

UnifiedCalloutAsset

Ujednolicony komponent z objaśnieniami.

Zapis JSON 
{
  "calloutText": string,
  "startDate": string,
  "endDate": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ],
  "useSearcherTimeZone": boolean
}
Pola
calloutText

string

Tekst objaśnienia. Jego długość powinna mieścić się w przedziale od 1 do 25 włącznie.
startDate

string

Data rozpoczęcia wyświetlania zasobu w formacie rrrr-MM-dd.
endDate

string

Data ostatniej daty ważności tego komponentu i nadal jest wyświetlana. Czas jest w formacie rrrr-MM-dd.
adScheduleTargets[]

object (AdScheduleInfo)

Lista nienakładających się harmonogramów określająca wszystkie przedziały czasowe, w których zasób może się wyświetlać. Można ustawić maksymalnie 6 harmonogramów na dzień, a łącznie 42.
useSearcherTimeZone

boolean

Określa, czy zasób ma być wyświetlany w strefie czasowej użytkownika przeprowadzającego wyszukiwanie. Dotyczy Microsoft Ads.

AdScheduleInfo

Reprezentuje kryterium AdSchedule.

AdSchedule jest określony jako dzień tygodnia i przedział czasu, w którym mają być wyświetlane reklamy.

Dla tego samego dnia można dodać maksymalnie 6 harmonogramów AdSchedule.

Zapis JSON 
{
  "startMinute": enum (MinuteOfHour),
  "endMinute": enum (MinuteOfHour),
  "dayOfWeek": enum (DayOfWeek),
  "startHour": integer,
  "endHour": integer
}
Pola
startMinute

enum (MinuteOfHour)

Minuty po godzinie rozpoczęcia, o której rozpoczyna się ten harmonogram.

To pole jest wymagane w przypadku operacji CREATE i jest niedozwolone w przypadku operacji UPDATE.
endMinute

enum (MinuteOfHour)

Minuty po godzinie zakończenia tego harmonogramu. W harmonogramie nie ma minut końcowych.

To pole jest wymagane w przypadku operacji CREATE i jest niedozwolone w przypadku operacji UPDATE.
dayOfWeek

enum (DayOfWeek)

Dzień tygodnia, którego dotyczy harmonogram.

To pole jest wymagane w przypadku operacji CREATE i jest niedozwolone w przypadku operacji UPDATE.
startHour

integer

Godzina rozpoczęcia w ciągu 24 godzin. To pole musi mieścić się w zakresie od 0 do 23 włącznie.

To pole jest wymagane w przypadku operacji CREATE i jest niedozwolone w przypadku operacji UPDATE.
endHour

integer

Godzina końcowa w formacie 24-godzinnym; 24 oznacza koniec dnia. To pole musi mieścić się w zakresie od 0 do 24 włącznie.

To pole jest wymagane w przypadku operacji CREATE i jest niedozwolone w przypadku operacji UPDATE.

MinuteOfHour

Wylicza kwadrans. Na przykład: „FIFTEEN”.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Wartość jest nieznana w tej wersji.
ZERO 0 minut po godzinie.
FIFTEEN Piętnaście minut po godzinie.
THIRTY 30 minut po godzinie.
FORTY_FIVE 45 minut po godzinie.

DayOfWeek

Wymienia dni tygodnia, na przykład „Monday”.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Wartość jest nieznana w tej wersji.
MONDAY Poniedziałek.
TUESDAY Wtorek.
WEDNESDAY Środa.
THURSDAY Czwartek.
FRIDAY Piątek.
SATURDAY do soboty.
SUNDAY Niedziela.

UnifiedSitelinkAsset

Ujednolicony komponent z linkami do podstron.

Zapis JSON 
{
  "linkText": string,
  "description1": string,
  "description2": string,
  "startDate": string,
  "endDate": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ],
  "trackingId": string,
  "useSearcherTimeZone": boolean,
  "mobilePreferred": boolean
}
Pola
linkText

string

Wyświetlany tekst adresu URL linku do podstrony. Jego długość powinna mieścić się w przedziale od 1 do 25 włącznie.
description1

string

Pierwszy wiersz opisu linku do podstrony. Jeśli jest ustawiony, długość powinna mieścić się w przedziale od 1 do 35 włącznie i należy też ustawić opis2.
description2

string

Drugi wiersz opisu linku do podstrony. Jeśli jest ustawiony, długość powinna mieścić się w przedziale od 1 do 35 włącznie i należy też ustawić opis1.
startDate

string

Data rozpoczęcia wyświetlania zasobu w formacie rrrr-MM-dd.
endDate

string

Data ostatniej daty ważności tego komponentu i nadal jest wyświetlana. Czas jest w formacie rrrr-MM-dd.
adScheduleTargets[]

object (AdScheduleInfo)

Lista nienakładających się harmonogramów określająca wszystkie przedziały czasowe, w których zasób może się wyświetlać. Można ustawić maksymalnie 6 harmonogramów na dzień, a łącznie 42.
trackingId

string (int64 format)

Identyfikator używany do śledzenia kliknięć w komponencie z linkami do podstron. To jest konto Yahoo! Japan.
useSearcherTimeZone

boolean

Określa, czy komponent z linkami do podstron ma się wyświetlać w strefie czasowej użytkownika wyszukiwarki. Dotyczy Microsoft Ads.
mobilePreferred

boolean

Określa, czy komponent z linkami do podstron ma się wyświetlać na urządzeniach mobilnych. Dotyczy Microsoft Ads.

UnifiedPageFeedAsset

Ujednolicony zasób z plikami z adresami stron docelowych.

Zapis JSON 
{
  "pageUrl": string,
  "labels": [
    string
  ]
}
Pola
pageUrl

string

Strona internetowa, na którą chcą kierować reklamy reklamodawcy.
labels[]

string

Etykiety używane do grupowania adresów URL stron.

MobileAppAsset

Komponent reprezentujący aplikację mobilną.

Zapis JSON 
{
  "appId": string,
  "appStore": enum (MobileAppVendor)
}
Pola
appId

string

Wymagane. Ciąg znaków, który jednoznacznie identyfikuje aplikację mobilną. Powinien on zawierać tylko identyfikator natywny platformy, np. „com.android.ebay” w przypadku Androida lub „12345689” w przypadku iOS.
appStore

enum (MobileAppVendor)

Wymagane. Sklep z aplikacjami, który dystrybuuje tę konkretną aplikację.

MobileAppVendor

Typ dostawcy aplikacji mobilnej

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
APPLE_APP_STORE Dostawca aplikacji mobilnych dla sklepu Apple App Store.
GOOGLE_APP_STORE Dostawca aplikacji mobilnej dla sklepu z aplikacjami Google.

UnifiedCallAsset

Ujednolicony komponent do wykonywania połączeń.

Zapis JSON 
{
  "countryCode": string,
  "phoneNumber": string,
  "callConversionReportingState": enum (CallConversionReportingState),
  "callConversionAction": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ],
  "callOnly": boolean,
  "callTrackingEnabled": boolean,
  "useSearcherTimeZone": boolean,
  "startDate": string,
  "endDate": string
}
Pola
countryCode

string

Dwuliterowy kod kraju z numerem telefonu. Przykłady: „PL”, „pl”.
phoneNumber

string

Nieprzetworzony numer telefonu reklamodawcy. Przykłady: „1234567890”, „(123)456-7890”.
callConversionReportingState

enum (CallConversionReportingState)

Wskazuje, czy ten komponent do wykonywania połączeń powinien używać własnego ustawienia konwersji telefonicznych, przestrzegać ustawień na poziomie konta, czy wyłączyć konwersje telefoniczne.
callConversionAction

string

Działanie powodujące konwersję, do którego przypisać konwersję telefoniczną. Jeśli zasada nie jest skonfigurowana, używane jest domyślne działanie powodujące konwersję. To pole ma zastosowanie tylko wtedy, gdy parametr callConversionReportingState ma wartość USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION.
adScheduleTargets[]

object (AdScheduleInfo)

Lista nienakładających się harmonogramów określająca wszystkie przedziały czasowe, w których zasób może się wyświetlać. Można ustawić maksymalnie 6 harmonogramów na dzień, a łącznie 42.
callOnly

boolean

Wskazuje, czy w połączeniu wyświetli się tylko numer telefonu bez linku do witryny. Dotyczy Microsoft Ads.
callTrackingEnabled

boolean

Określa, czy połączenie ma być włączone przy śledzeniu połączeń. Dotyczy Microsoft Ads.
useSearcherTimeZone

boolean

Określa, czy rozszerzenie połączeń ma być wyświetlane w strefie czasowej użytkownika wyszukiwarki. Dotyczy Microsoft Ads.
startDate

string

Data rozpoczęcia wyświetlania zasobu w formacie rrrr-MM-dd.
endDate

string

Data ostatniej daty ważności tego komponentu i nadal jest wyświetlana. Czas jest w formacie rrrr-MM-dd.

CallConversionReportingState

Możliwe typy danych dla stanu działania powodującego konwersję telefoniczną.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
DISABLED Działanie powodujące konwersję telefoniczną jest wyłączone.
USE_ACCOUNT_LEVEL_CALL_CONVERSION_ACTION Działanie powodujące konwersję telefoniczną będzie korzystać z typu konwersji telefonicznej ustawionego na poziomie konta.
USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION Działanie powodujące konwersję telefoniczną będzie korzystać z typu konwersji telefonicznej określonego na poziomie zasobu (reklamy typu „tylko połączenie” lub rozszerzenia połączeń).

CallToActionAsset

Komponent z wezwaniem do działania.

Zapis JSON 
{
  "callToAction": enum (CallToActionType)
}
Pola
callToAction

enum (CallToActionType)

Wezwanie do działania.

CallToActionType

Wartość Enum opisująca możliwe typy wezwań do działania.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
LEARN_MORE Typ wezwania do działania to „więcej informacji”.
GET_QUOTE Rodzaj wezwania do działania to „uzyskaj wycenę”.
APPLY_NOW Typ wezwania do działania ma zastosowanie.
SIGN_UP Typ wezwania do działania to „rejestracja”.
CONTACT_US Wezwanie do działania to „Skontaktuj się z nami”.
SUBSCRIBE Typ wezwania do działania to „Subskrybuj”.
DOWNLOAD Rodzaj wezwania do działania to „pobieranie”.
BOOK_NOW Typ wezwania do działania to Zarezerwuj teraz.
SHOP_NOW Typ wezwania do działania to „kup teraz”.
BUY_NOW Typ wezwania do działania to kup teraz.
DONATE_NOW Typ wezwania do działania to „Przekaż darowiznę”.
ORDER_NOW Typ wezwania do działania to zamówienie teraz.
PLAY_NOW Typ wezwania do działania to Odtwórz teraz.
SEE_MORE Typ wezwania do działania: zobacz więcej.
START_NOW Typ wezwania do działania jest teraz uruchamiany.
VISIT_SITE Typ wezwania do działania to wizyta w witrynie.
WATCH_NOW Typ wezwania do działania to „obejrzyj teraz”.

UnifiedLocationAsset

Ujednolicony komponent z lokalizacją.

Zapis JSON 
{
  "placeId": string,
  "businessProfileLocations": [
    {
      object (BusinessProfileLocation)
    }
  ],
  "locationOwnershipType": enum (LocationOwnershipType)
}
Pola
placeId

string

Identyfikatory miejsc jednoznacznie identyfikują dane miejsce w bazie danych Miejsc Google i w Mapach Google. To pole jest unikalne dla danego identyfikatora klienta i typu zasobu. Więcej informacji o identyfikatorze miejsca znajdziesz na stronie https://developers.google.com/places/web-service/place-id.
businessProfileLocations[]

object (BusinessProfileLocation)

Lista lokalizacji firmy klienta. Ta wartość będzie zwracana tylko wtedy, gdy komponent z lokalizacją jest synchronizowany z kontem w Profilu Firmy. Na tym samym koncie może być wiele wizytówek w Profilu Firmy i mających ten sam identyfikator miejsca.
locationOwnershipType

enum (LocationOwnershipType)

Typ własności lokalizacji. Jeśli typ to BUSINESS_OWNER, będzie wyświetlany jako rozszerzenie lokalizacji. Jeśli typ to Powiązana lokalizacja, będzie ona wyświetlana jako powiązana lokalizacja.

BusinessProfileLocation

Dane o lokalizacji profilu firmy są synchronizowane z połączonego konta w usłudze Profil Firmy.

Zapis JSON 
{
  "labels": [
    string
  ],
  "storeCode": string,
  "listingId": string
}
Pola
labels[]

string

Reklamodawca określił etykietę lokalizacji na koncie w Profilu Firmy. Te informacje są synchronizowane z konta w Profilu Firmy.
storeCode

string

Kod sklepu w Profilu Firmy dla tej lokalizacji. Te informacje są synchronizowane z konta w Profilu Firmy.
listingId

string (int64 format)

Identyfikator wizytówki w tej lokalizacji w Profilu Firmy. Te dane są synchronizowane z połączonego konta w usłudze Profil Firmy.

LocationOwnershipType

Możliwe rodzaje własności lokalizacji.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
BUSINESS_OWNER Właściciel firmy z lokalizacją(starsze rozszerzenie lokalizacji – LE).
AFFILIATE Powiązana lokalizacja(rozszerzenie lokalizacji firmy zewnętrznej – ALE).

AssetGroupAsset

AssetGroupAsset to połączenie między zasobem a grupą komponentów. Dodanie komponentu AssetGroupAsset powoduje połączenie zasobu z grupą komponentów.

Zapis JSON 
{
  "resourceName": string,
  "assetGroup": string,
  "asset": string,
  "fieldType": enum (AssetFieldType),
  "status": enum (AssetLinkStatus)
}
Pola
resourceName

string

Nazwa zasobu grupy plików. Nazwa zasobu w grupie plików ma postać:

customers/{customerId}/assetGroupAssets/{asset_group_id}~{assetId}~{fieldType}
assetGroup

string

Grupa plików, którą łączy ten komponent z grupą plików.
asset

string

Komponent, który łączy ten komponent grupy plików.
fieldType

enum (AssetFieldType)

Opis miejsca docelowego zasobu w grupie plików. Na przykład: HEADLINE, YOUTUBE_VIDEO itp.
status

enum (AssetLinkStatus)

Stan połączenia komponentu z grupą komponentów.

AssetFieldType

Wartość Enum opisująca możliwe miejsca docelowe zasobu.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
HEADLINE Komponent jest połączony i można go używać jako nagłówka.
DESCRIPTION Zasób jest połączony i można go używać jako tekstu reklamy.
MANDATORY_AD_TEXT Ten komponent jest połączony i można go używać jako obowiązkowego tekstu reklamy.
MARKETING_IMAGE Ten komponent jest połączony i można go używać jako obrazu marketingowego.
MEDIA_BUNDLE Zasób jest połączony i można go używać jako pakietu kreacji multimedialnych.
YOUTUBE_VIDEO Zasób jest połączony i można go używać jako filmu w YouTube.
BOOK_ON_GOOGLE Komponent jest połączony, aby wskazać, że kampania reklam hoteli ma włączoną opcję „Zarezerwuj z Google”.
LEAD_FORM Ten komponent jest połączony i można go używać jako rozszerzenia formularza kontaktowego.
PROMOTION Ten komponent jest połączony i można go używać jako rozszerzenia promocji.
CALLOUT Ten komponent jest połączony i można go używać jako rozszerzenia objaśnień.
STRUCTURED_SNIPPET Komponent jest połączony i można go używać jako rozszerzenia informacji w witrynie.
MOBILE_APP Komponent jest połączony i można go używać jako rozszerzenia aplikacji mobilnej.
HOTEL_CALLOUT Ten komponent jest połączony i może służyć jako rozszerzenie objaśnień dotyczących hoteli.
CALL Ten komponent jest połączony i można go używać jako rozszerzenia połączeń.
PRICE Ten komponent jest połączony i można go używać jako rozszerzenia cen.
LONG_HEADLINE Komponent jest połączony i można go używać jako długiego nagłówka.
BUSINESS_NAME Komponent został połączony i może służyć jako nazwa firmy.
SQUARE_MARKETING_IMAGE Ten komponent jest połączony i można go używać jako kwadratowego obrazu marketingowego.
PORTRAIT_MARKETING_IMAGE Ten komponent jest połączony i można go używać jako pionowego obrazu marketingowego.
VIDEO Zasób jest połączony, aby można było używać go jako logo innego niż YouTube.
CALL_TO_ACTION_SELECTION Komponent jest połączony i służy do wyboru wezwania do działania.
AD_IMAGE Komponent jest połączony i służy do wyboru obrazu reklamy.
HOTEL_PROPERTY Komponent jest połączony i może służyć jako obiekt hotelowy w kampanii Performance Max do celów związanych z podróżami.

AssetGroupSignal

AssetGroupSignal reprezentuje sygnał w grupie komponentów. Taki sygnał wskazuje kampanię Performance Max, która z największym prawdopodobieństwem dokona konwersji. Kampania Performance Max używa tego sygnału, aby znaleźć nowych użytkowników o podobnych lub silniejszych zamiarach i uzyskać więcej konwersji w sieci wyszukiwania, sieci reklamowej, sieci wideo oraz innych usługach.

Zapis JSON 
{
  "resourceName": string,
  "assetGroup": string,

  // Union field signal can be only one of the following:
  "audience": {
    object (AudienceInfo)
  }
  // End of list of possible types for union field signal.
}
Pola
resourceName

string

Nazwa zasobu sygnału grupy plików. Nazwa zasobu sygnału grupy plików ma postać:

customers/{customerId}/assetGroupSignals/{asset_group_id}~{signal_id}
assetGroup

string

Grupa plików, do której należy ten sygnał grupy plików.
Pole sumy signal. Sygnał grupy plików. signal może być tylko jedną z tych wartości:
audience

object (AudienceInfo)

Sygnał dotyczący odbiorców, który ma być używany w kampanii Performance Max.

AudienceInfo

Kryterium odbiorców.

Zapis JSON 
{
  "audience": string
}
Pola
audience

string

Nazwa zasobu dotyczącego odbiorców.

AssetGroupListingGroupFilter

AssetGroupListingGroupFilter reprezentuje węzeł drzewa filtra grupy informacji o produktach w grupie zasobów.

Zapis JSON 
{
  "resourceName": string,
  "assetGroup": string,
  "id": string,
  "type": enum (ListingGroupFilterType),
  "vertical": enum (ListingGroupFilterVertical),
  "caseValue": {
    object (ListingGroupFilterDimension)
  },
  "parentListingGroupFilter": string,
  "path": {
    object (ListingGroupFilterDimensionPath)
  }
}
Pola
resourceName

string

Nazwa zasobu filtra grupy informacji o produktach w grupie plików. Nazwa zasobu filtra grupy informacji o produktach w grupie plików ma postać:

customers/{customerId}/assetGroupListingGroupFilters/{asset_group_id}~{listing_group_filter_id}
assetGroup

string

Grupa plików, do której należy ten filtr grupy informacji o produktach w grupie plików.
id

string (int64 format)

Identyfikator elementu ListingGroupFilter.
type

enum (ListingGroupFilterType)

Typ węzła filtra grupy informacji o produktach.
vertical

enum (ListingGroupFilterVertical)

Branża, którą reprezentuje bieżące drzewo węzłów. Wszystkie węzły w tym samym drzewie muszą należeć do tej samej branży.
caseValue

object (ListingGroupFilterDimension)

Wartość wymiaru, za pomocą której ta grupa informacji o produktach ulepsza element nadrzędny. Nie zdefiniowano w grupie głównej.
parentListingGroupFilter

string

Nazwa zasobu w nadrzędnej grupie informacji o produktach. Wartość null dla głównego węzła filtra grupy informacji o produktach.
path

object (ListingGroupFilterDimensionPath)

Ścieżka wymiarów definiujących ten filtr grupy informacji o produktach.

ListingGroupFilterType

Typ filtra grupy informacji o produktach.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
SUBDIVISION Podział produktów według niektórych wymiarów strony.
UNIT_INCLUDED Dołączony węzeł liścia filtra grupy informacji o produktach.
UNIT_EXCLUDED Wykluczony węzeł liścia filtra grupy informacji o produktach.

ListingGroupFilterVertical

Typ branży filtra grupy informacji o produktach.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
SHOPPING Reprezentuje branżę zakupów. Ta branża jest dozwolona tylko w kampaniach detalicznych Performance Max.

ListingGroupFilterDimension

Wymiary informacji o produktach w ramach filtra grupy informacji o produktach w grupie plików.

Zapis JSON 
{

  // Union field dimension can be only one of the following:
  "productBiddingCategory": {
    object (ProductBiddingCategory)
  },
  "productBrand": {
    object (ProductBrand)
  },
  "productChannel": {
    object (ProductChannel)
  },
  "productCondition": {
    object (ProductCondition)
  },
  "productCustomAttribute": {
    object (ProductCustomAttribute)
  },
  "productItemId": {
    object (ProductItemId)
  },
  "productType": {
    object (ProductType)
  }
  // End of list of possible types for union field dimension.
}
Pola
Pole sumy dimension. Wymiar jednego z poniższych typów zawsze jest obecny. dimension może być tylko jedną z tych wartości:
productBiddingCategory

object (ProductBiddingCategory)

Kategoria określania stawek oferty produktu.
productBrand

object (ProductBrand)

Marka oferty produktu.
productChannel

object (ProductChannel)

Lokalizacja oferty produktu.
productCondition

object (ProductCondition)

Stan oferty produktu.
productCustomAttribute

object (ProductCustomAttribute)

Atrybut niestandardowy oferty produktu.
productItemId

object (ProductItemId)

Identyfikator produktu w ofercie.
productType

object (ProductType)

Typ oferty produktu.

ProductBiddingCategory

Jeden z elementów kategorii ustalania stawek na określonym poziomie. Kategorie najwyższego poziomu to poziom 1, dzieci na poziomie 2 itd. Obecnie obsługujemy do 5 poziomów. Użytkownik musi określić typ wymiaru, który wskazuje poziom kategorii. Wszystkie przypadki w ramach tego samego podziału muszą mieć ten sam typ wymiaru (na poziomie kategorii).

Zapis JSON 
{
  "level": enum (ListingGroupFilterBiddingCategoryLevel),
  "id": string
}
Pola
level

enum (ListingGroupFilterBiddingCategoryLevel)

Wskazuje poziom kategorii w taksonomii.
id

string (int64 format)

Identyfikator kategorii ustalania stawek dla produktu.

Jest on odpowiednikiem identyfikatora google_product_category [kategoria_produktów_Google] zgodnie z opisem w tym artykule: https://support.google.com/merchants/answer/6324436.

ListingGroupFilterBiddingCategoryLevel

Poziom kategorii ustalania stawek w grupie informacji o produktach.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
LEVEL1 Poziom 1.
LEVEL2 Poziom 2.
LEVEL3 Poziom 3.
LEVEL4 Poziom 4.
LEVEL5 Poziom 5.

ProductBrand

Marka produktu.

Zapis JSON 
{
  "value": string
}
Pola
value

string

Wartość ciągu znaków marki produktu.

ProductChannel

Lokalizacja oferty produktu.

Zapis JSON 
{
  "channel": enum (ListingGroupFilterProductChannel)
}
Pola
channel

enum (ListingGroupFilterProductChannel)

Wartość lokalizacji.

ListingGroupFilterProductChannel

Wartość Enum opisująca miejscowość oferty produktu.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
ONLINE Produkt jest sprzedawany online.
LOCAL Produkt jest sprzedawany w lokalnych sklepach.

ProductCondition

Stan oferty produktu.

Zapis JSON 
{
  "condition": enum (ListingGroupFilterProductCondition)
}
Pola
condition

enum (ListingGroupFilterProductCondition)

Wartość warunku.

ListingGroupFilterProductCondition

Wyliczenie opisujące stan oferty produktu.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
NEW Stan produktu jest nowy.
REFURBISHED Stan produktu jest odnowiony.
USED Stan produktu jest używany.

ProductCustomAttribute

Atrybut niestandardowy oferty produktu.

Zapis JSON 
{
  "index": enum (ListingGroupFilterCustomAttributeIndex),
  "value": string
}
Pola
index

enum (ListingGroupFilterCustomAttributeIndex)

Wskazuje indeks atrybutu niestandardowego.
value

string

Wartość ciągu znaków niestandardowego atrybutu produktu.

ListingGroupFilterCustomAttributeIndex

Indeks atrybutów klienta.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
INDEX0 Atrybut niestandardowy filtra pierwszej grupy informacji o produktach.
INDEX1 Drugi atrybut niestandardowy filtra grupy informacji o produktach.
INDEX2 Atrybut niestandardowy filtra grupy informacji o produktach.
INDEX3 Czwarta grupa informacji o produktach – atrybut niestandardowy filtra grupy informacji o produktach.
INDEX4 Atrybut niestandardowy filtra piątej grupy informacji o produktach.

ProductItemId

Identyfikator produktu w ofercie.

Zapis JSON 
{
  "value": string
}
Pola
value

string

Wartość identyfikatora.

ProductType

Typ oferty produktu.

Zapis JSON 
{
  "level": enum (ListingGroupFilterProductTypeLevel),
  "value": string
}
Pola
level

enum (ListingGroupFilterProductTypeLevel)

Poziom typu.
value

string

Wartość typu.

ListingGroupFilterProductTypeLevel

Wyliczenie opisujące poziom typu oferty produktu.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
LEVEL1 Poziom 1.
LEVEL2 Poziom 2.
LEVEL3 Poziom 3.
LEVEL4 Poziom 4.
LEVEL5 Poziom 5.

ListingGroupFilterDimensionPath

Ścieżka definiująca wymiary definiujące filtr grupy informacji o produktach.

Zapis JSON 
{
  "dimensions": [
    {
      object (ListingGroupFilterDimension)
    }
  ]
}
Pola
dimensions[]

object (ListingGroupFilterDimension)

Pełna ścieżka wymiarów w hierarchii filtrów grup informacji o produktach (z wyłączeniem węzła głównego) do tego filtra grupy informacji o produktach.

AssetGroupTopCombinationView

Widok wykorzystania kombinacji komponentów reklamy w grupie reklam.

Zapis JSON 
{
  "resourceName": string,
  "assetGroupTopCombinations": [
    {
      object (AssetGroupAssetCombinationData)
    }
  ]
}
Pola
resourceName

string

Nazwa zasobu grupy plików w widoku najpopularniejszych kombinacji. Nazwy zasobów widoku danych najważniejszych kombinacji zasobów mają postać: `"customers/{customerId}/assetGroupTopCombinationViews/{identyfikator_grupy_zasobów}~{asset_combination_category}"
assetGroupTopCombinations[]

object (AssetGroupAssetCombinationData)

Najpopularniejsze kombinacje komponentów, które wyświetlały się razem.

AssetGroupAssetCombinationData

Grupa plików – dane kombinacji komponentów

Zapis JSON 
{
  "assetCombinationServedAssets": [
    {
      object (AssetUsage)
    }
  ]
}
Pola
assetCombinationServedAssets[]

object (AssetUsage)

Wyświetlane komponenty.

AssetUsage

Zawiera informacje o wykorzystaniu zasobu.

Zapis JSON 
{
  "asset": string,
  "servedAssetFieldType": enum (ServedAssetFieldType)
}
Pola
asset

string

Nazwa zasobu.
servedAssetFieldType

enum (ServedAssetFieldType)

Typ wyświetlanego pola zasobu.

ServedAssetFieldType

Możliwe typy pól zasobu.

Wartości w polu enum
UNSPECIFIED Nie określono wartości.
UNKNOWN

Otrzymana wartość nie jest znana w tej wersji.

To jest wartość tylko z odpowiedzią.
HEADLINE_1 Komponent jest używany w nagłówku 1.
HEADLINE_2 Komponent jest używany w nagłówku 2.
HEADLINE_3 Komponent jest używany w nagłówku 3.
DESCRIPTION_1 Zasób jest używany w tekście reklamy 1.
DESCRIPTION_2 Zasób jest używany w tekście reklamy 2.
HEADLINE Komponent został użyty w nagłówku. Używaj jej tylko wtedy, gdy reklama ma tylko 1 nagłówek. W przeciwnym razie użyj wyliczeń HEADLINE_1, HEADLINE_2 lub HEADLINE_3
HEADLINE_IN_PORTRAIT Komponent był używany jako nagłówek w obrazie pionowym.
LONG_HEADLINE Komponent został użyty w długim nagłówku (w reklamie MultiAssetelastycznie).
DESCRIPTION Zasób został użyty w tekście reklamy. Używaj jej tylko wtedy, gdy w reklamie jest tylko 1 tekst reklamy. W przeciwnym razie użyj wyliczeń DESCRIPTION_1 lub DESCRIPTION_@
DESCRIPTION_IN_PORTRAIT Komponent został użyty jako tekst reklamy w orientacji pionowej.
BUSINESS_NAME_IN_PORTRAIT Komponent został użyty jako nazwa firmy w obrazie pionowym.
BUSINESS_NAME Komponent służył jako nazwa firmy.
MARKETING_IMAGE Komponent został użyty jako obraz marketingowy.
MARKETING_IMAGE_IN_PORTRAIT Komponent został użyty jako obraz marketingowy w orientacji pionowej.
SQUARE_MARKETING_IMAGE Komponent został użyty jako kwadratowy obraz marketingowy.
PORTRAIT_MARKETING_IMAGE Komponent został użyty jako pionowy obraz marketingowy.
CALL_TO_ACTION Komponent został użyty jako wezwanie do działania.
YOU_TUBE_VIDEO Zasób był używany jako film w YouTube.
CALL Ten komponent jest używany jako połączenie.
MOBILE_APP Ten komponent jest używany jako aplikacja mobilna.
CALLOUT Ten komponent jest używany jako objaśnienie.
STRUCTURED_SNIPPET Ten komponent jest używany jako rozszerzenie informacji.
PRICE Ten komponent jest używany jako cena.
PROMOTION Ten komponent jest używany jako promocja.
AD_IMAGE Ten komponent jest używany jako obraz.
LEAD_FORM Komponent jest używany jako formularz kontaktowy.

AssetGroup

Grupa komponentów. AssetGroupAsset służy do łączenia zasobu z grupą komponentów. AssetGroupSignal służy do powiązania sygnału z grupą komponentów.

Zapis JSON 
{
  "resourceName": string,
  "id": string,
  "campaign": string,
  "name": string,
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "status": enum (AssetGroupStatus),
  "path1": string,
  "path2": string,
  "adStrength": enum (AdStrength)
}
Pola
resourceName

string

Nazwa zasobu grupy zasobów. Nazwy zasobów grupy plików mają postać:

customers/{customerId}/assetGroups/{asset_group_id}
id

string (int64 format)

Identyfikator grupy plików.
campaign

string

Kampania, z którą ta grupa plików jest powiązana. Komponent połączony z grupą plików.
name

string

Wymagane. Nazwa grupy plików. Wymagane. Musi mieć minimalną długość 1 i maksymalną 128 znaków. Musi być niepowtarzalna w ramach kampanii.
finalUrls[]

string

Lista końcowych adresów URL po wszystkich przekierowaniach między domenami. Domyślnie w kampanii Performance Max adresy URL mogą się rozwijać, chyba że z tego zrezygnujesz.
finalMobileUrls[]

string

Lista końcowych mobilnych adresów URL po wszystkich przekierowaniach między domenami. Domyślnie w kampanii Performance Max adresy URL mogą się rozwijać, chyba że z tego zrezygnujesz.
status

enum (AssetGroupStatus)

Stan grupy plików.
path1

string

Pierwsza część tekstu, który może się pojawić jako dołączony do adresu URL wyświetlanego w reklamie.
path2

string

Druga część tekstu, która może się pojawić jako dołączony do adresu URL wyświetlanego w reklamie. To pole można skonfigurować tylko wtedy, gdy ustawiona jest ścieżka 1.
adStrength

enum (AdStrength)

Ogólna skuteczność reklamy w tej grupie plików.

AssetGroupStatus

Możliwe stany grupy plików.

Wartości w polu enum
UNSPECIFIED Stan nie został określony.
UNKNOWN Otrzymana wartość nie jest znana w tej wersji.
ENABLED Grupa plików jest włączona.
PAUSED Grupa plików jest wstrzymana.
REMOVED Grupa plików została usunięta.

AdStrength

Wymienić możliwe skuteczność reklamy.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
PENDING Skuteczność reklamy jest obecnie oczekująca.
NO_ADS Nie udało się wygenerować reklam.
POOR Słaba siła.
AVERAGE Średnia siła.
GOOD Dobra siła.
EXCELLENT Doskonała siła.

AssetSetAsset

AssetSetAsset to połączenie między zasobem a zestawem zasobów. Dodanie komponentu AssetSetAsset powoduje połączenie zasobu z zestawem zasobów.

Zapis JSON 
{
  "resourceName": string,
  "assetSet": string,
  "asset": string,
  "status": enum (AssetSetAssetStatus)
}
Pola
resourceName

string

Nazwa zasobu zestawu zasobów. Nazwy zasobów zestawu zasobów mają postać:

customers/{customerId}/assetSetAssets/{asset_set_id}~{assetId}
assetSet

string

Zestaw komponentów, z którym jest połączony ten zestaw.
asset

string

Zasób, z którym jest połączony ten zestaw zasobów.
status

enum (AssetSetAssetStatus)

Stan zasobu zestawu komponentów. Tylko do odczytu.

AssetSetAssetStatus

Możliwe stany komponentu w zestawie komponentów.

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 Komponent w zestawie jest włączony.
REMOVED Komponent z zestawu komponentów został usunięty.

AssetSet

Zbiór zasobów reprezentujący zbiór zasobów. Użyj AssetSetAsset, aby połączyć zasób z zestawem zasobów.

Zapis JSON 
{
  "id": string,
  "resourceName": string
}
Pola
id

string (int64 format)

Identyfikator zestawu zasobów.
resourceName

string

Nazwa zasobu zestawu zasobów. Nazwy zasobów zestawu zasobów mają postać:

customers/{customerId}/assetSets/{asset_set_id}

BiddingStrategy

Strategia ustalania stawek.

Zapis JSON 
{
  "resourceName": string,
  "status": enum (BiddingStrategyStatus),
  "type": enum (BiddingStrategyType),
  "currencyCode": string,
  "id": string,
  "name": string,
  "effectiveCurrencyCode": string,
  "campaignCount": string,
  "nonRemovedCampaignCount": string,

  // Union field scheme can be only one of the following:
  "enhancedCpc": {
    object (EnhancedCpc)
  },
  "maximizeConversionValue": {
    object (MaximizeConversionValue)
  },
  "maximizeConversions": {
    object (MaximizeConversions)
  },
  "targetCpa": {
    object (TargetCpa)
  },
  "targetImpressionShare": {
    object (TargetImpressionShare)
  },
  "targetOutrankShare": {
    object (TargetOutrankShare)
  },
  "targetRoas": {
    object (TargetRoas)
  },
  "targetSpend": {
    object (TargetSpend)
  }
  // End of list of possible types for union field scheme.
}
Pola
resourceName

string

Nazwa zasobu strategii ustalania stawek. Nazwy zasobów strategii ustalania stawek mają postać:

customers/{customerId}/biddingStrategies/{bidding_strategy_id}
status

enum (BiddingStrategyStatus)

Stan strategii ustalania stawek.

To pole jest tylko do odczytu.
type

enum (BiddingStrategyType)

Typ strategii ustalania stawek. Utwórz strategię ustalania stawek, ustawiając schemat ustalania stawek.

To pole jest tylko do odczytu.
currencyCode

string

Waluta używana przez strategię ustalania stawek (trzyliterowy kod ISO 4217).

W przypadku strategii ustalania stawek na kontach klientów menedżera tę walutę można ustawić podczas tworzenia konta i domyślnie przyjmuje się walutę klienta menedżera. Tego pola nie można ustawić w przypadku obsługi klientów. Wszystkie strategie obsługiwanego klienta domyślnie korzystają z waluty tego klienta. We wszystkich przypadkach pole „effectiveCurrencyCode” zwraca walutę używaną przez strategię.
id

string (int64 format)

Identyfikator strategii ustalania stawek.
name

string

Nazwa strategii ustalania stawek. Wszystkie strategie ustalania stawek na koncie muszą mieć osobne nazwy.

Powinien on mieć długość od 1 do 255 bajtów w formacie UTF-8 (z przycięciem).
effectiveCurrencyCode

string

Waluta używana przez strategię ustalania stawek (trzyliterowy kod ISO 4217).

W przypadku strategii ustalania stawek dostępnych na kontach klientów menedżera jest to waluta ustawiona przez reklamodawcę podczas tworzenia strategii. W przypadku obsługi klientów jest to kod waluty klienta.

Dane strategii ustalania stawek są raportowane w tej walucie.

To pole jest tylko do odczytu.
campaignCount

string (int64 format)

Liczba kampanii powiązanych z tą strategią ustalania stawek.

To pole jest tylko do odczytu.
nonRemovedCampaignCount

string (int64 format)

Liczba nieusuniętych kampanii powiązanych z tą strategią ustalania stawek.

To pole jest tylko do odczytu.

Pole sumy scheme. Schemat określania stawek.

Można ustawić tylko jedną opcję. scheme może być tylko jedną z tych wartości:
enhancedCpc

object (EnhancedCpc)

Strategia ustalania stawek, która podnosi stawki za kliknięcia, w przypadku których prawdopodobieństwo konwersji jest większe, i obniża je pod kątem kliknięć, w przypadku których prawdopodobieństwo jest mniejsze.
maximizeConversionValue

object (MaximizeConversionValue)

Strategia automatycznego określania stawek, która pomoże Ci uzyskać jak największą wartość konwersji dla Twoich kampanii w ramach określonego budżetu.
maximizeConversions

object (MaximizeConversions)

Strategia automatycznego określania stawek, która pomoże Ci uzyskać jak najwięcej konwersji dla Twoich kampanii w ramach określonego budżetu.
targetCpa

object (TargetCpa)

Strategia ustalania stawek, która ustala stawki w taki sposób, by pomóc Ci uzyskać jak największą liczbę konwersji przy wybranym przez Ciebie docelowym koszcie pozyskania (CPA).
targetImpressionShare

object (TargetImpressionShare)

Strategia ustalania stawek, która automatycznie optymalizuje stawki pod kątem określonego odsetka wyświetleń.
targetOutrankShare

object (TargetOutrankShare)

Strategia ustalania stawek polegająca na określaniu stawek na podstawie docelowego odsetka aukcji, w których reklamodawca powinien przelicytować danego konkurenta. To pole zostało wycofane. Nie uda się utworzyć nowej strategii ustalania stawek z użyciem tego pola lub dołączyć strategie ustalania stawek z tym polem do kampanii. Mutacje do strategii, które mają już wypełnione ten schemat, są dozwolone.
targetRoas

object (TargetRoas)

Strategia ustalania stawek, która pomaga zmaksymalizować przychody przy średnim docelowym zwrocie z nakładów na reklamę (ROAS).
targetSpend

object (TargetSpend)

Strategia ustalania stawek, która ustala stawki w taki sposób, by pomóc Ci uzyskać jak najwięcej kliknięć w ramach budżetu.

BiddingStrategyStatus

Możliwe stany strategii ustalania stawek.

Wartości w polu enum
UNSPECIFIED Nie określono wartości.
UNKNOWN

Otrzymana wartość nie jest znana w tej wersji.

To jest wartość tylko z odpowiedzią.
ENABLED Strategia ustalania stawek jest włączona.
REMOVED Strategia ustalania stawek została usunięta.

BiddingStrategyType

Wyliczenie opisujące możliwe typy strategii ustalania stawek.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
COMMISSION Prowizja to strategia automatycznego określania stawek, w której reklamodawca płaci pewną część wartości konwersji.
ENHANCED_CPC Ulepszony CPC to strategia ustalania stawek, która podnosi stawki za kliknięcia, w przypadku których prawdopodobieństwo konwersji jest większe, i obniża je tam, gdzie są mniej prawdopodobne.
INVALID Używana tylko w przypadku wartości zwracanej. Oznacza, że kampania nie ma strategii ustalania stawek. Uniemożliwia to wyświetlanie reklam z kampanii. Kampania może być np. powiązana ze strategią ustalania stawek menedżera, a konto wyświetlania reklam zostanie odłączone od konta menedżera. W takim przypadku kampania zostanie automatycznie odłączona od strategii ustalania stawek, która jest obecnie niedostępna na koncie menedżera, i przejdzie na NIEPRAWIDŁOWY typ strategii ustalania stawek.
MANUAL_CPA Strategia samodzielnego ustawiania stawek, która pozwala reklamodawcy ustawić stawkę za działanie określone przez reklamodawcę.
MANUAL_CPC Samodzielne określanie stawek na podstawie kliknięć, w którym użytkownik płaci za kliknięcie.
MANUAL_CPM Samodzielne określanie stawek na podstawie wyświetleń, w którym użytkownik płaci za tysiąc wyświetleń.
MANUAL_CPV Strategia ustalania stawek, w której za wyświetlenie filmu można ustawić określoną kwotę.
MAXIMIZE_CONVERSIONS Strategia ustalania stawek, która automatycznie maksymalizuje liczbę konwersji przy danym budżecie dziennym.
MAXIMIZE_CONVERSION_VALUE Strategia automatycznego określania stawek, która automatycznie ustala stawki tak, aby zmaksymalizować przychody w ramach określonego budżetu.
PAGE_ONE_PROMOTED Schemat ustalania stawek za promocję na pierwszej stronie, który ustawia maksymalne stawki CPC pod kątem kierowania na wyświetlenia na pierwszej stronie lub na pierwszej stronie promowanych boksów w witrynie google.com. Ta wartość wyliczenia została wycofana.
PERCENT_CPC Procent CPC to strategia ustalania stawek, w której stawki są ułamkiem reklamowanej ceny za dany towar lub usługę.
TARGET_CPA Docelowy CPA to strategia automatycznego określania stawek, która ustala stawki, by pomóc Ci uzyskać jak największą liczbę konwersji przy wybranym przez Ciebie docelowym koszcie pozyskania (CPA).
TARGET_CPM Docelowy CPM to strategia automatycznego określania stawek, która ustala stawki w taki sposób, by pomóc Ci uzyskać jak największą liczbę wyświetleń przy wybranym przez Ciebie docelowym koszcie tysiąca wyświetleń (CPM).
TARGET_IMPRESSION_SHARE Strategia automatycznego określania stawek, która ustala stawki tak, aby określony odsetek reklam w wyszukiwarce wyświetlał się u góry pierwszej strony (lub w innej wybranej lokalizacji).
TARGET_OUTRANK_SHARE Docelowy udział w wygranych aukcjach to strategia automatycznego określania stawek, która ustala stawki na podstawie docelowego odsetka aukcji, w których reklamodawca powinien przelicytować określonego konkurenta. Ta wartość wyliczenia została wycofana.
TARGET_ROAS Docelowy ROAS to strategia automatycznego określania stawek, która pomaga zmaksymalizować przychody przy średnim docelowym zwrocie z nakładów na reklamę (ROAS).
TARGET_SPEND Docelowe wydatki to strategia automatycznego określania stawek, która ustala stawki w taki sposób, by zapewniać jak najwięcej kliknięć w ramach ustalonego budżetu.

EnhancedCpc

Ten typ nie ma żadnych pól.

Strategia automatycznego określania stawek, która podnosi stawki za kliknięcia, w przypadku których prawdopodobieństwo konwersji jest większe, i obniża je pod kątem kliknięć, w przypadku których prawdopodobieństwo jest mniejsze.

Ta strategia ustalania stawek została wycofana i nie można jej już utworzyć. Aby uzyskać równoważną funkcjonalność, użyj zasady ManualCpc z parametrem EnhancedCpcEnabled ustawionym na wartość true.

MaximizeConversionValue

Strategia automatycznego określania stawek, która pomoże Ci uzyskać jak największą wartość konwersji dla Twoich kampanii w ramach określonego budżetu.

Zapis JSON 
{
  "cpcBidCeilingMicros": string,
  "cpcBidFloorMicros": string,
  "targetRoas": number
}
Pola
cpcBidCeilingMicros

string (int64 format)

Maksymalna stawka, jaką może ustawić strategia ustalania stawek. Limit dotyczy wszystkich słów kluczowych zarządzanych przez strategię. Zmienne tylko w przypadku strategii portfolio ustalania stawek.
cpcBidFloorMicros

string (int64 format)

Limit minimalnej stawki, który może ustawić strategia ustalania stawek. Limit dotyczy wszystkich słów kluczowych zarządzanych przez strategię. Zmienne tylko w przypadku strategii portfolio ustalania stawek.
targetRoas

number

Opcja docelowego zwrotu z nakładów na reklamę (ROAS). Jeśli go skonfigurujesz, strategia ustalania stawek zmaksymalizuje przychody, zachowując przy tym średni docelowy zwrot z nakładów na reklamę. Jeśli docelowy ROAS jest wysoki, strategia ustalania stawek może nie wydać całego budżetu. Jeśli docelowy ROAS nie jest ustawiony, strategia ustalania stawek dąży do osiągnięcia najwyższego możliwego ROAS w ramach budżetu.

MaximizeConversions

Strategia automatycznego określania stawek, która pomoże Ci uzyskać jak najwięcej konwersji dla Twoich kampanii w ramach określonego budżetu.

Zapis JSON 
{
  "cpcBidCeilingMicros": string,
  "cpcBidFloorMicros": string,
  "targetCpaMicros": string
}
Pola
cpcBidCeilingMicros

string (int64 format)

Maksymalna stawka, jaką może ustawić strategia ustalania stawek. Limit dotyczy wszystkich słów kluczowych zarządzanych przez strategię. Zmienne tylko w przypadku strategii portfolio ustalania stawek.
cpcBidFloorMicros

string (int64 format)

Limit minimalnej stawki, który może ustawić strategia ustalania stawek. Limit dotyczy wszystkich słów kluczowych zarządzanych przez strategię. Zmienne tylko w przypadku strategii portfolio ustalania stawek.
targetCpaMicros

string (int64 format)

Opcja docelowego kosztu działania (CPA). Jest to średnia kwota, jaką chcesz wydać na działanie powodujące konwersję, podana w mikrojednostkach waluty strategii ustalania stawek. Jeśli ją skonfigurujesz, strategia ustalania stawek będzie uzyskiwać jak najwięcej konwersji przy docelowym lub niższym koszcie działania. W przeciwnym razie strategia ustalania stawek będzie dążyć do uzyskania jak najniższego CPA w ramach budżetu.

TargetCpa

Strategia automatycznego określania stawek, która ustala stawki w taki sposób, by pomóc Ci uzyskać jak największą liczbę konwersji przy wybranym przez Ciebie docelowym koszcie pozyskania (CPA).

Zapis JSON 
{
  "targetCpaMicros": string,
  "cpcBidCeilingMicros": string,
  "cpcBidFloorMicros": string
}
Pola
targetCpaMicros

string (int64 format)

Średni docelowy CPA. Wartość docelowa powinna być większa od minimalnej jednostki podlegającej rozliczeniu lub jej równa w zależności od waluty konta.
cpcBidCeilingMicros

string (int64 format)

Maksymalna stawka, jaką może ustawić strategia ustalania stawek. Limit dotyczy wszystkich słów kluczowych zarządzanych przez strategię. To ustawienie należy ustawić tylko w przypadku strategii portfolio ustalania stawek.
cpcBidFloorMicros

string (int64 format)

Limit minimalnej stawki, który może ustawić strategia ustalania stawek. Limit dotyczy wszystkich słów kluczowych zarządzanych przez strategię. To ustawienie należy ustawić tylko w przypadku strategii portfolio ustalania stawek.

TargetImpressionShare

Strategia automatycznego określania stawek, która ustala stawki tak, aby określony odsetek reklam w wyszukiwarce wyświetlał się u góry pierwszej strony (lub w innej wybranej lokalizacji).

Zapis JSON 
{
  "location": enum (TargetImpressionShareLocation),
  "locationFractionMicros": string,
  "cpcBidCeilingMicros": string
}
Pola
location

enum (TargetImpressionShareLocation)

Wybrana lokalizacja na stronie wyników wyszukiwania.
locationFractionMicros

string (int64 format)

Wybrany odsetek reklam wyświetlanych w wybranej lokalizacji (w mikro). Na przykład 1% to 10 000.
cpcBidCeilingMicros

string (int64 format)

Najwyższa stawka CPC, jaką może określić system automatycznego określania stawek. Jest to pole wymagane przez reklamodawcę, które ustawia limit i jest podane w mikro lokalnych.

TargetImpressionShareLocation

Wyliczenie opisujące możliwe cele.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
ANYWHERE_ON_PAGE Dowolna lokalizacja na stronie internetowej.
TOP_OF_PAGE Górne pole z reklamami.
ABSOLUTE_TOP_OF_PAGE Górny boks w górnym polu z reklamami.

TargetOutrankShare

Strategia automatycznego określania stawek polegająca na określaniu stawek na podstawie docelowego odsetka aukcji, w których reklamodawca powinien przelicytować danego konkurenta. Ta strategia została wycofana.

Zapis JSON 
{
  "cpcBidCeilingMicros": string
}
Pola
cpcBidCeilingMicros

string (Int64Value format)

Maksymalna stawka, jaką może ustawić strategia ustalania stawek. Limit dotyczy wszystkich słów kluczowych zarządzanych przez strategię.

TargetRoas

Strategia automatycznego określania stawek, która pomaga zmaksymalizować przychody przy średnim docelowym zwrocie z nakładów na reklamę (ROAS).

Zapis JSON 
{
  "targetRoas": number,
  "cpcBidCeilingMicros": string,
  "cpcBidFloorMicros": string
}
Pola
targetRoas

number

Wymagane. Wybrane przychody (na podstawie danych o konwersjach) na jednostkę wydatków. Wartość musi mieścić się w zakresie od 0,01 do 1000,0 włącznie.
cpcBidCeilingMicros

string (int64 format)

Maksymalna stawka, jaką może ustawić strategia ustalania stawek. Limit dotyczy wszystkich słów kluczowych zarządzanych przez strategię. To ustawienie należy ustawić tylko w przypadku strategii portfolio ustalania stawek.
cpcBidFloorMicros

string (int64 format)

Limit minimalnej stawki, który może ustawić strategia ustalania stawek. Limit dotyczy wszystkich słów kluczowych zarządzanych przez strategię. To ustawienie należy ustawić tylko w przypadku strategii portfolio ustalania stawek.

TargetSpend

Strategia automatycznego określania stawek, która ustala stawki w taki sposób, by pomóc Ci uzyskać jak najwięcej kliknięć w ramach budżetu.

Zapis JSON 
{
  "targetSpendMicros": string,
  "cpcBidCeilingMicros": string
}
Pola
targetSpendMicros
(deprecated)

string (int64 format)

Docelowe wydatki, poniżej których mają być kierowane maksymalizacje liczby kliknięć. Licytujący docelowe wydatki spróbuje wydać mniejszą z tych wartości lub kwotę wydatków, które są naturalnie ograniczane. Jeśli go nie określisz, zostanie użyty budżet. To pole zostało wycofane i nie powinno być już używane. Szczegółowe informacje znajdziesz na stronie https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html.
cpcBidCeilingMicros

string (int64 format)

Maksymalna stawka, jaką może ustawić strategia ustalania stawek. Limit dotyczy wszystkich słów kluczowych zarządzanych przez strategię.

CampaignBudget

Budżet kampanii.

Zapis JSON 
{
  "resourceName": string,
  "deliveryMethod": enum (BudgetDeliveryMethod),
  "period": enum (BudgetPeriod),
  "amountMicros": string
}
Pola
resourceName

string

Nazwa zasobu budżetu kampanii. Nazwy zasobów budżetu kampanii mają postać:

customers/{customerId}/campaignBudgets/{campaign_budget_id}
deliveryMethod

enum (BudgetDeliveryMethod)

Metoda wyświetlania, która określa tempo wydawania budżetu kampanii.

Jeśli nie określono inaczej w operacji tworzenia, wartość domyślna to STANDARD.
period

enum (BudgetPeriod)

Okres, w którym zostanie wykorzystany budżet. Jeśli nie zostanie określony, przyjmuje się, że domyślnie jest to DAILY.
amountMicros

string (int64 format)

Kwota budżetu w walucie lokalnej konta. Kwotę podaje się w mikro, gdzie milion to jedna jednostka waluty. Wydatki miesięczne są ograniczone do 30,4 raza więcej.

BudgetDeliveryMethod

Możliwe metody wyświetlania budżetu.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
STANDARD Serwer budżetu będzie ograniczać wyświetlanie równomiernie w całym okresie.
ACCELERATED Serwer budżetu nie będzie ograniczać wyświetlania reklam, a reklamy będą wyświetlać się tak szybko, jak to możliwe.

BudgetPeriod

Potencjalny okres budżetu.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
DAILY Budżet dzienny.
FIXED_DAILY Stały budżet dzienny.
CUSTOM_PERIOD Budżetu niestandardowego można użyć z wartością total_amount, aby określić limit czasu trwania budżetu.

Priorytet

Kampania.

Zapis JSON 
{
  "resourceName": string,
  "status": enum (CampaignStatus),
  "servingStatus": enum (CampaignServingStatus),
  "biddingStrategySystemStatus": enum (BiddingStrategySystemStatus),
  "adServingOptimizationStatus": enum (AdServingOptimizationStatus),
  "advertisingChannelType": enum (AdvertisingChannelType),
  "advertisingChannelSubType": enum (AdvertisingChannelSubType),
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "realTimeBiddingSetting": {
    object (RealTimeBiddingSetting)
  },
  "networkSettings": {
    object (NetworkSettings)
  },
  "dynamicSearchAdsSetting": {
    object (DynamicSearchAdsSetting)
  },
  "shoppingSetting": {
    object (ShoppingSetting)
  },
  "geoTargetTypeSetting": {
    object (GeoTargetTypeSetting)
  },
  "labels": [
    string
  ],
  "biddingStrategyType": enum (BiddingStrategyType),
  "accessibleBiddingStrategy": string,
  "frequencyCaps": [
    {
      object (FrequencyCapEntry)
    }
  ],
  "selectiveOptimization": {
    object (SelectiveOptimization)
  },
  "optimizationGoalSetting": {
    object (OptimizationGoalSetting)
  },
  "trackingSetting": {
    object (TrackingSetting)
  },
  "engineId": string,
  "excludedParentAssetFieldTypes": [
    enum (AssetFieldType)
  ],
  "createTime": string,
  "creationTime": string,
  "lastModifiedTime": string,
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "campaignBudget": string,
  "startDate": string,
  "endDate": string,
  "finalUrlSuffix": string,
  "urlExpansionOptOut": boolean,

  // Union field campaign_bidding_strategy can be only one of the following:
  "biddingStrategy": string,
  "manualCpa": {
    object (ManualCpa)
  },
  "manualCpc": {
    object (ManualCpc)
  },
  "manualCpm": {
    object (ManualCpm)
  },
  "maximizeConversions": {
    object (MaximizeConversions)
  },
  "maximizeConversionValue": {
    object (MaximizeConversionValue)
  },
  "targetCpa": {
    object (TargetCpa)
  },
  "targetImpressionShare": {
    object (TargetImpressionShare)
  },
  "targetRoas": {
    object (TargetRoas)
  },
  "targetSpend": {
    object (TargetSpend)
  },
  "percentCpc": {
    object (PercentCpc)
  },
  "targetCpm": {
    object (TargetCpm)
  }
  // End of list of possible types for union field campaign_bidding_strategy.
}
Pola
resourceName

string

Nazwa zasobu kampanii. Nazwy zasobów kampanii mają postać:

customers/{customerId}/campaigns/{campaign_id}
status

enum (CampaignStatus)

Stan kampanii.

Po dodaniu nowej kampanii jej stan przyjmuje domyślnie wartość WŁĄCZONA.
servingStatus

enum (CampaignServingStatus)

Stan wyświetlania reklam w kampanii.
biddingStrategySystemStatus

enum (BiddingStrategySystemStatus)

Stan systemowy strategii ustalania stawek w kampanii.
adServingOptimizationStatus

enum (AdServingOptimizationStatus)

Stan optymalizacji wyświetlania reklam w kampanii.
advertisingChannelType

enum (AdvertisingChannelType)

Główny cel wyświetlania reklam w kampanii. Opcje kierowania można zawęzić tutaj: networkSettings.

To pole jest wymagane i nie powinno być puste podczas tworzenia nowych kampanii.

To ustawienie można skonfigurować tylko podczas tworzenia kampanii. Po utworzeniu kampanii nie można zmienić tego pola.
advertisingChannelSubType

enum (AdvertisingChannelSubType)

Opcjonalne zawężenie wyszukiwania do: advertisingChannelType. Musi być prawidłowym podtypem kanału nadrzędnego.

To ustawienie można skonfigurować tylko podczas tworzenia kampanii. Po utworzeniu kampanii nie można zmienić tego pola.
urlCustomParameters[]

object (CustomParameter)

Lista mapowań używanych do zastępowania tagów parametrów niestandardowych w tagach trackingUrlTemplate, finalUrls lub mobile_final_urls.
realTimeBiddingSetting

object (RealTimeBiddingSetting)

Ustawienia określania stawek w czasie rzeczywistym – to funkcja dostępna tylko w kampaniach kierowanych na sieć Ad Exchange.
networkSettings

object (NetworkSettings)

Ustawienia sieci dla kampanii.
dynamicSearchAdsSetting

object (DynamicSearchAdsSetting)

Ustawienie do kontrolowania dynamicznych reklam w wyszukiwarce.
shoppingSetting

object (ShoppingSetting)

Ustawienie do kontrolowania kampanii produktowych.
geoTargetTypeSetting

object (GeoTargetTypeSetting)

Ustawienie kierowania geograficznego reklam.
labels[]

string

Nazwy zasobów etykiet dołączonych do tej kampanii.
biddingStrategyType

enum (BiddingStrategyType)

Typ strategii ustalania stawek.

Strategię ustalania stawek można utworzyć, ustawiając schemat ustalania stawek tak, aby utworzyć standardową strategię ustalania stawek, lub pole biddingStrategy, aby utworzyć strategię portfolio ustalania stawek.

To pole jest tylko do odczytu.
accessibleBiddingStrategy

string

Nazwa zasobu AccessibleStrategia określania stawek, czyli dostępny tylko do odczytu widok nieograniczonych atrybutów dołączonej strategii portfolio ustalania stawek określonej przez strategię ustalania stawek „biddingStrategy”. Pole jest puste, jeśli kampania nie korzysta ze strategii portfolio. Atrybuty strategii bez ograniczeń są dostępne dla wszystkich klientów, którym udostępniono strategię i są odczytywane z zasobu AccessibleStrategia określania stawek. Z kolei atrybuty z ograniczeniami są dostępne tylko dla właściciela strategii i jego menedżerów. Atrybuty z ograniczeniami można odczytywać tylko z zasobu strategii określania stawek.
frequencyCaps[]

object (FrequencyCapEntry)

Lista ograniczająca częstotliwość, z jaką każdy użytkownik może oglądać reklamy z tej kampanii.
selectiveOptimization

object (SelectiveOptimization)

Ustawienie optymalizacji selektywnej tej kampanii obejmujące zestaw działań powodujących konwersję, pod kątem których ma być optymalizowana kampania. Ta funkcja dotyczy tylko kampanii promujących aplikacje, które mają wartość MULTI_CHANNEL jako typ kanału reklamowego i APP_CAMPAIGN lub APP_CAMPAIGN_FOR_ENGAGEMENT jako elementu AdvertisingChannelSubType.
optimizationGoalSetting

object (OptimizationGoalSetting)

Ustawienie celu optymalizacji tej kampanii z zestawem typów celów optymalizacji.
trackingSetting

object (TrackingSetting)

Ustawienia śledzenia informacji na poziomie kampanii.
engineId

string

Identyfikator kampanii na zewnętrznym koncie wyszukiwarki. To pole dotyczy tylko kont innych niż Google Ads, np. Yahoo Japan, Microsoft czy Baidu. W przypadku elementu Google Ads zamiast „campaign.id”.
excludedParentAssetFieldTypes[]

enum (AssetFieldType)

Typy pól komponentów, które powinny być wykluczone z tej kampanii. Połączenia zasobów z tymi typami pól nie będą dziedziczone przez tę kampanię z wyższego poziomu.
createTime

string

Sygnatura czasowa utworzenia tej kampanii. Sygnatura czasowa jest podana w strefie czasowej klienta i ma format „rrrr-MM-dd GG:mm:ss”. W wersji 1 parametr createTime zostanie wycofany. Zamiast tego użyj parametru createTime.
creationTime

string

Sygnatura czasowa utworzenia tej kampanii. Sygnatura czasowa jest podana w strefie czasowej klienta i w formacie „rrrr-MM-dd GG:mm:ss”.
lastModifiedTime

string

Data i godzina ostatniej modyfikacji kampanii. Data i godzina są podane w strefie czasowej klienta i w formacie „rrrr-MM-dd GG:mm:ss.ssssss”.
id

string (int64 format)

Identyfikator kampanii.
name

string

Nazwa kampanii

To pole jest wymagane i nie powinno być puste podczas tworzenia nowych kampanii.

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).
trackingUrlTemplate

string

Szablon adresu URL służący do tworzenia linku monitorującego.
campaignBudget

string

Budżet kampanii.
startDate

string

Data rozpoczęcia kampanii w strefie czasowej klienta podana w formacie RRRR-MM-DD.
endDate

string

Ostatni dzień kampanii w strefie czasowej klienta w formacie RRRR-MM-DD. Domyślna wartość podczas tworzenia to 30.12.2037, co oznacza, że kampania będzie prowadzona bezterminowo. Aby ustawić bieżącą kampanię na czas nieokreślony, ustaw w tym polu wartość 30.12.2037.
finalUrlSuffix

string

Sufiks używany do dołączania parametrów zapytania do stron docelowych wyświetlanych przy użyciu śledzenia równoległego.
urlExpansionOptOut

boolean

Oznacza rezygnację z rozwinięcia adresu URL na bardziej ukierunkowane adresy URL. Jeśli ta opcja jest wyłączona, kierowanie odbywa się tylko na końcowe adresy URL z grupy plików lub adresy URL określone w Google Merchant Center lub plikach firmowych baz danych reklamodawcy. Jeśli zasada jest włączona (fałsz), reklamy są kierowane na całą domenę. To pole można skonfigurować tylko w przypadku kampanii Performance Max, w których wartość domyślna to fałsz.

Pole sumy campaign_bidding_strategy. Strategia ustalania stawek w kampanii.

Musi być portfolio (utworzonym w usłudze ustalania stawek) lub standardowym umieszczonym w kampanii. campaign_bidding_strategy może być tylko jedną z tych wartości:
biddingStrategy

string

Strategia portfolio ustalania stawek używana przez kampanię.
manualCpa

object (ManualCpa)

standardowa strategia samodzielnego ustawiania stawek CPA. Strategia samodzielnego ustawiania stawek, która pozwala reklamodawcy ustawić stawkę za działanie określone przez reklamodawcę. Obsługiwane tylko w kampaniach w Usługach Lokalnych.
manualCpc

object (ManualCpc)

standardowa strategia samodzielnego ustawiania stawek CPC. Samodzielne określanie stawek na podstawie kliknięć, w którym użytkownik płaci za kliknięcie.
manualCpm

object (ManualCpm)

Standardowa strategia samodzielnego ustawiania stawek CPM. Ręczne określanie stawek na podstawie wyświetleń, w którym użytkownik płaci za tysiąc wyświetleń.
maximizeConversions

object (MaximizeConversions)

Standardowa strategia ustalania stawek pod kątem maksymalizacji liczby konwersji, która automatycznie maksymalizuje liczbę konwersji w ramach określonego budżetu.
maximizeConversionValue

object (MaximizeConversionValue)

Standardowa strategia ustalania stawek pod kątem maksymalizacji wartości konwersji, która automatycznie ustala stawki tak, aby zmaksymalizować przychody w ramach określonego budżetu.
targetCpa

object (TargetCpa)

Standardowa strategia określania docelowych stawek CPA, która automatycznie ustala stawki, by pomóc Ci uzyskać jak największą liczbę konwersji przy wybranym przez Ciebie docelowym koszcie pozyskania (CPA).
targetImpressionShare

object (TargetImpressionShare)

Strategia ustalania stawek pod kątem docelowego udziału w wyświetleniach. Strategia automatycznego określania stawek, która ustala stawki tak, aby osiągnąć określony odsetek wyświetleń.
targetRoas

object (TargetRoas)

Standardowa strategia ustalania stawek Docelowy ROAS, która automatycznie maksymalizuje przychody przy średnim docelowym zwrocie z nakładów na reklamę (ROAS).
targetSpend

object (TargetSpend)

Standardowa strategia ustalania stawek pod kątem docelowych wydatków, która automatycznie ustala stawki tak, by pomóc Ci uzyskać jak najwięcej kliknięć w ramach budżetu.
percentCpc

object (PercentCpc)

Standardowa strategia ustalania stawek CPC (w %), w której stawki stanowią ułamek reklamowanej ceny za dany towar lub usługę.
targetCpm

object (TargetCpm)

Strategia ustalania stawek, która automatycznie optymalizuje koszt tysiąca wyświetleń

CampaignStatus

Możliwy stan kampanii.

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 Kampania jest aktywna i może wyświetlać reklamy.
PAUSED Kampania została wstrzymana przez użytkownika.
REMOVED Kampania została usunięta.

CampaignServingStatus

Możliwe stany wyświetlania reklam z kampanii.

Wartości w polu enum
UNSPECIFIED Nie określono wartości.
UNKNOWN

Otrzymana wartość nie jest znana w tej wersji.

To jest wartość tylko z odpowiedzią.
SERVING Obsługa.
NONE Brak.
ENDED Zakończono.
PENDING Oczekiwanie.
SUSPENDED Zawieszony.

BiddingStrategySystemStatus

Możliwe stany systemu strategii ustalania stawek.

Wartości w polu enum
UNSPECIFIED Sygnały, że wystąpił nieoczekiwany błąd, np. nie znaleziono typu strategii ustalania stawek lub nie znaleziono informacji o stanie.
UNKNOWN Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
ENABLED Strategia ustalania stawek jest aktywna, AdWords nie znajduje w niej żadnych konkretnych problemów.
LEARNING_NEW Strategia ustalania stawek się uczy, ponieważ została niedawno utworzona lub niedawno ponownie aktywowana.
LEARNING_SETTING_CHANGE Strategia ustalania stawek się uczy z powodu niedawnej zmiany ustawienia.
LEARNING_BUDGET_CHANGE Strategia ustalania stawek się uczy z powodu niedawnej zmiany w budżecie.
LEARNING_COMPOSITION_CHANGE Strategia ustalania stawek się uczy z powodu niedawnej zmiany liczby powiązanych z nią kampanii, grup reklam lub słów kluczowych.
LEARNING_CONVERSION_TYPE_CHANGE Strategia ustalania stawek korzysta z raportów o konwersjach oraz typów konwersji, które ostatnio zmodyfikował klient, które pasowały do tej strategii.
LEARNING_CONVERSION_SETTING_CHANGE Strategia ustalania stawek działa na podstawie raportowania konwersji, a klient niedawno zmienił ustawienia konwersji.
LIMITED_BY_CPC_BID_CEILING Strategia ustalania stawek jest ograniczona przez limit stawki.
LIMITED_BY_CPC_BID_FLOOR Strategia ustalania stawek jest ograniczona przez dolną stawkę.
LIMITED_BY_DATA Strategia ustalania stawek jest ograniczona, ponieważ w ostatnich tygodniach liczba konwersji była niewystarczająca.
LIMITED_BY_BUDGET Znaczna część słów kluczowych w tej strategii ustalania stawek jest ograniczona przez budżet.
LIMITED_BY_LOW_PRIORITY_SPEND Strategia ustalania stawek nie może osiągnąć docelowych wydatków, ponieważ priorytet wydatków został obniżony.
LIMITED_BY_LOW_QUALITY Znaczna część słów kluczowych w tej strategii ustalania stawek ma niski wynik jakości.
LIMITED_BY_INVENTORY Strategia ustalania stawek nie może w pełni wykorzystać budżetu z powodu wąskiego kierowania.
MISCONFIGURED_ZERO_ELIGIBILITY Brak śledzenia konwersji (brak pingów) lub listy remarketingowe dla inteligentnych kampanii produktowych.
MISCONFIGURED_CONVERSION_TYPES Strategia ustalania stawek korzysta z raportowania konwersji, a klientowi brakuje typów konwersji, które mogłyby zostać uwzględnione w raportach dotyczących tej strategii.
MISCONFIGURED_CONVERSION_SETTINGS Strategia ustalania stawek korzysta z raportowania konwersji, a ustawienia konwersji klienta są nieprawidłowo skonfigurowane.
MISCONFIGURED_SHARED_BUDGET Istnieją kampanie spoza strategii ustalania stawek, które korzystają z budżetu wspólnego z kampaniami objętymi tą strategią.
MISCONFIGURED_STRATEGY_TYPE Kampania ma nieprawidłowy typ strategii i nie wyświetla reklam.
PAUSED Strategia ustalania stawek nie jest aktywna. Ze strategią ustalania stawek nie są powiązane żadne aktywne kampanie, grupy reklam ani słowa kluczowe. Strategia ustalania stawek nie ma też żadnych aktywnych budżetów.
UNAVAILABLE Ta strategia ustalania stawek nie obsługuje obecnie raportowania stanu.
MULTIPLE_LEARNING W okresie, o którym mowa, ta strategia ustalania stawek miała kilka LEARNING_* stanów systemu.
MULTIPLE_LIMITED W okresie, o którym mowa, ta strategia ustalania stawek miała kilka LIMITED_* stanów systemu.
MULTIPLE_MISCONFIGURED W okresie, o którym była mowa w danej strategii ustalania stawek, wystąpiło kilka stanów MISCONFIGURED_* w systemie.
MULTIPLE W wybranym okresie ta strategia ustalania stawek miała kilka stanów systemu.

AdServingOptimizationStatus

Wyliczenie opisujące możliwe stany wyświetlania.

Wartości w polu enum
UNSPECIFIED Nie określono wartości.
UNKNOWN

Otrzymana wartość nie jest znana w tej wersji.

To jest wartość tylko z odpowiedzią.
OPTIMIZE Wyświetlanie reklam jest optymalizowane na podstawie CTR kampanii.
CONVERSION_OPTIMIZE Wyświetlanie reklam jest optymalizowane na podstawie CTR * konwersji w kampanii. Jeśli kampania nie korzysta ze strategii ustalania stawek optymalizatora konwersji, domyślnie zostanie ustawiona opcja OPTYMALIZACJA.
ROTATE Reklamy są wyświetlane naprzemiennie przez 90 dni, a następnie optymalizowane pod kątem kliknięć.
ROTATE_INDEFINITELY Równomiernie wyświetlaj mniej skuteczne reklamy z reklamami skuteczniejszymi i nie optymalizuj.
UNAVAILABLE Stan optymalizacji wyświetlania reklam jest niedostępny.

AdvertisingChannelType

Wyliczenie opisujące różne typy kanałów reklamowych.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
SEARCH Sieć wyszukiwania. Obejmuje kampanie w sieci reklamowej i kampanie w sieci wyszukiwania+.
DISPLAY Tylko sieć reklamowa Google.
SHOPPING Kampanie produktowe wyświetlają reklamy w usłudze produktowej i w wynikach wyszukiwania na google.com.
HOTEL kampanii reklam hoteli.
VIDEO Kampanie wideo.
MULTI_CHANNEL Kampanie promujące aplikacje i kampanie budujące zaangażowanie w aplikacje, które działają w wielu kanałach.
LOCAL Lokalne kampanie reklamowe.
SMART Kampanie inteligentne.
PERFORMANCE_MAX Kampanie Performance Max.
LOCAL_SERVICES Kampanie w Usługach Lokalnych.
DISCOVERY Kampanie Discovery.
TRAVEL Kampanie dotyczące podróży.

AdvertisingChannelSubType

Wyliczenie opisujące różne podtypy kanałów.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Jest używana tylko jako wartość zwrotna. Reprezentuje wartość nieznaną w tej wersji.
SEARCH_MOBILE_APP Kampanie promujące aplikacje mobilne w sieci wyszukiwania.
DISPLAY_MOBILE_APP Kampanie promujące aplikacje mobilne w sieci reklamowej.
SEARCH_EXPRESS Kampanie AdWords Express w sieci wyszukiwania.
DISPLAY_EXPRESS Kampanie AdWords Express w sieci reklamowej.
SHOPPING_SMART_ADS Inteligentne kampanie produktowe.
DISPLAY_GMAIL_AD Kampanie reklamowe w Gmailu.
DISPLAY_SMART_CAMPAIGN Inteligentne kampanie w sieci reklamowej. Nie można tworzyć nowych kampanii tego podtypu.
VIDEO_OUTSTREAM Kampanie wideo Out-Stream.
VIDEO_ACTION Kampanie wideo TrueView zachęcające do działania.
VIDEO_NON_SKIPPABLE Kampanie wideo z reklamami wideo niemożliwymi do pominięcia.
APP_CAMPAIGN Kampania promująca aplikację, która ułatwia promowanie aplikacji na Androida lub iOS w najważniejszych usługach Google, takich jak wyszukiwarka, Google Play, YouTube i sieć reklamowa Google.
APP_CAMPAIGN_FOR_ENGAGEMENT Kampania budująca zaangażowanie w aplikację, która koncentruje się na zachęcaniu do ponownego zaangażowania w aplikację w kilku najpopularniejszych usługach Google, m.in. w wyszukiwarce, YouTube i sieci reklamowej Google.
LOCAL_CAMPAIGN Kampanie specjalizujące się w reklamie lokalnej.
SHOPPING_COMPARISON_LISTING_ADS kampanii produktowych z porównaniem informacji o produktach.
SMART_CAMPAIGN standardowych kampanii inteligentnych.
VIDEO_SEQUENCE Kampanie wideo z sekwencyjnymi reklamami wideo.
APP_CAMPAIGN_FOR_PRE_REGISTRATION Kampania promująca aplikację z wcześniejszą rejestracją, specjalizująca się w reklamowaniu wcześniejszej rejestracji na aplikację mobilną, kierowana na wiele kanałów reklamowych w Google Play, YouTube i sieci reklamowej.
VIDEO_REACH_TARGET_FREQUENCY Kampania wideo typu „Zasięg” ze strategią ustalania stawek pod kątem docelowej częstotliwości.
TRAVEL_ACTIVITIES kampanii dotyczących podróży.

CustomParameter

Mapowanie, którego można używać przez tagi parametrów niestandardowych w obrębie trackingUrlTemplate, finalUrls lub mobile_final_urls.

Zapis JSON 
{
  "key": string,
  "value": string
}
Pola
key

string

Klucz pasujący do nazwy tagu parametru.
value

string

Wartość do zastąpienia.

RealTimeBiddingSetting

Ustawienia określania stawek w czasie rzeczywistym – to funkcja dostępna tylko w kampaniach kierowanych na sieć Ad Exchange.

Zapis JSON 
{
  "optIn": boolean
}
Pola
optIn

boolean

Określa, czy kampania ma włączone określanie stawek w czasie rzeczywistym.

NetworkSettings

Ustawienia sieci dla kampanii.

Zapis JSON 
{
  "targetGoogleSearch": boolean,
  "targetSearchNetwork": boolean,
  "targetContentNetwork": boolean,
  "targetPartnerSearchNetwork": boolean
}
Pola
targetSearchNetwork

boolean

Określa, czy reklamy będą wyświetlane w witrynach partnerów w sieci wyszukiwania Google (wymagany parametr targetGoogleSearch też musi wynosić true).
targetContentNetwork

boolean

Czy reklamy będą wyświetlane w określonych miejscach docelowych w sieci reklamowej Google. Miejsca docelowe określa się za pomocą kryterium Miejsce docelowe.
targetPartnerSearchNetwork

boolean

Czy reklamy mają być wyświetlane w sieci partnerów Google. Ta funkcja jest dostępna tylko na wybranych kontach partnerów Google.

DynamicSearchAdsSetting

Ustawienie do kontrolowania dynamicznych reklam w wyszukiwarce.

Zapis JSON 
{
  "domainName": string,
  "languageCode": string,
  "useSuppliedUrlsOnly": boolean
}
Pola
domainName

string

Wymagane. Nazwa domeny internetowej reprezentowana przez to ustawienie, na przykład „google.com” lub „www.google.com”.
languageCode

string

Wymagane. Kod języka określający język domeny, np. „pl”.
useSuppliedUrlsOnly

boolean

Wskazuje, czy w kampanii są używane wyłącznie adresy URL dostarczone przez reklamodawcę.

ShoppingSetting

To ustawienie dotyczy kampanii produktowych. Określa zbiór produktów, które mogą być reklamowane w ramach kampanii, oraz sposób interakcji kampanii z innymi kampaniami produktowymi.

Zapis JSON 
{
  "feedLabel": string,
  "useVehicleInventory": boolean,
  "merchantId": string,
  "salesCountry": string,
  "campaignPriority": integer,
  "enableLocal": boolean
}
Pola
feedLabel

string

Etykieta pliku danych z produktami do dodania do kampanii. Można ustawić tylko jedną etykietę pliku danych lub kraj sprzedaży. Jeśli zostanie użyte zamiast parametru SalesCountry, pole FeedLabel akceptuje kody krajów w tym samym formacie, np. „XX”. W przeciwnym razie może to być dowolny ciąg znaków używany jako etykieta pliku danych w Google Merchant Center.
useVehicleInventory

boolean

Określa, czy kierowanie na wykaz pojazdów.
merchantId

string (int64 format)

Identyfikator konta Merchant Center. To pole jest wymagane do operacji tworzenia. W przypadku kampanii produktowych tego pola nie można zmienić.
salesCountry

string

Kraj sprzedaży produktów, które chcesz uwzględnić w kampanii.
campaignPriority

integer

Priorytet kampanii. Kampanie o wyższych numerach priorytetów mają pierwszeństwo przed kampaniami o niższych priorytetach. To pole jest wymagane w przypadku kampanii produktowych zawierających wartości z zakresu od 0 do 2 włącznie. W przypadku inteligentnych kampanii produktowych to pole jest opcjonalne, ale jego wartość musi wynosić 3.
enableLocal

boolean

Określa, czy uwzględniać produkty dostępne lokalnie.

GeoTargetTypeSetting

Reprezentuje zbiór ustawień związanych z kierowaniem geograficznym reklam.

Zapis JSON 
{
  "positiveGeoTargetType": enum (PositiveGeoTargetType),
  "negativeGeoTargetType": enum (NegativeGeoTargetType)
}
Pola
positiveGeoTargetType

enum (PositiveGeoTargetType)

Ustawienie używane do kierowania geograficznego w tej konkretnej kampanii.
negativeGeoTargetType

enum (NegativeGeoTargetType)

Ustawienie używane do wykluczającego kierowania geograficznego w tej konkretnej kampanii.

PositiveGeoTargetType

Możliwe typy niewykluczających celów geograficznych.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Wartość jest nieznana w tej wersji.
PRESENCE_OR_INTEREST Określa, że reklama ma się wyświetlić, gdy użytkownik znajduje się w wybranych lokalizacjach reklamodawcy lub się nimi interesuje.
SEARCH_INTEREST Określa, że reklama jest wyświetlana, gdy użytkownik wyszukuje wybrane lokalizacje reklamodawcy. Tej opcji można używać tylko w kampaniach w sieci wyszukiwania i standardowych kampaniach produktowych.
PRESENCE Określa, że reklama jest wyświetlana, gdy użytkownik znajduje się w wybranych lokalizacjach reklamodawcy lub regularnie w nich bywa.

NegativeGeoTargetType

Możliwe typy wykluczonych celów geograficznych.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Wartość jest nieznana w tej wersji.
PRESENCE_OR_INTEREST Określa, że użytkownik nie zobaczy reklamy, jeśli znajduje się w wykluczonych lokalizacjach reklamodawcy lub się nimi interesuje.
PRESENCE Określa, że użytkownik nie może zobaczyć reklamy, jeśli znajduje się w wykluczonej lokalizacji reklamodawcy.

FrequencyCapEntry

Ten typ nie ma żadnych pól.

Reguła określająca maksymalną liczbę wyświetleń reklamy (lub zestawu reklam) użytkownikowi w danym okresie.

SelectiveOptimization

Ustawienie optymalizacji selektywnej tej kampanii obejmujące zestaw działań powodujących konwersję, pod kątem których ma być optymalizowana kampania. Ta funkcja dotyczy tylko kampanii promujących aplikacje, które mają wartość MULTI_CHANNEL jako typ kanału reklamowego i APP_CAMPAIGN lub APP_CAMPAIGN_FOR_ENGAGEMENT jako elementu AdvertisingChannelSubType.

Zapis JSON 
{
  "conversionActions": [
    string
  ]
}
Pola
conversionActions[]

string

Wybrany zestaw działań powodujących konwersję do optymalizacji tej kampanii.

OptimizationGoalSetting

Ustawienie celu optymalizacji tej kampanii z zestawem typów celów optymalizacji.

Zapis JSON 
{
  "optimizationGoalTypes": [
    enum (OptimizationGoalType)
  ]
}
Pola
optimizationGoalTypes[]

enum (OptimizationGoalType)

Lista typów celów optymalizacji.

OptimizationGoalType

Typ celu optymalizacji

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Jest używana tylko jako wartość zwrotna. Reprezentuje wartość nieznaną w tej wersji.
CALL_CLICKS Optymalizuj pod kątem kliknięć prowadzących do połączenia. Konwersje po kliknięciu połączenia to liczba kliknięć opcji „Zadzwoń”, aby skontaktować się ze sklepem po obejrzeniu reklamy.
DRIVING_DIRECTIONS Optymalizacja pod kątem wskazówek dojazdu. Konwersje wskazówek dojazdu to kliknięcia przycisku „Wyznacz trasę”, by wyznaczyć trasę dojazdu do sklepu po obejrzeniu reklamy.
APP_PRE_REGISTRATION Optymalizacja pod kątem wcześniejszej rejestracji. Konwersje polegające na wcześniejszej rejestracji to liczba rejestracji w ramach wcześniejszej rejestracji, które umożliwiają otrzymanie powiadomienia o opublikowaniu aplikacji.

TrackingSetting

Ustawienia śledzenia informacji na poziomie kampanii.

Zapis JSON 
{
  "trackingUrl": string
}
Pola
trackingUrl

string

Adres URL używany do dynamicznego śledzenia.

ManualCpa

Ten typ nie ma żadnych pól.

Strategia samodzielnego ustawiania stawek, która pozwala reklamodawcy ustawić stawkę za działanie określone przez reklamodawcę.

ManualCpc

Samodzielne określanie stawek na podstawie kliknięć, w którym użytkownik płaci za kliknięcie.

Zapis JSON 
{
  "enhancedCpcEnabled": boolean
}
Pola
enhancedCpcEnabled

boolean

Czy stawki mają zostać ulepszone na podstawie danych z optymalizatora konwersji.

ManualCpm

Ten typ nie ma żadnych pól.

Ręczne określanie stawek na podstawie wyświetleń, w którym użytkownik płaci za tysiąc wyświetleń.

PercentCpc

Strategia ustalania stawek, w której stawki są ułamkiem reklamowanej ceny dla danego towaru lub usługi.

Zapis JSON 
{
  "cpcBidCeilingMicros": string,
  "enhancedCpcEnabled": boolean
}
Pola
cpcBidCeilingMicros

string (int64 format)

Maksymalna stawka, jaką może ustawić strategia ustalania stawek. To pole jest wpisane przez reklamodawcę i podawane w mikro lokalnych. Uwaga: wartość zerowa jest interpretowana w taki sam sposób, jak wartość atrybutu bid_floor nieokreślona.
enhancedCpcEnabled

boolean

Dostosowuje stawkę w każdej aukcji w górę lub w dół w zależności od prawdopodobieństwa konwersji. Poszczególne stawki mogą przekraczać cpcbidCeilingMicros, ale średnia kwota stawki w kampanii nie powinna.

TargetCpm

Ten typ nie ma żadnych pól.

Docelowy CPM (koszt tysiąca wyświetleń) to strategia automatycznego określania stawek, która ustala stawki pod kątem optymalizacji skuteczności przy określonym docelowym CPM.

CampaignAsset

Połączenie między kampanią a zasobem.

Zapis JSON 
{
  "resourceName": string,
  "status": enum (AssetLinkStatus),
  "campaign": string,
  "asset": string
}
Pola
resourceName

string

Nazwa zasobu kampanii. Nazwy zasobów CampaignAsset mają postać:

customers/{customerId}/campaignAssets/{campaign_id}~{assetId}~{fieldType}
status

enum (AssetLinkStatus)

Stan komponentu kampanii.
campaign

string

Kampania, z którą powiązany jest komponent.
asset

string

Komponent połączony z kampanią.

CampaignAssetSet

CampaignAssetSet to połączenie między kampanią a zestawem komponentów. Dodanie elementu CampaignAssetSet łączy zestaw komponentów z kampanią.

Zapis JSON 
{
  "resourceName": string,
  "campaign": string,
  "assetSet": string,
  "status": enum (AssetSetLinkStatus)
}
Pola
resourceName

string

Nazwa zasobu zestawu komponentów kampanii. Nazwy zasobów zestawu zasobów mają postać:

customers/{customerId}/campaignAssetSets/{campaign_id}~{asset_set_id}
campaign

string

Kampania, z którą jest połączony ten zestaw komponentów.
assetSet

string

Zestaw komponentów połączony z kampanią.
status

enum (AssetSetLinkStatus)

Stan komponentu w zestawie komponentów kampanii. Tylko do odczytu.

CampaignAudienceView

Widok odbiorców kampanii. Zawiera dane o skuteczności z zainteresowań i list remarketingowych dla reklam w sieci reklamowej i w YouTube oraz listy remarketingowe dla reklam w wyszukiwarce (RLSA) pogrupowane według kampanii i kryterium odbiorców. Ten widok obejmuje tylko listy odbiorców dołączone na poziomie kampanii.

Zapis JSON 
{
  "resourceName": string
}
Pola
resourceName

string

Nazwa zasobu widoku odbiorców kampanii. Nazwy zasobów widoku odbiorców w kampanii mają postać:

customers/{customerId}/campaignAudienceViews/{campaign_id}~{criterionId}

CampaignCriterion

Kryterium kampanii.

Zapis JSON 
{
  "resourceName": string,
  "displayName": string,
  "type": enum (CriterionType),
  "status": enum (CampaignCriterionStatus),
  "lastModifiedTime": string,
  "criterionId": string,
  "bidModifier": number,
  "negative": boolean,

  // Union field criterion can be only one of the following:
  "keyword": {
    object (KeywordInfo)
  },
  "location": {
    object (LocationInfo)
  },
  "device": {
    object (DeviceInfo)
  },
  "ageRange": {
    object (AgeRangeInfo)
  },
  "gender": {
    object (GenderInfo)
  },
  "userList": {
    object (UserListInfo)
  },
  "language": {
    object (LanguageInfo)
  },
  "webpage": {
    object (WebpageInfo)
  },
  "locationGroup": {
    object (LocationGroupInfo)
  }
  // End of list of possible types for union field criterion.
}
Pola
resourceName

string

Nazwa zasobu kryterium kampanii. Nazwy zasobów kryterium kampanii mają postać:

customers/{customerId}/campaignCriteria/{campaign_id}~{criterionId}
displayName

string

Wyświetlana nazwa kryterium.

To pole jest ignorowane w przypadku mutacji.
type

enum (CriterionType)

Rodzaj kryterium.
status

enum (CampaignCriterionStatus)

Stan kryterium.
lastModifiedTime

string

Data i godzina ostatniej modyfikacji tego kryterium kampanii. Data i godzina są podane w strefie czasowej klienta i w formacie „rrrr-MM-dd GG:mm:ss.ssssss”.
criterionId

string (int64 format)

Identyfikator kryterium.

To pole jest ignorowane podczas mutacji.
bidModifier

number

Modyfikator stawek w przypadku spełnienia kryterium. Modyfikator musi mieścić się w zakresie: 0,1 - 10,0. Większość typów kryteriów kierowania obsługuje modyfikatory. Aby zrezygnować z danego typu urządzenia, wpisz 0.
negative

boolean

Określa, czy kryterium ma być celem kierowania (false) czy wykluczonym (true).

Pole sumy criterion. Kryterium kampanii.

Musisz ustawić dokładnie jeden. criterion może być tylko jedną z tych wartości:
keyword

object (KeywordInfo)

Słowo kluczowe.
location

object (LocationInfo)

Lokalizacja.
device

object (DeviceInfo)

Urządzenie.
ageRange

object (AgeRangeInfo)

Przedział wiekowy.
gender

object (GenderInfo)

Płeć.
userList

object (UserListInfo)

Lista użytkowników.
language

object (LanguageInfo)

Językiem
webpage

object (WebpageInfo)

Strona internetowa.
locationGroup

object (LocationGroupInfo)

Grupa lokalizacji

CampaignCriterionStatus

Możliwe stany elementu CampaignCriterion.

Wartości w polu enum
UNSPECIFIED Nie określono wartości.
UNKNOWN

Otrzymana wartość nie jest znana w tej wersji.

To jest wartość tylko z odpowiedzią.
ENABLED Kryterium kampanii jest włączone.
PAUSED Kryterium kampanii jest wstrzymane.
REMOVED Kryterium kampanii zostało usunięte.

LanguageInfo

Kryterium języka.

Zapis JSON 
{
  "languageConstant": string
}
Pola
languageConstant

string

Nazwa zasobu stałego języka.

LocationGroupInfo

Promień wokół listy lokalizacji określonej w pliku danych.

Zapis JSON 
{
  "geoTargetConstants": [
    string
  ],
  "radiusUnits": enum (LocationGroupRadiusUnits),
  "feedItemSets": [
    string
  ],
  "radius": string
}
Pola
geoTargetConstants[]

string

Stałe kierowania geograficznego ograniczające zakres obszaru geograficznego w pliku danych. Obecnie dozwolona jest tylko jedna stała kierowania geograficznego.
radiusUnits

enum (LocationGroupRadiusUnits)

Jednostka promienia. W przypadku stałych kierowania geograficznego obsługiwane są mile i metry. W zestawach elementów pliku danych obsługiwane są mile i metry. Jest to wymagane i należy je ustawić w operacjach CREATE.
feedItemSets[]

string

Zbiory kanałów, których elementy kanału są celem kierowania. Jeśli podasz większą liczbę identyfikatorów, kierowanie będzie obejmować wszystkie elementy, które występują w co najmniej 1 zestawie. Tego pola nie można używać ze stałymi wartościami geoTargetConstants. Jest to opcjonalne i można go ustawić tylko w operacjach CREATE.
radius

string (int64 format)

Odległość w jednostkach określająca promień wokół wybranych lokalizacji. Jest to wymagane i należy je ustawić w operacjach CREATE.

LocationGroupRadiusUnits

Jednostka długości promienia w grupie lokalizacji (np. MILE)

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
METERS Metry
MILES Mile
MILLI_MILES Milli mile

CampaignLabel

Reprezentuje relację między kampanią a etykietą.

Zapis JSON 
{
  "resourceName": string,
  "campaign": string,
  "label": string
}
Pola
resourceName

string

Nazwa zasobu. Nazwy zasobów etykiet kampanii mają postać: customers/{customerId}/campaignLabels/{campaign_id}~{label_id}
campaign

string

Kampania, do której została dołączona etykieta.
label

string

Etykieta przypisana do kampanii.

CartDataSalesView

Widok sprzedaży danych koszyka.

Zapis JSON 
{
  "resourceName": string
}
Pola
resourceName

string

Nazwa zasobu widoku sprzedaży danych koszyka. Nazwy zasobów widoku sprzedaży danych koszyka mają postać: customers/{customerId}/cartDataSalesView

Odbiorcy

Odbiorcy to skuteczna opcja kierowania, która pozwala łączyć różne atrybuty segmentów, np. szczegółowe dane demograficzne i podobne zainteresowania, aby tworzyć listy odbiorców reprezentujące sekcje segmentów docelowych.

Zapis JSON 
{
  "resourceName": string,
  "id": string,
  "name": string,
  "description": string
}
Pola
resourceName

string

Nazwa zasobu listy odbiorców. Nazwy list odbiorców mają postać:

customers/{customerId}/audiences/{audience_id}
id

string (int64 format)

Identyfikator listy odbiorców.
name

string

Wymagane. Nazwa listy odbiorców. Powinien on być niepowtarzalny wśród wszystkich odbiorców. Musi mieć minimalną długość 1 i maksymalną 255 znaków.
description

string

Opis tej listy odbiorców.

ConversionAction

Działanie powodujące konwersję.

Zapis JSON 
{
  "resourceName": string,
  "creationTime": string,
  "status": enum (ConversionActionStatus),
  "type": enum (ConversionActionType),
  "category": enum (ConversionActionCategory),
  "valueSettings": {
    object (ValueSettings)
  },
  "attributionModelSettings": {
    object (AttributionModelSettings)
  },
  "floodlightSettings": {
    object (FloodlightSettings)
  },
  "id": string,
  "name": string,
  "primaryForGoal": boolean,
  "ownerCustomer": string,
  "includeInClientAccountConversionsMetric": boolean,
  "includeInConversionsMetric": boolean,
  "clickThroughLookbackWindowDays": string,
  "appId": string
}
Pola
resourceName

string

Nazwa zasobu działania powodującego konwersję. Nazwy zasobów działań powodujących konwersję mają postać:

customers/{customerId}/conversionActions/{conversion_action_id}
creationTime

string

Sygnatura czasowa utworzenia aktywności Floodlight w formacie ISO 8601.
status

enum (ConversionActionStatus)

Stan tego działania powodującego konwersję na potrzeby gromadzenia zdarzeń konwersji.
type

enum (ConversionActionType)

Typ tego działania powodującego konwersję.
category

enum (ConversionActionCategory)

Kategoria konwersji zgłoszonych dla tego działania powodującego konwersję.
valueSettings

object (ValueSettings)

Ustawienia związane z wartością zdarzeń konwersji powiązanych z tym działaniem powodującym konwersję.
attributionModelSettings

object (AttributionModelSettings)

Ustawienia związane z modelem atrybucji tego działania powodującego konwersję.
floodlightSettings

object (FloodlightSettings)

Ustawienia Floodlight dla typów konwersji Floodlight.
id

string (int64 format)

Identyfikator działania powodującego konwersję.
name

string

Nazwa działania powodującego konwersję.

To pole jest wymagane i nie powinno być puste podczas tworzenia nowych działań powodujących konwersję.
primaryForGoal

boolean

Jeśli parametr primaryForGoal ma wartość false (fałsz), w przypadku działania powodującego konwersję nie można ustalać stawki w żadnej kampanii, niezależnie od celu konwersji klienta czy celu konwersji kampanii. Niestandardowe cele konwersji nie uwzględniają jednak ustawień primaryForGoal, więc jeśli w kampanii cel konwersji niestandardowy jest skonfigurowany z ustawieniem primaryForGoal = false działanie powodujące konwersję, za to działanie powodujące konwersję nadal można ustalać stawki. Jeśli nie zostanie ustawiony, zasada mainForGoal ma domyślnie wartość prawda. W wersji 9 parametr mainForGoal może mieć wartość „false” (fałsz) po utworzeniu za pomocą operacji „update”, ponieważ nie jest on zadeklarowany jako opcjonalny.
ownerCustomer

string

Nazwa zasobu klienta właściciela działania powodującego konwersję lub wartość null, jeśli jest to działanie powodujące konwersję zdefiniowane przez system.
includeInClientAccountConversionsMetric

boolean

Określa, czy to działanie powodujące konwersję ma być uwzględnione w danych „Konwersje na koncie klienta”.
includeInConversionsMetric

boolean

Określa, czy to działanie powodujące konwersję ma być uwzględniane w danych „Konwersje”.
clickThroughLookbackWindowDays

string (int64 format)

Maksymalna liczba dni, jaka może upływać między interakcją (np. kliknięciem) a zdarzeniem konwersji.
appId

string

Identyfikator aplikacji działania powodującego konwersję z aplikacji.

ConversionActionStatus

Możliwe stany działania powodującego konwersję.

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 Konwersje będą rejestrowane.
REMOVED Konwersje nie będą rejestrowane.
HIDDEN Konwersje nie będą rejestrowane, a działanie powodujące konwersję nie będzie widoczne w interfejsie.

ConversionActionType

Możliwe typy działania powodującego konwersję.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
AD_CALL Konwersje, które mają miejsce, gdy użytkownik kliknie rozszerzenie połączeń w reklamie.
CLICK_TO_CALL Konwersje, które mają miejsce, gdy użytkownik kliknie numer telefonu na urządzeniu mobilnym.
GOOGLE_PLAY_DOWNLOAD Konwersje, które mają miejsce, gdy użytkownik pobierze aplikację mobilną ze Sklepu Google Play.
GOOGLE_PLAY_IN_APP_PURCHASE Konwersje, które mają miejsce, gdy użytkownik dokonuje zakupu w aplikacji, korzystając z płatności na Androidzie.
UPLOAD_CALLS Konwersje telefoniczne śledzone przez reklamodawcę i przesyłane.
UPLOAD_CLICKS Konwersje śledzone przez reklamodawcę i przesyłane z przypisanymi kliknięciami.
WEBPAGE Konwersje na stronie internetowej.
WEBSITE_CALL Konwersje, które mają miejsce, gdy użytkownik zadzwoni pod dynamicznie generowany numer telefonu z witryny reklamodawcy.
STORE_SALES_DIRECT_UPLOAD Konwersje polegające na sprzedaży w sklepie stacjonarnym obliczane na podstawie przesłanych danych własnych lub pochodzących od sprzedawców zewnętrznych. Z typów przesyłania bezpośredniego sprzedaży w sklepie mogą korzystać tylko klienci z listy dozwolonych.
STORE_SALES Konwersje polegające na sprzedaży w sklepie są określane na podstawie przesłanych danych własnych lub pochodzących od sprzedawców zewnętrznych lub zakupów w sklepie przy użyciu kart z sieci płatniczych. Z typów sprzedaży w sklepie mogą korzystać tylko klienci z listy dozwolonych. Tylko do odczytu.
FIREBASE_ANDROID_FIRST_OPEN Konwersje polegające na pierwszym uruchomieniu aplikacji na Androida śledzone przez Firebase.
FIREBASE_ANDROID_IN_APP_PURCHASE Konwersje polegające na zakupie aplikacji na Androida w aplikacji śledzone przez Firebase.
FIREBASE_ANDROID_CUSTOM Niestandardowe konwersje aplikacji na Androida śledzone przez Firebase.
FIREBASE_IOS_FIRST_OPEN Konwersje polegające na pierwszym uruchomieniu aplikacji na iOS śledzone przez Firebase.
FIREBASE_IOS_IN_APP_PURCHASE Konwersje polegające na zakupie w aplikacji na iOS śledzone przez Firebase.
FIREBASE_IOS_CUSTOM Niestandardowe konwersje aplikacji na iOS śledzone przez Firebase.
THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN Konwersje polegające na pierwszym uruchomieniu aplikacji na Androida śledzone za pomocą analityki aplikacji przez firmy zewnętrzne
THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE Konwersje polegające na zakupie aplikacji na Androida śledzone w ramach analityki aplikacji innych firm
THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM Konwersje niestandardowe w aplikacjach na Androida śledzone za pomocą analityki aplikacji firmy zewnętrznej
THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN Konwersje polegające na pierwszym uruchomieniu aplikacji na iOS śledzone za pomocą analityki aplikacji firm zewnętrznych
THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE Konwersje polegające na zakupie aplikacji na iOS śledzone za pomocą analityki aplikacji firmy zewnętrznej
THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM Niestandardowe konwersje w aplikacji na iOS śledzone za pomocą analityki aplikacji innych firm
ANDROID_APP_PRE_REGISTRATION Konwersje, które mają miejsce, gdy użytkownik wstępnie zarejestruje aplikację mobilną ze Sklepu Google Play. Tylko do odczytu.
ANDROID_INSTALLS_ALL_OTHER_APPS Konwersje, które śledzą wszystkie pobrania z Google Play, które nie są śledzone przez typ aplikacji. Tylko do odczytu.
FLOODLIGHT_ACTION Aktywność Floodlight zliczająca wizyty na określonej stronie internetowej po zobaczeniu lub kliknięciu jednej z reklam reklamodawcy. Tylko do odczytu.
FLOODLIGHT_TRANSACTION Aktywność Floodlight śledząca liczbę zrealizowanych transakcji sprzedaży lub liczbę kupionych produktów. Może też rejestrować łączną wartość każdej sprzedaży. Tylko do odczytu.
GOOGLE_HOSTED Konwersje, które śledzą działania lokalne produktów i usług Google po interakcji z reklamą. Tylko do odczytu.
LEAD_FORM_SUBMIT Konwersje są rejestrowane, gdy użytkownik przesyła formularz kontaktowy. Tylko do odczytu.
SALESFORCE Konwersje pochodzące z Salesforce. Tylko do odczytu.
SEARCH_ADS_360 Konwersje zaimportowane z danych Floodlight w Search Ads 360. Tylko do odczytu.
SMART_CAMPAIGN_AD_CLICKS_TO_CALL konwersje telefoniczne, które są realizowane w reklamach w kampanii inteligentnej, jeśli nie skonfigurowano śledzenia połączeń telefonicznych, a które są określane przy użyciu kryteriów niestandardowych w kampanii inteligentnej. Tylko do odczytu.
SMART_CAMPAIGN_MAP_CLICKS_TO_CALL Użytkownik klika element połączenia w Mapach Google. Tylko kampania inteligentna. Tylko do odczytu.
SMART_CAMPAIGN_MAP_DIRECTIONS Użytkownik prosi o wskazówki dojazdu do lokalizacji firmy w Mapach Google. Tylko kampania inteligentna. Tylko do odczytu.
SMART_CAMPAIGN_TRACKED_CALLS Konwersje telefoniczne uzyskiwane w reklamach w kampanii inteligentnej z ustawionymi śledzeniem połączeń i ustawionymi kryteriami niestandardowymi w kampanii inteligentnej. Tylko do odczytu.
STORE_VISITS Konwersje, które mają miejsce, gdy użytkownik odwiedza sklep stacjonarny reklamodawcy. Tylko do odczytu.
WEBPAGE_CODELESS Konwersje utworzone na podstawie zdarzeń w witrynie (np. przesłania formularza lub wczytania strony), które nie korzystają z indywidualnie kodowanych fragmentów kodu zdarzenia. Tylko do odczytu.
UNIVERSAL_ANALYTICS_GOAL Konwersje, które pochodzą z połączonych celów Universal Analytics.
UNIVERSAL_ANALYTICS_TRANSACTION Konwersje, które pochodzą z połączonych transakcji Universal Analytics.
GOOGLE_ANALYTICS_4_CUSTOM Konwersje, które pochodzą z połączonych konwersji zdarzeń niestandardowych Google Analytics 4.
GOOGLE_ANALYTICS_4_PURCHASE Konwersje, które pochodzą z połączonych konwersji polegających na zakupie w Google Analytics 4.

ConversionActionCategory

Kategoria konwersji powiązanych z działaniem powodującym konwersję.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
DEFAULT Kategoria domyślna.
PAGE_VIEW Użytkownik odwiedzający stronę.
PURCHASE Zdarzenie zakupu, sprzedaży lub złożonego zamówienia.
SIGNUP Działanie użytkownika polegające na rejestracji.
LEAD Działania mające na celu zwiększanie liczby potencjalnych klientów
DOWNLOAD Pobranie oprogramowania (jak w przypadku aplikacji).
ADD_TO_CART Dodanie produktów do koszyka lub torby na zakupy w witrynie reklamodawcy.
BEGIN_CHECKOUT Gdy ktoś rozpoczyna proces płatności w witrynie reklamodawcy.
SUBSCRIBE_PAID Początek płatnej subskrypcji produktu lub usługi.
PHONE_CALL_LEAD Rozmowa telefoniczna z prośbą o wyrażenie zainteresowania ofertą reklamodawcy.
IMPORTED_LEAD Konwersja polegająca na wypełnieniu formularza kontaktowego zaimportowanego z zewnętrznego źródła do Google Ads.
SUBMIT_LEAD_FORM Wypełnienie na stronie reklamodawcy formularza wskazującego zainteresowanie firmą.
BOOK_APPOINTMENT Umówienie spotkania z firmą reklamodawcy.
REQUEST_QUOTE Prośba o wycenę lub oszacowanie ceny.
GET_DIRECTIONS Wyszukiwanie lokalizacji firmy reklamodawcy z zamiarem odwiedzenia.
OUTBOUND_CLICK Kliknięcie prowadzące do witryny partnera reklamodawcy.
CONTACT Rozmowa telefoniczna, SMS, e-mail, czat lub inny rodzaj kontaktu z reklamodawcą.
ENGAGEMENT zdarzenie związane z zaangażowaniem w witrynę, np. długi czas spędzony w witrynie lub cel inteligentny w Google Analytics (GA). Przeznaczona do importowania celów w Google Analytics, Firebase i Google Analytics.
STORE_VISIT Wizyta w sklepie stacjonarnym.
STORE_SALE Wyprzedaż w sklepie stacjonarnym.
QUALIFIED_LEAD Konwersja polegająca na zaimportowaniu do Google Ads konwersji potencjalnego klienta z zewnętrznego źródła, która została dodatkowo zakwalifikowana przez reklamodawcę (zespół ds. marketingu lub sprzedaży). Reklamodawcy pozyskują potencjalnych klientów na ścieżce od potencjalnego klienta do sprzedaży, a następnie nawiązują z nimi kontakt. Jeśli klient jest zainteresowany zakupem jego produktu, reklamodawca oznacza go jako „kwalifikujących się potencjalnych klientów”.
CONVERTED_LEAD Konwersja polegająca na wypełnieniu formularza kontaktowego zaimportowana do Google Ads z zewnętrznego źródła, która zakończyła się dalej określonym etapem określonym przez reklamodawcę służącego do zdobywania potencjalnych klientów.

ValueSettings

Ustawienia związane z wartością zdarzeń konwersji powiązanych z tym działaniem powodującym konwersję.

Zapis JSON 
{
  "defaultValue": number,
  "defaultCurrencyCode": string,
  "alwaysUseDefaultValue": boolean
}
Pola
defaultValue

number

Wartość do użycia, gdy zdarzenia konwersji dla tego działania powodującego konwersję są wysyłane z nieprawidłową, niedozwoloną lub brakującą wartością albo gdy to działanie powodujące konwersję jest skonfigurowane tak, aby zawsze używać wartości domyślnej.
defaultCurrencyCode

string

Kod waluty używany, gdy zdarzenia konwersji w ramach tego działania powodującego konwersję są wysyłane z nieprawidłowym lub brakującym kodem waluty albo gdy to działanie powodujące konwersję jest skonfigurowane tak, aby zawsze używać wartości domyślnej.
alwaysUseDefaultValue

boolean

Określa, czy zamiast kodu wartości i waluty określonych w zdarzeniach konwersji w przypadku tego działania powodującego konwersję używa się kodu wartości domyślnej i kodu waluty domyślnej.

AttributionModelSettings

Ustawienia związane z modelem atrybucji tego działania powodującego konwersję.

Zapis JSON 
{
  "attributionModel": enum (AttributionModel),
  "dataDrivenModelStatus": enum (DataDrivenModelStatus)
}
Pola
attributionModel

enum (AttributionModel)

Typ modelu atrybucji w przypadku tego działania powodującego konwersję.
dataDrivenModelStatus

enum (DataDrivenModelStatus)

Stan modelu atrybucji opartej na danych dla działania powodującego konwersję.

AttributionModel

Model atrybucji, który określa, jak przypisać udział w danej konwersji między potencjalnie wiele wcześniejszych interakcji.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
EXTERNAL Wykorzystuje zewnętrzną atrybucję.
GOOGLE_ADS_LAST_CLICK Przypisuje cały udział w konwersji ostatniemu kliknięciu.
GOOGLE_SEARCH_ATTRIBUTION_FIRST_CLICK Przypisuje cały udział w konwersji pierwszemu kliknięciu na podstawie atrybucji w wyszukiwarce Google.
GOOGLE_SEARCH_ATTRIBUTION_LINEAR Przypisuje jednakowy udział w konwersji wszystkim kliknięciom, korzystając z atrybucji w wyszukiwarce Google.
GOOGLE_SEARCH_ATTRIBUTION_TIME_DECAY Na podstawie atrybucji w wyszukiwarce Google przypisuje zdecydowanie większy udział w konwersji ostatnim kliknięciom (okres półtrwania to tydzień).
GOOGLE_SEARCH_ATTRIBUTION_POSITION_BASED Na jej podstawie 40% udziału w konwersji jest przypisywane pierwszemu i ostatniemu kliknięciu. Pozostałe 20% jest równomiernie rozkładane pomiędzy wszystkie pozostałe kliknięcia. Korzysta on z atrybucji w wyszukiwarce Google.
GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN Elastyczny model, który wykorzystuje systemy uczące się, aby określić odpowiedni rozkład udziału w kliknięciach za pomocą atrybucji w wyszukiwarce Google.

DataDrivenModelStatus

Wylicza stany modelu na podstawie danych.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
AVAILABLE Dostępny jest model oparty na danych.
STALE Model oparty na danych jest nieaktualny. Nie była aktualizowana od co najmniej 7 dni. Nadal jest używana, ale jeśli nie zostanie zaktualizowana w ciągu 30 dni, wygaśnie.
EXPIRED Model oparty na danych wygasł. Nie była aktualizowana od co najmniej 30 dni, więc nie można jej używać. Zwykle dzieje się tak, gdy w ciągu ostatnich 30 dni nie było wymaganej liczby zdarzeń.
NEVER_GENERATED Model oparty na danych nigdy nie został wygenerowany. Najczęściej dzieje się tak w żadnym 30-dniowym okresie.

FloodlightSettings

Ustawienia związane z działaniem powodującym konwersję Floodlight.

Zapis JSON 
{
  "activityGroupTag": string,
  "activityTag": string,
  "activityId": string
}
Pola
activityGroupTag

string

Ciąg znaków używany do identyfikacji grupy aktywności Floodlight podczas raportowania konwersji.
activityTag

string

Ciąg znaków używany do identyfikacji aktywności Floodlight podczas raportowania konwersji.
activityId

string (int64 format)

Identyfikator aktywności Floodlight w usłudze DoubleClick Campaign Manager (DCM).

ConversionCustomVariable

Niestandardowa zmienna konwersji. Przeczytaj artykuł „Niestandardowe dane i wymiary Floodlight w nowej wersji Search Ads 360” na stronie https://support.google.com/sa360/answer/13567857.

Zapis JSON 
{
  "resourceName": string,
  "id": string,
  "name": string,
  "tag": string,
  "status": enum (ConversionCustomVariableStatus),
  "ownerCustomer": string,
  "family": enum (ConversionCustomVariableFamily),
  "cardinality": enum (ConversionCustomVariableCardinality),
  "floodlightConversionCustomVariableInfo": {
    object (FloodlightConversionCustomVariableInfo)
  },
  "customColumnIds": [
    string
  ]
}
Pola
resourceName

string

Nazwa zasobu zmiennej niestandardowej konwersji. Nazwy zasobów niestandardowych zmiennych konwersji mają postać:

customers/{customerId}/conversionCustomVariables/{conversion_custom_variable_id}
id

string (int64 format)

Identyfikator niestandardowej zmiennej konwersji.
name

string

Wymagane. Nazwa niestandardowej zmiennej konwersji. Nazwa powinna być unikalna. Maksymalna długość nazwy to 100 znaków. Przed i po nim nie może być żadnych dodatkowych spacji.
tag

string

Wymagane. Tag zmiennej niestandardowej konwersji. Tag powinien być unikalny i zawierać znak „u”, po którym następuje liczba mniejsza niż ormequal do 100. Na przykład: „u4”.
status

enum (ConversionCustomVariableStatus)

Stan zmiennej niestandardowej konwersji na potrzeby gromadzenia zdarzeń konwersji.
ownerCustomer

string

Nazwa zasobu klienta, do którego należy niestandardowa zmienna konwersji.
family

enum (ConversionCustomVariableFamily)

Rodzina zmiennej niestandardowej konwersji.
cardinality

enum (ConversionCustomVariableCardinality)

Moc zbioru niestandardowej zmiennej konwersji.
floodlightConversionCustomVariableInfo

object (FloodlightConversionCustomVariableInfo)

Pola na potrzeby zmiennych niestandardowych konwersji Floodlight w Search Ads 360.
customColumnIds[]

string (int64 format)

Identyfikatory kolumn niestandardowych, które korzystają z tej zmiennej niestandardowej konwersji.

ConversionCustomVariableStatus

Możliwe stany zmiennej niestandardowej konwersji.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
ACTIVATION_NEEDED

Niestandardowa zmienna konwersji oczekuje na aktywację i nie będzie gromadziła statystyk, dopóki nie zostanie włączona.

Tego stanu nie można używać w żądaniach CREATE ani UPDATE.
ENABLED Niestandardowa zmienna konwersji jest włączona i będzie gromadziła statystyki.
PAUSED Niestandardowa zmienna konwersji została wstrzymana i nie będzie gromadziła statystyk, dopóki nie zostanie ponownie WŁĄCZONA.

ConversionCustomVariableFamily

Rodzina zmiennej niestandardowej konwersji.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
STANDARD Standardowa zmienna niestandardowa konwersji. Klienci muszą aktywować usługę przed użyciem.
FLOODLIGHT Niestandardowa zmienna konwersji zaimportowana z niestandardowej zmiennej Floodlight.

ConversionCustomVariableCardinality

Moc zbioru niestandardowej zmiennej konwersji.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
BELOW_ALL_LIMITS Niestandardowa zmienna konwersji ma moc zbioru poniżej wszystkich limitów. Tej zmiennej można użyć do podziału na segmenty, a jeśli jest ona włączona, można gromadzić dane o nowych wartościach.
EXCEEDS_SEGMENTATION_LIMIT_BUT_NOT_STATS_LIMIT Niestandardowa zmienna konwersji ma moc zbioru, która przekracza limit podziału na segmenty, ale nie przekracza limitu statystyk. Podział na segmenty zostanie wyłączony, ale jeśli zmienna zostanie włączona, mogą być gromadzone dla nowych wartości statystyki.
APPROACHES_STATS_LIMIT Niestandardowa zmienna konwersji przekroczyła limit podziału na segmenty i zbliża się do limitów statystyk (>90%). Podział na segmenty zostanie wyłączony, ale jeśli zmienna zostanie włączona, mogą być gromadzone dla nowych wartości statystyki.
EXCEEDS_STATS_LIMIT Niestandardowa zmienna konwersji przekroczyła zarówno limity podziału na segmenty, jak i limity statystyk. Podział na segmenty zostanie wyłączony, a statystyki włączonych zmiennych będą gromadzone tylko wtedy, gdy istniejące wartości nie zwiększają już mocy zbioru zmiennej.

FloodlightConversionCustomVariableInfo

Informacje o zmiennych niestandardowych konwersji Floodlight w Search Ads 360.

Zapis JSON 
{
  "floodlightVariableType": enum (FloodlightVariableType),
  "floodlightVariableDataType": enum (FloodlightVariableDataType)
}
Pola
floodlightVariableType

enum (FloodlightVariableType)

Typ zmiennej Floodlight zdefiniowany w Search Ads 360.
floodlightVariableDataType

enum (FloodlightVariableDataType)

Typ danych zmiennej Floodlight zdefiniowany w Search Ads 360.

FloodlightVariableType

Typ zmiennej Floodlight określony w Search Ads 360. Więcej informacji znajdziesz na stronie https://support.google.com/searchads/answer/4397154?hl=en.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
DIMENSION Typ zmiennej Floodlight wymiaru.
METRIC Typ zmiennej Floodlight.
UNSET Nie określono typu zmiennej Floodlight.

FloodlightVariableDataType

Typ danych zmiennej Floodlight określony w Search Ads 360. Więcej informacji znajdziesz na stronie https://support.google.com/searchads/answer/4397154?hl=en.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
NUMBER Reprezentuje zmienną Floodlight typu „Liczba”. Tę zmienną można przypisać do zmiennych Floodlight typu DIMENSION lub METRIC.
STRING Reprezentuje zmienną Floodlight typu „String”. Tę zmienną można przypisać do zmiennych Floodlight typu DIMENSION.

Klient

Klienta.

Zapis JSON 
{
  "resourceName": string,
  "conversionTrackingSetting": {
    object (ConversionTrackingSetting)
  },
  "accountType": enum (AccountType),
  "doubleClickCampaignManagerSetting": {
    object (DoubleClickCampaignManagerSetting)
  },
  "accountStatus": enum (AccountStatus),
  "lastModifiedTime": string,
  "engineId": string,
  "status": enum (CustomerStatus),
  "creationTime": string,
  "id": string,
  "descriptiveName": string,
  "currencyCode": string,
  "timeZone": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": string,
  "autoTaggingEnabled": boolean,
  "manager": boolean
}
Pola
resourceName

string

Nazwa zasobu klienta. Nazwy zasobów klienta mają postać:

customers/{customerId}
conversionTrackingSetting

object (ConversionTrackingSetting)

Ustawienie śledzenia konwersji dla klienta.
accountType

enum (AccountType)

Typ konta wyszukiwarki, np. Google Ads, Microsoft Advertising, Yahoo Japan, Baidu, Facebook, śledzenia wyszukiwarki itp.
doubleClickCampaignManagerSetting

object (DoubleClickCampaignManagerSetting)

Ustawienie usługi DoubleClick Campaign Manager (DCM) dla klienta menedżera.
accountStatus

enum (AccountStatus)

Stan konta, np. Włączone, Wstrzymane, Usunięte itp.
lastModifiedTime

string

Data i godzina ostatniej modyfikacji klienta. Data i godzina są podane w strefie czasowej klienta i w formacie „rrrr-MM-dd GG:mm:ss.ssssss”.
engineId

string

Identyfikator konta na zewnętrznym koncie wyszukiwarki.
status

enum (CustomerStatus)

Stan klienta.
creationTime

string

Sygnatura czasowa utworzenia tego klienta. Sygnatura czasowa jest podana w strefie czasowej klienta i w formacie „rrrr-MM-dd GG:mm:ss”.
id

string (int64 format)

Identyfikator klienta.
descriptiveName

string

Opcjonalna, nieunikalna nazwa opisowa klienta.
currencyCode

string

Waluta, w której działa konto. Obsługiwany jest podzbiór kodów waluty ze standardu ISO 4217.
timeZone

string

Identyfikator lokalnej strefy czasowej klienta.
trackingUrlTemplate

string

Szablon URL służący do tworzenia linku monitorującego na podstawie parametrów.
finalUrlSuffix

string

Szablon adresu URL służący do dołączania parametrów do końcowego adresu URL.
autoTaggingEnabled

boolean

Określa, czy na koncie klienta jest włączone automatyczne tagowanie.
manager

boolean

od tego, czy klient jest menedżerem.

ConversionTrackingSetting

Zbiór ustawień dla wszystkich klientów związanych ze śledzeniem konwersji w Search Ads 360.

Zapis JSON 
{
  "acceptedCustomerDataTerms": boolean,
  "conversionTrackingStatus": enum (ConversionTrackingStatus),
  "enhancedConversionsForLeadsEnabled": boolean,
  "googleAdsConversionCustomer": string,
  "conversionTrackingId": string,
  "googleAdsCrossAccountConversionTrackingId": string,
  "crossAccountConversionTrackingId": string
}
Pola
acceptedCustomerDataTerms

boolean

Informacja o tym, czy klient zaakceptował warunki dotyczące danych klienta. Jeśli stosujesz śledzenie konwersji dla wielu kont, wartość ta jest dziedziczona z konta menedżera. To pole jest tylko do odczytu. Więcej informacji znajdziesz na https://support.google.com/adspolicy/answer/7475709.
conversionTrackingStatus

enum (ConversionTrackingStatus)

Stan śledzenia konwersji. Wskazuje, czy klient używa śledzenia konwersji i kto jest właścicielem śledzenia konwersji tego klienta. Jeśli ten klient korzysta ze śledzenia konwersji dla wielu kont, zwrócona wartość będzie się różnić w zależności od wartości w polu login-customer-id żądania.
enhancedConversionsForLeadsEnabled

boolean

od tego, czy klient włączył konwersje rozszerzone dotyczące potencjalnych klientów. Jeśli stosujesz śledzenie konwersji dla wielu kont, wartość ta jest dziedziczona z konta menedżera. To pole jest tylko do odczytu.
googleAdsConversionCustomer

string

Nazwa zasobu klienta, dla którego są tworzone i zarządzane konwersje. To pole jest tylko do odczytu.
conversionTrackingId

string (int64 format)

Identyfikator śledzenia konwersji używany na tym koncie. Ten identyfikator nie wskazuje, czy klient korzysta ze śledzenia konwersji (tak – conversionTrackingStatus). To pole jest tylko do odczytu.
googleAdsCrossAccountConversionTrackingId

string (int64 format)

Identyfikator śledzenia konwersji należącego do menedżera klienta. Jest ona konfigurowana, gdy klient ma włączone śledzenie konwersji, i zastępuje parametr conversionTrackingId. Tym polem można zarządzać tylko przez interfejs Google Ads. To pole jest tylko do odczytu.
crossAccountConversionTrackingId

string (int64 format)

Identyfikator śledzenia konwersji należącego do menedżera klienta. Jest ona konfigurowana, gdy klient ma włączone śledzenie konwersji dla wielu kont, co zastępuje conversionTrackingId.

ConversionTrackingStatus

Stan śledzenia konwersji klienta.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
NOT_CONVERSION_TRACKED Klient nie korzysta ze śledzenia konwersji.
CONVERSION_TRACKING_MANAGED_BY_SELF Działania powodujące konwersję są tworzone i zarządzane przez tego klienta.
CONVERSION_TRACKING_MANAGED_BY_THIS_MANAGER Działania powodujące konwersję jest tworzone i zarządzane przez menedżera określonego w login-customer-id prośby.
CONVERSION_TRACKING_MANAGED_BY_ANOTHER_MANAGER Działania powodujące konwersję są tworzone i zarządzane przez menedżera innego niż klient lub menedżer określony w login-customer-id prośby.

AccountType

Możliwe typy kont wyszukiwarki.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
BAIDU Baidu.
ENGINE_TRACK Konto śledzenia wyszukiwarki.
FACEBOOK Konto na Facebooku.
FACEBOOK_GATEWAY Konto na Facebooku zarządzane przez bramę.
GOOGLE_ADS koncie Google Ads.
MICROSOFT na koncie Microsoft Advertising.
SEARCH_ADS_360 konta menedżera Search Ads 360.
YAHOO_JAPAN Konto Yahoo! Japan.

DoubleClickCampaignManagerSetting

Ustawienie usługi DoubleClick Campaign Manager (DCM) dla klienta menedżera.

Zapis JSON 
{
  "advertiserId": string,
  "networkId": string,
  "timeZone": string
}
Pola
advertiserId

string (int64 format)

Identyfikator reklamodawcy w usłudze Campaign Manager powiązanego z tym klientem.
networkId

string (int64 format)

Identyfikator sieci w usłudze Campaign Manager powiązanej z tym klientem.
timeZone

string

Strefa czasowa sieci Campaign Managera powiązanej z tym klientem w formacie bazy danych stref czasowych IANA, np. America/New_York.

AccountStatus

Możliwe stany konta.

Wartości w polu enum
UNSPECIFIED Wartość domyślna.
UNKNOWN Nieznana wartość.
ENABLED Konto może wyświetlać reklamy.
PAUSED Konto zostało dezaktywowane przez użytkownika.
SUSPENDED Konto zostało dezaktywowane w wyniku wewnętrznego procesu.
REMOVED Konto zostało nieodwołalnie dezaktywowane.
DRAFT Konto jest w trakcie konfiguracji, ale nie jest jeszcze WŁĄCZONE.

CustomerStatus

Możliwe stany klienta.

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 Wskazuje aktywne konto, które może wyświetlać reklamy.
CANCELED Wskazuje, że zlikwidowane konto nie może wyświetlać reklam. Administrator może aktywować ponownie.
SUSPENDED Oznacza, że zawieszone konto nie może wyświetlać reklam. To ustawienie może zostać aktywowane tylko przez zespół pomocy Google.
CLOSED Oznacza zamknięte konto, które nie może wyświetlać reklam. Konto testowe też będzie miało stan ZAMKNIĘTE. Stan jest trwały i nie można go ponownie otworzyć.

CustomerAsset

Połączenie między klientem a komponentem.

Zapis JSON 
{
  "resourceName": string,
  "asset": string,
  "status": enum (AssetLinkStatus)
}
Pola
resourceName

string

Nazwa zasobu zasobu klienta. Nazwy zasobów CustomerAsset mają postać:

customers/{customerId}/customerAssets/{assetId}~{fieldType}
asset

string

Wymagane. Komponent, który jest połączony z klientem.
status

enum (AssetLinkStatus)

Stan komponentu klienta.

CustomerAssetSet

Element CustomerAssetSet to połączenie między klientem a zbiorem komponentów. Dodanie obiektu CustomerAssetSet łączy zestaw komponentów z klientem.

Zapis JSON 
{
  "resourceName": string,
  "assetSet": string,
  "customer": string,
  "status": enum (AssetSetLinkStatus)
}
Pola
resourceName

string

Nazwa zasobu zestawu zasobów klienta. Nazwy zasobów zestawu zasobów mają postać:

customers/{customerId}/customerAssetSets/{asset_set_id}
assetSet

string

Zestaw komponentów połączony z klientem.
customer

string

Klient, z którym jest połączony ten zestaw komponentów.
status

enum (AssetSetLinkStatus)

Stan komponentu w zestawie komponentów klienta. Tylko do odczytu.

AccessibleBiddingStrategy

Reprezentuje widok strategii ustalania stawek, które należą do klienta i zostały mu udostępnione.

W przeciwieństwie do strategii ustalania stawek ten zasób obejmuje strategie należące do menedżerów klienta i udostępnione temu klientowi. Ten zasób nie zawiera danych i udostępnia tylko ograniczony podzbiór atrybutów strategii ustalania stawek.

Zapis JSON 
{
  "resourceName": string,
  "id": string,
  "name": string,
  "type": enum (BiddingStrategyType),
  "ownerCustomerId": string,
  "ownerDescriptiveName": string,

  // Union field scheme can be only one of the following:
  "maximizeConversionValue": {
    object (MaximizeConversionValue)
  },
  "maximizeConversions": {
    object (MaximizeConversions)
  },
  "targetCpa": {
    object (TargetCpa)
  },
  "targetImpressionShare": {
    object (TargetImpressionShare)
  },
  "targetRoas": {
    object (TargetRoas)
  },
  "targetSpend": {
    object (TargetSpend)
  }
  // End of list of possible types for union field scheme.
}
Pola
resourceName

string

Nazwa zasobu dostępnej strategii ustalania stawek. Nazwy zasobów AccessibleStrategia określania stawek mają postać:

customers/{customerId}/accessibleBiddingStrategies/{bidding_strategy_id}
id

string (int64 format)

Identyfikator strategii ustalania stawek.
name

string

Nazwa strategii ustalania stawek.
type

enum (BiddingStrategyType)

Typ strategii ustalania stawek.
ownerCustomerId

string (int64 format)

Identyfikator klienta, do którego należy strategia ustalania stawek.
ownerDescriptiveName

string

opisowa nazwa klienta, do którego należy strategia ustalania stawek.

Pole sumy scheme. Schemat określania stawek.

Można ustawić tylko jedną opcję. scheme może być tylko jedną z tych wartości:
maximizeConversionValue

object (MaximizeConversionValue)

Strategia automatycznego określania stawek, która pomoże Ci uzyskać jak największą wartość konwersji dla Twoich kampanii w ramach określonego budżetu.
maximizeConversions

object (MaximizeConversions)

Strategia automatycznego określania stawek, która pomoże Ci uzyskać jak najwięcej konwersji dla Twoich kampanii w ramach określonego budżetu.
targetCpa

object (TargetCpa)

Strategia ustalania stawek, która ustala stawki w taki sposób, by pomóc Ci uzyskać jak największą liczbę konwersji przy wybranym przez Ciebie docelowym koszcie pozyskania (CPA).
targetImpressionShare

object (TargetImpressionShare)

Strategia ustalania stawek, która automatycznie optymalizuje stawki pod kątem określonego odsetka wyświetleń.
targetRoas

object (TargetRoas)

Strategia ustalania stawek, która pomaga zmaksymalizować przychody przy średnim docelowym zwrocie z nakładów na reklamę (ROAS).
targetSpend

object (TargetSpend)

Strategia ustalania stawek, która ustala stawki w taki sposób, by pomóc Ci uzyskać jak najwięcej kliknięć w ramach budżetu.

MaximizeConversionValue

Strategia automatycznego określania stawek, która pomoże Ci uzyskać jak największą wartość konwersji dla Twoich kampanii w ramach określonego budżetu.

Zapis JSON 
{
  "targetRoas": number
}
Pola
targetRoas

number

Opcja docelowego zwrotu z nakładów na reklamę (ROAS). Jeśli go skonfigurujesz, strategia ustalania stawek zmaksymalizuje przychody, zachowując przy tym średni docelowy zwrot z nakładów na reklamę. Jeśli docelowy ROAS jest wysoki, strategia ustalania stawek może nie wydać całego budżetu. Jeśli docelowy ROAS nie jest ustawiony, strategia ustalania stawek dąży do osiągnięcia najwyższego możliwego ROAS w ramach budżetu.

MaximizeConversions

Strategia automatycznego określania stawek, która pomoże Ci uzyskać jak najwięcej konwersji dla Twoich kampanii w ramach określonego budżetu.

Zapis JSON 
{
  "targetCpa": string,
  "targetCpaMicros": string
}
Pola
targetCpa

string (int64 format)

Opcja docelowego kosztu pozyskania (CPA). To średnia kwota, jaką chcesz wydać na pozyskanie.
targetCpaMicros

string (int64 format)

Opcja docelowego kosztu pozyskania (CPA). To średnia kwota, jaką chcesz wydać na pozyskanie.

TargetCpa

Strategia automatycznego określania stawek, która ustala stawki w taki sposób, by pomóc Ci uzyskać jak największą liczbę konwersji przy wybranym przez Ciebie docelowym koszcie pozyskania (CPA).

Zapis JSON 
{
  "targetCpaMicros": string
}
Pola
targetCpaMicros

string (int64 format)

Średni docelowy CPA. Wartość docelowa powinna być większa od minimalnej jednostki podlegającej rozliczeniu lub jej równa w zależności od waluty konta.

TargetImpressionShare

Strategia automatycznego określania stawek, która ustala stawki tak, aby określony odsetek reklam w wyszukiwarce wyświetlał się u góry pierwszej strony (lub w innej wybranej lokalizacji).

Zapis JSON 
{
  "location": enum (TargetImpressionShareLocation),
  "locationFractionMicros": string,
  "cpcBidCeilingMicros": string
}
Pola
location

enum (TargetImpressionShareLocation)

Wybrana lokalizacja na stronie wyników wyszukiwania.
locationFractionMicros

string (int64 format)

Wybrany odsetek reklam wyświetlanych w wybranej lokalizacji (w mikro). Na przykład 1% to 10 000.
cpcBidCeilingMicros

string (int64 format)

Najwyższa stawka CPC, jaką może określić system automatycznego określania stawek. Jest to pole wymagane przez reklamodawcę, które ustawia limit i jest podane w mikro lokalnych.

TargetRoas

Strategia automatycznego określania stawek, która pomaga zmaksymalizować przychody przy średnim docelowym zwrocie z nakładów na reklamę (ROAS).

Zapis JSON 
{
  "targetRoas": number
}
Pola
targetRoas

number

Wybrane przychody (na podstawie danych o konwersjach) na jednostkę wydatków.

TargetSpend

Strategia automatycznego określania stawek, która ustala stawki w taki sposób, by pomóc Ci uzyskać jak najwięcej kliknięć w ramach budżetu.

Zapis JSON 
{
  "targetSpendMicros": string,
  "cpcBidCeilingMicros": string
}
Pola
targetSpendMicros
(deprecated)

string (int64 format)

Docelowe wydatki, poniżej których mają być kierowane maksymalizacje liczby kliknięć. Licytujący docelowe wydatki spróbuje wydać mniejszą z tych wartości lub kwotę wydatków, które są naturalnie ograniczane. Jeśli go nie określisz, zostanie użyty budżet. To pole zostało wycofane i nie powinno być już używane. Szczegółowe informacje znajdziesz na stronie https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html.
cpcBidCeilingMicros

string (int64 format)

Maksymalna stawka, jaką może ustawić strategia ustalania stawek. Limit dotyczy wszystkich słów kluczowych zarządzanych przez strategię.

ManagerLinkStatus

Możliwe stany linku.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
ACTIVE Wskazuje obecny związek
INACTIVE Oznacza zakończone relacje
PENDING Wskazuje, że menedżer wysłał prośbę o relację, ale klient jeszcze jej nie zaakceptował.
REFUSED Menedżer poprosił o utworzenie relacji, ale klient odrzucił prośbę.
CANCELED Wskazuje, że menedżer wysłał prośbę o dodanie relacji, ale menedżer ją anulował.

CustomerClient

Związek między danym klientem a klientem. Element CustomerClient jest dostępny tylko w przypadku klientów menedżera. Uwzględniani są wszyscy bezpośredni i pośredni klienci klienci oraz sam menedżer.

Zapis JSON 
{
  "resourceName": string,
  "appliedLabels": [
    string
  ],
  "status": enum (CustomerStatus),
  "clientCustomer": string,
  "hidden": boolean,
  "level": string,
  "timeZone": string,
  "testAccount": boolean,
  "manager": boolean,
  "descriptiveName": string,
  "currencyCode": string,
  "id": string
}
Pola
resourceName

string

Nazwa zasobu klienta klienta. Nazwy zasobów CustomerClient mają postać: customers/{customerId}/customerClients/{client_customer_id}
appliedLabels[]

string

Nazwy zasobów etykiet należących do klienta wysyłającego prośbę, które zostały zastosowane do klienta klienckiego. Nazwy zasobów etykiet mają postać:

customers/{customerId}/labels/{label_id}
status

enum (CustomerStatus)

Stan klienta. Tylko do odczytu.
clientCustomer

string

Nazwa zasobu klient-klient, który jest połączony z danym klientem. Tylko do odczytu.
hidden

boolean

Określa, czy jest to konto ukryte.

Tylko do odczytu.
level

string (int64 format)

Odległość między danym klientem a klientem. W przypadku połączenia własnego wartość będzie wynosić 0. Tylko do odczytu.
timeZone

string

Reprezentacja ciągu znaków CLDR (Common Locale Data Repository, Common Locale Data Repository) dotycząca strefy czasowej klienta, na przykład America/Los_Angeles. Tylko do odczytu.
testAccount

boolean

Wskazuje, czy klient jest kontem testowym. Tylko do odczytu.
manager

boolean

Wskazuje, czy klient jest menedżerem. Tylko do odczytu.
descriptiveName

string

Opisowa nazwa klienta. Tylko do odczytu.
currencyCode

string

Kod waluty klienta (np. „USD”, „EUR”). Tylko do odczytu.
id

string (int64 format)

Identyfikator klienta. Tylko do odczytu.

DynamicSearchAdsSearchTermView

Widok wyszukiwanych haseł w dynamicznych reklamach w wyszukiwarce.

Zapis JSON 
{
  "resourceName": string,
  "landingPage": string
}
Pola
resourceName

string

Nazwa zasobu widoku wyszukiwanych haseł dynamicznych reklam w wyszukiwarce. Nazwy zasobów w widoku wyszukiwanych haseł w dynamicznych reklamach w wyszukiwarce mają postać:

customers/{customerId}/dynamicSearchAdsSearchTermViews/{ad_group_id}~{search_term_fingerprint}~{headline_fingerprint}~{landing_page_fingerprint}~{page_url_fingerprint}
landingPage

string

Dynamicznie wybrany adres URL strony docelowej wyświetlenia.

To pole jest tylko do odczytu.

GenderView

Widok płci. Zasób płećView odzwierciedla efektywny stan wyświetlania, a nie tylko dodane kryteria. Grupa reklam bez kryteriów płci jest domyślnie wyświetlana wszystkim płciom, więc wszystkie płcie są widoczne w funkcji płećView wraz ze statystykami.

Zapis JSON 
{
  "resourceName": string
}
Pola
resourceName

string

Nazwa zasobu widoku płci. Nazwy zasobów widoku płci mają postać:

customers/{customerId}/genderViews/{ad_group_id}~{criterionId}

GeoTargetConstant

Stała celu geograficznego.

Zapis JSON 
{
  "resourceName": string,
  "status": enum (GeoTargetConstantStatus),
  "id": string,
  "name": string,
  "countryCode": string,
  "targetType": string,
  "canonicalName": string,
  "parentGeoTarget": string
}
Pola
resourceName

string

Nazwa zasobu stałej kierowania geograficznego. Nazwy stałych zasobów w kierowaniu geograficznym mają postać:

geoTargetConstants/{geo_target_constant_id}
status

enum (GeoTargetConstantStatus)

Stan stałego kierowania geograficznego.
id

string (int64 format)

Identyfikator stałej wartości kierowania geograficznego.
name

string

Angielska nazwa stałej kierowania geograficznego.
countryCode

string

Kod kraju w formacie ISO-3166-1 alfa-2, który jest powiązany z celem.
targetType

string

Typ stałego celu kierowania geograficznego.
canonicalName

string

Pełna i jednoznaczna nazwa angielska składająca się z nazwy obiektu docelowego, nazwy elementu nadrzędnego i kraju.
parentGeoTarget

string

Nazwa zasobu nadrzędnej stałej docelowej lokalizacji geograficznej. Nazwy stałych zasobów w kierowaniu geograficznym mają postać:

geoTargetConstants/{parent_geo_target_constant_id}

GeoTargetConstantStatus

Możliwe stany stałej kierowania geograficznego.

Wartości w polu enum
UNSPECIFIED Nie określono wartości.
UNKNOWN

Otrzymana wartość nie jest znana w tej wersji.

To jest wartość tylko z odpowiedzią.
ENABLED Stała kierowania geograficznego jest prawidłowa.
REMOVAL_PLANNED Stała wartość kierowania geograficznego jest nieaktualna i zostanie usunięta.

KeywordView

Widok słów kluczowych.

Zapis JSON 
{
  "resourceName": string
}
Pola
resourceName

string

Nazwa zasobu widoku słów kluczowych. Nazwy zasobów widoku słów kluczowych mają postać:

customers/{customerId}/keywordViews/{ad_group_id}~{criterionId}

Etykieta

Etykieta.

Zapis JSON 
{
  "resourceName": string,
  "status": enum (LabelStatus),
  "textLabel": {
    object (TextLabel)
  },
  "id": string,
  "name": string
}
Pola
resourceName

string

Nazwa zasobu. Nazwy zasobów etykiet mają postać: customers/{customerId}/labels/{label_id}
status

enum (LabelStatus)

Stan etykiety. Tylko do odczytu.
textLabel

object (TextLabel)

Rodzaj etykiety wyświetlanej na kolorowym tle.
id

string (int64 format)

Identyfikator etykiety. Tylko do odczytu.
name

string

Nazwa etykiety.

To pole jest wymagane i nie powinno być puste podczas tworzenia nowej etykiety.

Długość tego ciągu powinna mieścić się w przedziale od 1 do 80 włącznie.

LabelStatus

Możliwe stany etykiety.

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 Etykieta jest włączona.
REMOVED Etykieta została usunięta.

TextLabel

Rodzaj etykiety wyświetlanej na kolorowym tle.

Zapis JSON 
{
  "backgroundColor": string,
  "description": string
}
Pola
backgroundColor

string

Kolor tła etykiety w formacie RGB. Ten ciąg musi być zgodny z wyrażeniem regularnym „^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$”. Uwaga: kolor tła może być niewidoczny na kontach menedżera.
description

string

Krótki opis etykiety. Maksymalna dozwolona liczba znaków to 200.

LanguageConstant

Język.

Zapis JSON 
{
  "resourceName": string,
  "id": string,
  "code": string,
  "name": string,
  "targetable": boolean
}
Pola
resourceName

string

Nazwa zasobu stałej języka. Nazwy zasobów stałych języka mają postać:

languageConstants/{criterionId}
id

string (int64 format)

Identyfikator stałej języka.
code

string

Kod języka, np. „en_US”, „en_AU”, „es”, „fr” itp.
name

string

pełna nazwa języka w języku angielskim, na przykład „angielski (USA)”, „hiszpański” itp.;
targetable

boolean

Określa, czy na język można kierować reklamy.

LocationView

Widok lokalizacji zawiera podsumowanie skuteczności kampanii według kryterium lokalizacji.

Zapis JSON 
{
  "resourceName": string
}
Pola
resourceName

string

Nazwa zasobu widoku lokalizacji. Nazwy zasobów widoku lokalizacji mają postać:

customers/{customerId}/locationViews/{campaign_id}~{criterionId}

ProductBiddingCategoryConstant

Kategoria określania stawek za produkt.

Zapis JSON 
{
  "resourceName": string,
  "level": enum (ProductBiddingCategoryLevel),
  "status": enum (ProductBiddingCategoryStatus),
  "id": string,
  "countryCode": string,
  "productBiddingCategoryConstantParent": string,
  "languageCode": string,
  "localizedName": string
}
Pola
resourceName

string

Nazwa zasobu kategorii ustalania stawek za produkt. Nazwy zasobów kategorii ustalania stawek za produkt mają postać:

productBiddingCategoryConstants/{countryCode}~{level}~{id}
level

enum (ProductBiddingCategoryLevel)

Poziom kategorii ustalania stawek za produkt.
status

enum (ProductBiddingCategoryStatus)

Stan kategorii ustalania stawek dla produktu.
id

string (int64 format)

Identyfikator kategorii ustalania stawek dla produktu.

Jest on odpowiednikiem identyfikatora google_product_category [kategoria_produktów_google] zgodnie z opisem w tym artykule: https://support.google.com/merchants/answer/6324436.
countryCode

string

Dwuliterowy kod kraju powiązany z kategorią ustalania stawek produktu.
productBiddingCategoryConstantParent

string

Nazwa zasobu nadrzędnej kategorii ustalania stawek produktu.
languageCode

string

Kod języka kategorii ustalania stawek za produkt.
localizedName

string

Wyświetlaj wartość kategorii ustalania stawek za produkt zlokalizowaną zgodnie z kodem languageCode.

ProductBiddingCategoryLevel

Wyliczenie opisujące poziom kategorii ustalania stawek za produkt.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
LEVEL1 Poziom 1.
LEVEL2 Poziom 2.
LEVEL3 Poziom 3.
LEVEL4 Poziom 4.
LEVEL5 Poziom 5.

ProductBiddingCategoryStatus

Wyliczenie opisujące stan kategorii ustalania stawek za produkt.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
ACTIVE Kategoria jest aktywna i można jej używać do określania stawek.
OBSOLETE Kategoria jest nieaktualna. Dane są używane tylko na potrzeby raportowania.

ProductGroupView

Widok grupy produktów.

Zapis JSON 
{
  "resourceName": string
}
Pola
resourceName

string

Nazwa zasobu widoku grupy produktów. Nazwy zasobów widoku grupy produktów mają postać:

customers/{customerId}/productGroupViews/{ad_group_id}~{criterionId}

ShoppingPerformanceView

Widok skuteczności zakupów. Wyświetla statystyki kampanii produktowej zbiorcze na kilku poziomach wymiarów produktów. Wartości wymiarów produktów z Merchant Center, np. marka, kategoria, atrybuty niestandardowe, stan produktu i typ produktu, będą odzwierciedlać stan każdego wymiaru na dzień i godzinę zarejestrowania odpowiedniego zdarzenia.

Zapis JSON 
{
  "resourceName": string
}
Pola
resourceName

string

Nazwa zasobu widoku skuteczności w Zakupach Google. Nazwy zasobów widoku skuteczności zakupów mają postać: customers/{customerId}/shoppingPerformanceView

UserList

Lista użytkowników. Jest to lista użytkowników, na których klient może kierować reklamy.

Zapis JSON 
{
  "resourceName": string,
  "type": enum (UserListType),
  "id": string,
  "name": string
}
Pola
resourceName

string

Nazwa zasobu listy użytkowników. Nazwy zasobów list użytkowników mają postać:

customers/{customerId}/userLists/{user_list_id}
type

enum (UserListType)

Typ tej listy.

To pole jest tylko do odczytu.
id

string (int64 format)

Identyfikator listy użytkowników.
name

string

Nazwa tej listy użytkowników. W zależności od przyczyny_dostępu nazwa listy użytkowników może nie być unikalna (na przykład, jeśli access_reason=SHARED)

UserListType

Wyliczenie zawierające możliwe typy list użytkownikó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.
REMARKETING UserList przedstawiona jako zbiór typów konwersji.
LOGICAL Lista użytkowników przedstawiana jako połączenie innych list i zainteresowań użytkowników.
EXTERNAL_REMARKETING Lista użytkowników utworzona na platformie Google Ad Manager.
RULE_BASED Lista użytkowników powiązana z regułą.
SIMILAR UserList z użytkownikami podobnymi do użytkowników innej listy.
CRM_BASED Lista użytkowników zawierająca własne dane z systemu CRM przekazane przez reklamodawcę w postaci e-maili lub innych formatów.

WebpageView

Widok strony internetowej.

Zapis JSON 
{
  "resourceName": string
}
Pola
resourceName

string

Nazwa zasobu widoku strony internetowej. Nazwy zasobów wyświetleń stron internetowych mają postać:

customers/{customerId}/webpageViews/{ad_group_id}~{criterionId}

Wejdź na

Wizyta.

Zapis JSON 
{
  "resourceName": string,
  "id": string,
  "criterionId": string,
  "merchantId": string,
  "adId": string,
  "clickId": string,
  "visitDateTime": string,
  "productId": string,
  "productChannel": enum (ProductChannel),
  "productLanguageCode": string,
  "productStoreId": string,
  "productCountryCode": string,
  "assetId": string,
  "assetFieldType": enum (AssetFieldType)
}
Pola
resourceName

string

Nazwa zasobu wizyty. Nazwy zasobów wizyt mają postać:

customers/{customerId}/visits/{ad_group_id}~{criterionId}~{ds_visit_id}
id

string (int64 format)

Identyfikator wizyty.
criterionId

string (int64 format)

Identyfikator słowa kluczowego w Search Ads 360. Wartość 0 oznacza, że słowo kluczowe nie jest przypisane.
merchantId

string (int64 format)

Identyfikator konta asortymentowego Search Ads 360 zawierający kliknięty produkt. Search Ads 360 generuje ten identyfikator po połączeniu z nią konta asortymentowego.
adId

string (int64 format)

Identyfikator reklamy. Wartość 0 oznacza, że reklama nie jest przypisana.
clickId

string

Unikalny ciąg znaków dla każdej wizyty przekazywany do strony docelowej jako parametr adresu URL identyfikatora kliknięcia.
visitDateTime

string

Sygnatura czasowa zdarzenia wizyty. Sygnatura czasowa jest podana w strefie czasowej klienta i w formacie „rrrr-MM-dd GG:mm:ss”.
productId

string

Identyfikator klikniętego produktu.
productChannel

enum (ProductChannel)

Kanał sprzedaży produktu, który został kliknięty: online lub lokalny.
productLanguageCode

string

Język (ISO-639-1) ustawiony dla pliku danych Merchant Center zawierającego dane produktu.
productStoreId

string

Sklep w reklamie lokalnego asortymentu produktów, w której użytkownik kliknął reklamę. Powinny one odpowiadać identyfikatorom sklepu używanym w Twoim pliku danych o produktach dostępnych lokalnie.
productCountryCode

string

Kraj (w formacie ISO-3166) zarejestrowany w pliku danych o asortymencie zawierającym kliknięty produkt.
assetId

string (int64 format)

Identyfikator zasobu, z którym nastąpiła interakcja podczas wizyty.
assetFieldType

enum (AssetFieldType)

Typ pola komponentu zdarzenia wizyty.

ProductChannel

Wartość Enum opisująca miejscowość oferty produktu.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
ONLINE Produkt jest sprzedawany online.
LOCAL Produkt jest sprzedawany w lokalnych sklepach.

Konwersje

Konwersja.

Zapis JSON 
{
  "resourceName": string,
  "id": string,
  "criterionId": string,
  "merchantId": string,
  "adId": string,
  "clickId": string,
  "visitId": string,
  "advertiserConversionId": string,
  "productId": string,
  "productChannel": enum (ProductChannel),
  "productLanguageCode": string,
  "productStoreId": string,
  "productCountryCode": string,
  "attributionType": enum (AttributionType),
  "conversionDateTime": string,
  "conversionLastModifiedDateTime": string,
  "conversionVisitDateTime": string,
  "conversionQuantity": string,
  "conversionRevenueMicros": string,
  "floodlightOriginalRevenue": string,
  "floodlightOrderId": string,
  "status": enum (ConversionStatus),
  "assetId": string,
  "assetFieldType": enum (AssetFieldType)
}
Pola
resourceName

string

Nazwa zasobu konwersji. Nazwy zasobów konwersji mają postać:

customers/{customerId}/conversions/{ad_group_id}~{criterionId}~{ds_conversion_id}
id

string (int64 format)

Identyfikator konwersji
criterionId

string (int64 format)

Identyfikator kryterium Search Ads 360. Wartość 0 oznacza, że kryterium nie jest przypisane.
merchantId

string (int64 format)

Identyfikator konta asortymentowego Search Ads 360 zawierający kliknięty produkt. Search Ads 360 generuje ten identyfikator po połączeniu z nią konta asortymentowego.
adId

string (int64 format)

Identyfikator reklamy. Wartość 0 oznacza, że reklama nie jest przypisana.
clickId

string

Niepowtarzalny ciąg znaków reprezentujący wizytę, do której przypisano konwersję, przekazywany do strony docelowej jako parametr adresu URL identyfikatora kliknięcia.
visitId

string (int64 format)

Identyfikator wizyty w Search Ads 360, do której jest przypisana konwersja.
advertiserConversionId

string

W przypadku konwersji offline jest to identyfikator podany przez reklamodawców. Jeśli reklamodawca nie poda identyfikatora, wygeneruje go Search Ads 360. W przypadku konwersji online wartość ta jest równa kolumnie id lub floodlightOrderId w zależności od instrukcji Floodlight reklamodawcy.
productId

string

Identyfikator klikniętego produktu.
productChannel

enum (ProductChannel)

Kanał sprzedaży produktu, który został kliknięty: online lub lokalny.
productLanguageCode

string

Język (ISO-639-1) ustawiony dla pliku danych Merchant Center zawierającego dane produktu.
productStoreId

string

Sklep w reklamie lokalnego asortymentu produktów, w której użytkownik kliknął reklamę. Powinny one odpowiadać identyfikatorom sklepu używanym w Twoim pliku danych o produktach dostępnych lokalnie.
productCountryCode

string

Kraj (w formacie ISO-3166) zarejestrowany w pliku danych o asortymencie zawierającym kliknięty produkt.
attributionType

enum (AttributionType)

Do czego przypisana jest konwersja: wizyta lub słowo kluczowe+reklama.
conversionDateTime

string

Sygnatura czasowa zdarzenia konwersji.
conversionLastModifiedDateTime

string

Sygnatura czasowa ostatniej modyfikacji konwersji.
conversionVisitDateTime

string

Sygnatura czasowa wizyty, do której przypisano konwersję.
conversionQuantity

string (int64 format)

Liczba produktów zarejestrowanych przez konwersję, określona przez parametr qty url. Reklamodawca jest odpowiedzialny za dynamiczne wypełnianie parametru (np. liczbę sprzedanych produktów w ramach konwersji). W przeciwnym razie domyślna wartość to 1.
conversionRevenueMicros

string (int64 format)

Skorygowane przychody w mikro dla zdarzenia konwersji. Będzie ona zawsze podana w walucie konta wyświetlania reklam.
floodlightOriginalRevenue

string (int64 format)

Pierwotne, niezmienione przychody powiązane ze zdarzeniem Floodlight (w walucie bieżącego raportu) przed zmianami w instrukcji waluty Floodlight.
floodlightOrderId

string

Identyfikator zamówienia Floodlight podany przez reklamodawcę na potrzeby konwersji.
status

enum (ConversionStatus)

Stan konwersji: WŁĄCZONA lub USUNIĘTA.
assetId

string (int64 format)

Identyfikator zasobu, z którym nastąpiła interakcja podczas zdarzenia konwersji.
assetFieldType

enum (AssetFieldType)

Typ pola zasobu zdarzenia konwersji.

AttributionType

Typ atrybucji konwersji w Search Ads 360

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
VISIT Konwersja jest przypisywana do wizyty.
CRITERION_AD Konwersja jest przypisywana do pary kryterium i reklam.

ConversionStatus

Możliwe stany konwersji.

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 Konwersja jest włączona.
REMOVED Konwersja została usunięta.

Wskaźniki

Dane wskaźników.

Zapis JSON 
{
  "allConversionsValueByConversionDate": number,
  "allConversionsByConversionDate": number,
  "conversionCustomMetrics": [
    {
      object (Value)
    }
  ],
  "conversionsValueByConversionDate": number,
  "conversionsByConversionDate": number,
  "historicalCreativeQualityScore": enum (QualityScoreBucket),
  "historicalLandingPageQualityScore": enum (QualityScoreBucket),
  "historicalSearchPredictedCtr": enum (QualityScoreBucket),
  "interactionEventTypes": [
    enum (InteractionEventType)
  ],
  "rawEventConversionMetrics": [
    {
      object (Value)
    }
  ],
  "absoluteTopImpressionPercentage": number,
  "allConversionsFromInteractionsRate": number,
  "allConversionsValue": number,
  "allConversions": number,
  "allConversionsValuePerCost": number,
  "allConversionsFromClickToCall": number,
  "allConversionsFromDirections": number,
  "allConversionsFromInteractionsValuePerInteraction": number,
  "allConversionsFromMenu": number,
  "allConversionsFromOrder": number,
  "allConversionsFromOtherEngagement": number,
  "allConversionsFromStoreVisit": number,
  "visits": number,
  "allConversionsFromStoreWebsite": number,
  "averageCost": number,
  "averageCpc": number,
  "averageCpm": number,
  "clicks": string,
  "contentBudgetLostImpressionShare": number,
  "contentImpressionShare": number,
  "contentRankLostImpressionShare": number,
  "conversionsFromInteractionsRate": number,
  "clientAccountConversionsValue": number,
  "conversionsValuePerCost": number,
  "conversionsFromInteractionsValuePerInteraction": number,
  "clientAccountConversions": number,
  "costMicros": string,
  "costPerAllConversions": number,
  "costPerConversion": number,
  "costPerCurrentModelAttributedConversion": number,
  "crossDeviceConversions": number,
  "crossDeviceConversionsValue": number,
  "ctr": number,
  "conversions": number,
  "conversionsValue": number,
  "historicalQualityScore": string,
  "impressions": string,
  "interactionRate": number,
  "interactions": string,
  "invalidClickRate": number,
  "invalidClicks": string,
  "mobileFriendlyClicksPercentage": number,
  "searchAbsoluteTopImpressionShare": number,
  "searchBudgetLostAbsoluteTopImpressionShare": number,
  "searchBudgetLostImpressionShare": number,
  "searchBudgetLostTopImpressionShare": number,
  "searchClickShare": number,
  "searchExactMatchImpressionShare": number,
  "searchImpressionShare": number,
  "searchRankLostAbsoluteTopImpressionShare": number,
  "searchRankLostImpressionShare": number,
  "searchRankLostTopImpressionShare": number,
  "searchTopImpressionShare": number,
  "topImpressionPercentage": number,
  "valuePerAllConversions": number,
  "valuePerAllConversionsByConversionDate": number,
  "valuePerConversion": number,
  "valuePerConversionsByConversionDate": number,
  "clientAccountViewThroughConversions": string,
  "clientAccountCrossSellCostOfGoodsSoldMicros": string,
  "crossSellCostOfGoodsSoldMicros": string,
  "clientAccountCrossSellGrossProfitMicros": string,
  "crossSellGrossProfitMicros": string,
  "clientAccountCrossSellRevenueMicros": string,
  "crossSellRevenueMicros": string,
  "clientAccountCrossSellUnitsSold": number,
  "crossSellUnitsSold": number,
  "clientAccountLeadCostOfGoodsSoldMicros": string,
  "leadCostOfGoodsSoldMicros": string,
  "clientAccountLeadGrossProfitMicros": string,
  "leadGrossProfitMicros": string,
  "clientAccountLeadRevenueMicros": string,
  "leadRevenueMicros": string,
  "clientAccountLeadUnitsSold": number,
  "leadUnitsSold": number
}
Pola
allConversionsValueByConversionDate

number

Wartość wszystkich konwersji. Jeśli wybierzesz tę kolumnę z datą, wartości w kolumnie „Data” będą oznaczać datę konwersji. Szczegółowe informacje o kolumnach „by_conversion_date” znajdziesz na https://support.google.com/sa360/answer/9250611.
allConversionsByConversionDate

number

Łączna liczba konwersji. Obejmuje to wszystkie konwersje niezależnie od wartości includeInConversionMetric. Jeśli wybierzesz tę kolumnę z datą, wartości w kolumnie „Data” będą oznaczać datę konwersji. Szczegółowe informacje o kolumnach „by_conversion_date” znajdziesz na https://support.google.com/sa360/answer/9250611.
conversionCustomMetrics[]

object (Value)

Niestandardowe dane konwersji.
conversionsValueByConversionDate

number

Suma wartości konwersji z możliwością określenia stawki według daty konwersji. Jeśli wybierzesz tę kolumnę z datą, wartości w kolumnie „Data” będą oznaczać datę konwersji.
conversionsByConversionDate

number

Suma konwersji według daty konwersji dla typów konwersji z możliwością określenia stawki. Wartość może być cząstkowa ze względu na modelowanie atrybucji. Jeśli wybierzesz tę kolumnę z datą, wartości w kolumnie „Data” będą oznaczać datę konwersji.
historicalCreativeQualityScore

enum (QualityScoreBucket)

Historyczny wynik jakości kreacji.
historicalLandingPageQualityScore

enum (QualityScoreBucket)

Jakość historycznej oceny jakości strony docelowej.
historicalSearchPredictedCtr

enum (QualityScoreBucket)

Historyczny przewidywany współczynnik klikalności (CTR) w wyszukiwarce.
interactionEventTypes[]

enum (InteractionEventType)

Rodzaje płatnych i bezpłatnych interakcji.
rawEventConversionMetrics[]

object (Value)

Nieprzetworzone dane o konwersjach zdarzenia.
absoluteTopImpressionPercentage

number

Udział w wyświetleniach na najwyższej pozycji na stronie z sieci wyszukiwania to odsetek wyświetleń reklamy w sieci wyszukiwania na najbardziej widocznej pozycji na stronie wyników wyszukiwania.
allConversionsFromInteractionsRate

number

Wszystkie konwersje z interakcji (w przeciwieństwie do konwersji po obejrzeniu) podzielone przez liczbę interakcji z reklamą.
allConversionsValue

number

Wartość wszystkich konwersji.
allConversions

number

Łączna liczba konwersji. Obejmuje to wszystkie konwersje niezależnie od wartości includeInConversionMetric.
allConversionsValuePerCost

number

Wartość wszystkich konwersji podzielona przez łączny koszt interakcji z reklamą (np. kliknięć reklam tekstowych lub obejrzeń reklam wideo).
allConversionsFromClickToCall

number

Tyle razy użytkownicy kliknęli przycisk „Zadzwoń”, aby zadzwonić do sklepu w trakcie lub po kliknięciu reklamy. Ten numer nie zawiera informacji o tym, czy połączenie zostało odebrane ani ile trwało.

Te dane dotyczą tylko elementów w pliku danych.
allConversionsFromDirections

number

Tyle razy użytkownicy kliknęli przycisk „Wyznacz trasę”, aby wyznaczyć trasę dojazdu do sklepu po kliknięciu reklamy.

Te dane dotyczą tylko elementów w pliku danych.
allConversionsFromInteractionsValuePerInteraction

number

Wartość wszystkich konwersji z interakcji podzielona przez łączną liczbę interakcji.
allConversionsFromMenu

number

Tyle razy użytkownicy kliknęli link, aby wyświetlić menu sklepu po kliknięciu reklamy.

Te dane dotyczą tylko elementów w pliku danych.
allConversionsFromOrder

number

Tyle razy użytkownicy złożyli zamówienie w sklepie po kliknięciu reklamy.

Te dane dotyczą tylko elementów w pliku danych.
allConversionsFromOtherEngagement

number

Tyle razy użytkownicy zrealizowali inną konwersję (np. opublikowali opinię albo zapisali lokalizację sklepu) po kliknięciu reklamy.

Te dane dotyczą tylko elementów w pliku danych.
allConversionsFromStoreVisit

number

Szacunkowa liczba wizyt użytkowników w sklepie po kliknięciu reklamy.

Te dane dotyczą tylko elementów w pliku danych.
visits

number

Kliknięcia zarejestrowane przez Search Ads 360 i przekazane na stronę docelową reklamodawcy.
allConversionsFromStoreWebsite

number

Tyle razy użytkownicy zostali przekierowani na adres URL sklepu po kliknięciu reklamy.

Te dane dotyczą tylko elementów w pliku danych.
averageCost

number

Średnia kwota, jaką płacisz za interakcję. To iloraz łącznego kosztu reklam i całkowitej liczby interakcji.
averageCpc

number

Łączny koszt wszystkich kliknięć podzielony przez łączną liczbę uzyskanych kliknięć. Te dane mają wartość pieniężną i domyślnie zwracają ją w walucie klienta. Parametr metric_currency znajdziesz na https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
averageCpm

number

Średni koszt tysiąca wyświetleń (CPM). Te dane mają wartość pieniężną i domyślnie zwracają ją w walucie klienta. Parametr metric_currency znajdziesz na https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
clicks

string (int64 format)

Liczba kliknięć.
contentBudgetLostImpressionShare

number

Szacowany odsetek przypadków, w których reklama mogła się wyświetlić w sieci reklamowej, ale tak się nie stało z powodu zbyt niskiego budżetu. Uwaga: utracony udział w wyświetleniach przez budżet treści jest raportowany w zakresie od 0 do 0,9. Każda wartość powyżej 0,9 jest zgłaszana jako 0,9001.
contentImpressionShare

number

Liczba otrzymanych wyświetleń w sieci reklamowej podzielona przez szacunkową liczbę wyświetleń, które można było uzyskać. Uwaga: udział w wyświetleniach w sieci reklamowej jest raportowany w zakresie od 0,1 do 1. Każda wartość mniejsza niż 0,1 jest zgłaszana jako 0,0999.
contentRankLostImpressionShare

number

Szacowany odsetek wyświetleń w sieci reklamowej, których reklamy nie uzyskały z powodu niskiego rankingu reklamy. Uwaga: utracony udział w wyświetleniach w rankingu treści jest raportowany w zakresie od 0 do 0,9. Każda wartość powyżej 0,9 jest zgłaszana jako 0,9001.
conversionsFromInteractionsRate

number

Średnia liczba konwersji z możliwością określenia stawki (z interakcji) na odpowiednią interakcję w ramach konwersji. Pokazuje, jak często, średnio licząc, interakcja z reklamą prowadzi do konwersji z możliwością określenia stawki.
clientAccountConversionsValue

number

Wartość konwersji na koncie klienta. Dotyczy to tylko działań powodujących konwersję, w przypadku których atrybut includeInClientAccountKonwersjeMetric ma wartość Prawda. Jeśli korzystasz z określania stawek na podstawie konwersji, Twoje strategie ustalania stawek zostaną zoptymalizowane pod kątem tych konwersji.
conversionsValuePerCost

number

Wartość konwersji z możliwością określenia stawki podzielona przez łączny koszt interakcji odpowiednich do konwersji.
conversionsFromInteractionsValuePerInteraction

number

Wartość konwersji z interakcji podzielona przez liczbę interakcji z reklamą. Dotyczy to tylko działań powodujących konwersję, w przypadku których atrybut includeInConversionMetric ma wartość Prawda. Jeśli korzystasz z określania stawek na podstawie konwersji, Twoje strategie ustalania stawek zostaną zoptymalizowane pod kątem tych konwersji.
clientAccountConversions

number

Liczba konwersji na koncie klienta. Dotyczy to tylko działań powodujących konwersję, w przypadku których atrybut includeInClientAccountKonwersjeMetric ma wartość Prawda. Jeśli korzystasz z określania stawek na podstawie konwersji, Twoje strategie ustalania stawek zostaną zoptymalizowane pod kątem tych konwersji.
costMicros

string (int64 format)

Suma kosztów kliknięcia (CPC) i kosztu tysiąca wyświetleń (CPM) w danym okresie. Te dane mają wartość pieniężną i domyślnie zwracają ją w walucie klienta. Parametr metric_currency znajdziesz na https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
costPerAllConversions

number

Koszt interakcji z reklamą podzielony przez łączną liczbę konwersji.
costPerConversion

number

Średni kwalifikujący się koszt konwersji z możliwością określenia stawki.
costPerCurrentModelAttributedConversion

number

Koszt interakcji z reklamą podzielony przez liczbę konwersji przypisanych w bieżącym modelu. Dotyczy to tylko działań powodujących konwersję, w przypadku których atrybut includeInConversionMetric ma wartość Prawda. Jeśli korzystasz z określania stawek na podstawie konwersji, Twoje strategie ustalania stawek zostaną zoptymalizowane pod kątem tych konwersji.
crossDeviceConversions

number

Konwersje polegające na tym, że klient kliknie reklamę na jednym urządzeniu, a potem dokona konwersji na innym urządzeniu lub w innej przeglądarce. Konwersje na różnych urządzeniach są już uwzględnione w kolumnie Wszystkie konwersje.
crossDeviceConversionsValue

number

Suma wartości konwersji na różnych urządzeniach.
ctr

number

Liczba kliknięć reklamy (kliknięcia) podzielona przez liczbę jej wyświetleń.
conversions

number

Liczba konwersji. Dotyczy to tylko działań powodujących konwersję, w przypadku których atrybut includeInConversionMetric ma wartość Prawda. Jeśli korzystasz z określania stawek na podstawie konwersji, Twoje strategie ustalania stawek zostaną zoptymalizowane pod kątem tych konwersji.
conversionsValue

number

Suma wartości konwersji uwzględnionych w polu „Konwersje”. Te dane są przydatne tylko w przypadku, gdy wpiszesz wartość działań powodujących konwersję.
historicalQualityScore

string (int64 format)

Historyczny wynik jakości.
impressions

string (int64 format)

Liczba wyświetleń reklamy na stronie wyników wyszukiwania lub w witrynie w sieci Google.
interactionRate

number

Jak często użytkownicy po zobaczeniu reklamy wchodzą z nią w interakcję. Jest to liczba interakcji podzielona przez liczbę wyświetleń reklamy.
interactions

string (int64 format)

Liczba interakcji. Interakcja to główne działanie użytkownika związane z takim formatem reklamy: kliknięciami reklam tekstowych i produktowych, wyświetleniami reklam wideo itd.
invalidClickRate

number

Odsetek odfiltrowanych kliknięć z łącznej liczby kliknięć (odfiltrowanych i nieodfiltrowanych) w okresie raportowania.
invalidClicks

string (int64 format)

Liczba kliknięć, które Google uznaje za nielegalne i nie pobiera za nie opłat.
mobileFriendlyClicksPercentage

number

Odsetek kliknięć z komórek, które prowadzą na stronę dostosowaną do komórek.
searchAbsoluteTopImpressionShare

number

Odsetek wyświetleń reklamy produktowej lub reklamy w wyszukiwarce klienta na najwyższej pozycji na stronie w przypadku kampanii produktowych. Więcej informacji znajdziesz na stronie https://support.google.com/sa360/answer/9566729. Każda wartość mniejsza niż 0,1 jest zgłaszana jako 0,0999.
searchBudgetLostAbsoluteTopImpressionShare

number

Liczba określająca, jak często Twoja reklama nie była pierwszą reklamą na liście wyników wyszukiwania z powodu niskiego budżetu. Uwaga: utracony udział w wyświetleniach na najwyższej pozycji na stronie (budżet) jest raportowany w zakresie od 0 do 0,9. Każda wartość powyżej 0,9 jest zgłaszana jako 0,9001.
searchBudgetLostImpressionShare

number

Przybliżony odsetek przypadków, gdy reklama mogła wyświetlić się w sieci wyszukiwania, ale tak się nie stało z powodu zbyt niskiego budżetu. Uwaga: utracony udział w wyświetleniach z budżetu w sieci wyszukiwania jest raportowany w zakresie od 0 do 0,9. Każda wartość powyżej 0,9 jest zgłaszana jako 0,9001.
searchBudgetLostTopImpressionShare

number

Liczba określająca, jak często Twoja reklama nie wyświetliła się obok najlepszych bezpłatnych wyników wyszukiwania z powodu niskiego budżetu. Uwaga: utracony udział w wyświetleniach u góry strony z budżetu w sieci wyszukiwania jest raportowany w zakresie od 0 do 0,9. Każda wartość powyżej 0,9 jest zgłaszana jako 0,9001.
searchClickShare

number

Liczba kliknięć otrzymanych w sieci wyszukiwania podzielona przez szacowaną liczbę kliknięć możliwych do uzyskania. Uwaga: udział w kliknięciach z sieci wyszukiwania jest raportowany w zakresie od 0,1 do 1. Każda wartość mniejsza niż 0,1 jest zgłaszana jako 0,0999.
searchExactMatchImpressionShare

number

Liczba uzyskanych wyświetleń podzielona przez szacunkową liczbę wyświetleń możliwych do uzyskania w sieci wyszukiwania dla wyszukiwanych haseł, które dokładnie pasowały do Twoich słów kluczowych (lub były ich bliskimi odmianami), niezależnie od typów dopasowania słów kluczowych. Uwaga: udział w wyświetleniach przy dopasowaniu ścisłym z sieci wyszukiwania jest raportowany w zakresie od 0,1 do 1. Każda wartość mniejsza niż 0,1 jest zgłaszana jako 0,0999.
searchImpressionShare

number

Liczba otrzymanych wyświetleń w sieci wyszukiwania podzielona przez szacunkową liczbę wyświetleń możliwych do uzyskania. Uwaga: udział w wyświetleniach z sieci wyszukiwania jest raportowany w zakresie od 0,1 do 1. Każda wartość mniejsza niż 0,1 jest zgłaszana jako 0,0999.
searchRankLostAbsoluteTopImpressionShare

number

Liczba określająca, jak często Twoja reklama nie była pierwszą reklamą na liście wyników wyszukiwania z powodu niskiego rankingu reklamy. Uwaga: utrata udziału w wyświetleniach na najwyższej pozycji na stronie w wyszukiwarce jest podawana w zakresie od 0 do 0,9. Każda wartość powyżej 0,9 jest zgłaszana jako 0,9001.
searchRankLostImpressionShare

number

Szacowany odsetek wyświetleń w sieci wyszukiwania, których reklamy nie uzyskały z powodu niskiego rankingu reklamy. Uwaga: utracony udział w wyświetleniach w rankingu w wyszukiwarce jest raportowany w zakresie od 0 do 0,9. Każda wartość powyżej 0,9 jest zgłaszana jako 0,9001.
searchRankLostTopImpressionShare

number

Liczba określająca, jak często Twoja reklama nie wyświetliła się obok najlepszych bezpłatnych wyników wyszukiwania z powodu niskiego rankingu reklamy. Uwaga: utracony udział w wyświetleniach u góry strony w rankingu wyszukiwania jest raportowany w zakresie od 0 do 0,9. Każda wartość powyżej 0,9 jest zgłaszana jako 0,9001.
searchTopImpressionShare

number

Liczba uzyskanych wyświetleń najpopularniejszych reklam w porównaniu z szacunkową liczbą możliwych wyświetleń najlepszych reklam. Uwaga: udział w wyświetleniach u góry strony z sieci wyszukiwania jest raportowany w zakresie od 0,1 do 1. Każda wartość mniejsza niż 0,1 jest zgłaszana jako 0,0999.

Reklamy u góry strony znajdują się zwykle nad najlepszymi bezpłatnymi wynikami wyszukiwania, jednak w przypadku niektórych zapytań mogą się wyświetlać pod nimi.
topImpressionPercentage

number

Odsetek wyświetleń reklam obok najwyższych bezpłatnych wyników wyszukiwania.
valuePerAllConversions

number

Wartość wszystkich konwersji podzielona przez liczbę wszystkich konwersji.
valuePerAllConversionsByConversionDate

number

Wartość wszystkich konwersji podzielona przez liczbę wszystkich konwersji. Jeśli wybierzesz tę kolumnę z datą, wartości w kolumnie „Data” będą oznaczać datę konwersji. Szczegółowe informacje o kolumnach „by_conversion_date” znajdziesz na https://support.google.com/sa360/answer/9250611.
valuePerConversion

number

Wartość konwersji z możliwością określenia stawki podzielona przez liczbę takich konwersji. Wskazuje średnią wartość każdej konwersji z możliwością określenia stawki.
valuePerConversionsByConversionDate

number

Wartość konwersji z możliwością określenia stawki według daty konwersji podzielona przez liczbę konwersji z możliwością określenia stawki według daty konwersji. Pokazuje, ile jest średnio warta każda konwersja z możliwością określenia stawki (wg daty konwersji). Jeśli wybierzesz tę kolumnę z datą, wartości w kolumnie „Data” będą oznaczać datę konwersji.
clientAccountViewThroughConversions

string (int64 format)

Łączna liczba konwersji po wyświetleniu. Dzieje się tak, gdy klient widzi reklamę graficzną lub multimedialną, a potem dokonuje konwersji w Twojej witrynie bez wchodzenia z nią w interakcję (np. kliknięcia).
clientAccountCrossSellCostOfGoodsSoldMicros

string (int64 format)

Koszt własny sprzedaży krzyżowej na koncie klienta to łączny koszt produktów sprzedanych dzięki reklamom innego produktu. Jak to działa: raportujesz konwersje z danymi koszyka w przypadku ukończonych zakupów w Twojej witrynie. Jeśli reklama, z którą nastąpiła interakcja przed zakupem, ma powiązany produkt (patrz Reklamy produktowe), jest on produktem reklamowanym. Każdy produkt uwzględniony w zamówieniu, które złożył klient, jest produktem sprzedanym. Jeśli te produkty się różnią, uznajemy to za sprzedaż krzyżową. Koszt własny sprzedaży krzyżowej to łączny koszt sprzedanych produktów, które nie były reklamowane. Przykład: użytkownik kliknął reklamę produktową kapelusza, a potem kupił ten kapelusz oraz koszulę. Koszt własny sprzedaży kapelusza wynosi 3 zł, a koszuli – 5 zł. Koszt własny sprzedaży krzyżowej tego zamówienia wynosi 5 zł. Te dane są dostępne tylko wtedy, gdy rejestrujesz konwersje z danymi koszyka. Te dane mają wartość pieniężną i domyślnie zwracają ją w walucie klienta. Parametr metric_currency znajdziesz na https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
crossSellCostOfGoodsSoldMicros

string (int64 format)

Koszt własny sprzedaży krzyżowej to łączny koszt produktów sprzedanych dzięki reklamom innego produktu. Jak to działa: raportujesz konwersje z danymi koszyka w przypadku ukończonych zakupów w Twojej witrynie. Jeśli reklama, z którą nastąpiła interakcja przed zakupem, ma powiązany produkt (patrz Reklamy produktowe), jest on produktem reklamowanym. Każdy produkt uwzględniony w zamówieniu, które złożył klient, jest produktem sprzedanym. Jeśli te produkty się różnią, uznajemy to za sprzedaż krzyżową. Koszt własny sprzedaży krzyżowej to łączny koszt sprzedanych produktów, które nie były reklamowane. Przykład: użytkownik kliknął reklamę produktową kapelusza, a potem kupił ten kapelusz oraz koszulę. Koszt własny sprzedaży kapelusza wynosi 3 zł, a koszuli – 5 zł. Koszt własny sprzedaży krzyżowej tego zamówienia wynosi 5 zł. Te dane są dostępne tylko wtedy, gdy rejestrujesz konwersje z danymi koszyka. Te dane mają wartość pieniężną i domyślnie zwracają ją w walucie klienta. Parametr metric_currency znajdziesz na https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
clientAccountCrossSellGrossProfitMicros

string (int64 format)

Zysk brutto ze sprzedaży krzyżowej na koncie klienta to zysk ze sprzedaży produktów uzyskany dzięki reklamowaniu innego produktu i pomniejszony o koszt własny sprzedaży. Jak to działa: raportujesz konwersje z danymi koszyka w przypadku ukończonych zakupów w Twojej witrynie. Jeśli reklama, z którą nastąpiła interakcja przed zakupem, ma powiązany produkt (patrz Reklamy produktowe), jest on produktem reklamowanym. Każdy produkt objęty przez transakcję zakupu jest produktem sprzedanym. Jeśli te produkty się różnią, uznajemy to za sprzedaż krzyżową. Zysk brutto ze sprzedaży krzyżowej to przychody uzyskane ze sprzedaży krzyżowej przypisanej Twoim reklamom i pomniejszone o koszt własny sprzedaży. Przykład: użytkownik kliknął reklamę produktową kapelusza, a potem kupił ten kapelusz oraz koszulę. Cena koszuli wynosi 20 zł, a jej koszt własny sprzedaży to 5 zł. W przypadku tego zamówienia zysk brutto ze sprzedaży krzyżowej wynosi 15 zł = 20 zł – 5 zł. Te dane są dostępne tylko wtedy, gdy rejestrujesz konwersje z danymi koszyka. Te dane mają wartość pieniężną i domyślnie zwracają ją w walucie klienta. Parametr metric_currency znajdziesz na https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
crossSellGrossProfitMicros

string (int64 format)

Zysk brutto ze sprzedaży krzyżowej to zysk ze sprzedaży produktów uzyskany dzięki reklamowaniu innego produktu i pomniejszony o koszt własny sprzedaży. Jak to działa: raportujesz konwersje z danymi koszyka w przypadku ukończonych zakupów w Twojej witrynie. Jeśli reklama, z którą nastąpiła interakcja przed zakupem, ma powiązany produkt (patrz Reklamy produktowe), jest on produktem reklamowanym. Każdy produkt objęty przez transakcję zakupu jest produktem sprzedanym. Jeśli te produkty się różnią, uznajemy to za sprzedaż krzyżową. Zysk brutto ze sprzedaży krzyżowej to przychody uzyskane ze sprzedaży krzyżowej przypisanej Twoim reklamom i pomniejszone o koszt własny sprzedaży. Przykład: użytkownik kliknął reklamę produktową kapelusza, a potem kupił ten kapelusz oraz koszulę. Cena koszuli wynosi 20 zł, a jej koszt własny sprzedaży to 5 zł. W przypadku tego zamówienia zysk brutto ze sprzedaży krzyżowej wynosi 15 zł = 20 zł – 5 zł. Te dane są dostępne tylko wtedy, gdy rejestrujesz konwersje z danymi koszyka. Te dane mają wartość pieniężną i domyślnie zwracają ją w walucie klienta. Parametr metric_currency znajdziesz na https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
clientAccountCrossSellRevenueMicros

string (int64 format)

Przychody ze sprzedaży krzyżowej na koncie klienta to łączna kwota przychodów ze sprzedaży produktów uzyskana dzięki reklamom innych produktów. Jak to działa: raportujesz konwersje z danymi koszyka w przypadku ukończonych zakupów w Twojej witrynie. Jeśli reklama, z którą nastąpiła interakcja przed zakupem, ma powiązany produkt (patrz Reklamy produktowe), jest on produktem reklamowanym. Każdy produkt uwzględniony w zamówieniu, które złożył klient, jest produktem sprzedanym. Jeśli te produkty się różnią, uznajemy to za sprzedaż krzyżową. Przychody ze sprzedaży krzyżowej to łączna wartość przychodów uzyskanych ze sprzedaży krzyżowej przypisanych do Twoich reklam. Przykład: użytkownik kliknął reklamę produktową kapelusza, a potem kupił ten kapelusz oraz koszulę. Kapelusz kosztował 10 zł, a koszulka 20 zł. Przychody ze sprzedaży krzyżowej tego zamówienia wynoszą 20 zł. Te dane są dostępne tylko wtedy, gdy rejestrujesz konwersje z danymi koszyka. Te dane mają wartość pieniężną i domyślnie zwracają ją w walucie klienta. Parametr metric_currency znajdziesz na https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
crossSellRevenueMicros

string (int64 format)

Przychody ze sprzedaży krzyżowej to łączna kwota przychodów ze sprzedaży produktów uzyskana dzięki reklamom innych produktów. Jak to działa: raportujesz konwersje z danymi koszyka w przypadku ukończonych zakupów w Twojej witrynie. Jeśli reklama, z którą nastąpiła interakcja przed zakupem, ma powiązany produkt (patrz Reklamy produktowe), jest on produktem reklamowanym. Każdy produkt uwzględniony w zamówieniu, które złożył klient, jest produktem sprzedanym. Jeśli te produkty się różnią, uznajemy to za sprzedaż krzyżową. Przychody ze sprzedaży krzyżowej to łączna wartość przychodów uzyskanych ze sprzedaży krzyżowej przypisanych do Twoich reklam. Przykład: użytkownik kliknął reklamę produktową kapelusza, a potem kupił ten kapelusz oraz koszulę. Kapelusz kosztował 10 zł, a koszulka 20 zł. Przychody ze sprzedaży krzyżowej tego zamówienia wynoszą 20 zł. Te dane są dostępne tylko wtedy, gdy rejestrujesz konwersje z danymi koszyka. Te dane mają wartość pieniężną i domyślnie zwracają ją w walucie klienta. Parametr metric_currency znajdziesz na https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
clientAccountCrossSellUnitsSold

number

Pozycje sprzedane dzięki sprzedaży krzyżowej na koncie klienta to łączna liczba produktów sprzedanych dzięki reklamom innego produktu. Jak to działa: raportujesz konwersje z danymi koszyka w przypadku ukończonych zakupów w Twojej witrynie. Jeśli reklama, z którą nastąpiła interakcja przed zakupem, ma powiązany produkt (patrz Reklamy produktowe), jest on produktem reklamowanym. Każdy produkt uwzględniony w zamówieniu, które złożył klient, jest produktem sprzedanym. Jeśli te produkty się różnią, uznajemy to za sprzedaż krzyżową. Egzemplarze sprzedane krzyżowo to łączna liczba produktów sprzedanych dzięki sprzedaży krzyżowej w ramach wszystkich zamówień przypisanych Twoim reklamom. Przykład: użytkownik kliknął reklamę produktową kapelusza, a potem kupił ten kapelusz oraz koszulę i kurtkę. W przypadku tego zamówienia liczba pozycji sprzedanych dzięki sprzedaży krzyżowej wynosi 2. Te dane są dostępne tylko wtedy, gdy rejestrujesz konwersje z danymi koszyka.
crossSellUnitsSold

number

Egzemplarze sprzedane krzyżowo to łączna liczba produktów sprzedanych dzięki reklamom innego produktu. Jak to działa: raportujesz konwersje z danymi koszyka w przypadku ukończonych zakupów w Twojej witrynie. Jeśli reklama, z którą nastąpiła interakcja przed zakupem, ma powiązany produkt (patrz Reklamy produktowe), jest on produktem reklamowanym. Każdy produkt uwzględniony w zamówieniu, które złożył klient, jest produktem sprzedanym. Jeśli te produkty się różnią, uznajemy to za sprzedaż krzyżową. Egzemplarze sprzedane krzyżowo to łączna liczba produktów sprzedanych dzięki sprzedaży krzyżowej w ramach wszystkich zamówień przypisanych Twoim reklamom. Przykład: użytkownik kliknął reklamę produktową kapelusza, a potem kupił ten kapelusz oraz koszulę i kurtkę. W przypadku tego zamówienia liczba pozycji sprzedanych dzięki sprzedaży krzyżowej wynosi 2. Te dane są dostępne tylko wtedy, gdy rejestrujesz konwersje z danymi koszyka.
clientAccountLeadCostOfGoodsSoldMicros

string (int64 format)

Koszt własny potencjalnej sprzedaży na koncie klienta to łączny koszt produktów sprzedanych dzięki ich reklamowaniu. Jak to działa: raportujesz konwersje z danymi koszyka w przypadku ukończonych zakupów w Twojej witrynie. Jeśli reklama, z którą nastąpiła interakcja, jest powiązana z produktem (patrz Reklamy produktowe), jest on produktem reklamowanym. Każdy produkt uwzględniony w zamówieniu, które złożył klient, jest produktem sprzedanym. Jeśli reklamowane i sprzedane produkty pasują do siebie, ich koszt jest zaliczany do kosztu własnego potencjalnej sprzedaży. Przykład: użytkownik kliknął reklamę produktową kapelusza, a potem kupił ten kapelusz oraz koszulę. Koszt własny sprzedaży kapelusza wynosi 3 zł, a koszuli – 5 zł. W przypadku tego zamówienia potencjalny koszt własny sprzedaży wynosi 3 zł. Te dane są dostępne tylko wtedy, gdy rejestrujesz konwersje z danymi koszyka. Te dane mają wartość pieniężną i domyślnie zwracają ją w walucie klienta. Parametr metric_currency znajdziesz na https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
leadCostOfGoodsSoldMicros

string (int64 format)

Potencjalny koszt własny sprzedaży to łączny koszt produktów sprzedanych dzięki ich reklamowaniu. Jak to działa: raportujesz konwersje z danymi koszyka w przypadku ukończonych zakupów w Twojej witrynie. Jeśli reklama, z którą nastąpiła interakcja, jest powiązana z produktem (patrz Reklamy produktowe), jest on produktem reklamowanym. Każdy produkt uwzględniony w zamówieniu, które złożył klient, jest produktem sprzedanym. Jeśli reklamowane i sprzedane produkty pasują do siebie, ich koszt jest zaliczany do kosztu własnego potencjalnej sprzedaży. Przykład: użytkownik kliknął reklamę produktową kapelusza, a potem kupił ten kapelusz oraz koszulę. Koszt własny sprzedaży kapelusza wynosi 3 zł, a koszuli – 5 zł. W przypadku tego zamówienia potencjalny koszt własny sprzedaży wynosi 3 zł. Te dane są dostępne tylko wtedy, gdy rejestrujesz konwersje z danymi koszyka. Te dane mają wartość pieniężną i domyślnie zwracają ją w walucie klienta. Parametr metric_currency znajdziesz na https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
clientAccountLeadGrossProfitMicros

string (int64 format)

Potencjalny zysk brutto na koncie klienta to zysk ze sprzedaży produktów uzyskany dzięki ich reklamowaniu i pomniejszony o koszt własny sprzedaży. Jak to działa: raportujesz konwersje z danymi koszyka w przypadku ukończonych zakupów w Twojej witrynie. Jeśli reklama, z którą nastąpiła interakcja przed zakupem, ma powiązany produkt (patrz Reklamy produktowe), jest on produktem reklamowanym. Każdy produkt uwzględniony w zamówieniu, które złożył klient, jest produktem sprzedanym. Jeśli reklamowane i sprzedane produkty pasują do siebie, przychody z tej sprzedaży pomniejszone o koszt własny sprzedaży to Twój potencjalny zysk brutto. Przykład: użytkownik kliknął reklamę produktową kapelusza, a potem kupił ten kapelusz oraz koszulę. Cena kapelusza wynosi 10 zł, a jego koszt własny sprzedaży to 3 zł. Potencjalny zysk brutto z tego zamówienia wynosi 7 zł = 10 zł – 3 zł. Te dane są dostępne tylko wtedy, gdy rejestrujesz konwersje z danymi koszyka. Te dane mają wartość pieniężną i domyślnie zwracają ją w walucie klienta. Parametr metric_currency znajdziesz na https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
leadGrossProfitMicros

string (int64 format)

Potencjalny zysk brutto to zysk ze sprzedaży produktów uzyskany dzięki ich reklamowaniu i pomniejszony o koszt własny sprzedaży. Jak to działa: raportujesz konwersje z danymi koszyka w przypadku ukończonych zakupów w Twojej witrynie. Jeśli reklama, z którą nastąpiła interakcja przed zakupem, ma powiązany produkt (patrz Reklamy produktowe), jest on produktem reklamowanym. Każdy produkt uwzględniony w zamówieniu, które złożył klient, jest produktem sprzedanym. Jeśli reklamowane i sprzedane produkty pasują do siebie, przychody z tej sprzedaży pomniejszone o koszt własny sprzedaży to Twój potencjalny zysk brutto. Przykład: użytkownik kliknął reklamę produktową kapelusza, a potem kupił ten kapelusz oraz koszulę. Cena kapelusza wynosi 10 zł, a jego koszt własny sprzedaży to 3 zł. Potencjalny zysk brutto z tego zamówienia wynosi 7 zł = 10 zł – 3 zł. Te dane są dostępne tylko wtedy, gdy rejestrujesz konwersje z danymi koszyka. Te dane mają wartość pieniężną i domyślnie zwracają ją w walucie klienta. Parametr metric_currency znajdziesz na https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
clientAccountLeadRevenueMicros

string (int64 format)

Potencjalne przychody na koncie klienta to łączna kwota uzyskana ze sprzedaży produktów dzięki reklamom tych produktów. Jak to działa: raportujesz konwersje z danymi koszyka w przypadku ukończonych zakupów w Twojej witrynie. Jeśli reklama, z którą nastąpiła interakcja przed zakupem, ma powiązany produkt (patrz Reklamy produktowe), jest on produktem reklamowanym. Każdy produkt uwzględniony w zamówieniu, które złożył klient, jest produktem sprzedanym. Jeśli reklamowane i sprzedane produkty są takie same, łączna wartość przychodów ze sprzedaży tych produktów jest wyświetlana w sekcji potencjalnych przychodów. Przykład: użytkownik kliknął reklamę produktową kapelusza, a potem kupił ten kapelusz oraz koszulę. Kapelusz kosztował 10 zł, a koszulka 20 zł. Potencjalne przychody z tego zamówienia wynoszą 10 zł. Te dane są dostępne tylko wtedy, gdy rejestrujesz konwersje z danymi koszyka. Te dane mają wartość pieniężną i domyślnie zwracają ją w walucie klienta. Parametr metric_currency znajdziesz na https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
leadRevenueMicros

string (int64 format)

Potencjalne przychody to łączna kwota uzyskana ze sprzedaży produktów dzięki reklamom tych produktów. Jak to działa: raportujesz konwersje z danymi koszyka w przypadku ukończonych zakupów w Twojej witrynie. Jeśli reklama, z którą nastąpiła interakcja przed zakupem, ma powiązany produkt (patrz Reklamy produktowe), jest on produktem reklamowanym. Każdy produkt uwzględniony w zamówieniu, które złożył klient, jest produktem sprzedanym. Jeśli reklamowane i sprzedane produkty są takie same, łączna wartość przychodów ze sprzedaży tych produktów jest wyświetlana w sekcji potencjalnych przychodów. Przykład: użytkownik kliknął reklamę produktową kapelusza, a potem kupił ten kapelusz oraz koszulę. Kapelusz kosztował 10 zł, a koszulka 20 zł. Potencjalne przychody z tego zamówienia wynoszą 10 zł. Te dane są dostępne tylko wtedy, gdy rejestrujesz konwersje z danymi koszyka. Te dane mają wartość pieniężną i domyślnie zwracają ją w walucie klienta. Parametr metric_currency znajdziesz na https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
clientAccountLeadUnitsSold

number

Potencjalna liczba sprzedanych egzemplarzy na koncie klienta to łączna liczba produktów sprzedanych dzięki ich reklamowaniu. Jak to działa: raportujesz konwersje z danymi koszyka w przypadku ukończonych zakupów w Twojej witrynie. Jeśli reklama, z którą nastąpiła interakcja przed zakupem, ma powiązany produkt (patrz Reklamy produktowe), jest on produktem reklamowanym. Każdy produkt uwzględniony w zamówieniu, które złożył klient, jest produktem sprzedanym. Jeśli reklamowane i sprzedane produkty pasują do siebie, łączna liczba sprzedanych produktów jest widoczna w kolumnie potencjalnej liczby sprzedanych egzemplarzy. Przykład: użytkownik kliknął reklamę produktową kapelusza, a potem kupił ten kapelusz oraz koszulę i kurtkę. Potencjalna liczba sprzedanych egzemplarzy w ramach tego zamówienia to 1. Te dane są dostępne tylko wtedy, gdy rejestrujesz konwersje z danymi koszyka.
leadUnitsSold

number

Potencjalna liczba sprzedanych egzemplarzy to łączna liczba produktów sprzedanych dzięki ich reklamowaniu. Jak to działa: raportujesz konwersje z danymi koszyka w przypadku ukończonych zakupów w Twojej witrynie. Jeśli reklama, z którą nastąpiła interakcja przed zakupem, ma powiązany produkt (patrz Reklamy produktowe), jest on produktem reklamowanym. Każdy produkt uwzględniony w zamówieniu, które złożył klient, jest produktem sprzedanym. Jeśli reklamowane i sprzedane produkty pasują do siebie, łączna liczba sprzedanych produktów jest widoczna w kolumnie potencjalnej liczby sprzedanych egzemplarzy. Przykład: użytkownik kliknął reklamę produktową kapelusza, a potem kupił ten kapelusz oraz koszulę i kurtkę. Potencjalna liczba sprzedanych egzemplarzy w ramach tego zamówienia to 1. Te dane są dostępne tylko wtedy, gdy rejestrujesz konwersje z danymi koszyka.

Wartość

Ogólny kontener danych.

Zapis JSON 
{

  // Union field value can be only one of the following:
  "booleanValue": boolean,
  "int64Value": string,
  "floatValue": number,
  "doubleValue": number,
  "stringValue": string
  // End of list of possible types for union field value.
}
Pola
Pole sumy value. Wartość. value może być tylko jedną z tych wartości:
booleanValue

boolean

Wartość logiczna.
int64Value

string (int64 format)

Int64.
floatValue

number

Pływające.
doubleValue

number

Dublet.
stringValue

string

Ciąg znaków.

QualityScoreBucket

Wymienia listę możliwych segmentów wyniku jakości.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
BELOW_AVERAGE Jakość kreacji jest poniżej przeciętnej.
AVERAGE Jakość kreacji jest średnia.
ABOVE_AVERAGE Jakość kreacji jest powyżej średniej.

InteractionEventType

Wartość Enum opisująca możliwe typy płatnych i bezpłatnych interakcji.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
CLICK Kliknij, aby przejść do witryny. W większości przypadków ta interakcja prowadzi do lokalizacji zewnętrznej, zwykle na stronę docelową reklamodawcy. Jest to też domyślny typ InteractionEventType w przypadku zdarzeń kliknięcia.
ENGAGEMENT Wyrazieniu przez użytkownika zamiaru wejścia w interakcję z reklamą w miejscu docelowym
VIDEO_VIEW Użytkownik obejrzał reklamę wideo.
NONE Domyślny typ InteractionEventType w przypadku zdarzeń konwersji z reklam. Jest ona wykorzystywana, gdy wiersz konwersji z reklam NIE wskazuje, że bezpłatne interakcje (np. konwersje z reklamą) powinny być „promowane” i raportowane w ramach podstawowych danych. Są to po prostu inne konwersje (reklamy).

Segmenty

Pola tylko do podziału na segmenty.

Zapis JSON 
{
  "adNetworkType": enum (AdNetworkType),
  "conversionActionCategory": enum (ConversionActionCategory),
  "conversionCustomDimensions": [
    {
      object (Value)
    }
  ],
  "dayOfWeek": enum (DayOfWeek),
  "device": enum (Device),
  "keyword": {
    object (Keyword)
  },
  "productChannel": enum (ProductChannel),
  "productChannelExclusivity": enum (ProductChannelExclusivity),
  "productCondition": enum (ProductCondition),
  "productSoldCondition": enum (ProductCondition),
  "rawEventConversionDimensions": [
    {
      object (Value)
    }
  ],
  "conversionAction": string,
  "conversionActionName": string,
  "date": string,
  "month": string,
  "productBiddingCategoryLevel1": string,
  "productBiddingCategoryLevel2": string,
  "productBiddingCategoryLevel3": string,
  "productBiddingCategoryLevel4": string,
  "productBiddingCategoryLevel5": string,
  "productBrand": string,
  "productCountry": string,
  "productCustomAttribute0": string,
  "productCustomAttribute1": string,
  "productCustomAttribute2": string,
  "productCustomAttribute3": string,
  "productCustomAttribute4": string,
  "productItemId": string,
  "productLanguage": string,
  "productSoldBiddingCategoryLevel1": string,
  "productSoldBiddingCategoryLevel2": string,
  "productSoldBiddingCategoryLevel3": string,
  "productSoldBiddingCategoryLevel4": string,
  "productSoldBiddingCategoryLevel5": string,
  "productSoldBrand": string,
  "productSoldCustomAttribute0": string,
  "productSoldCustomAttribute1": string,
  "productSoldCustomAttribute2": string,
  "productSoldCustomAttribute3": string,
  "productSoldCustomAttribute4": string,
  "productSoldItemId": string,
  "productSoldTitle": string,
  "productSoldTypeL1": string,
  "productSoldTypeL2": string,
  "productSoldTypeL3": string,
  "productSoldTypeL4": string,
  "productSoldTypeL5": string,
  "productStoreId": string,
  "productTitle": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "quarter": string,
  "week": string,
  "year": integer,
  "assetInteractionTarget": {
    object (AssetInteractionTarget)
  }
}
Pola
adNetworkType

enum (AdNetworkType)

Typ sieci reklamowej.
conversionActionCategory

enum (ConversionActionCategory)

Kategoria działań powodujących konwersję.
conversionCustomDimensions[]

object (Value)

Wymiary niestandardowe konwersji.
dayOfWeek

enum (DayOfWeek)

Dzień tygodnia, na przykład MONDAY.
device

enum (Device)

Urządzenie, do którego mają zastosowanie dane.
keyword

object (Keyword)

Kryterium słowa kluczowego.
productChannel

enum (ProductChannel)

Kanał produktu.
productChannelExclusivity

enum (ProductChannelExclusivity)

Wyłączność kanału, na którym kierowany jest produkt.
productCondition

enum (ProductCondition)

Stan produktu.
productSoldCondition

enum (ProductCondition)

Stan sprzedawanego produktu.
rawEventConversionDimensions[]

object (Value)

Nieprzetworzone wymiary konwersji zdarzenia.
conversionAction

string

Nazwa zasobu działania powodującego konwersję.
conversionActionName

string

Nazwa działania powodującego konwersję.
date

string

Data, do której mają zastosowanie dane. Format rrrr-MM-dd, np. 2018-04-17.
month

string

Miesiąc w formie dnia pierwszego dnia miesiąca. Format to rrrr-MM-dd.
productBiddingCategoryLevel1

string

Kategoria ustalania stawek (poziom 1) produktu.
productBiddingCategoryLevel2

string

Kategoria ustalania stawek (poziom 2) produktu.
productBiddingCategoryLevel3

string

Kategoria ustalania stawek (poziom 3) produktu.
productBiddingCategoryLevel4

string

Kategoria ustalania stawek (poziom 4) produktu.
productBiddingCategoryLevel5

string

Kategoria ustalania stawek (poziom 5) produktu.
productBrand

string

Marka produktu.
productCountry

string

Nazwa zasobu stałej kierowania geograficznego dla kraju sprzedaży produktu.
productCustomAttribute0

string

Atrybut niestandardowy 0 produktu.
productCustomAttribute1

string

Atrybut niestandardowy 1 produktu.
productCustomAttribute2

string

Atrybut niestandardowy 2 produktu.
productCustomAttribute3

string

Atrybut niestandardowy 3 produktu.
productCustomAttribute4

string

Atrybut niestandardowy 4 produktu.
productItemId

string

Identyfikator produktu.
productLanguage

string

Nazwa zasobu stałej języka produktu.
productSoldBiddingCategoryLevel1

string

Kategoria ustalania stawek (poziom 1) sprzedawanego produktu.
productSoldBiddingCategoryLevel2

string

Kategoria ustalania stawek (poziom 2) sprzedawanego produktu.
productSoldBiddingCategoryLevel3

string

Kategoria ustalania stawek (poziom 3) sprzedawanego produktu.
productSoldBiddingCategoryLevel4

string

Kategoria ustalania stawek (poziom 4) sprzedawanego produktu.
productSoldBiddingCategoryLevel5

string

Kategoria ustalania stawek (poziom 5) sprzedawanego produktu.
productSoldBrand

string

Marka sprzedawanego produktu.
productSoldCustomAttribute0

string

Atrybut niestandardowy 0 sprzedawanego produktu.
productSoldCustomAttribute1

string

Atrybut niestandardowy 1 sprzedawanego produktu.
productSoldCustomAttribute2

string

Atrybut niestandardowy 2 sprzedawanego produktu.
productSoldCustomAttribute3

string

Atrybut niestandardowy 3 sprzedanego produktu.
productSoldCustomAttribute4

string

Atrybut niestandardowy 4 sprzedawanego produktu.
productSoldItemId

string

Identyfikator sprzedanego produktu.
productSoldTitle

string

Nazwa sprzedawanego produktu.
productSoldTypeL1

string

Typ (poziom 1) sprzedanego produktu.
productSoldTypeL2

string

Typ (poziom 2) sprzedanego produktu.
productSoldTypeL3

string

Typ (poziom 3) sprzedanego produktu.
productSoldTypeL4

string

Typ (poziom 4) sprzedanego produktu.
productSoldTypeL5

string

Typ (poziom 5) sprzedawanego produktu.
productStoreId

string

Identyfikator sklepu produktu.
productTitle

string

Nazwa produktu.
productTypeL1

string

Typ (poziom 1) produktu.
productTypeL2

string

Typ (poziom 2) produktu.
productTypeL3

string

Typ (poziom 3) produktu.
productTypeL4

string

Typ (poziom 4) produktu.
productTypeL5

string

Typ (poziom 5) produktu.
quarter

string

Kwartał jako data pierwszego dnia kwartału. używa roku kalendarzowego w przypadku kwartałów, na przykład drugi kwartał 2018 r. zaczyna się 1 kwietnia 2018 r. Format to rrrr-MM-dd.
week

string

Tydzień zdefiniowany jako okres od poniedziałku do niedzieli, reprezentowany jako poniedziałek. Format to rrrr-MM-dd.
year

integer

Rok w formacie rrrr.
assetInteractionTarget

object (AssetInteractionTarget)

Używany tylko z danymi CustomerAsset, CampaignAsset i KeywordAsset. Wskazuje, czy dane o interakcji wystąpiły z samym zasobem czy z innym zasobem lub jednostką reklamową. Interakcje (np. kliknięcia) są liczone we wszystkich częściach wyświetlanej reklamy (np. w samej reklamie i innych elementach, takich jak linki do podstron). Jeśli interakcja ma wartość Prawda, oznacza to, że interakcje są związane z konkretnym zasobem, a gdy interakcja OnThisAsset ma wartość false (fałsz), oznacza to, że interakcje nie dotyczą tego konkretnego komponentu, ale innych części reklamy, z którą ten komponent jest wyświetlany.

AdNetworkType

Wylicza typy sieci Google Ads.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Wartość jest nieznana w tej wersji.
SEARCH Wyszukiwarka Google.
SEARCH_PARTNERS Partnerzy w sieci wyszukiwania.
CONTENT dla sieci reklamowej
YOUTUBE_WATCH Filmy w YouTube
MIXED Z wielu sieci.

Słowo kluczowe

Segment kryterium słowa kluczowego.

Zapis JSON 
{
  "info": {
    object (KeywordInfo)
  },
  "adGroupCriterion": string
}
Pola
info

object (KeywordInfo)

Informacje o słowie kluczowym.
adGroupCriterion

string

Nazwa zasobu GroupCriterion.

ProductChannelExclusivity

Wyliczenie opisujące dostępność oferty produktu.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
SINGLE_CHANNEL Produkt jest sprzedawany tylko przez jeden kanał – lokalne sklepy lub online – zgodnie z wartością tego kanału.
MULTI_CHANNEL Produkt jest dopasowany do odpowiednika w sklepie internetowym lub lokalnym, co wskazuje, że można go kupić w obu kanałach ShoppingProductChannel.

ProductCondition

Wyliczenie opisujące stan oferty produktu.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
OLD Stan produktu jest nieaktualny.
NEW Stan produktu jest nowy.
REFURBISHED Stan produktu jest odnowiony.
USED Stan produktu jest używany.

AssetInteractionTarget

Segment AssetInteractionTarget.

Zapis JSON 
{
  "asset": string,
  "interactionOnThisAsset": boolean
}
Pola
asset

string

Nazwa zasobu zasobu.
interactionOnThisAsset

boolean

Używany tylko z danymi CustomerAsset, CampaignAsset i KeywordAsset. Wskazuje, czy dane o interakcji wystąpiły z samym zasobem czy z innym zasobem lub jednostką reklamową.