Package google.ads.searchads360.v0.resources

Indeks

AccessibleBiddingStrategy

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

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

Pola
resource_name

string

Nazwa zasobu dostępnej strategii ustalania stawek. Nazwy zasobów AccessibleStrategia określania 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 sumy scheme. Schemat określania stawek.

Można ustawić tylko jedną opcję. scheme może być tylko jedną z tych wartości:
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 pomoże Ci uzyskać jak najwięcej konwersji dla Twoich kampanii w ramach określonego budżetu.
target_cpa

TargetCpa

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

TargetImpressionShare

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

TargetRoas

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

TargetSpend

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

MaximizeConversionValue

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

Pola
target_roas

double

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

MaximizeConversions

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

Pola
target_cpa

int64

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

int64

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

TargetCpa

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

Pola
target_cpa_micros

int64

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

TargetImpressionShare

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

Pola
location

TargetImpressionShareLocation

Wybrana lokalizacja na stronie wyników wyszukiwania.
location_fraction_micros

int64

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

int64

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

TargetRoas

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

Pola
target_roas

double

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

TargetSpend

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

Pola
target_spend_micros
(deprecated)

int64

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

int64

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

Reklamą.

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 reklam.
name

string

Nazwa reklamy. Dane te służą tylko do identyfikacji reklamy. Nie musi być niepowtarzalna i nie ma wpływu na wyświetlaną reklamę. Pole nazwy jest obecnie obsługiwane tylko w przypadku reklam DisplayUploadAd, ImageAd, ShoppingComparisonListingAd i VideoAd.
Pole sumy ad_data. Szczegóły dotyczące typu reklamy. Musisz ustawić dokładnie jedną wartość. ad_data może być tylko jedną z tych wartości:
text_ad

SearchAds360TextAdInfo

Szczegóły dotyczące reklamy tekstowej.
expanded_text_ad

SearchAds360ExpandedTextAdInfo

Szczegóły dotyczące rozszerzonej reklamy tekstowej.
responsive_search_ad

SearchAds360ResponsiveSearchAdInfo

Szczegóły 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.

AdGroup

Grupa reklam.

Pola
resource_name

string

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

customers/{customer_id}/adGroups/{ad_group_id}
status

AdGroupStatus

Stan grupy reklam.
type

AdGroupType

Typ grupy reklam.
ad_rotation_mode

AdGroupAdRotationMode

Tryb rotacji reklam w grupie reklam.
creation_time

string

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

TargetingSetting

Ustawienie funkcji związanych z kierowaniem.
labels[]

string

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

string

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

string

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

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

string

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

Format: RRRR-MM-DD Przykład: 2019-03-14
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 GG:mm:ss.ssssss”.
id

int64

Identyfikator grupy reklam.
name

string

Nazwa grupy reklam.

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

Musi zawierać mniej niż 255 znaków UTF-8 o pełnej szerokości.

Nie może zawierać żadnych znaków null (punkt kodowy 0x0), przejścia do nowej linii NL (punkt kodowy 0xA) ani przejścia do nowej linii (punkt kodowy 0xD).
cpc_bid_micros

int64

Maksymalna stawka CPC (kosztu kliknięcia).
engine_status

AdGroupEngineStatus

Stan wyszukiwarki dla grupy reklam.

AdGroupAd

Reklamę z grupy reklam.

Pola
resource_name

string

Nazwa zasobu reklamy. Nazwy zasobów reklamowych 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 tej grupy ad_group_ad. Data i godzina są podane w strefie czasowej klienta i w formacie „rrrr-MM-dd GG:mm:ss.ssssss”.
labels[]

string

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

string

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

AdGroupAdEngineStatus

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

string

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

AdGroupAdLabel

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

Pola
resource_name

string

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

string

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

string

Etykieta przypisana do reklamy z grupy reklam.

AdGroupAsset

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

Pola
resource_name

string

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

customers/{customer_id}/adGroupAssets/{ad_group_id}~{asset_id}~{field_type}
ad_group

string

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

string

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

AssetLinkStatus

Stan komponentu grupy reklam.

AdGroupAssetSet

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

Pola
resource_name

string

Nazwa zasobu zestawu 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 połączony z grupą reklam.
status

