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)
• AdGroupAdLabel (komunikat)
• AdGroupAsset (komunikat)
• AdGroupAssetSet (komunikat)
• AdGroupAudienceView (komunikat)
• AdGroupBidModifier (komunikat)
• AdGroupCriterion (komunikat)
• AdGroupCriterion.PositionEstimates (komunikat)
• AdGroupCriterion.QualityInfo (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)
• Visit (komunikat)
• WebpageView (komunikat)

AccessibleBiddingStrategy

Reprezentuje widok strategii ustalania stawek należących do klienta i udostępnionych mu.

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 udostępnia danych, a tylko ograniczoną podzbiór atrybutów strategii ustalania stawek.

Pola
resource_name	string Nazwa zasobu dostępnej strategii ustalania stawek. Nazwy zasobów AccessibleOkreślanie stawek 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 unii 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 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 uzyskiwać jak najwięcej konwersji w kampaniach w ramach określonego budżetu.
target_cpa	TargetCpa Strategia ustalania stawek, która ustala stawki, aby Ci pomóc uzyskać jak największą liczbę konwersji przy wyznaczonym przez Ciebie docelowym koszcie pozyskania (CPA).
target_impression_share	TargetImpressionShare Strategia ustalania stawek, która automatycznie optymalizuje kampanię pod kątem wybranego odsetka wyświetleń.
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.

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 uzyskać z kampanii jak najwięcej konwersji w ramach określonego budżetu.

Pola
target_cpa	int64 Opcja docelowego kosztu 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 wydać na pozyskanie.

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

Automatyczna strategia określania stawek, która ustala stawki tak, aby określony procent reklam w wyszukiwarce wyświetlał się u góry pierwszej strony (lub w innym wybranym miejscu).

Pola
location	TargetImpressionShareLocation Wybrana lokalizacja na stronie wyników wyszukiwania.
location_fraction_micros	int64 Wybrany odsetek reklam, które mają być wyświetlane w wybranej lokalizacji w mikro. 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ć. To wymagane pole wprowadzane przez reklamodawcę, które ustawia limit i jest określone w mikrodane lokalne.

Docelowy ROAS

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 tak, aby pomóc Ci uzyskać jak najwięcej kliknięć w ramach budżetu.

Pola
target_spend_micros (deprecated)	int64 Ten produkt został wycofany. Docelowe wydatki, w ramach których należy zmaksymalizować liczbę kliknięć. Licytujący „Docelowy poziom wydatków” spróbuje wydać mniejszą z tych wartości lub będzie to kwota wynikająca z naturalnego ograniczenia wydatków. 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, którymi zarządza strategia.

Reklama

reklama,

Pola
resource_name	string Nazwa zasobu reklamy. Nazwy zasobów reklamowych 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 tekście reklamy w przypadku niektórych formatów reklamy.
name	string Nazwa reklamy. Pomaga nam to jedynie w identyfikacji reklamy. Nie musi być niepowtarzalna i nie wpływa na wyświetlaną reklamę. Pole name jest obecnie obsługiwane tylko w przypadku reklam DisplayUploadAd, ImageAd, ShoppingComparisonListingAd i VideoAd.
Pole sumy ad_data. Szczegóły dotyczące typu reklamy. Musisz podać dokładnie jedną wartość. ad_data może być tylko jednym z tych elementów:
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ą 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 podawana w strefie czasowej klienta i w formacie „rrrr-MM-dd HH:mm:ss”.
targeting_setting	TargetingSetting Ustawienia funkcji związanych 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. Etykieta obowiązująca to etykieta odziedziczona lub bezpośrednio przypisana do danej grupy reklam.
engine_id	string Identyfikator grupy reklam na koncie zewnętrznej 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 dniu określonym przez grupę reklam. Jeśli to pole jest skonfigurowane, grupa reklam kończy się o określonym dniu 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ą podane w strefie czasowej klienta i 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 pełnej szerokości w formacie UTF-8. 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.
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”.

AdGroupAdLabel

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

