Package google.ads.searchads360.v0.resources

Indeks

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

AccessibleBiddingStrategy

Reprezentuje widok strategii ustalania stawek 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 BiddingStrategy.

Pola
resource_name	string Nazwa zasobu strategii ustalania stawek z dostępnością. 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 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 pomaga 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 pomóc Ci 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_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.

MaximizeConversionValue

Strategia automatycznego określania stawek, która pomaga uzyskać jak największą wartość konwersji dla Twoich kampanii 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

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

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 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ć. To wymagane pole, które reklamodawca wypełnia, aby ustawić limit i określić w mikrodane lokalne.

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 tak, aby 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ęć. Uczestnik aukcji TargetSpend spróbuje wydać mniejszą z tych wartości lub naturalną kwotę wydatków na ograniczanie. Jeśli nie podasz wartości docelowych wydatków, jako wartość docelowa wydatków zostanie użyty 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, jaki może ustawić strategia 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 name jest obecnie obsługiwane tylko w przypadku reklam DisplayUploadAd, ImageAd, ShoppingComparisonListingAd i VideoAd.
Pole unii 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. Skuteczna etykieta to etykieta dziedziczona lub bezpośrednio przypisana do tej 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 na kontach bram Microsoft Advertising i Facebooka. Format: RRRR-MM-DD Przykład: 2019-03-14
end_date	string Data, od której grupa reklam przestanie wyświetlać reklamy. 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 na kontach bram 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. Nazwa może zawierać maksymalnie 255 znaków w kodowaniu 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 usługi w grupie 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 obowiązujących etykiet dołączonych do tej reklamy. Skuteczna etykieta to etykieta odziedziczona lub bezpośrednio przypisana do tej 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 tej grupie reklam. Data i godzina są podane w strefie czasowej klienta i w formacie „rrrr-MM-dd HH: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 etykiety skuteczności reklamy grupy reklam mają postać: 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, do którego należy dana etykieta.

AdGroupAdLabel

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

Pola
resource_name	string Nazwa zasobu etykiety reklamy grupy reklam. Nazwy zasobów etykiet reklam grup 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ą postać: customers/{customer_id}/adGroupAssets/{ad_group_id}~{asset_id}~{field_type}
ad_group	string Wymagane. Grupa reklam, z którą jest powiązany komponent.
asset	string Wymagane. Komponent powiązany z grupą reklam.
status	AssetLinkStatus Stan komponentu grupy reklam.

AdGroupAssetSet

AdGroupAssetSet to połączenie między grupą reklam a zestawem komponentów. Tworzenie zestawu komponentów grupy reklam powoduje połączenie zestawu komponentów z grupą reklam.

Pola
resource_name	string Nazwa zasobu zbioru 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 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 listy odbiorców grupy reklam mają postać: customers/{customer_id}/adGroupAudienceViews/{ad_group_id}~{criterion_id}

AdGroupBidModifier

Reprezentuje modyfikator stawki grupy reklam.

Pola
resource_name	string Nazwa zasobu modyfikatora stawki 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 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 stawki grupy reklam. Wymagane 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 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 kwalifikuje się do uruchomienia. 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 tych przedziałach mogą widzieć reklamy, ale 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.
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 za kryterium 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 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 grupy 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 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 docelowych obsługuje modyfikatory.
cpc_bid_micros	int64 Stawka CPC (koszt kliknięcia).
effective_cpc_bid_micros	int64 Efektywny CPC (stawka kosztu kliknięcia).
engine_status	AdGroupCriterionEngineStatus Stan kryterium w grupie reklam w wyszukiwarce.
final_url_suffix	string Szablon 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ć 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 za kryterium 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, aby określić wartość.

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 przypisana skuteczna etykietka.
label	string Skuteczna etykieta przypisana do kryterium w grupie reklam.
owner_customer_id	int64 Identyfikator klienta, do którego należy dana etykieta.

AdGroupCriterionLabel

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