AssetSetLinkStatus

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

AdGroupAudienceView

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

Pola
resource_name

string

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

customers/{customer_id}/adGroupAudienceViews/{ad_group_id}~{criterion_id}

AdGroupBidModifier

Reprezentuje modyfikator stawek grupy reklam.

Pola
resource_name

string

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

customers/{customer_id}/adGroupBidModifiers/{ad_group_id}~{criterion_id}
bid_modifier

double

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

Pole sumy criterion. Kryterium tego modyfikatora stawek grupy reklam.

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

DeviceInfo

Kryterium urządzenia.

AdGroupCriterion

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

Pola
resource_name

string

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

customers/{customer_id}/adGroupCriteria/{ad_group_id}~{criterion_id}
creation_time

string

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

AdGroupCriterionStatus

Stan kryterium.

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

QualityInfo

Informacje o jakości kryterium.
type

CriterionType

Rodzaj kryterium.
labels[]

string

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

PositionEstimates

Szacunki dla stawek dla różnych 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 czy Baidu. W przypadku jednostki Google Ads użyj „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 GG:mm:ss.ssssss”.
criterion_id

int64

Identyfikator kryterium.
ad_group

string

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

bool

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

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

double

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

int64

Stawka CPC (kosztu kliknięcia).
effective_cpc_bid_micros

int64

Efektywna stawka 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 sumy criterion. Kryterium grupy reklam.

Musisz ustawić dokładnie jeden. criterion może być 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 dla stawek dla różnych kryteriów na różnych pozycjach.

Pola
top_of_page_cpc_micros

int64

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

QualityInfo

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

Pola
quality_score

int32

Wynik jakości.

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

AdGroupCriterionLabel

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

Pola
resource_name

string

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

string

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

string

Etykieta przypisana do kryterium w grupie reklam.

AdGroupLabel

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

Pola
resource_name

string

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

string

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

string

Etykieta przypisana do grupy reklam.

AgeRangeView

Widok przedziału wiekowego.

Pola
resource_name

string

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

customers/{customer_id}/ageRangeViews/{ad_group_id}~{criterion_id}

Zasób

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

Pola
resource_name

string

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

customers/{customer_id}/assets/{asset_id}
type

AssetType

Typ zasobu.
final_urls[]

string

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

AssetStatus

Stan zasobu.
creation_time

string

Sygnatura czasowa utworzenia tego zasobu. Sygnatura czasowa jest 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 GG:mm:ss.ssssss”.
id

int64

Identyfikator zasobu.
name

string

Opcjonalna nazwa zasobu.
tracking_url_template

string

Szablon URL do tworzenia linku monitorującego.
engine_status

AssetEngineStatus

Stan wyszukiwarki zasobu.
Pole sumy asset_data. Konkretny typ zasobu. asset_data może być 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śnieniami.
page_feed_asset

UnifiedPageFeedAsset

Komponent z ujednoliconym plikiem z adresami stron docelowych.
mobile_app_asset

MobileAppAsset

Komponent z linkiem do aplikacji mobilnej.
call_asset

UnifiedCallAsset

Ujednolicony komponent do wykonywania połączeń.
call_to_action_asset

CallToActionAsset

Komponent z wezwaniem do działania.
location_asset

UnifiedLocationAsset

Ujednolicony komponent z lokalizacją.

AssetGroup

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

Pola
resource_name

string

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

customers/{customer_id}/assetGroups/{asset_group_id}
id

int64

Identyfikator grupy plików.
campaign

string

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

string

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

string

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

string

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

AssetGroupStatus

Stan grupy plików.
path1

string

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

string

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

AdStrength

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

AssetGroupAsset

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

Pola
resource_name

string

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

customers/{customer_id}/assetGroupAssets/{asset_group_id}~{asset_id}~{field_type}
asset_group

string

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

string

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

AssetFieldType

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

AssetLinkStatus

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

AssetGroupAssetCombinationData

Grupa plików – dane kombinacji komponentów

Pola
asset_combination_served_assets[]

AssetUsage

Wyświetlane komponenty.

AssetGroupListingGroupFilter

