Package google.ads.searchads360.v0.resources

Indeks

• AccessibleBiddingStrategy (komunikat)
• AccessibleBiddingStrategy.MaximizeConversionValue (komunikat)
• AccessibleBiddingStrategy.MaximizeConversions (komunikat)
• AccessibleBiddingStrategy.TargetCpa (komunikat)
• AccessibleBiddingStrategy.TargetImpressionShare (komunikat)
• AccessibleBiddingStrategy.TargetRoas (komunikat)
• AccessibleBiddingStrategy.TargetSpend (komunikat)
• Ad (komunikat)
• AdGroup (komunikat)
• AdGroupAd (komunikat)
• AdGroupAdEffectiveLabel (komunikat)
• AdGroupAdLabel (komunikat)
• AdGroupAsset (komunikat)
• AdGroupAssetSet (komunikat)
• AdGroupAudienceView (komunikat)
• AdGroupBidModifier (komunikat)
• AdGroupCriterion (komunikat)
• AdGroupCriterion.PositionEstimates (komunikat)
• AdGroupCriterion.QualityInfo (komunikat)
• AdGroupCriterionEffectiveLabel (komunikat)
• AdGroupCriterionLabel (komunikat)
• AdGroupEffectiveLabel (komunikat)
• AdGroupLabel (komunikat)
• AgeRangeView (komunikat)
• Asset (komunikat)
• AssetGroup (komunikat)
• AssetGroupAsset (komunikat)
• AssetGroupAssetCombinationData (komunikat)
• AssetGroupListingGroupFilter (komunikat)
• AssetGroupSignal (komunikat)
• AssetGroupTopCombinationView (komunikat)
• AssetSet (komunikat)
• AssetSetAsset (komunikat)
• Audience (komunikat)
• BiddingStrategy (komunikat)
• Campaign (komunikat)
• Campaign.DynamicSearchAdsSetting (komunikat)
• Campaign.GeoTargetTypeSetting (komunikat)
• Campaign.NetworkSettings (komunikat)
• Campaign.OptimizationGoalSetting (komunikat)
• Campaign.SelectiveOptimization (komunikat)
• Campaign.ShoppingSetting (komunikat)
• Campaign.TrackingSetting (komunikat)
• CampaignAsset (komunikat)
• CampaignAssetSet (komunikat)
• CampaignAudienceView (komunikat)
• CampaignBudget (komunikat)
• CampaignCriterion (komunikat)
• CampaignEffectiveLabel (komunikat)
• CampaignLabel (komunikat)
• CartDataSalesView (komunikat)
• Conversion (komunikat)
• ConversionAction (komunikat)
• ConversionAction.AttributionModelSettings (komunikat)
• ConversionAction.FloodlightSettings (komunikat)
• ConversionAction.ValueSettings (komunikat)
• ConversionCustomVariable (komunikat)
• ConversionCustomVariable.FloodlightConversionCustomVariableInfo (komunikat)
• ConversionTrackingSetting (komunikat)
• CustomColumn (komunikat)
• Customer (komunikat)
• CustomerAsset (komunikat)
• CustomerAssetSet (komunikat)
• CustomerClient (komunikat)
• CustomerManagerLink (komunikat)
• DoubleClickCampaignManagerSetting (komunikat)
• DynamicSearchAdsSearchTermView (komunikat)
• GenderView (komunikat)
• GeoTargetConstant (komunikat)
• KeywordView (komunikat)
• Label (komunikat)
• LanguageConstant (komunikat)
• ListingGroupFilterDimension (komunikat)
• ListingGroupFilterDimension.ProductBiddingCategory (komunikat)
• ListingGroupFilterDimension.ProductBrand (komunikat)
• ListingGroupFilterDimension.ProductChannel (komunikat)
• ListingGroupFilterDimension.ProductCondition (komunikat)
• ListingGroupFilterDimension.ProductCustomAttribute (komunikat)
• ListingGroupFilterDimension.ProductItemId (komunikat)
• ListingGroupFilterDimension.ProductType (komunikat)
• ListingGroupFilterDimensionPath (komunikat)
• LocationView (komunikat)
• ProductBiddingCategoryConstant (komunikat)
• ProductGroupView (komunikat)
• SearchAds360Field (komunikat)
• ShoppingPerformanceView (komunikat)
• UserList (komunikat)
• UserLocationView (komunikat)
• Visit (komunikat)
• WebpageView (komunikat)

AccessibleBiddingStrategy

Reprezentuje widok strategii ustalania stawek, które należą do klienta i są z nim współdzielone.

W przeciwieństwie do zasobu BiddingStrategy ten zasób zawiera strategie należące do menedżerów klienta i udostępnione temu klientowi – oprócz strategii należących do tego klienta. To źródło nie udostępnia danych i zawiera tylko ograniczony podzbiór atrybutów BiddingStrategy.

Pola
resource_name	string Nazwa zasobu dostępnej strategii ustalania stawek. Nazwy zasobów AccessibleBiddingStrategy mają format: customers/{customer_id}/accessibleBiddingStrategies/{bidding_strategy_id}
id	int64 Identyfikator strategii ustalania stawek.
name	string Nazwa strategii ustalania stawek.
type	BiddingStrategyType Typ strategii ustalania stawek.
owner_customer_id	int64 Identyfikator klienta, do którego należy strategia ustalania stawek.
owner_descriptive_name	string descriptive_name klienta, który jest właścicielem strategii ustalania stawek.
Pole zbiorcze scheme. Schemat określania stawek. Można ustawić tylko jedną z tych wartości. Pole scheme może mieć tylko jedną z tych wartości:
maximize_conversion_value	MaximizeConversionValue Strategia automatycznego określania stawek, która pomaga uzyskać jak największą wartość konwersji w kampaniach w ramach określonego budżetu.
maximize_conversions	MaximizeConversions Strategia automatycznego określania stawek, która pomaga uzyskać jak najwięcej konwersji w kampaniach w ramach określonego budżetu.
target_cpa	TargetCpa Strategia ustalania stawek, która ustala stawki tak, aby pomóc Ci uzyskać jak największą liczbę konwersji przy wybranym przez Ciebie docelowym koszcie pozyskania (CPA).
target_impression_share	TargetImpressionShare Strategia ustalania stawek, która automatycznie optymalizuje stawki pod kątem wybranego odsetka wyświetleń.
target_roas	TargetRoas Strategia ustalania stawek, która pomaga zmaksymalizować przychody przy zachowaniu określonego docelowego zwrotu z nakładów na reklamę (ROAS).
target_spend	TargetSpend Strategia ustalania stawek, która ustala stawki tak, aby umożliwić Ci uzyskanie jak największej liczby kliknięć w ramach budżetu.

MaximizeConversionValue

Strategia automatycznego określania stawek, która pomaga uzyskać jak największą wartość konwersji w kampaniach w ramach określonego budżetu.

Pola

target_roas

double Opcja docelowego zwrotu z nakładów na reklamę (ROAS). Jeśli jest ustawiona, strategia ustalania stawek będzie maksymalizować przychody przy średnim docelowym zwrocie z nakładów na reklamę. Jeśli docelowy ROAS jest wysoki, strategia ustalania stawek może nie być w stanie wydać całego budżetu. Jeśli docelowy ROAS nie jest ustawiony, strategia ustalania stawek będzie dążyć do osiągnięcia jak najwyższej wartości ROAS w ramach budżetu.

MaximizeConversions

Strategia automatycznego określania stawek, która pomaga uzyskać jak najwięcej konwersji w kampaniach w ramach określonego budżetu.

Pola
target_cpa	int64 Opcja docelowego kosztu pozyskania (CPA). Jest to średnia kwota, jaką chcesz wydawać na pozyskanie.
target_cpa_micros	int64 Opcja docelowego kosztu pozyskania (CPA). Jest to średnia kwota, jaką chcesz wydawać na pozyskanie.

TargetCpa

Automatyczna strategia określania stawek, która ustala stawki, aby pomóc Ci uzyskać jak największą liczbę konwersji przy wyznaczonym przez Ciebie docelowym koszcie pozyskania (CPA).

Pola
target_cpa_micros	int64 Średni docelowy CPA. Ta wartość docelowa powinna być większa lub równa minimalnej jednostce rozliczeniowej w walucie konta.

TargetImpressionShare

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

Pola
location	TargetImpressionShareLocation Wybrana lokalizacja na stronie wyników wyszukiwania.
location_fraction_micros	int64 Wybrany ułamek reklam do wyświetlania w lokalizacji docelowej w mikrosekundach. Na przykład 1% = 10 000.
cpc_bid_ceiling_micros	int64 Najwyższa stawka CPC, jaką może określić automatyczny system określania stawek. Jest to pole wymagane, które reklamodawca wprowadza w celu określenia górnej granicy i które jest podawane w lokalnych mikrowalutach.

TargetRoas

Strategia automatycznego określania stawek, która pomaga zmaksymalizować przychody przy zachowaniu określonego docelowego zwrotu z nakładów na reklamę (ROAS).

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

TargetSpend

Strategia automatycznego określania stawek, która ustala stawki tak, aby umożliwić Ci uzyskanie jak największej liczby kliknięć w ramach budżetu.

Pola
target_spend_micros (deprecated)	int64 Ten element został wycofany. Docelowe wydatki, w ramach których należy maksymalizować liczbę kliknięć. Licytujący korzystający z strategii Docelowe wydatki spróbuje wydać mniejszą z tych wartości: wartość tego parametru lub kwotę wydatków wynikającą z naturalnego ograniczania. Jeśli nie zostanie określony, budżet będzie używany jako docelowy poziom wydatków. To pole zostało wycofane i nie należy go już używać. Szczegółowe informacje znajdziesz na stronie https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html.
cpc_bid_ceiling_micros	int64 Limit maksymalnej stawki, który może ustawić strategia ustalania stawek. Limit dotyczy wszystkich słów kluczowych zarządzanych przez strategię.

Reklama

reklamę;

Pola
resource_name	string Nazwa zasobu reklamy. Nazwy zasobów reklam mają postać: customers/{customer_id}/ads/{ad_id}
final_urls[]	string Lista możliwych końcowych adresów URL reklamy po wszystkich przekierowaniach między domenami.
final_app_urls[]	FinalAppUrl Lista końcowych adresów URL aplikacji, które będą używane na urządzeniach mobilnych, jeśli użytkownik ma zainstalowaną daną aplikację.
final_mobile_urls[]	string Lista możliwych końcowych mobilnych adresów URL po wszystkich przekierowaniach między domenami w przypadku reklamy.
type	AdType Typ reklamy.
id	int64 Identyfikator reklamy.
tracking_url_template	string Szablon adresu URL do tworzenia linku monitorującego.
final_url_suffix	string Sufiks, który ma być używany podczas tworzenia końcowego adresu URL.
display_url	string Adres URL, który pojawia się w opisie reklamy w przypadku niektórych formatów reklam.
name	string Nazwa reklamy. Służy on tylko do identyfikowania reklamy. Nie musi być unikalny i nie wpływa na wyświetlaną reklamę.
Pole zbiorcze ad_data. Szczegóły dotyczące typu reklamy. Musisz ustawić dokładnie jedną wartość. ad_data może mieć tylko jedną z tych wartości:
text_ad	SearchAds360TextAdInfo Szczegóły dotyczące reklamy tekstowej.
expanded_text_ad	SearchAds360ExpandedTextAdInfo Szczegóły dotyczące rozszerzonej reklamy tekstowej.
responsive_search_ad	SearchAds360ResponsiveSearchAdInfo Szczegóły dotyczące elastycznej reklamy w wyszukiwarce.
product_ad	SearchAds360ProductAdInfo Szczegóły dotyczące reklamy produktu.
expanded_dynamic_search_ad	SearchAds360ExpandedDynamicSearchAdInfo Szczegóły dotyczące rozszerzonej dynamicznej reklamy w wyszukiwarce.

