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

Przedstawia widok strategii ustalania stawek należących do klienta i został mu udostępniony.

W odróżnieniu od strategii ustalania stawek ten zasób zawiera strategie należące do menedżerów klienta i udostępnione temu klientowi, a także strategie należące do tego klienta. Ten zasób nie dostarcza danych i udostępnia tylko ograniczony podzbiór atrybutów strategii określania stawek.

Pola
resource_name	string Nazwa zasobu dostępnej strategii ustalania stawek. Nazwy zasobów AccessibleBiddingStrategy mają postać: 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 Nazwa_opisowa klienta, który jest właścicielem strategii ustalania stawek.
Pole sumy scheme. Schemat ustalania stawek. Można ustawić tylko jedną z nich. scheme może być tylko jednym z tych elementów:
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ć z kampanii jak najwięcej konwersji w ramach określonego budżetu.
target_cpa	TargetCpa Strategia ustalania stawek, która ustala stawki tak, by 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 maksymalizować przychody przy średnim docelowym zwrocie z nakładów na reklamę (ROAS).
target_spend	TargetSpend Strategia ustalania stawek, która ustala stawki tak, by pomóc Ci uzyskać jak najwięcej 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 Docelowy zwrot 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 najwyższego możliwego ROAS w ramach budżetu.

MaximizeConversions

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

Pola
target_cpa	int64 Opcja Docelowy koszt pozyskania (CPA). Jest to średnia kwota, jaką chcesz wydawać na pozyskanie jednego klienta.
target_cpa_micros	int64 Opcja Docelowy koszt pozyskania (CPA). Jest to średnia kwota, jaką chcesz wydawać na pozyskanie jednego klienta.

TargetCpa

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

Pola
target_cpa_micros	int64 Średni docelowy CPA. Ten cel powinien być równy lub większy od minimalnej jednostki rozliczeniowej na podstawie waluty na koncie.

TargetImpressionShare

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

Pola
location	TargetImpressionShareLocation Wybrana lokalizacja na stronie wyników wyszukiwania.
location_fraction_micros	int64 Wybrana część reklam, które mają się wyświetlać w kierowanej lokalizacji, w mikrosekundach. Na przykład 1% to 10 000.
cpc_bid_ceiling_micros	int64 Najwyższa stawka CPC, jaką system automatycznego określania stawek może określić. Jest to wymagane pole podane przez reklamodawcę, które określa limit i podawane w lokalnych mikro.

TargetRoas

Automatyczna strategia ustalania stawek, która pomaga zmaksymalizować przychody przy średnim docelowym zwrocie 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 w taki sposób, by pomóc Ci uzyskać jak najwięcej kliknięć w ramach budżetu.

Pola
target_spend_micros (deprecated)	int64 Ten element został wycofany. Docelowe wydatki, w których przypadku ma być maksymalizowana liczba kliknięć. Użytkownik z celowym poziomem wydatków będzie próbować wydać mniejszą z tych wartości lub naturalną kwotę wydatków wynikającą z ograniczeń. Jeśli nie podasz wartości, jako docelowa kwota wydatków będzie używany budżet. 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 Maksymalny limit stawki, który może być ustawiony przez strategię ustalania stawek. Limit dotyczy wszystkich słów kluczowych zarządzanych przez strategię.

Reklama

reklama,

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 po wszystkich przekierowaniach między domenami w reklamie.
type	AdType Typ reklamy.
id	int64 Identyfikator reklamy.
display_url	string Adres URL widoczny w opisie reklamy w przypadku niektórych formatów reklam.
name	string Nazwa reklamy. Służy on tylko do identyfikacji reklamy. Nie musi być niepowtarzalna i nie wpływa na wyświetlaną reklamę. Pole nazwy jest obecnie obsługiwane tylko w przypadku reklam DisplayUploadAd, ImageAd, ShoppingComparisonListingAd i VideoAd.
Pole unii 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

Grupa reklam.

Pola
resource_name	string Nazwa zasobu grupy reklam. Nazwy zasobów grup reklam mają następujący format: 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 określająca, kiedy grupa reklam została utworzona. Sygnatura czasowa jest podawana w strefie czasowej klienta i w formacie „rrrr-MM-dd HH:mm:ss”.
targeting_setting	TargetingSetting Ustawienie kierowania na funkcje związane z kierowaniem.
labels[]	string Nazwy zasobów etykiet dołączonych do tej grupy reklam.
effective_labels[]	string Nazwy zasobów etykiet skutecznych dołączonych do tej grupy reklam. Skuteczna etykieta to etykieta dziedziczona lub bezpośrednio przypisana do tej grupy reklam.
engine_id	string Identyfikator grupy reklam na zewnętrznym koncie wyszukiwarki. To pole dotyczy tylko kont innych niż Google Ads, np. Yahoo Japan, Microsoft, Baidu itp. W przypadku elementów Google Ads użyj zamiast tego pola „ad_group.id”.
start_date	string Data, od której ta grupa reklam zacznie wyświetlać reklamy. Domyślnie grupa reklam rozpoczyna działanie w bieżącej chwili lub w dacie rozpoczęcia, zależnie od tego, co nastąpi później. Jeśli to pole jest ustawione, grupa reklam rozpoczyna działanie na początku określonej daty w strefie czasowej klienta. To pole jest dostępne tylko w przypadku kont Microsoft Advertising i Facebooka. 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 dacie zakończenia. Jeśli to pole jest ustawione, grupa reklam kończy się pod koniec określonej daty w strefie czasowej klienta. To pole jest dostępne tylko w przypadku kont Microsoft Advertising i Facebooka. 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ą w strefie czasowej klienta i w formacie „rrrr-MM-dd GG: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ć znaku null (punkt kodowy 0x0), znaku nowego wiersza (punkt kodowy 0xA) ani znaku przejścia do nowej linii (punkt kodowy 0xD).
cpc_bid_micros	int64 Maksymalna stawka CPC (koszt kliknięcia).
engine_status	AdGroupEngineStatus Stan wyszukiwarki dla grupy reklam.

AdGroupAd

Reklama z grupy reklam.

Pola
resource_name	string Nazwa zasobu reklamy. Nazwy zasobów reklamy grupy 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 tego elementu ad_group_ad. Data i godzina są podane w strefie czasowej klienta i 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 skutecznych etykiet dołączonych do tej reklamy. Etykieta obowiązująca to etykieta odziedziczona lub bezpośrednio przypisana do danej reklamy.
engine_id	string Identyfikator reklamy na koncie zewnętrznej wyszukiwarki. To pole dotyczy tylko kont Search Ads 360, np. Yahoo Japan, Microsoft, Baidu itp. W przypadku elementów innych niż Search Ads 360 użyj pola „ad_group_ad.ad.id”.
engine_status	AdGroupAdEngineStatus Dodatkowy stan reklamy na koncie zewnętrznej wyszukiwarki. Możliwe stany (w zależności od typu konta zewnętrznego) to m.in. aktywne, kwalifikujące się, oczekujące na sprawdzenie.
last_modified_time	string Data i godzina ostatniej modyfikacji reklamy w grupie reklam. Data i godzina są w strefie czasowej klienta i w formacie „rrrr-MM-dd GG:mm:ss.ssssss”.