AssetGroupListingGroupFilter reprezentuje węzeł drzewa filtra grupy informacji o produktach w grupie zasobó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 elementu ListingGroupFilter.
type

ListingGroupFilterType

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

ListingGroupFilterVertical

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

ListingGroupFilterDimension

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

string

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

ListingGroupFilterDimensionPath

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

AssetGroupSignal

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

Pola
resource_name

string

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

customers/{customer_id}/assetGroupSignals/{asset_group_id}~{signal_id}
asset_group

string

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

AudienceInfo

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

AssetGroupTopCombinationView

Widok wykorzystania kombinacji komponentów reklamy w grupie reklam.

Pola
resource_name

string

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

AssetGroupAssetCombinationData

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

AssetSet

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

Pola
id

int64

Identyfikator zestawu zasobów.
resource_name

string

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

customers/{customer_id}/assetSets/{asset_set_id}

AssetSetAsset

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

Pola
resource_name

string

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

customers/{customer_id}/assetSetAssets/{asset_set_id}~{asset_id}
asset_set

string

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

string

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

AssetSetAssetStatus

Stan zasobu zestawu komponentów. Tylko do odczytu.

Odbiorcy

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

Pola
resource_name

string

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

customers/{customer_id}/audiences/{audience_id}
id

int64

Identyfikator listy odbiorców.
name

string

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

string

Opis tej listy odbiorców.

BiddingStrategy

Strategia ustalania stawek.

Pola
resource_name

string

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

customers/{customer_id}/biddingStrategies/{bidding_strategy_id}
status

BiddingStrategyStatus

Stan strategii ustalania stawek.

To pole jest tylko do odczytu.
type

BiddingStrategyType

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

To pole jest tylko do odczytu.
currency_code

string

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

W przypadku strategii ustalania stawek na kontach klientów menedżera tę walutę można ustawić podczas tworzenia konta i domyślnie przyjmuje się walutę klienta menedżera. Tego pola nie można ustawić w przypadku obsługi klientów. Wszystkie strategie obsługiwanego klienta domyślnie korzystają z waluty tego klienta. We wszystkich przypadkach pole „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ć osobne nazwy.

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

string

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

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

Dane strategii ustalania stawek są raportowane w tej walucie.

To pole jest tylko do odczytu.
campaign_count

int64

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

To pole jest tylko do odczytu.
non_removed_campaign_count

int64

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

To pole jest tylko do odczytu.

Pole sumy scheme. Schemat określania stawek.

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

EnhancedCpc

Strategia ustalania stawek, która podnosi stawki za kliknięcia, w przypadku których prawdopodobieństwo konwersji jest większe, i obniża je pod kątem kliknięć, w przypadku których prawdopodobieństwo jest mniejsze.
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 pomoże Ci uzyskać jak najwięcej konwersji dla Twoich kampanii w ramach określonego budżetu.
target_cpa

TargetCpa

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

TargetImpressionShare

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

TargetOutrankShare

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

TargetRoas

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

TargetSpend

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

Priorytet

Kampania.

Pola
resource_name

string

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

customers/{customer_id}/campaigns/{campaign_id}
status

CampaignStatus

Stan kampanii.

Po dodaniu nowej kampanii jej stan przyjmuje domyślnie wartość 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 cel wyświetlania reklam w kampanii. Opcje kierowania można zawęzić tutaj: network_settings.

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

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

AdvertisingChannelSubType

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

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

CustomParameter

Lista mapowań używanych do zastępowania tagów parametrów niestandardowych w tagach tracking_url_template, final_urls lub mobile_final_urls.
real_time_bidding_setting

RealTimeBiddingSetting

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

NetworkSettings

Ustawienia sieci dla kampanii.
dynamic_search_ads_setting

DynamicSearchAdsSetting

Ustawienie do kontrolowania dynamicznych reklam w wyszukiwarce.
shopping_setting

ShoppingSetting

Ustawienie do kontrolowania kampanii produktowych.
geo_target_type_setting

GeoTargetTypeSetting

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

FrequencyCapEntry

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

SelectiveOptimization

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

OptimizationGoalSetting

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

TrackingSetting

Ustawienia śledzenia informacji na poziomie kampanii.
engine_id

string

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

