Package google.ads.searchads360.v0.resources

Indeks

AccessibleBiddingStrategy

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

W przeciwieństwie do strategii ustalania stawek ten zasób zawiera strategie należące do menedżerów klienta, które zostały mu udostępnione, a także strategie należące do tego klienta. Ten zasób nie dostarcza danych i udostępnia tylko ograniczony podzbiór atrybutów strategii określania stawek.

Pola
resource_name

string

Nazwa zasobu dostępnej strategii ustalania stawek. Nazwy zasobów AccessibleOkreślanie stawek mają postać:

customers/{customer_id}/accessibleBiddingStrategies/{bidding_strategy_id}

id

int64

Identyfikator strategii ustalania stawek.

name

string

Nazwa strategii ustalania stawek.

type

BiddingStrategyType

Typ strategii ustalania stawek.

owner_customer_id

int64

Identyfikator klienta, do którego należy strategia ustalania stawek.

owner_descriptive_name

string

opisowa_nazwa klienta, do którego należy strategia ustalania stawek.

Pole sumy scheme. Schemat ustalania stawek.

Można ustawić tylko jedną opcję. scheme może mieć 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 pomaga uzyskać z kampanii jak najwięcej konwersji w ramach określonego budżetu.

target_cpa

TargetCpa

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

target_impression_share

TargetImpressionShare

Strategia ustalania stawek, która automatycznie optymalizuje kampanię pod kątem wybranego odsetka wyświetleń.

target_roas

TargetRoas

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

target_spend

TargetSpend

Strategia ustalania stawek, która ustala stawki tak, 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 jest ustawiony, strategia ustalania stawek maksymalizuje przychody, utrzymując średni docelowy zwrot z nakładów na reklamę. Jeśli docelowy ROAS jest wysoki, strategia 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 uzyskania najwyższego możliwego ROAS w ramach budżetu.

MaximizeConversions

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

Pola
target_cpa

int64

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

target_cpa_micros

int64

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

TargetCpa

Strategia automatycznego określania stawek, która ustala stawki, 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. Ta wartość docelowa powinna być co najmniej równa minimalnej jednostce podlegającej rozliczeniu na podstawie waluty konta.

TargetImpressionShare

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

Pola
location

TargetImpressionShareLocation

Wybrana lokalizacja na stronie wyników wyszukiwania.

location_fraction_micros

int64

Wybrany odsetek reklam, które mają być wyświetlane w wybranej lokalizacji w mikro. Na przykład 1% to 10 000.

cpc_bid_ceiling_micros

int64

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

TargetRoas

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

Pola
target_roas

double

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

TargetSpend

Strategia automatycznego określania stawek, która ustala stawki 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, w ramach których należy zmaksymalizować liczbę kliknięć. Licytujący „Docelowy poziom wydatków” spróbuje wydać mniejszą z tych wartości lub będzie to kwota wynikająca z naturalnego ograniczenia wydatków. Jeśli go nie podasz, jako docelowe wydatki będzie używany budżet. To pole zostało wycofane i nie powinno być już używane. Szczegółowe informacje można znaleźć na stronie https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html.

cpc_bid_ceiling_micros

int64

Limit maksymalnej stawki, który można ustawić w strategii ustalania stawek. Limit dotyczy wszystkich słów kluczowych, którymi zarządza strategia.

Reklama.

Pola
resource_name

string

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

customers/{customer_id}/ads/{ad_id}

final_urls[]

string

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

type

AdType

Typ reklamy.

id

int64

Identyfikator reklamy.

display_url

string

Adres URL widoczny w tekście reklamy w przypadku niektórych formatów reklamy.

name

string

Nazwa reklamy. Pomaga nam to jedynie w identyfikacji reklamy. Nie musi być niepowtarzalna i nie 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 mieć tylko jedną z tych wartości:
text_ad

SearchAds360TextAdInfo

Szczegóły dotyczące reklamy tekstowej.

expanded_text_ad

SearchAds360ExpandedTextAdInfo

Szczegóły dotyczące rozszerzonej reklamy tekstowej.

responsive_search_ad

SearchAds360ResponsiveSearchAdInfo

Szczegóły dotyczące elastycznej reklamy w wyszukiwarce.

product_ad

SearchAds360ProductAdInfo

Szczegóły dotyczące reklamy produktu.

expanded_dynamic_search_ad

SearchAds360ExpandedDynamicSearchAdInfo

Szczegóły dotyczące rozszerzonej dynamicznej reklamy w wyszukiwarce.

Grupa reklam

Grupa reklam.

Pola
resource_name

string

Nazwa zasobu grupy reklam. Nazwy zasobów grup reklam mają następujący format:

customers/{customer_id}/adGroups/{ad_group_id}

status

AdGroupStatus

Stan grupy reklam.

type

AdGroupType

Typ grupy reklam.

ad_rotation_mode

AdGroupAdRotationMode

Tryb rotacji reklam w grupie reklam.

creation_time

string

Sygnatura czasowa określająca, kiedy grupa reklam została utworzona. Sygnatura czasowa jest podana w strefie czasowej klienta i w formacie „rrrr-MM-dd HH:mm:ss”. .

targeting_setting

TargetingSetting

Ustawienie kierowania na funkcje związane z kierowaniem.

labels[]

string

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

engine_id

string

Identyfikator grupy reklam na zewnętrznym koncie wyszukiwarki. To pole dotyczy tylko konta innego niż Google Ads, np. Yahoo Japan, Microsoft, Baidu itp. W przypadku podmiotu Google Ads użyj „ad_group.id” .

start_date

string

Data rozpoczęcia wyświetlania reklam w tej grupie reklam. Domyślnie grupa reklam zaczyna się teraz lub data rozpoczęcia grupy reklam (w zależności od tego, co nastąpi później). Jeśli to pole jest skonfigurowane, grupa reklam rozpoczyna się w określonym dniu w strefie czasowej klienta. To pole jest dostępne tylko w przypadku kont Microsoft Advertising i Facebooka.

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

end_date

string

Data zakończenia wyświetlania reklam przez grupę reklam. Domyślnie grupa reklam kończy się w dniu określonym przez grupę reklam. Jeśli to pole jest skonfigurowane, grupa reklam kończy się o określonym dniu w strefie czasowej klienta. To pole jest dostępne tylko w przypadku kont Microsoft Advertising i Facebooka.

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

language_code

string

Język reklam i słów kluczowych w grupie reklam. To pole jest dostępne tylko na kontach Microsoft Advertising. Więcej informacji: https://docs.microsoft.com/en-us/advertising/guides/ad-languages?view=bingads-13#adlanguage

last_modified_time

string

Data i godzina ostatniej modyfikacji tej grupy reklam. Data i godzina są w strefie czasowej klienta i w formacie „rrrr-MM-dd HH:mm:ss.sssss”. .

id

int64

Identyfikator grupy reklam.

name

string

Nazwa grupy reklam.

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

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

Nie może zawierać znaków pustych (punkt kodowy 0x0), znaku nowego wiersza (punkt kodowy 0xA) ani znaków 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

Reklama z grupy reklam.

Pola
resource_name

string

Nazwa zasobu reklamy. Nazwy zasobów reklamowych w grupie reklam mają postać:

customers/{customer_id}/adGroupAds/{ad_group_id}~{ad_id}

status

AdGroupAdStatus

Stan reklamy.

ad

Ad

Reklama.

creation_time

string

