- Zapis JSON
- AdGroup
- AdGroupStatus
- AdGroupType
- AdGroupAdRotationMode
- AdGroupEngineStatus
- TargetingSetting
- TargetRestriction:
- TargetingDimension
- AdGroupAd
- AdGroupAdStatus
- Reklama
- AdType
- SearchAds360TextAdInfo
- SearchAds360ExpandedTextAdInfo
- SearchAds360ResponsiveSearchAdInfo
- SearchAds360ProductAdInfo
- SearchAds360ExpandedDynamicSearchAdInfo
- AdGroupAdEngineStatus
- AdGroupAdLabel
- AdGroupAsset
- AssetLinkStatus
- AdGroupAssetSet
- AssetSetLinkStatus
- AdGroupAudienceView
- AdGroupBidModifier
- DeviceInfo
- Urządzenie
- AdGroupCriterion
- AdGroupCriterionStatus
- QualityInfo
- CriterionType
- PositionEstimates
- AdGroupCriterionEngineStatus
- KeywordInfo
- KeywordMatchType
- ListingGroupInfo
- ListingGroupType
- AgeRangeInfo
- AgeRangeType
- GenderInfo
- GenderType
- UserListInfo
- WebpageInfo
- WebpageConditionInfo
- WebpageConditionOperand
- WebpageConditionOperator
- LocationInfo
- AdGroupCriterionLabel
- AdGroupLabel
- AgeRangeView:
- Zasób
- AssetType
- AssetStatus
- AssetEngineStatus
- YoutubeVideoAsset
- ImageAsset
- MimeType
- ImageDimension
- TextAsset
- UnifiedCalloutAsset:
- AdScheduleInfo
- MinuteOfHour
- DayOfWeek
- UnifiedSitelinkAsset
- UnifiedPageFeedAsset
- MobileAppAsset
- MobileAppVendor
- UnifiedCallAsset
- CallConversionReportingState
- CallToActionAsset
- CallToActionType
- UnifiedLocationAsset
- BusinessProfileLocation (lokalizacja profilu firmy)
- LocationOwnershipType
- AssetGroupAsset
- AssetFieldType
- AssetGroupSignal
- AudienceInfo
- AssetGroupListingGroupFilter
- ListingGroupFilterType
- ListingGroupFilterVertical
- ListingGroupFilterDimension
- ProductBiddingCategory
- ListingGroupFilterBiddingCategoryLevel
- ProductBrand
- ProductChannel
- ListingGroupFilterProductChannel
- ProductCondition
- ListingGroupFilterProductCondition
- ProductCustomAttribute
- ListingGroupFilterCustomAttributeIndex
- ProductItemId
- ProductType
- ListingGroupFilterProductTypeLevel
- ListingGroupFilterDimensionPath:
- AssetGroupTopCombinationView
- AssetGroupAssetCombinationData
- AssetUsage
- ServedAssetFieldType
- AssetGroup
- AssetGroupStatus
- AdStrength
- AssetSetAsset
- AssetSetAssetStatus
- AssetSet
- BiddingStrategy
- BiddingStrategyStatus
- BiddingStrategyType
- EnhancedCpc
- MaximizeConversionValue
- MaximizeConversions
- TargetCpa
- TargetImpressionShare
- TargetImpressionShareLocation
- TargetOutrankShare
- TargetRoas
- TargetSpend
- CampaignBudget
- BudgetDeliveryMethod
- BudgetPeriod
- Kampania
- CampaignStatus
- CampaignServingStatus
- BiddingStrategySystemStatus
- AdServingOptimizationStatus
- AdvertisingChannelType
- AdvertisingChannelSubType
- CustomParameter
- RealTimeBiddingSetting (Ustawienia określania stawek w czasie rzeczywistym)
- NetworkSettings
- DynamicSearchAdsSetting
- ShoppingSetting
- GeoTargetTypeSetting
- PositiveGeoTargetType
- NegativeGeoTargetType
- FrequencyCapEntry
- SelectiveOptimization,
- OptimizationGoalSetting
- OptimizationGoalType
- TrackingSetting
- ManualCpa
- ManualCpc:
- ManualCpm
- PercentCpc
- TargetCpm
- CampaignAsset
- CampaignAssetSet
- CampaignAudienceView
- CampaignCriterion
- CampaignCriterionStatus
- LanguageInfo
- LocationGroupInfo
- LocationGroupRadiusUnits
- CampaignLabel
- CartDataSalesView
- Odbiorcy
- ConversionAction
- ConversionActionStatus
- ConversionActionType
- ConversionActionCategory
- ValueSettings
- AttributionModelSettings
- AttributionModel
- DataDrivenModelStatus
- FloodlightSettings
- ConversionCustomVariable
- ConversionCustomVariableStatus
- ConversionCustomVariableFamily
- ConversionCustomVariableCardinality
- FloodlightConversionCustomVariableInfo
- FloodlightVariableType
- FloodlightVariableDataType
- Klient
- ConversionTrackingSetting
- ConversionTrackingStatus
- AccountType
- DoubleClickCampaignManagerSetting
- AccountStatus
- CustomerStatus
- CustomerAsset
- CustomerAssetSet
- AccessibleBiddingStrategy
- MaximizeConversionValue
- MaximizeConversions
- TargetCpa
- TargetImpressionShare
- TargetRoas
- TargetSpend
- CustomerManagerLink
- ManagerLinkStatus
- CustomerClient
- DynamicSearchAdsSearchTermView
- GenderView
- GeoTargetConstant
- GeoTargetConstantStatus
- KeywordView
- Etykieta
- LabelStatus
- TextLabel
- LanguageConstant
- LocationView
- ProductBiddingCategoryConstant
- ProductBiddingCategoryLevel
- ProductBiddingCategoryStatus
- ProductGroupView
- ShoppingPerformanceView
- UserList:
- UserListType
- WebpageView
- Otwórz stronę
- ProductChannel
- Konwersja
- AttributionType
- ConversionStatus
- Wskaźniki
- Wartość
- QualityScoreBucket
- InteractionEventType
- Segmenty
- AdNetworkType
- Słowo kluczowe
- ProductChannelExclusivity
- ProductCondition
- AssetInteractionTarget
Wiersz zwrócony z zapytania.
Zapis JSON |
---|
{ "adGroup": { object ( |
Pola | |
---|---|
adGroup |
Grupa reklam, do której odwołuje się zapytanie. |
adGroupAd |
Reklama, do której odwołuje się zapytanie. |
adGroupAdLabel |
Etykieta grupy reklam, do której odwołuje się zapytanie. |
adGroupAsset |
Komponent z grupą reklam, do którego odwołuje się zapytanie. |
adGroupAssetSet |
Zestaw komponentów grupy reklam, do którego odwołuje się zapytanie. |
adGroupAudienceView |
Widok listy odbiorców grupy reklam, do którego odwołuje się zapytanie. |
adGroupBidModifier |
Modyfikator stawek, do którego odwołuje się zapytanie. |
adGroupCriterion |
Kryterium, do którego odwołuje się zapytanie. |
adGroupCriterionLabel |
Etykieta kryterium grupy reklam, do której odwołuje się zapytanie. |
adGroupLabel |
Etykieta grupy reklam, do której odwołuje się zapytanie. |
ageRangeView |
Widok przedziału wiekowego, do którego odwołuje się zapytanie. |
asset |
Zasób, do którego odwołuje się zapytanie. |
assetGroupAsset |
Zasób grupy plików, do którego odwołuje się zapytanie. |
assetGroupSignal |
Sygnał grupy plików, do którego odwołuje się zapytanie. |
assetGroupListingGroupFilter |
Filtr grupy informacji o produktach w grupie plików, do którego odwołuje się zapytanie. |
assetGroupTopCombinationView |
Widok najpopularniejszej kombinacji grupy plików, do której odwołuje się zapytanie. |
assetGroup |
Grupa plików, do której odwołuje się zapytanie. |
assetSetAsset |
Zasób zestawu zasobów, do którego odwołuje się zapytanie. |
assetSet |
Zbiór zasobów, do którego odwołuje się zapytanie. |
biddingStrategy |
Strategia ustalania stawek, do której odwołuje się zapytanie. |
campaignBudget |
Budżet kampanii, do którego odwołuje się zapytanie. |
campaign |
Kampania, do której odwołuje się zapytanie. |
campaignAsset |
Komponent kampanii, do którego odwołuje się zapytanie. |
campaignAssetSet |
Zestaw komponentów kampanii, do którego odwołuje się zapytanie. |
campaignAudienceView |
Widok odbiorców na poziomie kampanii, do którego odwołuje się zapytanie. |
campaignCriterion |
Kryterium kampanii, do którego odwołuje się zapytanie. |
campaignLabel |
Etykieta kampanii, do której odwołuje się zapytanie. |
cartDataSalesView |
Widok sprzedaży danych koszyka, do którego odwołuje się zapytanie. |
audience |
Lista odbiorców wymieniona w zapytaniu. |
conversionAction |
Działanie powodujące konwersję, do którego odwołuje się zapytanie. |
conversionCustomVariable |
Niestandardowa zmienna konwersji, do której odwołuje się zapytanie. |
customer |
Klient wskazany w zapytaniu. |
customerAsset |
Komponent klienta, do którego odwołuje się zapytanie. |
customerAssetSet |
Zestaw komponentów klienta, do którego odwołuje się zapytanie. |
accessibleBiddingStrategy |
Dostępna strategia ustalania stawek, do której odwołuje się zapytanie. |
customerManagerLink |
Link CustomerManagerLink, do którego odwołuje się zapytanie. |
customerClient |
Klient CustomerClient, do którego odwołuje się zapytanie. |
dynamicSearchAdsSearchTermView |
Widok wyszukiwanych haseł w dynamicznych reklamach w wyszukiwarce, do którego odwołuje się zapytanie. |
genderView |
Widok płci, do którego odwołuje się zapytanie. |
geoTargetConstant |
Stała celu geograficznego, do którego odwołuje się zapytanie. |
keywordView |
Widok słów kluczowych, do którego odwołuje się zapytanie. |
label |
Etykieta, do której odwołuje się zapytanie. |
languageConstant |
Stała języka, do której odwołuje się zapytanie. |
locationView |
Widok lokalizacji, do którego odwołuje się zapytanie. |
productBiddingCategoryConstant |
Kategoria określania stawek za produkt, do której odwołuje się zapytanie. |
productGroupView |
Widok grupy produktów, do którego odwołuje się zapytanie. |
shoppingPerformanceView |
Widok skuteczności zakupów, do którego odwołuje się zapytanie. |
userList |
Lista użytkowników, do której odwołuje się zapytanie. |
webpageView |
Widok strony internetowej, do którego odwołuje się zapytanie. |
visit |
Wizyta na poziomie zdarzenia, do której odwołuje się zapytanie. |
conversion |
Konwersja na poziomie zdarzenia, do której odwołuje się zapytanie. |
metrics |
Dane. |
segments |
Segmenty. |
customColumns[] |
Kolumny niestandardowe. |
AdGroup
Grupa reklam.
Zapis JSON |
---|
{ "resourceName": string, "status": enum ( |
Pola | |
---|---|
resourceName |
Nazwa zasobu grupy reklam. Nazwy zasobów grupy reklam mają postać:
|
status |
Stan grupy reklam. |
type |
Typ grupy reklam. |
adRotationMode |
Tryb rotacji reklam w grupie reklam. |
creationTime |
Sygnatura czasowa utworzenia tej grupy reklam. Sygnatura czasowa jest podana w strefie czasowej klienta i w formacie „rrrr-MM-dd GG:mm:ss”. |
targetingSetting |
Ustawienie funkcji związanych z kierowaniem. |
labels[] |
Nazwy zasobów etykiet dołączonych do tej grupy reklam. |
engineId |
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 elementu Google Ads użyj „adGroup.id”. |
startDate |
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 |
endDate |
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 |
languageCode |
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 |
lastModifiedTime |
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 |
Identyfikator grupy reklam. |
name |
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). |
cpcBidMicros |
Maksymalna stawka CPC (kosztu kliknięcia). |
engineStatus |
Stan wyszukiwarki dla grupy reklam. |
AdGroupStatus
Możliwe stany grupy reklam.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Stan nie został określony. |
UNKNOWN |
Otrzymana wartość nie jest znana w tej wersji. To jest wartość tylko z odpowiedzią. |
ENABLED |
Grupa reklam jest włączona. |
PAUSED |
Grupa reklam jest wstrzymana. |
REMOVED |
Grupa reklam została usunięta. |
AdGroupType
Lista możliwych typów grup reklam.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono typu. |
UNKNOWN |
Otrzymana wartość nie jest znana w tej wersji. To jest wartość tylko z odpowiedzią. |
SEARCH_STANDARD |
Domyślny typ grupy reklam w kampaniach w sieci wyszukiwania. |
DISPLAY_STANDARD |
Domyślny typ grupy reklam w kampaniach w sieci reklamowej. |
SHOPPING_PRODUCT_ADS |
Typ grupy reklam w kampaniach produktowych, w których wyświetlane są standardowe reklamy produktów. |
SHOPPING_SHOWCASE_ADS |
Typ grup reklam, które są ograniczone do wyświetlania reklam z funkcją prezentacji lub reklam sprzedawcy w wynikach wyszukiwania w Zakupach Google. |
HOTEL_ADS |
Domyślny typ grupy reklam w kampaniach reklam hoteli. |
SHOPPING_SMART_ADS |
Typ grup reklam w inteligentnych kampaniach produktowych. |
VIDEO_BUMPER |
Krótkie reklamy In-Stream, których nie można pominąć. |
VIDEO_TRUE_VIEW_IN_STREAM |
Reklamy wideo TrueView (możliwe do pominięcia) In-Stream. |
VIDEO_TRUE_VIEW_IN_DISPLAY |
reklam wideo TrueView In-Display. |
VIDEO_NON_SKIPPABLE_IN_STREAM |
Reklamy wideo In-Stream niemożliwe do pominięcia. |
VIDEO_OUTSTREAM |
Reklamy wideo typu Out-Stream. |
SEARCH_DYNAMIC_ADS |
Typ grupy reklam dla grup dynamicznych reklam w wyszukiwarce. |
SHOPPING_COMPARISON_LISTING_ADS |
Typ grup reklam w kampaniach z porównaniem produktów w Zakupach Google. |
PROMOTED_HOTEL_ADS |
Typ grupy reklam w grupach reklam promowanych hoteli. |
VIDEO_RESPONSIVE |
Grupy elastycznych reklam wideo. |
VIDEO_EFFICIENT_REACH |
Grupy reklam wideo typu „Skuteczny zasięg”. |
SMART_CAMPAIGN_ADS |
Typ grupy reklam w kampaniach inteligentnych. |
TRAVEL_ADS |
Typ grupy reklam w kampaniach dotyczących podróży. |
AdGroupAdRotationMode
Możliwe tryby rotacji reklam w grupie reklam.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Tryb rotacji reklam nie został określony. |
UNKNOWN |
Otrzymana wartość nie jest znana w tej wersji. To jest wartość tylko z odpowiedzią. |
OPTIMIZE |
Optymalizuj reklamy w grupie reklam pod kątem kliknięć lub konwersji. |
ROTATE_FOREVER |
Wyświetlaj naprzemiennie w nieskończoność. |
AdGroupEngineStatus
Stan wyszukiwarki grupy reklam.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji. |
AD_GROUP_ELIGIBLE |
Rola wycofana. Nie używać. |
AD_GROUP_EXPIRED |
W tej grupie reklam nie są wyświetlane żadne reklamy, ponieważ minęła data jej zakończenia. |
AD_GROUP_REMOVED |
Grupa reklam została usunięta. |
AD_GROUP_DRAFT |
W tej grupie reklam nie wyświetlają się żadne reklamy, ponieważ powiązana z nią grupa reklam jest nadal w wersji roboczej. |
AD_GROUP_PAUSED |
Grupa reklam została wstrzymana. |
AD_GROUP_SERVING |
Grupa reklam jest aktywna i aktualnie wyświetla reklamy. |
AD_GROUP_SUBMITTED |
Grupa reklam została przesłana (starszy stan Microsoft Bing Ads). |
CAMPAIGN_PAUSED |
W tej grupie reklam nie są wyświetlane żadne reklamy, ponieważ kampania została wstrzymana. |
ACCOUNT_PAUSED |
W tej grupie reklam nie są wyświetlane żadne reklamy, ponieważ konto zostało wstrzymane. |
TargetingSetting
Ustawienia funkcji związanych z kierowaniem na poziomie kampanii i grupy reklam. Więcej informacji o ustawieniu kierowania znajdziesz na stronie https://support.google.com/google-ads/answer/7365594
Zapis JSON |
---|
{
"targetRestrictions": [
{
object ( |
Pola | |
---|---|
targetRestrictions[] |
Ustawienie według wymiaru kierowania ograniczające zasięg kampanii lub grupy reklam. |
TargetRestriction
Lista ustawień kierowania na wymiar kierowania.
Zapis JSON |
---|
{
"targetingDimension": enum ( |
Pola | |
---|---|
targetingDimension |
Wymiar kierowania, do którego mają zastosowanie te ustawienia. |
bidOnly |
Wskazuje, czy ograniczyć wyświetlanie reklam tylko do kryteriów wybranych dla tego wymiaru kierowania, czy też na kierowanie wszystkich wartości tego wymiaru kierowania i wyświetlanie reklam na podstawie kierowania w innych wymiarach kierowania. Wartość |
TargetingDimension
Wyliczenie opisujące możliwe wymiary kierowania.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji. |
KEYWORD |
Kryteria słowa kluczowego, na przykład „rejs po marsie”. Słowo kluczowe KEYWORD można użyć jako wymiaru stawki niestandardowej. Słowa kluczowe są zawsze wymiarami kierowania, więc nie można ich ustawić jako wymiaru docelowego „WSZYSTKO” z ograniczeniem kierowania. |
AUDIENCE |
Kryteria odbiorców, które obejmują listę użytkowników, zainteresowania użytkowników, niestandardowe podobieństwo i niestandardowe grupy odbiorców na rynku. |
TOPIC |
Kryteria tematyczne do kierowania na kategorie treści, np. „category::Zwierzęta>Zwierzęta domowe” używane do kierowania reklam displayowych i wideo. |
GENDER |
Kryteria kierowania na płeć. |
AGE_RANGE |
Kryteria kierowania na przedziały wiekowe. |
PLACEMENT |
Kryteria miejsc docelowych obejmujące witryny takie jak „www.wyprzedaż4kwiaty.pl”, a także aplikacje mobilne, kategorie aplikacji mobilnych, filmy w YouTube i kanały w YouTube. |
PARENTAL_STATUS |
Kryteria kierowania na status rodzicielski. |
INCOME_RANGE |
Kryteria kierowania na przedział dochodu. |
AdGroupAd
Reklamę z grupy reklam.
Zapis JSON |
---|
{ "resourceName": string, "status": enum ( |
Pola | |
---|---|
resourceName |
Nazwa zasobu reklamy. Nazwy zasobów reklamowych grupy reklam mają postać:
|
status |
Stan reklamy. |
ad |
Reklama. |
creationTime |
Sygnatura czasowa utworzenia tej reklamy z grupy reklam. Data i godzina są podane w strefie czasowej klienta i w formacie „rrrr-MM-dd GG:mm:ss.ssssss”. |
labels[] |
Nazwy zasobów etykiet dołączonych do tej reklamy z grupy reklam. |
engineId |
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 Search Ads 360 użyj „adGroupAd.ad.id”. |
engineStatus |
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. |
lastModifiedTime |
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”. |
AdGroupAdStatus
Możliwe stany reklamy w grupie reklam.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono wartości. |
UNKNOWN |
Otrzymana wartość nie jest znana w tej wersji. To jest wartość tylko z odpowiedzią. |
ENABLED |
Reklama w grupie reklam jest włączona. |
PAUSED |
Reklama grupy reklam jest wstrzymana. |
REMOVED |
Reklama z grupy reklam została usunięta. |
Reklama
Reklamą.
Zapis JSON |
---|
{ "resourceName": string, "finalUrls": [ string ], "type": enum ( |
Pola | |
---|---|
resourceName |
Nazwa zasobu reklamy. Nazwy zasobów reklamowych mają postać:
|
finalUrls[] |
Lista możliwych końcowych adresów URL po wszystkich przekierowaniach między domenami w reklamie. |
type |
Typ reklamy. |
id |
Identyfikator reklamy. |
displayUrl |
Adres URL widoczny w tekście reklamy w przypadku niektórych formatów reklam. |
name |
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: |
|
textAd |
Szczegóły dotyczące reklamy tekstowej. |
expandedTextAd |
Szczegóły dotyczące rozszerzonej reklamy tekstowej. |
responsiveSearchAd |
Szczegóły elastycznej reklamy w wyszukiwarce. |
productAd |
Szczegóły dotyczące reklamy produktu. |
expandedDynamicSearchAd |
Szczegóły dotyczące rozszerzonej dynamicznej reklamy w wyszukiwarce. |
AdType
Możliwe typy reklamy.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono wartości. |
UNKNOWN |
Otrzymana wartość nie jest znana w tej wersji. To jest wartość tylko z odpowiedzią. |
TEXT_AD |
Jest to reklama tekstowa. |
EXPANDED_TEXT_AD |
Jest to rozszerzona reklama tekstowa. |
CALL_ONLY_AD |
Reklama typu „tylko połączenie”. |
EXPANDED_DYNAMIC_SEARCH_AD |
Reklama jest rozszerzoną dynamiczną reklamą w wyszukiwarce. |
HOTEL_AD |
Reklama to reklama hotelu. |
SHOPPING_SMART_AD |
To inteligentna reklama produktowa. |
SHOPPING_PRODUCT_AD |
To standardowa reklama produktowa. |
VIDEO_AD |
Jest to reklama wideo. |
GMAIL_AD |
Ta reklama to reklama w Gmailu. |
IMAGE_AD |
Ta reklama jest reklamą graficzną. |
RESPONSIVE_SEARCH_AD |
Jest to elastyczna reklama w wyszukiwarce. |
LEGACY_RESPONSIVE_DISPLAY_AD |
To starsza, elastyczna reklama displayowa. |
APP_AD |
Reklama jest reklamą aplikacji. |
LEGACY_APP_INSTALL_AD |
To starsza reklama promująca instalacje aplikacji. |
RESPONSIVE_DISPLAY_AD |
Jest to elastyczna reklama displayowa. |
LOCAL_AD |
Jest to reklama lokalna. |
HTML5_UPLOAD_AD |
Jest to reklama displayowa z typem produktu HTML5_UPLOAD_AD. |
DYNAMIC_HTML5_AD |
Jest to reklama displayowa przesyłana z jednym z typów produktów DYNAMIC_HTML5_*. |
APP_ENGAGEMENT_AD |
Reklama angażująca w aplikację. |
SHOPPING_COMPARISON_LISTING_AD |
Reklama jest reklamą z porównaniem produktów w Zakupach Google. |
VIDEO_BUMPER_AD |
Bumper reklamowy wideo. |
VIDEO_NON_SKIPPABLE_IN_STREAM_AD |
Reklama wideo In-Stream niemożliwa do pominięcia. |
VIDEO_OUTSTREAM_AD |
Reklama wideo Out-Stream. |
VIDEO_TRUEVIEW_DISCOVERY_AD |
Reklama wideo TrueView In-Display. |
VIDEO_TRUEVIEW_IN_STREAM_AD |
Reklama wideo TrueView In-Stream. |
VIDEO_RESPONSIVE_AD |
Elastyczna reklama wideo. |
SMART_CAMPAIGN_AD |
Reklama z kampanii inteligentnej. |
APP_PRE_REGISTRATION_AD |
Uniwersalna reklama promująca aplikację z wcześniejszą rejestracją. |
DISCOVERY_MULTI_ASSET_AD |
Reklama Discovery z wieloma zasobami. |
DISCOVERY_CAROUSEL_AD |
Reklama karuzelowa Discovery. |
TRAVEL_AD |
Reklama dotycząca podróży. |
DISCOVERY_VIDEO_RESPONSIVE_AD |
Elastyczna reklama wideo Discovery. |
SearchAds360TextAdInfo
Reklama tekstowa w Search Ads 360.
Zapis JSON |
---|
{ "headline": string, "description1": string, "description2": string, "displayUrl": string, "displayMobileUrl": string, "adTrackingId": string } |
Pola | |
---|---|
headline |
Nagłówek reklamy. |
description1 |
Pierwszy wiersz tekstu reklamy. |
description2 |
Drugi wiersz tekstu reklamy. |
displayUrl |
Wyświetlany adres URL reklamy. |
displayMobileUrl |
Wyświetlany mobilny adres URL reklamy. |
adTrackingId |
Identyfikator śledzenia reklamy. |
SearchAds360ExpandedTextAdInfo
Rozszerzona reklama tekstowa w Search Ads 360.
Zapis JSON |
---|
{ "headline": string, "headline2": string, "headline3": string, "description1": string, "description2": string, "path1": string, "path2": string, "adTrackingId": string } |
Pola | |
---|---|
headline |
Nagłówek reklamy. |
headline2 |
Drugi nagłówek reklamy. |
headline3 |
Trzeci nagłówek reklamy. |
description1 |
Pierwszy wiersz tekstu reklamy. |
description2 |
Drugi wiersz tekstu reklamy. |
path1 |
Tekst dołączany do automatycznie wygenerowanego widocznego adresu URL za pomocą separatora. |
path2 |
Tekst został dołączony do ścieżki 1 separatorem. |
adTrackingId |
Identyfikator śledzenia reklamy. |
SearchAds360ResponsiveSearchAdInfo
Elastyczna reklama w wyszukiwarce w Search Ads 360.
Zapis JSON |
---|
{ "path1": string, "path2": string, "adTrackingId": string } |
Pola | |
---|---|
path1 |
Tekst dołączany do automatycznie wygenerowanego widocznego adresu URL za pomocą separatora. |
path2 |
Tekst został dołączony do ścieżki 1 separatorem. |
adTrackingId |
Identyfikator śledzenia reklamy. |
SearchAds360ProductAdInfo
Ten typ nie ma żadnych pól.
Reklama produktu w Search Ads 360.
SearchAds360ExpandedDynamicSearchAdInfo
Rozszerzona dynamiczna reklama w wyszukiwarce.
Zapis JSON |
---|
{ "description1": string, "description2": string, "adTrackingId": string } |
Pola | |
---|---|
description1 |
Pierwszy wiersz tekstu reklamy. |
description2 |
Drugi wiersz tekstu reklamy. |
adTrackingId |
Identyfikator śledzenia reklamy. |
AdGroupAdEngineStatus
Liczy stany wyszukiwarki reklam w grupie reklam.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono wartości. |
UNKNOWN |
Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji. |
AD_GROUP_AD_ELIGIBLE |
Rola wycofana. Nie używać. |
AD_GROUP_AD_INAPPROPRIATE_FOR_CAMPAIGN |
Baidu: kreacja nie została zatwierdzona. |
AD_GROUP_AD_MOBILE_URL_UNDER_REVIEW |
Baidu: mobilny adres URL oczekuje na sprawdzenie. |
AD_GROUP_AD_PARTIALLY_INVALID |
Baidu: kreacja jest nieprawidłowa na urządzeniu mobilnym, ale prawidłowa na komputerze. |
AD_GROUP_AD_TO_BE_ACTIVATED |
Baidu: kreacja jest gotowa do aktywacji. |
AD_GROUP_AD_NOT_REVIEWED |
Baidu: kreacja nie została sprawdzona. |
AD_GROUP_AD_ON_HOLD |
Rola wycofana. Nie używać. Używany wcześniej przez Gemini |
AD_GROUP_AD_PAUSED |
Kreacja została wstrzymana. |
AD_GROUP_AD_REMOVED |
Kreacja została usunięta. |
AD_GROUP_AD_PENDING_REVIEW |
Kreacja oczekuje na sprawdzenie. |
AD_GROUP_AD_UNDER_REVIEW |
Kreacja jest w trakcie sprawdzania. |
AD_GROUP_AD_APPROVED |
Kreacja została zatwierdzona. |
AD_GROUP_AD_DISAPPROVED |
Kreacja została odrzucona. |
AD_GROUP_AD_SERVING |
Kreacja jest wyświetlana. |
AD_GROUP_AD_ACCOUNT_PAUSED |
Kreacja została wstrzymana, ponieważ konto jest wstrzymane. |
AD_GROUP_AD_CAMPAIGN_PAUSED |
Kreacja została wstrzymana, ponieważ kampania jest wstrzymana. |
AD_GROUP_AD_AD_GROUP_PAUSED |
Kreacja została wstrzymana, ponieważ grupa reklam jest wstrzymana. |
AdGroupAdLabel
Związek między reklamą w grupie reklam a etykietą.
Zapis JSON |
---|
{ "resourceName": string, "adGroupAd": string, "label": string } |
Pola | |
---|---|
resourceName |
Nazwa zasobu etykiety reklamy grupy reklam. Nazwy zasobów etykiet reklam w grupie reklam mają postać: |
adGroupAd |
Reklama w grupie reklam, do której jest dołączona etykieta. |
label |
Etykieta przypisana do reklamy z grupy reklam. |
AdGroupAsset
Połączenie między grupą reklam a komponentem.
Zapis JSON |
---|
{
"resourceName": string,
"adGroup": string,
"asset": string,
"status": enum ( |
Pola | |
---|---|
resourceName |
Nazwa zasobu grupy reklam. Nazwy zasobów GroupAsset mają postać:
|
adGroup |
Wymagane. Grupa reklam, z którą komponent jest połączony. |
asset |
Wymagane. Komponent połączony z grupą reklam. |
status |
Stan komponentu grupy reklam. |
AssetLinkStatus
Wyliczenie opisujące stan linku zasobu.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji. |
ENABLED |
Link do zasobu jest włączony. |
REMOVED |
Link do zasobu został usunięty. |
PAUSED |
Link do zasobu jest wstrzymany. |
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.
Zapis JSON |
---|
{
"resourceName": string,
"adGroup": string,
"assetSet": string,
"status": enum ( |
Pola | |
---|---|
resourceName |
Nazwa zasobu zestawu komponentów grupy reklam. Nazwy zasobów zestawu komponentów grupy reklam mają postać:
|
adGroup |
Grupa reklam, z którą połączony jest ten zestaw komponentów. |
assetSet |
Zestaw komponentów połączony z grupą reklam. |
status |
Stan zestawu komponentów grupy reklam. Tylko do odczytu. |
AssetSetLinkStatus
Możliwe stany połączenia zestawu zasobów z jego kontenerem.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Stan nie został określony. |
UNKNOWN |
Otrzymana wartość nie jest znana w tej wersji. To jest wartość tylko z odpowiedzią. |
ENABLED |
Włączone jest łączenie zestawu zasobów z jego kontenerem. |
REMOVED |
Połączenie między zestawem zasobów a jego kontenerem zostanie usunięte. |
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.
Zapis JSON |
---|
{ "resourceName": string } |
Pola | |
---|---|
resourceName |
Nazwa zasobu widoku odbiorców na poziomie grupy reklam. Nazwy zasobów widoku listy odbiorców w grupie reklam mają postać:
|
AdGroupBidModifier
Reprezentuje modyfikator stawek grupy reklam.
Zapis JSON |
---|
{ "resourceName": string, "bidModifier": number, // Union field |
Pola | |
---|---|
resourceName |
Nazwa zasobu modyfikatora stawki grupy reklam. Nazwy zasobów modyfikatora stawek grupy reklam mają postać:
|
bidModifier |
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 Wymagane przy operacjach tworzenia począwszy od wersji 5. |
|
device |
Kryterium urządzenia. |
DeviceInfo
Kryterium urządzenia.
Zapis JSON |
---|
{
"type": enum ( |
Pola | |
---|---|
type |
Typ urządzenia. |
Urządzenie
Określa urządzenia Google Ads, na które można kierować reklamy.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Wartość jest nieznana w tej wersji. |
MOBILE |
Komórki wyposażone w przeglądarkę z pełną funkcjonalnością. |
TABLET |
Tablety wyposażone w przeglądarkę z pełną funkcjonalnością. |
DESKTOP |
Komputery. |
CONNECTED_TV |
Telewizory smart TV i konsole do gier |
OTHER |
Inne typy urządzeń. |
AdGroupCriterion
Kryterium grupy reklam. Raport adGroupCriterion zwraca tylko te kryteria, które zostały bezpośrednio dodane do grupy reklam.
Zapis JSON |
---|
{ "resourceName": string, "creationTime": string, "status": enum ( |
Pola | |
---|---|
resourceName |
Nazwa zasobu kryterium grupy reklam. Nazwy zasobów kryterium w grupie reklam mają postać:
|
creationTime |
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 |
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. |
qualityInfo |
Informacje o jakości kryterium. |
type |
Rodzaj kryterium. |
labels[] |
Nazwy zasobów etykiet dołączonych do tego kryterium grupy reklam. |
positionEstimates |
Szacunki dla stawek dla różnych kryteriów na różnych pozycjach. |
finalUrls[] |
Lista możliwych końcowych adresów URL po wszystkich przekierowaniach między domenami w reklamie. |
engineId |
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 elementu Google Ads użyj „adGroupCriterion.criterion_id”. |
lastModifiedTime |
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”. |
criterionId |
Identyfikator kryterium. |
adGroup |
Grupa reklam, do której należy kryterium. |
negative |
Określa, czy kryterium ma być celem kierowania ( Tego pola nie można zmienić. Aby zmienić kryterium z dodatnie na wykluczające, usuń je i dodaj ponownie. |
bidModifier |
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. |
cpcBidMicros |
Stawka CPC (kosztu kliknięcia). |
effectiveCpcBidMicros |
Efektywna stawka CPC (koszt kliknięcia). |
engineStatus |
Stan wyszukiwarki dla kryterium grupy reklam. |
finalUrlSuffix |
Szablon adresu URL służący do dołączania parametrów do końcowego adresu URL. |
trackingUrlTemplate |
Szablon adresu URL służący do tworzenia linku monitorującego. |
Pole sumy Musisz ustawić dokładnie jeden. |
|
keyword |
Słowo kluczowe. |
listingGroup |
Grupa informacji o produktach. |
ageRange |
Przedział wiekowy. |
gender |
Płeć. |
userList |
Lista użytkowników. |
webpage |
Strona internetowa |
location |
Lokalizacja. |
AdGroupCriterionStatus
Możliwe stany kryterium grupy reklam.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono wartości. |
UNKNOWN |
Otrzymana wartość nie jest znana w tej wersji. To jest wartość tylko z odpowiedzią. |
ENABLED |
Kryterium w grupie reklam jest włączone. |
PAUSED |
Kryterium w grupie reklam jest wstrzymane. |
REMOVED |
Kryterium w grupie reklam zostało usunięte. |
QualityInfo
Kontener informacji dotyczących jakości kryterium grupy reklam.
Zapis JSON |
---|
{ "qualityScore": integer } |
Pola | |
---|---|
qualityScore |
Wynik jakości. To pole może nie być wypełniane, jeśli Google nie ma wystarczających informacji do określenia wartości. |
CriterionType
Wyliczenie opisujące możliwe typy kryteriów.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji. |
KEYWORD |
Słowo kluczowe na przykład „rejs po marsie”. |
PLACEMENT |
Miejsce docelowe, znane również jako witryna, np. „www.wyprzedaż4kwiatów.com” |
MOBILE_APP_CATEGORY |
Kategorie aplikacji mobilnych, na które chcesz kierować reklamy. |
MOBILE_APPLICATION |
Aplikacje mobilne, na które chcesz kierować reklamy. |
DEVICE |
Urządzenia, na które chcesz kierować reklamy. |
LOCATION |
Lokalizacje, na które mają być kierowane reklamy. |
LISTING_GROUP |
Grupy informacji o produktach, na które mają być kierowane reklamy. |
AD_SCHEDULE |
Harmonogram reklam. |
AGE_RANGE |
Przedział wiekowy. |
GENDER |
Płeć. |
INCOME_RANGE |
Zakres przychodu. |
PARENTAL_STATUS |
Status rodzicielski. |
YOUTUBE_VIDEO |
Film w YouTube. |
YOUTUBE_CHANNEL |
Kanał w YouTube. |
USER_LIST |
Lista użytkowników. |
PROXIMITY |
Bliskość. |
TOPIC |
Kierowanie na temat w sieci reklamowej (np. „Zwierzęta dzikie i domowe”). |
LISTING_SCOPE |
Zakres informacji o aplikacji, na który chcesz kierować reklamy. |
LANGUAGE |
Językiem |
IP_BLOCK |
IPBlock. |
CONTENT_LABEL |
Etykieta treści dla wykluczenia kategorii. |
CARRIER |
Operator. |
USER_INTEREST |
Kategoria, którą interesuje użytkownika. |
WEBPAGE |
Kryterium strony internetowej dla dynamicznych reklam w wyszukiwarce. |
OPERATING_SYSTEM_VERSION |
Wersja systemu operacyjnego. |
APP_PAYMENT_MODEL |
Model płatności za aplikację. |
MOBILE_DEVICE |
Urządzenie mobilne. |
CUSTOM_AFFINITY |
Niestandardowe podobieństwo. |
CUSTOM_INTENT |
Niestandardowi odbiorcy o podobnych zamiarach. |
LOCATION_GROUP |
Grupa lokalizacji. |
CUSTOM_AUDIENCE |
Niestandardowa lista odbiorców |
COMBINED_AUDIENCE |
Odbiorcy z połączonych list |
KEYWORD_THEME |
Kampania inteligentna – grupa tematyczna słów kluczowych |
AUDIENCE |
Odbiorcy |
LOCAL_SERVICE_ID |
Identyfikator usługi Reklam Usług Lokalnych. |
BRAND |
Marka |
BRAND_LIST |
Lista marek |
LIFE_EVENT |
Zdarzenie z życia |
PositionEstimates
Szacunki dla stawek dla różnych kryteriów na różnych pozycjach.
Zapis JSON |
---|
{ "topOfPageCpcMicros": string } |
Pola | |
---|---|
topOfPageCpcMicros |
Szacunkowa stawka CPC wymagana do wyświetlenia reklamy na górze pierwszej strony wyników wyszukiwania. |
AdGroupCriterionEngineStatus
Wylicza stany wyszukiwarki GroupCriterion.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji. |
AD_GROUP_CRITERION_ELIGIBLE |
Rola wycofana. Nie używać. |
AD_GROUP_CRITERION_INAPPROPRIATE_FOR_CAMPAIGN |
Baidu: stawka lub jakość są za niskie, aby reklama mogła się wyświetlać. |
AD_GROUP_CRITERION_INVALID_MOBILE_SEARCH |
Baidu: stawka lub jakość są za niskie dla urządzeń mobilnych, ale mogą wyświetlać się na komputerach. |
AD_GROUP_CRITERION_INVALID_PC_SEARCH |
Baidu: za niska jakość lub stawka w przypadku komputerów, ale kwalifikuje się do wyświetlania na urządzeniach mobilnych. |
AD_GROUP_CRITERION_INVALID_SEARCH |
Baidu: stawka lub jakość są za niskie, aby reklama mogła się wyświetlać. |
AD_GROUP_CRITERION_LOW_SEARCH_VOLUME |
Baidu: reklama wstrzymana przez Baidu z powodu małej liczby wyszukiwań. |
AD_GROUP_CRITERION_MOBILE_URL_UNDER_REVIEW |
Baidu: mobilny adres URL oczekuje na sprawdzenie. |
AD_GROUP_CRITERION_PARTIALLY_INVALID |
Baidu: strona docelowa jednego urządzenia jest nieprawidłowa, a strona docelowa na drugim urządzeniu jest prawidłowa. |
AD_GROUP_CRITERION_TO_BE_ACTIVATED |
Baidu: słowo kluczowe zostało utworzone i wstrzymane przez funkcję zarządzania kontem Baidu i możesz je teraz aktywować. |
AD_GROUP_CRITERION_UNDER_REVIEW |
Baidu: oczekuje na sprawdzenie przez Baidu. Gemini: kryterium w trakcie sprawdzania. |
AD_GROUP_CRITERION_NOT_REVIEWED |
Baidu: kryterium do sprawdzenia. |
AD_GROUP_CRITERION_ON_HOLD |
Rola wycofana. Nie używać. Używany wcześniej przez Gemini |
AD_GROUP_CRITERION_PENDING_REVIEW |
Y!J : kryterium oczekuje na sprawdzenie |
AD_GROUP_CRITERION_PAUSED |
Kryterium zostało wstrzymane. |
AD_GROUP_CRITERION_REMOVED |
Kryterium zostało usunięte. |
AD_GROUP_CRITERION_APPROVED |
Kryterium zostało zatwierdzone. |
AD_GROUP_CRITERION_DISAPPROVED |
Kryterium zostało odrzucone. |
AD_GROUP_CRITERION_SERVING |
Kryterium jest aktywne i powoduje wyświetlanie reklam. |
AD_GROUP_CRITERION_ACCOUNT_PAUSED |
Kryterium zostało wstrzymane, ponieważ konto jest wstrzymane. |
KeywordInfo
Kryterium słowa kluczowego.
Zapis JSON |
---|
{
"matchType": enum ( |
Pola | |
---|---|
matchType |
Typ dopasowania słowa kluczowego. |
text |
Tekst słowa kluczowego (maksymalnie 80 znaków i 10 słów). |
KeywordMatchType
Możliwe typy dopasowania słów kluczowych.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji. |
EXACT |
Dopasowanie ścisłe. |
PHRASE |
Dopasowanie do wyrażenia. |
BROAD |
Dopasowanie przybliżone. |
ListingGroupInfo
Kryterium grupy informacji o produktach.
Zapis JSON |
---|
{
"type": enum ( |
Pola | |
---|---|
type |
Typ grupy informacji o produktach. |
ListingGroupType
Typ grupy informacji o produktach.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji. |
SUBDIVISION |
Podział produktów według niektórych wymiarów informacji o produkcie. Te węzły nie są używane do kierowania na wpisy z listą, ale służą tylko do definiowania struktury drzewa. |
UNIT |
Jednostka grupy informacji o produktach określająca stawkę. |
AgeRangeInfo
Kryterium przedziału wiekowego.
Zapis JSON |
---|
{
"type": enum ( |
Pola | |
---|---|
type |
Typ przedziału wiekowego. |
AgeRangeType
Rodzaj grupy demograficznej przedziałów wiekowych (na przykład od 18 do 24 lat).
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji. |
AGE_RANGE_18_24 |
między 18 a 24 rokiem życia. |
AGE_RANGE_25_34 |
między 25 a 34 rokiem życia; |
AGE_RANGE_35_44 |
Między 35 a 44 rokiem życia. |
AGE_RANGE_45_54 |
między 45 a 54 rokiem życia. |
AGE_RANGE_55_64 |
Między 55 a 64 rokiem życia. |
AGE_RANGE_65_UP |
65 lat i więcej. |
AGE_RANGE_UNDETERMINED |
Nieokreślony przedział wiekowy. |
GenderInfo
Kryterium płci.
Zapis JSON |
---|
{
"type": enum ( |
Pola | |
---|---|
type |
Rodzaj płci. |
GenderType
Rodzaj płci (np. kobiety).
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji. |
MALE |
Mężczyzna. |
FEMALE |
Kobieta. |
UNDETERMINED |
Nie określono płci. |
UserListInfo
Kryterium listy użytkowników. Reprezentuje listę użytkowników zdefiniowaną przez reklamodawcę, na którą ma być kierowana reklama.
Zapis JSON |
---|
{ "userList": string } |
Pola | |
---|---|
userList |
Nazwa zasobu listy użytkowników. |
WebpageInfo
Reprezentuje kryterium kierowania reklam na strony internetowe w witrynie reklamodawcy.
Zapis JSON |
---|
{
"conditions": [
{
object ( |
Pola | |
---|---|
conditions[] |
Warunki lub wyrażenia logiczne na potrzeby kierowania na strony internetowe. Lista warunków kierowania na strony internetowe jest i jest łączona podczas oceny kierowania. Pusta lista warunków oznacza, że reklamy są kierowane na wszystkie strony witryny kampanii. To pole jest wymagane w przypadku operacji CREATE i jest niedozwolone w przypadku operacji UPDATE. |
coveragePercentage |
Procent pokrycia kryteriów witryny. To obliczony odsetek pokrycia witryny obliczony na podstawie celu witryny, wykluczonej witryny docelowej i wykluczających słów kluczowych w grupie reklam i kampanii. Jeśli na przykład pokrycie zwraca wartość 1, oznacza to, że ma 100% pokrycia. To pole jest tylko do odczytu. |
criterionName |
Nazwa kryterium określona przez ten parametr. Wartość nazwy służy do identyfikowania, sortowania i filtrowania kryteriów związanych z tym typem parametrów. To pole jest wymagane w przypadku operacji CREATE i jest niedozwolone w przypadku operacji UPDATE. |
WebpageConditionInfo
Wyrażenie logiczne służące do kierowania reklam na strony internetowe w witrynie reklamodawcy.
Zapis JSON |
---|
{ "operand": enum ( |
Pola | |
---|---|
operand |
Parametr warunku kierowania na stronę internetową. |
operator |
Operator warunku kierowania na stronę internetową. |
argument |
Argument warunku kierowania na stronę internetową. |
WebpageConditionOperand
Argument warunku strony internetowej w kryterium strony internetowej.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji. |
URL |
Komentarz określający warunek kierowania na adres URL strony internetowej. |
CATEGORY |
Komentarz określający warunek kierowania na kategorię stron internetowych. |
PAGE_TITLE |
Komentarz określający warunek kierowania na tytuł strony internetowej. |
PAGE_CONTENT |
Komentarz określający warunek kierowania na treść strony internetowej. |
CUSTOM_LABEL |
Komentarz określający warunek kierowania etykiety własnej na stronie internetowej. |
WebpageConditionOperator
Operator warunku strony internetowej w kryterium strony.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji. |
EQUALS |
Warunek internetowy argumentu jest równy porównywanym warunkom sieciowym. |
CONTAINS |
Warunek internetowy argumentu jest częścią porównywanego warunku internetowego. |
LocationInfo
Kryterium lokalizacji.
Zapis JSON |
---|
{ "geoTargetConstant": string } |
Pola | |
---|---|
geoTargetConstant |
Nazwa stałego zasobu kierowania geograficznego. |
AdGroupCriterionLabel
Związek między kryterium grupy reklam a etykietą.
Zapis JSON |
---|
{ "resourceName": string, "adGroupCriterion": string, "label": string } |
Pola | |
---|---|
resourceName |
Nazwa zasobu etykiety kryterium grupy reklam. Nazwy zasobów etykiety kryterium w grupie reklam mają postać: |
adGroupCriterion |
Kryterium grupy reklam, do którego jest dołączona etykieta. |
label |
Etykieta przypisana do kryterium w grupie reklam. |
AdGroupLabel
Związek między grupą reklam a etykietą.
Zapis JSON |
---|
{ "resourceName": string, "adGroup": string, "label": string } |
Pola | |
---|---|
resourceName |
Nazwa zasobu etykiety grupy reklam. Nazwy zasobów etykiet grupy reklam mają postać: |
adGroup |
Grupa reklam, do której jest dołączona etykieta. |
label |
Etykieta przypisana do grupy reklam. |
AgeRangeView
Widok przedziału wiekowego.
Zapis JSON |
---|
{ "resourceName": string } |
Pola | |
---|---|
resourceName |
Nazwa zasobu widoku przedziału wiekowego. Nazwy zasobów widoku przedziału wiekowego mają postać:
|
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.
Zapis JSON |
---|
{ "resourceName": string, "type": enum ( |
Pola | |
---|---|
resourceName |
Nazwa zasobu. Nazwy zasobów zasobów mają postać:
|
type |
Typ zasobu. |
finalUrls[] |
Lista możliwych końcowych adresów URL po wszystkich przekierowaniach między domenami. |
status |
Stan zasobu. |
creationTime |
Sygnatura czasowa utworzenia tego zasobu. Sygnatura czasowa jest podana w strefie czasowej klienta i w formacie „rrrr-MM-dd GG:mm:ss”. |
lastModifiedTime |
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 |
Identyfikator zasobu. |
name |
Opcjonalna nazwa zasobu. |
trackingUrlTemplate |
Szablon URL do tworzenia linku monitorującego. |
engineStatus |
Stan wyszukiwarki zasobu. |
Pole sumy asset_data . Konkretny typ zasobu. asset_data może być tylko jedną z tych wartości: |
|
youtubeVideoAsset |
Komponent wideo w YouTube. |
imageAsset |
Komponent z obrazem. |
textAsset |
Komponent tekstowy. |
calloutAsset |
Ujednolicony komponent z objaśnieniami. |
sitelinkAsset |
Ujednolicony komponent z linkami do podstron. |
pageFeedAsset |
Komponent z ujednoliconym plikiem z adresami stron docelowych. |
mobileAppAsset |
Komponent z linkiem do aplikacji mobilnej. |
callAsset |
Ujednolicony komponent do wykonywania połączeń. |
callToActionAsset |
Komponent z wezwaniem do działania. |
locationAsset |
Ujednolicony komponent z lokalizacją. |
AssetType
Wartość Enum opisująca możliwe typy zasobu.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji. |
YOUTUBE_VIDEO |
Komponent wideo w YouTube. |
MEDIA_BUNDLE |
Zasób pakietu kreacji multimedialnych. |
IMAGE |
Komponent z obrazem. |
TEXT |
Komponent tekstowy. |
LEAD_FORM |
Komponent z formularzem kontaktowym. |
BOOK_ON_GOOGLE |
Komponent Zarezerwuj z Google. |
PROMOTION |
Komponent z promocją. |
CALLOUT |
Komponent z objaśnieniem. |
STRUCTURED_SNIPPET |
Komponent z rozszerzeniem informacji. |
SITELINK |
Komponent z linkami do podstron. |
PAGE_FEED |
Komponent z plikiem z adresami stron docelowych. |
DYNAMIC_EDUCATION |
Dynamiczny zasób edukacyjny. |
MOBILE_APP |
Komponent z linkiem do aplikacji mobilnej. |
HOTEL_CALLOUT |
Komponent z objaśnieniem dotyczącym hoteli. |
CALL |
Komponent do wykonywania połączeń. |
PRICE |
Komponent z cenami. |
CALL_TO_ACTION |
Komponent z wezwaniem do działania. |
DYNAMIC_REAL_ESTATE |
Dynamiczny zasób związany z nieruchomościami. |
DYNAMIC_CUSTOM |
Dynamiczny zasób niestandardowy. |
DYNAMIC_HOTELS_AND_RENTALS |
Dynamiczny zasób dotyczący hoteli i wynajmu. |
DYNAMIC_FLIGHTS |
Zasób dynamicznych lotów. |
DISCOVERY_CAROUSEL_CARD |
Zasób karty karuzeli Discovery. |
DYNAMIC_TRAVEL |
Dynamiczny komponent związany z podróżami. |
DYNAMIC_LOCAL |
Dynamiczny zasób lokalny. |
DYNAMIC_JOBS |
Dynamiczny zasób z ofertami pracy. |
LOCATION |
Komponent z lokalizacją. |
HOTEL_PROPERTY |
Komponent dotyczący obiektu hotelowego. |
AssetStatus
Możliwe stany komponentu.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Stan nie został określony. |
UNKNOWN |
Otrzymana wartość nie jest znana w tej wersji. To jest wartość tylko z odpowiedzią. |
ENABLED |
Komponent jest włączony. |
REMOVED |
Komponent zostanie usunięty. |
ARCHIVED |
Zasób został zarchiwizowany. |
PENDING_SYSTEM_GENERATED |
Zasób został wygenerowany przez system i oczekuje na sprawdzenie przez użytkownika. |
AssetEngineStatus
Następny identyfikator = 11
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji. |
SERVING |
Zasób jest aktywny. |
SERVING_LIMITED |
Zasób jest aktywny i ograniczony. |
DISAPPROVED |
Komponent został odrzucony (nieodpowiedni). |
DISABLED |
Komponent jest nieaktywny (oczekujący). |
REMOVED |
Komponent został usunięty. |
YoutubeVideoAsset
Zasób YouTube.
Zapis JSON |
---|
{ "youtubeVideoTitle": string, "youtubeVideoId": string } |
Pola | |
---|---|
youtubeVideoTitle |
Tytuł filmu w YouTube. |
youtubeVideoId |
Identyfikator filmu w YouTube. Jest to ciąg 11 znaków używany w adresie URL filmu w YouTube. |
ImageAsset
Komponent z obrazem.
Zapis JSON |
---|
{ "mimeType": enum ( |
Pola | |
---|---|
mimeType |
Typ MIME zasobu graficznego. |
fullSize |
Metadane tego obrazu w oryginalnym rozmiarze. |
fileSize |
Rozmiar pliku komponentu z obrazem w bajtach. |
MimeType
typ MIME.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Typ MIME nie został określony. |
UNKNOWN |
Otrzymana wartość nie jest znana w tej wersji. To jest wartość tylko z odpowiedzią. |
IMAGE_JPEG |
Typ MIME obrazu/jpeg. |
IMAGE_GIF |
Typ MIME obrazu/GIF-a. |
IMAGE_PNG |
Typ MIME obrazu/png. |
FLASH |
Typ MIME pliku application/x-shockwave-flash. |
TEXT_HTML |
Typ MIME pliku text/html. |
PDF |
Typ MIME aplikacji/pdf. |
MSWORD |
Typ MIME aplikacji/msword. |
MSEXCEL |
Typ MIME pliku application/vnd.ms-excel. |
RTF |
Typ MIME pliku application/rtf. |
AUDIO_WAV |
Typ MIME pliku audio/WAV. |
AUDIO_MP3 |
Typ MIME pliku audio/mp3. |
HTML5_AD_ZIP |
Typ MIME pliku application/x-html5-ad-zip. |
ImageDimension
Metadane obrazu w określonym rozmiarze (oryginalne lub zmienione).
Zapis JSON |
---|
{ "heightPixels": string, "widthPixels": string, "url": string } |
Pola | |
---|---|
heightPixels |
Wysokość obrazu. |
widthPixels |
Szerokość obrazu. |
url |
Adres URL, który zwraca obraz o tej wysokości i szerokości. |
TextAsset
Komponent tekstowy.
Zapis JSON |
---|
{ "text": string } |
Pola | |
---|---|
text |
Treść tekstowa komponentu tekstowego. |
UnifiedCalloutAsset
Ujednolicony komponent z objaśnieniami.
Zapis JSON |
---|
{
"calloutText": string,
"startDate": string,
"endDate": string,
"adScheduleTargets": [
{
object ( |
Pola | |
---|---|
calloutText |
Tekst objaśnienia. Jego długość powinna mieścić się w przedziale od 1 do 25 włącznie. |
startDate |
Data rozpoczęcia wyświetlania zasobu w formacie rrrr-MM-dd. |
endDate |
Data ostatniej daty ważności tego komponentu i nadal jest wyświetlana. Czas jest w formacie rrrr-MM-dd. |
adScheduleTargets[] |
Lista nienakładających się harmonogramów określająca wszystkie przedziały czasowe, w których zasób może się wyświetlać. Można ustawić maksymalnie 6 harmonogramów na dzień, a łącznie 42. |
useSearcherTimeZone |
Określa, czy zasób ma być wyświetlany w strefie czasowej użytkownika przeprowadzającego wyszukiwanie. Dotyczy Microsoft Ads. |
AdScheduleInfo
Reprezentuje kryterium AdSchedule.
AdSchedule jest określony jako dzień tygodnia i przedział czasu, w którym mają być wyświetlane reklamy.
Dla tego samego dnia można dodać maksymalnie 6 harmonogramów AdSchedule.
Zapis JSON |
---|
{ "startMinute": enum ( |
Pola | |
---|---|
startMinute |
Minuty po godzinie rozpoczęcia, o której rozpoczyna się ten harmonogram. To pole jest wymagane w przypadku operacji CREATE i jest niedozwolone w przypadku operacji UPDATE. |
endMinute |
Minuty po godzinie zakończenia tego harmonogramu. W harmonogramie nie ma minut końcowych. To pole jest wymagane w przypadku operacji CREATE i jest niedozwolone w przypadku operacji UPDATE. |
dayOfWeek |
Dzień tygodnia, którego dotyczy harmonogram. To pole jest wymagane w przypadku operacji CREATE i jest niedozwolone w przypadku operacji UPDATE. |
startHour |
Godzina rozpoczęcia w ciągu 24 godzin. To pole musi mieścić się w zakresie od 0 do 23 włącznie. To pole jest wymagane w przypadku operacji CREATE i jest niedozwolone w przypadku operacji UPDATE. |
endHour |
Godzina końcowa w formacie 24-godzinnym; 24 oznacza koniec dnia. To pole musi mieścić się w zakresie od 0 do 24 włącznie. To pole jest wymagane w przypadku operacji CREATE i jest niedozwolone w przypadku operacji UPDATE. |
MinuteOfHour
Wylicza kwadrans. Na przykład: „FIFTEEN”.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Wartość jest nieznana w tej wersji. |
ZERO |
0 minut po godzinie. |
FIFTEEN |
Piętnaście minut po godzinie. |
THIRTY |
30 minut po godzinie. |
FORTY_FIVE |
45 minut po godzinie. |
DayOfWeek
Wymienia dni tygodnia, na przykład „Monday”.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Wartość jest nieznana w tej wersji. |
MONDAY |
Poniedziałek. |
TUESDAY |
Wtorek. |
WEDNESDAY |
Środa. |
THURSDAY |
Czwartek. |
FRIDAY |
Piątek. |
SATURDAY |
do soboty. |
SUNDAY |
Niedziela. |
UnifiedSitelinkAsset
Ujednolicony komponent z linkami do podstron.
Zapis JSON |
---|
{
"linkText": string,
"description1": string,
"description2": string,
"startDate": string,
"endDate": string,
"adScheduleTargets": [
{
object ( |
Pola | |
---|---|
linkText |
Wyświetlany tekst adresu URL linku do podstrony. Jego długość powinna mieścić się w przedziale od 1 do 25 włącznie. |
description1 |
Pierwszy wiersz opisu linku do podstrony. Jeśli jest ustawiony, długość powinna mieścić się w przedziale od 1 do 35 włącznie i należy też ustawić opis2. |
description2 |
Drugi wiersz opisu linku do podstrony. Jeśli jest ustawiony, długość powinna mieścić się w przedziale od 1 do 35 włącznie i należy też ustawić opis1. |
startDate |
Data rozpoczęcia wyświetlania zasobu w formacie rrrr-MM-dd. |
endDate |
Data ostatniej daty ważności tego komponentu i nadal jest wyświetlana. Czas jest w formacie rrrr-MM-dd. |
adScheduleTargets[] |
Lista nienakładających się harmonogramów określająca wszystkie przedziały czasowe, w których zasób może się wyświetlać. Można ustawić maksymalnie 6 harmonogramów na dzień, a łącznie 42. |
trackingId |
Identyfikator używany do śledzenia kliknięć w komponencie z linkami do podstron. To jest konto Yahoo! Japan. |
useSearcherTimeZone |
Określa, czy komponent z linkami do podstron ma się wyświetlać w strefie czasowej użytkownika wyszukiwarki. Dotyczy Microsoft Ads. |
mobilePreferred |
Określa, czy komponent z linkami do podstron ma się wyświetlać na urządzeniach mobilnych. Dotyczy Microsoft Ads. |
UnifiedPageFeedAsset
Ujednolicony zasób z plikami z adresami stron docelowych.
Zapis JSON |
---|
{ "pageUrl": string, "labels": [ string ] } |
Pola | |
---|---|
pageUrl |
Strona internetowa, na którą chcą kierować reklamy reklamodawcy. |
labels[] |
Etykiety używane do grupowania adresów URL stron. |
MobileAppAsset
Komponent reprezentujący aplikację mobilną.
Zapis JSON |
---|
{
"appId": string,
"appStore": enum ( |
Pola | |
---|---|
appId |
Wymagane. Ciąg znaków, który jednoznacznie identyfikuje aplikację mobilną. Powinien on zawierać tylko identyfikator natywny platformy, np. „com.android.ebay” w przypadku Androida lub „12345689” w przypadku iOS. |
appStore |
Wymagane. Sklep z aplikacjami, który dystrybuuje tę konkretną aplikację. |
MobileAppVendor
Typ dostawcy aplikacji mobilnej
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji. |
APPLE_APP_STORE |
Dostawca aplikacji mobilnych dla sklepu Apple App Store. |
GOOGLE_APP_STORE |
Dostawca aplikacji mobilnej dla sklepu z aplikacjami Google. |
UnifiedCallAsset
Ujednolicony komponent do wykonywania połączeń.
Zapis JSON |
---|
{ "countryCode": string, "phoneNumber": string, "callConversionReportingState": enum ( |
Pola | |
---|---|
countryCode |
Dwuliterowy kod kraju z numerem telefonu. Przykłady: „PL”, „pl”. |
phoneNumber |
Nieprzetworzony numer telefonu reklamodawcy. Przykłady: „1234567890”, „(123)456-7890”. |
callConversionReportingState |
Wskazuje, czy ten komponent do wykonywania połączeń powinien używać własnego ustawienia konwersji telefonicznych, przestrzegać ustawień na poziomie konta, czy wyłączyć konwersje telefoniczne. |
callConversionAction |
Działanie powodujące konwersję, do którego przypisać konwersję telefoniczną. Jeśli zasada nie jest skonfigurowana, używane jest domyślne działanie powodujące konwersję. To pole ma zastosowanie tylko wtedy, gdy parametr callConversionReportingState ma wartość USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION. |
adScheduleTargets[] |
Lista nienakładających się harmonogramów określająca wszystkie przedziały czasowe, w których zasób może się wyświetlać. Można ustawić maksymalnie 6 harmonogramów na dzień, a łącznie 42. |
callOnly |
Wskazuje, czy w połączeniu wyświetli się tylko numer telefonu bez linku do witryny. Dotyczy Microsoft Ads. |
callTrackingEnabled |
Określa, czy połączenie ma być włączone przy śledzeniu połączeń. Dotyczy Microsoft Ads. |
useSearcherTimeZone |
Określa, czy rozszerzenie połączeń ma być wyświetlane w strefie czasowej użytkownika wyszukiwarki. Dotyczy Microsoft Ads. |
startDate |
Data rozpoczęcia wyświetlania zasobu w formacie rrrr-MM-dd. |
endDate |
Data ostatniej daty ważności tego komponentu i nadal jest wyświetlana. Czas jest w formacie rrrr-MM-dd. |
CallConversionReportingState
Możliwe typy danych dla stanu działania powodującego konwersję telefoniczną.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji. |
DISABLED |
Działanie powodujące konwersję telefoniczną jest wyłączone. |
USE_ACCOUNT_LEVEL_CALL_CONVERSION_ACTION |
Działanie powodujące konwersję telefoniczną będzie korzystać z typu konwersji telefonicznej ustawionego na poziomie konta. |
USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION |
Działanie powodujące konwersję telefoniczną będzie korzystać z typu konwersji telefonicznej określonego na poziomie zasobu (reklamy typu „tylko połączenie” lub rozszerzenia połączeń). |
CallToActionAsset
Komponent z wezwaniem do działania.
Zapis JSON |
---|
{
"callToAction": enum ( |
Pola | |
---|---|
callToAction |
Wezwanie do działania. |
CallToActionType
Wartość Enum opisująca możliwe typy wezwań do działania.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji. |
LEARN_MORE |
Typ wezwania do działania to „więcej informacji”. |
GET_QUOTE |
Rodzaj wezwania do działania to „uzyskaj wycenę”. |
APPLY_NOW |
Typ wezwania do działania ma zastosowanie. |
SIGN_UP |
Typ wezwania do działania to „rejestracja”. |
CONTACT_US |
Wezwanie do działania to „Skontaktuj się z nami”. |
SUBSCRIBE |
Typ wezwania do działania to „Subskrybuj”. |
DOWNLOAD |
Rodzaj wezwania do działania to „pobieranie”. |
BOOK_NOW |
Typ wezwania do działania to Zarezerwuj teraz. |
SHOP_NOW |
Typ wezwania do działania to „kup teraz”. |
BUY_NOW |
Typ wezwania do działania to kup teraz. |
DONATE_NOW |
Typ wezwania do działania to „Przekaż darowiznę”. |
ORDER_NOW |
Typ wezwania do działania to zamówienie teraz. |
PLAY_NOW |
Typ wezwania do działania to Odtwórz teraz. |
SEE_MORE |
Typ wezwania do działania: zobacz więcej. |
START_NOW |
Typ wezwania do działania jest teraz uruchamiany. |
VISIT_SITE |
Typ wezwania do działania to wizyta w witrynie. |
WATCH_NOW |
Typ wezwania do działania to „obejrzyj teraz”. |
UnifiedLocationAsset
Ujednolicony komponent z lokalizacją.
Zapis JSON |
---|
{ "placeId": string, "businessProfileLocations": [ { object ( |
Pola | |
---|---|
placeId |
Identyfikatory miejsc jednoznacznie identyfikują dane miejsce w bazie danych Miejsc Google i w Mapach Google. To pole jest unikalne dla danego identyfikatora klienta i typu zasobu. Więcej informacji o identyfikatorze miejsca znajdziesz na stronie https://developers.google.com/places/web-service/place-id. |
businessProfileLocations[] |
Lista lokalizacji firmy klienta. Ta wartość będzie zwracana tylko wtedy, gdy komponent z lokalizacją jest synchronizowany z kontem w Profilu Firmy. Na tym samym koncie może być wiele wizytówek w Profilu Firmy i mających ten sam identyfikator miejsca. |
locationOwnershipType |
Typ własności lokalizacji. Jeśli typ to BUSINESS_OWNER, będzie wyświetlany jako rozszerzenie lokalizacji. Jeśli typ to Powiązana lokalizacja, będzie ona wyświetlana jako powiązana lokalizacja. |
BusinessProfileLocation
Dane o lokalizacji profilu firmy są synchronizowane z połączonego konta w usłudze Profil Firmy.
Zapis JSON |
---|
{ "labels": [ string ], "storeCode": string, "listingId": string } |
Pola | |
---|---|
labels[] |
Reklamodawca określił etykietę lokalizacji na koncie w Profilu Firmy. Te informacje są synchronizowane z konta w Profilu Firmy. |
storeCode |
Kod sklepu w Profilu Firmy dla tej lokalizacji. Te informacje są synchronizowane z konta w Profilu Firmy. |
listingId |
Identyfikator wizytówki w tej lokalizacji w Profilu Firmy. Te dane są synchronizowane z połączonego konta w usłudze Profil Firmy. |
LocationOwnershipType
Możliwe rodzaje własności lokalizacji.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji. |
BUSINESS_OWNER |
Właściciel firmy z lokalizacją(starsze rozszerzenie lokalizacji – LE). |
AFFILIATE |
Powiązana lokalizacja(rozszerzenie lokalizacji firmy zewnętrznej – ALE). |
AssetGroupAsset
AssetGroupAsset to połączenie między zasobem a grupą komponentów. Dodanie komponentu AssetGroupAsset powoduje połączenie zasobu z grupą komponentów.
Zapis JSON |
---|
{ "resourceName": string, "assetGroup": string, "asset": string, "fieldType": enum ( |
Pola | |
---|---|
resourceName |
Nazwa zasobu grupy plików. Nazwa zasobu w grupie plików ma postać:
|
assetGroup |
Grupa plików, którą łączy ten komponent z grupą plików. |
asset |
Komponent, który łączy ten komponent grupy plików. |
fieldType |
Opis miejsca docelowego zasobu w grupie plików. Na przykład: HEADLINE, YOUTUBE_VIDEO itp. |
status |
Stan połączenia komponentu z grupą komponentów. |
AssetFieldType
Wartość Enum opisująca możliwe miejsca docelowe zasobu.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji. |
HEADLINE |
Komponent jest połączony i można go używać jako nagłówka. |
DESCRIPTION |
Zasób jest połączony i można go używać jako tekstu reklamy. |
MANDATORY_AD_TEXT |
Ten komponent jest połączony i można go używać jako obowiązkowego tekstu reklamy. |
MARKETING_IMAGE |
Ten komponent jest połączony i można go używać jako obrazu marketingowego. |
MEDIA_BUNDLE |
Zasób jest połączony i można go używać jako pakietu kreacji multimedialnych. |
YOUTUBE_VIDEO |
Zasób jest połączony i można go używać jako filmu w YouTube. |
BOOK_ON_GOOGLE |
Komponent jest połączony, aby wskazać, że kampania reklam hoteli ma włączoną opcję „Zarezerwuj z Google”. |
LEAD_FORM |
Ten komponent jest połączony i można go używać jako rozszerzenia formularza kontaktowego. |
PROMOTION |
Ten komponent jest połączony i można go używać jako rozszerzenia promocji. |
CALLOUT |
Ten komponent jest połączony i można go używać jako rozszerzenia objaśnień. |
STRUCTURED_SNIPPET |
Komponent jest połączony i można go używać jako rozszerzenia informacji w witrynie. |
SITELINK |
Ten komponent jest połączony i można go używać jako linku do podstrony. |
MOBILE_APP |
Komponent jest połączony i można go używać jako rozszerzenia aplikacji mobilnej. |
HOTEL_CALLOUT |
Ten komponent jest połączony i może służyć jako rozszerzenie objaśnień dotyczących hoteli. |
CALL |
Ten komponent jest połączony i można go używać jako rozszerzenia połączeń. |
PRICE |
Ten komponent jest połączony i można go używać jako rozszerzenia cen. |
LONG_HEADLINE |
Komponent jest połączony i można go używać jako długiego nagłówka. |
BUSINESS_NAME |
Komponent został połączony i może służyć jako nazwa firmy. |
SQUARE_MARKETING_IMAGE |
Ten komponent jest połączony i można go używać jako kwadratowego obrazu marketingowego. |
PORTRAIT_MARKETING_IMAGE |
Ten komponent jest połączony i można go używać jako pionowego obrazu marketingowego. |
LOGO |
Ten zasób jest połączony i można go używać jako logo. |
LANDSCAPE_LOGO |
Zasób jest połączony i można go używać jako logo w orientacji poziomej. |
VIDEO |
Zasób jest połączony, aby można było używać go jako logo innego niż YouTube. |
CALL_TO_ACTION_SELECTION |
Komponent jest połączony i służy do wyboru wezwania do działania. |
AD_IMAGE |
Komponent jest połączony i służy do wyboru obrazu reklamy. |
BUSINESS_LOGO |
Ten komponent jest połączony i może służyć jako logo firmy. |
HOTEL_PROPERTY |
Komponent jest połączony i może służyć jako obiekt hotelowy w kampanii Performance Max do celów związanych z podróżami. |
DISCOVERY_CAROUSEL_CARD |
Zasób jest połączony i można go używać jako karty karuzeli Discovery. |
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.
Zapis JSON |
---|
{ "resourceName": string, "assetGroup": string, // Union field |
Pola | |
---|---|
resourceName |
Nazwa zasobu sygnału grupy plików. Nazwa zasobu sygnału grupy plików ma postać:
|
assetGroup |
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 |
Sygnał dotyczący odbiorców, który ma być używany w kampanii Performance Max. |
AudienceInfo
Kryterium odbiorców.
Zapis JSON |
---|
{ "audience": string } |
Pola | |
---|---|
audience |
Nazwa zasobu dotyczącego odbiorców. |
AssetGroupListingGroupFilter
AssetGroupListingGroupFilter reprezentuje węzeł drzewa filtra grupy informacji o produktach w grupie zasobów.
Zapis JSON |
---|
{ "resourceName": string, "assetGroup": string, "id": string, "type": enum ( |
Pola | |
---|---|
resourceName |
Nazwa zasobu filtra grupy informacji o produktach w grupie plików. Nazwa zasobu filtra grupy informacji o produktach w grupie plików ma postać:
|
assetGroup |
Grupa plików, do której należy ten filtr grupy informacji o produktach w grupie plików. |
id |
Identyfikator elementu ListingGroupFilter. |
type |
Typ węzła filtra grupy informacji o produktach. |
vertical |
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. |
caseValue |
Wartość wymiaru, za pomocą której ta grupa informacji o produktach ulepsza element nadrzędny. Nie zdefiniowano w grupie głównej. |
parentListingGroupFilter |
Nazwa zasobu w nadrzędnej grupie informacji o produktach. Wartość null dla głównego węzła filtra grupy informacji o produktach. |
path |
Ścieżka wymiarów definiujących ten filtr grupy informacji o produktach. |
ListingGroupFilterType
Typ filtra grupy informacji o produktach.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji. |
SUBDIVISION |
Podział produktów według niektórych wymiarów strony. |
UNIT_INCLUDED |
Dołączony węzeł liścia filtra grupy informacji o produktach. |
UNIT_EXCLUDED |
Wykluczony węzeł liścia filtra grupy informacji o produktach. |
ListingGroupFilterVertical
Typ branży filtra grupy informacji o produktach.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji. |
SHOPPING |
Reprezentuje branżę zakupów. Ta branża jest dozwolona tylko w kampaniach detalicznych Performance Max. |
ListingGroupFilterDimension
Wymiary informacji o produktach w ramach filtra grupy informacji o produktach w grupie plików.
Zapis JSON |
---|
{ // Union field |
Pola | |
---|---|
Pole sumy dimension . Wymiar jednego z poniższych typów zawsze jest obecny. dimension może być tylko jedną z tych wartości: |
|
productBiddingCategory |
Kategoria określania stawek oferty produktu. |
productBrand |
Marka oferty produktu. |
productChannel |
Lokalizacja oferty produktu. |
productCondition |
Stan oferty produktu. |
productCustomAttribute |
Atrybut niestandardowy oferty produktu. |
productItemId |
Identyfikator produktu w ofercie. |
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).
Zapis JSON |
---|
{
"level": enum ( |
Pola | |
---|---|
level |
Wskazuje poziom kategorii w taksonomii. |
id |
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. |
ListingGroupFilterBiddingCategoryLevel
Poziom kategorii ustalania stawek w grupie informacji o produktach.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji. |
LEVEL1 |
Poziom 1. |
LEVEL2 |
Poziom 2. |
LEVEL3 |
Poziom 3. |
LEVEL4 |
Poziom 4. |
LEVEL5 |
Poziom 5. |
ProductBrand
Marka produktu.
Zapis JSON |
---|
{ "value": string } |
Pola | |
---|---|
value |
Wartość ciągu znaków marki produktu. |
ProductChannel
Lokalizacja oferty produktu.
Zapis JSON |
---|
{
"channel": enum ( |
Pola | |
---|---|
channel |
Wartość lokalizacji. |
ListingGroupFilterProductChannel
Wartość Enum opisująca miejscowość oferty produktu.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji. |
ONLINE |
Produkt jest sprzedawany online. |
LOCAL |
Produkt jest sprzedawany w lokalnych sklepach. |
ProductCondition
Stan oferty produktu.
Zapis JSON |
---|
{
"condition": enum ( |
Pola | |
---|---|
condition |
Wartość warunku. |
ListingGroupFilterProductCondition
Wyliczenie opisujące stan oferty produktu.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji. |
NEW |
Stan produktu jest nowy. |
REFURBISHED |
Stan produktu jest odnowiony. |
USED |
Stan produktu jest używany. |
ProductCustomAttribute
Atrybut niestandardowy oferty produktu.
Zapis JSON |
---|
{
"index": enum ( |
Pola | |
---|---|
index |
Wskazuje indeks atrybutu niestandardowego. |
value |
Wartość ciągu znaków niestandardowego atrybutu produktu. |
ListingGroupFilterCustomAttributeIndex
Indeks atrybutów klienta.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji. |
INDEX0 |
Atrybut niestandardowy filtra pierwszej grupy informacji o produktach. |
INDEX1 |
Drugi atrybut niestandardowy filtra grupy informacji o produktach. |
INDEX2 |
Atrybut niestandardowy filtra grupy informacji o produktach. |
INDEX3 |
Czwarta grupa informacji o produktach – atrybut niestandardowy filtra grupy informacji o produktach. |
INDEX4 |
Atrybut niestandardowy filtra piątej grupy informacji o produktach. |
ProductItemId
Identyfikator produktu w ofercie.
Zapis JSON |
---|
{ "value": string } |
Pola | |
---|---|
value |
Wartość identyfikatora. |
ProductType
Typ oferty produktu.
Zapis JSON |
---|
{
"level": enum ( |
Pola | |
---|---|
level |
Poziom typu. |
value |
Wartość typu. |
ListingGroupFilterProductTypeLevel
Wyliczenie opisujące poziom typu oferty produktu.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji. |
LEVEL1 |
Poziom 1. |
LEVEL2 |
Poziom 2. |
LEVEL3 |
Poziom 3. |
LEVEL4 |
Poziom 4. |
LEVEL5 |
Poziom 5. |
ListingGroupFilterDimensionPath
Ścieżka definiująca wymiary definiujące filtr grupy informacji o produktach.
Zapis JSON |
---|
{
"dimensions": [
{
object ( |
Pola | |
---|---|
dimensions[] |
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. |
AssetGroupTopCombinationView
Widok wykorzystania kombinacji komponentów reklamy w grupie reklam.
Zapis JSON |
---|
{
"resourceName": string,
"assetGroupTopCombinations": [
{
object ( |
Pola | |
---|---|
resourceName |
Nazwa zasobu grupy plików w widoku najpopularniejszych kombinacji. Nazwy zasobów widoku danych najważniejszych kombinacji zasobów mają postać: `"customers/{customerId}/assetGroupTopCombinationViews/{identyfikator_grupy_zasobów}~{asset_combination_category}" |
assetGroupTopCombinations[] |
Najpopularniejsze kombinacje komponentów, które wyświetlały się razem. |
AssetGroupAssetCombinationData
Grupa plików – dane kombinacji komponentów
Zapis JSON |
---|
{
"assetCombinationServedAssets": [
{
object ( |
Pola | |
---|---|
assetCombinationServedAssets[] |
Wyświetlane komponenty. |
AssetUsage
Zawiera informacje o wykorzystaniu zasobu.
Zapis JSON |
---|
{
"asset": string,
"servedAssetFieldType": enum ( |
Pola | |
---|---|
asset |
Nazwa zasobu. |
servedAssetFieldType |
Typ wyświetlanego pola zasobu. |
ServedAssetFieldType
Możliwe typy pól zasobu.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono wartości. |
UNKNOWN |
Otrzymana wartość nie jest znana w tej wersji. To jest wartość tylko z odpowiedzią. |
HEADLINE_1 |
Komponent jest używany w nagłówku 1. |
HEADLINE_2 |
Komponent jest używany w nagłówku 2. |
HEADLINE_3 |
Komponent jest używany w nagłówku 3. |
DESCRIPTION_1 |
Zasób jest używany w tekście reklamy 1. |
DESCRIPTION_2 |
Zasób jest używany w tekście reklamy 2. |
HEADLINE |
Komponent został użyty w nagłówku. Używaj jej tylko wtedy, gdy reklama ma tylko 1 nagłówek. W przeciwnym razie użyj wyliczeń HEADLINE_1, HEADLINE_2 lub HEADLINE_3 |
HEADLINE_IN_PORTRAIT |
Komponent był używany jako nagłówek w obrazie pionowym. |
LONG_HEADLINE |
Komponent został użyty w długim nagłówku (w reklamie MultiAssetelastycznie). |
DESCRIPTION |
Zasób został użyty w tekście reklamy. Używaj jej tylko wtedy, gdy w reklamie jest tylko 1 tekst reklamy. W przeciwnym razie użyj wyliczeń DESCRIPTION_1 lub DESCRIPTION_@ |
DESCRIPTION_IN_PORTRAIT |
Komponent został użyty jako tekst reklamy w orientacji pionowej. |
BUSINESS_NAME_IN_PORTRAIT |
Komponent został użyty jako nazwa firmy w obrazie pionowym. |
BUSINESS_NAME |
Komponent służył jako nazwa firmy. |
MARKETING_IMAGE |
Komponent został użyty jako obraz marketingowy. |
MARKETING_IMAGE_IN_PORTRAIT |
Komponent został użyty jako obraz marketingowy w orientacji pionowej. |
SQUARE_MARKETING_IMAGE |
Komponent został użyty jako kwadratowy obraz marketingowy. |
PORTRAIT_MARKETING_IMAGE |
Komponent został użyty jako pionowy obraz marketingowy. |
LOGO |
Zasób był używany jako logo. |
LANDSCAPE_LOGO |
Zasób był używany jako logo w orientacji poziomej. |
CALL_TO_ACTION |
Komponent został użyty jako wezwanie do działania. |
YOU_TUBE_VIDEO |
Zasób był używany jako film w YouTube. |
SITELINK |
Ten komponent jest używany jako link do podstrony. |
CALL |
Ten komponent jest używany jako połączenie. |
MOBILE_APP |
Ten komponent jest używany jako aplikacja mobilna. |
CALLOUT |
Ten komponent jest używany jako objaśnienie. |
STRUCTURED_SNIPPET |
Ten komponent jest używany jako rozszerzenie informacji. |
PRICE |
Ten komponent jest używany jako cena. |
PROMOTION |
Ten komponent jest używany jako promocja. |
AD_IMAGE |
Ten komponent jest używany jako obraz. |
LEAD_FORM |
Komponent jest używany jako formularz kontaktowy. |
BUSINESS_LOGO |
Komponent służy jako logo firmy. |
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.
Zapis JSON |
---|
{ "resourceName": string, "id": string, "campaign": string, "name": string, "finalUrls": [ string ], "finalMobileUrls": [ string ], "status": enum ( |
Pola | |
---|---|
resourceName |
Nazwa zasobu grupy zasobów. Nazwy zasobów grupy plików mają postać:
|
id |
Identyfikator grupy plików. |
campaign |
Kampania, z którą ta grupa plików jest powiązana. Komponent połączony z grupą plików. |
name |
Wymagane. Nazwa grupy plików. Wymagane. Musi mieć minimalną długość 1 i maksymalną 128 znaków. Musi być niepowtarzalna w ramach kampanii. |
finalUrls[] |
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. |
finalMobileUrls[] |
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 |
Stan grupy plików. |
path1 |
Pierwsza część tekstu, który może się pojawić jako dołączony do adresu URL wyświetlanego w reklamie. |
path2 |
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. |
adStrength |
Ogólna skuteczność reklamy w tej grupie plików. |
AssetGroupStatus
Możliwe stany grupy plików.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Stan nie został określony. |
UNKNOWN |
Otrzymana wartość nie jest znana w tej wersji. |
ENABLED |
Grupa plików jest włączona. |
PAUSED |
Grupa plików jest wstrzymana. |
REMOVED |
Grupa plików została usunięta. |
AdStrength
Wymienić możliwe skuteczność reklamy.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji. |
PENDING |
Skuteczność reklamy jest obecnie oczekująca. |
NO_ADS |
Nie udało się wygenerować reklam. |
POOR |
Słaba siła. |
AVERAGE |
Średnia siła. |
GOOD |
Dobra siła. |
EXCELLENT |
Doskonała siła. |
AssetSetAsset
AssetSetAsset to połączenie między zasobem a zestawem zasobów. Dodanie komponentu AssetSetAsset powoduje połączenie zasobu z zestawem zasobów.
Zapis JSON |
---|
{
"resourceName": string,
"assetSet": string,
"asset": string,
"status": enum ( |
Pola | |
---|---|
resourceName |
Nazwa zasobu zestawu zasobów. Nazwy zasobów zestawu zasobów mają postać:
|
assetSet |
Zestaw komponentów, z którym jest połączony ten zestaw. |
asset |
Zasób, z którym jest połączony ten zestaw zasobów. |
status |
Stan zasobu zestawu komponentów. Tylko do odczytu. |
AssetSetAssetStatus
Możliwe stany komponentu w zestawie komponentów.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Stan nie został określony. |
UNKNOWN |
Otrzymana wartość nie jest znana w tej wersji. To jest wartość tylko z odpowiedzią. |
ENABLED |
Komponent w zestawie jest włączony. |
REMOVED |
Komponent z zestawu komponentów został usunięty. |
AssetSet
Zbiór zasobów reprezentujący zbiór zasobów. Użyj AssetSetAsset, aby połączyć zasób z zestawem zasobów.
Zapis JSON |
---|
{ "id": string, "resourceName": string } |
Pola | |
---|---|
id |
Identyfikator zestawu zasobów. |
resourceName |
Nazwa zasobu zestawu zasobów. Nazwy zasobów zestawu zasobów mają postać:
|
BiddingStrategy
Strategia ustalania stawek.
Zapis JSON |
---|
{ "resourceName": string, "status": enum ( |
Pola | |
---|---|
resourceName |
Nazwa zasobu strategii ustalania stawek. Nazwy zasobów strategii ustalania stawek mają postać:
|
status |
Stan strategii ustalania stawek. To pole jest tylko do odczytu. |
type |
Typ strategii ustalania stawek. Utwórz strategię ustalania stawek, ustawiając schemat ustalania stawek. To pole jest tylko do odczytu. |
currencyCode |
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 „effectiveCurrencyCode” zwraca walutę używaną przez strategię. |
id |
Identyfikator strategii ustalania stawek. |
name |
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). |
effectiveCurrencyCode |
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 kod waluty klienta. Dane strategii ustalania stawek są raportowane w tej walucie. To pole jest tylko do odczytu. |
campaignCount |
Liczba kampanii powiązanych z tą strategią ustalania stawek. To pole jest tylko do odczytu. |
nonRemovedCampaignCount |
Liczba nieusuniętych kampanii powiązanych z tą strategią ustalania stawek. To pole jest tylko do odczytu. |
Pole sumy Można ustawić tylko jedną opcję. |
|
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. |
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. |
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. |
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). |
targetImpressionShare |
Strategia ustalania stawek, która automatycznie optymalizuje stawki pod kątem określonego odsetka wyświetleń. |
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. |
targetRoas |
Strategia ustalania stawek, która pomaga zmaksymalizować przychody przy średnim docelowym zwrocie z nakładów na reklamę (ROAS). |
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. |
BiddingStrategyStatus
Możliwe stany strategii ustalania stawek.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono wartości. |
UNKNOWN |
Otrzymana wartość nie jest znana w tej wersji. To jest wartość tylko z odpowiedzią. |
ENABLED |
Strategia ustalania stawek jest włączona. |
REMOVED |
Strategia ustalania stawek została usunięta. |
BiddingStrategyType
Wyliczenie opisujące możliwe typy strategii ustalania stawek.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji. |
COMMISSION |
Prowizja to strategia automatycznego określania stawek, w której reklamodawca płaci pewną część wartości konwersji. |
ENHANCED_CPC |
Ulepszony CPC to strategia ustalania stawek, która podnosi stawki za kliknięcia, w przypadku których prawdopodobieństwo konwersji jest większe, i obniża je tam, gdzie są mniej prawdopodobne. |
INVALID |
Używana tylko w przypadku wartości zwracanej. Oznacza, że kampania nie ma strategii ustalania stawek. Uniemożliwia to wyświetlanie reklam z kampanii. Kampania może być np. powiązana ze strategią ustalania stawek menedżera, a konto wyświetlania reklam zostanie odłączone od konta menedżera. W takim przypadku kampania zostanie automatycznie odłączona od strategii ustalania stawek, która jest obecnie niedostępna na koncie menedżera, i przejdzie na NIEPRAWIDŁOWY typ strategii ustalania stawek. |
MANUAL_CPA |
Strategia samodzielnego ustawiania stawek, która pozwala reklamodawcy ustawić stawkę za działanie określone przez reklamodawcę. |
MANUAL_CPC |
Samodzielne określanie stawek na podstawie kliknięć, w którym użytkownik płaci za kliknięcie. |
MANUAL_CPM |
Samodzielne określanie stawek na podstawie wyświetleń, w którym użytkownik płaci za tysiąc wyświetleń. |
MANUAL_CPV |
Strategia ustalania stawek, w której za wyświetlenie filmu można ustawić określoną kwotę. |
MAXIMIZE_CONVERSIONS |
Strategia ustalania stawek, która automatycznie maksymalizuje liczbę konwersji przy danym budżecie dziennym. |
MAXIMIZE_CONVERSION_VALUE |
Strategia automatycznego określania stawek, która automatycznie ustala stawki tak, aby zmaksymalizować przychody w ramach określonego budżetu. |
PAGE_ONE_PROMOTED |
Schemat ustalania stawek za promocję na pierwszej stronie, który ustawia maksymalne stawki CPC pod kątem kierowania na wyświetlenia na pierwszej stronie lub na pierwszej stronie promowanych boksów w witrynie google.com. Ta wartość wyliczenia została wycofana. |
PERCENT_CPC |
Procent CPC to strategia ustalania stawek, w której stawki są ułamkiem reklamowanej ceny za dany towar lub usługę. |
TARGET_CPA |
Docelowy CPA to 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). |
TARGET_CPM |
Docelowy CPM to strategia automatycznego określania stawek, która ustala stawki w taki sposób, by pomóc Ci uzyskać jak największą liczbę wyświetleń przy wybranym przez Ciebie docelowym koszcie tysiąca wyświetleń (CPM). |
TARGET_IMPRESSION_SHARE |
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). |
TARGET_OUTRANK_SHARE |
Docelowy udział w wygranych aukcjach to strategia automatycznego określania stawek, która ustala stawki na podstawie docelowego odsetka aukcji, w których reklamodawca powinien przelicytować określonego konkurenta. Ta wartość wyliczenia została wycofana. |
TARGET_ROAS |
Docelowy ROAS to strategia automatycznego określania stawek, która pomaga zmaksymalizować przychody przy średnim docelowym zwrocie z nakładów na reklamę (ROAS). |
TARGET_SPEND |
Docelowe wydatki to strategia automatycznego określania stawek, która ustala stawki w taki sposób, by zapewniać jak najwięcej kliknięć w ramach ustalonego budżetu. |
EnhancedCpc
Ten typ nie ma żadnych pól.
Strategia automatycznego określania 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.
Ta strategia ustalania stawek została wycofana i nie można jej już utworzyć. Aby uzyskać równoważną funkcjonalność, użyj zasady ManualCpc z parametrem EnhancedCpcEnabled ustawionym na wartość true.
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.
Zapis JSON |
---|
{ "cpcBidCeilingMicros": string, "cpcBidFloorMicros": string, "targetRoas": number } |
Pola | |
---|---|
cpcBidCeilingMicros |
Maksymalna stawka, jaką może ustawić strategia ustalania stawek. Limit dotyczy wszystkich słów kluczowych zarządzanych przez strategię. Zmienne tylko w przypadku strategii portfolio ustalania stawek. |
cpcBidFloorMicros |
Limit minimalnej stawki, który może ustawić strategia ustalania stawek. Limit dotyczy wszystkich słów kluczowych zarządzanych przez strategię. Zmienne tylko w przypadku strategii portfolio ustalania stawek. |
targetRoas |
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.
Zapis JSON |
---|
{ "cpcBidCeilingMicros": string, "cpcBidFloorMicros": string, "targetCpaMicros": string } |
Pola | |
---|---|
cpcBidCeilingMicros |
Maksymalna stawka, jaką może ustawić strategia ustalania stawek. Limit dotyczy wszystkich słów kluczowych zarządzanych przez strategię. Zmienne tylko w przypadku strategii portfolio ustalania stawek. |
cpcBidFloorMicros |
Limit minimalnej stawki, który może ustawić strategia ustalania stawek. Limit dotyczy wszystkich słów kluczowych zarządzanych przez strategię. Zmienne tylko w przypadku strategii portfolio ustalania stawek. |
targetCpaMicros |
Opcja docelowego kosztu działania (CPA). Jest to średnia kwota, jaką chcesz wydać na działanie powodujące konwersję, podana w mikrojednostkach waluty strategii ustalania stawek. Jeśli ją skonfigurujesz, strategia ustalania stawek będzie uzyskiwać jak najwięcej konwersji przy docelowym lub niższym koszcie działania. W przeciwnym razie strategia ustalania stawek będzie dążyć do uzyskania jak najniższego CPA w ramach budżetu. |
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).
Zapis JSON |
---|
{ "targetCpaMicros": string, "cpcBidCeilingMicros": string, "cpcBidFloorMicros": string } |
Pola | |
---|---|
targetCpaMicros |
Ś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. |
cpcBidCeilingMicros |
Maksymalna stawka, jaką może ustawić strategia ustalania stawek. Limit dotyczy wszystkich słów kluczowych zarządzanych przez strategię. To ustawienie należy ustawić tylko w przypadku strategii portfolio ustalania stawek. |
cpcBidFloorMicros |
Limit minimalnej stawki, który może ustawić strategia ustalania stawek. Limit dotyczy wszystkich słów kluczowych zarządzanych przez strategię. To ustawienie należy ustawić tylko w przypadku strategii portfolio ustalania stawek. |
TargetRoas
Strategia automatycznego określania stawek, która pomaga zmaksymalizować przychody przy średnim docelowym zwrocie z nakładów na reklamę (ROAS).
Zapis JSON |
---|
{ "targetRoas": number, "cpcBidCeilingMicros": string, "cpcBidFloorMicros": string } |
Pola | |
---|---|
targetRoas |
Wymagane. Wybrane przychody (na podstawie danych o konwersjach) na jednostkę wydatków. Wartość musi mieścić się w zakresie od 0,01 do 1000,0 włącznie. |
cpcBidCeilingMicros |
Maksymalna stawka, jaką może ustawić strategia ustalania stawek. Limit dotyczy wszystkich słów kluczowych zarządzanych przez strategię. To ustawienie należy ustawić tylko w przypadku strategii portfolio ustalania stawek. |
cpcBidFloorMicros |
Limit minimalnej stawki, który może ustawić strategia ustalania stawek. Limit dotyczy wszystkich słów kluczowych zarządzanych przez strategię. To ustawienie należy ustawić tylko w przypadku strategii portfolio ustalania stawek. |
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.
Zapis JSON |
---|
{ "targetSpendMicros": string, "cpcBidCeilingMicros": string } |
Pola | |
---|---|
targetSpendMicros |
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. |
cpcBidCeilingMicros |
Maksymalna stawka, jaką może ustawić strategia ustalania stawek. Limit dotyczy wszystkich słów kluczowych zarządzanych przez strategię. |
CampaignBudget
Budżet kampanii.
Zapis JSON |
---|
{ "resourceName": string, "deliveryMethod": enum ( |
Pola | |
---|---|
resourceName |
Nazwa zasobu budżetu kampanii. Nazwy zasobów budżetu kampanii mają postać:
|
deliveryMethod |
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 |
Okres, w którym zostanie wykorzystany budżet. Jeśli nie zostanie określony, przyjmuje się, że domyślnie jest to DAILY. |
amountMicros |
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. |
BudgetDeliveryMethod
Możliwe metody wyświetlania budżetu.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji. |
STANDARD |
Serwer budżetu będzie ograniczać wyświetlanie równomiernie w całym okresie. |
ACCELERATED |
Serwer budżetu nie będzie ograniczać wyświetlania reklam, a reklamy będą wyświetlać się tak szybko, jak to możliwe. |
BudgetPeriod
Potencjalny okres budżetu.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji. |
DAILY |
Budżet dzienny. |
FIXED_DAILY |
Stały budżet dzienny. |
CUSTOM_PERIOD |
Budżetu niestandardowego można użyć z wartością total_amount, aby określić limit czasu trwania budżetu. |
Priorytet
Kampania.
Zapis JSON |
---|
{ "resourceName": string, "status": enum ( |
Pola | |
---|---|
resourceName |
Nazwa zasobu kampanii. Nazwy zasobów kampanii mają postać:
|
status |
Stan kampanii. Po dodaniu nowej kampanii jej stan przyjmuje domyślnie wartość WŁĄCZONA. |
servingStatus |
Stan wyświetlania reklam w kampanii. |
biddingStrategySystemStatus |
Stan systemowy strategii ustalania stawek w kampanii. |
adServingOptimizationStatus |
Stan optymalizacji wyświetlania reklam w kampanii. |
advertisingChannelType |
Główny cel wyświetlania reklam w kampanii. Opcje kierowania można zawęzić tutaj: 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. |
advertisingChannelSubType |
Opcjonalne zawężenie wyszukiwania do: To ustawienie można skonfigurować tylko podczas tworzenia kampanii. Po utworzeniu kampanii nie można zmienić tego pola. |
urlCustomParameters[] |
Lista mapowań używanych do zastępowania tagów parametrów niestandardowych w tagach |
realTimeBiddingSetting |
Ustawienia określania stawek w czasie rzeczywistym – to funkcja dostępna tylko w kampaniach kierowanych na sieć Ad Exchange. |
networkSettings |
Ustawienia sieci dla kampanii. |
dynamicSearchAdsSetting |
Ustawienie do kontrolowania dynamicznych reklam w wyszukiwarce. |
shoppingSetting |
Ustawienie do kontrolowania kampanii produktowych. |
geoTargetTypeSetting |
Ustawienie kierowania geograficznego reklam. |
labels[] |
Nazwy zasobów etykiet dołączonych do tej kampanii. |
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 To pole jest tylko do odczytu. |
accessibleBiddingStrategy |
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 strategię ustalania stawek „biddingStrategy”. 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. |
frequencyCaps[] |
Lista ograniczająca częstotliwość, z jaką każdy użytkownik może oglądać reklamy z tej kampanii. |
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. |
optimizationGoalSetting |
Ustawienie celu optymalizacji tej kampanii z zestawem typów celów optymalizacji. |
trackingSetting |
Ustawienia śledzenia informacji na poziomie kampanii. |
engineId |
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”. |
excludedParentAssetFieldTypes[] |
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. |
createTime |
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 parametr createTime zostanie wycofany. Zamiast tego użyj parametru createTime. |
creationTime |
Sygnatura czasowa utworzenia tej kampanii. Sygnatura czasowa jest podana w strefie czasowej klienta i w formacie „rrrr-MM-dd GG:mm:ss”. |
lastModifiedTime |
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 |
Identyfikator kampanii. |
name |
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). |
trackingUrlTemplate |
Szablon adresu URL służący do tworzenia linku monitorującego. |
campaignBudget |
Budżet kampanii. |
startDate |
Data rozpoczęcia kampanii w strefie czasowej klienta podana w formacie RRRR-MM-DD. |
endDate |
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. |
finalUrlSuffix |
Sufiks używany do dołączania parametrów zapytania do stron docelowych wyświetlanych przy użyciu śledzenia równoległego. |
urlExpansionOptOut |
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 Musi być portfolio (utworzonym w usłudze ustalania stawek) lub standardowym umieszczonym w kampanii. |
|
biddingStrategy |
Strategia portfolio ustalania stawek używana przez kampanię. |
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. |
manualCpc |
standardowa strategia samodzielnego ustawiania stawek CPC. Samodzielne określanie stawek na podstawie kliknięć, w którym użytkownik płaci za kliknięcie. |
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ń. |
maximizeConversions |
Standardowa strategia ustalania stawek pod kątem maksymalizacji liczby konwersji, która automatycznie maksymalizuje liczbę konwersji w ramach określonego budżetu. |
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. |
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). |
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ń. |
targetRoas |
Standardowa strategia ustalania stawek Docelowy ROAS, która automatycznie maksymalizuje przychody przy średnim docelowym zwrocie z nakładów na reklamę (ROAS). |
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. |
percentCpc |
Standardowa strategia ustalania stawek CPC (w %), w której stawki stanowią ułamek reklamowanej ceny za dany towar lub usługę. |
targetCpm |
Strategia ustalania stawek, która automatycznie optymalizuje koszt tysiąca wyświetleń |
CampaignStatus
Możliwy stan kampanii.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji. |
ENABLED |
Kampania jest aktywna i może wyświetlać reklamy. |
PAUSED |
Kampania została wstrzymana przez użytkownika. |
REMOVED |
Kampania została usunięta. |
CampaignServingStatus
Możliwe stany wyświetlania reklam z kampanii.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono wartości. |
UNKNOWN |
Otrzymana wartość nie jest znana w tej wersji. To jest wartość tylko z odpowiedzią. |
SERVING |
Obsługa. |
NONE |
Brak. |
ENDED |
Zakończono. |
PENDING |
Oczekiwanie. |
SUSPENDED |
Zawieszony. |
BiddingStrategySystemStatus
Możliwe stany systemu strategii ustalania stawek.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Sygnały, że wystąpił nieoczekiwany błąd, np. nie znaleziono typu strategii ustalania stawek lub nie znaleziono informacji o stanie. |
UNKNOWN |
Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji. |
ENABLED |
Strategia ustalania stawek jest aktywna, AdWords nie znajduje w niej żadnych konkretnych problemów. |
LEARNING_NEW |
Strategia ustalania stawek się uczy, ponieważ została niedawno utworzona lub niedawno ponownie aktywowana. |
LEARNING_SETTING_CHANGE |
Strategia ustalania stawek się uczy z powodu niedawnej zmiany ustawienia. |
LEARNING_BUDGET_CHANGE |
Strategia ustalania stawek się uczy z powodu niedawnej zmiany w budżecie. |
LEARNING_COMPOSITION_CHANGE |
Strategia ustalania stawek się uczy z powodu niedawnej zmiany liczby powiązanych z nią kampanii, grup reklam lub słów kluczowych. |
LEARNING_CONVERSION_TYPE_CHANGE |
Strategia ustalania stawek korzysta z raportów o konwersjach oraz typów konwersji, które ostatnio zmodyfikował klient, które pasowały do tej strategii. |
LEARNING_CONVERSION_SETTING_CHANGE |
Strategia ustalania stawek działa na podstawie raportowania konwersji, a klient niedawno zmienił ustawienia konwersji. |
LIMITED_BY_CPC_BID_CEILING |
Strategia ustalania stawek jest ograniczona przez limit stawki. |
LIMITED_BY_CPC_BID_FLOOR |
Strategia ustalania stawek jest ograniczona przez dolną stawkę. |
LIMITED_BY_DATA |
Strategia ustalania stawek jest ograniczona, ponieważ w ostatnich tygodniach liczba konwersji była niewystarczająca. |
LIMITED_BY_BUDGET |
Znaczna część słów kluczowych w tej strategii ustalania stawek jest ograniczona przez budżet. |
LIMITED_BY_LOW_PRIORITY_SPEND |
Strategia ustalania stawek nie może osiągnąć docelowych wydatków, ponieważ priorytet wydatków został obniżony. |
LIMITED_BY_LOW_QUALITY |
Znaczna część słów kluczowych w tej strategii ustalania stawek ma niski wynik jakości. |
LIMITED_BY_INVENTORY |
Strategia ustalania stawek nie może w pełni wykorzystać budżetu z powodu wąskiego kierowania. |
MISCONFIGURED_ZERO_ELIGIBILITY |
Brak śledzenia konwersji (brak pingów) lub listy remarketingowe dla inteligentnych kampanii produktowych. |
MISCONFIGURED_CONVERSION_TYPES |
Strategia ustalania stawek korzysta z raportowania konwersji, a klientowi brakuje typów konwersji, które mogłyby zostać uwzględnione w raportach dotyczących tej strategii. |
MISCONFIGURED_CONVERSION_SETTINGS |
Strategia ustalania stawek korzysta z raportowania konwersji, a ustawienia konwersji klienta są nieprawidłowo skonfigurowane. |
MISCONFIGURED_SHARED_BUDGET |
Istnieją kampanie spoza strategii ustalania stawek, które korzystają z budżetu wspólnego z kampaniami objętymi tą strategią. |
MISCONFIGURED_STRATEGY_TYPE |
Kampania ma nieprawidłowy typ strategii i nie wyświetla reklam. |
PAUSED |
Strategia ustalania stawek nie jest aktywna. Ze strategią ustalania stawek nie są powiązane żadne aktywne kampanie, grupy reklam ani słowa kluczowe. Strategia ustalania stawek nie ma też żadnych aktywnych budżetów. |
UNAVAILABLE |
Ta strategia ustalania stawek nie obsługuje obecnie raportowania stanu. |
MULTIPLE_LEARNING |
W okresie, o którym mowa, ta strategia ustalania stawek miała kilka LEARNING_* stanów systemu. |
MULTIPLE_LIMITED |
W okresie, o którym mowa, ta strategia ustalania stawek miała kilka LIMITED_* stanów systemu. |
MULTIPLE_MISCONFIGURED |
W okresie, o którym była mowa w danej strategii ustalania stawek, wystąpiło kilka stanów MISCONFIGURED_* w systemie. |
MULTIPLE |
W wybranym okresie ta strategia ustalania stawek miała kilka stanów systemu. |
AdServingOptimizationStatus
Wyliczenie opisujące możliwe stany wyświetlania.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono wartości. |
UNKNOWN |
Otrzymana wartość nie jest znana w tej wersji. To jest wartość tylko z odpowiedzią. |
OPTIMIZE |
Wyświetlanie reklam jest optymalizowane na podstawie CTR kampanii. |
CONVERSION_OPTIMIZE |
Wyświetlanie reklam jest optymalizowane na podstawie CTR * konwersji w kampanii. Jeśli kampania nie korzysta ze strategii ustalania stawek optymalizatora konwersji, domyślnie zostanie ustawiona opcja OPTYMALIZACJA. |
ROTATE |
Reklamy są wyświetlane naprzemiennie przez 90 dni, a następnie optymalizowane pod kątem kliknięć. |
ROTATE_INDEFINITELY |
Równomiernie wyświetlaj mniej skuteczne reklamy z reklamami skuteczniejszymi i nie optymalizuj. |
UNAVAILABLE |
Stan optymalizacji wyświetlania reklam jest niedostępny. |
AdvertisingChannelType
Wyliczenie opisujące różne typy kanałów reklamowych.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji. |
SEARCH |
Sieć wyszukiwania. Obejmuje kampanie w sieci reklamowej i kampanie w sieci wyszukiwania+. |
DISPLAY |
Tylko sieć reklamowa Google. |
SHOPPING |
Kampanie produktowe wyświetlają reklamy w usłudze produktowej i w wynikach wyszukiwania na google.com. |
HOTEL |
kampanii reklam hoteli. |
VIDEO |
Kampanie wideo. |
MULTI_CHANNEL |
Kampanie promujące aplikacje i kampanie budujące zaangażowanie w aplikacje, które działają w wielu kanałach. |
LOCAL |
Lokalne kampanie reklamowe. |
SMART |
Kampanie inteligentne. |
PERFORMANCE_MAX |
Kampanie Performance Max. |
LOCAL_SERVICES |
Kampanie w Usługach Lokalnych. |
DISCOVERY |
Kampanie Discovery. |
TRAVEL |
Kampanie dotyczące podróży. |
AdvertisingChannelSubType
Wyliczenie opisujące różne podtypy kanałów.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Jest używana tylko jako wartość zwrotna. Reprezentuje wartość nieznaną w tej wersji. |
SEARCH_MOBILE_APP |
Kampanie promujące aplikacje mobilne w sieci wyszukiwania. |
DISPLAY_MOBILE_APP |
Kampanie promujące aplikacje mobilne w sieci reklamowej. |
SEARCH_EXPRESS |
Kampanie AdWords Express w sieci wyszukiwania. |
DISPLAY_EXPRESS |
Kampanie AdWords Express w sieci reklamowej. |
SHOPPING_SMART_ADS |
Inteligentne kampanie produktowe. |
DISPLAY_GMAIL_AD |
Kampanie reklamowe w Gmailu. |
DISPLAY_SMART_CAMPAIGN |
Inteligentne kampanie w sieci reklamowej. Nie można tworzyć nowych kampanii tego podtypu. |
VIDEO_OUTSTREAM |
Kampanie wideo Out-Stream. |
VIDEO_ACTION |
Kampanie wideo TrueView zachęcające do działania. |
VIDEO_NON_SKIPPABLE |
Kampanie wideo z reklamami wideo niemożliwymi do pominięcia. |
APP_CAMPAIGN |
Kampania promująca aplikację, która ułatwia promowanie aplikacji na Androida lub iOS w najważniejszych usługach Google, takich jak wyszukiwarka, Google Play, YouTube i sieć reklamowa Google. |
APP_CAMPAIGN_FOR_ENGAGEMENT |
Kampania budująca zaangażowanie w aplikację, która koncentruje się na zachęcaniu do ponownego zaangażowania w aplikację w kilku najpopularniejszych usługach Google, m.in. w wyszukiwarce, YouTube i sieci reklamowej Google. |
LOCAL_CAMPAIGN |
Kampanie specjalizujące się w reklamie lokalnej. |
SHOPPING_COMPARISON_LISTING_ADS |
kampanii produktowych z porównaniem informacji o produktach. |
SMART_CAMPAIGN |
standardowych kampanii inteligentnych. |
VIDEO_SEQUENCE |
Kampanie wideo z sekwencyjnymi reklamami wideo. |
APP_CAMPAIGN_FOR_PRE_REGISTRATION |
Kampania promująca aplikację z wcześniejszą rejestracją, specjalizująca się w reklamowaniu wcześniejszej rejestracji na aplikację mobilną, kierowana na wiele kanałów reklamowych w Google Play, YouTube i sieci reklamowej. |
VIDEO_REACH_TARGET_FREQUENCY |
Kampania wideo typu „Zasięg” ze strategią ustalania stawek pod kątem docelowej częstotliwości. |
TRAVEL_ACTIVITIES |
kampanii dotyczących podróży. |
CustomParameter
Mapowanie, którego można używać przez tagi parametrów niestandardowych w obrębie trackingUrlTemplate
, finalUrls
lub mobile_final_urls
.
Zapis JSON |
---|
{ "key": string, "value": string } |
Pola | |
---|---|
key |
Klucz pasujący do nazwy tagu parametru. |
value |
Wartość do zastąpienia. |
RealTimeBiddingSetting
Ustawienia określania stawek w czasie rzeczywistym – to funkcja dostępna tylko w kampaniach kierowanych na sieć Ad Exchange.
Zapis JSON |
---|
{ "optIn": boolean } |
Pola | |
---|---|
optIn |
Określa, czy kampania ma włączone określanie stawek w czasie rzeczywistym. |
NetworkSettings
Ustawienia sieci dla kampanii.
Zapis JSON |
---|
{ "targetGoogleSearch": boolean, "targetSearchNetwork": boolean, "targetContentNetwork": boolean, "targetPartnerSearchNetwork": boolean } |
Pola | |
---|---|
targetGoogleSearch |
Określa, czy reklamy będą wyświetlane w wynikach wyszukiwania w domenie google.pl. |
targetSearchNetwork |
Określa, czy reklamy będą wyświetlane w witrynach partnerów w sieci wyszukiwania Google (wymagany parametr |
targetContentNetwork |
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. |
targetPartnerSearchNetwork |
Czy reklamy mają być wyświetlane w sieci partnerów Google. Ta funkcja jest dostępna tylko na wybranych kontach partnerów Google. |
DynamicSearchAdsSetting
Ustawienie do kontrolowania dynamicznych reklam w wyszukiwarce.
Zapis JSON |
---|
{ "domainName": string, "languageCode": string, "useSuppliedUrlsOnly": boolean } |
Pola | |
---|---|
domainName |
Wymagane. Nazwa domeny internetowej reprezentowana przez to ustawienie, na przykład „google.com” lub „www.google.com”. |
languageCode |
Wymagane. Kod języka określający język domeny, np. „pl”. |
useSuppliedUrlsOnly |
Wskazuje, czy w kampanii są używane wyłącznie adresy URL dostarczone przez reklamodawcę. |
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.
Zapis JSON |
---|
{ "feedLabel": string, "useVehicleInventory": boolean, "merchantId": string, "salesCountry": string, "campaignPriority": integer, "enableLocal": boolean } |
Pola | |
---|---|
feedLabel |
Etykieta pliku danych z produktami do dodania do kampanii. Można ustawić tylko jedną etykietę pliku danych lub kraj sprzedaży. Jeśli zostanie użyte zamiast parametru SalesCountry, pole FeedLabel akceptuje 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. |
useVehicleInventory |
Określa, czy kierowanie na wykaz pojazdów. |
merchantId |
Identyfikator konta Merchant Center. To pole jest wymagane do operacji tworzenia. W przypadku kampanii produktowych tego pola nie można zmienić. |
salesCountry |
Kraj sprzedaży produktów, które chcesz uwzględnić w kampanii. |
campaignPriority |
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. |
enableLocal |
Określa, czy uwzględniać produkty dostępne lokalnie. |
GeoTargetTypeSetting
Reprezentuje zbiór ustawień związanych z kierowaniem geograficznym reklam.
Zapis JSON |
---|
{ "positiveGeoTargetType": enum ( |
Pola | |
---|---|
positiveGeoTargetType |
Ustawienie używane do kierowania geograficznego w tej konkretnej kampanii. |
negativeGeoTargetType |
Ustawienie używane do wykluczającego kierowania geograficznego w tej konkretnej kampanii. |
PositiveGeoTargetType
Możliwe typy niewykluczających celów geograficznych.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Wartość jest nieznana w tej wersji. |
PRESENCE_OR_INTEREST |
Określa, że reklama ma się wyświetlić, gdy użytkownik znajduje się w wybranych lokalizacjach reklamodawcy lub się nimi interesuje. |
SEARCH_INTEREST |
Określa, że reklama jest wyświetlana, gdy użytkownik wyszukuje wybrane lokalizacje reklamodawcy. Tej opcji można używać tylko w kampaniach w sieci wyszukiwania i standardowych kampaniach produktowych. |
PRESENCE |
Określa, że reklama jest wyświetlana, gdy użytkownik znajduje się w wybranych lokalizacjach reklamodawcy lub regularnie w nich bywa. |
NegativeGeoTargetType
Możliwe typy wykluczonych celów geograficznych.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Wartość jest nieznana w tej wersji. |
PRESENCE_OR_INTEREST |
Określa, że użytkownik nie zobaczy reklamy, jeśli znajduje się w wykluczonych lokalizacjach reklamodawcy lub się nimi interesuje. |
PRESENCE |
Określa, że użytkownik nie może zobaczyć reklamy, jeśli znajduje się w wykluczonej lokalizacji reklamodawcy. |
FrequencyCapEntry
Ten typ nie ma żadnych pól.
Reguła określająca maksymalną liczbę wyświetleń reklamy (lub zestawu reklam) użytkownikowi w danym okresie.
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.
Zapis JSON |
---|
{ "conversionActions": [ string ] } |
Pola | |
---|---|
conversionActions[] |
Wybrany zestaw działań powodujących konwersję do optymalizacji tej kampanii. |
OptimizationGoalSetting
Ustawienie celu optymalizacji tej kampanii z zestawem typów celów optymalizacji.
Zapis JSON |
---|
{
"optimizationGoalTypes": [
enum ( |
Pola | |
---|---|
optimizationGoalTypes[] |
Lista typów celów optymalizacji. |
OptimizationGoalType
Typ celu optymalizacji
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Jest używana tylko jako wartość zwrotna. Reprezentuje wartość nieznaną w tej wersji. |
CALL_CLICKS |
Optymalizuj pod kątem kliknięć prowadzących do połączenia. Konwersje po kliknięciu połączenia to liczba kliknięć opcji „Zadzwoń”, aby skontaktować się ze sklepem po obejrzeniu reklamy. |
DRIVING_DIRECTIONS |
Optymalizacja pod kątem wskazówek dojazdu. Konwersje wskazówek dojazdu to kliknięcia przycisku „Wyznacz trasę”, by wyznaczyć trasę dojazdu do sklepu po obejrzeniu reklamy. |
APP_PRE_REGISTRATION |
Optymalizacja pod kątem wcześniejszej rejestracji. Konwersje polegające na wcześniejszej rejestracji to liczba rejestracji w ramach wcześniejszej rejestracji, które umożliwiają otrzymanie powiadomienia o opublikowaniu aplikacji. |
TrackingSetting
Ustawienia śledzenia informacji na poziomie kampanii.
Zapis JSON |
---|
{ "trackingUrl": string } |
Pola | |
---|---|
trackingUrl |
Adres URL używany do dynamicznego śledzenia. |
ManualCpa
Ten typ nie ma żadnych pól.
Strategia samodzielnego ustawiania stawek, która pozwala reklamodawcy ustawić stawkę za działanie określone przez reklamodawcę.
ManualCpc
Samodzielne określanie stawek na podstawie kliknięć, w którym użytkownik płaci za kliknięcie.
Zapis JSON |
---|
{ "enhancedCpcEnabled": boolean } |
Pola | |
---|---|
enhancedCpcEnabled |
Czy stawki mają zostać ulepszone na podstawie danych z optymalizatora konwersji. |
ManualCpm
Ten typ nie ma żadnych pól.
Ręczne określanie stawek na podstawie wyświetleń, w którym użytkownik płaci za tysiąc wyświetleń.
PercentCpc
Strategia ustalania stawek, w której stawki są ułamkiem reklamowanej ceny dla danego towaru lub usługi.
Zapis JSON |
---|
{ "cpcBidCeilingMicros": string, "enhancedCpcEnabled": boolean } |
Pola | |
---|---|
cpcBidCeilingMicros |
Maksymalna stawka, jaką może ustawić strategia ustalania stawek. To pole jest wpisane przez reklamodawcę i podawane w mikro lokalnych. Uwaga: wartość zerowa jest interpretowana w taki sam sposób, jak wartość atrybutu bid_floor nieokreślona. |
enhancedCpcEnabled |
Dostosowuje stawkę w każdej aukcji w górę lub w dół w zależności od prawdopodobieństwa konwersji. Poszczególne stawki mogą przekraczać cpcbidCeilingMicros, ale średnia kwota stawki w kampanii nie powinna. |
TargetCpm
Ten typ nie ma żadnych pól.
Docelowy CPM (koszt tysiąca wyświetleń) to strategia automatycznego określania stawek, która ustala stawki pod kątem optymalizacji skuteczności przy określonym docelowym CPM.
CampaignAsset
Połączenie między kampanią a zasobem.
Zapis JSON |
---|
{
"resourceName": string,
"status": enum ( |
Pola | |
---|---|
resourceName |
Nazwa zasobu kampanii. Nazwy zasobów CampaignAsset mają postać:
|
status |
Stan komponentu kampanii. |
campaign |
Kampania, z którą powiązany jest komponent. |
asset |
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ą.
Zapis JSON |
---|
{
"resourceName": string,
"campaign": string,
"assetSet": string,
"status": enum ( |
Pola | |
---|---|
resourceName |
Nazwa zasobu zestawu komponentów kampanii. Nazwy zasobów zestawu zasobów mają postać:
|
campaign |
Kampania, z którą jest połączony ten zestaw komponentów. |
assetSet |
Zestaw komponentów połączony z kampanią. |
status |
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.
Zapis JSON |
---|
{ "resourceName": string } |
Pola | |
---|---|
resourceName |
Nazwa zasobu widoku odbiorców kampanii. Nazwy zasobów widoku odbiorców w kampanii mają postać:
|
CampaignCriterion
Kryterium kampanii.
Zapis JSON |
---|
{ "resourceName": string, "displayName": string, "type": enum ( |
Pola | |
---|---|
resourceName |
Nazwa zasobu kryterium kampanii. Nazwy zasobów kryterium kampanii mają postać:
|
displayName |
Wyświetlana nazwa kryterium. To pole jest ignorowane w przypadku mutacji. |
type |
Rodzaj kryterium. |
status |
Stan kryterium. |
lastModifiedTime |
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”. |
criterionId |
Identyfikator kryterium. To pole jest ignorowane podczas mutacji. |
bidModifier |
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 |
Określa, czy kryterium ma być celem kierowania ( |
Pole sumy Musisz ustawić dokładnie jeden. |
|
keyword |
Słowo kluczowe. |
location |
Lokalizacja. |
device |
Urządzenie. |
ageRange |
Przedział wiekowy. |
gender |
Płeć. |
userList |
Lista użytkowników. |
language |
Językiem |
webpage |
Strona internetowa. |
locationGroup |
Grupa lokalizacji |
CampaignCriterionStatus
Możliwe stany elementu CampaignCriterion.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono wartości. |
UNKNOWN |
Otrzymana wartość nie jest znana w tej wersji. To jest wartość tylko z odpowiedzią. |
ENABLED |
Kryterium kampanii jest włączone. |
PAUSED |
Kryterium kampanii jest wstrzymane. |
REMOVED |
Kryterium kampanii zostało usunięte. |
LanguageInfo
Kryterium języka.
Zapis JSON |
---|
{ "languageConstant": string } |
Pola | |
---|---|
languageConstant |
Nazwa zasobu stałego języka. |
LocationGroupInfo
Promień wokół listy lokalizacji określonej w pliku danych.
Zapis JSON |
---|
{
"geoTargetConstants": [
string
],
"radiusUnits": enum ( |
Pola | |
---|---|
geoTargetConstants[] |
Stałe kierowania geograficznego ograniczające zakres obszaru geograficznego w pliku danych. Obecnie dozwolona jest tylko jedna stała kierowania geograficznego. |
radiusUnits |
Jednostka promienia. W przypadku stałych kierowania geograficznego obsługiwane są mile i metry. W zestawach elementów pliku danych obsługiwane są mile i metry. Jest to wymagane i należy je ustawić w operacjach CREATE. |
feedItemSets[] |
Zbiory kanałów, których elementy kanału są celem kierowania. Jeśli podasz większą liczbę identyfikatorów, kierowanie będzie obejmować wszystkie elementy, które występują w co najmniej 1 zestawie. Tego pola nie można używać ze stałymi wartościami geoTargetConstants. Jest to opcjonalne i można go ustawić tylko w operacjach CREATE. |
radius |
Odległość w jednostkach określająca promień wokół wybranych lokalizacji. Jest to wymagane i należy je ustawić w operacjach CREATE. |
LocationGroupRadiusUnits
Jednostka długości promienia w grupie lokalizacji (np. MILE)
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji. |
METERS |
Metry |
MILES |
Mile |
MILLI_MILES |
Milli mile |
CampaignLabel
Reprezentuje relację między kampanią a etykietą.
Zapis JSON |
---|
{ "resourceName": string, "campaign": string, "label": string } |
Pola | |
---|---|
resourceName |
Nazwa zasobu. Nazwy zasobów etykiet kampanii mają postać: |
campaign |
Kampania, do której została dołączona etykieta. |
label |
Etykieta przypisana do kampanii. |
CartDataSalesView
Widok sprzedaży danych koszyka.
Zapis JSON |
---|
{ "resourceName": string } |
Pola | |
---|---|
resourceName |
Nazwa zasobu widoku sprzedaży danych koszyka. Nazwy zasobów widoku sprzedaży danych koszyka mają postać: |
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.
Zapis JSON |
---|
{ "resourceName": string, "id": string, "name": string, "description": string } |
Pola | |
---|---|
resourceName |
Nazwa zasobu listy odbiorców. Nazwy list odbiorców mają postać:
|
id |
Identyfikator listy odbiorców. |
name |
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 |
Opis tej listy odbiorców. |
ConversionAction
Działanie powodujące konwersję.
Zapis JSON |
---|
{ "resourceName": string, "creationTime": string, "status": enum ( |
Pola | |
---|---|
resourceName |
Nazwa zasobu działania powodującego konwersję. Nazwy zasobów działań powodujących konwersję mają postać:
|
creationTime |
Sygnatura czasowa utworzenia aktywności Floodlight w formacie ISO 8601. |
status |
Stan tego działania powodującego konwersję na potrzeby gromadzenia zdarzeń konwersji. |
type |
Typ tego działania powodującego konwersję. |
category |
Kategoria konwersji zgłoszonych dla tego działania powodującego konwersję. |
valueSettings |
Ustawienia związane z wartością zdarzeń konwersji powiązanych z tym działaniem powodującym konwersję. |
attributionModelSettings |
Ustawienia związane z modelem atrybucji tego działania powodującego konwersję. |
floodlightSettings |
Ustawienia Floodlight dla typów konwersji Floodlight. |
id |
Identyfikator działania powodującego konwersję. |
name |
Nazwa działania powodującego konwersję. To pole jest wymagane i nie powinno być puste podczas tworzenia nowych działań powodujących konwersję. |
primaryForGoal |
Jeśli parametr primaryForGoal 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ń primaryForGoal, więc jeśli w kampanii cel konwersji niestandardowy jest skonfigurowany z ustawieniem primaryForGoal = false działanie powodujące konwersję, za to działanie powodujące konwersję nadal można ustalać stawki. Jeśli nie zostanie ustawiony, zasada mainForGoal ma domyślnie wartość prawda. W wersji 9 parametr mainForGoal może mieć wartość „false” (fałsz) po utworzeniu za pomocą operacji „update”, ponieważ nie jest on zadeklarowany jako opcjonalny. |
ownerCustomer |
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. |
includeInClientAccountConversionsMetric |
Określa, czy to działanie powodujące konwersję ma być uwzględnione w danych „Konwersje na koncie klienta”. |
includeInConversionsMetric |
Określa, czy to działanie powodujące konwersję ma być uwzględniane w danych „Konwersje”. |
clickThroughLookbackWindowDays |
Maksymalna liczba dni, jaka może upływać między interakcją (np. kliknięciem) a zdarzeniem konwersji. |
appId |
Identyfikator aplikacji działania powodującego konwersję z aplikacji. |
ConversionActionStatus
Możliwe stany działania powodującego konwersję.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji. |
ENABLED |
Konwersje będą rejestrowane. |
REMOVED |
Konwersje nie będą rejestrowane. |
HIDDEN |
Konwersje nie będą rejestrowane, a działanie powodujące konwersję nie będzie widoczne w interfejsie. |
ConversionActionType
Możliwe typy działania powodującego konwersję.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji. |
AD_CALL |
Konwersje, które mają miejsce, gdy użytkownik kliknie rozszerzenie połączeń w reklamie. |
CLICK_TO_CALL |
Konwersje, które mają miejsce, gdy użytkownik kliknie numer telefonu na urządzeniu mobilnym. |
GOOGLE_PLAY_DOWNLOAD |
Konwersje, które mają miejsce, gdy użytkownik pobierze aplikację mobilną ze Sklepu Google Play. |
GOOGLE_PLAY_IN_APP_PURCHASE |
Konwersje, które mają miejsce, gdy użytkownik dokonuje zakupu w aplikacji, korzystając z płatności na Androidzie. |
UPLOAD_CALLS |
Konwersje telefoniczne śledzone przez reklamodawcę i przesyłane. |
UPLOAD_CLICKS |
Konwersje śledzone przez reklamodawcę i przesyłane z przypisanymi kliknięciami. |
WEBPAGE |
Konwersje na stronie internetowej. |
WEBSITE_CALL |
Konwersje, które mają miejsce, gdy użytkownik zadzwoni pod dynamicznie generowany numer telefonu z witryny reklamodawcy. |
STORE_SALES_DIRECT_UPLOAD |
Konwersje polegające na sprzedaży w sklepie stacjonarnym obliczane na podstawie przesłanych danych własnych lub pochodzących od sprzedawców zewnętrznych. Z typów przesyłania bezpośredniego sprzedaży w sklepie mogą korzystać tylko klienci z listy dozwolonych. |
STORE_SALES |
Konwersje polegające na sprzedaży w sklepie są określane na podstawie przesłanych danych własnych lub pochodzących od sprzedawców zewnętrznych lub zakupów w sklepie przy użyciu kart z sieci płatniczych. Z typów sprzedaży w sklepie mogą korzystać tylko klienci z listy dozwolonych. Tylko do odczytu. |
FIREBASE_ANDROID_FIRST_OPEN |
Konwersje polegające na pierwszym uruchomieniu aplikacji na Androida śledzone przez Firebase. |
FIREBASE_ANDROID_IN_APP_PURCHASE |
Konwersje polegające na zakupie aplikacji na Androida w aplikacji śledzone przez Firebase. |
FIREBASE_ANDROID_CUSTOM |
Niestandardowe konwersje aplikacji na Androida śledzone przez Firebase. |
FIREBASE_IOS_FIRST_OPEN |
Konwersje polegające na pierwszym uruchomieniu aplikacji na iOS śledzone przez Firebase. |
FIREBASE_IOS_IN_APP_PURCHASE |
Konwersje polegające na zakupie w aplikacji na iOS śledzone przez Firebase. |
FIREBASE_IOS_CUSTOM |
Niestandardowe konwersje aplikacji na iOS śledzone przez Firebase. |
THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN |
Konwersje polegające na pierwszym uruchomieniu aplikacji na Androida śledzone za pomocą analityki aplikacji przez firmy zewnętrzne |
THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE |
Konwersje polegające na zakupie aplikacji na Androida śledzone w ramach analityki aplikacji innych firm |
THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM |
Konwersje niestandardowe w aplikacjach na Androida śledzone za pomocą analityki aplikacji firmy zewnętrznej |
THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN |
Konwersje polegające na pierwszym uruchomieniu aplikacji na iOS śledzone za pomocą analityki aplikacji firm zewnętrznych |
THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE |
Konwersje polegające na zakupie aplikacji na iOS śledzone za pomocą analityki aplikacji firmy zewnętrznej |
THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM |
Niestandardowe konwersje w aplikacji na iOS śledzone za pomocą analityki aplikacji innych firm |
ANDROID_APP_PRE_REGISTRATION |
Konwersje, które mają miejsce, gdy użytkownik wstępnie zarejestruje aplikację mobilną ze Sklepu Google Play. Tylko do odczytu. |
ANDROID_INSTALLS_ALL_OTHER_APPS |
Konwersje, które śledzą wszystkie pobrania z Google Play, które nie są śledzone przez typ aplikacji. Tylko do odczytu. |
FLOODLIGHT_ACTION |
Aktywność Floodlight zliczająca wizyty na określonej stronie internetowej po zobaczeniu lub kliknięciu jednej z reklam reklamodawcy. Tylko do odczytu. |
FLOODLIGHT_TRANSACTION |
Aktywność Floodlight śledząca liczbę zrealizowanych transakcji sprzedaży lub liczbę kupionych produktów. Może też rejestrować łączną wartość każdej sprzedaży. Tylko do odczytu. |
GOOGLE_HOSTED |
Konwersje, które śledzą działania lokalne produktów i usług Google po interakcji z reklamą. Tylko do odczytu. |
LEAD_FORM_SUBMIT |
Konwersje są rejestrowane, gdy użytkownik przesyła formularz kontaktowy. Tylko do odczytu. |
SALESFORCE |
Konwersje pochodzące z Salesforce. Tylko do odczytu. |
SEARCH_ADS_360 |
Konwersje zaimportowane z danych Floodlight w Search Ads 360. Tylko do odczytu. |
SMART_CAMPAIGN_AD_CLICKS_TO_CALL |
konwersje telefoniczne, które są realizowane w reklamach w kampanii inteligentnej, jeśli nie skonfigurowano śledzenia połączeń telefonicznych, a które są określane przy użyciu kryteriów niestandardowych w kampanii inteligentnej. Tylko do odczytu. |
SMART_CAMPAIGN_MAP_CLICKS_TO_CALL |
Użytkownik klika element połączenia w Mapach Google. Tylko kampania inteligentna. Tylko do odczytu. |
SMART_CAMPAIGN_MAP_DIRECTIONS |
Użytkownik prosi o wskazówki dojazdu do lokalizacji firmy w Mapach Google. Tylko kampania inteligentna. Tylko do odczytu. |
SMART_CAMPAIGN_TRACKED_CALLS |
Konwersje telefoniczne uzyskiwane w reklamach w kampanii inteligentnej z ustawionymi śledzeniem połączeń i ustawionymi kryteriami niestandardowymi w kampanii inteligentnej. Tylko do odczytu. |
STORE_VISITS |
Konwersje, które mają miejsce, gdy użytkownik odwiedza sklep stacjonarny reklamodawcy. Tylko do odczytu. |
WEBPAGE_CODELESS |
Konwersje utworzone na podstawie zdarzeń w witrynie (np. przesłania formularza lub wczytania strony), które nie korzystają z indywidualnie kodowanych fragmentów kodu zdarzenia. Tylko do odczytu. |
UNIVERSAL_ANALYTICS_GOAL |
Konwersje, które pochodzą z połączonych celów Universal Analytics. |
UNIVERSAL_ANALYTICS_TRANSACTION |
Konwersje, które pochodzą z połączonych transakcji Universal Analytics. |
GOOGLE_ANALYTICS_4_CUSTOM |
Konwersje, które pochodzą z połączonych konwersji zdarzeń niestandardowych Google Analytics 4. |
GOOGLE_ANALYTICS_4_PURCHASE |
Konwersje, które pochodzą z połączonych konwersji polegających na zakupie w Google Analytics 4. |
ConversionActionCategory
Kategoria konwersji powiązanych z działaniem powodującym konwersję.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji. |
DEFAULT |
Kategoria domyślna. |
PAGE_VIEW |
Użytkownik odwiedzający stronę. |
PURCHASE |
Zdarzenie zakupu, sprzedaży lub złożonego zamówienia. |
SIGNUP |
Działanie użytkownika polegające na rejestracji. |
LEAD |
Działania mające na celu zwiększanie liczby potencjalnych klientów |
DOWNLOAD |
Pobranie oprogramowania (jak w przypadku aplikacji). |
ADD_TO_CART |
Dodanie produktów do koszyka lub torby na zakupy w witrynie reklamodawcy. |
BEGIN_CHECKOUT |
Gdy ktoś rozpoczyna proces płatności w witrynie reklamodawcy. |
SUBSCRIBE_PAID |
Początek płatnej subskrypcji produktu lub usługi. |
PHONE_CALL_LEAD |
Rozmowa telefoniczna z prośbą o wyrażenie zainteresowania ofertą reklamodawcy. |
IMPORTED_LEAD |
Konwersja polegająca na wypełnieniu formularza kontaktowego zaimportowanego z zewnętrznego źródła do Google Ads. |
SUBMIT_LEAD_FORM |
Wypełnienie na stronie reklamodawcy formularza wskazującego zainteresowanie firmą. |
BOOK_APPOINTMENT |
Umówienie spotkania z firmą reklamodawcy. |
REQUEST_QUOTE |
Prośba o wycenę lub oszacowanie ceny. |
GET_DIRECTIONS |
Wyszukiwanie lokalizacji firmy reklamodawcy z zamiarem odwiedzenia. |
OUTBOUND_CLICK |
Kliknięcie prowadzące do witryny partnera reklamodawcy. |
CONTACT |
Rozmowa telefoniczna, SMS, e-mail, czat lub inny rodzaj kontaktu z reklamodawcą. |
ENGAGEMENT |
zdarzenie związane z zaangażowaniem w witrynę, np. długi czas spędzony w witrynie lub cel inteligentny w Google Analytics (GA). Przeznaczona do importowania celów w Google Analytics, Firebase i Google Analytics. |
STORE_VISIT |
Wizyta w sklepie stacjonarnym. |
STORE_SALE |
Wyprzedaż w sklepie stacjonarnym. |
QUALIFIED_LEAD |
Konwersja polegająca na zaimportowaniu do Google Ads konwersji potencjalnego klienta z zewnętrznego źródła, która została dodatkowo zakwalifikowana przez reklamodawcę (zespół ds. marketingu lub sprzedaży). Reklamodawcy pozyskują potencjalnych klientów na ścieżce od potencjalnego klienta do sprzedaży, a następnie nawiązują z nimi kontakt. Jeśli klient jest zainteresowany zakupem jego produktu, reklamodawca oznacza go jako „kwalifikujących się potencjalnych klientów”. |
CONVERTED_LEAD |
Konwersja polegająca na wypełnieniu formularza kontaktowego zaimportowana do Google Ads z zewnętrznego źródła, która zakończyła się dalej określonym etapem określonym przez reklamodawcę służącego do zdobywania potencjalnych klientów. |
ValueSettings
Ustawienia związane z wartością zdarzeń konwersji powiązanych z tym działaniem powodującym konwersję.
Zapis JSON |
---|
{ "defaultValue": number, "defaultCurrencyCode": string, "alwaysUseDefaultValue": boolean } |
Pola | |
---|---|
defaultValue |
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. |
defaultCurrencyCode |
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. |
alwaysUseDefaultValue |
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. |
AttributionModelSettings
Ustawienia związane z modelem atrybucji tego działania powodującego konwersję.
Zapis JSON |
---|
{ "attributionModel": enum ( |
Pola | |
---|---|
attributionModel |
Typ modelu atrybucji w przypadku tego działania powodującego konwersję. |
dataDrivenModelStatus |
Stan modelu atrybucji opartej na danych dla działania powodującego konwersję. |
AttributionModel
Model atrybucji, który określa, jak przypisać udział w danej konwersji między potencjalnie wiele wcześniejszych interakcji.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji. |
EXTERNAL |
Wykorzystuje zewnętrzną atrybucję. |
GOOGLE_ADS_LAST_CLICK |
Przypisuje cały udział w konwersji ostatniemu kliknięciu. |
GOOGLE_SEARCH_ATTRIBUTION_FIRST_CLICK |
Przypisuje cały udział w konwersji pierwszemu kliknięciu na podstawie atrybucji w wyszukiwarce Google. |
GOOGLE_SEARCH_ATTRIBUTION_LINEAR |
Przypisuje jednakowy udział w konwersji wszystkim kliknięciom, korzystając z atrybucji w wyszukiwarce Google. |
GOOGLE_SEARCH_ATTRIBUTION_TIME_DECAY |
Na podstawie atrybucji w wyszukiwarce Google przypisuje zdecydowanie większy udział w konwersji ostatnim kliknięciom (okres półtrwania to tydzień). |
GOOGLE_SEARCH_ATTRIBUTION_POSITION_BASED |
Na jej podstawie 40% udziału w konwersji jest przypisywane pierwszemu i ostatniemu kliknięciu. Pozostałe 20% jest równomiernie rozkładane pomiędzy wszystkie pozostałe kliknięcia. Korzysta on z atrybucji w wyszukiwarce Google. |
GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN |
Elastyczny model, który wykorzystuje systemy uczące się, aby określić odpowiedni rozkład udziału w kliknięciach za pomocą atrybucji w wyszukiwarce Google. |
DataDrivenModelStatus
Wylicza stany modelu na podstawie danych.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji. |
AVAILABLE |
Dostępny jest model oparty na danych. |
STALE |
Model oparty na danych jest nieaktualny. Nie była aktualizowana od co najmniej 7 dni. Nadal jest używana, ale jeśli nie zostanie zaktualizowana w ciągu 30 dni, wygaśnie. |
EXPIRED |
Model oparty na danych wygasł. Nie była aktualizowana od co najmniej 30 dni, więc nie można jej używać. Zwykle dzieje się tak, gdy w ciągu ostatnich 30 dni nie było wymaganej liczby zdarzeń. |
NEVER_GENERATED |
Model oparty na danych nigdy nie został wygenerowany. Najczęściej dzieje się tak w żadnym 30-dniowym okresie. |
FloodlightSettings
Ustawienia związane z działaniem powodującym konwersję Floodlight.
Zapis JSON |
---|
{ "activityGroupTag": string, "activityTag": string, "activityId": string } |
Pola | |
---|---|
activityGroupTag |
Ciąg znaków używany do identyfikacji grupy aktywności Floodlight podczas raportowania konwersji. |
activityTag |
Ciąg znaków używany do identyfikacji aktywności Floodlight podczas raportowania konwersji. |
activityId |
Identyfikator aktywności Floodlight w usłudze DoubleClick Campaign Manager (DCM). |
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.
Zapis JSON |
---|
{ "resourceName": string, "id": string, "name": string, "tag": string, "status": enum ( |
Pola | |
---|---|
resourceName |
Nazwa zasobu zmiennej niestandardowej konwersji. Nazwy zasobów niestandardowych zmiennych konwersji mają postać:
|
id |
Identyfikator niestandardowej zmiennej konwersji. |
name |
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 |
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 |
Stan zmiennej niestandardowej konwersji na potrzeby gromadzenia zdarzeń konwersji. |
ownerCustomer |
Nazwa zasobu klienta, do którego należy niestandardowa zmienna konwersji. |
family |
Rodzina zmiennej niestandardowej konwersji. |
cardinality |
Moc zbioru niestandardowej zmiennej konwersji. |
floodlightConversionCustomVariableInfo |
Pola na potrzeby zmiennych niestandardowych konwersji Floodlight w Search Ads 360. |
customColumnIds[] |
Identyfikatory kolumn niestandardowych, które korzystają z tej zmiennej niestandardowej konwersji. |
ConversionCustomVariableStatus
Możliwe stany zmiennej niestandardowej konwersji.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji. |
ACTIVATION_NEEDED |
Niestandardowa zmienna konwersji oczekuje na aktywację i nie będzie gromadziła statystyk, dopóki nie zostanie włączona. Tego stanu nie można używać w żądaniach CREATE ani UPDATE. |
ENABLED |
Niestandardowa zmienna konwersji jest włączona i będzie gromadziła statystyki. |
PAUSED |
Niestandardowa zmienna konwersji została wstrzymana i nie będzie gromadziła statystyk, dopóki nie zostanie ponownie WŁĄCZONA. |
ConversionCustomVariableFamily
Rodzina zmiennej niestandardowej konwersji.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji. |
STANDARD |
Standardowa zmienna niestandardowa konwersji. Klienci muszą aktywować usługę przed użyciem. |
FLOODLIGHT |
Niestandardowa zmienna konwersji zaimportowana z niestandardowej zmiennej Floodlight. |
ConversionCustomVariableCardinality
Moc zbioru niestandardowej zmiennej konwersji.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji. |
BELOW_ALL_LIMITS |
Niestandardowa zmienna konwersji ma moc zbioru poniżej wszystkich limitów. Tej zmiennej można użyć do podziału na segmenty, a jeśli jest ona włączona, można gromadzić dane o nowych wartościach. |
EXCEEDS_SEGMENTATION_LIMIT_BUT_NOT_STATS_LIMIT |
Niestandardowa zmienna konwersji ma moc zbioru, która przekracza limit podziału na segmenty, ale nie przekracza limitu statystyk. Podział na segmenty zostanie wyłączony, ale jeśli zmienna zostanie włączona, mogą być gromadzone dla nowych wartości statystyki. |
APPROACHES_STATS_LIMIT |
Niestandardowa zmienna konwersji przekroczyła limit podziału na segmenty i zbliża się do limitów statystyk (>90%). Podział na segmenty zostanie wyłączony, ale jeśli zmienna zostanie włączona, mogą być gromadzone dla nowych wartości statystyki. |
EXCEEDS_STATS_LIMIT |
Niestandardowa zmienna konwersji przekroczyła zarówno limity podziału na segmenty, jak i limity statystyk. Podział na segmenty zostanie wyłączony, a statystyki włączonych zmiennych będą gromadzone tylko wtedy, gdy istniejące wartości nie zwiększają już mocy zbioru zmiennej. |
FloodlightConversionCustomVariableInfo
Informacje o zmiennych niestandardowych konwersji Floodlight w Search Ads 360.
Zapis JSON |
---|
{ "floodlightVariableType": enum ( |
Pola | |
---|---|
floodlightVariableType |
Typ zmiennej Floodlight zdefiniowany w Search Ads 360. |
floodlightVariableDataType |
Typ danych zmiennej Floodlight zdefiniowany w Search Ads 360. |
FloodlightVariableType
Typ zmiennej Floodlight określony w Search Ads 360. Więcej informacji znajdziesz na stronie https://support.google.com/searchads/answer/4397154?hl=en.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji. |
DIMENSION |
Typ zmiennej Floodlight wymiaru. |
METRIC |
Typ zmiennej Floodlight. |
UNSET |
Nie określono typu zmiennej Floodlight. |
FloodlightVariableDataType
Typ danych zmiennej Floodlight określony w Search Ads 360. Więcej informacji znajdziesz na stronie https://support.google.com/searchads/answer/4397154?hl=en.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji. |
NUMBER |
Reprezentuje zmienną Floodlight typu „Liczba”. Tę zmienną można przypisać do zmiennych Floodlight typu DIMENSION lub METRIC. |
STRING |
Reprezentuje zmienną Floodlight typu „String”. Tę zmienną można przypisać do zmiennych Floodlight typu DIMENSION. |
Klient
Klienta.
Zapis JSON |
---|
{ "resourceName": string, "conversionTrackingSetting": { object ( |
Pola | |
---|---|
resourceName |
Nazwa zasobu klienta. Nazwy zasobów klienta mają postać:
|
conversionTrackingSetting |
Ustawienie śledzenia konwersji dla klienta. |
accountType |
Typ konta wyszukiwarki, np. Google Ads, Microsoft Advertising, Yahoo Japan, Baidu, Facebook, śledzenia wyszukiwarki itp. |
doubleClickCampaignManagerSetting |
Ustawienie usługi DoubleClick Campaign Manager (DCM) dla klienta menedżera. |
accountStatus |
Stan konta, np. Włączone, Wstrzymane, Usunięte itp. |
lastModifiedTime |
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”. |
engineId |
Identyfikator konta na zewnętrznym koncie wyszukiwarki. |
status |
Stan klienta. |
creationTime |
Sygnatura czasowa utworzenia tego klienta. Sygnatura czasowa jest podana w strefie czasowej klienta i w formacie „rrrr-MM-dd GG:mm:ss”. |
id |
Identyfikator klienta. |
descriptiveName |
Opcjonalna, nieunikalna nazwa opisowa klienta. |
currencyCode |
Waluta, w której działa konto. Obsługiwany jest podzbiór kodów waluty ze standardu ISO 4217. |
timeZone |
Identyfikator lokalnej strefy czasowej klienta. |
trackingUrlTemplate |
Szablon URL służący do tworzenia linku monitorującego na podstawie parametrów. |
finalUrlSuffix |
Szablon adresu URL służący do dołączania parametrów do końcowego adresu URL. |
autoTaggingEnabled |
Określa, czy na koncie klienta jest włączone automatyczne tagowanie. |
manager |
od tego, czy klient jest menedżerem. |
ConversionTrackingSetting
Zbiór ustawień dla wszystkich klientów związanych ze śledzeniem konwersji w Search Ads 360.
Zapis JSON |
---|
{
"acceptedCustomerDataTerms": boolean,
"conversionTrackingStatus": enum ( |
Pola | |
---|---|
acceptedCustomerDataTerms |
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. |
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 |
enhancedConversionsForLeadsEnabled |
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. |
googleAdsConversionCustomer |
Nazwa zasobu klienta, dla którego są tworzone i zarządzane konwersje. To pole jest tylko do odczytu. |
conversionTrackingId |
Identyfikator śledzenia konwersji używany na tym koncie. Ten identyfikator nie wskazuje, czy klient korzysta ze śledzenia konwersji (tak – conversionTrackingStatus). To pole jest tylko do odczytu. |
googleAdsCrossAccountConversionTrackingId |
Identyfikator śledzenia konwersji należącego do menedżera klienta. Jest ona konfigurowana, gdy klient ma włączone śledzenie konwersji, i zastępuje parametr conversionTrackingId. Tym polem można zarządzać tylko przez interfejs Google Ads. To pole jest tylko do odczytu. |
crossAccountConversionTrackingId |
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 conversionTrackingId. |
ConversionTrackingStatus
Stan śledzenia konwersji klienta.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji. |
NOT_CONVERSION_TRACKED |
Klient nie korzysta ze śledzenia konwersji. |
CONVERSION_TRACKING_MANAGED_BY_SELF |
Działania powodujące konwersję są tworzone i zarządzane przez tego klienta. |
CONVERSION_TRACKING_MANAGED_BY_THIS_MANAGER |
Działania powodujące konwersję jest tworzone i zarządzane przez menedżera określonego w login-customer-id prośby. |
CONVERSION_TRACKING_MANAGED_BY_ANOTHER_MANAGER |
Działania powodujące konwersję są tworzone i zarządzane przez menedżera innego niż klient lub menedżer określony w login-customer-id prośby. |
AccountType
Możliwe typy kont wyszukiwarki.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji. |
BAIDU |
Baidu. |
ENGINE_TRACK |
Konto śledzenia wyszukiwarki. |
FACEBOOK |
Konto na Facebooku. |
FACEBOOK_GATEWAY |
Konto na Facebooku zarządzane przez bramę. |
GOOGLE_ADS |
koncie Google Ads. |
MICROSOFT |
na koncie Microsoft Advertising. |
SEARCH_ADS_360 |
konta menedżera Search Ads 360. |
YAHOO_JAPAN |
Konto Yahoo! Japan. |
DoubleClickCampaignManagerSetting
Ustawienie usługi DoubleClick Campaign Manager (DCM) dla klienta menedżera.
Zapis JSON |
---|
{ "advertiserId": string, "networkId": string, "timeZone": string } |
Pola | |
---|---|
advertiserId |
Identyfikator reklamodawcy w usłudze Campaign Manager powiązanego z tym klientem. |
networkId |
Identyfikator sieci w usłudze Campaign Manager powiązanej z tym klientem. |
timeZone |
Strefa czasowa sieci Campaign Managera powiązanej z tym klientem w formacie bazy danych stref czasowych IANA, np. America/New_York. |
AccountStatus
Możliwe stany konta.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Wartość domyślna. |
UNKNOWN |
Nieznana wartość. |
ENABLED |
Konto może wyświetlać reklamy. |
PAUSED |
Konto zostało dezaktywowane przez użytkownika. |
SUSPENDED |
Konto zostało dezaktywowane w wyniku wewnętrznego procesu. |
REMOVED |
Konto zostało nieodwołalnie dezaktywowane. |
DRAFT |
Konto jest w trakcie konfiguracji, ale nie jest jeszcze WŁĄCZONE. |
CustomerStatus
Możliwe stany klienta.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji. |
ENABLED |
Wskazuje aktywne konto, które może wyświetlać reklamy. |
CANCELED |
Wskazuje, że zlikwidowane konto nie może wyświetlać reklam. Administrator może aktywować ponownie. |
SUSPENDED |
Oznacza, że zawieszone konto nie może wyświetlać reklam. To ustawienie może zostać aktywowane tylko przez zespół pomocy Google. |
CLOSED |
Oznacza zamknięte konto, które nie może wyświetlać reklam. Konto testowe też będzie miało stan ZAMKNIĘTE. Stan jest trwały i nie można go ponownie otworzyć. |
CustomerAsset
Połączenie między klientem a komponentem.
Zapis JSON |
---|
{
"resourceName": string,
"asset": string,
"status": enum ( |
Pola | |
---|---|
resourceName |
Nazwa zasobu zasobu klienta. Nazwy zasobów CustomerAsset mają postać:
|
asset |
Wymagane. Komponent, który jest połączony z klientem. |
status |
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.
Zapis JSON |
---|
{
"resourceName": string,
"assetSet": string,
"customer": string,
"status": enum ( |
Pola | |
---|---|
resourceName |
Nazwa zasobu zestawu zasobów klienta. Nazwy zasobów zestawu zasobów mają postać:
|
assetSet |
Zestaw komponentów połączony z klientem. |
customer |
Klient, z którym jest połączony ten zestaw komponentów. |
status |
Stan komponentu w zestawie komponentów klienta. Tylko do odczytu. |
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.
Zapis JSON |
---|
{ "resourceName": string, "id": string, "name": string, "type": enum ( |
Pola | |
---|---|
resourceName |
Nazwa zasobu dostępnej strategii ustalania stawek. Nazwy zasobów AccessibleStrategia określania stawek mają postać:
|
id |
Identyfikator strategii ustalania stawek. |
name |
Nazwa strategii ustalania stawek. |
type |
Typ strategii ustalania stawek. |
ownerCustomerId |
Identyfikator klienta, do którego należy strategia ustalania stawek. |
ownerDescriptiveName |
opisowa nazwa klienta, do którego należy strategia ustalania stawek. |
Pole sumy Można ustawić tylko jedną opcję. |
|
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. |
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. |
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). |
targetImpressionShare |
Strategia ustalania stawek, która automatycznie optymalizuje stawki pod kątem określonego odsetka wyświetleń. |
targetRoas |
Strategia ustalania stawek, która pomaga zmaksymalizować przychody przy średnim docelowym zwrocie z nakładów na reklamę (ROAS). |
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.
Zapis JSON |
---|
{ "targetRoas": number } |
Pola | |
---|---|
targetRoas |
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.
Zapis JSON |
---|
{ "targetCpa": string, "targetCpaMicros": string } |
Pola | |
---|---|
targetCpa |
Opcja docelowego kosztu pozyskania (CPA). To średnia kwota, jaką chcesz wydać na pozyskanie. |
targetCpaMicros |
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).
Zapis JSON |
---|
{ "targetCpaMicros": string } |
Pola | |
---|---|
targetCpaMicros |
Ś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. |
TargetRoas
Strategia automatycznego określania stawek, która pomaga zmaksymalizować przychody przy średnim docelowym zwrocie z nakładów na reklamę (ROAS).
Zapis JSON |
---|
{ "targetRoas": number } |
Pola | |
---|---|
targetRoas |
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.
Zapis JSON |
---|
{ "targetSpendMicros": string, "cpcBidCeilingMicros": string } |
Pola | |
---|---|
targetSpendMicros |
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. |
cpcBidCeilingMicros |
Maksymalna stawka, jaką może ustawić strategia ustalania stawek. Limit dotyczy wszystkich słów kluczowych zarządzanych przez strategię. |
CustomerManagerLink
Reprezentuje relację „klient-menedżer”.
Zapis JSON |
---|
{
"resourceName": string,
"status": enum ( |
Pola | |
---|---|
resourceName |
Nazwa zasobu. Nazwy zasobów CustomerManagerLink mają postać: |
status |
Stan połączenia między klientem a menedżerem. |
managerCustomer |
Klient menedżera połączył się z klientem. |
managerLinkId |
Identyfikator połączenia z menedżerem klienta. To pole jest tylko do odczytu. |
ManagerLinkStatus
Możliwe stany linku.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji. |
ACTIVE |
Wskazuje obecny związek |
INACTIVE |
Oznacza zakończone relacje |
PENDING |
Wskazuje, że menedżer wysłał prośbę o relację, ale klient jeszcze jej nie zaakceptował. |
REFUSED |
Menedżer poprosił o utworzenie relacji, ale klient odrzucił prośbę. |
CANCELED |
Wskazuje, że menedżer wysłał prośbę o dodanie relacji, ale menedżer ją anulował. |
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.
Zapis JSON |
---|
{
"resourceName": string,
"appliedLabels": [
string
],
"status": enum ( |
Pola | |
---|---|
resourceName |
Nazwa zasobu klienta klienta. Nazwy zasobów CustomerClient mają postać: |
appliedLabels[] |
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ć:
|
status |
Stan klienta. Tylko do odczytu. |
clientCustomer |
Nazwa zasobu klient-klient, który jest połączony z danym klientem. Tylko do odczytu. |
level |
Odległość między danym klientem a klientem. W przypadku połączenia własnego wartość będzie wynosić 0. Tylko do odczytu. |
timeZone |
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. |
testAccount |
Wskazuje, czy klient jest kontem testowym. Tylko do odczytu. |
manager |
Wskazuje, czy klient jest menedżerem. Tylko do odczytu. |
descriptiveName |
Opisowa nazwa klienta. Tylko do odczytu. |
currencyCode |
Kod waluty klienta (np. „USD”, „EUR”). Tylko do odczytu. |
id |
Identyfikator klienta. Tylko do odczytu. |
DynamicSearchAdsSearchTermView
Widok wyszukiwanych haseł w dynamicznych reklamach w wyszukiwarce.
Zapis JSON |
---|
{ "resourceName": string, "landingPage": string } |
Pola | |
---|---|
resourceName |
Nazwa zasobu widoku wyszukiwanych haseł dynamicznych reklam w wyszukiwarce. Nazwy zasobów w widoku wyszukiwanych haseł w dynamicznych reklamach w wyszukiwarce mają postać:
|
landingPage |
Dynamicznie wybrany adres URL strony docelowej wyświetlenia. To pole jest tylko do odczytu. |
GenderView
Widok płci. Zasób płećView odzwierciedla efektywny 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.
Zapis JSON |
---|
{ "resourceName": string } |
Pola | |
---|---|
resourceName |
Nazwa zasobu widoku płci. Nazwy zasobów widoku płci mają postać:
|
GeoTargetConstant
Stała celu geograficznego.
Zapis JSON |
---|
{
"resourceName": string,
"status": enum ( |
Pola | |
---|---|
resourceName |
Nazwa zasobu stałej kierowania geograficznego. Nazwy stałych zasobów w kierowaniu geograficznym mają postać:
|
status |
Stan stałego kierowania geograficznego. |
id |
Identyfikator stałej wartości kierowania geograficznego. |
name |
Angielska nazwa stałej kierowania geograficznego. |
countryCode |
Kod kraju w formacie ISO-3166-1 alfa-2, który jest powiązany z celem. |
targetType |
Typ stałego celu kierowania geograficznego. |
canonicalName |
Pełna i jednoznaczna nazwa angielska składająca się z nazwy obiektu docelowego, nazwy elementu nadrzędnego i kraju. |
parentGeoTarget |
Nazwa zasobu nadrzędnej stałej docelowej lokalizacji geograficznej. Nazwy stałych zasobów w kierowaniu geograficznym mają postać:
|
GeoTargetConstantStatus
Możliwe stany stałej kierowania geograficznego.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono wartości. |
UNKNOWN |
Otrzymana wartość nie jest znana w tej wersji. To jest wartość tylko z odpowiedzią. |
ENABLED |
Stała kierowania geograficznego jest prawidłowa. |
REMOVAL_PLANNED |
Stała wartość kierowania geograficznego jest nieaktualna i zostanie usunięta. |
KeywordView
Widok słów kluczowych.
Zapis JSON |
---|
{ "resourceName": string } |
Pola | |
---|---|
resourceName |
Nazwa zasobu widoku słów kluczowych. Nazwy zasobów widoku słów kluczowych mają postać:
|
Etykieta
Etykieta.
Zapis JSON |
---|
{ "resourceName": string, "status": enum ( |
Pola | |
---|---|
resourceName |
Nazwa zasobu. Nazwy zasobów etykiet mają postać: |
status |
Stan etykiety. Tylko do odczytu. |
textLabel |
Rodzaj etykiety wyświetlanej na kolorowym tle. |
id |
Identyfikator etykiety. Tylko do odczytu. |
name |
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. |
LabelStatus
Możliwe stany etykiety.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji. |
ENABLED |
Etykieta jest włączona. |
REMOVED |
Etykieta została usunięta. |
TextLabel
Rodzaj etykiety wyświetlanej na kolorowym tle.
Zapis JSON |
---|
{ "backgroundColor": string, "description": string } |
Pola | |
---|---|
backgroundColor |
Kolor tła etykiety w formacie RGB. Ten ciąg musi być zgodny z wyrażeniem regularnym „^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$”. Uwaga: kolor tła może być niewidoczny na kontach menedżera. |
description |
Krótki opis etykiety. Maksymalna dozwolona liczba znaków to 200. |
LanguageConstant
Język.
Zapis JSON |
---|
{ "resourceName": string, "id": string, "code": string, "name": string, "targetable": boolean } |
Pola | |
---|---|
resourceName |
Nazwa zasobu stałej języka. Nazwy zasobów stałych języka mają postać:
|
id |
Identyfikator stałej języka. |
code |
Kod języka, np. „en_US”, „en_AU”, „es”, „fr” itp. |
name |
pełna nazwa języka w języku angielskim, na przykład „angielski (USA)”, „hiszpański” itp.; |
targetable |
Określa, czy na język można kierować reklamy. |
LocationView
Widok lokalizacji zawiera podsumowanie skuteczności kampanii według kryterium lokalizacji.
Zapis JSON |
---|
{ "resourceName": string } |
Pola | |
---|---|
resourceName |
Nazwa zasobu widoku lokalizacji. Nazwy zasobów widoku lokalizacji mają postać:
|
ProductBiddingCategoryConstant
Kategoria określania stawek za produkt.
Zapis JSON |
---|
{ "resourceName": string, "level": enum ( |
Pola | |
---|---|
resourceName |
Nazwa zasobu kategorii ustalania stawek za produkt. Nazwy zasobów kategorii ustalania stawek za produkt mają postać:
|
level |
Poziom kategorii ustalania stawek za produkt. |
status |
Stan kategorii ustalania stawek dla produktu. |
id |
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. |
countryCode |
Dwuliterowy kod kraju powiązany z kategorią ustalania stawek produktu. |
productBiddingCategoryConstantParent |
Nazwa zasobu nadrzędnej kategorii ustalania stawek produktu. |
languageCode |
Kod języka kategorii ustalania stawek za produkt. |
localizedName |
Wyświetlaj wartość kategorii ustalania stawek za produkt zlokalizowaną zgodnie z kodem languageCode. |
ProductBiddingCategoryLevel
Wyliczenie opisujące poziom kategorii ustalania stawek za produkt.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji. |
LEVEL1 |
Poziom 1. |
LEVEL2 |
Poziom 2. |
LEVEL3 |
Poziom 3. |
LEVEL4 |
Poziom 4. |
LEVEL5 |
Poziom 5. |
ProductBiddingCategoryStatus
Wyliczenie opisujące stan kategorii ustalania stawek za produkt.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji. |
ACTIVE |
Kategoria jest aktywna i można jej używać do określania stawek. |
OBSOLETE |
Kategoria jest nieaktualna. Dane są używane tylko na potrzeby raportowania. |
ProductGroupView
Widok grupy produktów.
Zapis JSON |
---|
{ "resourceName": string } |
Pola | |
---|---|
resourceName |
Nazwa zasobu widoku grupy produktów. Nazwy zasobów widoku grupy produktów mają postać:
|
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.
Zapis JSON |
---|
{ "resourceName": string } |
Pola | |
---|---|
resourceName |
Nazwa zasobu widoku skuteczności w Zakupach Google. Nazwy zasobów widoku skuteczności zakupów mają postać: |
UserList
Lista użytkowników. Jest to lista użytkowników, na których klient może kierować reklamy.
Zapis JSON |
---|
{
"resourceName": string,
"type": enum ( |
Pola | |
---|---|
resourceName |
Nazwa zasobu listy użytkowników. Nazwy zasobów list użytkowników mają postać:
|
type |
Typ tej listy. To pole jest tylko do odczytu. |
id |
Identyfikator listy użytkowników. |
name |
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) |
UserListType
Wyliczenie zawierające możliwe typy list użytkowników.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji. |
REMARKETING |
UserList przedstawiona jako zbiór typów konwersji. |
LOGICAL |
Lista użytkowników przedstawiana jako połączenie innych list i zainteresowań użytkowników. |
EXTERNAL_REMARKETING |
Lista użytkowników utworzona na platformie Google Ad Manager. |
RULE_BASED |
Lista użytkowników powiązana z regułą. |
SIMILAR |
UserList z użytkownikami podobnymi do użytkowników innej listy. |
CRM_BASED |
Lista użytkowników zawierająca własne dane z systemu CRM przekazane przez reklamodawcę w postaci e-maili lub innych formatów. |
WebpageView
Widok strony internetowej.
Zapis JSON |
---|
{ "resourceName": string } |
Pola | |
---|---|
resourceName |
Nazwa zasobu widoku strony internetowej. Nazwy zasobów wyświetleń stron internetowych mają postać:
|
Wejdź na
Wizyta.
Zapis JSON |
---|
{ "resourceName": string, "id": string, "criterionId": string, "merchantId": string, "adId": string, "clickId": string, "visitDateTime": string, "productId": string, "productChannel": enum ( |
Pola | |
---|---|
resourceName |
Nazwa zasobu wizyty. Nazwy zasobów wizyt mają postać:
|
id |
Identyfikator wizyty. |
criterionId |
Identyfikator słowa kluczowego w Search Ads 360. Wartość 0 oznacza, że słowo kluczowe nie jest przypisane. |
merchantId |
Identyfikator konta asortymentowego Search Ads 360 zawierający kliknięty produkt. Search Ads 360 generuje ten identyfikator po połączeniu z nią konta asortymentowego. |
adId |
Identyfikator reklamy. Wartość 0 oznacza, że reklama nie jest przypisana. |
clickId |
Unikalny ciąg znaków dla każdej wizyty przekazywany do strony docelowej jako parametr adresu URL identyfikatora kliknięcia. |
visitDateTime |
Sygnatura czasowa zdarzenia wizyty. Sygnatura czasowa jest podana w strefie czasowej klienta i w formacie „rrrr-MM-dd GG:mm:ss”. |
productId |
Identyfikator klikniętego produktu. |
productChannel |
Kanał sprzedaży produktu, który został kliknięty: online lub lokalny. |
productLanguageCode |
Język (ISO-639-1) ustawiony dla pliku danych Merchant Center zawierającego dane produktu. |
productStoreId |
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. |
productCountryCode |
Kraj (w formacie ISO-3166) zarejestrowany w pliku danych o asortymencie zawierającym kliknięty produkt. |
assetId |
Identyfikator zasobu, z którym nastąpiła interakcja podczas wizyty. |
assetFieldType |
Typ pola komponentu zdarzenia wizyty. |
ProductChannel
Wartość Enum opisująca miejscowość oferty produktu.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji. |
ONLINE |
Produkt jest sprzedawany online. |
LOCAL |
Produkt jest sprzedawany w lokalnych sklepach. |
Konwersje
Konwersja.
Zapis JSON |
---|
{ "resourceName": string, "id": string, "criterionId": string, "merchantId": string, "adId": string, "clickId": string, "visitId": string, "advertiserConversionId": string, "productId": string, "productChannel": enum ( |
Pola | |
---|---|
resourceName |
Nazwa zasobu konwersji. Nazwy zasobów konwersji mają postać:
|
id |
Identyfikator konwersji |
criterionId |
Identyfikator kryterium Search Ads 360. Wartość 0 oznacza, że kryterium nie jest przypisane. |
merchantId |
Identyfikator konta asortymentowego Search Ads 360 zawierający kliknięty produkt. Search Ads 360 generuje ten identyfikator po połączeniu z nią konta asortymentowego. |
adId |
Identyfikator reklamy. Wartość 0 oznacza, że reklama nie jest przypisana. |
clickId |
Niepowtarzalny ciąg znaków reprezentujący wizytę, do której przypisano konwersję, przekazywany do strony docelowej jako parametr adresu URL identyfikatora kliknięcia. |
visitId |
Identyfikator wizyty w Search Ads 360, do której jest przypisana konwersja. |
advertiserConversionId |
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 floodlightOrderId w zależności od instrukcji Floodlight reklamodawcy. |
productId |
Identyfikator klikniętego produktu. |
productChannel |
Kanał sprzedaży produktu, który został kliknięty: online lub lokalny. |
productLanguageCode |
Język (ISO-639-1) ustawiony dla pliku danych Merchant Center zawierającego dane produktu. |
productStoreId |
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. |
productCountryCode |
Kraj (w formacie ISO-3166) zarejestrowany w pliku danych o asortymencie zawierającym kliknięty produkt. |
attributionType |
Do czego przypisana jest konwersja: wizyta lub słowo kluczowe+reklama. |
conversionDateTime |
Sygnatura czasowa zdarzenia konwersji. |
conversionLastModifiedDateTime |
Sygnatura czasowa ostatniej modyfikacji konwersji. |
conversionVisitDateTime |
Sygnatura czasowa wizyty, do której przypisano konwersję. |
conversionQuantity |
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. |
conversionRevenueMicros |
Skorygowane przychody w mikro dla zdarzenia konwersji. Będzie ona zawsze podana w walucie konta wyświetlania reklam. |
floodlightOriginalRevenue |
Pierwotne, niezmienione przychody powiązane ze zdarzeniem Floodlight (w walucie bieżącego raportu) przed zmianami w instrukcji waluty Floodlight. |
floodlightOrderId |
Identyfikator zamówienia Floodlight podany przez reklamodawcę na potrzeby konwersji. |
status |
Stan konwersji: WŁĄCZONA lub USUNIĘTA. |
assetId |
Identyfikator zasobu, z którym nastąpiła interakcja podczas zdarzenia konwersji. |
assetFieldType |
Typ pola zasobu zdarzenia konwersji. |
AttributionType
Typ atrybucji konwersji w Search Ads 360
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji. |
VISIT |
Konwersja jest przypisywana do wizyty. |
CRITERION_AD |
Konwersja jest przypisywana do pary kryterium i reklam. |
ConversionStatus
Możliwe stany konwersji.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji. |
ENABLED |
Konwersja jest włączona. |
REMOVED |
Konwersja została usunięta. |
Wskaźniki
Dane wskaźników.
Zapis JSON |
---|
{ "allConversionsValueByConversionDate": number, "allConversionsByConversionDate": number, "conversionCustomMetrics": [ { object ( |
Pola | |
---|---|
allConversionsValueByConversionDate |
Wartość wszystkich konwersji. Jeśli wybierzesz tę kolumnę z datą, wartości w kolumnie „Data” będą oznaczać datę konwersji. Szczegółowe informacje o kolumnach „by_conversion_date” znajdziesz na https://support.google.com/sa360/answer/9250611. |
allConversionsByConversionDate |
Łączna liczba konwersji. Obejmuje to wszystkie konwersje niezależnie od wartości includeInConversionMetric. Jeśli wybierzesz tę kolumnę z datą, wartości w kolumnie „Data” będą oznaczać datę konwersji. Szczegółowe informacje o kolumnach „by_conversion_date” znajdziesz na https://support.google.com/sa360/answer/9250611. |
conversionCustomMetrics[] |
Niestandardowe dane konwersji. |
conversionsValueByConversionDate |
Suma wartości konwersji z możliwością określenia stawki według daty konwersji. Jeśli wybierzesz tę kolumnę z datą, wartości w kolumnie „Data” będą oznaczać datę konwersji. |
conversionsByConversionDate |
Suma konwersji według daty konwersji dla typów konwersji z możliwością określenia stawki. Wartość może być cząstkowa ze względu na modelowanie atrybucji. Jeśli wybierzesz tę kolumnę z datą, wartości w kolumnie „Data” będą oznaczać datę konwersji. |
historicalCreativeQualityScore |
Historyczny wynik jakości kreacji. |
historicalLandingPageQualityScore |
Jakość historycznej oceny jakości strony docelowej. |
historicalSearchPredictedCtr |
Historyczny przewidywany współczynnik klikalności (CTR) w wyszukiwarce. |
interactionEventTypes[] |
Rodzaje płatnych i bezpłatnych interakcji. |
rawEventConversionMetrics[] |
Nieprzetworzone dane o konwersjach zdarzenia. |
absoluteTopImpressionPercentage |
Udział w wyświetleniach na najwyższej pozycji na stronie z sieci wyszukiwania to odsetek wyświetleń reklamy w sieci wyszukiwania na najbardziej widocznej pozycji na stronie wyników wyszukiwania. |
allConversionsFromInteractionsRate |
Wszystkie konwersje z interakcji (w przeciwieństwie do konwersji po obejrzeniu) podzielone przez liczbę interakcji z reklamą. |
allConversionsValue |
Wartość wszystkich konwersji. |
allConversions |
Łączna liczba konwersji. Obejmuje to wszystkie konwersje niezależnie od wartości includeInConversionMetric. |
allConversionsValuePerCost |
Wartość wszystkich konwersji podzielona przez łączny koszt interakcji z reklamą (np. kliknięć reklam tekstowych lub obejrzeń reklam wideo). |
allConversionsFromClickToCall |
Tyle razy użytkownicy kliknęli przycisk „Zadzwoń”, aby zadzwonić do sklepu w trakcie lub po kliknięciu reklamy. Ten numer nie zawiera informacji o tym, czy połączenie zostało odebrane ani ile trwało. Te dane dotyczą tylko elementów w pliku danych. |
allConversionsFromDirections |
Tyle razy użytkownicy kliknęli przycisk „Wyznacz trasę”, aby wyznaczyć trasę dojazdu do sklepu po kliknięciu reklamy. Te dane dotyczą tylko elementów w pliku danych. |
allConversionsFromInteractionsValuePerInteraction |
Wartość wszystkich konwersji z interakcji podzielona przez łączną liczbę interakcji. |
allConversionsFromMenu |
Tyle razy użytkownicy kliknęli link, aby wyświetlić menu sklepu po kliknięciu reklamy. Te dane dotyczą tylko elementów w pliku danych. |
allConversionsFromOrder |
Tyle razy użytkownicy złożyli zamówienie w sklepie po kliknięciu reklamy. Te dane dotyczą tylko elementów w pliku danych. |
allConversionsFromOtherEngagement |
Tyle razy użytkownicy zrealizowali inną konwersję (np. opublikowali opinię albo zapisali lokalizację sklepu) po kliknięciu reklamy. Te dane dotyczą tylko elementów w pliku danych. |
allConversionsFromStoreVisit |
Szacunkowa liczba wizyt użytkowników w sklepie po kliknięciu reklamy. Te dane dotyczą tylko elementów w pliku danych. |
visits |
Kliknięcia zarejestrowane przez Search Ads 360 i przekazane na stronę docelową reklamodawcy. |
allConversionsFromStoreWebsite |
Tyle razy użytkownicy zostali przekierowani na adres URL sklepu po kliknięciu reklamy. Te dane dotyczą tylko elementów w pliku danych. |
averageCost |
Średnia kwota, jaką płacisz za interakcję. To iloraz łącznego kosztu reklam i całkowitej liczby interakcji. |
averageCpc |
Łączny koszt wszystkich kliknięć podzielony przez łączną liczbę uzyskanych kliknięć. Te dane mają wartość pieniężną i domyślnie zwracają ją w walucie klienta. Parametr metric_currency znajdziesz na https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
averageCpm |
Średni koszt tysiąca wyświetleń (CPM). Te dane mają wartość pieniężną i domyślnie zwracają ją w walucie klienta. Parametr metric_currency znajdziesz na https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
clicks |
Liczba kliknięć. |
contentBudgetLostImpressionShare |
Szacowany odsetek przypadków, w których reklama mogła się wyświetlić w sieci reklamowej, ale tak się nie stało z powodu zbyt niskiego budżetu. Uwaga: utracony udział w wyświetleniach przez budżet treści jest raportowany w zakresie od 0 do 0,9. Każda wartość powyżej 0,9 jest zgłaszana jako 0,9001. |
contentImpressionShare |
Liczba otrzymanych wyświetleń w sieci reklamowej podzielona przez szacunkową liczbę wyświetleń, które można było uzyskać. Uwaga: udział w wyświetleniach w sieci reklamowej jest raportowany w zakresie od 0,1 do 1. Każda wartość mniejsza niż 0,1 jest zgłaszana jako 0,0999. |
contentRankLostImpressionShare |
Szacowany odsetek wyświetleń w sieci reklamowej, których reklamy nie uzyskały z powodu niskiego rankingu reklamy. Uwaga: utracony udział w wyświetleniach w rankingu treści jest raportowany w zakresie od 0 do 0,9. Każda wartość powyżej 0,9 jest zgłaszana jako 0,9001. |
conversionsFromInteractionsRate |
Średnia liczba konwersji z możliwością określenia stawki (z interakcji) na odpowiednią interakcję w ramach konwersji. Pokazuje, jak często, średnio licząc, interakcja z reklamą prowadzi do konwersji z możliwością określenia stawki. |
clientAccountConversionsValue |
Wartość konwersji na koncie klienta. Dotyczy to tylko działań powodujących konwersję, w przypadku których atrybut includeInClientAccountKonwersjeMetric ma wartość Prawda. Jeśli korzystasz z określania stawek na podstawie konwersji, Twoje strategie ustalania stawek zostaną zoptymalizowane pod kątem tych konwersji. |
conversionsValuePerCost |
Wartość konwersji z możliwością określenia stawki podzielona przez łączny koszt interakcji odpowiednich do konwersji. |
conversionsFromInteractionsValuePerInteraction |
Wartość konwersji z interakcji podzielona przez liczbę interakcji z reklamą. Dotyczy to tylko działań powodujących konwersję, w przypadku których atrybut includeInConversionMetric ma wartość Prawda. Jeśli korzystasz z określania stawek na podstawie konwersji, Twoje strategie ustalania stawek zostaną zoptymalizowane pod kątem tych konwersji. |
clientAccountConversions |
Liczba konwersji na koncie klienta. Dotyczy to tylko działań powodujących konwersję, w przypadku których atrybut includeInClientAccountKonwersjeMetric ma wartość Prawda. Jeśli korzystasz z określania stawek na podstawie konwersji, Twoje strategie ustalania stawek zostaną zoptymalizowane pod kątem tych konwersji. |
costMicros |
Suma kosztów kliknięcia (CPC) i kosztu tysiąca wyświetleń (CPM) w danym okresie. Te dane mają wartość pieniężną i domyślnie zwracają ją w walucie klienta. Parametr metric_currency znajdziesz na https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
costPerAllConversions |
Koszt interakcji z reklamą podzielony przez łączną liczbę konwersji. |
costPerConversion |
Średni kwalifikujący się koszt konwersji z możliwością określenia stawki. |
costPerCurrentModelAttributedConversion |
Koszt interakcji z reklamą podzielony przez liczbę konwersji przypisanych w bieżącym modelu. Dotyczy to tylko działań powodujących konwersję, w przypadku których atrybut includeInConversionMetric ma wartość Prawda. Jeśli korzystasz z określania stawek na podstawie konwersji, Twoje strategie ustalania stawek zostaną zoptymalizowane pod kątem tych konwersji. |
crossDeviceConversions |
Konwersje polegające na tym, że klient kliknie reklamę na jednym urządzeniu, a potem dokona konwersji na innym urządzeniu lub w innej przeglądarce. Konwersje na różnych urządzeniach są już uwzględnione w kolumnie Wszystkie konwersje. |
crossDeviceConversionsValue |
Suma wartości konwersji na różnych urządzeniach. |
ctr |
Liczba kliknięć reklamy (kliknięcia) podzielona przez liczbę jej wyświetleń. |
conversions |
Liczba konwersji. Dotyczy to tylko działań powodujących konwersję, w przypadku których atrybut includeInConversionMetric ma wartość Prawda. Jeśli korzystasz z określania stawek na podstawie konwersji, Twoje strategie ustalania stawek zostaną zoptymalizowane pod kątem tych konwersji. |
conversionsValue |
Suma wartości konwersji uwzględnionych w polu „Konwersje”. Te dane są przydatne tylko w przypadku, gdy wpiszesz wartość działań powodujących konwersję. |
historicalQualityScore |
Historyczny wynik jakości. |
impressions |
Liczba wyświetleń reklamy na stronie wyników wyszukiwania lub w witrynie w sieci Google. |
interactionRate |
Jak często użytkownicy po zobaczeniu reklamy wchodzą z nią w interakcję. Jest to liczba interakcji podzielona przez liczbę wyświetleń reklamy. |
interactions |
Liczba interakcji. Interakcja to główne działanie użytkownika związane z takim formatem reklamy: kliknięciami reklam tekstowych i produktowych, wyświetleniami reklam wideo itd. |
invalidClickRate |
Odsetek odfiltrowanych kliknięć z łącznej liczby kliknięć (odfiltrowanych i nieodfiltrowanych) w okresie raportowania. |
invalidClicks |
Liczba kliknięć, które Google uznaje za nielegalne i nie pobiera za nie opłat. |
mobileFriendlyClicksPercentage |
Odsetek kliknięć z komórek, które prowadzą na stronę dostosowaną do komórek. |
searchAbsoluteTopImpressionShare |
Odsetek wyświetleń reklamy produktowej lub reklamy w wyszukiwarce klienta na najwyższej pozycji na stronie w przypadku kampanii produktowych. Więcej informacji znajdziesz na stronie https://support.google.com/sa360/answer/9566729. Każda wartość mniejsza niż 0,1 jest zgłaszana jako 0,0999. |
searchBudgetLostAbsoluteTopImpressionShare |
Liczba określająca, jak często Twoja reklama nie była pierwszą reklamą na liście wyników wyszukiwania z powodu niskiego budżetu. Uwaga: utracony udział w wyświetleniach na najwyższej pozycji na stronie (budżet) jest raportowany w zakresie od 0 do 0,9. Każda wartość powyżej 0,9 jest zgłaszana jako 0,9001. |
searchBudgetLostImpressionShare |
Przybliżony odsetek przypadków, gdy reklama mogła wyświetlić się w sieci wyszukiwania, ale tak się nie stało z powodu zbyt niskiego budżetu. Uwaga: utracony udział w wyświetleniach z budżetu w sieci wyszukiwania jest raportowany w zakresie od 0 do 0,9. Każda wartość powyżej 0,9 jest zgłaszana jako 0,9001. |
searchBudgetLostTopImpressionShare |
Liczba określająca, jak często Twoja reklama nie wyświetliła się obok najlepszych bezpłatnych wyników wyszukiwania z powodu niskiego budżetu. Uwaga: utracony udział w wyświetleniach u góry strony z budżetu w sieci wyszukiwania jest raportowany w zakresie od 0 do 0,9. Każda wartość powyżej 0,9 jest zgłaszana jako 0,9001. |
searchClickShare |
Liczba kliknięć otrzymanych w sieci wyszukiwania podzielona przez szacowaną liczbę kliknięć możliwych do uzyskania. Uwaga: udział w kliknięciach z sieci wyszukiwania jest raportowany w zakresie od 0,1 do 1. Każda wartość mniejsza niż 0,1 jest zgłaszana jako 0,0999. |
searchExactMatchImpressionShare |
Liczba uzyskanych wyświetleń podzielona przez szacunkową liczbę wyświetleń możliwych do uzyskania w sieci wyszukiwania dla wyszukiwanych haseł, które dokładnie pasowały do Twoich słów kluczowych (lub były ich bliskimi odmianami), niezależnie od typów dopasowania słów kluczowych. Uwaga: udział w wyświetleniach przy dopasowaniu ścisłym z sieci wyszukiwania jest raportowany w zakresie od 0,1 do 1. Każda wartość mniejsza niż 0,1 jest zgłaszana jako 0,0999. |
searchImpressionShare |
Liczba otrzymanych wyświetleń w sieci wyszukiwania podzielona przez szacunkową liczbę wyświetleń możliwych do uzyskania. Uwaga: udział w wyświetleniach z sieci wyszukiwania jest raportowany w zakresie od 0,1 do 1. Każda wartość mniejsza niż 0,1 jest zgłaszana jako 0,0999. |
searchRankLostAbsoluteTopImpressionShare |
Liczba określająca, jak często Twoja reklama nie była pierwszą reklamą na liście wyników wyszukiwania z powodu niskiego rankingu reklamy. Uwaga: utrata udziału w wyświetleniach na najwyższej pozycji na stronie w wyszukiwarce jest podawana w zakresie od 0 do 0,9. Każda wartość powyżej 0,9 jest zgłaszana jako 0,9001. |
searchRankLostImpressionShare |
Szacowany odsetek wyświetleń w sieci wyszukiwania, których reklamy nie uzyskały z powodu niskiego rankingu reklamy. Uwaga: utracony udział w wyświetleniach w rankingu w wyszukiwarce jest raportowany w zakresie od 0 do 0,9. Każda wartość powyżej 0,9 jest zgłaszana jako 0,9001. |
searchRankLostTopImpressionShare |
Liczba określająca, jak często Twoja reklama nie wyświetliła się obok najlepszych bezpłatnych wyników wyszukiwania z powodu niskiego rankingu reklamy. Uwaga: utracony udział w wyświetleniach u góry strony w rankingu wyszukiwania jest raportowany w zakresie od 0 do 0,9. Każda wartość powyżej 0,9 jest zgłaszana jako 0,9001. |
searchTopImpressionShare |
Liczba uzyskanych wyświetleń najpopularniejszych reklam w porównaniu z szacunkową liczbą możliwych wyświetleń najlepszych reklam. Uwaga: udział w wyświetleniach u góry strony z sieci wyszukiwania jest raportowany w zakresie od 0,1 do 1. Każda wartość mniejsza niż 0,1 jest zgłaszana jako 0,0999. Reklamy u góry strony znajdują się zwykle nad najlepszymi bezpłatnymi wynikami wyszukiwania, jednak w przypadku niektórych zapytań mogą się wyświetlać pod nimi. |
topImpressionPercentage |
Odsetek wyświetleń reklam obok najwyższych bezpłatnych wyników wyszukiwania. |
valuePerAllConversions |
Wartość wszystkich konwersji podzielona przez liczbę wszystkich konwersji. |
valuePerAllConversionsByConversionDate |
Wartość wszystkich konwersji podzielona przez liczbę wszystkich konwersji. Jeśli wybierzesz tę kolumnę z datą, wartości w kolumnie „Data” będą oznaczać datę konwersji. Szczegółowe informacje o kolumnach „by_conversion_date” znajdziesz na https://support.google.com/sa360/answer/9250611. |
valuePerConversion |
Wartość konwersji z możliwością określenia stawki podzielona przez liczbę takich konwersji. Wskazuje średnią wartość każdej konwersji z możliwością określenia stawki. |
valuePerConversionsByConversionDate |
Wartość konwersji z możliwością określenia stawki według daty konwersji podzielona przez liczbę konwersji z możliwością określenia stawki według daty konwersji. Pokazuje, ile jest średnio warta każda konwersja z możliwością określenia stawki (wg daty konwersji). Jeśli wybierzesz tę kolumnę z datą, wartości w kolumnie „Data” będą oznaczać datę konwersji. |
clientAccountViewThroughConversions |
Łączna liczba konwersji po wyświetleniu. Dzieje się tak, gdy klient widzi reklamę graficzną lub multimedialną, a potem dokonuje konwersji w Twojej witrynie bez wchodzenia z nią w interakcję (np. kliknięcia). |
clientAccountCrossSellCostOfGoodsSoldMicros |
Koszt własny sprzedaży krzyżowej na koncie klienta to łączny koszt produktów sprzedanych dzięki reklamom innego produktu. Jak to działa: raportujesz konwersje z danymi koszyka w przypadku ukończonych zakupów w Twojej witrynie. Jeśli reklama, z którą nastąpiła interakcja przed zakupem, ma powiązany produkt (patrz Reklamy produktowe), jest on produktem reklamowanym. Każdy produkt uwzględniony w zamówieniu, które złożył klient, jest produktem sprzedanym. Jeśli te produkty się różnią, uznajemy to za sprzedaż krzyżową. Koszt własny sprzedaży krzyżowej to łączny koszt sprzedanych produktów, które nie były reklamowane. Przykład: użytkownik kliknął reklamę produktową kapelusza, a potem kupił ten kapelusz oraz koszulę. Koszt własny sprzedaży kapelusza wynosi 3 zł, a koszuli – 5 zł. Koszt własny sprzedaży krzyżowej tego zamówienia wynosi 5 zł. Te dane są dostępne tylko wtedy, gdy rejestrujesz konwersje z danymi koszyka. Te dane mają wartość pieniężną i domyślnie zwracają ją w walucie klienta. Parametr metric_currency znajdziesz na https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
crossSellCostOfGoodsSoldMicros |
Koszt własny sprzedaży krzyżowej to łączny koszt produktów sprzedanych dzięki reklamom innego produktu. Jak to działa: raportujesz konwersje z danymi koszyka w przypadku ukończonych zakupów w Twojej witrynie. Jeśli reklama, z którą nastąpiła interakcja przed zakupem, ma powiązany produkt (patrz Reklamy produktowe), jest on produktem reklamowanym. Każdy produkt uwzględniony w zamówieniu, które złożył klient, jest produktem sprzedanym. Jeśli te produkty się różnią, uznajemy to za sprzedaż krzyżową. Koszt własny sprzedaży krzyżowej to łączny koszt sprzedanych produktów, które nie były reklamowane. Przykład: użytkownik kliknął reklamę produktową kapelusza, a potem kupił ten kapelusz oraz koszulę. Koszt własny sprzedaży kapelusza wynosi 3 zł, a koszuli – 5 zł. Koszt własny sprzedaży krzyżowej tego zamówienia wynosi 5 zł. Te dane są dostępne tylko wtedy, gdy rejestrujesz konwersje z danymi koszyka. Te dane mają wartość pieniężną i domyślnie zwracają ją w walucie klienta. Parametr metric_currency znajdziesz na https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
clientAccountCrossSellGrossProfitMicros |
Zysk brutto ze sprzedaży krzyżowej na koncie klienta to zysk ze sprzedaży produktów uzyskany dzięki reklamowaniu innego produktu i pomniejszony o koszt własny sprzedaży. Jak to działa: raportujesz konwersje z danymi koszyka w przypadku ukończonych zakupów w Twojej witrynie. Jeśli reklama, z którą nastąpiła interakcja przed zakupem, ma powiązany produkt (patrz Reklamy produktowe), jest on produktem reklamowanym. Każdy produkt objęty przez transakcję zakupu jest produktem sprzedanym. Jeśli te produkty się różnią, uznajemy to za sprzedaż krzyżową. Zysk brutto ze sprzedaży krzyżowej to przychody uzyskane ze sprzedaży krzyżowej przypisanej Twoim reklamom i pomniejszone o koszt własny sprzedaży. Przykład: użytkownik kliknął reklamę produktową kapelusza, a potem kupił ten kapelusz oraz koszulę. Cena koszuli wynosi 20 zł, a jej koszt własny sprzedaży to 5 zł. W przypadku tego zamówienia zysk brutto ze sprzedaży krzyżowej wynosi 15 zł = 20 zł – 5 zł. Te dane są dostępne tylko wtedy, gdy rejestrujesz konwersje z danymi koszyka. Te dane mają wartość pieniężną i domyślnie zwracają ją w walucie klienta. Parametr metric_currency znajdziesz na https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
crossSellGrossProfitMicros |
Zysk brutto ze sprzedaży krzyżowej to zysk ze sprzedaży produktów uzyskany dzięki reklamowaniu innego produktu i pomniejszony o koszt własny sprzedaży. Jak to działa: raportujesz konwersje z danymi koszyka w przypadku ukończonych zakupów w Twojej witrynie. Jeśli reklama, z którą nastąpiła interakcja przed zakupem, ma powiązany produkt (patrz Reklamy produktowe), jest on produktem reklamowanym. Każdy produkt objęty przez transakcję zakupu jest produktem sprzedanym. Jeśli te produkty się różnią, uznajemy to za sprzedaż krzyżową. Zysk brutto ze sprzedaży krzyżowej to przychody uzyskane ze sprzedaży krzyżowej przypisanej Twoim reklamom i pomniejszone o koszt własny sprzedaży. Przykład: użytkownik kliknął reklamę produktową kapelusza, a potem kupił ten kapelusz oraz koszulę. Cena koszuli wynosi 20 zł, a jej koszt własny sprzedaży to 5 zł. W przypadku tego zamówienia zysk brutto ze sprzedaży krzyżowej wynosi 15 zł = 20 zł – 5 zł. Te dane są dostępne tylko wtedy, gdy rejestrujesz konwersje z danymi koszyka. Te dane mają wartość pieniężną i domyślnie zwracają ją w walucie klienta. Parametr metric_currency znajdziesz na https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
clientAccountCrossSellRevenueMicros |
Przychody ze sprzedaży krzyżowej na koncie klienta to łączna kwota przychodów ze sprzedaży produktów uzyskana dzięki reklamom innych produktów. Jak to działa: raportujesz konwersje z danymi koszyka w przypadku ukończonych zakupów w Twojej witrynie. Jeśli reklama, z którą nastąpiła interakcja przed zakupem, ma powiązany produkt (patrz Reklamy produktowe), jest on produktem reklamowanym. Każdy produkt uwzględniony w zamówieniu, które złożył klient, jest produktem sprzedanym. Jeśli te produkty się różnią, uznajemy to za sprzedaż krzyżową. Przychody ze sprzedaży krzyżowej to łączna wartość przychodów uzyskanych ze sprzedaży krzyżowej przypisanych do Twoich reklam. Przykład: użytkownik kliknął reklamę produktową kapelusza, a potem kupił ten kapelusz oraz koszulę. Kapelusz kosztował 10 zł, a koszulka 20 zł. Przychody ze sprzedaży krzyżowej tego zamówienia wynoszą 20 zł. Te dane są dostępne tylko wtedy, gdy rejestrujesz konwersje z danymi koszyka. Te dane mają wartość pieniężną i domyślnie zwracają ją w walucie klienta. Parametr metric_currency znajdziesz na https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
crossSellRevenueMicros |
Przychody ze sprzedaży krzyżowej to łączna kwota przychodów ze sprzedaży produktów uzyskana dzięki reklamom innych produktów. Jak to działa: raportujesz konwersje z danymi koszyka w przypadku ukończonych zakupów w Twojej witrynie. Jeśli reklama, z którą nastąpiła interakcja przed zakupem, ma powiązany produkt (patrz Reklamy produktowe), jest on produktem reklamowanym. Każdy produkt uwzględniony w zamówieniu, które złożył klient, jest produktem sprzedanym. Jeśli te produkty się różnią, uznajemy to za sprzedaż krzyżową. Przychody ze sprzedaży krzyżowej to łączna wartość przychodów uzyskanych ze sprzedaży krzyżowej przypisanych do Twoich reklam. Przykład: użytkownik kliknął reklamę produktową kapelusza, a potem kupił ten kapelusz oraz koszulę. Kapelusz kosztował 10 zł, a koszulka 20 zł. Przychody ze sprzedaży krzyżowej tego zamówienia wynoszą 20 zł. Te dane są dostępne tylko wtedy, gdy rejestrujesz konwersje z danymi koszyka. Te dane mają wartość pieniężną i domyślnie zwracają ją w walucie klienta. Parametr metric_currency znajdziesz na https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
clientAccountCrossSellUnitsSold |
Pozycje sprzedane dzięki sprzedaży krzyżowej na koncie klienta to łączna liczba produktów sprzedanych dzięki reklamom innego produktu. Jak to działa: raportujesz konwersje z danymi koszyka w przypadku ukończonych zakupów w Twojej witrynie. Jeśli reklama, z którą nastąpiła interakcja przed zakupem, ma powiązany produkt (patrz Reklamy produktowe), jest on produktem reklamowanym. Każdy produkt uwzględniony w zamówieniu, które złożył klient, jest produktem sprzedanym. Jeśli te produkty się różnią, uznajemy to za sprzedaż krzyżową. Egzemplarze sprzedane krzyżowo to łączna liczba produktów sprzedanych dzięki sprzedaży krzyżowej w ramach wszystkich zamówień przypisanych Twoim reklamom. Przykład: użytkownik kliknął reklamę produktową kapelusza, a potem kupił ten kapelusz oraz koszulę i kurtkę. W przypadku tego zamówienia liczba pozycji sprzedanych dzięki sprzedaży krzyżowej wynosi 2. Te dane są dostępne tylko wtedy, gdy rejestrujesz konwersje z danymi koszyka. |
crossSellUnitsSold |
Egzemplarze sprzedane krzyżowo to łączna liczba produktów sprzedanych dzięki reklamom innego produktu. Jak to działa: raportujesz konwersje z danymi koszyka w przypadku ukończonych zakupów w Twojej witrynie. Jeśli reklama, z którą nastąpiła interakcja przed zakupem, ma powiązany produkt (patrz Reklamy produktowe), jest on produktem reklamowanym. Każdy produkt uwzględniony w zamówieniu, które złożył klient, jest produktem sprzedanym. Jeśli te produkty się różnią, uznajemy to za sprzedaż krzyżową. Egzemplarze sprzedane krzyżowo to łączna liczba produktów sprzedanych dzięki sprzedaży krzyżowej w ramach wszystkich zamówień przypisanych Twoim reklamom. Przykład: użytkownik kliknął reklamę produktową kapelusza, a potem kupił ten kapelusz oraz koszulę i kurtkę. W przypadku tego zamówienia liczba pozycji sprzedanych dzięki sprzedaży krzyżowej wynosi 2. Te dane są dostępne tylko wtedy, gdy rejestrujesz konwersje z danymi koszyka. |
clientAccountLeadCostOfGoodsSoldMicros |
Koszt własny potencjalnej sprzedaży na koncie klienta to łączny koszt produktów sprzedanych dzięki ich reklamowaniu. Jak to działa: raportujesz konwersje z danymi koszyka w przypadku ukończonych zakupów w Twojej witrynie. Jeśli reklama, z którą nastąpiła interakcja, jest powiązana z produktem (patrz Reklamy produktowe), jest on produktem reklamowanym. Każdy produkt uwzględniony w zamówieniu, które złożył klient, jest produktem sprzedanym. Jeśli reklamowane i sprzedane produkty pasują do siebie, ich koszt jest zaliczany do kosztu własnego potencjalnej sprzedaży. Przykład: użytkownik kliknął reklamę produktową kapelusza, a potem kupił ten kapelusz oraz koszulę. Koszt własny sprzedaży kapelusza wynosi 3 zł, a koszuli – 5 zł. W przypadku tego zamówienia potencjalny koszt własny sprzedaży wynosi 3 zł. Te dane są dostępne tylko wtedy, gdy rejestrujesz konwersje z danymi koszyka. Te dane mają wartość pieniężną i domyślnie zwracają ją w walucie klienta. Parametr metric_currency znajdziesz na https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
leadCostOfGoodsSoldMicros |
Potencjalny koszt własny sprzedaży to łączny koszt produktów sprzedanych dzięki ich reklamowaniu. Jak to działa: raportujesz konwersje z danymi koszyka w przypadku ukończonych zakupów w Twojej witrynie. Jeśli reklama, z którą nastąpiła interakcja, jest powiązana z produktem (patrz Reklamy produktowe), jest on produktem reklamowanym. Każdy produkt uwzględniony w zamówieniu, które złożył klient, jest produktem sprzedanym. Jeśli reklamowane i sprzedane produkty pasują do siebie, ich koszt jest zaliczany do kosztu własnego potencjalnej sprzedaży. Przykład: użytkownik kliknął reklamę produktową kapelusza, a potem kupił ten kapelusz oraz koszulę. Koszt własny sprzedaży kapelusza wynosi 3 zł, a koszuli – 5 zł. W przypadku tego zamówienia potencjalny koszt własny sprzedaży wynosi 3 zł. Te dane są dostępne tylko wtedy, gdy rejestrujesz konwersje z danymi koszyka. Te dane mają wartość pieniężną i domyślnie zwracają ją w walucie klienta. Parametr metric_currency znajdziesz na https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
clientAccountLeadGrossProfitMicros |
Potencjalny zysk brutto na koncie klienta to zysk ze sprzedaży produktów uzyskany dzięki ich reklamowaniu i pomniejszony o koszt własny sprzedaży. Jak to działa: raportujesz konwersje z danymi koszyka w przypadku ukończonych zakupów w Twojej witrynie. Jeśli reklama, z którą nastąpiła interakcja przed zakupem, ma powiązany produkt (patrz Reklamy produktowe), jest on produktem reklamowanym. Każdy produkt uwzględniony w zamówieniu, które złożył klient, jest produktem sprzedanym. Jeśli reklamowane i sprzedane produkty pasują do siebie, przychody z tej sprzedaży pomniejszone o koszt własny sprzedaży to Twój potencjalny zysk brutto. Przykład: użytkownik kliknął reklamę produktową kapelusza, a potem kupił ten kapelusz oraz koszulę. Cena kapelusza wynosi 10 zł, a jego koszt własny sprzedaży to 3 zł. Potencjalny zysk brutto z tego zamówienia wynosi 7 zł = 10 zł – 3 zł. Te dane są dostępne tylko wtedy, gdy rejestrujesz konwersje z danymi koszyka. Te dane mają wartość pieniężną i domyślnie zwracają ją w walucie klienta. Parametr metric_currency znajdziesz na https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
leadGrossProfitMicros |
Potencjalny zysk brutto to zysk ze sprzedaży produktów uzyskany dzięki ich reklamowaniu i pomniejszony o koszt własny sprzedaży. Jak to działa: raportujesz konwersje z danymi koszyka w przypadku ukończonych zakupów w Twojej witrynie. Jeśli reklama, z którą nastąpiła interakcja przed zakupem, ma powiązany produkt (patrz Reklamy produktowe), jest on produktem reklamowanym. Każdy produkt uwzględniony w zamówieniu, które złożył klient, jest produktem sprzedanym. Jeśli reklamowane i sprzedane produkty pasują do siebie, przychody z tej sprzedaży pomniejszone o koszt własny sprzedaży to Twój potencjalny zysk brutto. Przykład: użytkownik kliknął reklamę produktową kapelusza, a potem kupił ten kapelusz oraz koszulę. Cena kapelusza wynosi 10 zł, a jego koszt własny sprzedaży to 3 zł. Potencjalny zysk brutto z tego zamówienia wynosi 7 zł = 10 zł – 3 zł. Te dane są dostępne tylko wtedy, gdy rejestrujesz konwersje z danymi koszyka. Te dane mają wartość pieniężną i domyślnie zwracają ją w walucie klienta. Parametr metric_currency znajdziesz na https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
clientAccountLeadRevenueMicros |
Potencjalne przychody na koncie klienta to łączna kwota uzyskana ze sprzedaży produktów dzięki reklamom tych produktów. Jak to działa: raportujesz konwersje z danymi koszyka w przypadku ukończonych zakupów w Twojej witrynie. Jeśli reklama, z którą nastąpiła interakcja przed zakupem, ma powiązany produkt (patrz Reklamy produktowe), jest on produktem reklamowanym. Każdy produkt uwzględniony w zamówieniu, które złożył klient, jest produktem sprzedanym. Jeśli reklamowane i sprzedane produkty są takie same, łączna wartość przychodów ze sprzedaży tych produktów jest wyświetlana w sekcji potencjalnych przychodów. Przykład: użytkownik kliknął reklamę produktową kapelusza, a potem kupił ten kapelusz oraz koszulę. Kapelusz kosztował 10 zł, a koszulka 20 zł. Potencjalne przychody z tego zamówienia wynoszą 10 zł. Te dane są dostępne tylko wtedy, gdy rejestrujesz konwersje z danymi koszyka. Te dane mają wartość pieniężną i domyślnie zwracają ją w walucie klienta. Parametr metric_currency znajdziesz na https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
leadRevenueMicros |
Potencjalne przychody to łączna kwota uzyskana ze sprzedaży produktów dzięki reklamom tych produktów. Jak to działa: raportujesz konwersje z danymi koszyka w przypadku ukończonych zakupów w Twojej witrynie. Jeśli reklama, z którą nastąpiła interakcja przed zakupem, ma powiązany produkt (patrz Reklamy produktowe), jest on produktem reklamowanym. Każdy produkt uwzględniony w zamówieniu, które złożył klient, jest produktem sprzedanym. Jeśli reklamowane i sprzedane produkty są takie same, łączna wartość przychodów ze sprzedaży tych produktów jest wyświetlana w sekcji potencjalnych przychodów. Przykład: użytkownik kliknął reklamę produktową kapelusza, a potem kupił ten kapelusz oraz koszulę. Kapelusz kosztował 10 zł, a koszulka 20 zł. Potencjalne przychody z tego zamówienia wynoszą 10 zł. Te dane są dostępne tylko wtedy, gdy rejestrujesz konwersje z danymi koszyka. Te dane mają wartość pieniężną i domyślnie zwracają ją w walucie klienta. Parametr metric_currency znajdziesz na https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
clientAccountLeadUnitsSold |
Potencjalna liczba sprzedanych egzemplarzy na koncie klienta to łączna liczba produktów sprzedanych dzięki ich reklamowaniu. Jak to działa: raportujesz konwersje z danymi koszyka w przypadku ukończonych zakupów w Twojej witrynie. Jeśli reklama, z którą nastąpiła interakcja przed zakupem, ma powiązany produkt (patrz Reklamy produktowe), jest on produktem reklamowanym. Każdy produkt uwzględniony w zamówieniu, które złożył klient, jest produktem sprzedanym. Jeśli reklamowane i sprzedane produkty pasują do siebie, łączna liczba sprzedanych produktów jest widoczna w kolumnie potencjalnej liczby sprzedanych egzemplarzy. Przykład: użytkownik kliknął reklamę produktową kapelusza, a potem kupił ten kapelusz oraz koszulę i kurtkę. Potencjalna liczba sprzedanych egzemplarzy w ramach tego zamówienia to 1. Te dane są dostępne tylko wtedy, gdy rejestrujesz konwersje z danymi koszyka. |
leadUnitsSold |
Potencjalna liczba sprzedanych egzemplarzy to łączna liczba produktów sprzedanych dzięki ich reklamowaniu. Jak to działa: raportujesz konwersje z danymi koszyka w przypadku ukończonych zakupów w Twojej witrynie. Jeśli reklama, z którą nastąpiła interakcja przed zakupem, ma powiązany produkt (patrz Reklamy produktowe), jest on produktem reklamowanym. Każdy produkt uwzględniony w zamówieniu, które złożył klient, jest produktem sprzedanym. Jeśli reklamowane i sprzedane produkty pasują do siebie, łączna liczba sprzedanych produktów jest widoczna w kolumnie potencjalnej liczby sprzedanych egzemplarzy. Przykład: użytkownik kliknął reklamę produktową kapelusza, a potem kupił ten kapelusz oraz koszulę i kurtkę. Potencjalna liczba sprzedanych egzemplarzy w ramach tego zamówienia to 1. Te dane są dostępne tylko wtedy, gdy rejestrujesz konwersje z danymi koszyka. |
Wartość
Ogólny kontener danych.
Zapis JSON |
---|
{ // Union field |
Pola | |
---|---|
Pole sumy value . Wartość. value może być tylko jedną z tych wartości: |
|
booleanValue |
Wartość logiczna. |
int64Value |
Int64. |
floatValue |
Pływające. |
doubleValue |
Dublet. |
stringValue |
Ciąg znaków. |
QualityScoreBucket
Wymienia listę możliwych segmentów wyniku jakości.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji. |
BELOW_AVERAGE |
Jakość kreacji jest poniżej przeciętnej. |
AVERAGE |
Jakość kreacji jest średnia. |
ABOVE_AVERAGE |
Jakość kreacji jest powyżej średniej. |
InteractionEventType
Wartość Enum opisująca możliwe typy płatnych i bezpłatnych interakcji.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji. |
CLICK |
Kliknij, aby przejść do witryny. W większości przypadków ta interakcja prowadzi do lokalizacji zewnętrznej, zwykle na stronę docelową reklamodawcy. Jest to też domyślny typ InteractionEventType w przypadku zdarzeń kliknięcia. |
ENGAGEMENT |
Wyrazieniu przez użytkownika zamiaru wejścia w interakcję z reklamą w miejscu docelowym |
VIDEO_VIEW |
Użytkownik obejrzał reklamę wideo. |
NONE |
Domyślny typ InteractionEventType w przypadku zdarzeń konwersji z reklam. Jest ona wykorzystywana, gdy wiersz konwersji z reklam NIE wskazuje, że bezpłatne interakcje (np. konwersje z reklamą) powinny być „promowane” i raportowane w ramach podstawowych danych. Są to po prostu inne konwersje (reklamy). |
Segmenty
Pola tylko do podziału na segmenty.
Zapis JSON |
---|
{ "adNetworkType": enum ( |
Pola | |
---|---|
adNetworkType |
Typ sieci reklamowej. |
conversionActionCategory |
Kategoria działań powodujących konwersję. |
conversionCustomDimensions[] |
Wymiary niestandardowe konwersji. |
dayOfWeek |
Dzień tygodnia, na przykład MONDAY. |
device |
Urządzenie, do którego mają zastosowanie dane. |
keyword |
Kryterium słowa kluczowego. |
productChannel |
Kanał produktu. |
productChannelExclusivity |
Wyłączność kanału, na którym kierowany jest produkt. |
productCondition |
Stan produktu. |
productSoldCondition |
Stan sprzedawanego produktu. |
rawEventConversionDimensions[] |
Nieprzetworzone wymiary konwersji zdarzenia. |
conversionAction |
Nazwa zasobu działania powodującego konwersję. |
conversionActionName |
Nazwa działania powodującego konwersję. |
date |
Data, do której mają zastosowanie dane. Format rrrr-MM-dd, np. 2018-04-17. |
month |
Miesiąc w formie dnia pierwszego dnia miesiąca. Format to rrrr-MM-dd. |
productBiddingCategoryLevel1 |
Kategoria ustalania stawek (poziom 1) produktu. |
productBiddingCategoryLevel2 |
Kategoria ustalania stawek (poziom 2) produktu. |
productBiddingCategoryLevel3 |
Kategoria ustalania stawek (poziom 3) produktu. |
productBiddingCategoryLevel4 |
Kategoria ustalania stawek (poziom 4) produktu. |
productBiddingCategoryLevel5 |
Kategoria ustalania stawek (poziom 5) produktu. |
productBrand |
Marka produktu. |
productCountry |
Nazwa zasobu stałej kierowania geograficznego dla kraju sprzedaży produktu. |
productCustomAttribute0 |
Atrybut niestandardowy 0 produktu. |
productCustomAttribute1 |
Atrybut niestandardowy 1 produktu. |
productCustomAttribute2 |
Atrybut niestandardowy 2 produktu. |
productCustomAttribute3 |
Atrybut niestandardowy 3 produktu. |
productCustomAttribute4 |
Atrybut niestandardowy 4 produktu. |
productItemId |
Identyfikator produktu. |
productLanguage |
Nazwa zasobu stałej języka produktu. |
productSoldBiddingCategoryLevel1 |
Kategoria ustalania stawek (poziom 1) sprzedawanego produktu. |
productSoldBiddingCategoryLevel2 |
Kategoria ustalania stawek (poziom 2) sprzedawanego produktu. |
productSoldBiddingCategoryLevel3 |
Kategoria ustalania stawek (poziom 3) sprzedawanego produktu. |
productSoldBiddingCategoryLevel4 |
Kategoria ustalania stawek (poziom 4) sprzedawanego produktu. |
productSoldBiddingCategoryLevel5 |
Kategoria ustalania stawek (poziom 5) sprzedawanego produktu. |
productSoldBrand |
Marka sprzedawanego produktu. |
productSoldCustomAttribute0 |
Atrybut niestandardowy 0 sprzedawanego produktu. |
productSoldCustomAttribute1 |
Atrybut niestandardowy 1 sprzedawanego produktu. |
productSoldCustomAttribute2 |
Atrybut niestandardowy 2 sprzedawanego produktu. |
productSoldCustomAttribute3 |
Atrybut niestandardowy 3 sprzedanego produktu. |
productSoldCustomAttribute4 |
Atrybut niestandardowy 4 sprzedawanego produktu. |
productSoldItemId |
Identyfikator sprzedanego produktu. |
productSoldTitle |
Nazwa sprzedawanego produktu. |
productSoldTypeL1 |
Typ (poziom 1) sprzedanego produktu. |
productSoldTypeL2 |
Typ (poziom 2) sprzedanego produktu. |
productSoldTypeL3 |
Typ (poziom 3) sprzedanego produktu. |
productSoldTypeL4 |
Typ (poziom 4) sprzedanego produktu. |
productSoldTypeL5 |
Typ (poziom 5) sprzedawanego produktu. |
productStoreId |
Identyfikator sklepu produktu. |
productTitle |
Nazwa produktu. |
productTypeL1 |
Typ (poziom 1) produktu. |
productTypeL2 |
Typ (poziom 2) produktu. |
productTypeL3 |
Typ (poziom 3) produktu. |
productTypeL4 |
Typ (poziom 4) produktu. |
productTypeL5 |
Typ (poziom 5) produktu. |
quarter |
Kwartał jako data pierwszego dnia kwartału. używa roku kalendarzowego w przypadku kwartałów, na przykład drugi kwartał 2018 r. zaczyna się 1 kwietnia 2018 r. Format to rrrr-MM-dd. |
week |
Tydzień zdefiniowany jako okres od poniedziałku do niedzieli, reprezentowany jako poniedziałek. Format to rrrr-MM-dd. |
year |
Rok w formacie rrrr. |
assetInteractionTarget |
Używany tylko z danymi CustomerAsset, CampaignAsset i KeywordAsset. Wskazuje, czy dane o interakcji wystąpiły z samym zasobem czy z innym zasobem lub jednostką reklamową. Interakcje (np. kliknięcia) są liczone we wszystkich częściach wyświetlanej reklamy (np. w samej reklamie i innych elementach, takich jak linki do podstron). Jeśli interakcja ma wartość Prawda, oznacza to, że interakcje są związane z konkretnym zasobem, a gdy interakcja OnThisAsset ma wartość false (fałsz), oznacza to, że interakcje nie dotyczą tego konkretnego komponentu, ale innych części reklamy, z którą ten komponent jest wyświetlany. |
AdNetworkType
Wylicza typy sieci Google Ads.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Wartość jest nieznana w tej wersji. |
SEARCH |
Wyszukiwarka Google. |
SEARCH_PARTNERS |
Partnerzy w sieci wyszukiwania. |
CONTENT |
dla sieci reklamowej |
YOUTUBE_SEARCH |
Wyszukiwarka w YouTube. |
YOUTUBE_WATCH |
Filmy w YouTube |
MIXED |
Z wielu sieci. |
Słowo kluczowe
Segment kryterium słowa kluczowego.
Zapis JSON |
---|
{
"info": {
object ( |
Pola | |
---|---|
info |
Informacje o słowie kluczowym. |
adGroupCriterion |
Nazwa zasobu GroupCriterion. |
ProductChannelExclusivity
Wyliczenie opisujące dostępność oferty produktu.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji. |
SINGLE_CHANNEL |
Produkt jest sprzedawany tylko przez jeden kanał – lokalne sklepy lub online – zgodnie z wartością tego kanału. |
MULTI_CHANNEL |
Produkt jest dopasowany do odpowiednika w sklepie internetowym lub lokalnym, co wskazuje, że można go kupić w obu kanałach ShoppingProductChannel. |
ProductCondition
Wyliczenie opisujące stan oferty produktu.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji. |
OLD |
Stan produktu jest nieaktualny. |
NEW |
Stan produktu jest nowy. |
REFURBISHED |
Stan produktu jest odnowiony. |
USED |
Stan produktu jest używany. |
AssetInteractionTarget
Segment AssetInteractionTarget.
Zapis JSON |
---|
{ "asset": string, "interactionOnThisAsset": boolean } |
Pola | |
---|---|
asset |
Nazwa zasobu zasobu. |
interactionOnThisAsset |
Używany tylko z danymi CustomerAsset, CampaignAsset i KeywordAsset. Wskazuje, czy dane o interakcji wystąpiły z samym zasobem czy z innym zasobem lub jednostką reklamową. |