AssetFieldType

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

string

Sygnatura czasowa utworzenia tej kampanii. Sygnatura czasowa jest podana w strefie czasowej klienta i ma format „rrrr-MM-dd GG:mm:ss”. W wersji 1 atrybut create_time zostanie wycofany. Zamiast tego użyj parametru 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 kampanii. Data i godzina są podane w strefie czasowej klienta i w formacie „rrrr-MM-dd GG: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ć żadnych znaków null (punkt kodowy 0x0), przejścia do nowej linii NL (punkt kodowy 0xA) ani przejścia do nowej linii (punkt kodowy 0xD).
tracking_url_template

string

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

string

Budżet 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ślna wartość podczas tworzenia to 30.12.2037, co oznacza, że kampania będzie prowadzona bezterminowo. Aby ustawić bieżącą kampanię na czas nieokreślony, ustaw w tym polu wartość 30.12.2037.
final_url_suffix

string

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

bool

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

Pole sumy campaign_bidding_strategy. Strategia ustalania stawek w kampanii.

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

string

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

ManualCpa

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

ManualCpc

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

ManualCpm

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

MaximizeConversions

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

MaximizeConversionValue

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

TargetCpa

Standardowa strategia określania docelowych stawek CPA, która automatycznie ustala stawki, by pomóc Ci uzyskać jak największą liczbę konwersji przy wybranym przez Ciebie docelowym koszcie pozyskania (CPA).
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, aby osiągnąć określony odsetek wyświetleń.
target_roas

TargetRoas

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

TargetSpend

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

PercentCpc

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

TargetCpm

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

DynamicSearchAdsSetting

Ustawienie do kontrolowania dynamicznych reklam w wyszukiwarce.

Pola
domain_name

string

Wymagane. Nazwa domeny internetowej reprezentowana przez to ustawienie, na przykład „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

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

GeoTargetTypeSetting

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

Pola
positive_geo_target_type

PositiveGeoTargetType

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

NegativeGeoTargetType

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

NetworkSettings

Ustawienia sieci dla kampanii.

Pola
target_search_network

bool

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

bool

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

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

OptimizationGoalSetting

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

Pola
optimization_goal_types[]

OptimizationGoalType

Lista typów celów optymalizacji.

SelectiveOptimization

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

Pola
conversion_actions[]

string

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

ShoppingSetting

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

Pola
feed_label

string

Etykieta pliku danych z produktami do dodania do kampanii. Można ustawić tylko jeden parametr „feed_label” lub „sales_country”. Jeśli zostanie użyte zamiast wartości sales_country, pole pliku danych_etykieta będzie zawierać kody krajów w tym samym formacie, np. „XX”. W przeciwnym razie może to być dowolny ciąg znaków używany jako etykieta pliku danych w Google Merchant Center.
use_vehicle_inventory

bool

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

int64

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

string

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

int32

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

bool

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

TrackingSetting

Ustawienia śledzenia informacji na poziomie kampanii.

Pola
tracking_url

string

Adres URL używany do dynamicznego śledzenia.

CampaignAsset

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

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ą powiązany jest komponent.
asset

string

Komponent połączony z kampanią.

CampaignAssetSet

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

Pola
resource_name

string

Nazwa zasobu zestawu komponentów kampanii. Nazwy zasobów zestawu zasobó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 połączony z kampanią.
status

AssetSetLinkStatus

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

CampaignAudienceView

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

Pola
resource_name

string

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

customers/{customer_id}/campaignAudienceViews/{campaign_id}~{criterion_id}

CampaignBudget

Budżet kampanii.

Pola
resource_name

string

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

customers/{customer_id}/campaignBudgets/{campaign_budget_id}
delivery_method

BudgetDeliveryMethod

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

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

BudgetPeriod

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

int64

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

CampaignCriterion

Kryterium kampanii.

Pola
resource_name

string

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

customers/{customer_id}/campaignCriteria/{campaign_id}~{criterion_id}
display_name

string

Wyświetlana nazwa kryterium.

To pole jest ignorowane w przypadku mutacji.
type

CriterionType

Rodzaj 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 GG:mm:ss.ssssss”.
criterion_id

int64