Pola
resource_name	string Nazwa zasobu etykiety kryterium grupy reklam. Nazwy zasobów etykiet kryteriów w grupie reklam mają postać: customers/{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 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 Skuteczna etykieta 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 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 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 podawana w strefie czasowej klienta i w formacie „rrrr-MM-dd HH:mm:ss”.
last_modified_time	string Data i godzina ostatniej modyfikacji tego 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 służący 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 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. AssetGroupAsset służy do łączenia komponentów z grupą plikó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 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 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 domyślnie adresy URL są kwalifikowane do rozwinięcia, chyba że ta opcja zostanie wyłączona.
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 grupy komponentó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 umiejscowienia komponentu w grupie komponentów. Na przykład: HEADLINE, YOUTUBE_VIDEO itp.
status	AssetLinkStatus Stan połączenia między komponentem a grupą komponentó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 grupa wizytówek określa swoje uszczegółowienie. Niezdefiniowane dla grupy rdzeniowej.
parent_listing_group_filter	string Nazwa zasobu podgrupy nadrzędnej grupy informacji. Wartość null w przypadku węzła filtra grupy informacji o produktach na poziomie katalogu katalogu.
path	ListingGroupFilterDimensionPath Ścieżka wymiarów definiująca ten filtr grupy informacji o produktach.

AssetGroupSignal

AssetGroupSignal reprezentuje sygnał w grupie komponentó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 przedstawiający wykorzystanie najlepszych kombinacji komponentów w grupie komponentów.

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

Zbiór komponentów reprezentujący kolekcję komponentów. Użyj AssetSetAsset, aby powiązać zasób 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

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

Pola
resource_name	string Nazwa zasobu w zbiorze 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 Zasób, z którym łączy się komponent w zbiorze komponentów.
status	AssetSetAssetStatus Stan zasobu w zbiorze komponentów. Tylko do odczytu.

Odbiorcy

Odbiorcy to skuteczna opcja kierowania, która umożliwia łączenie 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ć minimalną długość 1 i maksymalną 255.
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 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ą 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, które z większym prawdopodobieństwem prowadzą do konwersji, oraz obniża je w przypadku kliknięć, które prowadzą do konwersji z mniejszym prawdopodobieństwem.
maximize_conversion_value	MaximizeConversionValue Strategia automatycznego określania stawek, która pomaga 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 pomóc Ci 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ć konkretnego 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ż korzystają z tego schematu, 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ą 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ż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 elementach 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. Skuteczna etykieta to etykieta dziedziczona lub bezpośrednio przypisana do tej kampanii.
labels[]	string Nazwy zasobów etykiet dołączonych do tej kampanii.
bidding_strategy_type	BiddingStrategyType Typ strategii ustalania stawek. Strategię ustalania stawek moż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, z którymi jest ona udostępniona, i są odczytywane z zasobu AccessibleBiddingStrategy. Natomiast atrybuty ograniczone 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ść 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 w kolumnie AdvertisingChannelType mają wartość MULTI_CHANNEL, a w kolumnie AdvertisingChannelSubType – wartość 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 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 zostać wykluczone z tej kampanii. Linki 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. Podczas tworzenia kampanii domyślnie ustawiana jest data 30.12.2037, co oznacza, że kampania będzie działać bezterminowo. Aby ustawić, że istniejąca kampania ma działać bezterminowo, w tym polu wpisz 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 (false), kierowanie zostanie ustawione na całą domenę. To pole można ustawić tylko w przypadku kampanii Performance Max, gdzie domyślna wartość to „fałsz”.
Pole unii campaign_bidding_strategy. Strategia ustalania stawek w kampanii. Musi to być strategia portfolio (utworzona za pomocą usługi BiddingStrategy) lub standardowa, która jest umieszczana 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. Obsługiwane tylko w kampaniach Usług 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 ustalania stawek Manual CPM. Ręczne ustalanie stawek na podstawie wyświetleń, w którym użytkownik płaci za tysiąc wyświetleń.
maximize_conversions	MaximizeConversions Standardowa strategia ustalania stawek Maksymalizacja liczby konwersji, która automatycznie maksymalizuje liczbę konwersji w ramach określonego budżetu.
maximize_conversion_value	MaximizeConversionValue Standardowa strategia 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, aby uzyskać wybrany odsetek wyświetleń.
target_roas	TargetRoas Standardowa strategia ustalania stawek Docelowy ROAS, która automatycznie maksymalizuje przychody przy zachowaniu określonego docelowego zwrotu z nakładów na reklamę (ROAS).
target_spend	TargetSpend Standardowa strategia ustalania stawek pod kątem docelowych wydatków, która automatycznie ustala stawki tak, aby pomóc Ci uzyskać jak najwięcej kliknięć w ramach budżetu.
percent_cpc	PercentCpc Standardowa strategia ustalania stawek 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 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 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 opcja jest dostępna tylko dla wybranych kont 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 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 w kolumnie AdvertisingChannelType mają wartość MULTI_CHANNEL, a w kolumnie AdvertisingChannelSubType – wartość 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 chcesz uwzględnić w kampanii. Można ustawić tylko jeden z tych parametró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. W kampaniach produktowych tego pola nie można zmienić.
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 mieć wartość 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ą jest powiązany 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 jego powiązanie 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ą jest połączony 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 widoku listy odbiorców 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 wydawania budżetu kampanii. Jeśli w operacji tworzenia nie zostanie określony inaczej, domyślnie przyjmuje się STANDARD.
period	BudgetPeriod Okres, w którym ma być wykorzystany budżet. Jeśli nie zostanie podany, przyjmuje domyślnie wartość CODZIENNIE.
amount_micros	int64 Kwota budżetu w walucie lokalnej na koncie. 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, gdy kryterium jest zgodne. Modyfikator musi mieścić się w zakresie 0,1–10,0. Większość typów kryteriów docelowych 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 unii criterion. Kryterium kampanii. Musisz ustawić dokładnie 1 z nich. criterion może być tylko jednym z tych elementów:
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 zależność między kampanią a skuteczną etykietą. 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, 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 etykiet 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 z danymi 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

Konwersja

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 z nią konta asortymentowego.
ad_id	int64 Identyfikator reklamy. Wartość 0 oznacza, że reklama nie jest przypisana.
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 Search Ads 360, do której przypisana jest konwersja.
advertiser_conversion_id	string W przypadku konwersji offline jest to identyfikator podany przez reklamodawców. Jeśli reklamodawca nie poda takiego identyfikatora, wygeneruje go Search Ads 360. W przypadku konwersji online 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 + 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 jest podawana w walucie konta służącego do obsługi reklam.
floodlight_original_revenue	int64 Pierwotny, niezmieniony przychód powiązany 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 USUNIĘ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 sformatowany zgodnie z normą 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 bit primary_for_goal działania powodującego konwersję ma wartość false, nie można określać stawek na podstawie tego działania w przypadku żadnej kampanii, niezależnie od celu konwersji klienta lub celu konwersji kampanii. Cele konwersji niestandardowych nie uwzględniają jednak parametru primary_for_goal, więc jeśli 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 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 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ąć od interakcji (np. kliknięcia) do zdarzenia 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 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ść, której należy użyć, 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 jest skonfigurowane tak, aby zawsze używać wartości domyślnej.
default_currency_code	string Kod waluty, który ma być używany, gdy zdarzenia konwersji dla tego działania powodującego konwersję są wysyłane z nieprawidłowym lub 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 zmiennej niestandardowej konwersji.
name	string Wymagane. Nazwa zmiennej niestandardowej konwersji. Nazwa powinna być unikalna. Maksymalna długość nazwy to 100 znaków. Nie powinno być żadnych dodatkowych spacji przed imionami ani po nich.
tag	string Wymagane. Tag zmiennej niestandardowej konwersji. Tag powinien być unikalny i składać się z znaku „u” bezpośrednio poprzedzonego liczbą mniejszą lub równą 100. Na przykład: „u4”.
status	ConversionCustomVariableStatus Stan zmiennej niestandardowej konwersji na potrzeby gromadzenia zdarzeń konwersji.
owner_customer	string Nazwa zasobu klienta, który jest właścicielem zmiennej niestandardowej konwersji.
family	ConversionCustomVariableFamily Rodzina zmiennej niestandardowej konwersji.
cardinality	ConversionCustomVariableCardinality Moc zbioru zmiennej niestandardowej konwersji.
floodlight_conversion_custom_variable_info	FloodlightConversionCustomVariableInfo Pola niestandardowych zmiennych konwersji Floodlight w Search Ads 360.
custom_column_ids[]	int64 Identyfikatory kolumn niestandardowych, które 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ń dotyczących całego konta klienta związanych ze śledzeniem konwersji 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 stronie 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 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. 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 Wartość Prawda, gdy kolumna niestandardowa odnosi 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 klienta mają postać: customers/{customer_id}
conversion_tracking_setting	ConversionTrackingSetting Ustawienie śledzenia konwersji dla klienta.
account_type	AccountType Typ konta wyszukiwarki, np. Google Ads, Microsoft Advertising, Yahoo Japan, Baidu, Facebook, Engine Track itp.
double_click_campaign_manager_setting	DoubleClickCampaignManagerSetting Ustawienie DoubleClick Campaign Manager (DCM) dla klienta 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ą podane w strefie czasowej klienta i w formacie „rrrr-MM-dd HH:mm:ss.ssssss”.
engine_id	string Identyfikator konta w zewnętrznym koncie wyszukiwarki.
status	CustomerStatus Stan klienta.
creation_time	string Sygnatura czasowa utworzenia tego klienta. Sygnatura czasowa jest podawana w strefie czasowej klienta i w formacie „rrrr-MM-dd HH:mm:ss”.
manager_id	int64 Identyfikator klienta menedżera. Wartość 0 oznacza, że klient nie ma menedżera SA360.
manager_descriptive_name	string Nazwa opisowa menedżera.
sub_manager_id	int64 Identyfikator klienta podrzędnego konta menedżera. Wartość 0 oznacza, że klient nie ma podrzędnego konta menedżera SA360.
sub_manager_descriptive_name	string Nazwa opisowa podrzędnego konta menedżera.
associate_manager_id	int64 Identyfikator klienta powiązanego menedżera. Wartość 0 oznacza, że klient nie ma powiązanego konta menedżera SA360.
associate_manager_descriptive_name	string Nazwa opisowa powiązanego menedżera.
account_level	AccountLevelType Poziom konta klienta: menedżer, podrzędny menedżer, powiązany menedżer, konto usługi.
id	int64 Identyfikator klienta.
descriptive_name	string Opcjonalna, niepowtająca się nazwa klienta.
currency_code	string Waluta, w której działa konto. Obsługiwany jest podzbiór kodów walut według 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 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 powiązany z klientem.
status	AssetLinkStatus Stan zasobu klienta.

CustomerAssetSet

CustomerAssetSet to połączenie między klientem a zestawem komponentów. Dodanie zestawu komponentów klienta 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 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. Obejmuje to 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óry wysłał żądanie, które są stosowane 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 linku do siebie wartość poziomu będzie 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 CustomerManagerLink. 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 Manager 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 wyszukiwanego hasła w dynamicznej reklamie w wyszukiwarce

Pola
resource_name	string Nazwa zasobu widoku wyszukiwanych haseł dotyczącego dynamicznych reklam 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 stan wyświetlania, a nie dodane kryteria. Grupa reklam bez kryteriów płci domyślnie wyświetla reklamy wszystkim płciom, więc w kolumnie gender_view z danymi 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 kierowania geograficznego.

Pola
resource_name	string Nazwa zasobu stałej lokalizacji geograficznej. 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 hasła 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 Rodzaj etykiety z tekstem 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 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 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 są na poziomie 1, ich podkategorie na poziomie 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 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 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 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 określania stawek za produkty. Nazwy zasobów kategorii ustalania stawek za produkt mają postać: productBiddingCategoryConstants/{country_code}~{level}~{id}
level	ProductBiddingCategoryLevel Poziom kategorii ustalania stawek za produkt.
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 określania stawek dla produktów.
localized_name	string Wyświetlana wartość kategorii określania stawek dla produktu spersonalizowana zgodnie z kodem języka (language_code).

ProductGroupView

Widok grupy produktów

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

SearchAds360Field

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

Pola
resource_name	string Nazwa zasobu artefaktu. Nazwy zasobów artefaktów mają postać: SearchAds360Fields/{name}
category	SearchAds360FieldCategory Kategoria artefaktu.
selectable_with[]	string Nazwy wszystkich zasobów, segmentów i rodzajów danych, które można wybrać za pomocą opisanego artefaktu.
attribute_resources[]	string nazwy wszystkich zasobów, które można wybrać za pomocą opisanego artefaktu; Pola z tych zasobów nie 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 W tym polu znajduje się lista nazw wszystkich danych, które można wybrać w przypadku opisanego artefaktu, gdy jest on używany w nawiasach klamrowych FROM. Jest on ustawiany tylko w przypadku artefaktów, których kategoria to RESOURCE.
segments[]	string W tym polu znajduje się lista nazw wszystkich artefaktów (segmentów lub innych zasobów) z danymi segmentu, które są uwzględnione w zapytaniach wyszukiwania i które są używane 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ć w przypadku artefaktu 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 zakupów. 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. 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 Lokalizacja użytkownika zawiera wszystkie dane zagregowane na poziomie kraju (po jednym wierszu na kraj). Raportuje on dane o rzeczywistej fizycznej lokalizacji użytkownika według wybranej lub niewybranej lokalizacji. Jeśli używane są inne pola segmentu, możesz uzyskać więcej niż 1 wiersz na kraj.

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

Odwiedź

wizyta.

Pola
resource_name	string Nazwa zasobu wizyty. Nazwy zasobów wizyt mają postać: customers/{customer_id}/visits/{ad_group_id}~{criterion_id}~{ds_visit_id}
id	int64 Identyfikator wizyty.
criterion_id	int64 Identyfikator słowa kluczowego Search Ads 360. Wartość 0 oznacza, że słowo kluczowe nie jest przypisane.
merchant_id	int64 Identyfikator konta asortymentu Search Ads 360 zawierającego produkt, który został kliknięty. Search Ads 360 generuje ten identyfikator po połączeniu z nią konta asortymentowego.
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 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}