AdGroupAdEffectiveLabel

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

Pola
resource_name	string Nazwa zasobu etykiety skuteczności reklamy grupy reklam. Nazwy zasobów etykiet skutecznych reklam w grupie reklam mają następujący format: customers/{customer_id}/adGroupAdEffectiveLabels/{ad_group_id}~{ad_id}~{label_id}
ad_group_ad	string Reklama grupy reklam, do której jest przypisana skuteczna etykieta.
label	string Efektywny tag przypisany do reklamy w grupie reklam.
owner_customer_id	int64 Identyfikator klienta, który jest właścicielem etykiety obowiązującej.

AdGroupAdLabel

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

Pola
resource_name	string Nazwa zasobu etykiety reklamy w grupie reklam. Nazwy zasobów etykiety reklamy grupy reklam mają postać: customers/{customer_id}/adGroupAdLabels/{ad_group_id}~{ad_id}~{label_id}
ad_group_ad	string Reklama grupy reklam, do której jest przypisana 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 grupy reklam. Nazwy zasobów AdGroupAsset mają następujący format: customers/{customer_id}/adGroupAssets/{ad_group_id}~{asset_id}~{field_type}
ad_group	string Wymagane. Grupa reklam, z którą połączony jest komponent.
asset	string Wymagane. Komponent połączony z grupą reklam.
status	AssetLinkStatus Stan komponentu grupy reklam.

AdGroupAssetSet

AdGroupAssetSet łączy grupę reklam z zestawem komponentów. Tworzenie zestawu komponentów grupy reklam powoduje połączenie zestawu komponentów z grupą reklam.

Pola
resource_name	string Nazwa zasobu w zestawie komponentów grupy reklam. Nazwy zasobów zestawu komponentów grupy reklam mają postać: customers/{customer_id}/adGroupAssetSets/{ad_group_id}~{asset_set_id}
ad_group	string Grupa reklam, do której jest powiązany ten zestaw komponentów.
asset_set	string Zbiór plików połączony 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 oparte na zainteresowaniach i listach remarketingowych dla reklam w sieci reklamowej i w YouTube oraz z list remarketingowych dla reklam w wyszukiwarce (RLSA) zebrane na poziomie odbiorców.

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

AdGroupBidModifier

Odnosi się do modyfikatora stawek grupy reklam.

Pola
resource_name	string Nazwa zasobu modyfikatora stawek grupy reklam. Nazwy zasobów modyfikatora stawki grupy reklam mają postać: customers/{customer_id}/adGroupBidModifiers/{ad_group_id}~{criterion_id}
bid_modifier	double Modyfikator stawki, gdy kryterium jest zgodne. Modyfikator musi należeć do zakresu od 0,1 do 10,0. Zakres wynosi od 1,0 do 6,0 w przypadku treści PreferredContent. Aby zrezygnować z typu urządzenia, wpisz 0.
Pole unii criterion. Kryterium tego modyfikatora stawek grupy reklam. Wymagany w operacjach tworzenia od wersji 5. criterion może być tylko jednym z tych elementów:
device	DeviceInfo Kryterium urządzenia.

AdGroupCriterion

kryterium w grupie reklam, Raport ad_group_criterion zwraca tylko te kryteria, które zostały bezpośrednio dodane do grupy reklam.