Pola
resource_name	string Nazwa zasobu etykiety reklamy grupy 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 z grupy reklam, do której dołączona jest etykieta.
label	string Etykieta przypisana do reklamy z grupy 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 powiązany 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, z którą połączony jest ten zestaw komponentów.
asset_set	string Zestaw komponentów powiązany z grupą reklam.
status	AssetSetLinkStatus Stan zestawu komponentów grupy reklam. Tylko do odczytu.

AdGroupAudienceView

Widok listy odbiorców grupy reklam. Zawiera dane o skuteczności pochodzące 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 na poziomie listy odbiorców.

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

AdGroupBidModifier

Reprezentuje modyfikator stawki 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 w przypadku dopasowania do kryterium. Modyfikator musi mieścić się w zakresie 0,1–10,0. Zakres wartości PreferredContent to 1,0–6,0. 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 kryteria, które zostały wyraźnie 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 podana w strefie czasowej klienta i w formacie „rrrr-MM-dd GG: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 każdy przedział wiekowy będzie oznaczony jako „włączony”, ponieważ użytkownicy w danym przedziale mogą widzieć reklamy, ale parametr AdGroupCriterion.status będzie miał wartość „usunięty”, 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.
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 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_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 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śl, czy chcesz kierować reklamy na to kryterium (false) czy je z niego wykluczać (true). Tego pola nie można zmienić. Aby zmienić kryterium z dodatniego na negatywne, usuń je, a następnie dodaj ponownie.
bid_modifier	double Modyfikator stawki w przypadku dopasowania do kryterium. Modyfikator musi mieścić się w zakresie 0,1–10,0. Większość typów kryteriów docelowych 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 wyszukiwarki dla kryterium grupy reklam.
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 unii criterion. Kryterium w grupie reklam. Musisz ustawić tylko jedną opcję. 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

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