Grupa reklam

grupę reklam,

Pola
resource_name	string Nazwa zasobu grupy reklam. Nazwy zasobów grupy reklam mają postać: customers/{customer_id}/adGroups/{ad_group_id}
status	AdGroupStatus Stan grupy reklam.
type	AdGroupType Typ grupy reklam.
ad_rotation_mode	AdGroupAdRotationMode Tryb rotacji reklam w grupie reklam.
creation_time	string Sygnatura czasowa utworzenia tej grupy reklam. Sygnatura czasowa jest podana w strefie czasowej klienta w formacie „rrrr-MM-dd GG:mm:ss”.
targeting_setting	TargetingSetting Ustawienie funkcji związanych z kierowaniem.
labels[]	string Nazwy zasobów etykiet dołączonych do tej grupy reklam.
effective_labels[]	string Nazwy zasobów obowiązujących etykiet dołączonych do tej grupy reklam. Skuteczna etykieta to etykieta odziedziczona lub przypisana bezpośrednio do tej grupy reklam.
engine_id	string Identyfikator grupy reklam na zewnętrznym koncie wyszukiwarki. To pole jest przeznaczone tylko dla kont innych niż Google Ads, np. Yahoo Japan, Microsoft, Baidu itp. W przypadku jednostki Google Ads użyj zamiast niego „ad_group.id”.
start_date	string Data rozpoczęcia wyświetlania reklam przez tę grupę reklam. Domyślnie grupa reklam rozpoczyna się teraz lub w dniu rozpoczęcia grupy reklam (w zależności od tego, co nastąpi później). Jeśli to pole jest ustawione, grupa reklam rozpoczyna się na początku określonej daty w strefie czasowej klienta. To pole jest dostępne tylko w przypadku kont bramy Microsoft Advertising i Facebook. Format: RRRR-MM-DD Przykład: 2019-03-14
end_date	string Data zakończenia wyświetlania reklam przez grupę reklam. Domyślnie grupa reklam kończy się w dniu zakończenia grupy reklam. Jeśli to pole jest ustawione, grupa reklam kończy się na koniec określonej daty w strefie czasowej klienta. To pole jest dostępne tylko w przypadku kont bramy Microsoft Advertising i Facebook. Format: RRRR-MM-DD Przykład: 2019-03-14
language_code	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
last_modified_time	string Data i godzina ostatniej modyfikacji tej grupy reklam. Data i godzina są podane w strefie czasowej klienta w formacie „rrrr-MM-dd HH:mm:ss.ssssss”.
id	int64 Identyfikator grupy reklam.
name	string Nazwa grupy reklam. To pole jest wymagane i nie powinno być puste podczas tworzenia nowych grup reklam. Musi zawierać mniej niż 255 znaków UTF-8 o pełnej szerokości. Nie może zawierać znaków null (punkt kodowy 0x0), znaku nowego wiersza (punkt kodowy 0xA) ani przejścia do nowej linii (punkt kodowy 0xD).
tracking_url_template	string Szablon adresu URL do tworzenia linku monitorującego.
cpc_bid_micros	int64 Maksymalna stawka CPC (kosztu kliknięcia).
engine_status	AdGroupEngineStatus Stan grupy reklam w wyszukiwarce.
final_url_suffix	string Szablon adresu URL do dołączania parametrów do końcowego adresu URL.

AdGroupAd

Reklama z grupy reklam.

Pola
resource_name	string Nazwa zasobu reklamy. Nazwy zasobów reklam w grupie reklam mają postać: customers/{customer_id}/adGroupAds/{ad_group_id}~{ad_id}
status	AdGroupAdStatus Stan reklamy.
ad	Ad Reklama.
creation_time	string Sygnatura czasowa utworzenia tej reklamy w grupie reklam. Data i godzina są podane w strefie czasowej klienta w formacie „rrrr-MM-dd HH:mm:ss.ssssss”.
labels[]	string Nazwy zasobów etykiet dołączonych do tej reklamy w grupie reklam.
effective_labels[]	string Nazwy zasobów obowiązujących etykiet dołączonych do tej reklamy. Skuteczna etykieta to etykieta odziedziczona lub przypisana bezpośrednio do tej reklamy.
engine_id	string Identyfikator reklamy na zewnętrznym koncie wyszukiwarki. To pole dotyczy tylko konta Search Ads 360, np. Yahoo Japan, Microsoft, Baidu itp. W przypadku podmiotu innego niż Search Ads 360 użyj zamiast tego pola „ad_group_ad.ad.id”.
engine_status	AdGroupAdEngineStatus Dodatkowy stan reklamy na zewnętrznym koncie wyszukiwarki. Możliwe stany (w zależności od typu konta zewnętrznego) to m.in. aktywne, kwalifikujące się, oczekujące na weryfikację.
last_modified_time	string Data i godzina ostatniej modyfikacji reklamy w tej grupie reklam. Data i godzina są podane w strefie czasowej klienta w formacie „rrrr-MM-dd HH:mm:ss.ssssss”.

AdGroupAdEffectiveLabel

Relacja między reklamą w grupie reklam a skuteczną etykietą. Skuteczna etykieta to etykieta odziedziczona lub przypisana bezpośrednio do tej reklamy w grupie reklam.

Pola
resource_name	string Nazwa zasobu etykiety skutecznej reklamy w grupie reklam. Nazwy zasobów etykiet skutecznych reklam w grupie reklam mają postać: customers/{owner_customer_id}/adGroupAdEffectiveLabels/{ad_group_id}~{ad_id}~{label_id}
ad_group_ad	string Reklama w grupie reklam, do której jest dołączona etykieta.
label	string Etykieta przypisana do reklamy w grupie reklam.
owner_customer_id	int64 Identyfikator klienta, do którego należy efektywna etykieta.

AdGroupAdLabel

Relacja między reklamą w grupie reklam a etykietą.

Pola
resource_name	string Nazwa zasobu etykiety reklamy w grupie reklam. Nazwy zasobów etykiet reklam w grupie reklam mają postać: customers/{owner_customer_id}/adGroupAdLabels/{ad_group_id}~{ad_id}~{label_id}
ad_group_ad	string Reklama w grupie reklam, do której jest dołączona etykieta.
label	string Etykieta przypisana do reklamy w grupie reklam.
owner_customer_id	int64 Identyfikator klienta, który jest właścicielem etykiety.

AdGroupAsset

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

Pola
resource_name	string Nazwa zasobu komponentu grupy reklam. Nazwy zasobów AdGroupAsset mają postać: customers/{customer_id}/adGroupAssets/{ad_group_id}~{asset_id}~{field_type}
ad_group	string Wymagane. Grupa reklam, z którą jest powiązany komponent.
asset	string Wymagane. Komponent powiązany z grupą reklam.
status	AssetLinkStatus Stan komponentu grupy reklam.

AdGroupAssetSet

AdGroupAssetSet to połączenie między grupą reklam a zestawem komponentów. Utworzenie obiektu AdGroupAssetSet łączy zestaw komponentów z grupą reklam.

Pola
resource_name	string Nazwa zasobu zestawu komponentów grupy reklam. Nazwy zasobów zestawów komponentów grupy reklam mają postać: customers/{customer_id}/adGroupAssetSets/{ad_group_id}~{asset_set_id}
ad_group	string Grupa reklam, z którą jest połączony ten zestaw komponentów.
asset_set	string Zbiór komponentów powiązany z grupą reklam.
status	AssetSetLinkStatus Stan zestawu komponentów grupy reklam. Tylko do odczytu.

AdGroupAudienceView

Widok odbiorców grupy reklam. Zawiera dane o skuteczności dotyczące list zainteresowań i list remarketingowych w przypadku reklam w sieci reklamowej i sieci YouTube oraz list remarketingowych dla reklam w wyszukiwarce (RLSA) zagregowane na poziomie odbiorców.

Pola
resource_name	string Nazwa zasobu widoku odbiorców grupy reklam. Nazwy zasobów widoku odbiorców grupy reklam mają postać: customers/{customer_id}/adGroupAudienceViews/{ad_group_id}~{criterion_id}

AdGroupBidModifier

Reprezentuje modyfikator stawki grupy reklam.

Pola
resource_name	string Nazwa zasobu modyfikatora stawek w grupie reklam. Nazwy zasobów modyfikatorów stawek w grupie reklam mają postać: customers/{customer_id}/adGroupBidModifiers/{ad_group_id}~{criterion_id}
bid_modifier	double Modyfikator stawki, gdy kryterium jest spełnione. Modyfikator musi mieścić się w zakresie od 0,1 do 10,0. W przypadku parametru PreferredContent zakres wynosi 1,0–6,0. Aby zrezygnować z typu urządzenia, wpisz 0.
Pole zbiorcze criterion. Kryterium tego modyfikatora stawek w grupie reklam. Wymagane w operacjach tworzenia od wersji 5. Pole criterion może mieć tylko jedną z tych wartości:
device	DeviceInfo Kryterium urządzenia.

AdGroupCriterion

Kryterium w grupie reklam. Raport ad_group_criterion zwraca tylko kryteria, które zostały jawnie dodane do grupy reklam.

Pola
resource_name	string Nazwa zasobu kryterium w grupie reklam. Nazwy zasobów kryteriów w grupie reklam mają postać: customers/{customer_id}/adGroupCriteria/{ad_group_id}~{criterion_id}
creation_time	string Sygnatura czasowa określająca, kiedy to kryterium grupy reklam zostało utworzone. Sygnatura czasowa jest podana w strefie czasowej klienta w formacie „rrrr-MM-dd GG:mm:ss”.
status	AdGroupCriterionStatus Stan kryterium. Jest to stan kryterium w grupie reklam ustawiony przez klienta. Uwaga: raporty w interfejsie mogą zawierać dodatkowe informacje, które wpływają na to, czy kryterium kwalifikuje się do uruchomienia. W niektórych przypadkach kryterium USUNIĘTE w interfejsie API może być nadal wyświetlane jako włączone w interfejsie. Na przykład kampanie domyślnie wyświetlają się użytkownikom ze wszystkich przedziałów wiekowych, chyba że zostaną wykluczeni. Interfejs użytkownika będzie wyświetlać każdy zakres wiekowy jako „włączony”, ponieważ użytkownicy w tym wieku mogą zobaczyć reklamy, ale AdGroupCriterion.status będzie wyświetlać „usunięto”, ponieważ nie dodano żadnego kryterium pozytywnego.
quality_info	QualityInfo Informacje o jakości kryterium.
type	CriterionType Typ kryterium.
labels[]	string Nazwy zasobów etykiet dołączonych do tego kryterium grupy reklam.
effective_labels[]	string Nazwy zasobów skutecznych etykiet dołączonych do tego kryterium w grupie reklam. Skuteczna etykieta to etykieta odziedziczona lub przypisana bezpośrednio do tego kryterium grupy reklam.
position_estimates	PositionEstimates Szacunkowe stawki za kryteria na różnych pozycjach.
final_urls[]	string Lista możliwych końcowych adresów URL reklamy po wszystkich przekierowaniach między domenami.
final_mobile_urls[]	string Lista możliwych końcowych mobilnych adresów URL po wszystkich przekierowaniach między domenami.
url_custom_parameters[]	CustomParameter Lista mapowań używanych do zastępowania tagów parametrów niestandardowych w zmiennych tracking_url_template, final_urls lub mobile_final_urls.
engine_id	string Identyfikator kryterium grupy reklam na zewnętrznym koncie wyszukiwarki. To pole jest przeznaczone tylko dla kont innych niż Google Ads, np. Yahoo Japan, Microsoft, Baidu itp. W przypadku jednostki Google Ads użyj zamiast niego pola „ad_group_criterion.criterion_id”.
last_modified_time	string Data i godzina ostatniej modyfikacji tego kryterium w grupie reklam. Data i godzina są podane w strefie czasowej klienta w formacie „rrrr-MM-dd HH:mm:ss.ssssss”.
criterion_id	int64 Identyfikator kryterium.
ad_group	string Grupa reklam, do której należy kryterium.
negative	bool Określ, czy chcesz kierować reklamy na kryterium (false), czy je wykluczać (true). Tego pola nie można zmienić. Aby zmienić kryterium z pozytywnego na negatywne, usuń je, a potem dodaj ponownie.
bid_modifier	double Modyfikator stawki, gdy kryterium jest spełnione. Modyfikator musi mieścić się w zakresie od 0,1 do 10,0. Większość typów kryteriów, na które można kierować reklamy, obsługuje modyfikatory.
cpc_bid_micros	int64 Stawka CPC (kosztu kliknięcia).
effective_cpc_bid_micros	int64 Efektywna stawka CPC (kosztu kliknięcia).
engine_status	AdGroupCriterionEngineStatus Stan kryterium w grupie reklam w wyszukiwarce.
final_url_suffix	string Szablon URL do dołączania parametrów do końcowego adresu URL.
tracking_url_template	string Szablon adresu URL do tworzenia linku monitorującego.
Pole zbiorcze criterion. Kryterium w grupie reklam. Musi być ustawiona dokładnie jedna z tych wartości. Pole criterion może mieć tylko jedną z tych wartości:
keyword	KeywordInfo Słowo kluczowe.
listing_group	ListingGroupInfo Grupa informacji o produktach.
age_range	AgeRangeInfo Przedział wiekowy.
gender	GenderInfo Płeć.
user_list	UserListInfo Lista użytkowników.
webpage	WebpageInfo Strona internetowa
location	LocationInfo Lokalizacja.