Identyfikator kryterium.

To pole jest ignorowane podczas mutacji.
bid_modifier

float

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

bool

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

Pole sumy criterion. Kryterium kampanii.

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

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ęzykiem
webpage

WebpageInfo

Strona internetowa.
location_group

LocationGroupInfo

Grupa lokalizacji

CampaignLabel

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

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 została dołączona etykieta.
label

string

Etykieta przypisana do kampanii.

CartDataSalesView

Widok sprzedaży danych koszyka.

Pola
resource_name

string

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

Konwersje

Konwersja.

Pola
resource_name

string

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

customers/{customer_id}/conversions/{ad_group_id}~{criterion_id}~{ds_conversion_id}
id

int64

Identyfikator konwersji
criterion_id

int64

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

int64

Identyfikator konta asortymentowego SearchAds 360 zawierający kliknięty produkt. Search Ads360 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 reprezentujący wizytę, do której przypisano konwersję, przekazywany do strony docelowej jako parametr adresu URL identyfikatora kliknięcia.
visit_id

int64

Identyfikator wizyty SearchAds 360, do której jest przypisana konwersja.
advertiser_conversion_id

string

W przypadku konwersji offline jest to identyfikator podany przez reklamodawców. Jeśli reklamodawca nie poda identyfikatora, wygeneruje go Search Ads 360. W przypadku konwersji online wartość ta jest równa kolumnie id lub 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 lokalny.
product_language_code

string

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

string

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

string

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

AttributionType

Do czego przypisana jest konwersja: wizyta lub słowo kluczowe+reklama.
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 przypisano konwersję.
conversion_quantity

int64

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

int64

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

int64

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

string

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

ConversionStatus

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

int64

Identyfikator zasobu, z którym nastąpiła interakcja 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

Sygnatura czasowa 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 zgłoszonych dla 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 parametr primary_for_goal ma wartość false (fałsz), w przypadku działania powodującego konwersję nie można ustalać stawki w żadnej kampanii, niezależnie od celu konwersji klienta czy celu konwersji kampanii. Niestandardowe cele konwersji nie uwzględniają jednak ustawień „primary_for_goal”, więc jeśli kampania ma niestandardowy cel konwersji skonfigurowany z parametrem primary_for_goal = false (fałsz), nadal można ustalać stawki za to działanie powodujące konwersję. Jeśli nie zostanie ustawiony, domyślnie parametr primary_for_goal ma wartość true (prawda). W wersji 9 atrybut main_for_goal może mieć wartość „false” (fałsz) po utworzeniu za pomocą operacji „update”, ponieważ nie jest on zadeklarowany jako opcjonalny.
owner_customer

string

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

bool

Określa, czy to działanie powodujące konwersję ma 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, jaka może upływać między interakcją (np. kliknięciem) a zdarzeniem konwersji.
app_id

string

Identyfikator aplikacji 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 w przypadku tego działania powodującego konwersję.
data_driven_model_status

DataDrivenModelStatus

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

FloodlightSettings

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

Pola
activity_group_tag

string

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

string

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

int64

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

ValueSettings

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

Pola
default_value

double

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

string

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

bool

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

ConversionCustomVariable

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

Pola
resource_name

string

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

customers/{customer_id}/conversionCustomVariables/{conversion_custom_variable_id}
id

int64

Identyfikator niestandardowej zmiennej konwersji.
name

string

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

string

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

ConversionCustomVariableStatus

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

string

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

ConversionCustomVariableFamily

Rodzina zmiennej niestandardowej konwersji.
cardinality

ConversionCustomVariableCardinality

Moc zbioru niestandardowej zmiennej konwersji.
floodlight_conversion_custom_variable_info

FloodlightConversionCustomVariableInfo

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

int64

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

FloodlightConversionCustomVariableInfo

Informacje o zmiennych niestandardowych konwersji Floodlight w Search Ads 360.

Pola
floodlight_variable_type

FloodlightVariableType

Typ zmiennej Floodlight zdefiniowany w Search Ads 360.
floodlight_variable_data_type

FloodlightVariableDataType

Typ danych zmiennej Floodlight zdefiniowany w Search Ads 360.

ConversionTrackingSetting

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