Pola
top_of_page_cpc_micros	int64 Szacunkowa stawka CPC wymagana do wyświetlenia 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.

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/{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ą. Etykieta obowiązująca to etykieta odziedziczona lub bezpośrednio przypisana do danej 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ą postać: customers/{customer_id}/adGroupLabels/{ad_group_id}~{label_id}
ad_group	string Grupa reklam, do której dołączona jest 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. Komponentów nie można zmienić. Aby zatrzymać wyświetlanie komponentu, usuń go z elementu, który go używa.

Pola
resource_name	string Nazwa zasobu. Nazwy zasobów komponentó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 podana w strefie czasowej klienta i w formacie „rrrr-MM-dd GG: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 URL służący do tworzenia linku monitorującego.
engine_status	AssetEngineStatus Stan wyszukiwarki dla komponentu.
Pole unii asset_data. Konkretny typ zasobu. 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 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. Element AssetGroupAsset służy do łączenia komponentu z grupą plików. 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 grupy plików mają postać: customers/{customer_id}/assetGroups/{asset_group_id}
id	int64 Identyfikator grupy komponentó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. Musi być niepowtarzalna w ramach kampanii.
final_urls[]	string Lista końcowych adresów URL 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.
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 Pierwszy fragment tekstu, który może być dołączony 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 path1 jest ustawione.
ad_strength	AdStrength Ogólna skuteczność reklamy w tej grupie komponentów.

AssetGroupAsset

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

Pola
resource_name	string Nazwa zasobu zasobu grupy plików. Nazwa zasobu w grupie plików ma taki format: 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 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 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ść pusta dla węzła filtra grup informacji o produktach na poziomie głównym.
path	ListingGroupFilterDimensionPath Ścieżka wymiarów definiujących 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 komponentów. Nazwa zasobu sygnału grupy komponentó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 być tylko jednym z tych elementów:
audience	AudienceInfo Sygnał dotyczący odbiorców, który ma być używany przez kampanię Performance Max.

AssetGroupTopCombinationView

Widok dotyczący użycia 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 zasobów mają postać: customers/{customer_id}/assetSets/{asset_set_id}

AssetSetAsset

AssetSetAsset to połączenie między komponentem a zestawem komponentó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 komponentów, z którym łączy się komponent w zbiorze komponentó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

Odbiorcy to skuteczna opcja kierowania, która umożliwia krzyżowanie różnych atrybutów segmentów, np. szczegółowych danych demograficznych i powiązanych zainteresowań, w celu tworzenia list odbiorców reprezentujących sekcje segmentów docelowych.

Pola
resource_name	string Nazwa zasobu związanego z listą 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ą taką 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 w strategii ustalania stawek (trzyliterowy 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 bajtów (w tym przypadku w formacie UTF-8).
effective_currency_code	string Waluta używana przez strategię ustalania stawek (3-literowy 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ą 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 unii scheme. Schemat ustalania stawek. Można ustawić tylko jedną opcję. scheme może być tylko jednym z tych elementów:
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 je za kliknięcia, które prawdopodobnie nie spowodują konwersji.
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 uzyskiwać jak najwięcej konwersji w kampaniach w ramach określonego budżetu.
target_cpa	TargetCpa Strategia ustalania stawek, która ustala stawki, aby Ci pomóc uzyskać jak największą liczbę konwersji przy wyznaczonym 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 dodanie do kampanii strategii ustalania stawek z tym polem spowoduje niepowodzenie. Mutacje do strategii, które już zawierają ten schemat, są dozwolone.
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, aby umożliwić Ci uzyskanie jak największej liczby kliknięć w ramach budżetu.

Kampania

kampanii,

Pola
resource_name	string Nazwa zasobu kampanii. Nazwy zasobów kampanii mają następujący format: 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 systemu 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żesz dostosować 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 już 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 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 geograficznego reklam.
effective_labels[]	string Nazwy zasobów skutecznych 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żna utworzyć, ustawiając schemat ustalania stawek w celu utworzenia standardowej strategii ustalania stawek lub za pomocą pola bidding_strategy do utworzenia strategii 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, z którymi jest ona udostępniona, i są odczytywane z zasobu AccessibleBiddingStrategy. Natomiast atrybuty z ograniczonym dostępem są dostępne tylko dla właściciela strategii i jego menedżerów. Atrybuty ograniczone można odczytać tylko z zasosobu BiddingStrategy.
frequency_caps[]	FrequencyCapEntry Lista, która ogranicza częstotliwość, z jaką każdy użytkownik będzie widzieć reklamy z tej kampanii.
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 tej kampanii, które zawiera zestaw typów celów optymalizacji.
tracking_setting	TrackingSetting Ustawienia na poziomie kampanii dotyczące informacji śledzenia.
engine_id	string Identyfikator kampanii na koncie zewnętrznej 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 pola create_time.
creation_time	string Sygnatura czasowa utworzenia tej kampanii. Sygnatura czasowa jest podana w strefie czasowej klienta i 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 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 Rezygnuje z rozwinięcia adresu URL na bardziej ukierunkowane adresy URL. Jeśli ta opcja jest wyłączona (prawda), kierowanie obejmuje tylko końcowe adresy URL w grupie plików lub adresy URL określone w Google Merchant Center reklamodawcy albo w plikach firmowych baz danych reklamodawcy. Jeśli opcja jest włączona (fałsz), kierowanie zostanie ustawione na całą domenę. To pole można skonfigurować tylko w przypadku kampanii Performance Max, które mają wartość domyślną „false”.
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 mieć tylko jedną z tych wartości:
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 pozwala reklamodawcy określać stawkę za działanie 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 liczby kliknięć, w którym użytkownik płaci za kliknięcie.
manual_cpm	ManualCpm Standardowa strategia ustalania stawek Manual CPM. Samodzielne określanie 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 pod kątem docelowego udziału 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, aby 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. „en”.
use_supplied_urls_only	bool Określa, czy kampania używa wyłącznie adresów URL podanych 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 w kampanii.

Pola
target_google_search	bool Czy reklamy będą wyświetlane w wynikach wyszukiwania na stronie google.com.
target_search_network	bool Określa, czy reklamy będą wyświetlane w witrynach partnerów w sieci wyszukiwania Google (wymaga też ustawienia target_google_search jako true).
target_content_network	bool Określa, czy reklamy będą wyświetlane w określonych miejscach docelowych w sieci reklamowej Google. Miejsca docelowe określa się za pomocą kryterium Miejsce docelowe.
target_partner_search_network	bool Określa, czy reklamy mają się wyświetlać w sieci partnerskiej Google. Ta funkcja jest dostępna tylko na niektórych wybranych kontach partnerów Google.

OptimizationGoalSetting

Ustawienie celu optymalizacji tej kampanii, które zawiera 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 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.

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 produktów, które mają być uwzględnione w kampanii. Można ustawić tylko jedną wartość parametru 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 z wartościami 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 kampanii i komponentu.

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

Zestaw komponentów kampanii

CampaignAssetSet łączy kampanię z 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 odbiorców kampanii. 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 według kryteriów kampanii i odbiorców. Ten widok zawiera 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 w kampanii mają taką 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 określająca częstotliwość wydawania budżetu kampanii. Jeśli w operacji tworzenia nie określono inaczej, domyślna wartość to STANDARD.
period	BudgetPeriod Okres, w którym ma być wykorzystany budżet. Jeśli nie zostanie określona, domyślna wartość to DAILY.
amount_micros	int64 Kwota budżetu w walucie lokalnej konta. Kwota jest podana w milionowych częściach, 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ą podane w strefie czasowej klienta i w formacie „rrrr-MM-dd HH:mm:ss.ssssss”.
criterion_id	int64 Identyfikator kryterium. To pole jest ignorowane podczas operacji zmiany.
bid_modifier	float Modyfikator stawek w przypadku dopasowania do kryterium. Modyfikator musi mieścić się w zakresie 0,1–10,0. Większość typów kryteriów kierowania reklam obsługuje modyfikatory. Aby zrezygnować z urządzeń danego typu, wpisz 0.
negative	bool Określ, czy chcesz kierować reklamy na to kryterium (false) czy je z niego wykluczać (true).
Pole unii 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. Skuteczna etykieta to etykieta dziedziczona lub bezpośrednio przypisana do tej 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 skuteczności przypisana do kampanii.
owner_customer_id	int64 Identyfikator klienta, który jest właścicielem etykiety obowiązującej.

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 jest przypisana 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 Dane 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 w Search Ads 360. Wartość 0 oznacza, że kryterium nie zostało przypisane.
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 asortymentowego z tą usługą.
ad_id	int64 Identyfikator reklamy. Wartość 0 oznacza, że reklama jest nieprzypisana.
click_id	string Niepowtarzalny ciąg znaków odpowiadający wizycie, do której przypisana jest konwersja, przekazywany na stronę docelową jako parametr identyfikatora kliknięcia w adresie URL.
visit_id	int64 Identyfikator wizyty w Search Ads 360, do którego przypisana jest konwersja.
advertiser_conversion_id	string W przypadku konwersji offline jest to identyfikator podany przez reklamodawców. Jeśli reklamodawca nie określi takiego identyfikatora, Search Ads 360 go wygeneruje. 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 klikniętego produktu: 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 została przypisana 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 jest podawana w walucie konta służącego do obsługi reklam.
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ŁĄCZONA lub USUNIĘTA.
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ę na potrzeby 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ślna wartość parametru main_for_goal ma wartość true (prawda). 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 Określa, czy to działanie powodujące konwersję powinno być uwzględnione 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 w działaniu powodującym 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 używany 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, Informacje o niestandardowych danych i wymiarach Floodlight w nowej wersji Search Ads 360 znajdziesz 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 niestandardowej zmiennej niestandardowej konwersji na potrzeby naliczania 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 niestandardowej zmiennej konwersji.
floodlight_conversion_custom_variable_info	FloodlightConversionCustomVariableInfo Pola zmiennych niestandardowych 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 określony 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 Określa, czy klient wyraził zgodę na 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 zarządzane nimi. To pole jest tylko do odczytu.
conversion_tracking_id	int64 Identyfikator śledzenia konwersji używany na tym koncie. Ten identyfikator nie wskazuje, czy klient korzysta ze śledzenia konwersji (robi to parametr 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. 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 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 Wartość 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 wynikowej kolumny niestandardowej.

Klient

Klient.

Pola
resource_name	string Nazwa zasobu klienta. Nazwy zasobów klienta mają postać: customers/{customer_id}
conversion_tracking_setting	ConversionTrackingSetting Ustawienie śledzenia konwersji dla klienta.
account_type	AccountType rodzaj konta wyszukiwarki, np. Google Ads, Microsoft Advertising, Yahoo Japan, Baidu, Facebook, śledzenie wyszukiwarki itp.
double_click_campaign_manager_setting	DoubleClickCampaignManagerSetting Ustawienie usługi DoubleClick Campaign Manager (DCM) w przypadku 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 podana w strefie czasowej klienta i w formacie „rrrr-MM-dd GG:mm:ss”.
id	int64 Identyfikator klienta.
descriptive_name	string Opcjonalna, nieunikalna opisowa 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 adresu URL służący 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 automatyczne tagowanie jest włączone na koncie klienta.
manager	bool od tego, 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 zbiorem komponentów. Dodanie CustomerAssetSet powoduje połączenie zestawu komponentów z klientem.

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

CustomerClient

Połączenie między danym klientem a jego klientem. Klient CustomerClient jest przypisany tylko do 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 wysyłającego żądanie, które zostały zastosowane do klienta. Nazwy zasobów etykiet mają format: 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 to konto jest 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 Konto menedżera, które zostało połączone 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ł w dynamicznych reklamach w wyszukiwarce. Nazwy zasobów widoku hasła dynamicznych reklam 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 efektywny stan wyświetlania, a nie kryteria dodane. Grupa reklam bez kryteriów płci jest domyślnie wyświetlana wszystkim płciom, więc wszystkie płcie są widoczne w widoku gender_view ze statystykami.

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 kierowania geograficznego.

Pola
resource_name	string Nazwa zasobu stałej kierowania geograficznego. Nazwy zasobów stałych 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ą postać: 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 Określa, czy język, na który można kierować reklamy, jest dostępny.

ListingGroupFilterDimension

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

Pola
Pole unii 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 ustalania stawek w ofercie 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 są na poziomie 1, dla dzieci na poziomie 2 itd. Obecnie obsługujemy maksymalnie 5 poziomów. Użytkownik musi określić typ wymiaru wskazujący 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 odpowiednikiem identyfikatora google_product_category [kategoria_produktów_google], jak opisano w tym artykule: https://support.google.com/merchants/answer/6324436.

ProductBrand

Marka produktu.

Pola
value	string Wartość ciągu znaków odpowiadająca marce produktu.

ProductChannel

Lokalizacja oferty produktu.

Pola
channel	ListingGroupFilterProductChannel Wartość lokalizacji.

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 znaków niestandardowego atrybutu 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 przez hierarchię filtru grupy informacji o produktach (z wyjątkiem węzła głównego) do tego filtra grupy 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 za produkty. 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 w wielkich literach, do którego należy kategoria określania stawek dla produktu.
product_bidding_category_constant_parent	string Nazwa zasobu nadrzędnej kategorii określania stawek dla produktów.
language_code	string Kod języka kategorii ustalania stawek produktu.
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ą taką 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 segmentują danych, 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 on ustawiany tylko w przypadku 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 może przyjąć artefakt, 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 artefakt może być używany w klauzuli SELECT w zapytaniach wyszukiwania.
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 pliku proto opisu 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 w widoku skuteczności w Zakupach Google 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).

Odwiedź

wizyta.

Pola
resource_name	string Nazwa zasobu wizyty. Nazwy zasobów wizyt mają następujący format: 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 produkt, który został kliknięty. Search Ads 360 generuje ten identyfikator po połączeniu konta asortymentowego z tą usługą.
ad_id	int64 Identyfikator reklamy. Wartość 0 oznacza, że reklama jest nieprzypisana.
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 podana w strefie czasowej klienta i 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 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. Te informacje powinny być zgodne z identyfikatorami sklepów użytymi 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 użytkownik wszedł w interakcję 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}