- Zapis JSON
- AdGroup
- AdGroupStatus
- AdGroupType
- AdGroupAdRotationMode
- AdGroupEngineStatus
- TargetingSetting
- TargetRestriction
- TargetingDimension
- AdGroupAd
- AdGroupAdStatus
- Reklama
- AdType
- SearchAds360TextAdInfo
- SearchAds360ExpandedTextAdInfo
- SearchAds360ResponsiveSearchAdInfo
- AdTextAsset
- 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
- 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
- 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
- Strona
- ProductChannel
- Konwersja
- AttributionType
- ConversionStatus
- Dane
- 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 odnosi się zapytanie. |
adGroupAd |
Reklama, do której odwołuje się zapytanie. |
adGroupAdLabel |
Etykieta reklamy grupy reklam, do której odwołuje się zapytanie. |
adGroupAsset |
Komponent grupy reklam, do którego odwołuje się zapytanie. |
adGroupAssetSet |
Zestaw komponentów grupy reklam, do którego odwołuje się zapytanie. |
adGroupAudienceView |
Widok 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 w grupie 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 grup informacji o produktach w grupie plików, do którego odwołuje się zapytanie. |
assetGroupTopCombinationView |
Widok kombinacji u góry grupy plików, do którego 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, o której mowa w zapytaniu. |
campaignBudget |
Budżet kampanii, do którego odwołuje się zapytanie. |
campaign |
Kampania, do której odnosi się zapytanie. |
campaignAsset |
Komponent kampanii, do którego odwołuje się zapytanie. |
campaignAssetSet |
Zbiór zasobó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, do której odwołuje się zapytanie. |
conversionAction |
Działanie powodujące konwersję, do którego odwołuje się zapytanie. |
conversionCustomVariable |
Zmienna niestandardowa konwersji, do której odwołuje się zapytanie. |
customer |
Klient wskazany w zapytaniu. |
customerAsset |
Komponent klienta, do którego odwołuje się zapytanie. |
customerAssetSet |
Zbiór zasobów klienta, do którego odwołuje się zapytanie. |
accessibleBiddingStrategy |
Dostępna strategia ustalania stawek, do której odwołuje się zapytanie. |
customerManagerLink |
CustomerManagerLink, do którego odwołuje się zapytanie. |
customerClient |
Klient CustomerClient, do którego odwołuje się zapytanie. |
dynamicSearchAdsSearchTermView |
Widok wyszukiwanych haseł dynamicznych reklam w wyszukiwarce, do którego odwołuje się zapytanie |
genderView |
Widok płci, do którego odwołuje się zapytanie. |
geoTargetConstant |
Stała kierowania geograficznego, do której 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 ustalania stawek produktu, do której odwołuje się zapytanie. |
productGroupView |
Widok grupy produktów, do którego odwołuje się zapytanie. |
shoppingPerformanceView |
Widok skuteczności reklam produktowych, do którego odwołuje się zapytanie. |
userList |
Lista użytkowników, do których 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. |
Grupa reklam
Grupa reklam.
Zapis JSON |
---|
{ "resourceName": string, "status": enum ( |
Pola | |
---|---|
resourceName |
Nazwa zasobu grupy reklam. Nazwy zasobów grup reklam mają następujący format:
|
status |
Stan grupy reklam. |
type |
Typ grupy reklam. |
adRotationMode |
Tryb rotacji reklam w grupie reklam. |
creationTime |
Sygnatura czasowa określająca, kiedy grupa reklam została utworzona. Sygnatura czasowa jest podana w strefie czasowej klienta i w formacie „rrrr-MM-dd HH:mm:ss”. . |
targetingSetting |
Ustawienie kierowania na funkcje związane 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 konta innego niż Google Ads, np. Yahoo Japan, Microsoft, Baidu itp. W przypadku podmiotu Google Ads użyj „adGroup.id” . |
startDate |
Data rozpoczęcia wyświetlania reklam w tej grupie reklam. Domyślnie grupa reklam zaczyna się teraz lub data rozpoczęcia grupy reklam (w zależności od tego, co nastąpi później). Jeśli to pole jest skonfigurowane, grupa reklam rozpoczyna się w określonym dniu w strefie czasowej klienta. To pole jest dostępne tylko w przypadku kont Microsoft Advertising i Facebooka. Format: RRRR-MM-DD Przykład: 2019-03-14 |
endDate |
Data zakończenia wyświetlania reklam przez grupę reklam. Domyślnie grupa reklam kończy się w dniu określonym przez grupę reklam. Jeśli to pole jest skonfigurowane, grupa reklam kończy się o określonym dniu w strefie czasowej klienta. To pole jest dostępne tylko w przypadku kont Microsoft Advertising i Facebooka. Format: RRRR-MM-DD Przykład: 2019-03-14 |
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ą w strefie czasowej klienta i w formacie „rrrr-MM-dd HH:mm:ss.sssss”. . |
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ć znaków pustych (punkt kodowy 0x0), znaku nowego wiersza (punkt kodowy 0xA) ani znaków 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. Ta wartość dotyczy tylko odpowiedzi. |
ENABLED |
Grupa reklam jest włączona. |
PAUSED |
Grupa reklam jest wstrzymana. |
REMOVED |
Usunięto grupę reklam. |
AdGroupType
Wyliczenie listy możliwych typów w grupie reklam.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Typ nie został określony. |
UNKNOWN |
Otrzymana wartość nie jest znana w tej wersji. Ta wartość dotyczy tylko 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 wyświetlających standardowe reklamy produktów. |
SHOPPING_SHOWCASE_ADS |
Typ dla grup reklam, które są ograniczone do wyświetlania reklam z funkcją prezentacji lub reklam sprzedawców 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 wideo In-Stream niemożliwe do pominięcia |
VIDEO_TRUE_VIEW_IN_STREAM |
Reklamy wideo In-Stream TrueView (możliwe do pominięcia). |
VIDEO_TRUE_VIEW_IN_DISPLAY |
reklamy 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 produktowych z porównaniem produktów. |
PROMOTED_HOTEL_ADS |
Typ grupy reklam w grupach reklam promowanych hoteli. |
VIDEO_RESPONSIVE |
Elastyczne grupy reklam wideo. |
VIDEO_EFFICIENT_REACH |
Grupy reklam wideo typu „Zasięg” z efektywnym zasięgiem. |
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. Ta wartość dotyczy tylko odpowiedzi. |
OPTIMIZE |
Optymalizowanie reklam w grupach reklam pod kątem kliknięć lub konwersji. |
ROTATE_FOREVER |
Wyświetlaj naprzemiennie bez przerwy. |
AdGroupEngineStatus
Stan wyszukiwarki grupy reklam.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używany tylko w przypadku zwracanej wartości. Reprezentuje wartość nieznaną w tej wersji. |
AD_GROUP_ELIGIBLE |
Rola wycofana. Nie używać. |
AD_GROUP_EXPIRED |
Żadne reklamy nie są wyświetlane w tej grupie reklam, ponieważ minęła data jej zakończenia. |
AD_GROUP_REMOVED |
Grupa reklam została usunięta. |
AD_GROUP_DRAFT |
Reklamy nie są wyświetlane w tej grupie reklam, ponieważ powiązana grupa reklam jest nadal w wersji roboczej. |
AD_GROUP_PAUSED |
Grupa reklam została wstrzymana. |
AD_GROUP_SERVING |
Grupa reklam jest aktywna i obecnie wyświetla reklamy. |
AD_GROUP_SUBMITTED |
Grupa reklam została przesłana (starszy stan Microsoft Bing Ads). |
CAMPAIGN_PAUSED |
Reklamy nie są wyświetlane w tej grupie reklam, ponieważ kampania została wstrzymana. |
ACCOUNT_PAUSED |
Reklamy nie są wyświetlane w tej grupie reklam, 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 https://support.google.com/google-ads/answer/7365594.
Zapis JSON |
---|
{
"targetRestrictions": [
{
object ( |
Pola | |
---|---|
targetRestrictions[] |
Ustawienie poszczególnych wymiarów kierowania, by ograniczyć zasięg kampanii lub grupy reklam. |
TargetRestriction
Lista ustawień kierowania według wymiarów 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 na wszystkie wartości tego wymiaru kierowania i wyświetlać reklamy na podstawie ustawień 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żywany tylko w przypadku zwracanej wartości. Reprezentuje wartość nieznaną w tej wersji. |
KEYWORD |
Kryteria słów kluczowych, na przykład „rejs po marsie”. Słowo kluczowe KEYWORD może być używane jako wymiar stawki niestandardowej. Słowa kluczowe są zawsze wymiarem kierowania, więc nie można ich ustawić jako docelowego „WSZYSTKICH” z wymiarem Ograniczenie kierowania. |
AUDIENCE |
Kryteria odbiorców, które obejmują listę użytkowników, zainteresowania użytkowników, niestandardowe podobieństwo i niestandardowi odbiorcy na rynku. |
TOPIC |
Kryteria kierowania na kategorie treści, np. „category::Zwierzęta domowe>Zwierzęta domowe” Służy do kierowania w reklamach displayowych i wideo. |
GENDER |
Kryteria kierowania na płeć. |
AGE_RANGE |
Kryteria kierowania na przedziały wiekowe. |
PLACEMENT |
Kryteria miejsc docelowych, które obejmują witryny takie jak „www.flowers4sale.com”, a także aplikacje mobilne, kategorie aplikacji mobilnych, filmy i kanały w YouTube. |
PARENTAL_STATUS |
Kryteria kierowania na status rodzicielski. |
INCOME_RANGE |
Kryteria kierowania na zakres dochodu. |
AdGroupAd
Reklama z grupy reklam.
Zapis JSON |
---|
{ "resourceName": string, "status": enum ( |
Pola | |
---|---|
resourceName |
Nazwa zasobu reklamy. Nazwy zasobów reklamowych w grupie reklam mają postać:
|
status |
Stan reklamy. |
ad |
Reklama. |
creationTime |
Sygnatura czasowa określająca, kiedy utworzono daną reklamę w grupie reklam. Data i godzina są w strefie czasowej klienta i w formacie „rrrr-MM-dd HH:mm:ss.sssss”. . |
labels[] |
Nazwy zasobów etykiet dołączonych do tej reklamy należącej do grupy reklam. |
engineId |
Identyfikator reklamy na zewnętrznym koncie wyszukiwarki. To pole dotyczy tylko konta Search Ads 360, np. Yahoo Japan, Microsoft, Baidu. W przypadku elementu 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, kwalifikujące się, oczekujące na sprawdzenie itp. |
lastModifiedTime |
Data i godzina ostatniej modyfikacji reklamy z grupy reklam. Data i godzina są w strefie czasowej klienta i w formacie „rrrr-MM-dd HH:mm:ss.sssss”. . |
AdGroupAdStatus
Możliwe stany reklamyGroupAd.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono żadnej wartości. |
UNKNOWN |
Otrzymana wartość nie jest znana w tej wersji. Ta wartość dotyczy tylko odpowiedzi. |
ENABLED |
Reklama w grupie reklam jest włączona. |
PAUSED |
Reklama z grupy reklam jest wstrzymana. |
REMOVED |
Reklama z grupy reklam zostanie usunięta. |
Reklama
Reklama.
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 reklamy. |
name |
Nazwa reklamy. Pomaga nam to jedynie w identyfikacji reklamy. Nie musi być niepowtarzalna i nie ma wpływu na wyświetlaną reklamę. Pole nazwy jest obecnie obsługiwane tylko w przypadku reklam DisplayUploadAd, ImageAd, ShoppingComparisonListingAd i VideoAd. |
Pole sumy ad_data . Szczegóły dotyczące typu reklamy. Musisz ustawić dokładnie jedną wartość. ad_data może mieć tylko jedną z tych wartości: |
|
textAd |
Szczegóły dotyczące reklamy tekstowej. |
expandedTextAd |
Szczegóły dotyczące rozszerzonej reklamy tekstowej. |
responsiveSearchAd |
Szczegóły dotyczące 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 żadnej wartości. |
UNKNOWN |
Otrzymana wartość nie jest znana w tej wersji. Ta wartość dotyczy tylko odpowiedzi. |
TEXT_AD |
To reklama tekstowa. |
EXPANDED_TEXT_AD |
To rozszerzona reklama tekstowa. |
CALL_ONLY_AD |
To reklama typu „tylko połączenie”. |
EXPANDED_DYNAMIC_SEARCH_AD |
To rozszerzona dynamiczna reklama w wyszukiwarce. |
HOTEL_AD |
Ta reklama to reklama hotelu. |
SHOPPING_SMART_AD |
To jest inteligentna reklama produktowa. |
SHOPPING_PRODUCT_AD |
To standardowa reklama produktowa. |
VIDEO_AD |
Jest to reklama wideo. |
GMAIL_AD |
Ta reklama jest w Gmailu. |
IMAGE_AD |
Ta reklama jest reklamą graficzną. |
RESPONSIVE_SEARCH_AD |
To jest elastyczna reklama w wyszukiwarce. |
LEGACY_RESPONSIVE_DISPLAY_AD |
To starsza wersja elastycznej reklamy displayowej. |
APP_AD |
Ta reklama to reklama aplikacji. |
LEGACY_APP_INSTALL_AD |
Jest to starsza wersja reklamy promującej instalacje aplikacji. |
RESPONSIVE_DISPLAY_AD |
Jest to elastyczna reklama displayowa. |
LOCAL_AD |
Jest to reklama lokalna. |
HTML5_UPLOAD_AD |
Jest to reklama displayowa przesyłana typu produktu HTML5_UPLOAD_AD. |
DYNAMIC_HTML5_AD |
Jest to reklama displayowa produktu typu DYNAMIC_HTML5_*, |
APP_ENGAGEMENT_AD |
Jest to reklama angażująca w aplikację. |
SHOPPING_COMPARISON_LISTING_AD |
Ta reklama zawiera porównanie informacji o produktach w Zakupach Google. |
VIDEO_BUMPER_AD |
Bumper reklamowy. |
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 w 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 podróży. |
DISCOVERY_VIDEO_RESPONSIVE_AD |
Elastyczna reklama wideo Discovery. |
MULTIMEDIA_AD |
Reklama multimedialna. |
SearchAds360TextAdInfo
Reklama tekstowa 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łączony do automatycznie wygenerowanego widocznego adresu URL z separatorem. |
path2 |
Tekst dołączony do ścieżki 1 z separatorem. |
adTrackingId |
Identyfikator śledzenia reklamy. |
SearchAds360ResponsiveSearchAdInfo
Elastyczna reklama w wyszukiwarce w Search Ads 360.
Zapis JSON |
---|
{ "headlines": [ { object ( |
Pola | |
---|---|
headlines[] |
Lista komponentów tekstowych do nagłówków. Gdy reklama się wyświetli, nagłówki zostaną wybrane z tej listy. |
descriptions[] |
Lista komponentów tekstowych do tekstów reklamy. Gdy reklama się wyświetli, teksty reklamy zostaną wybrane z tej listy. |
path1 |
Tekst dołączony do automatycznie wygenerowanego widocznego adresu URL z separatorem. |
path2 |
Tekst dołączony do ścieżki 1 z separatorem. |
adTrackingId |
Identyfikator śledzenia reklamy. |
AdTextAsset
Komponent tekstowy wykorzystywany w reklamie.
Zapis JSON |
---|
{ "text": string } |
Pola | |
---|---|
text |
Tekst komponentu. |
SearchAds360ProductAdInfo
Ten typ nie zawiera 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
Wylicza stany wyszukiwarki grupy reklam.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono żadnej wartości. |
UNKNOWN |
Używany tylko w przypadku zwracanej wartości. 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 w trakcie sprawdzania. |
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ć. Wcześniej używane 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 się wyświetla. |
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
Relacja między reklamą w grupie reklam a etykietą.
Zapis JSON |
---|
{ "resourceName": string, "adGroupAd": string, "label": string } |
Pola | |
---|---|
resourceName |
Nazwa zasobu etykiety reklamy w grupie reklam. Nazwy zasobów etykiet reklam w grupie reklam mają następujący format: |
adGroupAd |
Reklama z grupy 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 komponentu grupy reklam. Nazwy zasobów AdGroupAsset mają następujący format:
|
adGroup |
Wymagane. Grupa reklam, z którą połączony jest komponent. |
asset |
Wymagane. Komponent połączony z grupą reklam. |
status |
Stan komponentu grupy reklam. |
AssetLinkStatus
Wyliczenie opisujące stany połączenia zasobów.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używany tylko w przypadku zwracanej wartości. Reprezentuje wartość nieznaną w tej wersji. |
ENABLED |
Link do zasobów jest włączony. |
REMOVED |
Link do zasobu został usunięty. |
PAUSED |
Link do komponentu jest wstrzymany. |
AdGroupAssetSet
AdGroupAssetSet łączy grupę reklam z zestawem komponentów. Utworzenie AdGroupAssetSet łączy zestaw 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 w grupach reklam mają taką postać:
|
adGroup |
Grupa reklam, z którą połączony jest ten zestaw komponentów. |
assetSet |
Zbiór plików połączony z grupą reklam. |
status |
Stan zestawu komponentów grupy reklam. Tylko do odczytu. |
AssetSetLinkStatus
Możliwe stany połączenia między zestawem zasobów a jego kontenerem.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Stan nie został określony. |
UNKNOWN |
Otrzymana wartość nie jest znana w tej wersji. Ta wartość dotyczy tylko odpowiedzi. |
ENABLED |
Połączenie między zestawem zasobów i jego kontenerem jest włączone. |
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 oparte na zainteresowaniach i listach remarketingowych dla reklam w sieci reklamowej i w YouTube oraz z list remarketingowych dla reklam w wyszukiwarce (RLSA) zebrane na poziomie odbiorców.
Zapis JSON |
---|
{ "resourceName": string } |
Pola | |
---|---|
resourceName |
Nazwa zasobu w widoku odbiorców grupy reklam. Nazwy zasobów widoku odbiorców w grupach reklam mają postać:
|
AdGroupBidModifier
Odnosi się do modyfikatora stawek grupy reklam.
Zapis JSON |
---|
{ "resourceName": string, "bidModifier": number, // Union field |
Pola | |
---|---|
resourceName |
Nazwa zasobu modyfikatora stawek grupy reklam. Nazwy zasobów modyfikatora stawek grupy reklam mają postać:
|
bidModifier |
Modyfikator stawki w przypadku dopasowania do kryterium. Modyfikator musi należeć do zakresu od 0,1 do 10,0. Zakres wynosi od 1,0 do 6,0 w przypadku treści PreferredContent. Aby zrezygnować z urządzeń danego typu, wpisz 0. |
Pole sumy Wymagane w operacjach tworzenia rozpoczynających się w wersji 5. |
|
device |
Kryterium urządzenia. |
DeviceInfo
Kryterium urządzenia.
Zapis JSON |
---|
{
"type": enum ( |
Pola | |
---|---|
type |
Typ urządzenia. |
Urządzenie
Wyświetla 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 w grupie 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 w grupie reklam. Nazwy zasobów kryterium w grupie reklam mają następującą postać:
|
creationTime |
Sygnatura czasowa utworzenia danego kryterium w grupie reklam. Sygnatura czasowa jest podana w strefie czasowej klienta i w formacie „rrrr-MM-dd HH:mm:ss”. . |
status |
Stan kryterium. To jest stan elementu kryterium w grupie reklam ustawiony przez klienta. Uwaga: raporty w interfejsie mogą zawierać dodatkowe informacje, które wpływają na to, czy dane kryterium może zostać zrealizowane. W niektórych przypadkach kryterium, które zostało USUNIĘTE w interfejsie API, może być nadal wyświetlane jako włączone w interfejsie. Na przykład kampanie domyślnie wyświetlają reklamy użytkownikom ze wszystkich przedziałów wiekowych, chyba że zostaną wykluczone. W interfejsie poszczególne przedziały wiekowe będą oznaczone jako „włączone”, ponieważ użytkownikom mogą się wyświetlać reklamy. ale AdGroupCriterion.status wyświetli wartość „usunięto”, ponieważ nie dodano żadnego niewykluczającego kryterium. |
qualityInfo |
Informacje dotyczące jakości kryterium. |
type |
Typ kryterium. |
labels[] |
Nazwy zasobów etykiet dołączonych do tego kryterium grupy reklam. |
positionEstimates |
Szacunki stawek 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 konta innego niż Google Ads, np. Yahoo Japan, Microsoft, Baidu itp. 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ą w strefie czasowej klienta i w formacie „rrrr-MM-dd HH:mm:ss.sssss”. . |
criterionId |
Identyfikator kryterium. |
adGroup |
Grupa reklam, do której należy kryterium. |
negative |
Określa, czy kryterium ma być celem ( Tego pola nie można zmienić. Aby zmienić kryterium z pozytywnego na negatywne, usuń je, a następnie dodaj ponownie. |
bidModifier |
Modyfikator stawki w przypadku dopasowania do kryterium. Modyfikator musi należeć do zakresu od 0,1 do 10,0. Większość typów kryteriów kierowania reklam obsługuje modyfikatory. |
cpcBidMicros |
Stawka CPC (kosztu kliknięcia). |
effectiveCpcBidMicros |
Efektywna stawka CPC (kosztu 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 URL do tworzenia linku monitorującego. |
Pole sumy Musisz ustawić tylko jedną opcję. |
|
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 elementu AdGroupCriterion.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono żadnej wartości. |
UNKNOWN |
Otrzymana wartość nie jest znana w tej wersji. Ta wartość dotyczy tylko odpowiedzi. |
ENABLED |
Kryterium w grupie reklam jest włączone. |
PAUSED |
Kryterium w grupie reklam zostało wstrzymane. |
REMOVED |
Kryterium w grupie reklam zostało usunięte. |
QualityInfo
Kontener informacji o jakości kryterium w grupie reklam.
Zapis JSON |
---|
{ "qualityScore": integer } |
Pola | |
---|---|
qualityScore |
Wynik jakości. To pole może być puste, jeśli Google nie ma wystarczającej ilości 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żywany tylko w przypadku zwracanej wartości. Reprezentuje wartość nieznaną w tej wersji. |
KEYWORD |
Słowo kluczowe, na przykład „rejs po marsie”. |
PLACEMENT |
Miejsce docelowe, nazywane też witryną, np. „www.kwiaty4wyprzedaż.com”. |
MOBILE_APP_CATEGORY |
Kategorie aplikacji mobilnych, na które chcesz kierować reklamy. |
MOBILE_APPLICATION |
Aplikacje mobilne, na które mają być kierowane reklamy. |
DEVICE |
Urządzenia, na które mają być kierowane reklamy. |
LOCATION |
Lokalizacje, na które mają być kierowane reklamy. |
LISTING_GROUP |
Grupy informacji o produktach, na które chcesz kierować 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 |
na swoim kanale YouTube. |
USER_LIST |
Lista użytkowników. |
PROXIMITY |
Bliskość |
TOPIC |
Cel tematyczny w sieci reklamowej (np. „Zwierzęta dzikie i domowe”). |
LISTING_SCOPE |
Zakres informacji, na który mają być kierowane reklamy. |
LANGUAGE |
Język. |
IP_BLOCK |
IpBlock. |
CONTENT_LABEL |
Etykieta treści na potrzeby wykluczenia kategorii. |
CARRIER |
Operatora. |
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 w aplikacji. |
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 |
Grupa tematyczna słów kluczowych kampanii inteligentnej |
AUDIENCE |
Odbiorcy |
LOCAL_SERVICE_ID |
Identyfikator usługi w Reklamach Usług Lokalnych. |
BRAND |
Marka |
BRAND_LIST |
Lista marek |
LIFE_EVENT |
Zdarzenie z życia |
PositionEstimates
Szacunki stawek kryteriów na różnych pozycjach.
Zapis JSON |
---|
{ "topOfPageCpcMicros": string } |
Pola | |
---|---|
topOfPageCpcMicros |
Szacunkowa stawka CPC wymagana do wyświetlenia reklamy u góry pierwszej strony wyników wyszukiwania. |
AdGroupCriterionEngineStatus
Wylicza stany wyszukiwarki AdGroupCriterion.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używany tylko w przypadku zwracanej wartości. 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 niska do wyświetlenia. |
AD_GROUP_CRITERION_INVALID_MOBILE_SEARCH |
Baidu: stawka lub jakość są za niska dla urządzeń mobilnych, ale może się wyświetlać w wersji na komputery. |
AD_GROUP_CRITERION_INVALID_PC_SEARCH |
Baidu: stawka lub jakość są za niskie w przypadku komputerów, ale kwalifikują się do wyświetlania na urządzeniach mobilnych. |
AD_GROUP_CRITERION_INVALID_SEARCH |
Baidu: stawka lub jakość są za niska do wyświetlenia. |
AD_GROUP_CRITERION_LOW_SEARCH_VOLUME |
Baidu: wstrzymana przez Baidu z powodu małej liczby wyszukiwań. |
AD_GROUP_CRITERION_MOBILE_URL_UNDER_REVIEW |
Baidu: mobilny adres URL w trakcie sprawdzania. |
AD_GROUP_CRITERION_PARTIALLY_INVALID |
Baidu: strona docelowa jednego urządzenia jest nieprawidłowa, a strona docelowa innego urządzenia jest prawidłowa. |
AD_GROUP_CRITERION_TO_BE_ACTIVATED |
Baidu: słowo kluczowe zostało utworzone i wstrzymane przez zarządzanie kontem Baidu. Możesz teraz je aktywować. |
AD_GROUP_CRITERION_UNDER_REVIEW |
Baidu: proces sprawdzania 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ć. Wcześniej używane 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 wyświetla reklamy. |
AD_GROUP_CRITERION_ACCOUNT_PAUSED |
Kryterium zostało wstrzymane, ponieważ wstrzymano konto. |
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żywany tylko w przypadku zwracanej wartości. 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żywany tylko w przypadku zwracanej wartości. Reprezentuje wartość nieznaną w tej wersji. |
SUBDIVISION |
Podział produktów według wymiaru informacji o produkcie. Węzły te nie są używane do kierowania na wpisy z listą, ale służą tylko do zdefiniowania struktury drzewa. |
UNIT |
Jednostka grupy informacji o produktach, która określa 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żywany tylko w przypadku zwracanej wartości. Reprezentuje wartość nieznaną w tej wersji. |
AGE_RANGE_18_24 |
Od 18 do 24 lat. |
AGE_RANGE_25_34 |
Od 25 do 34 lat. |
AGE_RANGE_35_44 |
Od 35 do 44 lat. |
AGE_RANGE_45_54 |
Od 45 do 54 lat. |
AGE_RANGE_55_64 |
Od 55 do 64 lat. |
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 grupy demograficznej płci (np. kobieta).
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używany tylko w przypadku zwracanej wartości. 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órego chcesz kierować reklamy.
Zapis JSON |
---|
{ "userList": string } |
Pola | |
---|---|
userList |
Nazwa zasobu listy użytkowników. |
WebpageInfo
Określa kryterium kierowania reklam na strony internetowe w witrynie reklamodawcy.
Zapis JSON |
---|
{
"conditions": [
{
object ( |
Pola | |
---|---|
conditions[] |
Warunki lub wyrażenia logiczne używane do kierowania na strony internetowe. Lista warunków kierowania na strony internetowe jest łączona podczas oceniania kierowania pod kątem kierowania. Pusta lista warunków oznacza, że kierowanie odbywa się na wszystkie strony witryny kampanii. To pole jest wymagane w przypadku operacji CREATE i nie jest dozwolone w operacjach UPDATE. |
coveragePercentage |
Odsetek pokrycia kryteriów witryn. Jest to obliczony odsetek pokrycia witryny na podstawie witryny docelowej, wykluczonej witryny docelowej i wykluczających słów kluczowych w grupie reklam i kampanii. Jeśli na przykład pokrycie ma wartość 1, oznacza to, że ma 100% pokrycia. To pole jest tylko do odczytu. |
criterionName |
Nazwa kryterium zdefiniowana przez ten parametr. Wartość „name” będzie używana do identyfikowania, sortowania i filtrowania kryteriów w przypadku tego typu parametrów. To pole jest wymagane w przypadku operacji CREATE i nie jest dozwolone w operacjach UPDATE. |
WebpageConditionInfo
Wyrażenie logiczne służące do kierowania reklam na strony internetowe w witrynie reklamodawcy.
Zapis JSON |
---|
{ "operand": enum ( |
Pola | |
---|---|
operand |
Argument 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żywany tylko w przypadku zwracanej wartości. Reprezentuje wartość nieznaną w tej wersji. |
URL |
Parametr określający warunek kierowania na adres URL strony internetowej. |
CATEGORY |
Operator określający warunek kierowania na kategorię strony internetowej. |
PAGE_TITLE |
Operator określający warunek kierowania na tytuł strony internetowej. |
PAGE_CONTENT |
Operator określający warunek kierowania na treść strony internetowej. |
CUSTOM_LABEL |
Operator określający warunek kierowania etykiety własnej na stronie internetowej. |
WebpageConditionOperator
Operator warunku strony internetowej w kryterium strony internetowej.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używany tylko w przypadku zwracanej wartości. Reprezentuje wartość nieznaną w tej wersji. |
EQUALS |
Warunek sieciowy argumentu jest równy porównywanemu warunkowi internetowemu. |
CONTAINS |
Argument warunek sieci jest częścią porównania warunku internetowego. |
LocationInfo
Kryterium lokalizacji.
Zapis JSON |
---|
{ "geoTargetConstant": string } |
Pola | |
---|---|
geoTargetConstant |
Nazwa stałego zasobu kierowania geograficznego. |
AdGroupCriterionLabel
Relacja między kryterium w grupie reklam a etykietą.
Zapis JSON |
---|
{ "resourceName": string, "adGroupCriterion": string, "label": string } |
Pola | |
---|---|
resourceName |
Nazwa zasobu etykiety kryterium w grupie reklam. Nazwy zasobów etykiet kryterium w grupie reklam mają następujący format: |
adGroupCriterion |
Kryterium w grupie reklam, do którego dołączona jest etykieta. |
label |
Etykieta przypisana do kryterium w grupie reklam. |
AdGroupLabel
Relacja 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 grup reklam mają następujący format: |
adGroup |
Grupa reklam, do której dołączona jest 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 w widoku przedziału wiekowego mają następujący format:
|
Komponent
Zasób to część reklamy, która może być wykorzystywana w wielu reklamach. Może to być obraz (ImageAsset), film (YouTubeVideoAsset) itp. Komponentów nie można zmienić. Aby zatrzymać wyświetlanie komponentu, usuń go z elementu, który go używa.
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 określająca, kiedy zasób został utworzony. Sygnatura czasowa jest podana w strefie czasowej klienta i w formacie „rrrr-MM-dd HH:mm:ss”. . |
lastModifiedTime |
Data i godzina ostatniej modyfikacji komponentu. Data i godzina są w strefie czasowej klienta i w formacie „rrrr-MM-dd HH:mm:ss.sssss”. . |
id |
Identyfikator zasobu. |
name |
Opcjonalna nazwa zasobu. |
trackingUrlTemplate |
Szablon URL służący do tworzenia linku monitorującego. |
engineStatus |
Stan wyszukiwarki zasobu. |
Pole sumy asset_data . Konkretny typ zasobu. asset_data może mieć tylko jedną z tych wartości: |
|
youtubeVideoAsset |
Zasób wideo w YouTube |
imageAsset |
Komponent z obrazem. |
textAsset |
Komponent tekstowy. |
calloutAsset |
Ujednolicony komponent z objaśnieniem. |
sitelinkAsset |
Ujednolicony komponent z linkami do podstron. |
pageFeedAsset |
Komponent z ujednoliconym plikiem z adresami stron docelowych. |
mobileAppAsset |
Komponent aplikacji mobilnej |
callAsset |
Ujednolicony komponent do wykonywania połączeń. |
callToActionAsset |
Komponent z wezwaniem do działania |
locationAsset |
Ujednolicony komponent z lokalizacją. |
Typ komponentu
Wyliczenie opisujące możliwe typy zasobów.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używany tylko w przypadku zwracanej wartości. Reprezentuje wartość nieznaną w tej wersji. |
YOUTUBE_VIDEO |
Komponent wideo 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 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 komponent związany z nieruchomościami. |
DYNAMIC_CUSTOM |
Dynamiczny zasób niestandardowy. |
DYNAMIC_HOTELS_AND_RENTALS |
Komponent z dynamicznymi hotelami i wynajmem. |
DYNAMIC_FLIGHTS |
Dynamiczny komponent z lotami. |
DISCOVERY_CAROUSEL_CARD |
Zasób karty karuzeli Discovery. |
DYNAMIC_TRAVEL |
Komponent dynamiczny dotyczący podróży. |
DYNAMIC_LOCAL |
Dynamiczny zasób lokalny. |
DYNAMIC_JOBS |
Dynamiczny komponent z ofertami pracy. |
LOCATION |
Komponent z lokalizacją. |
HOTEL_PROPERTY |
Komponent obiektu hotelowego. |
AssetStatus
Możliwe stany zasobu.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Stan nie został określony. |
UNKNOWN |
Otrzymana wartość nie jest znana w tej wersji. Ta wartość dotyczy tylko odpowiedzi. |
ENABLED |
Zasób 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żywany tylko w przypadku zwracanej wartości. Reprezentuje wartość nieznaną w tej wersji. |
SERVING |
Zasób jest aktywny. |
SERVING_LIMITED |
Zasób jest aktywny z ograniczeniami. |
DISAPPROVED |
Komponent został odrzucony (nie spełnia wymagań). |
DISABLED |
Zasób jest nieaktywny (oczekuje). |
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 11-znakowa wartość ciągu używana 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 jego 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. Ta wartość dotyczy tylko odpowiedzi. |
IMAGE_JPEG |
Typ MIME pliku Image/JPEG. |
IMAGE_GIF |
Typ MIME obrazu/gif. |
IMAGE_PNG |
Typ MIME obrazu/png. |
FLASH |
Typ MIME: application/x-shockwave-flash. |
TEXT_HTML |
Typ MIME: text/html. |
PDF |
Typ MIME aplikacji/pdf. |
MSWORD |
Typ MIME aplikacji/msword. |
MSEXCEL |
Typ MIME pliku application/vnd.ms-excel. |
RTF |
Typ MIME aplikacji/rtf. |
AUDIO_WAV |
Typ MIME audio/WAV. |
AUDIO_MP3 |
Typ MIME: audio/mp3. |
HTML5_AD_ZIP |
Typ MIME pliku application/x-html5-ad-zip. |
ImageDimension
Metadane obrazu w określonym rozmiarze – oryginalnym lub zmienionym.
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
Zasób tekstowy.
Zapis JSON |
---|
{ "text": string } |
Pola | |
---|---|
text |
Zawartość tekstowa komponentu tekstowego. |
UnifiedCalloutAsset
Ujednolicony komponent z objaśnieniem.
Zapis JSON |
---|
{
"calloutText": string,
"startDate": string,
"endDate": string,
"adScheduleTargets": [
{
object ( |
Pola | |
---|---|
calloutText |
Tekst objaśnienia. Długość tego ciągu powinna wynosić od 1 do 25 włącznie. |
startDate |
Data rozpoczęcia wyświetlania zasobu i rozpoczęcie jego wyświetlania, w formacie rrrr-MM-dd. |
endDate |
Data końcowa wejścia tego komponentu w życie i dalszego wyświetlania, w formacie rrrr-MM-dd. |
adScheduleTargets[] |
Lista nienakładających się harmonogramów określających wszystkie przedziały czasu, w których zasób może się wyświetlać. Dziennie możesz mieć maksymalnie 6 harmonogramów, a łącznie 42. |
useSearcherTimeZone |
Określa, czy komponent ma być wyświetlany w strefie czasowej użytkownika wyszukiwania. Dotyczy Microsoft Ads. |
AdScheduleInfo
Reprezentuje kryterium AdSchedule.
AdSchedule określa się jako dzień tygodnia i przedział czasu, w którym reklamy mają być wyświetlane.
Nie można dodać więcej niż sześć harmonogramów reklam dla tego samego dnia.
Zapis JSON |
---|
{ "startMinute": enum ( |
Pola | |
---|---|
startMinute |
Liczba minut po godzinie rozpoczęcia, w której uruchamia się ten harmonogram. To pole jest wymagane w przypadku operacji CREATE i nie jest dozwolone w operacjach UPDATE. |
endMinute |
Liczba minut po godzinie końcowej, w której kończy się ten harmonogram. W harmonogramie nie uwzględniono minuty końcowej. To pole jest wymagane w przypadku operacji CREATE i nie jest dozwolone w operacjach UPDATE. |
dayOfWeek |
Dzień tygodnia, którego dotyczy harmonogram. To pole jest wymagane w przypadku operacji CREATE i nie jest dozwolone w operacjach UPDATE. |
startHour |
Godzina rozpoczęcia w czasie 24-godzinnym. To pole musi zawierać wartość od 0 do 23 włącznie. To pole jest wymagane w przypadku operacji CREATE i nie jest dozwolone w operacjach UPDATE. |
endHour |
Godzina zakończenia w czasie 24-godzinnym; 24 oznacza koniec dnia. To pole musi zawierać wartość od 0 do 24 włącznie. To pole jest wymagane w przypadku operacji CREATE i nie jest dozwolone w operacjach 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 |
Zero minut po godzinie. |
FIFTEEN |
Piętnaście minut po godzinie. |
THIRTY |
30 minut po godzinie. |
FORTY_FIVE |
Czterdzieści pięć minut po godzinie. |
DzieńTygodnia
Wylicza dni tygodnia, na przykład „poniedziałek”.
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 adres URL linku do podstrony. Długość tego ciągu powinna wynosić od 1 do 25 włącznie. |
description1 |
Pierwszy wiersz opisu linku do podstrony. Jeśli jest ustawiony, musisz określić długość z zakresu od 1 do 35 włącznie i należy ustawić także opis2. |
description2 |
Drugi wiersz opisu linku do podstrony. Jeśli jest ustawiony, jego długość powinna mieścić się w zakresie od 1 do 35 razy, a także musi być ustawiony. |
startDate |
Data rozpoczęcia wyświetlania zasobu i rozpoczęcie jego wyświetlania, w formacie rrrr-MM-dd. |
endDate |
Data końcowa wejścia tego komponentu w życie i dalszego wyświetlania, w formacie rrrr-MM-dd. |
adScheduleTargets[] |
Lista nienakładających się harmonogramów określających wszystkie przedziały czasu, w których zasób może się wyświetlać. Dziennie możesz mieć maksymalnie 6 harmonogramów, a łącznie 42. |
trackingId |
Identyfikator używany do śledzenia kliknięć komponentu z linkami do podstron. To jest adres URL Yahoo! Tylko Japonia. |
useSearcherTimeZone |
Określa, czy komponent z linkami do podstron ma się wyświetlać w strefie czasowej użytkownika wyszukiwania. Dotyczy Microsoft Ads. |
mobilePreferred |
Określa, czy preferowane jest wyświetlanie komponentu z linkami do podstron na urządzeniach mobilnych. Dotyczy Microsoft Ads. |
UnifiedPageFeedAsset
Komponent z ujednoliconym plikiem z adresami stron docelowych.
Zapis JSON |
---|
{ "pageUrl": string, "labels": [ string ] } |
Pola | |
---|---|
pageUrl |
Strona internetowa, na którą reklamodawcy chcą kierować reklamy. |
labels[] |
Etykiety używane do grupowania adresów URL stron. |
MobileAppAsset
Zasób reprezentujący aplikację mobilną.
Zapis JSON |
---|
{
"appId": string,
"appStore": enum ( |
Pola | |
---|---|
appId |
Wymagane. Ciąg jednoznacznie identyfikujący aplikację mobilną. Powinien zawierać tylko natywny identyfikator platformy, np. „com.android.ebay”. na Androida lub „12345689” na iOS. |
appStore |
Wymagane. Sklep z aplikacjami, który udostępnia tę aplikację. |
MobileAppVendor
Typ dostawcy aplikacji mobilnej
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używany tylko w przypadku zwracanej wartości. Reprezentuje wartość nieznaną w tej wersji. |
APPLE_APP_STORE |
Dostawca aplikacji mobilnej dla Apple App Store. |
GOOGLE_APP_STORE |
Dostawca aplikacji mobilnej w sklepie z aplikacjami Google. |
UnifiedCallAsset
Ujednolicony komponent do wykonywania połączeń.
Zapis JSON |
---|
{ "countryCode": string, "phoneNumber": string, "callConversionReportingState": enum ( |
Pola | |
---|---|
countryCode |
Dwuliterowy kod kraju numeru telefonu. Przykłady: „PL”, „us”. |
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 chcesz 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ących wszystkie przedziały czasu, w których zasób może się wyświetlać. Dziennie możesz mieć maksymalnie 6 harmonogramów, a łącznie 42. |
callOnly |
Czy podczas połączenia wyświetlany jest tylko numer telefonu bez linku do strony internetowej. Dotyczy Microsoft Ads. |
callTrackingEnabled |
Określa, czy połączenie ma być włączone w śledzeniu połączeń. Dotyczy Microsoft Ads. |
useSearcherTimeZone |
Określa, czy rozszerzenie połączeń ma być wyświetlane w strefie czasowej użytkownika wyszukiwania. Dotyczy Microsoft Ads. |
startDate |
Data rozpoczęcia wyświetlania zasobu i rozpoczęcie jego wyświetlania, w formacie rrrr-MM-dd. |
endDate |
Data końcowa wejścia tego komponentu w życie i dalszego wyświetlania, w formacie rrrr-MM-dd. |
CallConversionReportingState
Możliwe typy danych dotyczące stanu działania powodującego konwersję telefoniczną.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używany tylko w przypadku zwracanej wartości. 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 ustawionego na poziomie zasobu (reklamy typu „tylko połączenie” / rozszerzenia połączeń). |
CallToActionAsset
Komponent z wezwaniem do działania
Zapis JSON |
---|
{
"callToAction": enum ( |
Pola | |
---|---|
callToAction |
Wezwanie do działania. |
CallToActionType
Wyliczenie opisujące możliwe rodzaje wezwania do działania.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używany tylko w przypadku zwracanej wartości. Reprezentuje wartość nieznaną w tej wersji. |
LEARN_MORE |
Typ wezwania do działania to Dowiedz się więcej. |
GET_QUOTE |
Typ wezwania do działania to Uzyskaj wycenę. |
APPLY_NOW |
Stosowany jest teraz typ wezwania do działania. |
SIGN_UP |
Typ wezwania do działania to „Zarejestruj się”. |
CONTACT_US |
Typ wezwania do działania to „Skontaktuj się z nami”. |
SUBSCRIBE |
Typ wezwania do działania to subskrypcja. |
DOWNLOAD |
Wezwanie do działania to „pobierz”. |
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 teraz kolejność. |
PLAY_NOW |
Odtwarzane jest wezwanie do działania. |
SEE_MORE |
Typ wezwania do działania to więcej. |
START_NOW |
Wezwanie do działania jest teraz aktywne. |
VISIT_SITE |
Typ wezwania do działania to „Odwiedź stronę”. |
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ą miejsce w bazie danych Miejsc Google i w Mapach Google. To pole jest unikalne w przypadku danego identyfikatora klienta i typu komponentu. 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ść jest zwracana tylko wtedy, gdy komponent z lokalizacją synchronizuje się z kontem w usłudze Profil Firmy. Na jednym koncie może się znajdować wiele wizytówek w Profilu Firmy, które odnoszą się do tego samego identyfikatora miejsca. |
locationOwnershipType |
Typ własności lokalizacji. Jeśli typ to BUSINESS_OWNER, będzie ono wyświetlane jako rozszerzenie lokalizacji. Jeśli typ to AFFILIA, będzie ona wyświetlana jako powiązana lokalizacja. |
BusinessProfileLocation
Dane o lokalizacji profilu firmy synchronizowane z połączonego konta w Profilu Firmy.
Zapis JSON |
---|
{ "labels": [ string ], "storeCode": string, "listingId": string } |
Pola | |
---|---|
labels[] |
Reklamodawca określił etykietę lokalizacji na koncie w Profilu Firmy. Te dane są synchronizowane z konta Profilu Firmy. |
storeCode |
Kod sklepu w profilu firmy dotyczący tej lokalizacji. Te dane są synchronizowane z konta Profilu Firmy. |
listingId |
Identyfikator wizytówki tej lokalizacji w profilu firmy. Te dane są synchronizowane z połączonego konta w Profilu Firmy. |
LocationOwnershipType
Możliwe typy własności lokalizacji.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używany tylko w przypadku zwracanej wartości. Reprezentuje wartość nieznaną w tej wersji. |
BUSINESS_OWNER |
Właściciel firmy w lokalizacji(starsze rozszerzenie lokalizacji – LE). |
AFFILIATE |
Powiązana lokalizacja(rozszerzenie lokalizacji innej firmy – ALE). |
AssetGroupAsset
Element AssetGroupAsset stanowi połączenie między zasobem a grupą plikó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 zasobu grupy plików. Nazwa zasobu w grupie plików ma taki format:
|
assetGroup |
Grupa plików, z którą łączysz ten komponent grupy plików. |
asset |
Komponent, który łączy ten komponent grupy plików. |
fieldType |
Opis miejsca docelowego komponentu w grupie plików. Na przykład: HEADLINE, YOUTUBE_VIDEO itp. |
status |
Stan połączenia między zasobem a grupą plików. |
Typ pola komponentu
Wyliczenie opisujące możliwe miejsca docelowe zasobu.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używany tylko w przypadku zwracanej wartości. Reprezentuje wartość nieznaną w tej wersji. |
HEADLINE |
Komponent jest połączony i może służyć jako nagłówek. |
DESCRIPTION |
Komponent jest połączony i może służyć jako tekst reklamy. |
MANDATORY_AD_TEXT |
Komponent jest połączony i może być używany jako obowiązkowy tekst reklamy. |
MARKETING_IMAGE |
Komponent jest połączony i może służyć jako obraz marketingowy. |
MEDIA_BUNDLE |
Zasób jest połączony i może być używany jako pakiet kreacji multimedialnych. |
YOUTUBE_VIDEO |
Zasób jest połączony i może służyć jako film w YouTube. |
BOOK_ON_GOOGLE |
Komponent jest połączony, aby wskazać, że kampania reklam hoteli to „Zarezerwuj z Google”. . |
LEAD_FORM |
Komponent jest połączony i może być używany jako rozszerzenie formularza kontaktowego. |
PROMOTION |
Komponent jest połączony i może być używany jako rozszerzenie promocji. |
CALLOUT |
Komponent jest połączony i może być używany jako rozszerzenie objaśnień. |
STRUCTURED_SNIPPET |
Komponent jest połączony i może być używany jako rozszerzenie informacji w witrynie. |
SITELINK |
Komponent jest połączony i może służyć jako link do podstrony. |
MOBILE_APP |
Komponent jest połączony i może być używany jako rozszerzenie aplikacji mobilnej. |
HOTEL_CALLOUT |
Komponent jest połączony i może być używany jako rozszerzenie objaśnień dotyczących hoteli. |
CALL |
Komponent jest połączony i może być używany jako rozszerzenie połączeń. |
PRICE |
Komponent jest połączony i może być używany jako rozszerzenie cen. |
LONG_HEADLINE |
Komponent jest połączony i może służyć jako długi nagłówek. |
BUSINESS_NAME |
Komponent jest połączony i może być używany jako nazwa firmy. |
SQUARE_MARKETING_IMAGE |
Komponent jest połączony i może być używany jako kwadratowy obraz marketingowy. |
PORTRAIT_MARKETING_IMAGE |
Komponent jest połączony i może być używany jako pionowy obraz marketingowy. |
LOGO |
Zasób jest połączony i może służyć jako logo. |
LANDSCAPE_LOGO |
Komponent jest połączony i może służyć jako logo w orientacji poziomej. |
VIDEO |
Zasób jest połączony i może być używany jako logo spoza YouTube. |
CALL_TO_ACTION_SELECTION |
Komponent jest połączony i można go użyć do wyboru wezwania do działania. |
AD_IMAGE |
Komponent jest połączony i można go użyć do wyboru obrazu reklamy. |
BUSINESS_LOGO |
Komponent jest połączony i może służyć jako logo firmy. |
HOTEL_PROPERTY |
Ten komponent jest połączony 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że być używany jako karta karuzeli Discovery. |
AssetGroupSignal
AssetGroupSignal reprezentuje sygnał w grupie plików. Sygnały są przekazywane do kampanii Performance Max, którzy z większym prawdopodobieństwem dokonają konwersji. Kampania Performance Max używa tego sygnału, aby znaleźć nowych użytkowników o podobnych lub silniejszych zamiarach i uzyskać więcej konwersji w sieci wyszukiwania, sieci reklamowej, sieci wideo oraz innych usługach.
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ł. |
Pole sumy signal . Sygnał grupy plików. signal może mieć tylko jedną z tych wartości: |
|
audience |
Sygnał dotyczący odbiorców do użycia w kampanii Performance Max. |
AudienceInfo
Kryterium odbiorców.
Zapis JSON |
---|
{ "audience": string } |
Pola | |
---|---|
audience |
Nazwa zasobu związanego z odbiorcami. |
AssetGroupListingGroupFilter
AssetGroupListingGroupFilter reprezentuje węzeł drzewa filtra grup informacji o produktach w grupie plikó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 grup informacji o produktach w grupie plików ma taki format:
|
assetGroup |
Grupa plików, do której należy ten filtr grupy informacji o produktach. |
id |
Identyfikator elementu ListingGroupFilter. |
type |
Typ węzła filtra grup informacji o produktach. |
vertical |
Branża reprezentowana przez bieżące drzewo węzłów. Wszystkie węzły w tym samym drzewie muszą należeć do tej samej branży. |
caseValue |
Wartość wymiaru, za pomocą której ta grupa informacji o produktach zawęża obiekt nadrzędny. Nieokreślona dla grupy głównej. |
parentListingGroupFilter |
Nazwa zasobu dla podziału nadrzędnej grupy informacji o produktach. Wartość pusta dla węzła filtra grup informacji o produktach na poziomie głównym. |
path |
Ś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żywany tylko w przypadku zwracanej wartości. Reprezentuje wartość nieznaną w tej wersji. |
SUBDIVISION |
Podział produktów według niektórych wymiarów informacji o produktach. |
UNIT_INCLUDED |
Uwzględniony węzeł liścia filtra grupy informacji o produktach. |
UNIT_EXCLUDED |
Węzeł liścia filtra wykluczonej grupy informacji o produktach. |
ListingGroupFilterVertical
Typ branży filtrowania grupy informacji o produktach.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używany tylko w przypadku zwracanej wartości. Reprezentuje wartość nieznaną w tej wersji. |
SHOPPING |
Reprezentuje branżę zakupów. Branża jest dozwolona tylko w kampaniach detalicznych Performance Max. |
ListingGroupFilterDimension
Wymiary informacji o produktach stosowane do filtra grupy informacji o produktach w grupie plików.
Zapis JSON |
---|
{ // Union field |
Pola | |
---|---|
Pole sumy dimension . Wymiar jednego z poniższych typów jest zawsze obecny. dimension może mieć tylko jedną z tych wartości: |
|
productBiddingCategory |
Kategoria ustalania stawek w ofercie 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 element kategorii ustalania stawek na określonym poziomie. Kategorie najwyższego poziomu są na poziomie 1, dla dzieci na poziomie 2 itd. Obecnie obsługujemy maksymalnie 5 poziomów. Użytkownik musi określić typ wymiaru, który wskazuje poziom kategorii. Wszystkie przypadki tego samego podziału muszą mieć ten sam typ wymiaru (poziom kategorii).
Zapis JSON |
---|
{
"level": enum ( |
Pola | |
---|---|
level |
Wskazuje poziom kategorii w taksonomii. |
id |
Identyfikator kategorii ustalania stawek produktu. Ten identyfikator jest odpowiednikiem identyfikatora google_product_category [kategoria_produktów_google], jak opisano w tym artykule: https://support.google.com/merchants/answer/6324436. |
ListingGroupFilterBiddingCategoryLevel
Poziom kategorii ustalania stawek filtra grupy informacji o produktach.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używany tylko w przypadku zwracanej wartości. 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 |
Zalety miejscowości. |
ListingGroupFilterProductChannel
Enum opisujący lokalizację, w której jest oferowany produkt.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używany tylko w przypadku zwracanej wartości. 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
Enum opisujący stan oferty produktu.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używany tylko w przypadku zwracanej wartości. Reprezentuje wartość nieznaną w tej wersji. |
NEW |
Produkt jest nowy. |
REFURBISHED |
Produkt jest odnowiony. |
USED |
Używany jest stan produktu. |
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żywany tylko w przypadku zwracanej wartości. Reprezentuje wartość nieznaną w tej wersji. |
INDEX0 |
Pierwszy atrybut niestandardowy filtra grupy informacji o produktach. |
INDEX1 |
Drugi atrybut niestandardowy filtra grupy informacji o produktach. |
INDEX2 |
Trzeci atrybut niestandardowy filtra grupy informacji o produktach. |
INDEX3 |
Czwarty atrybut niestandardowy filtra grupy informacji o produktach. |
INDEX4 |
Piąty atrybut niestandardowy filtra 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żywany tylko w przypadku zwracanej wartości. 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 określonych przez hierarchię filtra grup informacji o produktach (bez węzła głównego) do tego filtra grup informacji o produktach. |
AssetGroupTopCombinationView
Widok wykorzystania kombinacji komponentów reklamy w grupie reklam.
Zapis JSON |
---|
{
"resourceName": string,
"assetGroupTopCombinations": [
{
object ( |
Pola | |
---|---|
resourceName |
Nazwa zasobu dla widoku kombinacji u góry grupy plików. Nazwy zasobów widoku Najważniejsze kombinacje grupy zasobów mają format: `"customers/{customerId}/assetGroupTopCombinationViews/{asset_group_id}~{asset_combination_category}" |
assetGroupTopCombinations[] |
Najpopularniejsze kombinacje komponentów, które wyświetlały się razem. |
AssetGroupAssetCombinationData
Grupa plików – dane o kombinacji komponentów
Zapis JSON |
---|
{
"assetCombinationServedAssets": [
{
object ( |
Pola | |
---|---|
assetCombinationServedAssets[] |
Wyświetlone komponenty. |
AssetUsage
Zawiera informacje o wykorzystaniu zasobu.
Zapis JSON |
---|
{
"asset": string,
"servedAssetFieldType": enum ( |
Pola | |
---|---|
asset |
Nazwa zasobu. |
servedAssetFieldType |
Typ wyświetlonego pola zasobu. |
ServedAssetFieldType
Możliwe typy pól komponentów.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono żadnej wartości. |
UNKNOWN |
Otrzymana wartość nie jest znana w tej wersji. Ta wartość dotyczy tylko 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żyj tej opcji tylko wtedy, gdy reklama zawiera tylko 1 nagłówek. W przeciwnym razie użyj wyrażeń HEADLINE_1, HEADLINE_2 lub HEADLINE_3. |
HEADLINE_IN_PORTRAIT |
Komponent został użyty jako nagłówek na obrazie pionowym. |
LONG_HEADLINE |
Komponent został użyty w długim nagłówku (używanym w przypadku reklam elastycznych MultiAssetAd). |
DESCRIPTION |
Zasób został użyty w tekście reklamy. Używaj go tylko wtedy, gdy reklama zawiera tylko 1 tekst reklamy. W przeciwnym razie użyj wyliczenia DESCRIPTION_1 lub DESCRIPTION_@ |
DESCRIPTION_IN_PORTRAIT |
Komponent został użyty jako tekst w obrazie pionowym. |
BUSINESS_NAME_IN_PORTRAIT |
Komponent został użyty jako nazwa firmy na obrazie pionowym. |
BUSINESS_NAME |
Komponent został użyty jako nazwa firmy. |
MARKETING_IMAGE |
Komponent został użyty jako obraz marketingowy. |
MARKETING_IMAGE_IN_PORTRAIT |
Komponent był używany 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 został użyty 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 jest używany jako logo firmy. |
AssetGroup
Grupa plików. Element AssetGroupAsset służy do łączenia komponentu z grupą plików. AssetGroupSignal służy do powiązania sygnału z grupą plików.
Zapis JSON |
---|
{ "resourceName": string, "id": string, "campaign": string, "name": string, "finalUrls": [ string ], "finalMobileUrls": [ string ], "status": enum ( |
Pola | |
---|---|
resourceName |
Nazwa zasobu grupy plików. Nazwy zasobów grup plików mają format:
|
id |
Identyfikator grupy plików. |
campaign |
Kampania, z którą powiązana jest ta grupa plików. Komponent połączony z grupą plików. |
name |
Wymagane. Nazwa grupy plików. Wymagane. Minimalna długość to 1 i maksymalna 128 znaków. Nie może się powtarzać w ramach kampanii. |
finalUrls[] |
Lista końcowych adresów URL po wszystkich przekierowaniach między domenami. W kampanii Performance Max adresy URL domyślnie kwalifikują się do rozwijania, o ile nie zrezygnujesz z tej opcji. |
finalMobileUrls[] |
Lista końcowych mobilnych adresów URL po wszystkich przekierowaniach między domenami. W kampanii Performance Max adresy URL domyślnie kwalifikują się do rozwijania, o ile nie zrezygnujesz z tej opcji. |
status |
Stan grupy plików. |
path1 |
Pierwsza część tekstu, która może być dołączana do adresu URL wyświetlanego w reklamie. |
path2 |
Druga część tekstu, która może być dołączana do adresu URL wyświetlanego w reklamie. To pole można ustawić tylko wtedy, gdy ustawiona jest ścieżka 1. |
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
Wyliczenie listy możliwych skuteczności reklamy.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używany tylko w przypadku zwracanej wartości. Reprezentuje wartość nieznaną w tej wersji. |
PENDING |
Skuteczność reklamy nie została jeszcze oceniona. |
NO_ADS |
Nie można wygenerować żadnych reklam. |
POOR |
Słaba siła. |
AVERAGE |
Średnia siła. |
GOOD |
Dobra siła. |
EXCELLENT |
Doskonała siła. |
AssetSetAsset
Element AssetSetAsset stanowi połączenie między zasobem a zbiorem zasobów. Dodanie komponentu AssetSetAsset powoduje połączenie zasobu z zestawem.
Zapis JSON |
---|
{
"resourceName": string,
"assetSet": string,
"asset": string,
"status": enum ( |
Pola | |
---|---|
resourceName |
Nazwa zasobu zasobu zestawu zasobów. Nazwy zasobów w zestawie zasobów mają taką postać:
|
assetSet |
Zbiór zasobów, z którym jest połączony ten zasób zestawu zasobów. |
asset |
Zasób, z którym jest połączony ten zasób zestawu zasobów. |
status |
Stan zasobu zestawu zasobów. Tylko do odczytu. |
AssetSetAssetStatus
Możliwe stany zasobu w zestawie.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Stan nie został określony. |
UNKNOWN |
Otrzymana wartość nie jest znana w tej wersji. Ta wartość dotyczy tylko odpowiedzi. |
ENABLED |
Zasób zestawu zasobów jest włączony. |
REMOVED |
Usunięto komponent zestawu komponentów. |
AssetSet
Zbiór zasobów reprezentujący kolekcję zasobów. Użyj komponentu AssetSetAsset, by połączyć zasób z zestawem zasobów.
Zapis JSON |
---|
{ "id": string, "resourceName": string } |
Pola | |
---|---|
id |
Identyfikator zestawu zasobów. |
resourceName |
Nazwa zasobu zbioru 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ą taką postać:
|
status |
Stan strategii ustalania stawek. To pole jest tylko do odczytu. |
type |
Typ strategii ustalania stawek. Utwórz strategię ustalania stawek, konfigurując schemat. To pole jest tylko do odczytu. |
currencyCode |
Waluta używana w strategii ustalania stawek (trzyliterowy kod ISO 4217). W przypadku strategii ustalania stawek na kontach klientów menedżera tę walutę można ustawić podczas tworzenia i domyślnie jest to waluta klienta menedżera. Nie można ustawić tego pola w przypadku klientów, którzy obsługują klientów. wszystkie strategie dotyczące obsługi klienta domyślnie używają waluty klienta obsługującego reklamy. We wszystkich przypadkach poleEffectiveCurrencyCode zwraca walutę używaną przez strategię. |
id |
Identyfikator strategii ustalania stawek. |
name |
Nazwa strategii ustalania stawek. Wszystkie strategie ustalania stawek na koncie muszą mieć różne nazwy. Długość tego ciągu powinna mieścić się w zakresie od 1 do 255 włącznie i w formacie UTF-8 (przycięty). |
effectiveCurrencyCode |
Waluta używana w strategii ustalania stawek (trzyliterowy kod ISO 4217). W przypadku strategii ustalania stawek na kontach klientów, którzy korzystają z konta menedżera, jest to waluta ustawiona przez reklamodawcę podczas tworzenia strategii. W przypadku klientów wyświetlających reklamy 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, jeśli prawdopodobieństwo jest mniej prawdopodobne. |
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 pomaga uzyskać z kampanii jak najwięcej konwersji w ramach określonego budżetu. |
targetCpa |
Strategia ustalania stawek, która ustala stawki tak, by pomóc Ci uzyskać jak największą liczbę konwersji przy wybranym przez Ciebie docelowym koszcie pozyskania (CPA). |
targetImpressionShare |
Strategia ustalania stawek, która automatycznie optymalizuje kampanię pod kątem wybranego odsetka wyświetleń. |
targetOutrankShare |
Strategia ustalania stawek, która ustala stawki na podstawie docelowego odsetka aukcji, w których reklamodawca powinien przelicytować konkretny konkurent. To pole zostało wycofane. Utworzenie nowej strategii ustalania stawek z tym polem lub dołączenie do kampanii strategii ustalania stawek z tym polem zakończy się niepowodzeniem. Mutacje do strategii, które mają już wypełniony ten schemat, są dozwolone. |
targetRoas |
Strategia ustalania stawek, która pomaga zmaksymalizować przychody przy zachowaniu średniego docelowego zwrotu z nakładów na reklamę (ROAS). |
targetSpend |
Strategia ustalania stawek, która ustala stawki tak, 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 żadnej wartości. |
UNKNOWN |
Otrzymana wartość nie jest znana w tej wersji. Ta wartość dotyczy tylko 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żywany tylko w przypadku zwracanej wartości. Reprezentuje wartość nieznaną w tej wersji. |
COMMISSION |
Prowizja to strategia automatycznego określania stawek, w ramach której reklamodawca płaci określoną 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 w przypadku kliknięć, w których jest to mniej prawdopodobne. |
INVALID |
Używany tylko w przypadku zwracanej wartości. Wskazuje, że kampania nie ma strategii ustalania stawek. Spowoduje to, że kampania nie będzie wyświetlać reklam. Na przykład kampania może być powiązana ze strategią ustalania stawek menedżera, a konto wyświetlające reklamy zostaje odłączone od konta menedżera. W takim przypadku kampania zostanie automatycznie odłączona od niedostępnej obecnie strategii ustalania stawek menedżera i przejdzie na NIEPRAWIDŁOWY typ strategii ustalania stawek. |
MANUAL_CPA |
Strategia samodzielnego ustawiania stawek, która pozwala reklamodawcy określać stawkę za działanie określone przez reklamodawcę. |
MANUAL_CPC |
Ręczne określanie stawek na podstawie kliknięć, w ramach których 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 |
To strategia ustalania stawek, w której za wyświetlenie filmu płaci się kwotę, którą można skonfigurować. |
MAXIMIZE_CONVERSIONS |
Strategia ustalania stawek, która automatycznie maksymalizuje liczbę konwersji w ramach budżetu dziennego. |
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 maks. stawki CPC pod kątem wyświetleń na pierwszej stronie lub promowanych boksach na pierwszej stronie w witrynie google.com. Ta wartość enum została wycofana. |
PERCENT_CPC |
Odsetek CPC to strategia ustalania stawek, w której stawki stanowią ułamek reklamowanej ceny danego towaru lub danej usługi. |
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, by pomóc Ci uzyskać jak największą liczbę wyświetleń przy ustawionym 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ę na górze 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ć konkretny konkurent. Ta wartość enum została wycofana. |
TARGET_ROAS |
Docelowy ROAS to strategia automatycznego określania stawek, która pomaga zmaksymalizować przychody przy zachowaniu średniego docelowego zwrotu 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 pomóc Ci uzyskać jak najwięcej kliknięć w ramach budżetu. |
EnhancedCpc
Ten typ nie zawiera pól.
To 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 w przypadku kliknięć, w których jest to mniej prawdopodobne.
Ta strategia ustalania stawek została wycofana i nie można jej już utworzyć. Aby uzyskać równoważne działanie, użyj ManualCpc z ustawieniem EnhancedCpcEnabled z wartością 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 |
Limit maksymalnej stawki, który można ustawić w strategii ustalania stawek. Limit dotyczy wszystkich słów kluczowych, którymi zarządza strategia. Ta opcja jest możliwa tylko w przypadku strategii portfolio ustalania stawek. |
cpcBidFloorMicros |
Limit minimalnej stawki, jaki może ustawić strategia ustalania stawek. Limit dotyczy wszystkich słów kluczowych, którymi zarządza strategia. Ta opcja jest możliwa tylko w przypadku strategii portfolio ustalania stawek. |
targetRoas |
Opcja docelowego zwrotu z nakładów na reklamę (ROAS). Jeśli jest ustawiony, strategia ustalania stawek maksymalizuje przychody, utrzymując średni docelowy zwrot z nakładów na reklamę. Jeśli docelowy ROAS jest wysoki, strategia może nie być w stanie wydać całego budżetu. Jeśli docelowy ROAS nie jest ustawiony, strategia ustalania stawek będzie dążyć do uzyskania najwyższego możliwego ROAS w ramach budżetu. |
MaximizeConversions
Strategia automatycznego określania stawek, która pomaga uzyskać z kampanii jak najwięcej konwersji w ramach określonego budżetu.
Zapis JSON |
---|
{ "cpcBidCeilingMicros": string, "cpcBidFloorMicros": string, "targetCpaMicros": string } |
Pola | |
---|---|
cpcBidCeilingMicros |
Limit maksymalnej stawki, który można ustawić w strategii ustalania stawek. Limit dotyczy wszystkich słów kluczowych, którymi zarządza strategia. Ta opcja jest możliwa tylko w przypadku strategii portfolio ustalania stawek. |
cpcBidFloorMicros |
Limit minimalnej stawki, jaki może ustawić strategia ustalania stawek. Limit dotyczy wszystkich słów kluczowych, którymi zarządza strategia. Ta opcja jest możliwa 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ę, określona w mikrojednostkach waluty strategii ustalania stawek. Jeśli go ustawisz, strategia ustalania stawek będzie uzyskiwać jak najwięcej konwersji przy docelowym lub niższym koszcie działania. Jeśli docelowy CPA nie jest ustawiony, strategia ustalania stawek dąży do osiągnięcia najniższego możliwego CPA w ramach danego budżetu. |
TargetCpa
Strategia automatycznego określania stawek, która ustala stawki, by pomóc Ci uzyskać jak największą liczbę konwersji przy wybranym przez Ciebie docelowym koszcie pozyskania (CPA).
Zapis JSON |
---|
{ "targetCpaMicros": string, "cpcBidCeilingMicros": string, "cpcBidFloorMicros": string } |
Pola | |
---|---|
targetCpaMicros |
Średni docelowy CPA. Ta wartość docelowa powinna być co najmniej równa minimalnej jednostce podlegającej rozliczeniu na podstawie waluty konta. |
cpcBidCeilingMicros |
Limit maksymalnej stawki, który można ustawić w strategii ustalania stawek. Limit dotyczy wszystkich słów kluczowych, którymi zarządza strategia. Tę wartość należy ustawiać tylko w strategiach portfolio ustalania stawek. |
cpcBidFloorMicros |
Limit minimalnej stawki, jaki może ustawić strategia ustalania stawek. Limit dotyczy wszystkich słów kluczowych, którymi zarządza strategia. Tę wartość należy ustawiać tylko w strategiach portfolio ustalania stawek. |
TargetRoas
Strategia automatycznego określania stawek, która pomaga zmaksymalizować przychody przy zachowaniu średniego docelowego zwrotu 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 znajdować się w zakresie od 0,01 do 1000,0 włącznie. |
cpcBidCeilingMicros |
Limit maksymalnej stawki, który można ustawić w strategii ustalania stawek. Limit dotyczy wszystkich słów kluczowych, którymi zarządza strategia. Tę wartość należy ustawiać tylko w strategiach portfolio ustalania stawek. |
cpcBidFloorMicros |
Limit minimalnej stawki, jaki może ustawić strategia ustalania stawek. Limit dotyczy wszystkich słów kluczowych, którymi zarządza strategia. Tę wartość należy ustawiać tylko w strategiach 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 |
Wycofane: docelowe wydatki, w ramach których ma być ustalona maksymalizacja liczby kliknięć. Licytujący „Docelowy poziom wydatków” spróbuje wydać mniejszą z tych wartości lub będzie to kwota wynikająca z naturalnego ograniczenia wydatków. Jeśli go nie podasz, jako docelowe wydatki będzie używany budżet. To pole zostało wycofane i nie powinno być już używane. Szczegółowe informacje można znaleźć na stronie https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html. |
cpcBidCeilingMicros |
Limit maksymalnej stawki, który można ustawić w strategii ustalania stawek. Limit dotyczy wszystkich słów kluczowych, którymi zarządza strategia. |
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 określająca częstotliwość wydawania budżetu kampanii. Jeśli w operacji tworzenia nie określono inaczej, domyślna wartość to STANDARD. |
period |
Okres, w którym budżet ma zostać wykorzystany. Jeśli nie zostanie określona, domyślna wartość to DAILY. |
amountMicros |
Kwota budżetu w walucie lokalnej konta. Kwota jest podawana w mikro, gdzie milion odpowiada jednej jednostce waluty. Miesięczne wydatki są ograniczone do 30,4 raza tej kwoty. |
BudgetDeliveryMethod
Możliwe metody wyświetlania budżetu.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używany tylko w przypadku zwracanej wartości. Reprezentuje wartość nieznaną w tej wersji. |
STANDARD |
Serwer budżetu będzie ograniczać wyświetlanie reklam równomiernie w całym okresie. |
ACCELERATED |
Serwer budżetu nie będzie ograniczać wyświetlania reklam, a reklamy będą się wyświetlać tak szybko, jak to możliwe. |
BudgetPeriod
Potencjalny okres budżetu.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używany tylko w przypadku zwracanej wartości. 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ć razem z wartością total_amount, by określić limit budżetu na cały okres. |
Kampania
Kampania.
Zapis JSON |
---|
{ "resourceName": string, "status": enum ( |
Pola | |
---|---|
resourceName |
Nazwa zasobu kampanii. Nazwy zasobów kampanii mają następujący format:
|
status |
Stan kampanii. Po dodaniu nowej kampanii jej stan przyjmuje domyślnie stan WŁĄCZONA. |
servingStatus |
Stan wyświetlania reklam w kampanii. |
biddingStrategySystemStatus |
Stan systemu 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 doprecyzować w sekcji To pole jest wymagane i nie powinno być puste podczas tworzenia nowych kampanii. Można go ustawić tylko podczas tworzenia kampanii. Po utworzeniu kampanii nie można zmienić tego pola. |
advertisingChannelSubType |
Opcjonalne doprecyzowanie: Można go ustawić tylko podczas tworzenia kampanii. Po utworzeniu kampanii nie można zmienić tego pola. |
urlCustomParameters[] |
Lista mapowań używanych do zastępowania tagów niestandardowych parametrów w elemencie |
realTimeBiddingSetting |
Ustawienia określania stawek w czasie rzeczywistym – funkcja dostępna tylko w kampaniach kierowanych na sieć Ad Exchange. |
networkSettings |
Ustawienia sieci w kampanii. |
dynamicSearchAdsSetting |
Ustawienie do kontrolowania dynamicznych reklam w wyszukiwarce (DSA). |
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 w celu utworzenia standardowej strategii ustalania stawek lub za pomocą pola To pole jest tylko do odczytu. |
accessibleBiddingStrategy |
Nazwa zasobu AccessibleOkreślanie stawek, czyli widok tylko do odczytu nieobjętych ograniczeniami atrybutów powiązanej strategii portfolio ustalania stawek zidentyfikowanych przez „biddingStrategy”. Jeśli kampania nie korzysta ze strategii portfolio, pole jest puste. Atrybuty strategii bez ograniczeń są dostępne dla wszystkich klientów, którym udostępniana jest strategia, i są odczytywane z zasobu AccessibleOkreślanie strategii. Atrybuty z ograniczeniami są natomiast dostępne tylko dla klientów będących właścicielami strategii i ich menedżerów. Atrybuty z ograniczeniami można odczytywać tylko z zasobu strategii ustalania stawek. |
frequencyCaps[] |
Lista, która ogranicza częstotliwość, z jaką każdy użytkownik będzie widzieć reklamy z tej kampanii. |
selectiveOptimization |
Ustawienie optymalizacji selektywnej dla tej kampanii, które obejmuje zestaw działań powodujących konwersję, pod kątem których ma być optymalizowana kampania. Ta funkcja dotyczy tylko kampanii promujących aplikacje, w których jako AdvertisingChannelType występuje MULTI_CHANNEL lub APP_CAMPAIGN lub APP_CAMPAIGN_FOR_ENGAGEMENT. |
optimizationGoalSetting |
Ustawienie celu optymalizacji dla tej kampanii, które zawiera zestaw typów celów optymalizacji. |
trackingSetting |
Ustawienia śledzenia informacji na poziomie kampanii. |
engineId |
Identyfikator kampanii na zewnętrznym koncie wyszukiwarki. To pole dotyczy tylko konta innego niż Google Ads, np. Yahoo Japan, Microsoft, Baidu itp. W przypadku podmiotu Google Ads użyj „campaign.id” . |
excludedParentAssetFieldTypes[] |
Typy pól komponentów, które powinny być wykluczone z tej kampanii. Połączenia komponentów z tymi typami pól nie będą dziedziczone przez tę kampanię z wyższego poziomu. |
createTime |
Sygnatura czasowa określająca, kiedy kampania została utworzona. Sygnatura czasowa jest podana w strefie czasowej klienta i w formacie „rrrr-MM-dd HH:mm:ss”. . Parametr createTime zostanie wycofany w wersji 1. Zamiast tego użyj createTime. |
creationTime |
Sygnatura czasowa określająca, kiedy kampania została utworzona. Sygnatura czasowa jest podana w strefie czasowej klienta i w formacie „rrrr-MM-dd HH:mm:ss”. . |
lastModifiedTime |
Data i godzina ostatniej modyfikacji kampanii. Data i godzina są w strefie czasowej klienta i w formacie „rrrr-MM-dd HH:mm:ss.sssss”. . |
id |
Identyfikator kampanii. |
name |
Nazwa kampanii To pole jest wymagane i nie powinno być puste podczas tworzenia nowych kampanii. Nie może zawierać znaków pustych (punkt kodowy 0x0), znaku nowego wiersza (punkt kodowy 0xA) ani znaków przejścia do nowej linii (punkt kodowy 0xD). |
trackingUrlTemplate |
Szablon URL do tworzenia linku monitorującego. |
campaignBudget |
Budżet kampanii. |
startDate |
Data rozpoczęcia wyświetlania kampanii w strefie czasowej klienta w formacie RRRR-MM-DD. |
endDate |
Ostatni dzień kampanii w strefie czasowej klienta w formacie RRRR-MM-DD. Podczas tworzenia przyjmuje on wartość domyślną 2037-12-30, co oznacza, że kampania będzie działać bez końca. Aby ustawić czas trwania istniejącej kampanii na czas nieokreślony, wybierz w tym polu wartość 2037-12-30. |
finalUrlSuffix |
Sufiks używany do dołączania parametrów zapytania do stron docelowych obsługiwanych przez śledzenie równoległe. |
urlExpansionOptOut |
Rezygnacja z rozwinięcia adresu URL na bardziej ukierunkowane adresy URL. Jeśli wyłączysz tę opcję (prawda), reklamy będą kierowane tylko na końcowe adresy URL w grupie plików lub adresy URL określone w Google Merchant Center reklamodawcy bądź w plikach firmowych baz danych reklamodawcy. Jeśli zasada jest włączona (fałsz), reklamy będą kierowane na całą domenę. To pole można skonfigurować tylko w przypadku kampanii Performance Max, które mają wartość domyślną „false”. |
Pole sumy Musi to być portfolio (utworzone za pomocą usługi strategii ustalania stawek) lub standardowe, umieszczone w kampanii. |
|
biddingStrategy |
Strategia portfolio ustalania stawek używana w kampanii. |
manualCpa |
Standardowa strategia samodzielnego ustawiania stawek CPA. Strategia samodzielnego ustawiania stawek, która pozwala reklamodawcy określać stawkę za działanie określone przez reklamodawcę. To ustawienie jest obsługiwane tylko w kampaniach w Usługach Lokalnych. |
manualCpc |
Standardowa strategia samodzielnego ustalania stawek CPC. Samodzielne określanie stawek na podstawie kliknięć, w ramach którego użytkownik płaci za kliknięcie. |
manualCpm |
Standardowa strategia samodzielnego ustawiania stawek CPM. Samodzielne określanie stawek na podstawie wyświetleń, w którym użytkownik płaci za tysiąc wyświetleń. |
maximizeConversions |
Standardowa strategia ustalania stawek Maksymalizacja liczby konwersji, która automatycznie maksymalizuje liczbę konwersji w ramach określonego budżetu. |
maximizeConversionValue |
Standardowa strategia ustalania stawek Maksymalizacja wartości konwersji, która automatycznie ustala stawki tak, aby zmaksymalizować przychody w ramach określonego budżetu. |
targetCpa |
Standardowa strategia ustalania stawek Docelowy CPA, która automatycznie ustala stawki, by pomóc Ci uzyskać jak największą liczbę konwersji przy wybranym przez Ciebie docelowym koszcie pozyskania (CPA). |
targetImpressionShare |
Strategia ustalania stawek pod kątem docelowego udziału w wyświetleniach. Strategia automatycznego określania stawek, która ustala stawki tak, by osiągnąć wybrany odsetek wyświetleń. |
targetRoas |
Standardowa strategia ustalania stawek Docelowy ROAS, która automatycznie maksymalizuje przychody przy zachowaniu średniego docelowego zwrotu 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 pod kątem procentu CPC, w której stawki stanowią ułamek reklamowanej ceny danego towaru lub usługi. |
targetCpm |
Strategia ustalania stawek, która automatycznie optymalizuje koszt tysiąca wyświetleń |
CampaignStatus
Możliwe stany kampanii.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używany tylko w przypadku zwracanej wartości. 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 żadnej wartości. |
UNKNOWN |
Otrzymana wartość nie jest znana w tej wersji. Ta wartość dotyczy tylko odpowiedzi. |
SERVING |
Wyświetlanie. |
NONE |
Brak. |
ENDED |
Zakończono. |
PENDING |
Oczekiwanie. |
SUSPENDED |
Zawieszony. |
BiddingStrategySystemStatus
Możliwe stany systemowe 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żywany tylko w przypadku zwracanej wartości. 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 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 budżetu. |
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 raportowania konwersji oraz od ostatnio zmodyfikowanych przez klienta typów konwersji, które były z nią związane. |
LEARNING_CONVERSION_SETTING_CHANGE |
Strategia ustalania stawek korzysta z raportowania konwersji, a klient niedawno zmienił swoje 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 minimalną stawkę. |
LIMITED_BY_DATA |
Strategia ustalania stawek jest ograniczona, ponieważ w ostatnich tygodniach nie było wystarczającej liczby konwersji. |
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, bo wydatki mają teraz mniejszy priorytet. |
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 list remarketingowych w przypadku inteligentnych kampanii produktowych. |
MISCONFIGURED_CONVERSION_TYPES |
Strategia ustalania stawek działa na podstawie raportowania konwersji, a klient nie ma typów konwersji, które można by uwzględnić w raportach. |
MISCONFIGURED_CONVERSION_SETTINGS |
Strategia ustalania stawek korzysta z raportowania konwersji, a ustawienia konwersji klienta są nieprawidłowo skonfigurowane. |
MISCONFIGURED_SHARED_BUDGET |
Poza strategią ustalania stawek występują kampanie, które mają wspólny budżet z kampaniami objętymi tą strategią. |
MISCONFIGURED_STRATEGY_TYPE |
Kampania ma nieprawidłowy typ strategii i nie wyświetla reklam. |
PAUSED |
Strategia ustalania stawek jest nieaktywna. Ze strategią ustalania stawek nie są powiązane żadne aktywne kampanie, grupy reklam lub słowa kluczowe. Z tą strategią ustalania stawek nie są też powiązane żadne aktywne budżety. |
UNAVAILABLE |
Ta strategia ustalania stawek nie obsługuje obecnie raportowania stanu. |
MULTIPLE_LEARNING |
W danym okresie ta strategia ustalania stawek miała wiele stanów systemu (LEARNING_*). |
MULTIPLE_LIMITED |
W danym okresie ta strategia ustalania stawek miała wiele stanów systemu (LIMITED_*). |
MULTIPLE_MISCONFIGURED |
W podanym okresie wystąpiło wiele statusów systemu tej strategii ustalania stawek: MISCONFIGURED_*. |
MULTIPLE |
W określonym czasie ta strategia ustalania stawek miała wiele stanów w systemie. |
AdServingOptimizationStatus
Wyliczenie opisujące możliwe stany wyświetlania.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono żadnej wartości. |
UNKNOWN |
Otrzymana wartość nie jest znana w tej wersji. Ta wartość dotyczy tylko odpowiedzi. |
OPTIMIZE |
Wyświetlanie reklam w kampanii jest optymalizowane na podstawie CTR. |
CONVERSION_OPTIMIZE |
Wyświetlanie reklam jest optymalizowane na podstawie współczynnika klikalności w kampanii. Jeśli kampania nie jest objęta strategią ustalania stawek optymalizator konwersji, domyślnie zostanie włączona OPTYMALIZACJA. |
ROTATE |
Reklamy są równomiernie wyświetlane na przemian przez 90 dni, a potem optymalizowane pod kątem kliknięć. |
ROTATE_INDEFINITELY |
Wyświetlaj mniej skuteczne reklamy bardziej równomiernie z reklamami o wyższej skuteczności 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żywany tylko w przypadku zwracanej wartości. Reprezentuje wartość nieznaną w tej wersji. |
SEARCH |
Sieć wyszukiwania. Obejmuje zarówno kampanie w sieci reklamowej, jak i kampanie w sieci wyszukiwania+. |
DISPLAY |
Tylko sieć reklamowa Google. |
SHOPPING |
Kampanie produktowe wyświetlają reklamy w usłudze zakupowej i w wynikach wyszukiwania w wyszukiwarce Google. |
HOTEL |
Kampanie 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. |
SOCIAL |
Kampanie w mediach społecznościowych. |
AdvertisingChannelSubType
Wyliczenie opisujące różne podtypy kanału.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używana tylko jako wartość zwracana. Reprezentuje wartość nieznaną w tej wersji. |
SEARCH_MOBILE_APP |
Kampanie aplikacji mobilnych w sieci wyszukiwania. |
DISPLAY_MOBILE_APP |
Kampanie aplikacji mobilnych 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 pozwoli Ci łatwo promować aplikację na Androida lub iOS w najpopularniejszych 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 zwiększaniu zaangażowania użytkowników w aplikację w kilku najpopularniejszych usługach Google, m.in. w wyszukiwarce, YouTube i sieci reklamowej Google. |
LOCAL_CAMPAIGN |
Kampanie specjalistyczne z myślą o reklamie lokalnej. |
SHOPPING_COMPARISON_LISTING_ADS |
Kampanie z porównaniem informacji o produktach w Zakupach Google. |
SMART_CAMPAIGN |
Standardowe kampanie inteligentne. |
VIDEO_SEQUENCE |
Kampanie wideo z sekwencyjnymi reklamami wideo. |
APP_CAMPAIGN_FOR_PRE_REGISTRATION |
Kampania promująca aplikację z wcześniejszą rejestracją, skierowana do wcześniejszej rejestracji na aplikacje mobilne, 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 |
Kampanie związane z podróżami. |
SOCIAL_FACEBOOK_TRACKING_ONLY |
Facebook śledzi tylko kampanie w mediach społecznościowych. |
CustomParameter
Mapowanie, którego może używać tagi parametrów niestandardowych w elemencie 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 – funkcja dostępna tylko w kampaniach kierowanych na sieć Ad Exchange.
Zapis JSON |
---|
{ "optIn": boolean } |
Pola | |
---|---|
optIn |
Od tego, czy w kampanii jest włączone określanie stawek w czasie rzeczywistym. |
NetworkSettings
Ustawienia sieci w kampanii.
Zapis JSON |
---|
{ "targetGoogleSearch": boolean, "targetSearchNetwork": boolean, "targetContentNetwork": boolean, "targetPartnerSearchNetwork": boolean } |
Pola | |
---|---|
targetGoogleSearch |
Określa, czy reklamy będą wyświetlane z wynikami wyszukiwania google.com. |
targetSearchNetwork |
Określa, czy reklamy będą wyświetlane w witrynach partnerów w sieci wyszukiwania Google (wymaga też ustawienia |
targetContentNetwork |
Określa, czy reklamy będą wyświetlane w określonych miejscach docelowych w sieci reklamowej Google. Miejsca docelowe określa się za pomocą kryterium Miejsce docelowe. |
targetPartnerSearchNetwork |
Określa, czy reklamy będą wyświetlane w sieci partnerskiej Google. Ta funkcja jest dostępna tylko na niektórych wybranych kontach partnerów Google. |
DynamicSearchAdsSetting
Ustawienie do kontrolowania dynamicznych reklam w wyszukiwarce (DSA).
Zapis JSON |
---|
{ "domainName": string, "languageCode": string, "useSuppliedUrlsOnly": boolean } |
Pola | |
---|---|
domainName |
Wymagane. Nazwa domeny internetowej reprezentowanej przez to ustawienie, na przykład „google.com” lub „www.google.com”. |
languageCode |
Wymagane. Kod języka określający język domeny, np. „en”. |
useSuppliedUrlsOnly |
Określa, czy kampania korzysta wyłącznie z adresów URL dostarczonych przez reklamodawcę. |
ShoppingSetting
Ustawienie dla kampanii produktowych. Określa szeroką gamę produktów, które można reklamować w ramach kampanii, oraz sposób interakcji tej kampanii z innymi kampaniami produktowymi.
Zapis JSON |
---|
{ "feedLabel": string, "useVehicleInventory": boolean, "merchantId": string, "salesCountry": string, "campaignPriority": integer, "enableLocal": boolean } |
Pola | |
---|---|
feedLabel |
Etykieta pliku danych z produktami do uwzględnienia w kampanii. Można ustawić tylko jedną wartość fileLabel lub salesCountry. Jeśli jest używany zamiast atrybutu salesCountry, pole fileLabel akceptuje kody krajów w tym samym formacie, np. „XX”. W innym przypadku może to być dowolny ciąg znaków używany jako etykieta pliku danych w Google Merchant Center. |
useVehicleInventory |
Określa, czy kierować reklamy na zasoby reklamowe z informacjami o pojazdach. |
merchantId |
Identyfikator konta Merchant Center. To pole jest wymagane przy tworzeniu operacji tworzenia. Tego pola nie można zmienić w przypadku kampanii produktowych. |
salesCountry |
Kraj sprzedaży produktów, które mają być uwzględnione w kampanii. |
campaignPriority |
Priorytet kampanii. Kampanie z numerycznie wyższym priorytetem mają pierwszeństwo przed kampaniami o niższych priorytetach. To pole jest wymagane w przypadku kampanii produktowych z wartościami od 0 do 2 włącznie. To pole jest opcjonalne w przypadku inteligentnych kampanii produktowych, ale jeśli jest skonfigurowane, musi zawierać 3. |
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 stosowane do niewykluczającego kierowania geograficznego w tej konkretnej kampanii. |
negativeGeoTargetType |
Ustawienie używane do wykluczającego kierowania geograficznego w tej konkretnej kampanii. |
PositiveGeoTargetType
Możliwe dodatnie typy kierowania geograficznego.
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świetlać, gdy użytkownik znajduje się w wybranych lokalizacjach reklamodawcy lub jest nimi zainteresowany. |
SEARCH_INTEREST |
Określa, że reklama jest wyświetlana, gdy użytkownik wyszukuje lokalizacje docelowe reklamodawcy. Tej opcji można używać tylko w kampaniach w sieci wyszukiwania i standardowych kampaniach produktowych. |
PRESENCE |
Określa, że reklama ma się wyświetlać, gdy użytkownik znajduje się w wybranych przez reklamodawcę lokalizacjach lub regularnie w nich bywa. |
NegativeGeoTargetType
Możliwe wykluczające typy kierowania geograficznego.
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 może zobaczyć reklamy, jeśli znajduje się w wykluczonych lokalizacjach reklamodawcy lub jest nimi zainteresowany. |
PRESENCE |
Określa, że użytkownik nie może zobaczyć reklamy, jeśli znajduje się w wykluczonych lokalizacjach reklamodawcy. |
FrequencyCapEntry
Ten typ nie zawiera pól.
Reguła określająca maksymalną liczbę wyświetleń reklamy (lub zestawu reklam) użytkownikowi w danym okresie.
SelectiveOptimization
Ustawienie optymalizacji selektywnej dla tej kampanii, które obejmuje zestaw działań powodujących konwersję, pod kątem których ma być optymalizowana kampania. Ta funkcja dotyczy tylko kampanii promujących aplikacje, w których jako AdvertisingChannelType występuje MULTI_CHANNEL lub APP_CAMPAIGN lub APP_CAMPAIGN_FOR_ENGAGEMENT.
Zapis JSON |
---|
{ "conversionActions": [ string ] } |
Pola | |
---|---|
conversionActions[] |
Wybrany zestaw działań powodujących konwersję do optymalizacji tej kampanii. |
OptimizationGoalSetting
Ustawienie celu optymalizacji dla tej kampanii, które zawiera zestaw 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 |
Używana tylko jako wartość zwracana. Reprezentuje wartość nieznaną w tej wersji. |
CALL_CLICKS |
Optymalizacja pod kątem kliknięć prowadzących do połączenia. Konwersje po kliknięciu to liczba kliknięć opcji „Połączenie” skontaktować się ze sklepem po obejrzeniu reklamy. |
DRIVING_DIRECTIONS |
Optymalizuj pod kątem wskazówek dojazdu. Konwersje typu „Trasa dojazdu” pokazują, ile razy użytkownicy kliknęli opcję „Wyznacz trasę” przejść do sklepu po obejrzeniu reklamy. |
APP_PRE_REGISTRATION |
Optymalizacja pod kątem wcześniejszej rejestracji. Konwersje związane z wcześniejszą rejestracją to liczba osób, które skorzystały z wcześniejszej rejestracji, aby otrzymać powiadomienie o jej opublikowaniu. |
TrackingSetting
Ustawienia śledzenia informacji na poziomie kampanii.
Zapis JSON |
---|
{ "trackingUrl": string } |
Pola | |
---|---|
trackingUrl |
Adres URL używany do dynamicznego śledzenia. |
ManualCpa
Ten typ nie zawiera pól.
Strategia samodzielnego ustawiania stawek, która pozwala reklamodawcy określać stawkę za działanie określone przez reklamodawcę.
ManualCpc
Samodzielne określanie stawek na podstawie kliknięć, w ramach którego użytkownik płaci za kliknięcie.
Zapis JSON |
---|
{ "enhancedCpcEnabled": boolean } |
Pola | |
---|---|
enhancedCpcEnabled |
Określa, czy stawki mają być ulepszone na podstawie danych z optymalizatora konwersji. |
ManualCpm
Ten typ nie zawiera pól.
Samodzielne 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 stanowią ułamek ceny reklamowanej danego towaru lub danej usługi.
Zapis JSON |
---|
{ "cpcBidCeilingMicros": string, "enhancedCpcEnabled": boolean } |
Pola | |
---|---|
cpcBidCeilingMicros |
Limit maksymalnej stawki, który można ustawić w strategii ustalania stawek. To jest opcjonalne pole podane przez reklamodawcę i określone w lokalnych mikro. Uwaga: wartość zerowa jest interpretowana w taki sam sposób, jak bez zdefiniowania atrybutu bid_pu pułap. |
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ć wartość cpcBidCeilingMicros, ale średnia kwota stawki w kampanii nie powinna. |
TargetCpm
Ten typ nie zawiera pól.
Docelowy CPM (koszt tysiąca wyświetleń) to strategia automatycznego określania stawek, która ustala stawki w celu optymalizacji skuteczności pod kątem docelowego CPM.
CampaignAsset
Połączenie kampanii i zasobu.
Zapis JSON |
---|
{
"resourceName": string,
"status": enum ( |
Pola | |
---|---|
resourceName |
Nazwa zasobu komponentu kampanii. Nazwy zasobów CampaignAsset mają następujący format:
|
status |
Stan komponentu kampanii. |
campaign |
Kampania, z którą połączony jest komponent. |
asset |
Komponent powiązany z kampanią. |
Zestaw komponentów kampanii
CampaignAssetSet łączy kampanię z zestawem komponentów. Dodanie elementu CampaignAssetSet łączy zestaw komponentów z kampanią.
Zapis JSON |
---|
{
"resourceName": string,
"campaign": string,
"assetSet": string,
"status": enum ( |
Pola | |
---|---|
resourceName |
Nazwa zasobu zbioru zasobów kampanii. Nazwy zasobów w zestawie zasobów mają taką postać:
|
campaign |
Kampania, z którą połączony jest ten zestaw komponentów. |
assetSet |
Zbiór komponentów powiązany z kampanią. |
status |
Stan komponentu w zestawie komponentów kampanii. Tylko do odczytu. |
CampaignAudienceView
Widok odbiorców kampanii. Zawiera dane o skuteczności oparte na zainteresowaniach i listach remarketingowych dla reklam w sieci reklamowej i w YouTube oraz z list remarketingowych dla reklam w wyszukiwarce (RLSA) zebrane według kryteriów kampanii i odbiorców. Ten widok obejmuje tylko listy odbiorców dołączone na poziomie kampanii.
Zapis JSON |
---|
{ "resourceName": string } |
Pola | |
---|---|
resourceName |
Nazwa zasobu w widoku odbiorców na poziomie kampanii. Nazwy zasobów widoku odbiorców w kampanii mają taką postać:
|
CampaignCriterion
Kryterium kampanii.
Zapis JSON |
---|
{ "resourceName": string, "displayName": string, "type": enum ( |
Pola | |
---|---|
resourceName |
Nazwa zasobu kryterium kampanii. Nazwy zasobów kryterium kampanii mają taką postać:
|
displayName |
Wyświetlana nazwa kryterium. To pole jest ignorowane w przypadku mutacji. |
type |
Typ kryterium. |
status |
Stan kryterium. |
lastModifiedTime |
Data i godzina ostatniej modyfikacji tego kryterium kampanii. Data i godzina są w strefie czasowej klienta i w formacie „rrrr-MM-dd HH:mm:ss.sssss”. . |
criterionId |
Identyfikator kryterium. To pole jest ignorowane podczas mutacji. |
bidModifier |
Modyfikator stawek w przypadku dopasowania do kryterium. Modyfikator musi należeć do zakresu od 0,1 do 10,0. Większość typów kryteriów kierowania reklam obsługuje modyfikatory. Aby zrezygnować z urządzeń danego typu, wpisz 0. |
negative |
Określa, czy kryterium ma być celem ( |
Pole sumy Musisz ustawić tylko jedną opcję. |
|
keyword |
Słowo kluczowe. |
location |
Lokalizacja. |
device |
Urządzenie. |
ageRange |
Przedział wiekowy. |
gender |
Płeć. |
userList |
Lista użytkowników. |
language |
Język. |
webpage |
Strona internetowa. |
locationGroup |
Grupa lokalizacji |
CampaignCriterionStatus
Możliwe stany elementu CampaignCriterion.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono żadnej wartości. |
UNKNOWN |
Otrzymana wartość nie jest znana w tej wersji. Ta wartość dotyczy tylko odpowiedzi. |
ENABLED |
Kryterium kampanii jest włączone. |
PAUSED |
Kryterium kampanii jest wstrzymane. |
REMOVED |
Usunięto kryterium kampanii. |
LanguageInfo
Kryterium języka.
Zapis JSON |
---|
{ "languageConstant": string } |
Pola | |
---|---|
languageConstant |
Nazwa zasobu stałej języka. |
LocationGroupInfo
Promień wokół listy lokalizacji określonej za pomocą pliku danych.
Zapis JSON |
---|
{
"geoTargetConstants": [
string
],
"radiusUnits": enum ( |
Pola | |
---|---|
geoTargetConstants[] |
Stała kierowania geograficznego, która ogranicza zakres obszaru geograficznego w pliku danych. Obecnie dozwolona jest tylko 1 stała wartość kierowania geograficznego. |
radiusUnits |
Jednostka promienia. W przypadku stałych kierowania geograficznego obsługiwane są mile i metry. W przypadku zestawów plików danych obsługiwane są milimetry i mile. To pole jest wymagane i należy je ustawić w operacjach CREATE. |
feedItemSets[] |
FeedItemSets, których elementy FeedItem są celem kierowania. Jeśli określisz większą liczbę identyfikatorów, reklamy będą kierowane na wszystkie elementy, które występują w co najmniej 1 zestawie. Tego pola nie można używać z geoTargetConstants. Jest to opcjonalne i można je ustawić tylko w operacjach CREATE. |
radius |
Odległość w jednostkach określająca promień wokół wybranych lokalizacji. To pole jest 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żywany tylko w przypadku zwracanej wartości. Reprezentuje wartość nieznaną w tej wersji. |
METERS |
Metry |
MILES |
Mile |
MILLI_MILES |
Milimetry |
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ą następujący format: |
campaign |
Kampania, do której dołączona jest etykieta. |
label |
Etykieta przypisana do kampanii. |
CartDataSalesView
Widok sprzedaży danych koszyka.
Zapis JSON |
---|
{ "resourceName": string } |
Pola | |
---|---|
resourceName |
Nazwa zasobu widoku danych sprzedaży danych koszyka. Nazwy zasobów widoku danych sprzedaży danych koszyka mają format: |
Odbiorcy
Odbiorcy to skuteczna opcja kierowania, która umożliwia łączenie różnych atrybutów segmentów, np. szczegółowych danych demograficznych i podobnych zainteresowań, w celu tworzenia list odbiorców reprezentujących sekcje segmentów docelowych.
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 być niepowtarzalny wśród wszystkich odbiorców. Minimalna długość to 1, a maksymalna – 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ą następujący format:
|
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 raportowanych 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 bit mainForGoal działania powodującego konwersję ma wartość false (fałsz), nie można określać stawki za działanie powodujące konwersję we wszystkich kampaniach, niezależnie od celu konwersji klienta lub kampanii. Niestandardowe cele konwersji nie respektują jednak tego działania, więc jeśli kampania ma niestandardowy cel konwersji skonfigurowany z wartością mainForGoal = false conversion action (fałsz), nadal można określać stawki za to działanie. Jeśli nie zostanie ustawiona, domyślnie będzie miała wartość trueForGoal. W wersji 9 parametr mainForGoal można ustawić na wartość „false” tylko po utworzeniu za pomocą funkcji „update” , ponieważ nie jest zadeklarowana jako opcjonalna. |
ownerCustomer |
Nazwa zasobu klienta będącego właścicielem działania powodującego konwersję lub wartość null, jeśli jest to działanie powodujące konwersję zdefiniowane przez system. |
includeInClientAccountConversionsMetric |
Określa, czy to działanie powodujące konwersję ma być uwzględnione w kolumnie „clientAccountConversions” danych. |
includeInConversionsMetric |
Określa, czy to działanie powodujące konwersję powinno zostać uwzględnione w kolumnie „Konwersje” danych. |
clickThroughLookbackWindowDays |
Maksymalna liczba dni, które mogą upływać między interakcją (np. kliknięciem) a zdarzeniem konwersji. |
appId |
Identyfikator aplikacji dla 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żywany tylko w przypadku zwracanej wartości. 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żywany tylko w przypadku zwracanej wartości. Reprezentuje wartość nieznaną w tej wersji. |
AD_CALL |
Konwersje, do których dochodzi, gdy użytkownik kliknie rozszerzenie połączeń w reklamie. |
CLICK_TO_CALL |
Konwersje, do których dochodzi, 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 dokona zakupu w aplikacji, korzystając z płatności na Androida. |
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, które mają miejsce na stronie internetowej. |
WEBSITE_CALL |
Konwersje, które mają miejsce, gdy użytkownik zadzwoni pod dynamicznie wygenerowany numer telefonu w witrynie reklamodawcy. |
STORE_SALES_DIRECT_UPLOAD |
Konwersje polegające na sprzedaży w sklepie stacjonarnym są rejestrowane na podstawie przesłanych danych własnych lub danych sprzedawców zewnętrznych. Tylko klienci z listy dozwolonych mogą korzystać z bezpośredniego przesyłania danych o sprzedaży w sklepie. |
STORE_SALES |
Konwersje polegające na sprzedaży w sklepie stacjonarnym są określane na podstawie przesłanych danych własnych lub danych sprzedawców zewnętrznych bądź danych o zakupach w sklepach dokonanych przy użyciu kart pochodzących z sieci płatności. Tylko klienci z listy dozwolonych mogą używać typów sprzedaży w sklepie. 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 śledzone za pomocą Firebase. |
FIREBASE_ANDROID_CUSTOM |
Konwersje niestandardowe z aplikacji na Androida śledzone przez Firebase. |
FIREBASE_IOS_FIRST_OPEN |
Konwersje przy pierwszym uruchomieniu aplikacji na iOS śledzone przez Firebase. |
FIREBASE_IOS_IN_APP_PURCHASE |
Konwersje polegające na zakupie aplikacji na iOS śledzone przez Firebase. |
FIREBASE_IOS_CUSTOM |
Konwersje niestandardowe w aplikacjach na iOS śledzone przez Firebase. |
THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN |
Konwersje przy pierwszym uruchomieniu aplikacji na Androida śledzone przez analizę aplikacji przez firmy zewnętrzne. |
THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE |
Konwersje polegające na zakupie aplikacji na Androida śledzone za pomocą analityki aplikacji przez firmy zewnętrzne. |
THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM |
Niestandardowe konwersje w aplikacjach na Androida śledzone przez analizę aplikacji przez firmy zewnętrzne. |
THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN |
Konwersje przy pierwszym uruchomieniu aplikacji na iOS śledzone przez analizę aplikacji przez firmy zewnętrzne. |
THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE |
Konwersje polegające na zakupie aplikacji na iOS śledzone przez analizę aplikacji przez firmy zewnętrzne. |
THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM |
Niestandardowe konwersje w aplikacjach na iOS śledzone przez analizę aplikacji przez firmy zewnętrzne. |
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 według typu aplikacji. Tylko do odczytu. |
FLOODLIGHT_ACTION |
Aktywność Floodlight zliczająca wizyty konkretnej strony po zobaczeniu lub kliknięciu jednej z reklam reklamodawcy. Tylko do odczytu. |
FLOODLIGHT_TRANSACTION |
Aktywność Floodlight, która śledzi liczbę zrealizowanych transakcji sprzedaży lub liczbę kupionych produktów. Umożliwia też rejestrowanie łącznej wartości każdej sprzedaży. Tylko do odczytu. |
GOOGLE_HOSTED |
Konwersje, które śledzą działania lokalne związane z produktami i usługami Google po interakcji z reklamą. Tylko do odczytu. |
LEAD_FORM_SUBMIT |
Konwersje 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 rejestrowane w reklamach w kampanii inteligentnej bez skonfigurowanego śledzenia połączeń, które korzystają z kryteriów niestandardowych 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 rejestrowane w reklamach w kampanii inteligentnej ze skonfigurowanym śledzeniem połączeń, które korzystają z kryteriów niestandardowych kampanii inteligentnej. Tylko do odczytu. |
STORE_VISITS |
Konwersje, do których dochodzi, 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 osobnych kodów zdarzeń. Tylko do odczytu. |
UNIVERSAL_ANALYTICS_GOAL |
Konwersje pochodzące z połączonych celów Universal Analytics. |
UNIVERSAL_ANALYTICS_TRANSACTION |
Konwersje pochodzące z połączonych transakcji Universal Analytics. |
GOOGLE_ANALYTICS_4_CUSTOM |
Konwersje pochodzące z połączonych konwersji zdarzeń niestandardowych Google Analytics 4. |
GOOGLE_ANALYTICS_4_PURCHASE |
Konwersje pochodzące z połączonych konwersji polegających na zakupie w Google Analytics 4. |
ConversionActionCategory
Kategoria konwersji powiązanych z działaniem ConversionAction.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używany tylko w przypadku zwracanej wartości. Reprezentuje wartość nieznaną w tej wersji. |
DEFAULT |
Kategoria domyślna. |
PAGE_VIEW |
Użytkownik odwiedzający stronę. |
PURCHASE |
Zakup, sprzedaż lub zamówienie . |
SIGNUP |
Działanie rejestracji użytkownika. |
LEAD |
Działanie nastawione na zdobywanie potencjalnych klientów. |
DOWNLOAD |
Działanie pobierania oprogramowania (jak w przypadku aplikacji). |
ADD_TO_CART |
Dodanie produktów do koszyka lub torby na zakupy na stronie reklamodawcy. |
BEGIN_CHECKOUT |
Gdy ktoś rozpoczyna proces płatności na stronie reklamodawcy. |
SUBSCRIBE_PAID |
Początek płatnej subskrypcji produktu lub usługi. |
PHONE_CALL_LEAD |
Telefon do wyrażenia zainteresowania ofertą reklamodawcy. |
IMPORTED_LEAD |
Konwersja polegająca na wypełnieniu formularza kontaktowego została zaimportowana ze źródła zewnętrznego do Google Ads. |
SUBMIT_LEAD_FORM |
Przesłanie w witrynie reklamodawcy formularza wyrażającego zainteresowanie firmą |
BOOK_APPOINTMENT |
Rezerwacja spotkania z firmą reklamodawcy. |
REQUEST_QUOTE |
Prośba o wycenę lub wycenę. |
GET_DIRECTIONS |
Wyszukiwanie lokalizacji firmy reklamodawcy z zamiarem wizyty w niej |
OUTBOUND_CLICK |
Kliknięcie prowadzące do witryny partnera reklamodawcy. |
CONTACT |
Połączenie, SMS, e-mail, czat lub inny rodzaj kontaktu z reklamodawcą. |
ENGAGEMENT |
Zdarzenie związane z zaangażowaniem w witrynę, takie jak długi czas korzystania z witryny lub cel inteligentny Google Analytics (GA). Rola przeznaczona do importowania celów dotyczących Google Analytics, Firebase i Google Analytics na poziomie złotym. |
STORE_VISIT |
Wizyta w sklepie stacjonarnym. |
STORE_SALE |
Sprzedaż w sklepie stacjonarnym. |
QUALIFIED_LEAD |
Konwersja polegająca na wypełnieniu formularza kontaktowego zaimportowana do Google Ads ze źródła zewnętrznego i zakwalifikowana przez reklamodawcę (zespół ds. marketingu/sprzedaży). Na ścieżce od potencjalnego klienta do sprzedaży reklamodawcy zdobywają kontakty do potencjalnych klientów, a następnie kontaktują się z nimi. Jeśli klient jest zainteresowany i może w końcu kupić jego produkt, oznacza takich potencjalnych klientów jako „zakwalifikowanych potencjalnych klientów”. |
CONVERTED_LEAD |
Konwersja polegająca na wypełnieniu formularza kontaktowego została zaimportowana do Google Ads ze źródła zewnętrznego, która zakończyła się wybranym etapem określonym przez reklamodawcę zajmującego się zdobywaniem 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ść używana, gdy zdarzenia konwersji dla tego działania powodującego konwersję są wysyłane z nieprawidłową, niedozwoloną lub brakującą wartością albo gdy to działanie powodujące konwersję jest skonfigurowane tak, aby zawsze używało wartości domyślnej. |
defaultCurrencyCode |
Kod waluty używany, gdy zdarzenia konwersji dla tego działania powodującego konwersję są wysyłane z nieprawidłowym kodem waluty lub bez niego albo gdy to działanie powodujące konwersję jest skonfigurowane tak, aby zawsze używało wartości domyślnej. |
alwaysUseDefaultValue |
Określa, czy zamiast kodu wartości i kodu waluty określone w zdarzeniach konwersji dla tego działania powodującego konwersję mają być używane wartość domyślna i kod waluty domyślnej. |
AttributionModelSettings
Ustawienia związane z modelem atrybucji tego działania powodującego konwersję.
Zapis JSON |
---|
{ "attributionModel": enum ( |
Pola | |
---|---|
attributionModel |
Typ modelu atrybucji dla tego działania powodującego konwersję. |
dataDrivenModelStatus |
Stan modelu atrybucji opartej na danych dla działania powodującego konwersję. |
AttributionModel
Model atrybucji, który opisuje, jak przypisywać udział w konkretnej konwersji na wiele wcześniejszych interakcji.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używany tylko w przypadku zwracanej wartości. Reprezentuje wartość nieznaną w tej wersji. |
EXTERNAL |
Wykorzystuje zewnętrzny model atrybucji. |
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 za pomocą atrybucji w wyszukiwarce Google. |
GOOGLE_SEARCH_ATTRIBUTION_LINEAR |
Korzystając z atrybucji w wyszukiwarce Google, przypisuje udział w konwersji po równo wszystkim kliknięciom. |
GOOGLE_SEARCH_ATTRIBUTION_TIME_DECAY |
Korzystając z modelu atrybucji w wyszukiwarce Google, znacznie większy udział przypisuje się w konwersji najnowszym kliknięciom (okres półtrwania to 1 tydzień). |
GOOGLE_SEARCH_ATTRIBUTION_POSITION_BASED |
Przypisuje 40% udziału w konwersji pierwszemu i ostatniemu kliknięciu. Pozostałe 20% jest równomiernie rozdzielane na pozostałe kliknięcia. Wykorzystuje atrybucję w wyszukiwarce Google. |
GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN |
Elastyczny model, który wykorzystuje systemy uczące się do określenia odpowiedniego udziału w konwersji między kliknięcia przy użyciu atrybucji w wyszukiwarce Google. |
DataDrivenModelStatus
Wylicza stany modelu opartego na danych.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używany tylko w przypadku zwracanej wartości. Reprezentuje wartość nieznaną w tej wersji. |
AVAILABLE |
Dostępny jest model oparty na danych. |
STALE |
Model oparty na danych jest nieaktualny. Nie było aktualizowane od co najmniej 7 dni. Nadal jest używana, ale wygaśnie, jeśli nie zostanie zaktualizowana w ciągu 30 dni. |
EXPIRED |
Model oparty na danych wygasł. Nie były aktualizowane od co najmniej 30 dni i nie można ich używać. Najczęściej dzieje się tak, gdy w ciągu ostatnich 30 dni nie wystąpiła wymagana liczba zdarzeń. |
NEVER_GENERATED |
Model oparty na danych nigdy nie został wygenerowany. Dzieje się tak najczęściej dlatego, że w żadnym 30-dniowym okresie nigdy nie wystąpiła wymagana liczba zdarzeń. |
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 identyfikowania grupy aktywności Floodlight podczas raportowania konwersji. |
activityTag |
Ciąg tekstowy służący do rozpoznawania aktywności Floodlight podczas raportowania konwersji. |
activityId |
Identyfikator aktywności Floodlight w usłudze DoubleClick Campaign Manager (DCM). |
ConversionCustomVariable
Zmienna niestandardowa konwersji. Przeczytaj artykuł „Informacje o niestandardowych danych i wymiarach Floodlight w nowej wersji Search Ads 360” na stronie https://support.google.com/sa360/answer/13567857.
Zapis JSON |
---|
{ "resourceName": string, "id": string, "name": string, "tag": string, "status": enum ( |
Pola | |
---|---|
resourceName |
Nazwa zasobu zmiennej niestandardowej konwersji. Nazwy zasobów zmiennych niestandardowych 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 ani po nim nie może być żadnych dodatkowych spacji. |
tag |
Wymagane. Tag niestandardowej zmiennej konwersji. Tag powinien być niepowtarzalny i zawierać literę „u” bezpośrednio po którym następuje liczba mniejsza niż ormrówna 100. Na przykład: „u4”. |
status |
Stan niestandardowej zmiennej niestandardowej konwersji na potrzeby naliczania zdarzeń konwersji. |
ownerCustomer |
Nazwa zasobu klienta, do którego należy zmienna niestandardowa konwersji. |
family |
Rodzina zmiennej niestandardowej konwersji. |
cardinality |
Moc zbioru niestandardowej zmiennej konwersji. |
floodlightConversionCustomVariableInfo |
Pola zmiennych niestandardowych konwersji Floodlight w Search Ads 360. |
customColumnIds[] |
Identyfikatory kolumn niestandardowych, które korzystają z tej niestandardowej zmiennej konwersji. |
ConversionCustomVariableStatus
Możliwe stany niestandardowej zmiennej konwersji.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używany tylko w przypadku zwracanej wartości. Reprezentuje wartość nieznaną w tej wersji. |
ACTIVATION_NEEDED |
Niestandardowa zmienna konwersji oczekuje na aktywację i nie będzie gromadzić statystyk, dopóki nie zostanie włączona. Tego stanu nie można używać w żądaniach CREATE i UPDATE. |
ENABLED |
Niestandardowa zmienna konwersji jest włączona i będzie gromadzić statystyki. |
PAUSED |
Niestandardowa zmienna konwersji zostanie wstrzymana i nie będzie gromadzić statystyk, dopóki ponownie nie zostanie ustawiona na WŁĄCZONA. |
ConversionCustomVariableFamily
Rodzina zmiennej niestandardowej konwersji.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używany tylko w przypadku zwracanej wartości. Reprezentuje wartość nieznaną w tej wersji. |
STANDARD |
Standardowa zmienna niestandardowa konwersji. Klienci muszą przeprowadzić aktywację 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żywany tylko w przypadku zwracanej wartości. Reprezentuje wartość nieznaną w tej wersji. |
BELOW_ALL_LIMITS |
Niestandardowa zmienna konwersji ma moc zbioru poniżej wszystkich limitów. Zmienna może być używana do podziału na segmenty, a jeśli jest włączona, statystyki mogą być gromadzone dla nowych wartości. |
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 włączenie zmiennej może spowodować naliczanie nowych statystyk. |
APPROACHES_STATS_LIMIT |
Niestandardowa zmienna konwersji przekroczyła limity podziału na segmenty i zbliża się do limitów statystyk (> 90%). Podział na segmenty zostanie wyłączony, ale włączenie zmiennej może spowodować naliczanie nowych statystyk. |
EXCEEDS_STATS_LIMIT |
Niestandardowa zmienna konwersji przekroczyła zarówno limity segmentacji, jak i statystyki. Podział na segmenty zostanie wyłączony, a statystyki włączonych zmiennych będą zbierane tylko wtedy, gdy istniejące wartości nie zwiększają jeszcze mocy zbioru zmiennej. |
FloodlightConversionCustomVariableInfo
Informacje o zmiennych niestandardowych konwersji Floodlight w Search Ads 360.
Zapis JSON |
---|
{ "floodlightVariableType": enum ( |
Pola | |
---|---|
floodlightVariableType |
Typ zmiennej Floodlight określony 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żywany tylko w przypadku zwracanej wartości. Reprezentuje wartość nieznaną w tej wersji. |
DIMENSION |
Typ zmiennej Floodlight wymiaru. |
METRIC |
Typ zmiennej danych Floodlight. |
UNSET |
Typ zmiennej Floodlight jest nieskonfigurowany. |
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żywany tylko w przypadku zwracanej wartości. Reprezentuje wartość nieznaną w tej wersji. |
NUMBER |
Reprezentuje zmienną Floodlight typu „Liczba” typu. Ta zmienna może być przypisana do zmiennych Floodlight typu DIMENSION lub METRIC. |
STRING |
Reprezentuje zmienną Floodlight obiektu „String” typu. 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 klientów mają następujący format:
|
conversionTrackingSetting |
Ustawienie śledzenia konwersji dla klienta. |
accountType |
rodzaj konta wyszukiwarki, np. Google Ads, Microsoft Advertising, Yahoo Japan, Baidu, Facebook, śledzenie wyszukiwarki itp. |
doubleClickCampaignManagerSetting |
Ustawienie usługi DoubleClick Campaign Manager (DCM) w przypadku klienta menedżera. |
accountStatus |
Stan konta, np. włączone, wstrzymane, usunięte itp. |
lastModifiedTime |
Data i godzina ostatniej modyfikacji danych klienta. Data i godzina są w strefie czasowej klienta i w formacie „rrrr-MM-dd HH:mm:ss.sssss”. . |
engineId |
Identyfikator konta na zewnętrznym koncie wyszukiwarki. |
status |
Stan klienta. |
creationTime |
Sygnatura czasowa określająca, kiedy ten klient został utworzony. Sygnatura czasowa jest podana w strefie czasowej klienta i w formacie „rrrr-MM-dd HH:mm:ss”. . |
id |
Identyfikator klienta. |
descriptiveName |
Opcjonalna, nieunikalna opisowa nazwa klienta. |
currencyCode |
Waluta, w której działa konto. Obsługiwany jest podzbiór kodów walut ze standardu ISO 4217. |
timeZone |
Identyfikator lokalnej strefy czasowej klienta. |
trackingUrlTemplate |
Szablon URL 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 całego klienta związanych ze śledzeniem konwersji w Search Ads 360.
Zapis JSON |
---|
{
"acceptedCustomerDataTerms": boolean,
"conversionTrackingStatus": enum ( |
Pola | |
---|---|
acceptedCustomerDataTerms |
Określa, czy klient zaakceptował warunki dotyczące danych klienta. Jeśli stosujesz śledzenie konwersji dla wielu kont, ta wartość jest dziedziczona z konta menedżera. To pole jest tylko do odczytu. Więcej informacji znajdziesz na https://support.google.com/adspolicy/answer/7475709. |
conversionTrackingStatus |
Stan śledzenia konwersji. Wskazuje, czy klient używa śledzenia konwersji i kto jest właścicielem śledzenia konwersji tego klienta. Jeśli ten klient używa śledzenia konwersji dla wielu kont, zwrócona wartość będzie różnić się w zależności od |
enhancedConversionsForLeadsEnabled |
Określa, czy klient wyraził zgodę na konwersje rozszerzone dotyczące potencjalnych klientów. Jeśli stosujesz śledzenie konwersji dla wielu kont, ta wartość jest dziedziczona z konta menedżera. To pole jest tylko do odczytu. |
googleAdsConversionCustomer |
Nazwa zasobu klienta, w którym są tworzone konwersje i zarządzanie nimi. To pole jest tylko do odczytu. |
conversionTrackingId |
Identyfikator śledzenia konwersji używany w przypadku tego konta. Ten identyfikator nie wskazuje, czy klient korzysta ze śledzenia konwersji (conversionTrackingStatus). To pole jest tylko do odczytu. |
googleAdsCrossAccountConversionTrackingId |
Identyfikator śledzenia konwersji menedżera klienta. Jest ona ustawiana, gdy klient ma włączone śledzenie konwersji. Zastępuje parametr conversionTrackingId. Tym polem można zarządzać tylko w interfejsie Google Ads. To pole jest tylko do odczytu. |
crossAccountConversionTrackingId |
Identyfikator śledzenia konwersji menedżera klienta. Jest ona ustawiana, gdy klient ma włączone śledzenie konwersji dla wielu kont. Zastępuje parametr conversionTrackingId. |
ConversionTrackingStatus
Stan śledzenia konwersji klienta.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używany tylko w przypadku zwracanej wartości. Reprezentuje wartość nieznaną w tej wersji. |
NOT_CONVERSION_TRACKED |
Klient nie korzysta ze śledzenia konwersji. |
CONVERSION_TRACKING_MANAGED_BY_SELF |
Ten klient tworzy działania powodujące konwersję i nimi zarządza. |
CONVERSION_TRACKING_MANAGED_BY_THIS_MANAGER |
Działaniami powodującymi konwersję może zarządzać menedżer wskazany w login-customer-id żądania. |
CONVERSION_TRACKING_MANAGED_BY_ANOTHER_MANAGER |
Działaniami powodującymi konwersję musi zarządzać menedżer inny niż klient lub menedżer wymieniony w login-customer-id żądania. |
AccountType
Możliwe typy kont wyszukiwarki.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używany tylko w przypadku zwracanej wartości. Reprezentuje wartość nieznaną w tej wersji. |
BAIDU |
Konto 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 |
koncie Microsoft Advertising. |
SEARCH_ADS_360 |
konto menedżera Search Ads 360. |
YAHOO_JAPAN |
Konto Yahoo Japan. |
DoubleClickCampaignManagerSetting
Ustawienie usługi DoubleClick Campaign Manager (DCM) w przypadku 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 Campaign Managera powiązanej z tym klientem. |
timeZone |
Strefa czasowa sieci Campaign Managera powiązanej z tym klientem w formacie bazy danych strefy czasowej IANA, np. Ameryka/Nowy_Jork. |
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 przez wewnętrzny proces. |
REMOVED |
Konto zostaje nieodwołalnie wyłączone. |
DRAFT |
Konto jest nadal w trakcie konfiguracji i nie jest jeszcze WŁĄCZONE. |
CustomerStatus
Możliwe stany klienta.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używany tylko w przypadku zwracanej wartości. 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. Może zostać ponownie aktywowany przez administratora. |
SUSPENDED |
Wskazuje, że zawieszone konto nie może wyświetlać reklam. Może zostać aktywowany tylko przez zespół pomocy Google. |
CLOSED |
Wskazuje, że nie można wyświetlać reklam na zamkniętym koncie. Konto testowe będzie też miało stan ZAMKNIĘTE. Stan jest stały i nie można go ponownie otworzyć. |
CustomerAsset
Związek między klientem a komponentem.
Zapis JSON |
---|
{
"resourceName": string,
"asset": string,
"status": enum ( |
Pola | |
---|---|
resourceName |
Nazwa zasobu komponentu klienta. Nazwy zasobów CustomerAsset mają następujący format:
|
asset |
Wymagane. Zasób, który jest połączony z klientem. |
status |
Stan komponentu klienta. |
CustomerAssetSet
CustomerAssetSet to połączenie między klientem a zbiorem komponentów. Dodanie CustomerAssetSet łączy zestaw komponentów z klientem.
Zapis JSON |
---|
{
"resourceName": string,
"assetSet": string,
"customer": string,
"status": enum ( |
Pola | |
---|---|
resourceName |
Nazwa zasobu zbioru zasobów klienta. Nazwy zasobów w zestawie zasobów mają taką postać:
|
assetSet |
Zbiór zasobów powiązany 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
Przedstawia widok strategii ustalania stawek należących do klienta i został mu udostępniony.
W przeciwieństwie do strategii ustalania stawek ten zasób zawiera strategie należące do menedżerów klienta, które zostały mu udostępnione, a także strategie należące do tego klienta. Ten zasób nie dostarcza danych i udostępnia tylko ograniczony podzbiór atrybutów strategii określania stawek.
Zapis JSON |
---|
{ "resourceName": string, "id": string, "name": string, "type": enum ( |
Pola | |
---|---|
resourceName |
Nazwa zasobu dostępnej strategii ustalania stawek. Nazwy zasobów AccessibleOkreślanie 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 |
opisowaNazwa klienta, który jest właścicielem strategii 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 pomaga uzyskać z kampanii jak najwięcej konwersji w ramach określonego budżetu. |
targetCpa |
Strategia ustalania stawek, która ustala stawki tak, by pomóc Ci uzyskać jak największą liczbę konwersji przy wybranym przez Ciebie docelowym koszcie pozyskania (CPA). |
targetImpressionShare |
Strategia ustalania stawek, która automatycznie optymalizuje kampanię pod kątem wybranego odsetka wyświetleń. |
targetRoas |
Strategia ustalania stawek, która pomaga zmaksymalizować przychody przy zachowaniu średniego docelowego zwrotu z nakładów na reklamę (ROAS). |
targetSpend |
Strategia ustalania stawek, która ustala stawki tak, by pomóc Ci uzyskać jak najwięcej kliknięć w ramach budżetu. |
MaximizeConversionValue
Strategia automatycznego określania stawek, która pomoże Ci uzyskać jak największą wartość konwersji dla Twoich kampanii w ramach określonego budżetu.
Zapis JSON |
---|
{ "targetRoas": number } |
Pola | |
---|---|
targetRoas |
Opcja docelowego zwrotu z nakładów na reklamę (ROAS). Jeśli jest ustawiony, strategia ustalania stawek maksymalizuje przychody, utrzymując średni docelowy zwrot z nakładów na reklamę. Jeśli docelowy ROAS jest wysoki, strategia może nie być w stanie wydać całego budżetu. Jeśli docelowy ROAS nie jest ustawiony, strategia ustalania stawek będzie dążyć do uzyskania najwyższego możliwego ROAS w ramach budżetu. |
MaximizeConversions
Strategia automatycznego określania stawek, która pomaga uzyskać z kampanii jak najwięcej konwersji w ramach określonego budżetu.
Zapis JSON |
---|
{ "targetCpa": string, "targetCpaMicros": string } |
Pola | |
---|---|
targetCpa |
Opcja docelowego kosztu pozyskania (CPA). Jest to średnia kwota, jaką chcesz wydać na pozyskanie. |
targetCpaMicros |
Opcja docelowego kosztu pozyskania (CPA). Jest to średnia kwota, jaką chcesz wydać na pozyskanie. |
TargetCpa
Strategia automatycznego określania stawek, która ustala stawki, by pomóc Ci uzyskać jak największą liczbę konwersji przy wybranym przez Ciebie docelowym koszcie pozyskania (CPA).
Zapis JSON |
---|
{ "targetCpaMicros": string } |
Pola | |
---|---|
targetCpaMicros |
Średni docelowy CPA. Ta wartość docelowa powinna być co najmniej równa minimalnej jednostce podlegającej rozliczeniu na podstawie waluty konta. |
TargetRoas
Strategia automatycznego określania stawek, która pomaga zmaksymalizować przychody przy zachowaniu średniego docelowego zwrotu 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, w ramach których należy zmaksymalizować liczbę kliknięć. Licytujący „Docelowy poziom wydatków” spróbuje wydać mniejszą z tych wartości lub będzie to kwota wynikająca z naturalnego ograniczenia wydatków. Jeśli go nie podasz, jako docelowe wydatki będzie używany budżet. To pole zostało wycofane i nie powinno być już używane. Szczegółowe informacje można znaleźć na stronie https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html. |
cpcBidCeilingMicros |
Limit maksymalnej stawki, który można ustawić w strategii ustalania stawek. Limit dotyczy wszystkich słów kluczowych, którymi zarządza strategia. |
CustomerManagerLink
Reprezentuje relację połączenia między klientem a menedżerem.
Zapis JSON |
---|
{
"resourceName": string,
"status": enum ( |
Pola | |
---|---|
resourceName |
Nazwa zasobu. Nazwy zasobów CustomerManagerLink mają następujący format: |
status |
Stan połączenia między klientem a menedżerem. |
managerCustomer |
Konto menedżera, które zostało połączone z klientem. |
managerLinkId |
Identyfikator połączenia z kontem menedżera klienta. To pole jest tylko do odczytu. |
startTime |
Sygnatura czasowa utworzenia połączenia z klientem. Sygnatura czasowa jest podana w strefie czasowej klienta i w formacie „rrrr-MM-dd HH:mm:ss”. . |
ManagerLinkStatus
Możliwe stany połączenia.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używany tylko w przypadku zwracanej wartości. Reprezentuje wartość nieznaną w tej wersji. |
ACTIVE |
Wskazuje bieżącą relację między wpływem |
INACTIVE |
Wskazuje przerwaną relację |
PENDING |
Wskazuje, że menedżer poprosił o powiązanie, ale klient jeszcze nie wyraził zgody. |
REFUSED |
Menedżer poprosił o utworzenie relacji, ale klient ją odrzucił. |
CANCELED |
Wskazuje, że menedżer poprosił o relację, ale menedżer ją anulował. |
CustomerClient
Połączenie między danym klientem i klientem. Klient CustomerClient występuje tylko w przypadku klientów menedżera. Uwzględniasz wszystkich klientów bezpośrednich i pośrednich, a także samego menedżera.
Zapis JSON |
---|
{
"resourceName": string,
"appliedLabels": [
string
],
"status": enum ( |
Pola | |
---|---|
resourceName |
Nazwa zasobu klienta klienta. Nazwy zasobów CustomerClient mają format: |
appliedLabels[] |
Nazwy zasobów etykiet należących do klienta wysyłającego żądanie, które zostały zastosowane do klienta. Nazwy zasobów etykiet mają format:
|
status |
Stan klienta klienta. Tylko do odczytu. |
clientCustomer |
Nazwa zasobu klient-klient, który jest powiązany z danym klientem. Tylko do odczytu. |
level |
Odstęp między danym klientem a klientem. W przypadku połączenia własnego wartość poziomu będzie wynosić 0. Tylko do odczytu. |
timeZone |
Reprezentacja strefy czasowej klienta w ciągu CLDR (Common Locale Data Repositories), na przykład America/Los_Angeles. Tylko do odczytu. |
testAccount |
Określa, czy klient jest kontem testowym. Tylko do odczytu. |
manager |
Określa, 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ł w dynamicznych reklamach w wyszukiwarce. Nazwy zasobó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
Płeć. Zasób genderView odzwierciedla efektywny stan wyświetlania, a nie tylko te kryteria, które zostały dodane. Grupa reklam bez kryteriów płci jest domyślnie wyświetlana dla wszystkich płci, więc wszystkie płcie są widoczne w widoku płci ze statystykami.
Zapis JSON |
---|
{ "resourceName": string } |
Pola | |
---|---|
resourceName |
Nazwa zasobu widoku płci. Nazwy zasobów w widoku płci mają następujący format:
|
GeoTargetConstant
Stała kierowania geograficznego.
Zapis JSON |
---|
{
"resourceName": string,
"status": enum ( |
Pola | |
---|---|
resourceName |
Nazwa zasobu stałej kierowania geograficznego. Nazwy stałych zasobów kierowania geograficznego mają postać:
|
status |
Stały stan kierowania geograficznego. |
id |
Identyfikator stałej kierowania geograficznego. |
name |
Stała angielska nazwa kierowania geograficznego. |
countryCode |
Kod kraju zgodny ze standardem ISO-3166-1 alfa-2, który jest powiązany z celem. |
targetType |
Typ stałego kierowania geograficznego. |
canonicalName |
Pełna i jednoznaczna nazwa angielska składająca się z nazwy celu, nazwy jednostki nadrzędnej oraz kraju. |
parentGeoTarget |
Nazwa zasobu nadrzędnej stałej kierowania geograficznego. Nazwy stałych zasobów kierowania geograficznego mają postać:
|
GeoTargetConstantStatus
Możliwe stany stałej kierowania geograficznego.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono żadnej wartości. |
UNKNOWN |
Otrzymana wartość nie jest znana w tej wersji. Ta wartość dotyczy tylko odpowiedzi. |
ENABLED |
Stała kierowania geograficznego jest prawidłowa. |
REMOVAL_PLANNED |
Stała 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ą format: |
status |
Stan etykiety. Tylko do odczytu. |
textLabel |
Typ etykiety wyświetlającej tekst 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 wynosić od 1 do 80 włącznie. |
LabelStatus
Możliwe stany etykiety.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używany tylko w przypadku zwracanej wartości. Reprezentuje wartość nieznaną w tej wersji. |
ENABLED |
Etykieta jest włączona. |
REMOVED |
Usunięto etykietę. |
TextLabel
Typ etykiety wyświetlającej tekst na kolorowym tle.
Zapis JSON |
---|
{ "backgroundColor": string, "description": string } |
Pola | |
---|---|
backgroundColor |
Kolor tła etykiety w formacie szesnastkowym. 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 nie być widoczny na kontach menedżera. |
description |
Krótki opis etykiety. Może mieć maksymalnie 200 znaków. |
LanguageConstant
Język.
Zapis JSON |
---|
{ "resourceName": string, "id": string, "code": string, "name": string, "targetable": boolean } |
Pola | |
---|---|
resourceName |
Nazwa zasobu stałej języka. Nazwy stałych zasobów językowych mają postać:
|
id |
Identyfikator stałej języka. |
code |
Kod języka, np. „pl_PL”, „en_AU”, „es”, „fr” itd. |
name |
Pełna nazwa języka w języku angielskim, np. „English (US)”, „hiszpański” itp. |
targetable |
Określa, czy język, na który można kierować reklamy, jest dostępny. |
LocationView
Widok lokalizacji zawiera podsumowanie skuteczności kampanii według kryterium Lokalizacja.
Zapis JSON |
---|
{ "resourceName": string } |
Pola | |
---|---|
resourceName |
Nazwa zasobu widoku lokalizacji. Nazwy zasobów widoku lokalizacji mają następujący format:
|
ProductBiddingCategoryConstant
Kategoria określania stawek produktu.
Zapis JSON |
---|
{ "resourceName": string, "level": enum ( |
Pola | |
---|---|
resourceName |
Nazwa zasobu kategorii określania stawek za produkt. Nazwy zasobów kategorii ustalania stawek według produktu mają następujący format:
|
level |
Poziom kategorii określania stawek za produkt. |
status |
Stan kategorii określania stawek produktu. |
id |
Identyfikator kategorii ustalania stawek produktu. Ten identyfikator jest odpowiednikiem identyfikatora google_product_category [kategoria_produktów_google], jak opisano w tym artykule: https://support.google.com/merchants/answer/6324436. |
countryCode |
Dwuliterowy kod kraju kategorii określania stawek według produktów, pisany wielkimi literami. |
productBiddingCategoryConstantParent |
Nazwa zasobu z nadrzędnej kategorii określania stawek produktu. |
languageCode |
Kod języka kategorii ustalania stawek produktu. |
localizedName |
Wyświetla wartość kategorii określania stawek za produkt zlokalizowaną według kodu języka. |
ProductBiddingCategoryLevel
Wyliczenie opisujące poziom kategorii określania stawek produktu.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używany tylko w przypadku zwracanej wartości. 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 określania stawek produktu.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używany tylko w przypadku zwracanej wartości. Reprezentuje wartość nieznaną w tej wersji. |
ACTIVE |
Kategoria jest aktywna i może służyć do określania stawek. |
OBSOLETE |
Ta kategoria jest nieaktualna. Używany tylko na potrzeby raportowania. |
ProductGroupView
Widok grupy produktów.
Zapis JSON |
---|
{ "resourceName": string } |
Pola | |
---|---|
resourceName |
Nazwa zasobu w widoku grupy produktów. Nazwy zasobów widoku grupy produktów mają taką postać:
|
ShoppingPerformanceView
Widok skuteczności w Zakupach Google. Przedstawia statystyki kampanii produktowych zebrane na kilku poziomach wymiarów produktów. Wartości wymiarów produktu z Merchant Center, takie jak marka, kategoria, atrybuty niestandardowe, stan produktu i typ produktu, będą odzwierciedlać stan każdego wymiaru w momencie zarejestrowania danego zdarzenia.
Zapis JSON |
---|
{ "resourceName": string } |
Pola | |
---|---|
resourceName |
Nazwa zasobu widoku skuteczności w Zakupach Google. Nazwy zasobów w widoku skuteczności w Zakupach Google 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 listy 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 parametru access_reason nazwa listy użytkowników może nie być niepowtarzalna (np. 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żywany tylko w przypadku zwracanej wartości. Reprezentuje wartość nieznaną w tej wersji. |
REMARKETING |
Lista użytkowników przedstawiona jako zbiór typów konwersji. |
LOGICAL |
Lista użytkowników przedstawiana jako połączenie innych list/zainteresowań użytkowników. |
EXTERNAL_REMARKETING |
Lista UserList została 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 na innej liście użytkowników. |
CRM_BASED |
Lista użytkowników zawierająca własne dane z systemu CRM dostarczone przez reklamodawcę w formie e-maili lub w innych formatach. |
WebpageView
Widok strony internetowej.
Zapis JSON |
---|
{ "resourceName": string } |
Pola | |
---|---|
resourceName |
Nazwa zasobu widoku strony internetowej. Nazwy zasobów wyświetlenia strony internetowej mają następujący format:
|
Odwiedź
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ą następujący format:
|
id |
Identyfikator wizyty. |
criterionId |
Identyfikator słowa kluczowego w Search Ads 360. Wartość 0 oznacza, że słowo kluczowe jest nieprzypisane. |
merchantId |
Identyfikator konta asortymentu Search Ads 360 zawierającego kliknięty produkt. Search Ads 360 generuje ten identyfikator po połączeniu w tej usłudze konta asortymentowego. |
adId |
Identyfikator reklamy. Wartość 0 oznacza, że reklama jest nieprzypisana. |
clickId |
Unikalny ciąg znaków przy każdej wizycie przekazywany na stronę docelową 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 HH:mm:ss”. . |
productId |
Identyfikator klikniętego produktu. |
productChannel |
Kanał sprzedaży klikniętego produktu: online lub lokalnie. |
productLanguageCode |
Język (ISO-639-1) ustawiony w pliku danych Merchant Center zawierającym dane o produkcie. |
productStoreId |
Sklep w reklamie lokalnego asortymentu produktów, który został kliknięty. Te informacje powinny być zgodne z identyfikatorami sklepów użytymi w pliku danych o produktach dostępnych lokalnie. |
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 zdarzenia wizyty. |
assetFieldType |
Typ pola zasobu zdarzenia wizyty. |
ProductChannel
Enum opisujący lokalizację, w której jest oferowany produkt.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używany tylko w przypadku zwracanej wartości. 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 jest nieprzypisane. |
merchantId |
Identyfikator konta asortymentu Search Ads 360 zawierającego kliknięty produkt. Search Ads 360 generuje ten identyfikator po połączeniu w tej usłudze konta asortymentowego. |
adId |
Identyfikator reklamy. Wartość 0 oznacza, że reklama jest nieprzypisana. |
clickId |
Unikalny ciąg znaków używany w przypadku wizyty, do której przypisana jest konwersja, przekazywany na stronę docelową jako parametr adresu URL identyfikatora kliknięcia. |
visitId |
Identyfikator wizyty w Search Ads 360, do którego przypisana jest konwersja. |
advertiserConversionId |
W przypadku konwersji offline jest to identyfikator podawany przez reklamodawców. Jeśli reklamodawca nie określi takiego identyfikatora, Search Ads 360 go wygeneruje. W przypadku konwersji online ta wartość jest równa kolumnie identyfikatora lub kolumnie floodlightOrderId w zależności od instrukcji Floodlight reklamodawcy. |
productId |
Identyfikator klikniętego produktu. |
productChannel |
Kanał sprzedaży klikniętego produktu: online lub lokalnie. |
productLanguageCode |
Język (ISO-639-1) ustawiony w pliku danych Merchant Center zawierającym dane o produkcie. |
productStoreId |
Sklep w reklamie lokalnego asortymentu produktów, który został kliknięty. Te informacje powinny być zgodne z identyfikatorami sklepów użytymi w pliku danych o produktach dostępnych lokalnie. |
productCountryCode |
Kraj (format ISO-3166) zarejestrowany w pliku danych o asortymencie zawierającym kliknięty produkt. |
attributionType |
Do czego jest przypisana 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 została przypisana konwersja. |
conversionQuantity |
Liczba produktów zarejestrowanych w konwersji, określona przez parametr qty url. Reklamodawca jest odpowiedzialny za dynamiczne wprowadzanie parametru (np. liczby produktów sprzedanych w ramach konwersji). W przeciwnym razie domyślna wartość to 1. |
conversionRevenueMicros |
Skorygowane przychody w mikrosekundach ze zdarzenia konwersji. Zawsze będzie ona w walucie konta wyświetlającego reklamy. |
floodlightOriginalRevenue |
Pierwotne, niezmienione przychody powiązane ze zdarzeniem Floodlight (w walucie bieżącego raportu) sprzed modyfikacji instrukcji dotyczących 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 komponentu zdarzenia konwersji. |
AttributionType
Typ atrybucji konwersji w Search Ads 360
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używany tylko w przypadku zwracanej wartości. Reprezentuje wartość nieznaną w tej wersji. |
VISIT |
Konwersja zostaje przypisana do wizyty. |
CRITERION_AD |
Konwersja jest przypisywana do kryterium i reklamy. |
ConversionStatus
Możliwe stany konwersji.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używany tylko w przypadku zwracanej wartości. Reprezentuje wartość nieznaną w tej wersji. |
ENABLED |
Konwersja jest włączona. |
REMOVED |
Konwersja została usunięta. |
Dane
Dane.
Zapis JSON |
---|
{ "allConversionsValueByConversionDate": number, "allConversionsByConversionDate": number, "conversionCustomMetrics": [ { object ( |
Pola | |
---|---|
allConversionsValueByConversionDate |
Wartość wszystkich konwersji. Jeśli wybierzesz tę kolumnę wraz z datą, wartości w kolumnie „data” będą oznaczać datę konwersji. Szczegółowe informacje o kolumnach by_conversion_date znajdziesz na stronie https://support.google.com/sa360/answer/9250611. |
allConversionsByConversionDate |
Łączna liczba konwersji. Obejmuje to wszystkie konwersje niezależnie od wartości includeInConversionsMetric. Jeśli wybierzesz tę kolumnę wraz z datą, wartości w kolumnie „data” będą oznaczać datę konwersji. Szczegółowe informacje o kolumnach by_conversion_date znajdziesz na stronie 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ę wraz 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. Może być ułamkowa ze względu na modelowanie atrybucji. Jeśli wybierzesz tę kolumnę wraz 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 współczynnik klikalności (CTR) w sieci wyszukiwania. |
interactionEventTypes[] |
Rodzaje płatnych i bezpłatnych interakcji. |
rawEventConversionMetrics[] |
Nieprzetworzone dane konwersji zdarzeń. |
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 |
Liczba wszystkich konwersji z interakcji (przeciwieństwem do konwersji po wyświetleniu) podzielona przez liczbę interakcji z reklamą. |
allConversionsValue |
Wartość wszystkich konwersji. |
allConversions |
Łączna liczba konwersji. Obejmuje to wszystkie konwersje niezależnie od wartości includeInConversionsMetric. |
allConversionsValuePerCost |
Wartość wszystkich konwersji podzielona przez łączny koszt interakcji z reklamą (np. kliknięć reklam tekstowych lub wyświetleń reklam wideo). |
allConversionsFromClickToCall |
Tyle razy użytkownicy kliknęli „Zadzwoń” aby zadzwonić do sklepu w trakcie lub po kliknięciu reklamy. Numer ten nie zawiera informacji o tym, czy połączenie zostało odebrane ani ile trwało. Te dane mają zastosowanie tylko do elementów kanału. |
allConversionsFromDirections |
Tyle razy użytkownicy kliknęli link „Wyznacz trasę” , który po kliknięciu reklamy prowadzi do sklepu. Te dane mają zastosowanie tylko do elementów kanału. |
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 mają zastosowanie tylko do elementów kanału. |
allConversionsFromOrder |
Tyle razy użytkownicy złożyli zamówienie w sklepie po kliknięciu reklamy. Te dane mają zastosowanie tylko do elementów kanału. |
allConversionsFromOtherEngagement |
Tyle razy użytkownicy zrealizowali inną konwersję (np. opublikowali opinię albo zapisali lokalizację sklepu) po kliknięciu reklamy. Te dane mają zastosowanie tylko do elementów kanału. |
allConversionsFromStoreVisit |
Szacunkowa liczba wizyt użytkowników w sklepie po kliknięciu reklamy. Te dane mają zastosowanie tylko do elementów kanału. |
visits |
Kliknięcia zarejestrowane przez Search Ads 360 i przekierowane do strony docelowej reklamodawcy. |
allConversionsFromStoreWebsite |
Tyle razy użytkownicy zostali przeniesieni na stronę sklepu po kliknięciu reklamy. Te dane mają zastosowanie tylko do elementów kanału. |
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ęć. Jest to wartość pieniężna, która jest domyślnie zwracana w walucie klienta. Znajdziesz go na stronie https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause. |
averageCpm |
Średni koszt tysiąca wyświetleń (CPM). Jest to wartość pieniężna, która jest domyślnie zwracana w walucie klienta. Znajdziesz go na stronie https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause. |
clicks |
Liczba kliknięć. |
contentBudgetLostImpressionShare |
Szacowany odsetek przypadków, gdy reklama kwalifikowała się do wyświetlenia w sieci reklamowej, ale tak się nie stało z powodu zbyt niskiego budżetu. Uwaga: utracony udział w wyświetleniach z budżetu w sieci reklamowej mieści się w zakresie od 0 do 0,9. Każda wartość większa niż 0,9 jest raportowana 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 podawany w zakresie od 0,1 do 1. Każda wartość mniejsza niż 0,1 jest raportowana jako 0,0999. |
contentRankLostImpressionShare |
Szacowany odsetek wyświetleń w sieci reklamowej, których Twoje reklamy nie uzyskały z powodu niskiego rankingu reklamy. Uwaga: utracony udział w wyświetleniach w rankingu treści jest podawany w zakresie od 0 do 0,9. Każda wartość większa niż 0,9 jest raportowana jako 0,9001. |
conversionsFromInteractionsRate |
Średnia liczba konwersji z możliwością określenia stawki (z interakcji) na kwalifikującą się interakcję na podstawie 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ę, dla których atrybut includeInClientAccountConversionsMetric ma wartość „true”. 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 kwalifikujących się do konwersji. |
conversionsFromInteractionsValuePerInteraction |
Wartość konwersji z interakcji podzielona przez liczbę interakcji z reklamą. Dotyczy to tylko działań powodujących konwersję, dla których atrybut includeInKonwersjeMetric ma wartość „true”. 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ę, dla których atrybut includeInClientAccountConversionsMetric ma wartość „true”. 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 kosztów tysiąca wyświetleń (CPM) poniesionych w tym okresie. Jest to wartość pieniężna, która jest domyślnie zwracana w walucie klienta. Znajdziesz go na stronie https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause. |
costPerAllConversions |
Koszt interakcji z reklamą podzielony przez łączną liczbę konwersji. |
costPerConversion |
Średni koszt kwalifikujących się konwersji z możliwością określenia stawki. |
costPerCurrentModelAttributedConversion |
Koszt interakcji z reklamą podzielony przez konwersje przypisane do bieżącego modelu. Dotyczy to tylko działań powodujących konwersję, dla których atrybut includeInKonwersjeMetric ma wartość „true”. 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 kliknął 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 we wszystkich konwersjach. |
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ę, dla których atrybut includeInKonwersjeMetric ma wartość „true”. 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 kolumnie „Konwersje” . Te dane są przydatne tylko w przypadku, gdy wpiszesz wartość działań powodujących konwersję. |
averageQualityScore |
Średni wynik jakości. |
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 wchodzą w interakcję z reklamą po jej wyświetleniu. Jest to liczba interakcji podzielona przez liczbę wyświetleń reklamy. |
interactions |
Liczba interakcji. Interakcja to główne działanie użytkownika związane z formatem reklamy, np. kliknięcia reklam tekstowych i produktowych, obejrzenia reklam wideo itd. |
invalidClickRate |
Odsetek odfiltrowanych kliknięć spośród całkowitej liczby kliknięć (odfiltrowane i nieodfiltrowane) 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ń reklam produktowych lub reklam w wyszukiwarce na najbardziej widocznej pozycji na potrzeby Zakupów. Szczegółowe informacje znajdziesz na stronie https://support.google.com/sa360/answer/9566729. Każda wartość mniejsza niż 0,1 jest raportowana jako 0,0999. |
searchBudgetLostAbsoluteTopImpressionShare |
Liczba określająca, jak często reklama nie była pierwszą reklamą u góry strony wyników wyszukiwania z powodu niskiego budżetu. Uwaga: raport o utraconym udziale w wyświetleniach na najwyższej pozycji na stronie z budżetu w sieci wyszukiwania mieści się w zakresie od 0 do 0,9. Każda wartość większa niż 0,9 jest raportowana jako 0,9001. |
searchBudgetLostImpressionShare |
Szacowany odsetek przypadków, gdy reklama kwalifikowała się do wyświetlenia w sieci wyszukiwania, ale tak się nie stało z powodu zbyt niskiego budżetu. Uwaga: utrata udziału w wyświetleniach z budżetu w sieci wyszukiwania należy do zakresu od 0 do 0,9. Każda wartość większa niż 0,9 jest raportowana jako 0,9001. |
searchBudgetLostTopImpressionShare |
Liczba określająca, jak często reklama nie wyświetliła się obok bezpłatnych wyników wyszukiwania z powodu niskiego budżetu. Uwaga: raport o utraconym udziale w wyświetleniach u góry strony z budżetu w sieci wyszukiwania należy do zakresu od 0 do 0,9. Każda wartość większa niż 0,9 jest raportowana 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 podawany w zakresie od 0,1 do 1. Każda wartość mniejsza niż 0,1 jest raportowana jako 0,0999. |
searchExactMatchImpressionShare |
Liczba uzyskanych wyświetleń podzielona przez szacunkową liczbę wyświetleń możliwych do uzyskania w sieci wyszukiwania dla wyszukiwanych słów, które dokładnie pasowały do słów kluczowych (lub były ich zbliżonymi odmianami), niezależnie od typu dopasowania słów kluczowych. Uwaga: udział w wyświetleniach przy dopasowaniu ścisłym z sieci wyszukiwania jest podawany w zakresie od 0,1 do 1. Każda wartość mniejsza niż 0,1 jest raportowana jako 0,0999. |
searchImpressionShare |
Liczba wyświetleń otrzymanych w sieci wyszukiwania podzielona przez szacunkową liczbę wyświetleń, które można było uzyskać. Uwaga: udział w wyświetleniach z sieci wyszukiwania jest podawany w zakresie od 0,1 do 1. Każda wartość mniejsza niż 0,1 jest raportowana jako 0,0999. |
searchRankLostAbsoluteTopImpressionShare |
Liczba określająca, jak często reklama nie była pierwszą reklamą na górze wyników wyszukiwania z powodu niskiego rankingu reklamy. Uwaga: utracony udział w wyświetleniach na najwyższej pozycji na stronie z rankingu w sieci wyszukiwania jest podawany w zakresie od 0 do 0,9. Każda wartość większa niż 0,9 jest raportowana jako 0,9001. |
searchRankLostImpressionShare |
Szacowany odsetek wyświetleń w sieci wyszukiwania, których Twoje reklamy nie uzyskały z powodu niskiego rankingu reklamy. Uwaga: utrata udziału w wyświetleniach w rankingu w sieci wyszukiwania należy do zakresu od 0 do 0,9. Każda wartość większa niż 0,9 jest raportowana jako 0,9001. |
searchRankLostTopImpressionShare |
Liczba określająca, jak często reklama nie wyświetliła się obok bezpłatnych wyników wyszukiwania z powodu niskiego rankingu reklamy. Uwaga: utrata udziału w wyświetleniach u góry strony w rankingu w sieci wyszukiwania należy do zakresu od 0,9 do 0,9. Każda wartość większa niż 0,9 jest raportowana jako 0,9001. |
searchTopImpressionShare |
Liczba wyświetleń reklam u góry strony w porównaniu z szacunkową liczbą możliwych wyświetleń u góry strony. Uwaga: udział w wyświetleniach u góry strony z sieci wyszukiwania jest podawany w zakresie od 0,1 do 1. Każda wartość mniejsza niż 0,1 jest raportowana 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ń reklamy obok bezpłatnych wyników wyszukiwania u góry strony. |
valuePerAllConversions |
Wartość wszystkich konwersji podzielona przez liczbę wszystkich konwersji. |
valuePerAllConversionsByConversionDate |
Wartość wszystkich konwersji podzielona przez liczbę wszystkich konwersji. Jeśli wybierzesz tę kolumnę wraz z datą, wartości w kolumnie „data” będą oznaczać datę konwersji. Szczegółowe informacje o kolumnach by_conversion_date znajdziesz na stronie https://support.google.com/sa360/answer/9250611. |
valuePerConversion |
Wartość konwersji z możliwością określenia stawki podzielona przez liczbę konwersji z możliwością określenia stawki. Pokazuje ś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 i datę konwersji. Pokazuje średnią wartość każdej konwersji z możliwością określenia stawki (według daty konwersji). Jeśli wybierzesz tę kolumnę wraz 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 później dokonuje konwersji w Twojej witrynie bez wchodzenia w interakcję z inną reklamą (np. przez kliknięcie). |
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: rejestrujesz konwersje z danymi koszyka w przypadku zrealizowanych zakupów na swojej stronie. 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. Jest to wartość pieniężna, która jest domyślnie zwracana w walucie klienta. Znajdziesz go na stronie 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: rejestrujesz konwersje z danymi koszyka w przypadku zrealizowanych zakupów na swojej stronie. 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. Jest to wartość pieniężna, która jest domyślnie zwracana w walucie klienta. Znajdziesz go na stronie 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 reklamom innego produktu i pomniejszony o koszt własny sprzedaży. Jak to działa: rejestrujesz konwersje z danymi koszyka w przypadku zrealizowanych zakupów na swojej stronie. 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. Jest to wartość pieniężna, która jest domyślnie zwracana w walucie klienta. Znajdziesz go na stronie 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: rejestrujesz konwersje z danymi koszyka w przypadku zrealizowanych zakupów na swojej stronie. 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. Jest to wartość pieniężna, która jest domyślnie zwracana w walucie klienta. Znajdziesz go na stronie 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 innego produktu. Jak to działa: rejestrujesz konwersje z danymi koszyka w przypadku zrealizowanych zakupów na swojej stronie. 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. Jest to wartość pieniężna, która jest domyślnie zwracana w walucie klienta. Znajdziesz go na stronie 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: rejestrujesz konwersje z danymi koszyka w przypadku zrealizowanych zakupów na swojej stronie. 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. Jest to wartość pieniężna, która jest domyślnie zwracana w walucie klienta. Znajdziesz go na stronie 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: rejestrujesz konwersje z danymi koszyka w przypadku zrealizowanych zakupów na swojej stronie. 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: rejestrujesz konwersje z danymi koszyka w przypadku zrealizowanych zakupów na swojej stronie. 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: rejestrujesz konwersje z danymi koszyka w przypadku zrealizowanych zakupów na swojej stronie. 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. Jest to wartość pieniężna, która jest domyślnie zwracana w walucie klienta. Znajdziesz go na stronie 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: rejestrujesz konwersje z danymi koszyka w przypadku zrealizowanych zakupów na swojej stronie. 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. Jest to wartość pieniężna, która jest domyślnie zwracana w walucie klienta. Znajdziesz go na stronie 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: rejestrujesz konwersje z danymi koszyka w przypadku zrealizowanych zakupów na swojej stronie. 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. Jest to wartość pieniężna, która jest domyślnie zwracana w walucie klienta. Znajdziesz go na stronie 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: rejestrujesz konwersje z danymi koszyka w przypadku zrealizowanych zakupów na swojej stronie. 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. Jest to wartość pieniężna, która jest domyślnie zwracana w walucie klienta. Znajdziesz go na stronie https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause. |
clientAccountLeadRevenueMicros |
Potencjalne przychody z konta klienta to łączna kwota uzyskana ze sprzedaży produktów dzięki reklamom tych produktów. Jak to działa: rejestrujesz konwersje z danymi koszyka w przypadku zrealizowanych zakupów na swojej stronie. 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. Jest to wartość pieniężna, która jest domyślnie zwracana w walucie klienta. Znajdziesz go na stronie 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: rejestrujesz konwersje z danymi koszyka w przypadku zrealizowanych zakupów na swojej stronie. 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. Jest to wartość pieniężna, która jest domyślnie zwracana w walucie klienta. Znajdziesz go na stronie 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: rejestrujesz konwersje z danymi koszyka w przypadku zrealizowanych zakupów na swojej stronie. 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: rejestrujesz konwersje z danymi koszyka w przypadku zrealizowanych zakupów na swojej stronie. 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 mieć tylko jedną z tych wartości: |
|
booleanValue |
Wartość logiczna. |
int64Value |
Int64. |
floatValue |
Płytka. |
doubleValue |
Podwójna szansa. |
stringValue |
Ciąg znaków. |
QualityScoreBucket
Wyliczenie listy możliwych zasobników wyniku jakości.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używany tylko w przypadku zwracanej wartości. Reprezentuje wartość nieznaną w tej wersji. |
BELOW_AVERAGE |
Jakość kreacji jest poniżej średniej. |
AVERAGE |
Jakość kreacji jest średnia. |
ABOVE_AVERAGE |
Jakość kreacji jest powyżej średniej. |
InteractionEventType
Wyliczenie opisujące możliwe rodzaje płatnych i bezpłatnych interakcji.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używany tylko w przypadku zwracanej wartości. Reprezentuje wartość nieznaną w tej wersji. |
CLICK |
Kliknij, aby przejść do witryny. W większości przypadków ta interakcja prowadzi do zewnętrznej lokalizacji, zazwyczaj na stronę docelową reklamodawcy. Jest to też domyślna wartość InteractionEventType w przypadku zdarzeń kliknięcia. |
ENGAGEMENT |
Wyrazisty zamiar użytkownika wejścia w interakcję z reklamą w danym miejscu. |
VIDEO_VIEW |
Użytkownik obejrzał reklamę wideo. |
NONE |
Domyślna wartość InteractionEventType w przypadku zdarzeń konwersji z reklam. Używany, gdy wiersz konwersji reklamy NIE wskazuje, że bezpłatne interakcje (np. konwersje z reklamy) powinny być promowane i raportowane jako część podstawowych danych. Są to po prostu inne konwersje (z reklam). |
Segmenty
Tylko pola segmentów.
Zapis JSON |
---|
{ "adNetworkType": enum ( |
Pola | |
---|---|
adNetworkType |
Typ sieci reklamowej. |
conversionActionCategory |
Kategoria działania powodującego konwersję. |
conversionCustomDimensions[] |
Wymiary niestandardowe konwersji. |
dayOfWeek |
Dzień tygodnia, np. MONDAY. |
device |
Urządzenie, do którego mają zastosowanie dane. |
keyword |
Kryterium słowa kluczowego. |
productChannel |
Kanał produktu. |
productChannelExclusivity |
Wyłączność kanału produktu. |
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. |
geoTargetCity |
Nazwa zasobu ze stałą kierowania geograficznego, która reprezentuje miasto. |
geoTargetCountry |
Nazwa zasobu stałej kierowania geograficznego, która reprezentuje kraj. |
geoTargetMetro |
Nazwa zasobu ze stałą kierowania geograficznego, która reprezentuje obszar miejski. |
geoTargetRegion |
Nazwa zasobu stałej kierowania geograficznego, która reprezentuje region. |
hour |
Pora dnia jako liczba od 0 do 23 włącznie. |
month |
Miesiąc przedstawiony jako dzień pierwszego dnia miesiąca. W formacie 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 dla języka produktu. |
productSoldBiddingCategoryLevel1 |
Kategoria ustalania stawek (poziom 1) sprzedanego produktu. |
productSoldBiddingCategoryLevel2 |
Kategoria ustalania stawek (poziom 2) sprzedanego produktu. |
productSoldBiddingCategoryLevel3 |
Kategoria ustalania stawek (poziom 3) sprzedanego produktu. |
productSoldBiddingCategoryLevel4 |
Kategoria ustalania stawek (poziom 4) sprzedanego produktu. |
productSoldBiddingCategoryLevel5 |
Kategoria ustalania stawek (poziom 5) sprzedanego produktu. |
productSoldBrand |
Marka sprzedawanego produktu. |
productSoldCustomAttribute0 |
Atrybut niestandardowy 0 sprzedanego produktu. |
productSoldCustomAttribute1 |
Atrybut niestandardowy 1 sprzedanego produktu. |
productSoldCustomAttribute2 |
Atrybut niestandardowy 2 sprzedanego produktu. |
productSoldCustomAttribute3 |
Atrybut niestandardowy 3 sprzedanego produktu. |
productSoldCustomAttribute4 |
Atrybut niestandardowy 4 sprzedanego produktu. |
productSoldItemId |
Identyfikator sprzedanego produktu. |
productSoldTitle |
Tytuł sprzedanego 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) sprzedanego produktu. |
productStoreId |
Identyfikator sklepu produktu. |
productTitle |
Tytuł 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ł oznaczany datą pierwszego dnia kwartału. Używany jest rok kalendarzowy dla kwartałów, np. drugi kwartał 2018 roku rozpoczyna się 1 kwietnia 2018 r. W formacie rrrr-MM-dd. |
week |
Tydzień zgodnie z definicją od poniedziałku do niedzieli, oznaczony datą z poniedziałku. W formacie rrrr-MM-dd. |
year |
Rok w formacie rrrr. |
assetInteractionTarget |
Używany tylko w przypadku danych CustomerAsset, CampaignAsset i AdGroupAsset. Wskazuje, czy dane o interakcji wystąpiły w samym komponencie czy w innym komponencie lub jednostce reklamowej. Interakcje (np. kliknięcia) są zliczane w przypadku wszystkich części wyświetlonej reklamy (np. samej reklamy i innych komponentów, takich jak linki do podstron), gdy są wyświetlane razem. Jeśli interakcjaOnThisAsset ma wartość true (prawda), oznacza to, że interakcje są związane z tym konkretnym zasobem, a kiedy interakcjaOnThisAsset ma wartość false (fałsz), oznacza to, że interakcje nie dotyczą tego konkretnego zasobu, ale innych części wyświetlonej reklamy, z którym ten komponent jest wyświetlany. |
AdNetworkType
Wyświetla 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 wyszukiwania. |
CONTENT |
dla sieci reklamowej |
YOUTUBE_SEARCH |
Wyszukiwarka w YouTube. |
YOUTUBE_WATCH |
Filmy w YouTube |
MIXED |
Wszystkie sieci. |
Słowo kluczowe
Segment kryterium słowa kluczowego.
Zapis JSON |
---|
{
"info": {
object ( |
Pola | |
---|---|
info |
Informacje o słowie kluczowym. |
adGroupCriterion |
Nazwa zasobu AdGroupCriterion. |
ProductChannelExclusivity
Wyliczenie opisujące dostępność oferty produktu.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używany tylko w przypadku zwracanej wartości. Reprezentuje wartość nieznaną w tej wersji. |
SINGLE_CHANNEL |
Produkt jest sprzedawany tylko w jednym kanale – w lokalnych sklepach lub online – zgodnie z informacją o kanale produktu. |
MULTI_CHANNEL |
Produkt jest dopasowywany do odpowiedniego sklepu internetowego lub lokalnego, co oznacza, że jest dostępny do zakupu w obu kanałach ShoppingProductChannels. |
ProductCondition
Enum opisujący stan oferty produktu.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Używany tylko w przypadku zwracanej wartości. Reprezentuje wartość nieznaną w tej wersji. |
OLD |
Produkt jest ze starym stanem. |
NEW |
Produkt jest nowy. |
REFURBISHED |
Produkt jest odnowiony. |
USED |
Używany jest stan produktu. |
AssetInteractionTarget
Segment AssetInteractionTarget.
Zapis JSON |
---|
{ "asset": string, "interactionOnThisAsset": boolean } |
Pola | |
---|---|
asset |
Nazwa zasobu zasobu. |
interactionOnThisAsset |
Używany tylko w przypadku danych CustomerAsset, CampaignAsset i AdGroupAsset. Wskazuje, czy dane o interakcji wystąpiły w samym komponencie czy w innym komponencie lub jednostce reklamowej. |