Pola
accepted_customer_data_terms

bool

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

ConversionTrackingStatus

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

bool

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

string

Nazwa zasobu klienta, dla którego są tworzone i zarządzane konwersje. 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 (zwykle jest to conversion_tracking_status). To pole jest tylko do odczytu.
google_ads_cross_account_conversion_tracking_id

int64

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

int64

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

CustomColumn

Kolumna niestandardowa. Zobacz kolumnę niestandardową Search Ads 360 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 wyniku kolumny niestandardowej.
references_attributes

bool

Prawda, gdy kolumna niestandardowa odwołuje się do co najmniej jednego atrybutu.
references_metrics

bool

Prawda, gdy kolumna niestandardowa odwołuje się do co najmniej 1 rodzaju danych.
queryable

bool

Prawda, jeśli kolumna niestandardowa jest dostępna do użycia w zapytaniu SearchAds360Service.Search i SearchAds360Service.SearchStream.
referenced_system_columns[]

string

Lista kolumn systemowych, do których odwołuje się ta kolumna niestandardowa. Na przykład kolumna niestandardowa „Suma wyświetleń i kliknięć” odwołuje się do kolumn systemowych {"metrics.clicks", "metrics.impressions"}.

Klient

Klienta.

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, śledzenia wyszukiwarki itp.
double_click_campaign_manager_setting

DoubleClickCampaignManagerSetting

Ustawienie usługi 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 klienta. Data i godzina są podane w strefie czasowej klienta i w formacie „rrrr-MM-dd GG:mm:ss.ssssss”.
engine_id

string

Identyfikator konta na 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 nazwa opisowa klienta.
currency_code

string

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

string

Identyfikator lokalnej strefy czasowej klienta.
tracking_url_template

string

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

string

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

bool

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

bool

od tego, czy klient jest menedżerem.

CustomerAsset

Połączenie między klientem a komponentem.

Pola
resource_name

string

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

customers/{customer_id}/customerAssets/{asset_id}~{field_type}
asset

string

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

AssetLinkStatus

Stan komponentu klienta.

CustomerAssetSet

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

Pola
resource_name

string

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

customers/{customer_id}/customerAssetSets/{asset_set_id}
asset_set

string

Zestaw komponentów połączony 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

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

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 prośbę, które zostały zastosowane do klienta klienckiego. Nazwy zasobów etykiet mają postać:

customers/{customer_id}/labels/{label_id}
status

CustomerStatus

Stan klienta. Tylko do odczytu.
client_customer

string

Nazwa zasobu klient-klient, który jest połączony 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 klientem. W przypadku połączenia własnego wartość będzie wynosić 0. Tylko do odczytu.
time_zone

string

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

bool

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

bool

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

string

Opisowa nazwa klienta. Tylko do odczytu.
currency_code

string

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

int64

Identyfikator klienta. Tylko do odczytu.

DoubleClickCampaignManagerSetting

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

Pola
advertiser_id

int64

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

int64

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

string

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

DynamicSearchAdsSearchTermView

Widok wyszukiwanych haseł w dynamicznych reklamach w wyszukiwarce.

Pola
resource_name

string

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

customers/{customer_id}/dynamicSearchAdsSearchTermViews/{ad_group_id}~{search_term_fingerprint}~{headline_fingerprint}~{landing_page_fingerprint}~{page_url_fingerprint}
landing_page

string

Dynamicznie wybrany adres URL strony docelowej wyświetlenia.

To pole jest tylko do odczytu.

GenderView

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

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

Pola
resource_name

string

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

geoTargetConstants/{geo_target_constant_id}
status

GeoTargetConstantStatus

Stan stałego kierowania geograficznego.
id

int64

Identyfikator stałej wartości kierowania geograficznego.
name

string

Angielska nazwa stałej kierowania geograficznego.
country_code

string

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

string

Typ stałego celu kierowania geograficznego.
canonical_name

string

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

string

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

geoTargetConstants/{parent_geo_target_constant_id}

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}

Wytwórnia

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 wyświetlanej 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 przedziale od 1 do 80 włącznie.

LanguageConstant

Język.

Pola
resource_name

string

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

languageConstants/{criterion_id}
id