Sygnatura czasowa określająca, kiedy grupa reklam została utworzona. Data i godzina są w strefie czasowej klienta i w formacie „rrrr-MM-dd HH:mm:ss.sssss”. .

labels[]

string

Nazwy zasobów etykiet dołączonych do tej reklamy należącej do grupy reklam.

engine_id

string

Identyfikator reklamy na zewnętrznym koncie wyszukiwarki. To pole jest przeznaczone tylko do konta Search Ads 360, np. Yahoo Japan, Microsoft, Baidu. W przypadku elementu spoza Search Ads 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, kwalifikujące się, oczekujące na sprawdzenie itp.

last_modified_time

string

Data i godzina ostatniej modyfikacji reklamy z grupy reklam. Data i godzina są w strefie czasowej klienta i w formacie „rrrr-MM-dd HH:mm:ss.sssss”. .

AdGroupAdLabel

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

Pola
resource_name

string

Nazwa zasobu etykiety reklamy w grupie reklam. Nazwy zasobów etykiet reklam w grupie reklam mają następujący format: customers/{customer_id}/adGroupAdLabels/{ad_group_id}~{ad_id}~{label_id}

ad_group_ad

string

Reklama z grupy 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 komponentu grupy reklam. Nazwy zasobów AdGroupAsset mają następujący format:

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

ad_group

string

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

asset

string

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

status

AssetLinkStatus

Stan komponentu grupy reklam.

AdGroupAssetSet

AdGroupAssetSet łączy grupę reklam z zestawem komponentów. Utworzenie AdGroupAssetSet łączy zestaw komponentów z grupą reklam.

Pola
resource_name

string

Nazwa zasobu zestawu komponentów grupy reklam. Nazwy zasobów zestawu komponentów w grupach reklam mają taką 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

Zbiór plików połączony z grupą reklam.

status

AssetSetLinkStatus

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

AdGroupAudienceView

Widok odbiorców grupy reklam. Zawiera dane o skuteczności oparte na zainteresowaniach i listach remarketingowych dla reklam w sieci reklamowej i w YouTube oraz z list remarketingowych dla reklam w wyszukiwarce (RLSA) zebrane na poziomie odbiorców.

Pola
resource_name

string

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

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

AdGroupBidModifier

Odnosi się do modyfikatora stawek grupy reklam.

Pola
resource_name

string

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

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

bid_modifier

double

Modyfikator stawki w przypadku dopasowania do kryterium. Modyfikator musi należeć do zakresu od 0,1 do 10,0. Zakres wynosi od 1,0 do 6,0 w przypadku treści PreferredContent. Aby zrezygnować z urządzeń danego typu, wpisz 0.

Pole sumy criterion. Kryterium tego modyfikatora stawek grupy reklam.

Wymagane w operacjach tworzenia rozpoczynających się w wersji 5. criterion może mieć tylko jedną z tych wartości:

device

DeviceInfo

Kryterium urządzenia.

AdGroupCriterion

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

Pola
resource_name

string

Nazwa zasobu kryterium w grupie reklam. Nazwy zasobów kryterium w grupie reklam mają następującą postać:

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

creation_time

string

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

status

AdGroupCriterionStatus

Stan kryterium.

To jest stan elementu kryterium w grupie reklam ustawiony przez klienta. Uwaga: raporty w interfejsie mogą zawierać dodatkowe informacje, które wpływają na to, czy dane kryterium może zostać zrealizowane. W niektórych przypadkach kryterium, które zostało USUNIĘTE w interfejsie API, może być nadal wyświetlane jako włączone w interfejsie. Na przykład kampanie domyślnie wyświetlają reklamy użytkownikom ze wszystkich przedziałów wiekowych, chyba że zostaną wykluczone. W interfejsie poszczególne przedziały wiekowe będą oznaczone jako „włączone”, ponieważ użytkownikom mogą się wyświetlać reklamy. ale AdGroupCriterion.status wyświetli wartość „usunięto”, ponieważ nie dodano żadnego niewykluczającego kryterium.

quality_info

QualityInfo

Informacje dotyczące jakości kryterium.

type

CriterionType

Typ kryterium.

labels[]

string

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

position_estimates

PositionEstimates

Szacunki stawek 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 konta innego niż Google Ads, np. Yahoo Japan, Microsoft, Baidu itp. W przypadku elementu Google Ads użyj „ad_group_criterion.kryterium_id” .

last_modified_time

string

Data i godzina ostatniej modyfikacji tego kryterium w grupie reklam. Data i godzina są w strefie czasowej klienta i w formacie „rrrr-MM-dd HH:mm:ss.sssss”. .

criterion_id

int64

Identyfikator kryterium.

ad_group

string

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

negative

bool

Określa, czy kryterium ma być celem (false), czy też wykluczone (true).

Tego pola nie można zmienić. Aby zmienić kryterium z pozytywnego na negatywne, usuń je, a następnie dodaj ponownie.

bid_modifier

double

Modyfikator stawki w przypadku dopasowania do kryterium. Modyfikator musi należeć do zakresu od 0,1 do 10,0. Większość typów kryteriów kierowania reklam obsługuje modyfikatory.

cpc_bid_micros

int64

Stawka CPC (kosztu kliknięcia).

effective_cpc_bid_micros

int64