PositionEstimates

Szacunkowe stawki za kryteria na różnych pozycjach.

Pola
top_of_page_cpc_micros	int64 Szacunkowa stawka CPC wymagana, aby reklama wyświetlała się u góry pierwszej strony wyników wyszukiwania.

QualityInfo

Kontener informacji o jakości kryterium grupy reklam.

Pola
quality_score	int32 wynik jakości, To pole może nie być wypełnione, jeśli Google nie ma wystarczających informacji, aby określić wartość.

AdGroupCriterionEffectiveLabel

Relacja między kryterium w grupie reklam a etykietą efektywności. Skuteczna etykieta to etykieta odziedziczona lub przypisana bezpośrednio do tego kryterium grupy reklam.

Pola
resource_name	string Nazwa zasobu skutecznej etykiety kryterium w grupie reklam. Nazwy zasobów etykiety skutecznej kryterium w grupie reklam mają postać: customers/{owner_customer_id}/adGroupCriterionEffectiveLabels/{ad_group_id}~{criterion_id}~{label_id}
ad_group_criterion	string Kryterium w grupie reklam, do którego jest dołączona etykieta obowiązująca.
label	string Etykieta przypisana do kryterium w grupie reklam.
owner_customer_id	int64 Identyfikator klienta, do którego należy efektywna etykieta.

AdGroupCriterionLabel

Relacja między kryterium w grupie reklam a etykietą.

Pola
resource_name	string Nazwa zasobu etykiety kryterium grupy reklam. Nazwy zasobów etykiet kryteriów w grupie reklam mają postać: customers/{owner_customer_id}/adGroupCriterionLabels/{ad_group_id}~{criterion_id}~{label_id}
ad_group_criterion	string Kryterium w grupie reklam, do którego jest dołączona etykieta.
label	string Etykieta przypisana do kryterium w grupie reklam.
owner_customer_id	int64 Identyfikator klienta, który jest właścicielem etykiety.

AdGroupEffectiveLabel

Relacja między grupą reklam a skuteczną etykietą. Skuteczna etykieta to etykieta odziedziczona lub przypisana bezpośrednio do tej grupy reklam.

Pola
resource_name	string Nazwa zasobu etykiety skutecznej grupy reklam. Nazwy zasobów etykiety skutecznej grupy reklam mają postać: customers/{owner_customer_id}/adGroupEffectiveLabels/{ad_group_id}~{label_id}
ad_group	string Grupa reklam, do której jest dołączona skuteczna etykieta.
label	string Etykieta przypisana do grupy reklam.
owner_customer_id	int64 Identyfikator klienta, do którego należy efektywna etykieta.

AdGroupLabel

Relacja między grupą reklam a etykietą.

Pola
resource_name	string Nazwa zasobu etykiety grupy reklam. Nazwy zasobów etykiet grup reklam mają postać: customers/{owner_customer_id}/adGroupLabels/{ad_group_id}~{label_id}
ad_group	string Grupa reklam, do której jest dołączona etykieta.
label	string Etykieta przypisana do grupy reklam.
owner_customer_id	int64 Identyfikator klienta, który jest właścicielem etykiety.

AgeRangeView

Widok przedziału wiekowego.

Pola
resource_name	string Nazwa zasobu widoku zakresu wieku. Nazwy zasobów widoku zakresu wieku mają postać: customers/{customer_id}/ageRangeViews/{ad_group_id}~{criterion_id}

Komponent

Komponent to element reklamy, który można udostępniać w wielu reklamach. Może to być obraz (ImageAsset), film (YoutubeVideoAsset) itp. Komponenty są niezmienne i nie można ich usunąć. Aby komponent przestał się wyświetlać, usuń go z podmiotu, który go używa.

Pola
resource_name	string Nazwa zasobu komponentu. Nazwy zasobów komponentów mają postać: customers/{customer_id}/assets/{asset_id}
type	AssetType Typ komponentu.
final_urls[]	string Lista możliwych końcowych adresów URL po wszystkich przekierowaniach między domenami.
final_mobile_urls[]	string Lista możliwych końcowych mobilnych adresów URL po wszystkich przekierowaniach między domenami.
url_custom_parameters[]	CustomParameter Lista mapowań, które mają być używane do zastępowania tagów parametrów niestandardowych adresu URL w polach tracking_url_template, final_urls lub final_mobile_urls.
status	AssetStatus Stan komponentu.
creation_time	string Sygnatura czasowa utworzenia tego komponentu. Sygnatura czasowa jest podana w strefie czasowej klienta w formacie „rrrr-MM-dd GG:mm:ss”.
last_modified_time	string Data i godzina ostatniej modyfikacji tego komponentu. Data i godzina są podane w strefie czasowej klienta w formacie „rrrr-MM-dd HH:mm:ss.ssssss”.
id	int64 Identyfikator zasobu.
name	string Opcjonalna nazwa komponentu.
tracking_url_template	string Szablon adresu URL do tworzenia linku monitorującego.
final_url_suffix	string Szablon URL do dołączania parametrów do adresów URL stron docelowych wyświetlanych w ramach śledzenia równoległego.
engine_status	AssetEngineStatus Stan wyszukiwarki komponentu.
Pole zbiorcze asset_data. Konkretny typ komponentu. asset_data może mieć tylko jedną z tych wartości:
youtube_video_asset	YoutubeVideoAsset komponent wideo w YouTube,
image_asset	ImageAsset Komponent z obrazem.
text_asset	TextAsset Komponent tekstowy.
callout_asset	UnifiedCalloutAsset Ujednolicony komponent z objaśnieniem.
sitelink_asset	UnifiedSitelinkAsset Ujednolicony komponent z linkami do podstron.
page_feed_asset	UnifiedPageFeedAsset Ujednolicony plik z adresami stron docelowych.
mobile_app_asset	MobileAppAsset Komponent z linkiem do aplikacji mobilnej.
call_asset	UnifiedCallAsset Ujednolicony komponent do wykonywania połączeń.
call_to_action_asset	CallToActionAsset Komponent z wezwaniem do działania.
location_asset	UnifiedLocationAsset Ujednolicony komponent z lokalizacją.

AssetGroup

Grupa plików. Element AssetGroupAsset służy do łączenia komponentu z grupą plików. Element AssetGroupSignal służy do powiązania sygnału z grupą plików.

Pola
resource_name	string Nazwa zasobu grupy plików. Nazwy zasobów grup plików mają postać: customers/{customer_id}/assetGroups/{asset_group_id}
id	int64 Identyfikator grupy plików.
campaign	string Kampania, z którą jest powiązana ta grupa plików. Komponent połączony z grupą plików.
name	string Wymagane. Nazwa grupy plików. Wymagane. Musi mieć długość od 1 do 128 znaków. Musi być unikalny w obrębie kampanii.
final_urls[]	string Lista końcowych adresów URL po wszystkich przekierowaniach między domenami. W kampaniach Performance Max adresy URL domyślnie kwalifikują się do rozwinięcia, chyba że zrezygnujesz z tej funkcji.
final_mobile_urls[]	string Lista końcowych mobilnych adresów URL po wszystkich przekierowaniach między domenami. W kampaniach Performance Max adresy URL domyślnie kwalifikują się do rozwinięcia, chyba że zrezygnujesz z tej funkcji.
status	AssetGroupStatus Stan grupy plików.
path1	string Pierwsza część tekstu, która może być dołączona do adresu URL wyświetlanego w reklamie.
path2	string Druga część tekstu, która może być dołączona do adresu URL wyświetlanego w reklamie. To pole można ustawić tylko wtedy, gdy ustawiona jest ścieżka1.
ad_strength	AdStrength Ogólna skuteczność reklamy w tej grupie plików.

AssetGroupAsset

AssetGroupAsset to połączenie między komponentem a grupą plików. Dodanie obiektu AssetGroupAsset łączy komponent z grupą plików.

Pola
resource_name	string Nazwa zasobu komponentu grupy plików. Nazwa zasobu komponentu grupy plików ma postać: customers/{customer_id}/assetGroupAssets/{asset_group_id}~{asset_id}~{field_type}
asset_group	string Grupa plików, z którą jest połączony ten komponent grupy plików.
asset	string Komponent, z którym jest połączony komponent grupy plików.
field_type	AssetFieldType Opis miejsca docelowego komponentu w grupie plików. Na przykład: HEADLINE, YOUTUBE_VIDEO itp.
status	AssetLinkStatus Stan połączenia między komponentem a grupą plików.

AssetGroupAssetCombinationData

Dane o kombinacjach komponentów w grupach plików

Pola
asset_combination_served_assets[]	AssetUsage Wyświetlane komponenty.

AssetGroupListingGroupFilter

AssetGroupListingGroupFilter reprezentuje węzeł drzewa filtrów grupy informacji o produktach w grupie plików.

Pola
resource_name	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/{customer_id}/assetGroupListingGroupFilters/{asset_group_id}~{listing_group_filter_id}
asset_group	string Grupa plików, do której należy ten filtr grupy informacji o produktach w grupie plików.
id	int64 Identyfikator ListingGroupFilter.
type	ListingGroupFilterType Typ węzła filtra grupy informacji o produktach.
vertical	ListingGroupFilterVertical Pion, który reprezentuje bieżące drzewo węzłów. Wszystkie węzły w tym samym drzewie muszą należeć do tej samej branży.
case_value	ListingGroupFilterDimension Wartość wymiaru, za pomocą której ta grupa wizytówek zawęża zakres swojej grupy nadrzędnej. Nieokreślone w przypadku grupy głównej.
parent_listing_group_filter	string Nazwa zasobu podziału nadrzędnej grupy produktów. Wartość null w przypadku węzła filtra głównej grupy informacji o produktach.
path	ListingGroupFilterDimensionPath Ścieżka wymiarów definiujących ten filtr grupy informacji o produktach.

AssetGroupSignal

AssetGroupSignal reprezentuje sygnał w grupie plików. Sygnał informuje kampanię Performance Max, którzy użytkownicy z największym prawdopodobieństwem dokonają konwersji. Kampania Performance Max używa sygnału, aby znaleźć nowych użytkowników o zbliżonych lub silniejszych zamiarach i uzyskać więcej konwersji w wyszukiwarce, sieci reklamowej, sieci partnerów wideo oraz innych usługach.