int64

Identyfikator stałej języka.
code

string

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

string

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

bool

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

ListingGroupFilterDimension

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

Pola
Pole sumy dimension. Wymiar jednego z poniższych typów zawsze jest obecny. dimension może być tylko jedną z tych wartości:
product_bidding_category

ProductBiddingCategory

Kategoria określania stawek oferty produktu.
product_brand

ProductBrand

Marka oferty produktu.
product_channel

ProductChannel

Lokalizacja oferty produktu.
product_condition

ProductCondition

Stan oferty produktu.
product_custom_attribute

ProductCustomAttribute

Atrybut niestandardowy oferty produktu.
product_item_id

ProductItemId

Identyfikator produktu w ofercie.
product_type

ProductType

Typ oferty produktu.

ProductBiddingCategory

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

Pola
level

ListingGroupFilterBiddingCategoryLevel

Wskazuje poziom kategorii w taksonomii.
id

int64

Identyfikator kategorii ustalania stawek dla produktu.

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

ProductBrand

Marka produktu.

Pola
value

string

Wartość ciągu znaków marki 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 w hierarchii filtrów grup informacji o produktach (z wyłączeniem węzła głównego) do tego filtra grupy informacji o produktach.

LocationView

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

Pola
resource_name

string

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

customers/{customer_id}/locationViews/{campaign_id}~{criterion_id}

ProductBiddingCategoryConstant

Kategoria określania stawek za produkt.

Pola
resource_name

string

Nazwa zasobu kategorii ustalania stawek za produkt. 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 ustalania stawek dla produktu.

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

string

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

string

Nazwa zasobu nadrzędnej kategorii ustalania stawek produktu.
language_code

string

Kod języka kategorii ustalania stawek za produkt.
localized_name

string

Wyświetlaj wartość kategorii ustalania stawek za produkt zlokalizowaną zgodnie z kodem 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 (artefakt) 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 wskaźników, które można wybrać przy użyciu opisanego artefaktu.
attribute_resources[]

string

Nazwy wszystkich zasobów, które można wybrać przy użyciu opisanego artefaktu. Pola z tych zasobów nie dzielą danych na segmenty, gdy występują w zapytaniach.

To pole jest ustawiane tylko dla artefaktów, których kategoria to RESOURCE.
metrics[]

string

To pole zawiera nazwy wszystkich wskaźników, które można wybrać z opisanym artefaktem, gdy jest ono używane w klauzuli FROM. Jest ustawiana tylko dla artefaktów, których kategoria to RESOURCE.
segments[]

string

To pole zawiera nazwy wszystkich artefaktów (segmentów czy innych zasobów), które dzielą dane na segmenty, gdy są uwzględnione w zapytaniach i kiedy dany artefakt jest używany w klauzuli FROM. Jest ustawiana tylko dla 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 ustawione tylko dla artefaktów 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.
filterable

bool

Określa, czy artefakt może być używany w klauzuli WHERE w zapytaniach.
sortable

bool

Określa, czy artefakt może być używany w klauzuli ORDER BY w zapytaniach.
type_url

string

Adres URL protokołu opisującego typ danych artefaktu.
is_repeated

bool

Wskazuje, czy artefakt pola się powtarza.

ShoppingPerformanceView

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

Pola
resource_name

string

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

UserList

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

Pola
resource_name

string

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

customers/{customer_id}/userLists/{user_list_id}
type

UserListType

Typ tej listy.

To pole jest tylko do odczytu.
id

int64

Identyfikator listy użytkowników.
name

string

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

Wejdź na

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 w Search Ads 360. Wartość 0 oznacza, że słowo kluczowe nie jest przypisane.
merchant_id

int64

Identyfikator konta asortymentowego Search Ads 360 zawierający kliknięty produkt. 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 przekazywany do strony docelowej jako parametr adresu 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 produktu, który został kliknięty: online lub lokalny.
product_language_code

string

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

string

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

string

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

int64

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

AssetFieldType

Typ pola komponentu zdarzenia wizyty.

WebpageView

Widok strony internetowej.

Pola
resource_name

string

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

customers/{customer_id}/webpageViews/{ad_group_id}~{criterion_id}