Pola
resource_name	string Nazwa zasobu kryterium w grupie reklam. Nazwy zasobów kryterium 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 podawana w strefie czasowej klienta i w formacie „rrrr-MM-dd HH:mm:ss”.
status	AdGroupCriterionStatus Stan kryterium. Stan elementu kryterium w grupie reklam ustawiony przez klienta. Uwaga: raporty interfejsu użytkownika mogą zawierać dodatkowe informacje, które wpływają na to, czy kryterium może być stosowane. W niektórych przypadkach kryterium, które zostało USUNIĘTE w interfejsie API, może nadal być widoczne jako włączone w interfejsie użytkownika. Na przykład kampanie domyślnie wyświetlają się użytkownikom we wszystkich przedziałach wiekowych, chyba że zostaną wykluczone. W interfejsie poszczególne przedziały wiekowe będą oznaczone jako „aktywne”, ponieważ mogą zobaczyć reklamy. Jednak AdGroupCriterion.status wyświetli wartość „usunięto”, ponieważ nie dodano żadnego niewykluczającego kryterium.
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 etykiet skuteczności dołączonych do tego kryterium grupy reklam. Skuteczna etykieta to etykieta dziedziczona lub bezpośrednio przypisana do tego kryterium grupy reklam.
position_estimates	PositionEstimates Szacunki stawek na podstawie kryteriów na różnych pozycjach.
final_urls[]	string Lista możliwych końcowych adresów URL po wszystkich przekierowaniach między domenami w reklamie.
engine_id	string Identyfikator kryterium grupy reklam na koncie zewnętrznym. To pole dotyczy tylko konta innego niż Google Ads, np. Yahoo Japan, Microsoft, Baidu itp. W przypadku podmiotu Google Ads użyj parametru „ad_group_criterion.kryterium_id”.
last_modified_time	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 HH:mm:ss.ssssss”.
criterion_id	int64 Identyfikator kryterium.
ad_group	string Grupa reklam, do której należy kryterium.
negative	bool Określa, czy kryterium ma być celem (false), czy też wykluczone (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 zgodne. Modyfikator musi mieścić się w zakresie 0,1–10,0. Większość typów kryteriów kierowania reklam obsługuje modyfikatory.
cpc_bid_micros	int64 Stawka CPC (koszt kliknięcia).
effective_cpc_bid_micros	int64 Efektywny CPC (koszt kliknięcia).
engine_status	AdGroupCriterionEngineStatus Stan kryterium w grupie reklam w wyszukiwarce.
final_url_suffix	string Szablon adresu URL służący do dołączania parametrów do końcowego adresu URL.
tracking_url_template	string Szablon adresu URL służący do tworzenia linku monitorującego.
Pole sumy criterion. Kryterium w grupie reklam. Musisz ustawić dokładnie 1 z nich. criterion może być tylko jednym z tych elementów:
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

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

Pola
top_of_page_cpc_micros	int64 Szacunkowa stawka CPC wymagana do wyświetlania reklamy u góry pierwszej strony wyników wyszukiwania.

QualityInfo

Pojemnik na informacje o jakości kryterium grupy reklam.

Pola
quality_score	int32 Wynik jakości. To pole może nie zostać wypełnione, jeśli Google nie ma wystarczającej ilości informacji do określenia wartości.

AdGroupCriterionEffectiveLabel

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

Pola
resource_name	string Nazwa zasobu etykiety skuteczności kryterium grupy reklam. Nazwy zasobów z efektywnymi etykietami kryterium w grupie reklam mają postać: customers/{customer_id}/adGroupCriterionEffectiveLabels/{ad_group_id}~{criterion_id}~{label_id}
ad_group_criterion	string Kryterium w grupie reklam, do którego jest dołączona skuteczna etykieta.
label	string Skuteczna etykieta przypisana do kryterium w grupie reklam.
owner_customer_id	int64 Identyfikator klienta, który jest właścicielem etykiety obowiązującej.

AdGroupCriterionLabel

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

Pola
resource_name	string Nazwa zasobu etykiety kryterium grupy reklam. Nazwy zasobów etykiet kryterium w grupie reklam mają następujący format: customers/{customer_id}/adGroupCriterionLabels/{ad_group_id}~{criterion_id}~{label_id}
ad_group_criterion	string Kryterium w grupie reklam, do którego dołączona jest 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 efektywnym tagiem. Skuteczna etykieta to etykieta dziedziczona lub bezpośrednio przypisana do tej grupy reklam.

Pola
resource_name	string Nazwa zasobu etykiety skuteczności grupy reklam. Nazwy zasobów etykiety skuteczności grupy reklam mają postać: customers/{customer_id}/adGroupEffectiveLabels/{ad_group_id}~{label_id}
ad_group	string Grupa reklam, do której jest przypisana skuteczna etykieta.
label	string Etykieta skuteczności przypisana do grupy reklam.
owner_customer_id	int64 Identyfikator klienta, do którego należy dana 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ą następujący format: customers/{customer_id}/adGroupLabels/{ad_group_id}~{label_id}
ad_group	string Grupa reklam, do której jest przypisana 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 reklamy to element reklamy, który można udostępniać w wielu reklamach. Może to być obraz (ImageAsset), film (YoutubeVideoAsset) itp. Zasoby są niezmienne i nie można ich usunąć. Aby zatrzymać wyświetlanie komponentu, usuń go z elementu, który go używa.

Pola
resource_name	string Nazwa zasobu. Nazwy zasobów zasobów mają postać: customers/{customer_id}/assets/{asset_id}
type	AssetType Typ zasobu.
final_urls[]	string Lista możliwych końcowych adresów URL po wszystkich przekierowaniach między domenami.
status	AssetStatus Stan zasobu.
creation_time	string Sygnatura czasowa utworzenia tego zasobu. Sygnatura czasowa jest podawana w strefie czasowej klienta i w formacie „rrrr-MM-dd HH:mm:ss”.
last_modified_time	string Data i godzina ostatniej modyfikacji zasobu. Data i godzina są podane w strefie czasowej klienta i w formacie „rrrr-MM-dd HH:mm:ss.ssssss”.
id	int64 Identyfikator zasobu.
name	string Opcjonalna nazwa zasobu.
tracking_url_template	string Szablon adresu URL do tworzenia linku monitorującego.
engine_status	AssetEngineStatus Stan wyszukiwarki dla komponentu.
Pole unii asset_data. Konkretny typ komponentu. asset_data może być tylko jednym z tych elementów:
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 Komponent z ujednoliconym plikiem z adresami stron docelowych.
mobile_app_asset	MobileAppAsset Komponent 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 komponentów. AssetGroupAsset służy do łączenia komponentów z grupą komponentów. AssetGroupSignal służy do kojarzenia sygnału z grupą komponentów.

Pola
resource_name	string Nazwa zasobu grupy komponentów. Nazwy zasobów grupy 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 komponentów. Komponent powiązany z grupą plików.
name	string Wymagane. Nazwa grupy komponentów. Wymagane. Musi mieć co najmniej 1 znak i nie może mieć więcej niż 128 znaków. Nie może się powtarzać w ramach kampanii.
final_urls[]	string Lista końcowych adresów URL po wszystkich przekierowaniach między domenami. W kampanii Performance Max domyślnie adresy URL są kwalifikowane do rozwinięcia, chyba że ta opcja zostanie wyłączona.
final_mobile_urls[]	string Lista końcowych adresów URL na urządzenia mobilne po wszystkich przekierowaniach między domenami. W kampanii Performance Max adresy URL domyślnie kwalifikują się do rozwijania, o ile nie zrezygnujesz z tej opcji.
status	AssetGroupStatus Stan grupy plików.
path1	string Pierwsza część tekstu, która może być dołączana 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żka 1.
ad_strength	AdStrength Ogólna skuteczność reklamy w tej grupie plików.

AssetGroupAsset

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

Pola
resource_name	string Nazwa zasobu zasobu grupy plików. Nazwa zasobu grupy komponentów ma postać: customers/{customer_id}/assetGroupAssets/{asset_group_id}~{asset_id}~{field_type}
asset_group	string Grupa komponentów, do której jest powiązany ten komponent grupy komponentów.
asset	string Komponent, do którego łączy się ta grupa komponentów.
field_type	AssetFieldType Opis umieszczenia komponentu w grupie komponentów. Na przykład: HEADLINE, YOUTUBE_VIDEO itp.
status	AssetLinkStatus Stan połączenia między zasobem a grupą plików.

AssetGroupAssetCombinationData

Dane kombinacji komponentów grupy plików

Pola
asset_combination_served_assets[]	AssetUsage Udostępnione zasoby.

AssetGroupListingGroupFilter

AssetGroupListingGroupFilter reprezentuje węzeł drzewa filtra 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 filtra ListingGroupFilter.
type	ListingGroupFilterType Typ węzła filtra grup 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 informacji o produktach określa swój element nadrzędny. Niezdefiniowane dla grupy rdzeniowej.
parent_listing_group_filter	string Nazwa zasobu podgrupy nadrzędnej grupy informacji. Wartość null dla węzła filtra grupy informacji o produktach na poziomie głównym.
path	ListingGroupFilterDimensionPath Ścieżka wymiarów definiująca ten filtr grupy informacji o produktach.

AssetGroupSignal

AssetGroupSignal reprezentuje sygnał w grupie plików. Dzięki temu kampania Performance Max wie, 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 komponentów, do której należy ten sygnał dotyczący grupy komponentów.
Pole unii signal. Sygnał grupy komponentó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 kombinacji komponentów reklamy w grupie reklam.

Pola
resource_name	string Nazwa zasobu widoku najskuteczniejszych kombinacji grupy komponentów. Nazwy zasobów widoku Najczęstsze kombinacje grupy komponentów mają postać „customers/{customer_id}/assetGroupTopCombinationViews/{asset_group_id}~{asset_combination_category}”.
asset_group_top_combinations[]	AssetGroupAssetCombinationData Najpopularniejsze kombinacje komponentów wyświetlanych razem.

AssetSet

Zestaw komponentów reprezentujący kolekcję komponentów. Użyj AssetSetAsset, aby powiązać komponent z zestawem komponentów.

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

AssetSetAsset

Element AssetSetAsset stanowi połączenie między zasobem a zbiorem zasobów. Dodanie AssetSetAsset łączy komponent z zestawem komponentów.

Pola
resource_name	string Nazwa zasobu zasobu zestawu zasobów. Nazwy zasobów komponentów w zestawie komponentów mają postać: customers/{customer_id}/assetSetAssets/{asset_set_id}~{asset_id}
asset_set	string Zbiór zasobów, z którym jest połączony ten zasób zestawu zasobów.
asset	string Komponent, z którym łączy się komponent w zbiorze komponentów.
status	AssetSetAssetStatus Stan komponentu w zbiorze komponentów. Tylko do odczytu.

Odbiorcy

Listy odbiorców to skuteczna opcja kierowania, która umożliwia łączenie różnych atrybutów segmentów, np. szczegółowych danych demograficznych i podobnych zainteresowań, w celu tworzenia list odbiorców reprezentujących 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. Musi być niepowtarzalna w przypadku wszystkich list odbiorców. Musi mieć co najmniej 1 znak i nie może mieć więcej niż 255 znaków.
description	string Opis tej listy 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 (3-literowy kod ISO 4217). W przypadku strategii ustalania stawek na kontach menedżera walutę można ustawić podczas tworzenia strategii. Domyślnie jest to waluta konta menedżera. W przypadku klientów wyświetlania tego pola nie można ustawić. Wszystkie strategie klienta wyświetlania używają domyślnie waluty tego klienta. We wszystkich przypadkach 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 mieścić się w zakresie od 1 do 255 włącznie i w formacie UTF-8 (przycięty).
effective_currency_code	string Waluta używana w strategii ustalania stawek (trzyliterowy kod ISO 4217). W przypadku strategii ustalania stawek w klientach menedżerskich 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.
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 unii scheme. Schemat ustalania stawek. Można ustawić tylko jedną z nich. scheme może być tylko jednym z tych elementów:
enhanced_cpc	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, jeśli prawdopodobieństwo jest mniej prawdopodobne.
maximize_conversion_value	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.
maximize_conversions	MaximizeConversions Strategia automatycznego określania stawek, która pomaga uzyskać z kampanii jak najwięcej konwersji w ramach określonego budżetu.
target_cpa	TargetCpa Strategia ustalania stawek, która ustala stawki tak, by 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 ułamka aukcji, w których reklamodawca powinien wyprzedzić określonego konkurenta. To pole zostało wycofane. Utworzenie nowej strategii ustalania stawek z tym polem lub dołączenie do kampanii strategii ustalania stawek z tym polem zakończy się niepowodzeniem. Mutacje do strategii, które już zawierają ten schemat, są dozwolone.
target_roas	TargetRoas Strategia ustalania stawek, która pomaga zmaksymalizować przychody przy zachowaniu średniego 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 zostanie ustawiony na „Włączona”.
serving_status	CampaignServingStatus Stan wyświetlania reklam w kampanii.
bidding_strategy_system_status	BiddingStrategySystemStatus Stan systemowy strategii ustalania stawek w kampanii.
ad_serving_optimization_status	AdServingOptimizationStatus Stan optymalizacji wyświetlania reklam w kampanii.
advertising_channel_type	AdvertisingChannelType Główny obiekt wyświetlania reklam w ramach kampanii. Opcje kierowania można doprecyzować w sekcji 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 zawężenie do advertising_channel_type. Musi być prawidłowym podtypem typu kanału nadrzędnego. Można go ustawić tylko podczas tworzenia kampanii. Po utworzeniu kampanii nie można zmienić tego pola.
url_custom_parameters[]	CustomParameter Lista mapowań służących do zastępowania tagów parametrów niestandardowych w tagu tracking_url_template, final_urls lub mobile_final_urls.
real_time_bidding_setting	RealTimeBiddingSetting Ustawienia ustalania stawek w czasie rzeczywistym, które są dostępne tylko w przypadku kampanii 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 (DSA).
shopping_setting	ShoppingSetting Ustawienie służące do kontrolowania kampanii produktowych.
geo_target_type_setting	GeoTargetTypeSetting Ustawienie kierowania reklam na podstawie lokalizacji.
effective_labels[]	string Nazwy zasobów obowiązujących etykiet dołączonych do tej kampanii. Etykieta obowiązująca to etykieta odziedziczona lub bezpośrednio przypisana do danej kampanii.
labels[]	string Nazwy zasobów etykiet dołączonych do tej kampanii.
bidding_strategy_type	BiddingStrategyType Typ strategii ustalania stawek. Strategię ustalania stawek możesz utworzyć, ustawiając schemat ustalania stawek, aby utworzyć standardową strategię ustalania stawek, lub pole bidding_strategy, aby utworzyć strategię portfolio ustalania stawek. To pole jest tylko do odczytu.
accessible_bidding_strategy	string Nazwa zasobu AccessibleBiddingStrategy, czyli widok tylko do odczytu atrybutów bez ograniczeń strategii portfolio ustalania stawek z identyfikatorem „bidding_strategy”. Pusty, jeśli kampania nie korzysta ze strategii portfolio. Atrybuty strategii bez ograniczeń są dostępne dla wszystkich klientów, którym udostępniana jest strategia, i są odczytywane z zasobu AccessibleOkreślanie strategii. Atrybuty z ograniczeniami są natomiast dostępne tylko dla klientów będących właścicielami strategii i ich menedżerów. Atrybuty ograniczone można odczytać tylko z zasosobu 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 kampania ma być optymalizowana. Ta funkcja ma zastosowanie tylko do kampanii promujących aplikacje, które jako typ kanału reklamowego podają MULTI_CHANNEL, a jako podtyp kanału reklamowego – APP_CAMPAIGN lub APP_CAMPAIGN_FOR_ENGAGEMENT.
optimization_goal_setting	OptimizationGoalSetting Ustawienie celu optymalizacji w tej kampanii, które obejmuje zestaw typów celów optymalizacji.
tracking_setting	TrackingSetting Ustawienia śledzenia informacji na poziomie kampanii.
engine_id	string Identyfikator kampanii na zewnętrznym koncie wyszukiwarki. To pole dotyczy tylko kont innych niż Google Ads, np. Yahoo Japan, Microsoft, Baidu itp. W przypadku elementu Google Ads użyj zamiast tego pola „campaign.id”.
excluded_parent_asset_field_types[]	AssetFieldType Typy pól komponentów, które powinny być wykluczone 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 podawana w strefie czasowej klienta w formacie „rrrr-MM-dd HH:mm:ss”. W wersji 1 parametr create_time zostanie wycofany. Zamiast tego użyj kolumny creation_time.
creation_time	string Sygnatura czasowa utworzenia tej kampanii. Sygnatura czasowa jest podawana w strefie czasowej klienta i w formacie „rrrr-MM-dd HH:mm:ss”.
last_modified_time	string Data i godzina ostatniej modyfikacji tej kampanii. Data i godzina są podane w strefie czasowej klienta i w formacie „rrrr-MM-dd HH:mm:ss.ssssss”.
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ć znaku null (punkt kodowy 0x0), znaku nowego wiersza (punkt kodowy 0xA) ani znaku przejścia do nowej linii (punkt kodowy 0xD).
tracking_url_template	string Szablon adresu URL służący do tworzenia linku monitorującego.
campaign_budget	string Nazwa zasobu budżetu kampanii.
start_date	string Data rozpoczęcia kampanii w strefie czasowej klienta podana w formacie RRRR-MM-DD.
end_date	string Ostatni dzień kampanii w strefie czasowej klienta w formacie RRRR-MM-DD. Domyślnie podczas tworzenia kampanii jest to 30 grudnia 2037 r., co oznacza, że kampania będzie działać bezterminowo. Aby ustawić, że istniejąca kampania ma działać bezterminowo, ustaw w tym polu wartość 2037-12-30.
final_url_suffix	string Suffiks używany do dołączania parametrów zapytań do stron docelowych wyświetlanych ze śledzeniem równoległym.
url_expansion_opt_out	bool Określa wyłączenie rozszerzania adresów URL do bardziej ukierunkowanych adresów URL. Jeśli jest wyłączone (wartość „true”), kierowanie obejmuje tylko końcowe adresy URL w grupie komponentów lub adresy URL określone w plikach firmowych baz danych reklamodawcy w Google Merchant Center. Jeśli opcja jest włączona (fałsz), kierowanie zostanie ustawione na całą domenę. To pole można ustawić tylko w przypadku kampanii Performance Max, w których domyślna wartość to „fałsz”.
Pole unii campaign_bidding_strategy. Strategia ustalania stawek w kampanii. Musi to być portfolio (utworzone za pomocą usługi strategii określania stawek) lub standardowe, umieszczone w kampanii. campaign_bidding_strategy może być tylko jednym z tych elementów:
bidding_strategy	string Nazwa zasobu strategii portfolio ustalania stawek używanej przez kampanię.
manual_cpa	ManualCpa Standardowa strategia samodzielnego ustalania stawek CPA. Strategia samodzielnego ustawiania stawek, która umożliwia reklamodawcy ustawienie stawki za określone przez niego działanie. To ustawienie jest obsługiwane tylko w kampaniach w Usługach Lokalnych.
manual_cpc	ManualCpc Standardowa strategia samodzielnego określania stawek CPC. Ręczne określanie stawek na podstawie liczby kliknięć, w którym użytkownik płaci za kliknięcie.
manual_cpm	ManualCpm Standardowa strategia samodzielnego ustawiania 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 budżetu.
maximize_conversion_value	MaximizeConversionValue Standardowa strategia ustalania stawek Maksymalizacja wartości konwersji, która automatycznie ustala stawki, aby zmaksymalizować przychody w ramach budżetu.
target_cpa	TargetCpa Standardowa strategia określania stawek Docelowy CPA, która automatycznie ustala stawki, aby pomóc Ci uzyskać jak największą liczbę konwersji przy wybranym przez Ciebie docelowym koszcie pozyskania.
target_impression_share	TargetImpressionShare Strategia ustalania stawek Docelowy udział w wyświetleniach. Strategia automatycznego określania stawek, która ustala stawki tak, by osiągnąć 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, by pomóc Ci uzyskać jak najwięcej kliknięć w ramach budżetu.
percent_cpc	PercentCpc Standardowa strategia ustalania stawek Percent Cpc, w której stawki stanowią ułamek reklamowanej ceny produktu lub usługi.
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 (DSA).

Pola
domain_name	string Wymagane. Nazwa domeny internetowej reprezentowana przez 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 korzysta wyłącznie z adresów URL dostarczonych przez reklamodawcę.

GeoTargetTypeSetting

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

Pola
positive_geo_target_type	PositiveGeoTargetType Ustawienie używane do pozytywnego kierowania geograficznego w ramach tej konkretnej kampanii.
negative_geo_target_type	NegativeGeoTargetType Ustawienie używane do wykluczania kierowania geograficznego w danej kampanii.

NetworkSettings

ustawienia sieci dla kampanii,

Pola
target_google_search	bool Czy reklamy będą wyświetlane w wynikach wyszukiwania na stronie google.com.
target_search_network	bool Określ, czy reklamy mają się wyświetlać w witrynach partnerów w sieci wyszukiwania Google (wymaga, aby opcja target_google_search była też ustawiona na 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 mają się wyświetlać w sieci partnerskiej Google. Ta funkcja jest dostępna tylko na wybranych kontach partnerów Google.

OptimizationGoalSetting

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

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

SelectiveOptimization

Ustawienie optymalizacji selektywnej dla tej kampanii, które obejmuje zestaw działań powodujących konwersję, pod kątem których ma być optymalizowana kampania. Ta funkcja dotyczy tylko kampanii promujących aplikacje, w których jako AdvertisingChannelType występuje MULTI_CHANNEL lub APP_CAMPAIGN lub APP_CAMPAIGN_FOR_ENGAGEMENT.

Pola
conversion_actions[]	string Wybrany zestaw nazw zasobów działań powodujących konwersję, które mają służyć do optymalizacji tej kampanii.

ShoppingSetting

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

Pola
feed_label	string Etykieta pliku danych z produktami do uwzględnienia w kampanii. Można ustawić tylko jeden z tych atrybutów: feed_label lub sales_country. Jeśli zamiast sales_country użyjesz pola feed_label, pole to akceptuje kody krajów w tym samym formacie, np. „XX”. 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 chcesz kierować reklamy na zasoby reklamowe z kartami pojazdów.
merchant_id	int64 Identyfikator konta Merchant Center. To pole jest wymagane w przypadku operacji tworzenia. Tego pola nie można zmienić w kampaniach 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ższym priorytecie mają pierwszeństwo przed tymi o niższym priorytecie. To pole jest wymagane w przypadku kampanii produktowych. Wartości muszą się mieścić w zakresie od 0 do 2 włącznie. To pole jest opcjonalne w przypadku inteligentnych kampanii produktowych, ale jeśli jest ustawione, musi być równe 3.
enable_local	bool Czy uwzględnić produkty dostępne lokalnie.

TrackingSetting

Ustawienia na poziomie kampanii dotyczące informacji śledzenia.

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

CampaignAsset

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

Pola
resource_name	string Nazwa zasobu 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ą połączony jest komponent.
asset	string Komponent powiązany z kampanią.

Zestaw komponentów kampanii

Zestaw komponentów kampanii to połączenie między kampanią a zestawem komponentów. Dodanie zestawu komponentów kampanii powoduje połączenie 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ą postać: customers/{customer_id}/campaignAssetSets/{campaign_id}~{asset_set_id}
campaign	string Kampania, z którą połączony jest ten zestaw komponentów.
asset_set	string Zestaw komponentów powiązany z kampanią.
status	AssetSetLinkStatus Stan komponentu w zbiorze komponentów kampanii. Tylko do odczytu.

CampaignAudienceView

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

Pola
resource_name	string Nazwa zasobu w widoku odbiorców na poziomie kampanii. Nazwy zasobów widoku listy 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, w jakim wydawany jest budżet kampanii. Jeśli nie zostanie określona w operacji tworzenia, domyślnie przyjmuje wartość STANDARD.
period	BudgetPeriod Okres, w którym ma zostać wykorzystany budżet. Jeśli nie zostanie podany, przyjmuje domyślnie wartość DAILY (CODZIENNIE).
amount_micros	int64 Kwota budżetu w walucie lokalnej konta. Kwota jest podawana w mikro, gdzie milion odpowiada jednej jednostce waluty. Wydatki miesięczne są ograniczone do kwoty 30,4 razy większą od 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ą w strefie czasowej klienta i w formacie „rrrr-MM-dd GG:mm:ss.ssssss”.
criterion_id	int64 Identyfikator kryterium. To pole jest ignorowane podczas mutacji.
bid_modifier	float Modyfikator stawek w przypadku dopasowania do kryterium. Modyfikator musi należeć do zakresu od 0,1 do 10,0. Większość typów kryteriów kierowania reklam obsługuje modyfikatory. Aby zrezygnować z typu urządzenia, wpisz 0.
negative	bool Określ, czy chcesz kierować reklamy na to kryterium (false) czy je z niego wykluczać (true).
Pole sumy criterion. Kryterium kampanii. Musisz ustawić dokładnie 1 z nich. 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 związek między kampanią a efektywne etykiety. Etykieta obowiązująca to etykieta odziedziczona lub bezpośrednio przypisana do danej kampanii.

Pola
resource_name	string Nazwa zasobu. Nazwy zasobów CampaignEffectivelabel mają postać: customers/{customer_id}/campaignEffectiveLabels/{campaign_id}~{label_id}
campaign	string Kampania, do której jest przypisana skuteczna etykieta.
label	string Etykieta obowiązująca przypisana do kampanii.
owner_customer_id	int64 Identyfikator klienta, do którego należy dana etykieta.

CampaignLabel

Reprezentuje relację między kampanią a wytwórnią.

Pola
resource_name	string Nazwa zasobu. Nazwy zasobów etykiety kampanii mają postać: customers/{customer_id}/campaignLabels/{campaign_id}~{label_id}
campaign	string Kampania, do której dołączona jest 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 danych sprzedaży danych koszyka. Nazwy zasobów widoku danych o sprzedaży w koszyku mają postać: customers/{customer_id}/cartDataSalesView

Konwersje

konwersji,

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 jest nieprzypisane.
merchant_id	int64 Identyfikator konta asortymentu Search Ads 360 zawierającego produkt, który został kliknięty. 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 używany w przypadku wizyty, do której przypisana jest konwersja, przekazywany na stronę docelową jako parametr adresu URL identyfikatora kliknięcia.
visit_id	int64 Identyfikator wizyty Search Ads 360, do której przypisana jest konwersja.
advertiser_conversion_id	string W przypadku konwersji offline jest to identyfikator podawany przez reklamodawców. Jeśli reklamodawca nie poda takiego identyfikatora, wygeneruje go Search Ads 360. W przypadku konwersji online kolumna ta jest równa kolumnie id lub kolumnie floodlight_order_id w zależności od instrukcji Floodlight reklamodawcy.
product_id	string Identyfikator klikniętego produktu.
product_channel	ProductChannel Kanał sprzedaży produktu, który został kliknięty: online lub lokalnie.
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 reklamie lokalnego asortymentu produktów, który został kliknięty. Temu sklepowi muszą odpowiadać identyfikatory sklepów użyte 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: do wizyty czy do 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 qty url. Reklamodawca jest odpowiedzialny za dynamiczne wypełnianie tego parametru (np. liczby produktów sprzedanych w ramach konwersji). W przeciwnym razie jego wartość domyślna wynosi 1.
conversion_revenue_micros	int64 Skorygowane przychody w mikrosach dla zdarzenia konwersji. Zawsze będzie ona w walucie konta wyświetlającego reklamy.
floodlight_original_revenue	int64 Pierwotny, niezmieniony przychód powiązany z ze zdarzeniem Floodlight (w walucie bieżącego raportu) przed modyfikacją instrukcji dotyczących waluty Floodlight.
floodlight_order_id	string Identyfikator zamówienia Floodlight podany przez reklamodawcę dla danej konwersji.
status	ConversionStatus Stan konwersji: WŁĄCZONY lub USUNĄTY.
asset_id	int64 Identyfikator zasobu, z którym użytkownik miał interakcję podczas zdarzenia konwersji.
asset_field_type	AssetFieldType Typ pola zasobu 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 Znak czasu utworzenia aktywności Floodlight w formacie ISO 8601.
status	ConversionActionStatus Stan tego działania powodującego konwersję w przypadku 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 wartość parametru main_for_goal działania powodującego konwersję ma wartość false (fałsz), nie można określać stawki za działanie powodujące konwersję we wszystkich kampaniach, niezależnie od celu konwersji klienta lub kampanii. Cele konwersji niestandardowych nie uwzględniają jednak parametru primary_for_goal, więc jeśli w kampanii masz skonfigurowany cel konwersji niestandardowej z działaniem powodującym konwersję o parametrye primary_for_goal = false, to działanie to nadal będzie dostępne dla ustalania stawek. Jeśli nie zostanie ustawiony, domyślnie parametr primary_for_goal będzie miał wartość true. W wersji 9 parametr main_for_goal może mieć wartość false (fałsz) tylko po utworzeniu operacji „update”, ponieważ nie jest 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 Określa, czy dane działanie powodujące konwersję ma być uwzględniane w danych „client_account_conversions”.
include_in_conversions_metric	bool Określa, czy to działanie powodujące konwersję ma 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ę z 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 służący do identyfikowania grupy aktywności Floodlight podczas raportowania konwersji.
activity_tag	string Ciąg znaków służący do identyfikowania aktywności Floodlight podczas raportowania konwersji.
activity_id	int64 Identyfikator aktywności Floodlight w 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ść 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ło 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 nieobecnym 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 zamiast wartości i kodu waluty określonych w zdarzeniach konwersji dla tego działania powodującego konwersję mają być używane domyślna wartość i domyślny kod waluty.

ConversionCustomVariable

niestandardowa zmienna konwersji, Przeczytaj artykuł „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 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. Przed ani po nim nie może być żadnych dodatkowych spacji.
tag	string Wymagane. Tag zmiennej niestandardowej konwersji. Tag powinien być niepowtarzalny i zawierać bezpośrednio znak „u”, po którym znajduje się liczba mniejsza niż lub równa 100. Na przykład: „u4”.
status	ConversionCustomVariableStatus Stan zmiennej niestandardowej konwersji na potrzeby gromadzenia zdarzeń konwersji.
owner_customer	string Nazwa zasobu klienta, do którego należy zmienna niestandardowa 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 korzystają z tej niestandardowej zmiennej 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ń dla całego klienta związanych ze śledzeniem konwersji w Search Ads 360.

Pola
accepted_customer_data_terms	bool 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 https://support.google.com/adspolicy/answer/7475709.
conversion_tracking_status	ConversionTrackingStatus Stan śledzenia konwersji. Wskazuje, czy klient korzysta ze ś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 login-customer-id żądania.
enhanced_conversions_for_leads_enabled	bool Czy klient korzysta z konwersji rozszerzonych dotyczących 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 zarządzane nimi. To pole jest tylko do odczytu.
conversion_tracking_id	int64 Identyfikator śledzenia konwersji używany w przypadku tego konta. Ten identyfikator nie wskazuje, czy klient korzysta ze śledzenia konwersji (conversion_tracking_status). To pole jest tylko do odczytu.
google_ads_cross_account_conversion_tracking_id	int64 Identyfikator śledzenia konwersji menedżera klienta. Jest on ustawiany, gdy klient wyrazi zgodę na śledzenie konwersji, i zastępuje parametr conversion_tracking_id. Tego pola można używać tylko w interfejsie Google Ads. To pole jest tylko do odczytu.
cross_account_conversion_tracking_id	int64 Identyfikator śledzenia konwersji menedżera klienta. Jest on ustawiany, gdy klient włączy śledzenie konwersji dla wielu kont, i zastępuje parametr conversion_tracking_id.

CustomColumn

Kolumna niestandardowa. Informacje o kolumnie niestandardowej 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 Zdefiniowana przez użytkownika nazwa kolumny niestandardowej.
description	string Zdefiniowany przez użytkownika opis kolumny niestandardowej.
value_type	CustomColumnValueType Typ wartości kolumny niestandardowej.
references_attributes	bool Wartość Prawda, gdy kolumna niestandardowa odwołuje się do co najmniej 1 atrybutu.
references_metrics	bool Prawda, gdy kolumna niestandardowa odwołuje się do co najmniej 1 rodzaju danych.
queryable	bool Wartość Prawda, gdy 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 Sposób interpretacji wartości kolumny niestandardowej.

Klient

Klient.

Pola
resource_name	string Nazwa zasobu klienta. Nazwy zasobów klientów mają następujący format: 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 menedżera.
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ą w strefie czasowej klienta i w formacie „rrrr-MM-dd GG: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 podawana w strefie czasowej klienta i w formacie „rrrr-MM-dd HH:mm:ss”.
id	int64 Identyfikator klienta.
descriptive_name	string Opcjonalna, niepowtarzalna nazwa 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 lokalnego czasu klienta.
tracking_url_template	string Szablon URL do tworzenia linku monitorującego na podstawie parametrów.
final_url_suffix	string Szablon URL służący do dołączania parametrów do końcowego adresu URL.
auto_tagging_enabled	bool Określa, czy na koncie klienta jest włączone automatyczne tagowanie.
manager	bool czy klient jest menedżerem.

CustomerAsset

Połączenie między klientem a komponentem.

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

CustomerAssetSet

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

Pola
resource_name	string Nazwa zasobu zbioru zasobów klienta. Nazwy zasobów komponentów w zestawie komponentów mają postać: 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 jego klientem. CustomerClients istnieją tylko w przypadku klientów menedżera. Obejmują oni wszystkich klientów bezpośrednich i pośrednich, a także samego menedżera.

Pola
resource_name	string Nazwa zasobu klienta 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, które zostały zastosowane do klienta klienta. Nazwy zasobów etykiet mają postać: customers/{customer_id}/labels/{label_id}
status	CustomerStatus Stan klienta klienta. Tylko do odczytu.
client_customer	string Nazwa zasobu klienta, który jest powiązany z danym klientem. Tylko do odczytu.
hidden	bool Określa, czy jest to konto ukryte. Tylko do odczytu.
level	int64 Odległość między danym klientem a klientami. W przypadku połączenia własnego wartość poziomu będzie wynosić 0. Tylko do odczytu.
time_zone	string reprezentacja ciągu znaków strefy czasowej klienta zgodnie ze standardowym repozytorium danych (CLDR), 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 (np. „PLN”, „PLN”) klienta. Tylko do odczytu.
id	int64 Identyfikator klienta. Tylko do odczytu.

CustomerManagerLink

Reprezentuje relację między klientem a menedżerem.

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 Menedżer klienta powiązany z klientem.
manager_link_id	int64 Identyfikator połączenia klienta z menedżerem. To pole jest tylko do odczytu.
start_time	string Sygnatura czasowa utworzenia połączenia z klientem. Sygnatura czasowa jest podawana w strefie czasowej klienta i w formacie „rrrr-MM-dd HH:mm:ss”.

DoubleClickCampaignManagerSetting

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

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

DynamicSearchAdsSearchTermView

Widok wyszukiwanych haseł w ramach dynamicznych reklam 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 Dynamicznie wybrany URL strony docelowej wyświetlenia. To pole jest tylko do odczytu.

GenderView

Widok według płci. Zasób gender_view odzwierciedla stan skutecznego wyświetlania, a nie dodane kryteria. Grupa reklam bez kryteriów płci domyślnie wyświetla reklamy wszystkim płciom, więc w pliku gender_view z statystykami pojawiają się wszystkie płci.

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

GeoTargetConstant

Stała wartość kierowania geograficznego.

Pola
resource_name	string Nazwa zasobu stałej kierowania geograficznego. Nazwy stałych zasobów kierowania geograficznego mają postać: geoTargetConstants/{geo_target_constant_id}
status	GeoTargetConstantStatus Stała wartość kierowania geograficznego.
id	int64 Identyfikator stałej kierowania geograficznego.
name	string Stała nazwa angielska kierowania geograficznego.
country_code	string Kod kraju w formacie ISO-3166-1 alfa-2 powiązany z lokalizacją docelową.
target_type	string Typ docelowy kierowania geograficznego: stały.
canonical_name	string Pełna 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 nadrzędnej stałej docelowej geolokalizacji. 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łów kluczowych. Nazwy zasobów widoku słów kluczowych mają postać: customers/{customer_id}/keywordViews/{ad_group_id}~{criterion_id}

Etykieta

Etykieta.

Pola
resource_name	string Nazwa zasobu. Nazwy zasobów etykiet mają format: customers/{customer_id}/labels/{label_id}
status	LabelStatus Stan etykiety. Tylko do odczytu.
text_label	TextLabel Typ 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 powinno być puste podczas tworzenia nowej etykiety. Długość tego ciągu powinna mieścić się w zakresie od 1 do 80 znaków.

LanguageConstant

języka;

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. „pl_PL”, „en_US”, „en_AU”, „es”, „fr” itd.
name	string Pełna nazwa języka w języku angielskim, np. „English (US)”, „Spanish” itd.
targetable	bool Czy można kierować reklamy na ten język.

ListingGroupFilterDimension

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

Pola
Pole sumy dimension. Wymiar jednego z tych typów jest zawsze obecny. dimension może być tylko jednym z tych elementów:
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 ustalania stawek na określonym poziomie. Kategorie najwyższego poziomu mają poziom 1, ich podkategorie – poziom 2 itd. Obecnie obsługujemy maksymalnie 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 dla produktu. Ten identyfikator jest równoważny identyfikatorowi google_product_category opisanemu 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 Zalety 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ść ciągu 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 definiujące filtr grupy informacji o produktach.

Pola
dimensions[]	ListingGroupFilterDimension Pełna ścieżka wymiarów określonych przez hierarchię filtra grup informacji o produktach (bez węzła głównego) do tego filtra grup informacji o produktach.

LocationView

Widok „Lokalizacja” podsumowuje skuteczność kampanii według kryterium „Lokalizacja”.

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 ustalania stawek produktu. Nazwy zasobów kategorii ustalania stawek za produkty mają postać: productBiddingCategoryConstants/{country_code}~{level}~{id}
level	ProductBiddingCategoryLevel Poziom kategorii ustalania stawek dla produktów.
status	ProductBiddingCategoryStatus Stan kategorii ustalania stawek dla produktu.
id	int64 Identyfikator kategorii określania stawek dla produktu. Ten identyfikator jest równoważny identyfikatorowi google_product_category opisanemu w tym artykule: https://support.google.com/merchants/answer/6324436.
country_code	string Dwuliterowy kod kraju, który należy do kategorii określania stawek według produktów, zapisany wielkimi literami.
product_bidding_category_constant_parent	string Nazwa zasobu nadrzędnej kategorii określania stawek dla produktów.
language_code	string Kod języka kategorii określania stawek dla produktów.
localized_name	string Wartość wyświetlana w kategorii ustalania stawek produktów zlokalizowana zgodnie z kodem języka (language_code).

ProductGroupView

Widok grupy produktów.

Pola
resource_name	string Nazwa zasobu w 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 (element) używane 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 danych, które można wybrać za pomocą opisanego artefaktu.
attribute_resources[]	string nazwy wszystkich zasobów, które można wybrać w przypadku opisanego artefaktu; Pola z tych zasobów nie dzielą danych na segmenty, gdy są uwzględnione 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 ustawiony tylko dla artefaktów, których kategoria to RESOURCE.
segments[]	string To pole zawiera nazwy wszystkich artefaktów – segmentów i innych zasobów – tych, które segmentują dane, gdy są uwzględnione w zapytaniach i gdy opisywany artefakt jest używany w klauzuli FROM. Jest on ustawiany tylko w przypadku artefaktów, których kategoria to RESOURCE.
enum_values[]	string Wartości, które artefakt może przyjąć, jeśli jest to pole 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.
filterable	bool Określa, czy artefakt może być używany w klauzuli WHERE w zapytaniach wyszukiwania.
sortable	bool Określa, czy artefakt może być używany w klauzuli ORDER BY w zapytaniach wyszukiwania.
type_url	string Adres URL protokołu opisującego typ danych artefaktu.
is_repeated	bool Czy artefakt pola jest powtarzany.

ShoppingPerformanceView

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

Pola
resource_name	string Nazwa zasobu widoku wyników Zakupów. Nazwy zasobów widoku skuteczności w kampaniach produktowych 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 listy 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 (na przykład, jeśli access_reason=SHARED).

UserLocationView

Widok lokalizacji użytkownika.

Widok lokalizacji użytkownika obejmuje wszystkie dane zbiorcze na poziomie kraju, po jednym wierszu na kraj. Raportuje dane dotyczące rzeczywistej lokalizacji fizycznej użytkownika według lokalizacji, na którą jest ona kierowana lub nie. Jeśli używane są inne pola segmentu, możesz uzyskać więcej niż 1 wiersz na kraj.

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

Odwiedź

wizyta.

Pola
resource_name	string Nazwa zasobu wizyty. Nazwy 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 URL identyfikatora kliknięcia.
visit_date_time	string Sygnatura czasowa zdarzenia wizyty. Sygnatura czasowa jest podawana w strefie czasowej klienta i w formacie „rrrr-MM-dd HH:mm:ss”.
product_id	string Identyfikator klikniętego produktu.
product_channel	ProductChannel Kanał sprzedaży produktu, który został kliknięty: online lub lokalnie.
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 reklamie lokalnego asortymentu produktów, który został kliknięty. Temu sklepowi muszą odpowiadać identyfikatory sklepów użyte 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 zasobu, z którym nastąpiła interakcja podczas zdarzenia wizyty.
asset_field_type	AssetFieldType Typ pola zasobu zdarzenia wizyty.

WebpageView

Widok strony internetowej.

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