Pola
resource_name	string Nazwa zasobu sygnału grupy plików. Nazwa zasobu sygnału grupy plików ma postać: customers/{customer_id}/assetGroupSignals/{asset_group_id}~{signal_id}
asset_group	string Grupa plików, do której należy ten sygnał grupy plików.
Pole zbiorcze signal. Sygnał grupy plików. signal może mieć tylko jedną z tych wartości:
audience	AudienceInfo Sygnał dotyczący odbiorców, który ma być używany przez kampanię Performance Max.

AssetGroupTopCombinationView

Widok wykorzystania najlepszych kombinacji komponentów w grupach plików.

Pola
resource_name	string Nazwa zasobu widoku najlepszych kombinacji w grupie plików. Nazwy zasobów widoku Najpopularniejsze kombinacje w grupie plików mają format: `"customers/{customer_id}/assetGroupTopCombinationViews/{asset_group_id}~{asset_combination_category}"
asset_group_top_combinations[]	AssetGroupAssetCombinationData Najpopularniejsze kombinacje komponentów, które były wyświetlane razem.

AssetSet

Zbiór komponentów reprezentujący kolekcję komponentów. Użyj AssetSetAsset, aby połączyć komponent z zestawem komponentów.

Pola
id	int64 Identyfikator zestawu komponentów.
resource_name	string Nazwa zasobu zestawu komponentów. Nazwy zasobów zestawu komponentów mają format: customers/{customer_id}/assetSets/{asset_set_id}

AssetSetAsset

AssetSetAsset to połączenie między komponentem a zestawem komponentów. Dodanie obiektu AssetSetAsset łączy komponent z zestawem komponentów.

Pola
resource_name	string Nazwa zasobu zasobu w zbiorze zasobów. Nazwy zasobów komponentów w zestawie komponentów mają format: customers/{customer_id}/assetSetAssets/{asset_set_id}~{asset_id}
asset_set	string Zestaw komponentów, z którym jest powiązany ten zasób w zbiorze komponentów.
asset	string Komponent, z którym jest połączony ten zasób w zbiorze zasobów.
status	AssetSetAssetStatus Stan zasobu w zbiorze zasobów. Tylko do odczytu.

Odbiorcy

Odbiorcy to efektywne ustawienie kierowania, które umożliwia łączenie różnych atrybutów segmentów, np. szczegółowych danych demograficznych i podobnych zainteresowań, aby tworzyć listy odbiorców reprezentujące sekcje segmentów docelowych.

Pola
resource_name	string Nazwa zasobu listy odbiorców. Nazwy list odbiorców mają postać: customers/{customer_id}/audiences/{audience_id}
id	int64 Identyfikator listy odbiorców.
name	string Wymagane. Nazwa listy odbiorców. Powinien być unikalny wśród wszystkich list odbiorców. Musi mieć długość od 1 do 255 znaków.
description	string Opis tych odbiorców.

BiddingStrategy

strategię ustalania stawek,

Pola
resource_name	string Nazwa zasobu strategii ustalania stawek. Nazwy zasobów strategii ustalania stawek mają postać: customers/{customer_id}/biddingStrategies/{bidding_strategy_id}
status	BiddingStrategyStatus Stan strategii ustalania stawek. To pole jest tylko do odczytu.
type	BiddingStrategyType Typ strategii ustalania stawek. Utwórz strategię ustalania stawek, ustawiając schemat ustalania stawek. To pole jest tylko do odczytu.
currency_code	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 strategii. Domyślnie jest to waluta konta klienta menedżera. W przypadku klientów wyświetlających reklamy tego pola nie można ustawić. Wszystkie strategie u klienta wyświetlającego reklamy domyślnie używają waluty tego klienta. W każdym przypadku pole effective_currency_code zwraca walutę używaną przez strategię.
id	int64 Identyfikator strategii ustalania stawek.
name	string Nazwa strategii ustalania stawek. Wszystkie strategie ustalania stawek na koncie muszą mieć różne nazwy. Długość tego ciągu powinna wynosić od 1 do 255 bajtów w formacie UTF-8 (po przycięciu).
effective_currency_code	string Waluta używana przez strategię ustalania stawek (trzyliterowy kod ISO 4217). W przypadku strategii ustalania stawek na kontach klientów menedżera jest to waluta ustawiona przez reklamodawcę podczas tworzenia strategii. W przypadku wyświetlania reklam klientom jest to kod waluty klienta. Dane strategii ustalania stawek są podawane w tej walucie. To pole jest tylko do odczytu.
campaign_count	int64 Liczba kampanii powiązanych z tą strategią ustalania stawek. To pole jest tylko do odczytu.
non_removed_campaign_count	int64 Liczba nieusuniętych kampanii powiązanych z tą strategią ustalania stawek. To pole jest tylko do odczytu.
Pole zbiorcze scheme. Schemat określania stawek. Można ustawić tylko jedną z tych wartości. Pole scheme może mieć tylko jedną z tych wartości:
enhanced_cpc	EnhancedCpc Strategia ustalania stawek, która podnosi stawki za kliknięcia, które z większym prawdopodobieństwem prowadzą do konwersji, oraz obniża stawki za kliknięcia, w przypadku których takie prawdopodobieństwo jest mniejsze.
maximize_conversion_value	MaximizeConversionValue Strategia automatycznego określania stawek, która pomaga uzyskać jak największą wartość konwersji w kampaniach w ramach określonego budżetu.
maximize_conversions	MaximizeConversions Strategia automatycznego określania stawek, która pomaga uzyskać jak najwięcej konwersji w kampaniach w ramach określonego budżetu.
target_cpa	TargetCpa Strategia ustalania stawek, która ustala stawki tak, aby pomóc Ci uzyskać jak największą liczbę konwersji przy wybranym przez Ciebie docelowym koszcie pozyskania (CPA).
target_impression_share	TargetImpressionShare Strategia ustalania stawek, która automatycznie optymalizuje stawki pod kątem wybranego odsetka wyświetleń.
target_outrank_share	TargetOutrankShare Strategia ustalania stawek, która ustala stawki na podstawie docelowego odsetka aukcji, w których reklamodawca powinien uzyskać wyższą pozycję niż określony konkurent. To pole zostało wycofane. Utworzenie nowej strategii ustalania stawek z tym polem lub dołączenie do kampanii strategii ustalania stawek z tym polem nie powiedzie się. Zmiany strategii, które już mają wypełniony ten schemat, są dozwolone.
target_roas	TargetRoas Strategia ustalania stawek, która pomaga zmaksymalizować przychody przy zachowaniu określonego docelowego zwrotu z nakładów na reklamę (ROAS).
target_spend	TargetSpend Strategia ustalania stawek, która ustala stawki tak, aby umożliwić Ci uzyskanie jak największej liczby kliknięć w ramach budżetu.

Kampania

kampania,

Pola
resource_name	string Nazwa zasobu kampanii. Nazwy zasobów kampanii mają postać: customers/{customer_id}/campaigns/{campaign_id}
status	CampaignStatus Stan kampanii. Gdy dodasz nową kampanię, jej stan domyślnie będzie ustawiony na WŁĄCZONA.
serving_status	CampaignServingStatus Stan wyświetlania reklam w kampanii.
bidding_strategy_system_status	BiddingStrategySystemStatus Stan systemu strategii ustalania stawek w kampanii.
ad_serving_optimization_status	AdServingOptimizationStatus Stan optymalizacji wyświetlania reklam w kampanii.
advertising_channel_type	AdvertisingChannelType Główny cel wyświetlania reklam w kampanii. Opcje kierowania można doprecyzować w network_settings. To pole jest wymagane i nie powinno być puste podczas tworzenia nowych kampanii. Można go ustawić tylko podczas tworzenia kampanii. Po utworzeniu kampanii nie można zmienić tego pola.
advertising_channel_sub_type	AdvertisingChannelSubType Opcjonalne doprecyzowanie do advertising_channel_type. Musi to być prawidłowy podtyp głównego typu kanału. Można go ustawić tylko podczas tworzenia kampanii. Po utworzeniu kampanii nie można zmienić tego pola.
url_custom_parameters[]	CustomParameter Lista mapowań używanych do zastępowania tagów parametrów niestandardowych w zmiennych tracking_url_template, final_urls lub mobile_final_urls.
real_time_bidding_setting	RealTimeBiddingSetting Ustawienia ustalania stawek w czasie rzeczywistym, funkcji dostępnej tylko w kampaniach kierowanych na sieć Ad Exchange.
network_settings	NetworkSettings Ustawienia sieci dla kampanii.
dynamic_search_ads_setting	DynamicSearchAdsSetting Ustawienie służące do kontrolowania dynamicznych reklam w wyszukiwarce.
shopping_setting	ShoppingSetting Ustawienie służące do kontrolowania kampanii produktowych.
geo_target_type_setting	GeoTargetTypeSetting Ustawienie geotargetowania reklam.
effective_labels[]	string Nazwy zasobów obowiązujących etykiet dołączonych do tej kampanii. Etykieta obowiązująca to etykieta odziedziczona lub przypisana bezpośrednio do tej kampanii.
labels[]	string Nazwy zasobów etykiet dołączonych do tej kampanii.
bidding_strategy_type	BiddingStrategyType Typ strategii ustalania stawek. Strategię ustalania stawek można utworzyć, ustawiając schemat ustalania stawek w celu utworzenia standardowej strategii ustalania stawek lub pole bidding_strategy w celu utworzenia strategii portfolio ustalania stawek. To pole jest tylko do odczytu.
accessible_bidding_strategy	string Nazwa zasobu AccessibleBiddingStrategy, czyli widoku tylko do odczytu nieograniczonych atrybutów dołączonej strategii portfolio ustalania stawek zidentyfikowanej przez „bidding_strategy”. Pusta, 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 AccessibleBiddingStrategy. Natomiast atrybuty ograniczone są dostępne tylko dla klienta, który jest właścicielem strategii, i jego menedżerów. Ograniczone atrybuty można odczytywać tylko z zasobu BiddingStrategy.
frequency_caps[]	FrequencyCapEntry Lista, która ogranicza częstotliwość wyświetlania reklam z tej kampanii poszczególnym użytkownikom.
selective_optimization	SelectiveOptimization Ustawienie selektywnej optymalizacji dla tej kampanii, które obejmuje zestaw działań powodujących konwersję, pod kątem których ma być optymalizowana ta kampania. Ta funkcja ma zastosowanie tylko do kampanii promujących aplikacje, które używają wartości MULTI_CHANNEL w przypadku parametru AdvertisingChannelType oraz wartości APP_CAMPAIGN lub APP_CAMPAIGN_FOR_ENGAGEMENT w przypadku parametru AdvertisingChannelSubType.
optimization_goal_setting	OptimizationGoalSetting Ustawienie celu optymalizacji tej kampanii, które obejmuje zestaw typów celów optymalizacji.
tracking_setting	TrackingSetting Ustawienia na poziomie kampanii dotyczące informacji o śledzeniu.
engine_id	string Identyfikator kampanii na zewnętrznym koncie wyszukiwarki. To pole jest przeznaczone tylko dla kont innych niż Google Ads, np. Yahoo Japan, Microsoft, Baidu itp. W przypadku jednostki Google Ads użyj zamiast niego pola „campaign.id”.
excluded_parent_asset_field_types[]	AssetFieldType Typy pól komponentów, które należy wykluczyć z tej kampanii. Linki do komponentów z tymi typami pól nie będą dziedziczone przez tę kampanię z wyższego poziomu.
create_time	string Sygnatura czasowa utworzenia tej kampanii. Sygnatura czasowa jest podana w strefie czasowej klienta i w formacie „rrrr-MM-dd HH:mm:ss”. Pole create_time zostanie wycofane w wersji 1. Zamiast niej używaj kolumny creation_time.
creation_time	string Sygnatura czasowa utworzenia tej kampanii. Sygnatura czasowa jest podana w strefie czasowej klienta w formacie „rrrr-MM-dd GG:mm:ss”.
last_modified_time	string Data i godzina ostatniej modyfikacji tej kampanii. Data i godzina są podane w strefie czasowej klienta w formacie „rrrr-MM-dd HH:mm:ss.ssssss”.
feed_types[]	AssetSetType Typy plików danych, które są połączone bezpośrednio z tą kampanią.
id	int64 Identyfikator kampanii.
name	string Nazwa kampanii To pole jest wymagane i nie powinno być puste podczas tworzenia nowych kampanii. Nie może zawierać znaków null (punkt kodowy 0x0), znaku nowego wiersza (punkt kodowy 0xA) ani przejścia do nowej linii (punkt kodowy 0xD).
tracking_url_template	string Szablon adresu URL do tworzenia linku monitorującego.
campaign_budget	string Nazwa zasobu budżetu kampanii.
start_date	string Data rozpoczęcia kampanii w strefie czasowej klienta w formacie RRRR-MM-DD.
end_date	string Ostatni dzień kampanii w strefie czasowej klienta wyświetlającego reklamy w formacie RRRR-MM-DD. Domyślnie ustawiona jest data 30.12.2037, co oznacza, że kampania będzie działać bezterminowo. Aby ustawić datę zakończenia dotychczasowej kampanii na 30 grudnia 2037 r., ustaw to pole na 2037-12-30.
final_url_suffix	string Sufiks używany do dołączania parametrów zapytania do stron docelowych wyświetlanych ze śledzeniem równoległym.
url_expansion_opt_out	bool Wartość logiczna określająca, czy rozwinięcie adresu URL do bardziej precyzyjnych adresów URL jest wyłączone. Jeśli jest wyłączone (wartość „true”), kierowanie jest ustawione tylko na końcowe adresy URL w grupie plików lub adresy URL określone w plikach danych o firmie lub w Google Merchant Center reklamodawcy. Jeśli ta opcja jest włączona (wartość „false”), kierowanie będzie obejmować całą domenę. To pole można ustawić tylko w kampaniach Performance Max, w których wartość domyślna to „false”.
Pole zbiorcze campaign_bidding_strategy. Strategia ustalania stawek w kampanii. Musi to być strategia portfolio (utworzona za pomocą usługi BiddingStrategy) lub standardowa, która jest osadzona w kampanii. Pole campaign_bidding_strategy może mieć tylko jedną z tych wartości:
bidding_strategy	string Nazwa zasobu strategii portfolio ustalania stawek używanej w kampanii.
manual_cpa	ManualCpa Standardowa strategia samodzielnego ustalania stawek CPA. Strategia samodzielnego ustalania stawek, która umożliwia reklamodawcy ustawianie stawek za działania określone przez reklamodawcę. Obsługiwane tylko w kampaniach Usług Lokalnych.
manual_cpc	ManualCpc Standardowa strategia samodzielnego ustawiania stawek CPC. Ręczne określanie stawek na podstawie kliknięć, w którym użytkownik płaci za kliknięcie.
manual_cpm	ManualCpm Standardowa strategia samodzielnego ustalania stawek CPM. Ręczne ustalanie stawek na podstawie wyświetleń, w którym użytkownik płaci za tysiąc wyświetleń.
maximize_conversions	MaximizeConversions Standardowa strategia ustalania stawek Maksymalizacja liczby konwersji, która automatycznie maksymalizuje liczbę konwersji w ramach określonego budżetu.
maximize_conversion_value	MaximizeConversionValue Standardowa strategia określania stawek Maksymalizacja wartości konwersji, która automatycznie ustala stawki tak, aby zmaksymalizować przychody w ramach określonego budżetu.
target_cpa	TargetCpa Standardowa strategia określania docelowej stawki CPA, która automatycznie ustala stawki, aby pomóc Ci uzyskać jak największą liczbę konwersji przy wybranym przez Ciebie docelowym koszcie pozyskania (CPA).
target_impression_share	TargetImpressionShare Strategia ustalania stawek Docelowy udział w wyświetleniach. Strategia automatycznego określania stawek, która ustala stawki tak, aby uzyskać wybrany odsetek wyświetleń.
target_roas	TargetRoas Standardowa strategia ustalania stawek Docelowy ROAS, która automatycznie maksymalizuje przychody przy zachowaniu określonego docelowego zwrotu z nakładów na reklamę (ROAS).
target_spend	TargetSpend Standardowa strategia ustalania stawek pod kątem docelowych wydatków, która automatycznie ustala stawki tak, aby pomóc Ci uzyskać jak najwięcej kliknięć w ramach budżetu.
percent_cpc	PercentCpc Standardowa strategia ustalania stawek Procent CPC, w której stawki stanowią ułamek reklamowanej ceny niektórych towarów lub usług.
target_cpm	TargetCpm Strategia ustalania stawek, która automatycznie optymalizuje koszt tysiąca wyświetleń.

DynamicSearchAdsSetting

Ustawienie służące do kontrolowania dynamicznych reklam w wyszukiwarce.

Pola
domain_name	string Wymagane. Nazwa domeny internetowej, której dotyczy to ustawienie, np. „google.com” lub „www.google.com”.
language_code	string Wymagane. Kod języka określający język domeny, np. „pl”.
use_supplied_urls_only	bool Określa, czy kampania używa wyłącznie adresów URL dostarczonych przez reklamodawcę.

GeoTargetTypeSetting

Reprezentuje zbiór ustawień związanych z kierowaniem reklam na obszar geograficzny.

Pola
positive_geo_target_type	PositiveGeoTargetType Ustawienie używane w tej kampanii do kierowania na lokalizację.
negative_geo_target_type	NegativeGeoTargetType Ustawienie używane w tej kampanii do wykluczania kierowania geograficznego.

NetworkSettings

Ustawienia sieci dla kampanii.

Pola
target_google_search	bool Czy reklamy będą wyświetlane z wynikami wyszukiwania w Google.com.
target_search_network	bool Określa, czy reklamy będą wyświetlane w witrynach partnerów w sieci wyszukiwania Google (wymaga, aby target_google_search miało wartość true).
target_content_network	bool Określa, czy reklamy będą wyświetlane w określonych miejscach docelowych w sieci reklamowej Google. Miejsca docelowe są określane za pomocą kryterium Miejsce docelowe.
target_partner_search_network	bool Określa, czy reklamy będą wyświetlane w sieci partnerów Google. Ta opcja jest dostępna tylko na wybranych kontach partnerów Google.

OptimizationGoalSetting

Ustawienie celu optymalizacji tej kampanii, które obejmuje zestaw typów celów optymalizacji.

Pola
optimization_goal_types[]	OptimizationGoalType Lista typów celów optymalizacji.

SelectiveOptimization

Ustawienie selektywnej optymalizacji dla tej kampanii, które obejmuje zestaw działań powodujących konwersję, pod kątem których ma być optymalizowana ta kampania. Ta funkcja ma zastosowanie tylko do kampanii promujących aplikacje, które używają wartości MULTI_CHANNEL w przypadku parametru AdvertisingChannelType oraz wartości APP_CAMPAIGN lub APP_CAMPAIGN_FOR_ENGAGEMENT w przypadku parametru AdvertisingChannelSubType.

Pola
conversion_actions[]	string Wybrany zestaw nazw zasobów działań powodujących konwersję do optymalizacji tej kampanii.

ShoppingSetting

Ustawienie kampanii produktowych. Określa zakres produktów, które mogą być reklamowane w kampanii, oraz sposób, w jaki ta kampania wchodzi w interakcje z innymi kampaniami produktowymi.

Pola
feed_label	string Etykieta pliku danych produktów, które mają być uwzględnione w kampanii. Można ustawić tylko jedną wartość: feed_label lub sales_country. Jeśli zamiast pola sales_country użyjesz pola feed_label, akceptuje ono 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.
use_vehicle_inventory	bool Określa, czy kierować reklamy na zasoby reklamowe z listą pojazdów.
merchant_id	int64 Identyfikator konta Merchant Center. To pole jest wymagane w przypadku operacji tworzenia. Tego pola nie można zmienić w przypadku kampanii produktowych.
sales_country	string Kraj sprzedaży produktów, które mają być uwzględnione w kampanii.
campaign_priority	int32 Priorytet kampanii. Kampanie o wyższych priorytetach liczbowych mają pierwszeństwo przed kampaniami o niższych priorytetach. To pole jest wymagane w przypadku kampanii produktowych, a jego wartość musi mieścić się w zakresie od 0 do 2 włącznie. To pole jest opcjonalne w przypadku inteligentnych kampanii produktowych, ale jeśli jest ustawione, musi mieć wartość 3.
enable_local	bool Czy uwzględniać produkty dostępne lokalnie.

TrackingSetting

Ustawienia na poziomie kampanii dotyczące informacji o śledzeniu.

Pola
tracking_url	string Adres URL używany do dynamicznego śledzenia.

CampaignAsset

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

Pola
resource_name	string Nazwa zasobu komponentu kampanii. Nazwy zasobów CampaignAsset mają postać: customers/{customer_id}/campaignAssets/{campaign_id}~{asset_id}~{field_type}
status	AssetLinkStatus Stan komponentu kampanii.
campaign	string Kampania, z którą jest połączony komponent.
asset	string Komponent połączony z kampanią.

Zestaw komponentów kampanii

Zestaw komponentów kampanii to połączenie między kampanią a zestawem komponentów. Dodanie obiektu CampaignAssetSet powoduje powiązanie zestawu komponentów z kampanią.

Pola
resource_name	string Nazwa zasobu zestawu komponentów kampanii. Nazwy zasobów komponentów w zestawie komponentów mają format: customers/{customer_id}/campaignAssetSets/{campaign_id}~{asset_set_id}
campaign	string Kampania, z którą jest połączony ten zestaw komponentów.
asset_set	string Zestaw komponentów powiązany z kampanią.
status	AssetSetLinkStatus Stan komponentu zestawu komponentów kampanii. Tylko do odczytu.

CampaignAudienceView

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

Pola
resource_name	string Nazwa zasobu widoku listy odbiorców kampanii. Nazwy zasobów widoku odbiorców kampanii mają postać: customers/{customer_id}/campaignAudienceViews/{campaign_id}~{criterion_id}

CampaignBudget

budżet kampanii,

Pola
resource_name	string Nazwa zasobu budżetu kampanii. Nazwy zasobów budżetu kampanii mają postać: customers/{customer_id}/campaignBudgets/{campaign_budget_id}
delivery_method	BudgetDeliveryMethod Metoda wyświetlania, która określa tempo wydawania budżetu kampanii. Jeśli nie zostanie określony w operacji tworzenia, domyślnie przyjmuje wartość STANDARD.
period	BudgetPeriod Okres, w którym ma zostać wykorzystany budżet. Jeśli nie zostanie podana, domyślnie przyjmuje wartość DAILY.
amount_micros	int64 Kwota budżetu w walucie lokalnej konta. Kwota jest podana w milionowych częściach, gdzie milion odpowiada jednej jednostce waluty. Miesięczne wydatki są ograniczone do 30,4-krotności tej kwoty.

CampaignCriterion

Kryterium kampanii.

Pola
resource_name	string Nazwa zasobu kryterium kampanii. Nazwy zasobów kryteriów kampanii mają postać: customers/{customer_id}/campaignCriteria/{campaign_id}~{criterion_id}
display_name	string Wyświetlana nazwa kryterium. To pole jest ignorowane w przypadku operacji mutacji.
type	CriterionType Typ kryterium.
status	CampaignCriterionStatus Stan kryterium.
last_modified_time	string Data i godzina ostatniej modyfikacji tego kryterium kampanii. Data i godzina są podane w strefie czasowej klienta w formacie „rrrr-MM-dd HH:mm:ss.ssssss”.
criterion_id	int64 Identyfikator kryterium. To pole jest ignorowane podczas mutacji.
bid_modifier	float Modyfikator stawek, gdy kryterium jest spełnione. Modyfikator musi mieścić się w zakresie od 0,1 do 10,0. Większość typów kryteriów, na które można kierować reklamy, obsługuje modyfikatory. Aby zrezygnować z typu urządzenia, wpisz 0.
negative	bool Określ, czy chcesz kierować reklamy na kryterium (false), czy je wykluczać (true).
Pole zbiorcze criterion. Kryterium kampanii. Musi być ustawiona dokładnie jedna z tych wartości. Pole criterion może mieć tylko jedną z tych wartości:
keyword	KeywordInfo Słowo kluczowe.
location	LocationInfo Lokalizacja.
device	DeviceInfo Urządzenie.
age_range	AgeRangeInfo Przedział wiekowy.
gender	GenderInfo Płeć.
user_list	UserListInfo Lista użytkowników.
language	LanguageInfo Język.
webpage	WebpageInfo Strona internetowa.
location_group	LocationGroupInfo Grupa lokalizacji

CampaignEffectiveLabel

Reprezentuje relację między kampanią a skuteczną etykietą. Etykieta obowiązująca to etykieta odziedziczona lub przypisana bezpośrednio do tej kampanii.

Pola
resource_name	string Nazwa zasobu. Nazwy zasobów CampaignEffectivelabel mają format: customers/{owner_customer_id}/campaignEffectiveLabels/{campaign_id}~{label_id}
campaign	string Kampania, do której jest dołączona etykieta skuteczna.
label	string Etykieta przypisana do kampanii.
owner_customer_id	int64 Identyfikator klienta, do którego należy efektywna etykieta.

CampaignLabel

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

Pola
resource_name	string Nazwa zasobu. Nazwy zasobów etykiet kampanii mają postać: customers/{owner_customer_id}/campaignLabels/{campaign_id}~{label_id}
campaign	string Kampania, do której jest dołączona etykieta.
label	string Etykieta przypisana do kampanii.
owner_customer_id	int64 Identyfikator klienta, który jest właścicielem etykiety.

CartDataSalesView

Widok sprzedaży danych koszyka.

Pola
resource_name	string Nazwa zasobu widoku sprzedaży danych koszyka. Nazwy zasobów widoku sprzedaży z użyciem danych koszyka mają postać: customers/{customer_id}/cartDataSalesView

Konwersja

konwersję.

Pola
resource_name	string Nazwa zasobu konwersji. Nazwy zasobów konwersji mają postać: customers/{customer_id}/conversions/{ad_group_id}~{criterion_id}~{ds_conversion_id}
id	int64 Identyfikator konwersji
criterion_id	int64 Identyfikator kryterium Search Ads 360. Wartość 0 oznacza, że kryterium nie ma atrybutu.
merchant_id	int64 Identyfikator konta asortymentu Search Ads 360 zawierającego kliknięty produkt. Search Ads 360 generuje ten identyfikator po połączeniu konta asortymentu w Search Ads 360.
ad_id	int64 Identyfikator reklamy. Wartość 0 oznacza, że reklama nie jest przypisana.
click_id	string Unikalny ciąg znaków dotyczący wizyty, do której przypisana jest konwersja, przekazywany na stronę docelową jako parametr adresu URL identyfikatora kliknięcia.
visit_id	int64 Identyfikator wizyty w Search Ads 360, do której przypisana jest konwersja.
advertiser_conversion_id	string W przypadku konwersji offline jest to identyfikator podany przez reklamodawców. Jeśli reklamodawca nie poda takiego identyfikatora, wygeneruje go Search Ads 360. W przypadku konwersji online jest to kolumna id lub kolumna floodlight_order_id w zależności od instrukcji Floodlight reklamodawcy.
product_id	string Identyfikator klikniętego produktu.
product_channel	ProductChannel Kanał sprzedaży klikniętego produktu: online lub lokalny.
product_language_code	string Język (ISO-639-1) ustawiony dla pliku danych Merchant Center zawierającego dane produktu.
product_store_id	string Sklep w klikniętej reklamie lokalnego asortymentu produktów. Temu sklepowi musi odpowiadać jego identyfikator użyty w pliku danych o produktach dostępnych lokalnie.
product_country_code	string Kraj (w formacie ISO-3166) zarejestrowany na potrzeby pliku danych o asortymencie, który zawiera kliknięty produkt.
attribution_type	AttributionType Do czego jest przypisana konwersja: wizyty lub słowa kluczowego i reklamy.
conversion_date_time	string Sygnatura czasowa zdarzenia konwersji.
conversion_last_modified_date_time	string Sygnatura czasowa ostatniej modyfikacji konwersji.
conversion_visit_date_time	string Sygnatura czasowa wizyty, do której przypisana jest konwersja.
conversion_quantity	int64 Liczba produktów zarejestrowanych przez konwersję określona przez parametr adresu URL qty. Reklamodawca jest odpowiedzialny za dynamiczne wypełnianie parametru (np. liczby produktów sprzedanych w ramach konwersji). W przeciwnym razie domyślnie przyjmuje on wartość 1.
conversion_revenue_micros	int64 Skorygowane przychody w mikrojednostkach w przypadku zdarzenia konwersji. Zawsze będzie to waluta konta wyświetlającego reklamy.
floodlight_original_revenue	int64 Pierwotne, niezmienione przychody powiązane ze zdarzeniem Floodlight (w walucie bieżącego raportu) przed wprowadzeniem zmian przez instrukcję waluty Floodlight.
floodlight_order_id	string Identyfikator zamówienia Floodlight podany przez reklamodawcę na potrzeby konwersji.
status	ConversionStatus Stan konwersji, czyli WŁĄCZONA lub USUNIĘTA.
asset_id	int64 Identyfikator komponentu, z którym użytkownik wszedł w interakcję podczas zdarzenia konwersji.
asset_field_type	AssetFieldType Typ pola komponentu zdarzenia konwersji.

ConversionAction

działanie powodujące konwersję.

Pola
resource_name	string Nazwa zasobu działania powodującego konwersję. Nazwy zasobów działań powodujących konwersję mają postać: customers/{customer_id}/conversionActions/{conversion_action_id}
creation_time	string Sygnatura czasowa utworzenia aktywności Floodlight sformatowana zgodnie z normą ISO 8601.
status	ConversionActionStatus Stan tego działania powodującego konwersję w zakresie gromadzenia zdarzeń konwersji.
type	ConversionActionType Typ tego działania powodującego konwersję.
category	ConversionActionCategory Kategoria konwersji raportowanych w przypadku tego działania powodującego konwersję.
value_settings	ValueSettings Ustawienia związane z wartością zdarzeń konwersji powiązanych z tym działaniem powodującym konwersję.
attribution_model_settings	AttributionModelSettings Ustawienia związane z modelem atrybucji tego działania powodującego konwersję.
floodlight_settings	FloodlightSettings Ustawienia Floodlight dla typów konwersji Floodlight.
id	int64 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ę.
primary_for_goal	bool Jeśli bit primary_for_goal działania powodującego konwersję ma wartość false, działanie powodujące konwersję nie może być używane do określania stawek we wszystkich kampaniach, niezależnie od celu konwersji klienta lub celu konwersji kampanii. Cele konwersji niestandardowych nie uwzględniają jednak parametru primary_for_goal, więc jeśli kampania ma skonfigurowany cel konwersji niestandardowej z działaniem powodującym konwersję, w którym primary_for_goal = false, to działanie powodujące konwersję nadal jest dostępne do określania stawek. Jeśli nie zostanie ustawiony, domyślnie przyjmie wartość „true”. W wersji 9 parametr primary_for_goal można ustawić na wartość false tylko po utworzeniu za pomocą operacji „update”, ponieważ nie jest on zadeklarowany jako opcjonalny.
owner_customer	string Nazwa zasobu klienta będącego właścicielem działania powodującego konwersję lub wartość null, jeśli jest to działanie powodujące konwersję zdefiniowane przez system.
include_in_client_account_conversions_metric	bool Czy to działanie powodujące konwersję powinno być uwzględniane w danych „client_account_conversions”.
include_in_conversions_metric	bool Czy to działanie powodujące konwersję powinno być uwzględniane w danych „konwersje”.
click_through_lookback_window_days	int64 Maksymalna liczba dni, które mogą upłynąć między interakcją (np. kliknięciem) a zdarzeniem konwersji.
app_id	string Identyfikator aplikacji dla działania powodującego konwersję w aplikacji.

AttributionModelSettings

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

Pola
attribution_model	AttributionModel Typ modelu atrybucji tego działania powodującego konwersję.
data_driven_model_status	DataDrivenModelStatus Stan modelu atrybucji opartej na danych dla działania powodującego konwersję.

FloodlightSettings

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

Pola
activity_group_tag	string Ciąg znaków używany do identyfikowania grupy aktywności Floodlight podczas raportowania konwersji.
activity_tag	string Ciąg znaków używany do identyfikowania aktywności Floodlight podczas raportowania konwersji.
activity_id	int64 Identyfikator aktywności Floodlight w usłudze DoubleClick Campaign Manager (DCM).

ValueSettings

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

Pola
default_value	double Wartość, która ma być używana, 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.
default_currency_code	string Kod waluty, który ma być używany, gdy zdarzenia konwersji dla 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.
always_use_default_value	bool Określa, czy w przypadku tego działania powodującego konwersję zamiast wartości i kodu waluty określonych w zdarzeniach konwersji mają być używane wartość domyślna i domyślny kod waluty.

ConversionCustomVariable

Niestandardowa zmienna konwersji. Więcej informacji znajdziesz w artykule „Informacje o niestandardowych danych i wymiarach Floodlight w nowej wersji Search Ads 360” na stronie https://support.google.com/sa360/answer/13567857.

Pola
resource_name	string Nazwa zasobu zmiennej niestandardowej konwersji. Nazwy zasobów niestandardowych zmiennych konwersji mają postać: customers/{customer_id}/conversionCustomVariables/{conversion_custom_variable_id}
id	int64 Identyfikator niestandardowej zmiennej konwersji.
name	string Wymagane. Nazwa zmiennej niestandardowej konwersji. Nazwa powinna być unikalna. Maksymalna długość nazwy to 100 znaków. Nie powinno być żadnych dodatkowych spacji przed ani po nich.
tag	string Wymagane. Tag zmiennej niestandardowej konwersji. Tag powinien być unikalny i składać się z litery „u”, po której bezpośrednio następuje liczba mniejsza lub równa 100. Na przykład: „u4”.
status	ConversionCustomVariableStatus Stan zmiennej niestandardowej konwersji na potrzeby naliczania zdarzeń konwersji.
owner_customer	string Nazwa zasobu klienta, który jest właścicielem zmiennej niestandardowej konwersji.
family	ConversionCustomVariableFamily Rodzina zmiennej niestandardowej konwersji.
cardinality	ConversionCustomVariableCardinality Moc zbioru zmiennej niestandardowej konwersji.
floodlight_conversion_custom_variable_info	FloodlightConversionCustomVariableInfo Pola niestandardowych zmiennych konwersji Floodlight w Search Ads 360.
custom_column_ids[]	int64 Identyfikatory kolumn niestandardowych, które używają tej zmiennej niestandardowej konwersji.

FloodlightConversionCustomVariableInfo

Informacje o niestandardowych zmiennych konwersji Floodlight w Search Ads 360.

Pola
floodlight_variable_type	FloodlightVariableType Typ zmiennej Floodlight zdefiniowany w Search Ads 360.
floodlight_variable_data_type	FloodlightVariableDataType Typ danych zmiennej Floodlight zdefiniowany w Search Ads 360.

ConversionTrackingSetting

Zbiór ustawień dotyczących śledzenia konwersji w Search Ads 360, które obejmują wszystkich klientów.

Pola
accepted_customer_data_terms	bool Informacja o tym, czy klient zaakceptował warunki dotyczące danych klienta. Jeśli używasz śledzenia konwersji dla wielu kont, ta wartość jest dziedziczona z konta menedżera. To pole jest tylko do odczytu. Więcej informacji znajdziesz na stronie https://support.google.com/adspolicy/answer/7475709.
conversion_tracking_status	ConversionTrackingStatus Stan śledzenia konwersji. Wskazuje, czy klient korzysta ze śledzenia konwersji, oraz kto jest właścicielem śledzenia konwersji tego klienta. Jeśli ten klient korzysta ze śledzenia konwersji na wielu kontach, zwrócona wartość będzie się różnić w zależności od login-customer-id żądania.
enhanced_conversions_for_leads_enabled	bool Czy klient włączył konwersje rozszerzone dotyczące potencjalnych klientów. Jeśli używasz śledzenia konwersji dla wielu kont, ta wartość jest dziedziczona z konta menedżera. To pole jest tylko do odczytu.
google_ads_conversion_customer	string Nazwa zasobu klienta, w którym tworzone są konwersje i którym zarządza się konwersjami. To pole jest tylko do odczytu.
conversion_tracking_id	int64 Identyfikator śledzenia konwersji używany na tym koncie. Ten identyfikator nie wskazuje, czy klient używa śledzenia konwersji (wskazuje to parametr conversion_tracking_status). To pole jest tylko do odczytu.
google_ads_cross_account_conversion_tracking_id	int64 Identyfikator śledzenia konwersji klienta menedżera. Jest on ustawiany, gdy klient wyrazi zgodę na śledzenie konwersji, i zastępuje parametr conversion_tracking_id. Tym polem można zarządzać tylko w interfejsie Google Ads. To pole jest tylko do odczytu.
cross_account_conversion_tracking_id	int64 Identyfikator śledzenia konwersji klienta menedżera. Ten parametr jest ustawiany, gdy klient włączy śledzenie konwersji dla wielu kont, i zastępuje parametr conversion_tracking_id.

CustomColumn

kolumnę niestandardową, Informacje o kolumnach niestandardowych Search Ads 360 znajdziesz na stronie https://support.google.com/sa360/answer/9633916.

Pola
resource_name	string Nazwa zasobu kolumny niestandardowej. Nazwy zasobów kolumn niestandardowych mają postać: customers/{customer_id}/customColumns/{custom_column_id}
id	int64 Identyfikator kolumny niestandardowej.
name	string Nazwa kolumny niestandardowej zdefiniowana przez użytkownika.
description	string Opis kolumny niestandardowej zdefiniowany przez użytkownika.
value_type	CustomColumnValueType Typ wartości wyniku kolumny niestandardowej.
references_attributes	bool Wartość „Prawda”, jeśli kolumna niestandardowa odwołuje się do co najmniej 1 atrybutu.
references_metrics	bool Wartość „Prawda”, jeśli kolumna niestandardowa odnosi się do co najmniej 1 rodzaju danych.
queryable	bool Wartość „true”, jeśli kolumna niestandardowa jest dostępna do użycia w zapytaniu SearchAds360Service.Search i SearchAds360Service.SearchStream.
referenced_system_columns[]	string Lista kolumn systemowych, do których odwołuje się ta kolumna niestandardowa. Na przykład kolumna niestandardowa „Suma wyświetleń i kliknięć” odwołuje się do kolumn systemowych {„metrics.clicks”, „metrics.impressions”}.
render_type	CustomColumnRenderType Określa sposób interpretacji wartości wyniku w kolumnie niestandardowej.

Klient

klient.

Pola
resource_name	string Nazwa zasobu klienta. Nazwy zasobów klientów mają postać: customers/{customer_id}
conversion_tracking_setting	ConversionTrackingSetting Ustawienie śledzenia konwersji dla klienta.
account_type	AccountType Typ konta wyszukiwarki, np. Google Ads, Microsoft Advertising, Yahoo Japan, Baidu, Facebook, Engine Track itp.
double_click_campaign_manager_setting	DoubleClickCampaignManagerSetting Ustawienie DoubleClick Campaign Manager (DCM) dla klienta zarządzającego.
account_status	AccountStatus Stan konta, np. Włączone, Wstrzymane, Usunięte itp.
last_modified_time	string Data i godzina ostatniej modyfikacji tego klienta. Data i godzina są podane w strefie czasowej klienta w formacie „rrrr-MM-dd HH:mm:ss.ssssss”.
engine_id	string Identyfikator konta w zewnętrznym koncie wyszukiwarki.
status	CustomerStatus Stan klienta.
creation_time	string Sygnatura czasowa utworzenia tego klienta. Sygnatura czasowa jest podana w strefie czasowej klienta w formacie „rrrr-MM-dd GG:mm:ss”.
manager_id	int64 Identyfikator klienta menedżera. Wartość 0 oznacza, że klient nie ma menedżera SA360.
manager_descriptive_name	string Nazwa opisowa menedżera.
sub_manager_id	int64 Identyfikator klienta podrzędnego konta menedżera. Wartość 0 oznacza, że klient nie ma podrzędnego konta menedżera SA360.
sub_manager_descriptive_name	string Opisowa nazwa podrzędnego konta menedżera.
associate_manager_id	int64 Identyfikator klienta powiązanego menedżera. Wartość 0 oznacza, że klient nie ma powiązanego konta menedżera SA360.
associate_manager_descriptive_name	string Nazwa opisowa menedżera stowarzyszonego.
account_level	AccountLevelType Poziom konta klienta: konto menedżera, podrzędne konto menedżera, powiązane konto menedżera, konto usługi.
id	int64 Identyfikator klienta.
descriptive_name	string Opcjonalna, nieunikalna nazwa opisowa klienta.
currency_code	string Waluta, w której działa konto. Obsługiwany jest podzbiór kodów walut ze standardu ISO 4217.
time_zone	string Identyfikator lokalnej strefy czasowej klienta.
tracking_url_template	string Szablon adresu URL do tworzenia linku monitorującego z parametrów.
final_url_suffix	string Szablon URL do dołączania parametrów do końcowego adresu URL.
auto_tagging_enabled	bool Określa, czy automatyczne tagowanie jest włączone na koncie klienta.
manager	bool Określa, czy klient jest menedżerem.

CustomerAsset

Połączenie między klientem a komponentem.

Pola
resource_name	string Nazwa zasobu komponentu klienta. Nazwy zasobów CustomerAsset mają postać: customers/{customer_id}/customerAssets/{asset_id}~{field_type}
asset	string Wymagane. Komponent powiązany z klientem.
status	AssetLinkStatus Stan zasobu klienta.

CustomerAssetSet

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

Pola
resource_name	string Nazwa zasobu zestawu komponentów klienta. Nazwy zasobów komponentów w zestawie komponentów mają format: customers/{customer_id}/customerAssetSets/{asset_set_id}
asset_set	string Zestaw komponentów powiązany z klientem.
customer	string Klient, z którym jest połączony ten zestaw komponentów.
status	AssetSetLinkStatus Stan zasobu w zbiorze zasobów klienta. Tylko do odczytu.

CustomerClient

Połączenie między danym klientem a klientem klienta. Obiekty CustomerClient istnieją tylko w przypadku klientów zarządzających. Obejmuje to wszystkich klientów bezpośrednich i pośrednich, a także samo konto menedżera.

Pola
resource_name	string Nazwa zasobu klienta. Nazwy zasobów CustomerClient mają postać: customers/{customer_id}/customerClients/{client_customer_id}
applied_labels[]	string Nazwy zasobów etykiet należących do klienta wysyłającego żądanie, które są stosowane do klienta. Nazwy zasobów etykiet mają postać: customers/{customer_id}/labels/{label_id}
status	CustomerStatus Stan klienta. Tylko do odczytu.
client_customer	string Nazwa zasobu klienta połączonego z danym klientem. Tylko do odczytu.
hidden	bool Określa, czy jest to ukryte konto. Tylko do odczytu.
level	int64 Odległość między danym klientem a klientem. W przypadku linku do siebie wartość poziomu wynosi 0. Tylko do odczytu.
time_zone	string Ciąg znaków ze standardowego repozytorium danych (Common Locale Data Repository, CLDR) reprezentujący strefę czasową klienta, np. America/Los_Angeles. Tylko do odczytu.
test_account	bool Określa, czy klient jest kontem testowym. Tylko do odczytu.
manager	bool Określa, czy klient jest menedżerem. Tylko do odczytu.
descriptive_name	string Opisowa nazwa klienta. Tylko do odczytu.
currency_code	string Kod waluty klienta (np. „USD”, „EUR”). Tylko do odczytu.
id	int64 Identyfikator klienta klienta. Tylko do odczytu.

CustomerManagerLink

Reprezentuje relację połączenia klient-menedżer.

Pola
resource_name	string Nazwa zasobu. Nazwy zasobów CustomerManagerLink mają postać: customers/{customer_id}/customerManagerLinks/{manager_customer_id}~{manager_link_id}
status	ManagerLinkStatus Stan połączenia między klientem a menedżerem.
manager_customer	string Konto klienta menedżera połączone z kontem klienta.
manager_link_id	int64 Identyfikator połączenia klienta z kontem menedżera. To pole jest tylko do odczytu.
start_time	string Sygnatura czasowa utworzenia obiektu CustomerManagerLink. Sygnatura czasowa jest podana w strefie czasowej klienta w formacie „rrrr-MM-dd GG:mm:ss”.

DoubleClickCampaignManagerSetting

Ustawienie DoubleClick Campaign Manager (DCM) dla klienta zarządzającego.

Pola
advertiser_id	int64 Identyfikator reklamodawcy Campaign Managera powiązanego z tym klientem.
network_id	int64 Identyfikator sieci Campaign Manager powiązanej z tym klientem.
time_zone	string Strefa czasowa sieci Campaign Managera powiązanej z tym klientem w formacie bazy danych stref czasowych IANA, np. America/New_York.

DynamicSearchAdsSearchTermView

Widok wyszukiwanych haseł w dynamicznych reklamach w wyszukiwarce.

Pola
resource_name	string Nazwa zasobu widoku wyszukiwanych haseł dotyczącego dynamicznych reklam w wyszukiwarce. Nazwy zasobów widoku wyszukiwanych haseł w dynamicznych reklamach w wyszukiwarce mają postać: customers/{customer_id}/dynamicSearchAdsSearchTermViews/{ad_group_id}~{search_term_fingerprint}~{headline_fingerprint}~{landing_page_fingerprint}~{page_url_fingerprint}
landing_page	string Adres URL strony docelowej wyświetlenia wybrany dynamicznie. To pole jest tylko do odczytu.

GenderView

Widok płci. Zasób gender_view odzwierciedla stan wyświetlania, a nie dodane kryteria. Grupa reklam bez kryteriów dotyczących płci domyślnie wyświetla się wszystkim płciom, więc wszystkie płcie pojawiają się w tabeli gender_view ze statystykami.

Pola
resource_name	string Nazwa zasobu widoku płci. Nazwy zasobów widoku Płeć mają postać: customers/{customer_id}/genderViews/{ad_group_id}~{criterion_id}

GeoTargetConstant

Stała kierowania geograficznego.

Pola
resource_name	string Nazwa zasobu stałej lokalizacji docelowej. Nazwy zasobów stałych kierowania geograficznego mają postać: geoTargetConstants/{geo_target_constant_id}
status	GeoTargetConstantStatus Stan stałej kierowania geograficznego.
id	int64 Identyfikator stałej kierowania geograficznego.
name	string Stała nazwa kierowania geograficznego w języku angielskim.
country_code	string Kod kraju w formacie ISO-3166-1 alpha-2 powiązany z lokalizacją docelową.
target_type	string Typ kierowania stałej kierowania geograficznego.
canonical_name	string Pełna i jednoznaczna nazwa w języku angielskim składająca się z nazwy własnej oraz nazwy podmiotu nadrzędnego i kraju.
parent_geo_target	string Nazwa zasobu stałej geotargetowania nadrzędnej. Nazwy zasobów stałych kierowania geograficznego mają postać: geoTargetConstants/{parent_geo_target_constant_id}

KeywordView

Widok słów kluczowych.

Pola
resource_name	string Nazwa zasobu widoku słowa kluczowego. Nazwy zasobów widoku słów kluczowych mają postać: customers/{customer_id}/keywordViews/{ad_group_id}~{criterion_id}

Etykieta

etykietę,

Pola
resource_name	string Nazwa zasobu. Nazwy zasobów etykiet mają postać: customers/{owner_customer_id}/labels/{label_id}
status	LabelStatus Stan etykiety. Tylko do odczytu.
text_label	TextLabel Rodzaj etykiety wyświetlającej tekst na kolorowym tle.
id	int64 Identyfikator etykiety. Tylko do odczytu.
name	string Nazwa etykiety. To pole jest wymagane i nie może być puste podczas tworzenia nowej etykiety. Długość tego ciągu powinna wynosić od 1 do 80 znaków (włącznie).

LanguageConstant

język,

Pola
resource_name	string Nazwa zasobu stałej języka. Nazwy zasobów stałych języka mają postać: languageConstants/{criterion_id}
id	int64 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, np. „English (US)”, „Spanish” itp.
targetable	bool Czy na dany język można kierować reklamy.

ListingGroupFilterDimension

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

Pola
Pole zbiorcze dimension. Wymiar jednego z tych typów jest zawsze obecny. dimension może mieć tylko jedną z tych wartości:
product_bidding_category	ProductBiddingCategory Kategoria określania stawek oferty produktu.
product_brand	ProductBrand Marka oferty produktu.
product_channel	ProductChannel Lokalizacja oferty produktu.
product_condition	ProductCondition Stan oferty produktu.
product_custom_attribute	ProductCustomAttribute Atrybut niestandardowy oferty produktu.
product_item_id	ProductItemId Identyfikator produktu w ofercie.
product_type	ProductType Typ oferty produktu.

ProductBiddingCategory

Jeden element kategorii określania stawek na określonym poziomie. Kategorie najwyższego poziomu znajdują się na poziomie 1, ich podkategorie 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 tego samego podziału muszą mieć ten sam typ wymiaru (poziom kategorii).

Pola
level	ListingGroupFilterBiddingCategoryLevel Wskazuje poziom kategorii w taksonomii.
id	int64 Identyfikator kategorii określania stawek za produkt. Ten identyfikator jest odpowiednikiem identyfikatora atrybutu google_product_category [kategoria_produktów_google], o którym mowa w tym artykule: https://support.google.com/merchants/answer/6324436.

ProductBrand

Marka produktu.

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

ProductChannel

Lokalizacja oferty produktu.

Pola
channel	ListingGroupFilterProductChannel Wartość miejscowości.

ProductCondition

Stan oferty produktu.

Pola
condition	ListingGroupFilterProductCondition Wartość warunku.

ProductCustomAttribute

Atrybut niestandardowy oferty produktu.

Pola
index	ListingGroupFilterCustomAttributeIndex Wskazuje indeks atrybutu niestandardowego.
value	string Wartość tekstowa atrybutu niestandardowego produktu.

ProductItemId

Identyfikator produktu w ofercie.

Pola
value	string Wartość identyfikatora.

ProductType

Typ oferty produktu.

Pola
level	ListingGroupFilterProductTypeLevel Poziom typu.
value	string Wartość typu.

ListingGroupFilterDimensionPath

Ścieżka definiująca wymiary, które określają filtr grupy informacji o produktach.

Pola
dimensions[]	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.

LocationView

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

Pola
resource_name	string Nazwa zasobu widoku lokalizacji. Nazwy zasobów widoku lokalizacji mają postać: customers/{customer_id}/locationViews/{campaign_id}~{criterion_id}

ProductBiddingCategoryConstant

Kategoria ustalania stawek za produkt.

Pola
resource_name	string Nazwa zasobu kategorii określania stawek za produkt. Nazwy zasobów kategorii ustalania stawek za produkty mają postać: productBiddingCategoryConstants/{country_code}~{level}~{id}
level	ProductBiddingCategoryLevel Poziom kategorii produktów objętych licytowaniem.
status	ProductBiddingCategoryStatus Stan kategorii licytowania produktów.
id	int64 Identyfikator kategorii określania stawek za produkt. Ten identyfikator jest odpowiednikiem identyfikatora atrybutu google_product_category [kategoria_produktów_google] opisanego w tym artykule: https://support.google.com/merchants/answer/6324436.
country_code	string Dwuliterowy kod kraju w kategorii licytowania produktów.
product_bidding_category_constant_parent	string Nazwa zasobu nadrzędnej kategorii produktów do określania stawek.
language_code	string Kod języka kategorii licytowania produktu.
localized_name	string Wyświetla wartość kategorii określania stawek za produkt zlokalizowaną zgodnie z kodem języka.

ProductGroupView

Widok grupy produktów.

Pola
resource_name	string Nazwa zasobu widoku grupy produktów. Nazwy zasobów widoku grupy produktów mają postać: customers/{customer_id}/productGroupViews/{ad_group_id}~{criterion_id}

SearchAds360Field

Pole lub zasób (artefakt) używany przez SearchAds360Service.

Pola
resource_name	string Nazwa zasobu artefaktu. Nazwy zasobów artefaktów mają postać: SearchAds360Fields/{name}
category	SearchAds360FieldCategory Kategoria artefaktu.
selectable_with[]	string Nazwy wszystkich zasobów, segmentów i rodzajów danych, które można wybrać za pomocą opisanego artefaktu.
attribute_resources[]	string Nazwy wszystkich zasobów, które można wybrać za pomocą opisanego artefaktu. Pola z tych zasobów nie segmentują danych, gdy są uwzględniane w zapytaniach. To pole jest ustawiane tylko w przypadku artefaktów, których kategoria to RESOURCE.
metrics[]	string To pole zawiera nazwy wszystkich danych, które można wybrać za pomocą opisanego artefaktu, gdy jest on używany w klauzuli FROM. Jest on ustawiony tylko w przypadku artefaktów, których kategoria to RESOURCE.
segments[]	string To pole zawiera nazwy wszystkich artefaktów (segmentów lub innych zasobów), które segmentują dane, gdy są uwzględniane w zapytaniach i gdy opisany artefakt jest używany w klauzuli FROM. Jest on ustawiony tylko w przypadku artefaktów, których kategoria to RESOURCE.
enum_values[]	string Wartości, które może przyjmować artefakt, jeśli jest polem typu ENUM. To pole jest ustawiane tylko w przypadku artefaktów z kategorii SEGMENT lub ATTRIBUTE.
data_type	SearchAds360FieldDataType To pole określa operatory, których można używać z artefaktem w klauzulach WHERE.
name	string Nazwa artefaktu.
selectable	bool Określa, czy artefaktu można używać w klauzuli SELECT w zapytaniach wyszukiwania.
filterable	bool Określa, czy artefaktu można używać w klauzuli WHERE w zapytaniach.
sortable	bool Określa, czy artefaktu można używać w klauzuli ORDER BY w zapytaniach.
type_url	string Adres URL pliku proto opisującego typ danych artefaktu.
is_repeated	bool Czy artefakt pola się powtarza.

ShoppingPerformanceView

Widok skuteczności zakupów. Zawiera statystyki kampanii produktowych zebrane na kilku poziomach wymiarów produktów. Wartości wymiarów produktu z Merchant Center, takie jak marka, kategoria, atrybuty niestandardowe, stan produktu i typ produktu, będą odzwierciedlać stan każdego wymiaru w dniu i o godzinie zarejestrowania odpowiedniego zdarzenia.

Pola
resource_name	string Nazwa zasobu widoku wyników Zakupów. Nazwy zasobów widoku skuteczności zakupów mają postać: customers/{customer_id}/shoppingPerformanceView

UserList

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

Pola
resource_name	string Nazwa zasobu listy użytkowników. Nazwy zasobów list użytkowników mają postać: customers/{customer_id}/userLists/{user_list_id}
type	UserListType Typ tej listy. To pole jest tylko do odczytu.
id	int64 Identyfikator listy użytkowników.
name	string Nazwa tej listy użytkowników. W zależności od wartości parametru access_reason nazwa listy użytkowników może nie być unikalna (np. jeśli access_reason=SHARED).

UserLocationView

Widok lokalizacji użytkownika.

Widok Lokalizacja użytkownika zawiera wszystkie dane zagregowane na poziomie kraju, po jednym wierszu na kraj. Wyświetla wskaźniki w rzeczywistej fizycznej lokalizacji użytkownika według wybranej lub niewybranej lokalizacji. Jeśli używane są inne pola segmentu, możesz otrzymać więcej niż 1 wiersz na kraj.

Pola
resource_name	string Nazwa zasobu widoku lokalizacji użytkownika. Nazwy zasobów widoku UserLocation mają postać: customers/{customer_id}/userLocationViews/{country_criterion_id}~{targeting_location}
country_criterion_id	int64 Identyfikator kryteriów dla kraju.
targeting_location	bool Wskazuje, czy lokalizacja była objęta kierowaniem.

Odwiedź

wizyta;

Pola
resource_name	string Nazwa zasobu wizyty. Nazwy zasobów wizyt mają postać: customers/{customer_id}/visits/{ad_group_id}~{criterion_id}~{ds_visit_id}
id	int64 Identyfikator wizyty.
criterion_id	int64 Identyfikator słowa kluczowego Search Ads 360. Wartość 0 oznacza, że słowo kluczowe nie jest przypisane.
merchant_id	int64 Identyfikator konta asortymentu Search Ads 360 zawierającego kliknięty produkt. Search Ads 360 generuje ten identyfikator po połączeniu konta asortymentu w Search Ads 360.
ad_id	int64 Identyfikator reklamy. Wartość 0 oznacza, że reklama nie jest przypisana.
click_id	string Unikalny ciąg znaków dla każdej wizyty, który jest przekazywany na stronę docelową jako parametr adresu URL identyfikatora kliknięcia.
visit_date_time	string Sygnatura czasowa zdarzenia wizyty. Sygnatura czasowa jest podana w strefie czasowej klienta w formacie „rrrr-MM-dd GG:mm:ss”.
product_id	string Identyfikator klikniętego produktu.
product_channel	ProductChannel Kanał sprzedaży klikniętego produktu: online lub lokalny.
product_language_code	string Język (ISO-639-1) ustawiony dla pliku danych Merchant Center zawierającego dane produktu.
product_store_id	string Sklep w klikniętej reklamie lokalnego asortymentu produktów. Temu sklepowi musi odpowiadać jego identyfikator użyty w pliku danych o produktach dostępnych lokalnie.
product_country_code	string Kraj (w formacie ISO-3166) zarejestrowany na potrzeby pliku danych o asortymencie, który zawiera kliknięty produkt.
asset_id	int64 Identyfikator komponentu, z którym użytkownik wszedł w interakcję podczas zdarzenia wizyty.
asset_field_type	AssetFieldType Typ pola komponentu zdarzenia wizyty.

WebpageView

Wyświetlenie strony internetowej.

Pola
resource_name	string Nazwa zasobu wyświetlenia strony. Nazwy zasobów wyświetleń strony internetowej mają postać: customers/{customer_id}/webpageViews/{ad_group_id}~{criterion_id}