Efektywna stawka CPC (kosztu 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 URL do tworzenia linku monitorującego.

Pole sumy criterion. Kryterium w grupie reklam.

Musisz ustawić tylko jedną opcję. criterion może mieć tylko jedną z tych wartości:

keyword

KeywordInfo

Słowo kluczowe.

listing_group

ListingGroupInfo

Grupa informacji o produktach.

age_range

AgeRangeInfo

Przedział wiekowy.

gender

GenderInfo

Płeć.

user_list

UserListInfo

Lista użytkowników.

webpage

WebpageInfo

Strona internetowa

location

LocationInfo

Lokalizacja.

PositionEstimates

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

Pola
top_of_page_cpc_micros

int64

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

QualityInfo

Kontener informacji o jakości kryterium w grupie reklam.

Pola
quality_score

int32

Wynik jakości.

To pole może być puste, jeśli Google nie ma wystarczającej ilości informacji do określenia wartości.

AdGroupCriterionLabel

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

Pola
resource_name

string

Nazwa zasobu etykiety kryterium w grupie reklam. Nazwy zasobów etykiet kryterium w grupie reklam mają następujący format: customers/{customer_id}/adGroupCriterionLabels/{ad_group_id}~{criterion_id}~{label_id}

ad_group_criterion

string

Kryterium w grupie reklam, do którego dołączona jest etykieta.

label

string

Etykieta przypisana do kryterium w grupie reklam.

AdGroupLabel

Relacja między grupą reklam a etykietą.

Pola
resource_name

string

Nazwa zasobu etykiety grupy reklam. Nazwy zasobów etykiet grup reklam mają następujący format: customers/{customer_id}/adGroupLabels/{ad_group_id}~{label_id}

ad_group

string

Grupa reklam, do której dołączona jest 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 w widoku przedziału wiekowego mają następujący format:

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

Komponent

Zasób to część reklamy, która może być wykorzystywana w wielu reklamach. Może to być obraz (ImageAsset), film (YouTubeVideoAsset) itp. Komponentów nie można zmienić. Aby zatrzymać wyświetlanie komponentu, usuń go z elementu, który go używa.

Pola
resource_name

string

Nazwa zasobu. Nazwy zasobów 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 określająca, kiedy zasób został utworzony. Sygnatura czasowa jest podana w strefie czasowej klienta i w formacie „rrrr-MM-dd HH:mm:ss”. .

last_modified_time

string

Data i godzina ostatniej modyfikacji komponentu. Data i godzina są w strefie czasowej klienta i w formacie „rrrr-MM-dd HH:mm:ss.sssss”. .

id

int64

Identyfikator zasobu.

name

string

Opcjonalna nazwa zasobu.

tracking_url_template

string

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

engine_status

AssetEngineStatus

Stan wyszukiwarki zasobu.

Pole sumy asset_data. Konkretny typ zasobu. asset_data może mieć tylko jedną z tych wartości:
youtube_video_asset

YoutubeVideoAsset

Zasób wideo w YouTube

image_asset

ImageAsset

Komponent z obrazem.

text_asset

TextAsset

Komponent tekstowy.

callout_asset

UnifiedCalloutAsset

Ujednolicony komponent z objaśnieniem.

page_feed_asset

UnifiedPageFeedAsset

Komponent z ujednoliconym plikiem z adresami stron docelowych.

mobile_app_asset

MobileAppAsset

Komponent aplikacji mobilnej

call_asset

UnifiedCallAsset

Ujednolicony komponent do wykonywania połączeń.

call_to_action_asset

CallToActionAsset

Komponent z wezwaniem do działania

location_asset

UnifiedLocationAsset

Ujednolicony komponent z lokalizacją.

AssetGroup

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

Pola
resource_name

string

Nazwa zasobu grupy plików. Nazwy zasobów grup plików mają format:

customers/{customer_id}/assetGroups/{asset_group_id}

id

int64

Identyfikator grupy plików.

campaign

string

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

name

string

Wymagane. Nazwa grupy plików. Wymagane. Minimalna długość to 1 i maksymalna 128 znaków. Nie może się powtarzać w ramach kampanii.

final_urls[]

string

Lista końcowych adresów URL po wszystkich przekierowaniach między domenami. W kampanii Performance Max adresy URL domyślnie kwalifikują się do rozwijania, o ile nie zrezygnujesz z tej opcji.

final_mobile_urls[]

string

Lista końcowych mobilnych adresów URL po wszystkich przekierowaniach między domenami. W kampanii Performance Max adresy URL domyślnie kwalifikują się do rozwijania, o ile nie zrezygnujesz z tej opcji.

status

AssetGroupStatus

Stan grupy plików.

path1

string

Pierwsza część tekstu, która może być dołączana do adresu URL wyświetlanego w reklamie.

path2

string

Druga część tekstu, która może być dołączana do adresu URL wyświetlanego w reklamie. To pole można ustawić tylko wtedy, gdy ustawiona jest ścieżka 1.

ad_strength

AdStrength

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

AssetGroupAsset

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

Pola
resource_name

string

Nazwa zasobu zasobu grupy plików. Nazwa zasobu w grupie plików ma taki format:

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

asset_group

string

Grupa plików, z którą łączysz ten komponent grupy plików.

asset

string

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

field_type

AssetFieldType

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

status

AssetLinkStatus

Stan połączenia między zasobem a grupą plików.

AssetGroupAssetCombinationData

Grupa plików – dane o kombinacji komponentów

Pola
asset_combination_served_assets[]

AssetUsage

Wyświetlone komponenty.

AssetGroupListingGroupFilter

AssetGroupListingGroupFilter reprezentuje węzeł drzewa filtra grup 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 grup informacji o produktach w grupie plików ma taki format:

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.

id

int64

Identyfikator elementu ListingGroupFilter.

type

ListingGroupFilterType

Typ węzła filtra grup informacji o produktach.

vertical

ListingGroupFilterVertical

Branża reprezentowana przez 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 zawęża obiekt nadrzędny. Nieokreślona dla grupy głównej.

parent_listing_group_filter

string

Nazwa zasobu dla podziału nadrzędnej grupy informacji o produktach. Wartość pusta dla węzła filtra grup informacji o produktach na poziomie głównym.

path

ListingGroupFilterDimensionPath

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

AssetGroupSignal

AssetGroupSignal reprezentuje sygnał w grupie plików. Sygnały są przekazywane do kampanii Performance Max, którzy z większym prawdopodobieństwem dokonają 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ł.

Pole sumy signal. Sygnał grupy plików. signal może mieć tylko jedną z tych wartości:
audience

AudienceInfo

Sygnał dotyczący odbiorców do użycia w kampanii Performance Max.

AssetGroupTopCombinationView

Widok wykorzystania kombinacji komponentów reklamy w grupie reklam.

Pola
resource_name

string

Nazwa zasobu dla widoku kombinacji u góry grupy plików. Nazwy zasobów widoku Najważniejsze kombinacje grupy zasobów mają format: `"customers/{customer_id}/assetGroupTopCombinationViews/{asset_group_id}~{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 kolekcję zasobów. Użyj komponentu AssetSetAsset, by połączyć zasób z zestawem zasobów.

Pola
id

int64

Identyfikator zestawu zasobów.

resource_name

string

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

customers/{customer_id}/assetSets/{asset_set_id}

AssetSetAsset

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

Pola
resource_name

string

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

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

asset_set

string

Zbiór zasobów, z którym jest połączony ten zasób zestawu zasobów.

asset

string

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

status

AssetSetAssetStatus

Stan zasobu zestawu zasobó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 podobnych zainteresowań, w celu tworzenia list odbiorców reprezentujących sekcje segmentów docelowych.

Pola
resource_name

string

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

customers/{customer_id}/audiences/{audience_id}

id

int64

Identyfikator listy odbiorców.

name

string

Wymagane. Nazwa listy odbiorców. Powinien być niepowtarzalny wśród wszystkich odbiorców. Minimalna długość to 1, a maksymalna – 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ą taką postać:

customers/{customer_id}/biddingStrategies/{bidding_strategy_id}

status

BiddingStrategyStatus

Stan strategii ustalania stawek.

To pole jest tylko do odczytu.

type

BiddingStrategyType

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

To pole jest tylko do odczytu.

currency_code

string

Waluta używana w strategii ustalania stawek (trzyliterowy kod ISO 4217).

W przypadku strategii ustalania stawek na kontach klientów menedżera tę walutę można ustawić podczas tworzenia i domyślnie jest to waluta klienta menedżera. Nie można ustawić tego pola w przypadku klientów, którzy obsługują klientów. wszystkie strategie dotyczące obsługi klienta domyślnie używają waluty klienta obsługującego reklamy. We wszystkich przypadkach poleeffective_currency_code zwraca walutę używaną przez strategię.

id

int64

Identyfikator strategii ustalania stawek.

name

string

Nazwa strategii ustalania stawek. Wszystkie strategie ustalania stawek na koncie muszą mieć różne nazwy.

Długość tego ciągu powinna mieścić się w zakresie od 1 do 255 włącznie i w formacie UTF-8 (przycięty).

effective_currency_code

string

Waluta używana w strategii ustalania stawek (trzyliterowy kod ISO 4217).

W przypadku strategii ustalania stawek na kontach klientów, którzy korzystają z konta menedżera, jest to waluta ustawiona przez reklamodawcę podczas tworzenia strategii. W przypadku klientów jest to wartość 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 ustalania stawek.

Można ustawić tylko jedną opcję. scheme może mieć 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, jeśli prawdopodobieństwo jest mniej prawdopodobne.

maximize_conversion_value

MaximizeConversionValue

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

maximize_conversions

MaximizeConversions

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

target_cpa

TargetCpa

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

target_impression_share

TargetImpressionShare

Strategia ustalania stawek, która automatycznie optymalizuje kampanię pod kątem wybranego odsetka wyświetleń.

target_outrank_share

TargetOutrankShare

Strategia ustalania stawek, która ustala stawki na podstawie docelowego odsetka aukcji, w których reklamodawca powinien przelicytować konkretny konkurent. To pole zostało wycofane. Utworzenie nowej strategii ustalania stawek z tym polem lub dołączenie do kampanii strategii ustalania stawek z tym polem zakończy się niepowodzeniem. Mutacje do strategii, które mają już wypełniony ten schemat, są dozwolone.

target_roas

TargetRoas

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

target_spend

TargetSpend

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

Kampania

Kampania.

Pola
resource_name

string

Nazwa zasobu kampanii. Nazwy zasobów kampanii mają następujący format:

customers/{customer_id}/campaigns/{campaign_id}

status

CampaignStatus

Stan kampanii.

Po dodaniu nowej kampanii jej stan przyjmuje domyślnie stan WŁĄCZONA.

serving_status

CampaignServingStatus

Stan wyświetlania reklam w kampanii.

bidding_strategy_system_status

BiddingStrategySystemStatus

Stan systemu strategii ustalania stawek w kampanii.

ad_serving_optimization_status

AdServingOptimizationStatus

Stan optymalizacji wyświetlania reklam w kampanii.

advertising_channel_type

AdvertisingChannelType

Główny cel wyświetlania reklam w kampanii. Opcje kierowania można doprecyzować w sekcji network_settings.

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

Można go ustawić tylko podczas tworzenia kampanii. Po utworzeniu kampanii nie można zmienić tego pola.

advertising_channel_sub_type

AdvertisingChannelSubType

Opcjonalne doprecyzowanie: 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ń używanych do zastępowania tagów niestandardowych parametrów w elemencie tracking_url_template, final_urls lub mobile_final_urls.

real_time_bidding_setting

RealTimeBiddingSetting

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

network_settings

NetworkSettings

Ustawienia sieci w kampanii.

dynamic_search_ads_setting

DynamicSearchAdsSetting

Ustawienie do kontrolowania dynamicznych reklam w wyszukiwarce (DSA).

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 w celu utworzenia standardowej strategii ustalania stawek lub za pomocą pola bidding_strategy do utworzenia strategii portfolio ustalania stawek.

To pole jest tylko do odczytu.

accessible_bidding_strategy

string

Nazwa zasobu AccessibleOkreślanie stawek, czyli widok tylko do odczytu nieobjętych ograniczeniami atrybutów przypisanej strategii portfolio ustalania stawek zidentyfikowanych przez parametr „bidding_strategy”. Jeśli kampania nie korzysta ze strategii portfolio, pole jest puste. Atrybuty strategii bez ograniczeń są dostępne dla wszystkich klientów, którym udostępniana jest strategia, i są odczytywane z zasobu AccessibleOkreślanie strategii. Atrybuty z ograniczeniami są natomiast dostępne tylko dla klientów będących właścicielami strategii i ich menedżerów. Atrybuty z ograniczeniami można odczytywać tylko z zasobu strategii ustalania stawek.

frequency_caps[]

FrequencyCapEntry

Lista, która ogranicza częstotliwość, z jaką każdy użytkownik będzie widzieć reklamy z tej kampanii.

selective_optimization

SelectiveOptimization

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

optimization_goal_setting

OptimizationGoalSetting

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

tracking_setting

TrackingSetting

Ustawienia śledzenia informacji na poziomie kampanii.

engine_id

string

Identyfikator kampanii na zewnętrznym koncie wyszukiwarki. To pole dotyczy tylko konta innego niż Google Ads, np. Yahoo Japan, Microsoft, Baidu itp. W przypadku podmiotu Google Ads użyj „campaign.id” .

excluded_parent_asset_field_types[]

AssetFieldType

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

create_time

string

Sygnatura czasowa określająca, kiedy kampania została utworzona. Sygnatura czasowa jest podana w strefie czasowej klienta i w formacie „rrrr-MM-dd HH:mm:ss”. . Parametr create_time zostanie wycofany w wersji 1. Zamiast tego użyj parametru create_time.

creation_time

string

Sygnatura czasowa określająca, kiedy kampania została utworzona. Sygnatura czasowa jest podana w strefie czasowej klienta i w formacie „rrrr-MM-dd HH:mm:ss”. .

last_modified_time

string

Data i godzina ostatniej modyfikacji kampanii. Data i godzina są w strefie czasowej klienta i w formacie „rrrr-MM-dd HH:mm:ss.sssss”. .

id

int64

Identyfikator kampanii.

name

string

Nazwa kampanii

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

Nie może zawierać znaków pustych (punkt kodowy 0x0), znaku nowego wiersza (punkt kodowy 0xA) ani znaków przejścia do nowej linii (punkt kodowy 0xD).

tracking_url_template

string

Szablon URL do tworzenia linku monitorującego.

campaign_budget

string

Budżet kampanii.

start_date

string

Data rozpoczęcia wyświetlania kampanii w strefie czasowej klienta w formacie RRRR-MM-DD.

end_date

string

Ostatni dzień kampanii w strefie czasowej klienta w formacie RRRR-MM-DD. Podczas tworzenia przyjmuje on wartość domyślną 2037-12-30, co oznacza, że kampania będzie działać bez końca. Aby ustawić czas trwania istniejącej kampanii na czas nieokreślony, wybierz w tym polu wartość 2037-12-30.

final_url_suffix

string

Sufiks używany do dołączania parametrów zapytania do stron docelowych obsługiwanych przez śledzenie równoległe.

url_expansion_opt_out

bool

Rezygnacja z rozwinięcia adresu URL na bardziej ukierunkowane adresy URL. Jeśli wyłączysz tę opcję (prawda), reklamy będą kierowane tylko na końcowe adresy URL w grupie plików lub adresy URL określone w Google Merchant Center reklamodawcy bądź w plikach firmowych baz danych reklamodawcy. Jeśli zasada (fałsz) jest włączona, reklamy będą kierowane na całą domenę. To pole można skonfigurować tylko w przypadku kampanii Performance Max, które mają wartość domyślną „false”.

Pole sumy campaign_bidding_strategy. Strategia ustalania stawek w kampanii.

Musi to być portfolio (utworzone za pomocą usługi strategii ustalania stawek) lub standardowe, umieszczone w kampanii. campaign_bidding_strategy może mieć tylko jedną z tych wartości:

bidding_strategy

string

Strategia portfolio ustalania stawek używana w kampanii.

manual_cpa

ManualCpa

Standardowa strategia samodzielnego ustawiania stawek CPA. Strategia samodzielnego ustawiania stawek, która pozwala reklamodawcy określać stawkę za działanie określone przez reklamodawcę. To ustawienie jest obsługiwane tylko w kampaniach w Usługach Lokalnych.

manual_cpc

ManualCpc

Standardowa strategia samodzielnego ustalania stawek CPC. Samodzielne określanie stawek na podstawie kliknięć, w ramach którego użytkownik płaci za kliknięcie.

manual_cpm

ManualCpm

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

maximize_conversions

MaximizeConversions

Standardowa strategia ustalania stawek Maksymalizacja liczby konwersji, która automatycznie maksymalizuje liczbę konwersji w ramach określonego budżetu.

maximize_conversion_value

MaximizeConversionValue

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

target_cpa

TargetCpa

Standardowa strategia ustalania stawek Docelowy 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, by osiągnąć wybrany odsetek wyświetleń.

target_roas

TargetRoas

Standardowa strategia ustalania stawek Docelowy ROAS, która automatycznie maksymalizuje przychody przy zachowaniu średniego docelowego zwrotu z nakładów na reklamę (ROAS).

target_spend

TargetSpend

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

percent_cpc

PercentCpc

Standardowa strategia ustalania stawek pod kątem procentu CPC, w której stawki stanowią ułamek reklamowanej ceny danego towaru lub usługi.

target_cpm

TargetCpm

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

DynamicSearchAdsSetting

Ustawienie do kontrolowania dynamicznych reklam w wyszukiwarce (DSA).

Pola
domain_name

string

Wymagane. Nazwa domeny internetowej reprezentowanej 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. „en”.

use_supplied_urls_only

bool

Określa, czy kampania korzysta wyłącznie z adresów URL dostarczonych przez reklamodawcę.

GeoTargetTypeSetting

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

Pola
positive_geo_target_type

PositiveGeoTargetType

Ustawienie stosowane do niewykluczającego 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 w kampanii.

Pola
target_search_network

bool

Określa, czy reklamy będą wyświetlane w witrynach partnerów w sieci wyszukiwania Google (wymaga też ustawienia target_google_search jako true).

target_content_network

bool

Określa, czy reklamy będą wyświetlane w określonych miejscach docelowych w sieci reklamowej Google. Miejsca docelowe określa się za pomocą kryterium Miejsce docelowe.

target_partner_search_network

bool

Określa, czy reklamy będą wyświetlane w sieci partnerskiej Google. Ta funkcja jest dostępna tylko na niektórych wybranych kontach partnerów Google.

OptimizationGoalSetting

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

Pola
optimization_goal_types[]

OptimizationGoalType

Lista typów celów optymalizacji.

SelectiveOptimization

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

Pola
conversion_actions[]

string

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

ShoppingSetting

Ustawienie dla kampanii produktowych. Określa szeroką gamę produktów, które można reklamować w ramach kampanii, oraz sposób interakcji tej kampanii z innymi kampaniami produktowymi.

Pola
feed_label

string

Etykieta pliku danych z produktami, które mają zostać uwzględnione w kampanii. Można ustawić tylko jedną wartość parametru Feed_label lub sales_country. Jeśli jest używany zamiast atrybutu sales_country, pole pliku danych etykiety akceptuje kody krajów w tym samym formacie, np. „XX”. W innym przypadku może to być dowolny ciąg znaków używany jako etykieta pliku danych w Google Merchant Center.

use_vehicle_inventory

bool

Określa, czy kierować reklamy na zasoby reklamowe z informacjami o pojazdach.

merchant_id

int64

Identyfikator konta Merchant Center. To pole jest wymagane przy tworzeniu operacji tworzenia. Tego pola nie można zmienić w przypadku kampanii produktowych.

sales_country

string

Kraj sprzedaży produktów, które mają być uwzględnione w kampanii.

campaign_priority

int32

Priorytet kampanii. Kampanie z numerycznie wyższym priorytetem mają pierwszeństwo przed kampaniami o niższych priorytetach. To pole jest wymagane w przypadku kampanii produktowych z wartościami od 0 do 2 włącznie. To pole jest opcjonalne w przypadku inteligentnych kampanii produktowych, ale jeśli jest skonfigurowane, musi zawierać 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 kampanii i zasobu.

Pola
resource_name

string

Nazwa zasobu komponentu kampanii. Nazwy zasobów CampaignAsset mają następujący format:

customers/{customer_id}/campaignAssets/{campaign_id}~{asset_id}~{field_type}

status

AssetLinkStatus

Stan komponentu kampanii.

campaign

string

Kampania, z którą połączony jest komponent.

asset

string

Komponent powiązany z kampanią.

Zestaw komponentów kampanii

CampaignAssetSet łączy kampanię z zestawem komponentów. Dodanie elementu CampaignAssetSet łączy zestaw komponentów z kampanią.

Pola
resource_name

string

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

customers/{customer_id}/campaignAssetSets/{campaign_id}~{asset_set_id}

campaign

string

Kampania, z którą połączony jest ten zestaw komponentów.

asset_set

string

Zbiór komponentów powiązany z kampanią.

status

AssetSetLinkStatus

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

CampaignAudienceView

Widok odbiorców kampanii. Zawiera dane o skuteczności oparte na zainteresowaniach i listach remarketingowych dla reklam w sieci reklamowej i w YouTube oraz z list remarketingowych dla reklam w wyszukiwarce (RLSA) zebrane według kryteriów kampanii i odbiorców. Ten widok obejmuje tylko listy odbiorców dołączone na poziomie kampanii.

Pola
resource_name

string

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

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

CampaignBudget

Budżet kampanii.

Pola
resource_name

string

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

customers/{customer_id}/campaignBudgets/{campaign_budget_id}

delivery_method

BudgetDeliveryMethod

Metoda wyświetlania określająca częstotliwość wydawania budżetu kampanii.

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

period

BudgetPeriod

Okres, w którym budżet ma zostać wykorzystany. Jeśli nie zostanie określona, domyślna wartość to DAILY.

amount_micros

int64

Kwota budżetu w walucie lokalnej konta. Kwota jest podawana w mikro, gdzie milion odpowiada jednej jednostce waluty. Miesięczne wydatki są ograniczone do 30,4 raza tej kwoty.

CampaignCriterion

Kryterium kampanii.

Pola
resource_name

string

Nazwa zasobu kryterium kampanii. Nazwy zasobów kryterium kampanii mają taką 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

Typ kryterium.

status

CampaignCriterionStatus

Stan kryterium.

last_modified_time

string

Data i godzina ostatniej modyfikacji tego kryterium kampanii. Data i godzina są w strefie czasowej klienta i w formacie „rrrr-MM-dd HH:mm:ss.sssss”. .

criterion_id

int64

Identyfikator kryterium.

To pole jest ignorowane podczas mutacji.

bid_modifier

float

Modyfikator stawek w przypadku dopasowania do kryterium. Modyfikator musi należeć do zakresu od 0,1 do 10,0. Większość typów kryteriów kierowania reklam obsługuje modyfikatory. Aby zrezygnować z urządzeń danego typu, wpisz 0.

negative

bool

Określa, czy kryterium ma być celem (false) czy też wykluczone (true).

Pole sumy criterion. Kryterium kampanii.

Musisz ustawić tylko jedną opcję. criterion może mieć tylko jedną z tych wartości:

keyword

KeywordInfo

Słowo kluczowe.

location

LocationInfo

Lokalizacja.

device

DeviceInfo

Urządzenie.

age_range

AgeRangeInfo

Przedział wiekowy.

gender

GenderInfo

Płeć.

user_list

UserListInfo

Lista użytkowników.

language

LanguageInfo

Język.

webpage

WebpageInfo

Strona internetowa.

location_group

LocationGroupInfo

Grupa lokalizacji

CampaignLabel

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

Pola
resource_name

string

Nazwa zasobu. Nazwy zasobów etykiet kampanii mają następujący format: customers/{customer_id}/campaignLabels/{campaign_id}~{label_id}

campaign

string

Kampania, do której dołączona jest etykieta.

label

string

Etykieta przypisana do kampanii.

CartDataSalesView

Widok sprzedaży danych koszyka.

Pola
resource_name

string

Nazwa zasobu widoku danych sprzedaży danych koszyka. Nazwy zasobów widoku danych sprzedaży danych koszyka mają format: 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 jest nieprzypisane.

merchant_id

int64

Identyfikator konta asortymentu Search Ads 360 zawierającego kliknięty produkt. Search Ads 360 generuje ten identyfikator po połączeniu w tej usłudze konta asortymentowego.

ad_id

int64

Identyfikator reklamy. Wartość 0 oznacza, że reklama jest nieprzypisana.

click_id

string

Unikalny ciąg znaków używany w przypadku wizyty, do której przypisana jest konwersja, przekazywany na stronę docelową jako parametr adresu URL identyfikatora kliknięcia.

visit_id

int64

Identyfikator wizyty w Search Ads 360, do którego przypisana jest konwersja.

advertiser_conversion_id

string

W przypadku konwersji offline jest to identyfikator podawany przez reklamodawców. Jeśli reklamodawca nie określi takiego identyfikatora, Search Ads 360 go wygeneruje. W przypadku konwersji online ta wartość jest równa kolumnie identyfikatora lub kolumnie floodlight_order_id w zależności od instrukcji Floodlight reklamodawcy.

product_id

string

Identyfikator klikniętego produktu.

product_channel

ProductChannel

Kanał sprzedaży klikniętego produktu: online lub lokalnie.

product_language_code

string

Język (ISO-639-1) ustawiony w pliku danych Merchant Center zawierającym dane o produkcie.

product_store_id

string

Sklep w reklamie lokalnego asortymentu produktów, który został kliknięty. Te informacje powinny być zgodne z identyfikatorami sklepów użytymi w pliku danych o produktach dostępnych lokalnie.

product_country_code

string

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

attribution_type

AttributionType

Do czego jest przypisana 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 została przypisana konwersja.

conversion_quantity

int64

Liczba produktów zarejestrowanych w konwersji, określona przez parametr qty url. Reklamodawca jest odpowiedzialny za dynamiczne wprowadzanie parametru (np. liczby produktów sprzedanych w ramach konwersji). W przeciwnym razie domyślna wartość to 1.

conversion_revenue_micros

int64

Skorygowane przychody w mikrosekundach ze zdarzenia konwersji. Zawsze będzie ona w walucie konta wyświetlającego reklamy.

floodlight_original_revenue

int64

Pierwotne, niezmienione przychody powiązane ze zdarzeniem Floodlight (w walucie bieżącego raportu) sprzed modyfikacji instrukcji dotyczących 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 komponentu zdarzenia konwersji.

ConversionAction

Działanie powodujące konwersję.

Pola
resource_name

string

Nazwa zasobu działania powodującego konwersję. Nazwy zasobów działań powodujących konwersję mają następujący format:

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 raportowanych 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 wartość parametru main_for_goal działania powodującego konwersję ma wartość false (fałsz), nie można określać stawki za działanie powodujące konwersję we wszystkich kampaniach, niezależnie od celu konwersji klienta lub kampanii. Niestandardowe cele konwersji nie uwzględniają jednak wartości main_for_goal, więc jeśli kampania ma niestandardowy cel konwersji skonfigurowany z wartością main_for_goal = false (fałsz), to działanie powodujące konwersję nadal będzie objęte ustalaniem stawek. Jeśli nie zostanie ustawiony, domyślna wartość parametru main_for_goal ma wartość true (prawda). W wersji 9 parametr main_for_goal może mieć wartość false tylko po utworzeniu za pomocą „aktualizacji” , ponieważ nie jest zadeklarowana jako opcjonalna.

owner_customer

string

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

include_in_client_account_conversions_metric

bool

Określa, czy to działanie powodujące konwersję powinno zostać uwzględnione w kolumnie „client_account_conversions” danych.

include_in_conversions_metric

bool

Określa, czy to działanie powodujące konwersję powinno zostać uwzględnione w kolumnie „Konwersje” danych.

click_through_lookback_window_days

int64

Maksymalna liczba dni, które mogą upływać między interakcją (np. kliknięciem) a zdarzeniem konwersji.

app_id

string

Identyfikator aplikacji dla działania powodującego konwersję z aplikacji.

AttributionModelSettings

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

Pola
attribution_model

AttributionModel

Typ modelu atrybucji dla tego działania powodującego konwersję.

data_driven_model_status

DataDrivenModelStatus

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

FloodlightSettings

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

Pola
activity_group_tag

string

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

activity_tag

string

Ciąg tekstowy służący do rozpoznawania 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ść używana, gdy zdarzenia konwersji dla tego działania powodującego konwersję są wysyłane z nieprawidłową, niedozwoloną lub brakującą wartością albo gdy to działanie powodujące konwersję jest skonfigurowane tak, aby zawsze używało wartości domyślnej.

default_currency_code

string

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

always_use_default_value

bool

Określa, czy zamiast kodu wartości i kodu waluty określone w zdarzeniach konwersji dla tego działania powodującego konwersję mają być używane wartość domyślna i kod waluty domyślnej.

ConversionCustomVariable

Zmienna niestandardowa konwersji. Przeczytaj artykuł „Informacje o niestandardowych danych i wymiarach Floodlight w nowej wersji Search Ads 360” na stronie https://support.google.com/sa360/answer/13567857.

Pola
resource_name

string

Nazwa zasobu zmiennej niestandardowej konwersji. Nazwy zasobów zmiennych niestandardowych 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 ani po nim nie może być żadnych dodatkowych spacji.

tag

string

Wymagane. Tag niestandardowej zmiennej konwersji. Tag powinien być niepowtarzalny i zawierać literę „u” bezpośrednio po którym następuje liczba mniejsza niż ormrówna 100. Na przykład: „u4”.

status

ConversionCustomVariableStatus

Stan niestandardowej zmiennej niestandardowej konwersji na potrzeby naliczania zdarzeń konwersji.

owner_customer

string

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

family

ConversionCustomVariableFamily

Rodzina zmiennej niestandardowej konwersji.

cardinality

ConversionCustomVariableCardinality

Moc zbioru niestandardowej zmiennej konwersji.

floodlight_conversion_custom_variable_info

FloodlightConversionCustomVariableInfo

Pola zmiennych niestandardowych konwersji Floodlight w Search Ads 360.

custom_column_ids[]

int64

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

FloodlightConversionCustomVariableInfo

Informacje o zmiennych niestandardowych konwersji Floodlight w Search Ads 360.

Pola
floodlight_variable_type

FloodlightVariableType

Typ zmiennej Floodlight określony w Search Ads 360.

floodlight_variable_data_type

FloodlightVariableDataType

Typ danych zmiennej Floodlight zdefiniowany w Search Ads 360.

ConversionTrackingSetting

Zbiór ustawień dla całego klienta związanych ze śledzeniem konwersji w Search Ads 360.

Pola
accepted_customer_data_terms

bool

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

conversion_tracking_status

ConversionTrackingStatus

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

enhanced_conversions_for_leads_enabled

bool

Określa, czy klient wyraził zgodę na konwersje rozszerzone dotyczące potencjalnych klientów. Jeśli stosujesz śledzenie 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 są tworzone konwersje i zarządzanie nimi. To pole jest tylko do odczytu.

conversion_tracking_id

int64

Identyfikator śledzenia konwersji używany w przypadku tego konta. Ten identyfikator nie wskazuje, czy klient korzysta ze śledzenia konwersji (conversion_tracking_status). To pole jest tylko do odczytu.

google_ads_cross_account_conversion_tracking_id

int64

Identyfikator śledzenia konwersji menedżera klienta. Jest ona ustawiana, gdy klient ma włączone śledzenie konwersji. Zastępuje parametr conversion_tracking_id. Tym polem można zarządzać tylko w interfejsie Google Ads. To pole jest tylko do odczytu.

cross_account_conversion_tracking_id

int64

Identyfikator śledzenia konwersji menedżera klienta. Jest ona ustawiana, gdy klient ma włączone śledzenie konwersji dla wielu kont. 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 wynikowej 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 zapytaniach w 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ływał się do kolumn systemowych {"metrics.clicks", "metrics.impressions"}.

Klient

Klienta.

Pola
resource_name

string

Nazwa zasobu klienta. Nazwy zasobów klientów mają następujący format:

customers/{customer_id}

conversion_tracking_setting

ConversionTrackingSetting

Ustawienie śledzenia konwersji dla klienta.

account_type

AccountType

rodzaj konta wyszukiwarki, np. Google Ads, Microsoft Advertising, Yahoo Japan, Baidu, Facebook, śledzenie wyszukiwarki itp.

double_click_campaign_manager_setting

DoubleClickCampaignManagerSetting

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

account_status

AccountStatus

Stan konta, np. włączone, wstrzymane, usunięte itp.

last_modified_time

string

Data i godzina ostatniej modyfikacji danych klienta. Data i godzina są w strefie czasowej klienta i w formacie „rrrr-MM-dd HH:mm:ss.sssss”. .

engine_id

string

Identyfikator konta na zewnętrznym koncie wyszukiwarki.

status

CustomerStatus

Stan klienta.

creation_time

string

Sygnatura czasowa określająca, kiedy ten klient został utworzony. Sygnatura czasowa jest podana w strefie czasowej klienta i w formacie „rrrr-MM-dd HH:mm:ss”. .

id

int64

Identyfikator klienta.

descriptive_name

string

Opcjonalna, nieunikalna opisowa nazwa klienta.

currency_code

string

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

time_zone

string

Identyfikator lokalnej strefy czasowej klienta.

tracking_url_template

string

Szablon URL 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

Związek między klientem a komponentem.

Pola
resource_name

string

Nazwa zasobu komponentu klienta. Nazwy zasobów CustomerAsset mają następujący format:

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

asset

string

Wymagane. Zasób, który jest połączony z klientem.

status

AssetLinkStatus

Stan komponentu klienta.

CustomerAssetSet

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

Pola
resource_name

string

Nazwa zasobu zbioru zasobów klienta. Nazwy zasobów w zestawie zasobów mają taką postać:

customers/{customer_id}/customerAssetSets/{asset_set_id}

asset_set

string

Zbiór zasobów powiązany z klientem.

customer

string

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

status

AssetSetLinkStatus

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

CustomerClient

Połączenie między danym klientem i klientem. Klient CustomerClient występuje tylko w przypadku klientów menedżera. Uwzględniasz 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ą format: customers/{customer_id}/customerClients/{client_customer_id}

applied_labels[]

string

Nazwy zasobów etykiet należących do klienta wysyłającego żądanie, które zostały zastosowane do klienta. Nazwy zasobów etykiet mają format:

customers/{customer_id}/labels/{label_id}

status

CustomerStatus

Stan klienta klienta. Tylko do odczytu.

client_customer

string

Nazwa zasobu klient-klient, który jest powiązany z danym klientem. Tylko do odczytu.

hidden

bool

Określa, czy to konto jest ukryte.

Tylko do odczytu.

level

int64

Odstęp między danym klientem a klientem. W przypadku połączenia własnego wartość poziomu będzie wynosić 0. Tylko do odczytu.

time_zone

string

Reprezentacja strefy czasowej klienta w ciągu CLDR (Common Locale Data Repositories), na przykład America/Los_Angeles. Tylko do odczytu.

test_account

bool

Określa, czy klient jest kontem testowym. Tylko do odczytu.

manager

bool

Określa, czy klient jest menedżerem. Tylko do odczytu.

descriptive_name

string

Opisowa nazwa klienta. Tylko do odczytu.

currency_code

string

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

id

int64

Identyfikator klienta. Tylko do odczytu.

DoubleClickCampaignManagerSetting

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

Pola
advertiser_id

int64

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

network_id

int64

Identyfikator sieci Campaign Managera powiązanej z tym klientem.

time_zone

string

Strefa czasowa sieci Campaign Managera powiązanej z tym klientem w formacie bazy danych strefy czasowej IANA, np. Ameryka/Nowy_Jork.

DynamicSearchAdsSearchTermView

Widok wyszukiwanych haseł w dynamicznych reklamach w wyszukiwarce

Pola
resource_name

string

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

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

landing_page

string

Dynamicznie wybrany adres URL strony docelowej wyświetlenia.

To pole jest tylko do odczytu.

GenderView

Płeć. Zasób gender_view odzwierciedla efektywny stan udostępniania, 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 widoku gender_view ze statystykami.

Pola
resource_name

string

Nazwa zasobu widoku płci. Nazwy zasobów w widoku płci mają następujący format:

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

GeoTargetConstant

Stała kierowania geograficznego.

Pola
resource_name

string

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

geoTargetConstants/{geo_target_constant_id}

status

GeoTargetConstantStatus

Stały stan kierowania geograficznego.

id

int64

Identyfikator stałej kierowania geograficznego.

name

string

Stała angielska nazwa kierowania geograficznego.

country_code

string

Kod kraju zgodny ze standardem ISO-3166-1 alfa-2, który jest powiązany z celem.

target_type

string

Typ stałego kierowania geograficznego.

canonical_name

string

Pełna i jednoznaczna nazwa angielska składająca się z nazwy celu, nazwy jednostki nadrzędnej oraz kraju.

parent_geo_target

string

Nazwa zasobu nadrzędnej stałej kierowania geograficznego. Nazwy stałych zasobów kierowania geograficznego mają postać:

geoTargetConstants/{parent_geo_target_constant_id}

KeywordView

Widok słów kluczowych.

Pola
resource_name

string

Nazwa zasobu widoku słów kluczowych. Nazwy zasobów widoku słów kluczowych mają postać:

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

Etykieta

Etykieta.

Pola
resource_name

string

Nazwa zasobu. Nazwy zasobów etykiet mają format: customers/{customer_id}/labels/{label_id}

status

LabelStatus

Stan etykiety. Tylko do odczytu.

text_label

TextLabel

Typ etykiety wyświetlającej tekst na kolorowym tle.

id

int64

Identyfikator etykiety. Tylko do odczytu.

name

string

Nazwa etykiety.

To pole jest wymagane i nie powinno być puste podczas tworzenia nowej etykiety.

Długość tego ciągu powinna wynosić od 1 do 80 włącznie.

LanguageConstant

Język.

Pola
resource_name

string

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

languageConstants/{criterion_id}

id

int64

Identyfikator stałej języka.

code

string

Kod języka, np. „pl_PL”, „en_AU”, „es”, „fr” itd.

name

string

Pełna nazwa języka w języku angielskim, np. „English (US)”, „hiszpański” itp.

targetable

bool

Określa, czy język, na który można kierować reklamy, jest dostępny.

ListingGroupFilterDimension

Wymiary informacji o produktach stosowane do filtra grupy informacji o produktach w grupie plików.

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

ProductBiddingCategory

Kategoria ustalania stawek w ofercie produktu.

product_brand

ProductBrand

Marka oferty produktu.

product_channel

ProductChannel

Lokalizacja oferty produktu.

product_condition

ProductCondition

Stan oferty produktu.

product_custom_attribute

ProductCustomAttribute

Atrybut niestandardowy oferty produktu.

product_item_id

ProductItemId

Identyfikator produktu w ofercie.

product_type

ProductType

Typ oferty produktu.

ProductBiddingCategory

Jeden element kategorii ustalania stawek na określonym poziomie. Kategorie najwyższego poziomu są na poziomie 1, dla dzieci na poziomie 2 itd. Obecnie obsługujemy maksymalnie 5 poziomów. Użytkownik musi określić typ wymiaru, 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 ustalania stawek produktu.

Ten identyfikator jest odpowiednikiem identyfikatora google_product_category [kategoria_produktów_google], jak opisano w tym artykule: https://support.google.com/merchants/answer/6324436.

ProductBrand

Marka produktu.

Pola
value

string

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

ProductChannel

Lokalizacja oferty produktu.

Pola
channel

ListingGroupFilterProductChannel

Zalety miejscowości.

ProductCondition

Stan oferty produktu.

Pola
condition

ListingGroupFilterProductCondition

Wartość warunku.

ProductCustomAttribute

Atrybut niestandardowy oferty produktu.

Pola
index

ListingGroupFilterCustomAttributeIndex

Wskazuje indeks atrybutu niestandardowego.

value

string

Wartość ciągu 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 określonych przez hierarchię filtra grup informacji o produktach (bez węzła głównego) do tego filtra grup informacji o produktach.

LocationView

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

Pola
resource_name

string

Nazwa zasobu widoku lokalizacji. Nazwy zasobów widoku lokalizacji mają następujący format:

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

ProductBiddingCategoryConstant

Kategoria określania stawek produktu.

Pola
resource_name

string

Nazwa zasobu kategorii określania stawek za produkt. Nazwy zasobów kategorii ustalania stawek według produktu mają następujący format:

productBiddingCategoryConstants/{country_code}~{level}~{id}

level

ProductBiddingCategoryLevel

Poziom kategorii określania stawek za produkt.

status

ProductBiddingCategoryStatus

Stan kategorii określania stawek produktu.

id

int64

Identyfikator kategorii ustalania stawek produktu.

Ten identyfikator jest odpowiednikiem identyfikatora google_product_category [kategoria_produktów_google], jak opisano w tym artykule: https://support.google.com/merchants/answer/6324436.

country_code

string

Dwuliterowy kod kraju kategorii określania stawek według produktów, pisany wielkimi literami.

product_bidding_category_constant_parent

string

Nazwa zasobu z nadrzędnej kategorii określania stawek produktu.

language_code

string

Kod języka kategorii ustalania stawek produktu.

localized_name

string

Wyświetla wartość kategorii ustalania stawek produktu zlokalizowaną według atrybutu language_code.

ProductGroupView

Widok grupy produktów.

Pola
resource_name

string

Nazwa zasobu w widoku grupy produktów. Nazwy zasobów widoku grupy produktów mają taką postać:

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

SearchAds360Field

Pole lub zasób (artefakt) używane przez usługę SearchAds360Service.

Pola
resource_name

string

Nazwa zasobu artefaktu. Nazwy zasobów artefaktów mają następujący format:

SearchAds360Fields/{name}

category

SearchAds360FieldCategory

Kategoria artefaktu.

selectable_with[]

string

Nazwy wszystkich zasobów, segmentów i danych, które można wybrać za pomocą opisanego artefaktu.

attribute_resources[]

string

Nazwy wszystkich zasobów, które można wybrać za pomocą opisanego artefaktu. Pola z tych zasobów nie segmentują danych, gdy są uwzględnione w zapytaniach.

To pole jest ustawione tylko dla artefaktów, których kategoria to RESOURCE.

metrics[]

string

To pole zawiera nazwy wszystkich danych, które można wybrać za pomocą opisanego artefaktu, gdy jest on używany w klauzuli FROM. Jest ustawiony tylko dla artefaktów, których kategoria to RESOURCE.

segments[]

string

To pole zawiera nazwy wszystkich artefaktów – segmentów i innych zasobów – tych, które segmentują dane, gdy są uwzględniane w zapytaniach i gdy opisywany artefakt jest używany w klauzuli FROM. Jest ustawiony tylko dla artefaktów, których kategoria to RESOURCE.

enum_values[]

string

Wartości, które artefakt może przyjąć, jeśli jest to pole typu ENUM.

To pole jest 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 artefaktu można używać w klauzuli SELECT w zapytaniach.

filterable

bool

Określa, czy artefaktu można używać w klauzuli WHERE w zapytaniach.

sortable

bool

Określa, czy artefaktu można używać w klauzuli ORDER BY w zapytaniach.

type_url

string

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

is_repeated

bool

Określa, czy artefakt pola się powtarza.

ShoppingPerformanceView

Widok skuteczności w Zakupach Google. Przedstawia statystyki kampanii produktowych zebrane na kilku poziomach wymiarów produktów. Wartości wymiarów produktu z Merchant Center, takie jak marka, kategoria, atrybuty niestandardowe, stan produktu i typ produktu, będą odzwierciedlać stan każdego wymiaru w momencie zarejestrowania danego zdarzenia.

Pola
resource_name

string

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

UserList

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

Pola
resource_name

string

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

customers/{customer_id}/userLists/{user_list_id}

type

UserListType

Typ tej listy.

To pole jest tylko do odczytu.

id

int64

Identyfikator listy użytkowników.

name

string

Nazwa tej listy użytkowników. W zależności od parametru access_reason nazwa listy użytkowników może nie być niepowtarzalna (np. jeśli access_reason=SHARED).

Odwiedź

Wizyta.

Pola
resource_name

string

Nazwa zasobu wizyty. Nazwy zasobów wizyt mają następujący format:

customers/{customer_id}/visits/{ad_group_id}~{criterion_id}~{ds_visit_id}

id

int64

Identyfikator wizyty.

criterion_id

int64

Identyfikator słowa kluczowego w Search Ads 360. Wartość 0 oznacza, że słowo kluczowe jest nieprzypisane.

merchant_id

int64

Identyfikator konta asortymentu Search Ads 360 zawierającego kliknięty produkt. Search Ads 360 generuje ten identyfikator po połączeniu konta asortymentu w Search Ads 360.

ad_id

int64

Identyfikator reklamy. Wartość 0 oznacza, że reklama jest nieprzypisana.

click_id

string

Unikalny ciąg znaków przy każdej wizycie przekazywany na stronę docelową jako parametr adresu URL identyfikatora kliknięcia.

visit_date_time

string

Sygnatura czasowa zdarzenia wizyty. Sygnatura czasowa jest podana w strefie czasowej klienta i w formacie „rrrr-MM-dd HH:mm:ss”. .

product_id

string

Identyfikator klikniętego produktu.

product_channel

ProductChannel

Kanał sprzedaży klikniętego produktu: online lub lokalnie.

product_language_code

string

Język (ISO-639-1) ustawiony w pliku danych Merchant Center zawierającym dane o produkcie.

product_store_id

string

Sklep w reklamie lokalnego asortymentu produktów, który został kliknięty. Te informacje powinny być zgodne z identyfikatorami sklepów użytymi w pliku danych o produktach dostępnych lokalnie.

product_country_code

string

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

asset_id

int64

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

asset_field_type

AssetFieldType

Typ pola zasobu zdarzenia wizyty.

WebpageView

Widok strony internetowej.

Pola
resource_name

string

Nazwa zasobu widoku strony internetowej. Nazwy zasobów wyświetlenia strony internetowej mają następujący format:

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