SearchAds360Row

Wiersz zwrócony z zapytania.

Zapis JSON
{
  "adGroup": {
    object (AdGroup)
  },
  "adGroupAd": {
    object (AdGroupAd)
  },
  "adGroupAdLabel": {
    object (AdGroupAdLabel)
  },
  "adGroupAsset": {
    object (AdGroupAsset)
  },
  "adGroupAssetSet": {
    object (AdGroupAssetSet)
  },
  "adGroupAudienceView": {
    object (AdGroupAudienceView)
  },
  "adGroupBidModifier": {
    object (AdGroupBidModifier)
  },
  "adGroupCriterion": {
    object (AdGroupCriterion)
  },
  "adGroupCriterionLabel": {
    object (AdGroupCriterionLabel)
  },
  "adGroupLabel": {
    object (AdGroupLabel)
  },
  "ageRangeView": {
    object (AgeRangeView)
  },
  "asset": {
    object (Asset)
  },
  "assetGroupAsset": {
    object (AssetGroupAsset)
  },
  "assetGroupSignal": {
    object (AssetGroupSignal)
  },
  "assetGroupListingGroupFilter": {
    object (AssetGroupListingGroupFilter)
  },
  "assetGroupTopCombinationView": {
    object (AssetGroupTopCombinationView)
  },
  "assetGroup": {
    object (AssetGroup)
  },
  "assetSetAsset": {
    object (AssetSetAsset)
  },
  "assetSet": {
    object (AssetSet)
  },
  "biddingStrategy": {
    object (BiddingStrategy)
  },
  "campaignBudget": {
    object (CampaignBudget)
  },
  "campaign": {
    object (Campaign)
  },
  "campaignAsset": {
    object (CampaignAsset)
  },
  "campaignAssetSet": {
    object (CampaignAssetSet)
  },
  "campaignAudienceView": {
    object (CampaignAudienceView)
  },
  "campaignCriterion": {
    object (CampaignCriterion)
  },
  "campaignLabel": {
    object (CampaignLabel)
  },
  "cartDataSalesView": {
    object (CartDataSalesView)
  },
  "audience": {
    object (Audience)
  },
  "conversionAction": {
    object (ConversionAction)
  },
  "conversionCustomVariable": {
    object (ConversionCustomVariable)
  },
  "customer": {
    object (Customer)
  },
  "customerAsset": {
    object (CustomerAsset)
  },
  "customerAssetSet": {
    object (CustomerAssetSet)
  },
  "accessibleBiddingStrategy": {
    object (AccessibleBiddingStrategy)
  },
  "customerManagerLink": {
    object (CustomerManagerLink)
  },
  "customerClient": {
    object (CustomerClient)
  },
  "dynamicSearchAdsSearchTermView": {
    object (DynamicSearchAdsSearchTermView)
  },
  "genderView": {
    object (GenderView)
  },
  "geoTargetConstant": {
    object (GeoTargetConstant)
  },
  "keywordView": {
    object (KeywordView)
  },
  "label": {
    object (Label)
  },
  "languageConstant": {
    object (LanguageConstant)
  },
  "locationView": {
    object (LocationView)
  },
  "productBiddingCategoryConstant": {
    object (ProductBiddingCategoryConstant)
  },
  "productGroupView": {
    object (ProductGroupView)
  },
  "shoppingPerformanceView": {
    object (ShoppingPerformanceView)
  },
  "userList": {
    object (UserList)
  },
  "webpageView": {
    object (WebpageView)
  },
  "visit": {
    object (Visit)
  },
  "conversion": {
    object (Conversion)
  },
  "metrics": {
    object (Metrics)
  },
  "segments": {
    object (Segments)
  },
  "customColumns": [
    {
      object (Value)
    }
  ]
}
Pola
adGroup

object (AdGroup)

Grupa reklam, do której odnosi się zapytanie.

adGroupAd

object (AdGroupAd)

Reklama, do której odwołuje się zapytanie.

adGroupAdLabel

object (AdGroupAdLabel)

Etykieta reklamy grupy reklam, do której odwołuje się zapytanie.

adGroupAsset

object (AdGroupAsset)

Komponent grupy reklam, do którego odwołuje się zapytanie.

adGroupAssetSet

object (AdGroupAssetSet)

Zestaw komponentów grupy reklam, do którego odwołuje się zapytanie.

adGroupAudienceView

object (AdGroupAudienceView)

Widok odbiorców grupy reklam, do którego odwołuje się zapytanie.

adGroupBidModifier

object (AdGroupBidModifier)

Modyfikator stawek, do którego odwołuje się zapytanie.

adGroupCriterion

object (AdGroupCriterion)

Kryterium, do którego odwołuje się zapytanie.

adGroupCriterionLabel

object (AdGroupCriterionLabel)

Etykieta kryterium w grupie reklam, do której odwołuje się zapytanie.

adGroupLabel

object (AdGroupLabel)

Etykieta grupy reklam, do której odwołuje się zapytanie.

ageRangeView

object (AgeRangeView)

Widok przedziału wiekowego, do którego odwołuje się zapytanie.

asset

object (Asset)

Zasób, do którego odwołuje się zapytanie.

assetGroupAsset

object (AssetGroupAsset)

Zasób grupy plików, do którego odwołuje się zapytanie.

assetGroupSignal

object (AssetGroupSignal)

Sygnał grupy plików, do którego odwołuje się zapytanie.

assetGroupListingGroupFilter

object (AssetGroupListingGroupFilter)

Filtr grup informacji o produktach w grupie plików, do którego odwołuje się zapytanie.

assetGroupTopCombinationView

object (AssetGroupTopCombinationView)

Widok kombinacji u góry grupy plików, do którego odwołuje się zapytanie.

assetGroup

object (AssetGroup)

Grupa plików, do której odwołuje się zapytanie.

assetSetAsset

object (AssetSetAsset)

Zasób zestawu zasobów, do którego odwołuje się zapytanie.

assetSet

object (AssetSet)

Zbiór zasobów, do którego odwołuje się zapytanie.

biddingStrategy

object (BiddingStrategy)

Strategia ustalania stawek, o której mowa w zapytaniu.

campaignBudget

object (CampaignBudget)

Budżet kampanii, do którego odwołuje się zapytanie.

campaign

object (Campaign)

Kampania, do której odnosi się zapytanie.

campaignAsset

object (CampaignAsset)

Komponent kampanii, do którego odwołuje się zapytanie.

campaignAssetSet

object (CampaignAssetSet)

Zbiór zasobów kampanii, do którego odwołuje się zapytanie.

campaignAudienceView

object (CampaignAudienceView)

Widok odbiorców na poziomie kampanii, do którego odwołuje się zapytanie.

campaignCriterion

object (CampaignCriterion)

Kryterium kampanii, do którego odwołuje się zapytanie.

campaignLabel

object (CampaignLabel)

Etykieta kampanii, do której odwołuje się zapytanie.

cartDataSalesView

object (CartDataSalesView)

Widok sprzedaży danych koszyka, do którego odwołuje się zapytanie.

audience

object (Audience)

Lista odbiorców, do której odwołuje się zapytanie.

conversionAction

object (ConversionAction)

Działanie powodujące konwersję, do którego odwołuje się zapytanie.

conversionCustomVariable

object (ConversionCustomVariable)

Zmienna niestandardowa konwersji, do której odwołuje się zapytanie.

customer

object (Customer)

Klient wskazany w zapytaniu.

customerAsset

object (CustomerAsset)

Komponent klienta, do którego odwołuje się zapytanie.

customerAssetSet

object (CustomerAssetSet)

Zbiór zasobów klienta, do którego odwołuje się zapytanie.

accessibleBiddingStrategy

object (AccessibleBiddingStrategy)

Dostępna strategia ustalania stawek, do której odwołuje się zapytanie.

customerClient

object (CustomerClient)

Klient CustomerClient, do którego odwołuje się zapytanie.

dynamicSearchAdsSearchTermView

object (DynamicSearchAdsSearchTermView)

Widok wyszukiwanych haseł dynamicznych reklam w wyszukiwarce, do którego odwołuje się zapytanie

genderView

object (GenderView)

Widok płci, do którego odwołuje się zapytanie.

geoTargetConstant

object (GeoTargetConstant)

Stała kierowania geograficznego, do której odwołuje się zapytanie.

keywordView

object (KeywordView)

Widok słów kluczowych, do którego odwołuje się zapytanie.

label

object (Label)

Etykieta, do której odwołuje się zapytanie.

languageConstant

object (LanguageConstant)

Stała języka, do której odwołuje się zapytanie.

locationView

object (LocationView)

Widok lokalizacji, do którego odwołuje się zapytanie.

productBiddingCategoryConstant

object (ProductBiddingCategoryConstant)

Kategoria ustalania stawek produktu, do której odwołuje się zapytanie.

productGroupView

object (ProductGroupView)

Widok grupy produktów, do którego odwołuje się zapytanie.

shoppingPerformanceView

object (ShoppingPerformanceView)

Widok skuteczności reklam produktowych, do którego odwołuje się zapytanie.

userList

object (UserList)

Lista użytkowników, do których odwołuje się zapytanie.

webpageView

object (WebpageView)

Widok strony internetowej, do którego odwołuje się zapytanie.

visit

object (Visit)

Wizyta na poziomie zdarzenia, do której odwołuje się zapytanie.

conversion

object (Conversion)

Konwersja na poziomie zdarzenia, do której odwołuje się zapytanie.

metrics

object (Metrics)

Dane.

segments

object (Segments)

Segmenty.

customColumns[]

object (Value)

Kolumny niestandardowe.

Grupa reklam

Grupa reklam.

Zapis JSON
{
  "resourceName": string,
  "status": enum (AdGroupStatus),
  "type": enum (AdGroupType),
  "adRotationMode": enum (AdGroupAdRotationMode),
  "creationTime": string,
  "targetingSetting": {
    object (TargetingSetting)
  },
  "labels": [
    string
  ],
  "engineId": string,
  "startDate": string,
  "endDate": string,
  "languageCode": string,
  "lastModifiedTime": string,
  "id": string,
  "name": string,
  "cpcBidMicros": string,
  "engineStatus": enum (AdGroupEngineStatus)
}
Pola
resourceName

string

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

customers/{customerId}/adGroups/{ad_group_id}

status

enum (AdGroupStatus)

Stan grupy reklam.

type

enum (AdGroupType)

Typ grupy reklam.

adRotationMode

enum (AdGroupAdRotationMode)

Tryb rotacji reklam w grupie reklam.

creationTime

string

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

targetingSetting

object (TargetingSetting)

Ustawienie kierowania na funkcje związane z kierowaniem.

labels[]

string

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

engineId

string

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

startDate

string

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

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

endDate

string

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

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

languageCode

string

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

lastModifiedTime

string

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

id

string (int64 format)

Identyfikator grupy reklam.

name

string

Nazwa grupy reklam.

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

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

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

cpcBidMicros

string (int64 format)

Maksymalna stawka CPC (kosztu kliknięcia).

engineStatus

enum (AdGroupEngineStatus)

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 (TargetRestriction)
    }
  ]
}
Pola
targetRestrictions[]

object (TargetRestriction)

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 (TargetingDimension),
  "bidOnly": boolean
}
Pola
targetingDimension

enum (TargetingDimension)

Wymiar kierowania, do którego mają zastosowanie te ustawienia.

bidOnly

boolean

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ść true oznacza, że te kryteria będą stosowane tylko do modyfikatorów stawek i nie będą miały wpływu na kierowanie. Wartość false oznacza, że te kryteria ograniczają kierowanie oraz modyfikatory stawek.

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 (AdGroupAdStatus),
  "ad": {
    object (Ad)
  },
  "creationTime": string,
  "labels": [
    string
  ],
  "engineId": string,
  "engineStatus": enum (AdGroupAdEngineStatus),
  "lastModifiedTime": string
}
Pola
resourceName

string

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

customers/{customerId}/adGroupAds/{ad_group_id}~{adId}

status

enum (AdGroupAdStatus)

Stan reklamy.

ad

object (Ad)

Reklama.

creationTime

string

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[]

string

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

engineId

string

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

enum (AdGroupAdEngineStatus)

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

lastModifiedTime

string

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

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.

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

string

Nagłówek reklamy.

description1

string

Pierwszy wiersz tekstu reklamy.

description2

string

Drugi wiersz tekstu reklamy.

displayUrl

string

Wyświetlany adres URL reklamy.

displayMobileUrl

string

Wyświetlany mobilny adres URL reklamy.

adTrackingId

string (int64 format)

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

string

Nagłówek reklamy.

headline2

string

Drugi nagłówek reklamy.

headline3

string

Trzeci nagłówek reklamy.

description1

string

Pierwszy wiersz tekstu reklamy.

description2

string

Drugi wiersz tekstu reklamy.

path1

string

Tekst dołączony do automatycznie wygenerowanego widocznego adresu URL z separatorem.

path2

string

Tekst dołączony do ścieżki 1 z separatorem.

adTrackingId

string (int64 format)

Identyfikator śledzenia reklamy.

SearchAds360ResponsiveSearchAdInfo

Elastyczna reklama w wyszukiwarce w Search Ads 360.

Zapis JSON
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "path1": string,
  "path2": string,
  "adTrackingId": string
}
Pola
headlines[]

object (AdTextAsset)

Lista komponentów tekstowych do nagłówków. Gdy reklama się wyświetli, nagłówki zostaną wybrane z tej listy.

descriptions[]

object (AdTextAsset)

Lista komponentów tekstowych do tekstów reklamy. Gdy reklama się wyświetli, teksty reklamy zostaną wybrane z tej listy.

path1

string

Tekst dołączony do automatycznie wygenerowanego widocznego adresu URL z separatorem.

path2

string

Tekst dołączony do ścieżki 1 z separatorem.

adTrackingId

string (int64 format)

Identyfikator śledzenia reklamy.

AdTextAsset

Komponent tekstowy wykorzystywany w reklamie.

Zapis JSON
{
  "text": string
}
Pola
text

string

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

string

Pierwszy wiersz tekstu reklamy.

description2

string

Drugi wiersz tekstu reklamy.

adTrackingId

string (int64 format)

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

string

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

adGroupAd

string

Reklama z grupy reklam, do której jest dołączona etykieta.

label

string

Etykieta przypisana do reklamy z grupy reklam.

AdGroupAsset

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

Zapis JSON
{
  "resourceName": string,
  "adGroup": string,
  "asset": string,
  "status": enum (AssetLinkStatus)
}
Pola
resourceName

string

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

customers/{customerId}/adGroupAssets/{ad_group_id}~{assetId}~{fieldType}

adGroup

string

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

asset

string

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

status

enum (AssetLinkStatus)

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 (AssetSetLinkStatus)
}
Pola
resourceName

string

Nazwa zasobu zestawu komponentów grupy reklam. Nazwy zasobów zestawu komponentów w grupach reklam mają taką postać:

customers/{customerId}/adGroupAssetSets/{ad_group_id}~{asset_set_id}

adGroup

string

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

assetSet

string

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

status

enum (AssetSetLinkStatus)

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

string

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

customers/{customerId}/adGroupAudienceViews/{ad_group_id}~{criterionId}

AdGroupBidModifier

Odnosi się do modyfikatora stawek grupy reklam.

Zapis JSON
{
  "resourceName": string,
  "bidModifier": number,

  // Union field criterion can be only one of the following:
  "device": {
    object (DeviceInfo)
  }
  // End of list of possible types for union field criterion.
}
Pola
resourceName

string

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

customers/{customerId}/adGroupBidModifiers/{ad_group_id}~{criterionId}

bidModifier

number

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

Pole sumy criterion. Kryterium tego modyfikatora stawek grupy reklam.

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

device

object (DeviceInfo)

Kryterium urządzenia.

DeviceInfo

Kryterium urządzenia.

Zapis JSON
{
  "type": enum (Device)
}
Pola
type

enum (Device)

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 (AdGroupCriterionStatus),
  "qualityInfo": {
    object (QualityInfo)
  },
  "type": enum (CriterionType),
  "labels": [
    string
  ],
  "positionEstimates": {
    object (PositionEstimates)
  },
  "finalUrls": [
    string
  ],
  "engineId": string,
  "lastModifiedTime": string,
  "criterionId": string,
  "adGroup": string,
  "negative": boolean,
  "bidModifier": number,
  "cpcBidMicros": string,
  "effectiveCpcBidMicros": string,
  "engineStatus": enum (AdGroupCriterionEngineStatus),
  "finalUrlSuffix": string,
  "trackingUrlTemplate": string,

  // Union field criterion can be only one of the following:
  "keyword": {
    object (KeywordInfo)
  },
  "listingGroup": {
    object (ListingGroupInfo)
  },
  "ageRange": {
    object (AgeRangeInfo)
  },
  "gender": {
    object (GenderInfo)
  },
  "userList": {
    object (UserListInfo)
  },
  "webpage": {
    object (WebpageInfo)
  },
  "location": {
    object (LocationInfo)
  }
  // End of list of possible types for union field criterion.
}
Pola
resourceName

string

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

customers/{customerId}/adGroupCriteria/{ad_group_id}~{criterionId}

creationTime

string

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

status

enum (AdGroupCriterionStatus)

Stan kryterium.

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

qualityInfo

object (QualityInfo)

Informacje dotyczące jakości kryterium.

type

enum (CriterionType)

Typ kryterium.

labels[]

string

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

positionEstimates

object (PositionEstimates)

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

finalUrls[]

string

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

engineId

string

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

lastModifiedTime

string

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

criterionId

string (int64 format)

Identyfikator kryterium.

adGroup

string

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

negative

boolean

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

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

bidModifier

number

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

string (int64 format)

Stawka CPC (kosztu kliknięcia).

effectiveCpcBidMicros

string (int64 format)

Efektywna stawka CPC (kosztu kliknięcia).

engineStatus

enum (AdGroupCriterionEngineStatus)

Stan wyszukiwarki dla kryterium grupy reklam.

finalUrlSuffix

string

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

trackingUrlTemplate

string

Szablon URL do tworzenia linku monitorującego.

Pole sumy criterion. Kryterium w grupie reklam.

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

keyword

object (KeywordInfo)

Słowo kluczowe.

listingGroup

object (ListingGroupInfo)

Grupa informacji o produktach.

ageRange

object (AgeRangeInfo)

Przedział wiekowy.

gender

object (GenderInfo)

Płeć.

userList

object (UserListInfo)

Lista użytkowników.

webpage

object (WebpageInfo)

Strona internetowa

location

object (LocationInfo)

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

integer

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

string (int64 format)

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_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 (KeywordMatchType),
  "text": string
}
Pola
matchType

enum (KeywordMatchType)

Typ dopasowania słowa kluczowego.

text

string

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 (ListingGroupType)
}
Pola
type

enum (ListingGroupType)

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 (AgeRangeType)
}
Pola
type

enum (AgeRangeType)

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 (GenderType)
}
Pola
type

enum (GenderType)

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

string

Nazwa zasobu listy użytkowników.

WebpageInfo

Określa kryterium kierowania reklam na strony internetowe w witrynie reklamodawcy.

Zapis JSON
{
  "conditions": [
    {
      object (WebpageConditionInfo)
    }
  ],
  "coveragePercentage": number,
  "criterionName": string
}
Pola
conditions[]

object (WebpageConditionInfo)

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

number

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

string

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 (WebpageConditionOperand),
  "operator": enum (WebpageConditionOperator),
  "argument": string
}
Pola
operand

enum (WebpageConditionOperand)

Argument warunku kierowania na stronę internetową.

operator

enum (WebpageConditionOperator)

Operator warunku kierowania na stronę internetową.

argument

string

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

string

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

string

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

adGroupCriterion

string

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

label

string

Etykieta przypisana do kryterium w grupie reklam.

AdGroupLabel

Relacja między grupą reklam a etykietą.

Zapis JSON
{
  "resourceName": string,
  "adGroup": string,
  "label": string
}
Pola
resourceName

string

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

adGroup

string

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

label

string

Etykieta przypisana do grupy reklam.

AgeRangeView

Widok przedziału wiekowego.

Zapis JSON
{
  "resourceName": string
}
Pola
resourceName

string

Nazwa zasobu widoku przedziału wiekowego. Nazwy zasobów w widoku przedziału wiekowego mają następujący format:

customers/{customerId}/ageRangeViews/{ad_group_id}~{criterionId}

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 (AssetType),
  "finalUrls": [
    string
  ],
  "status": enum (AssetStatus),
  "creationTime": string,
  "lastModifiedTime": string,
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "engineStatus": enum (AssetEngineStatus),

  // Union field asset_data can be only one of the following:
  "youtubeVideoAsset": {
    object (YoutubeVideoAsset)
  },
  "imageAsset": {
    object (ImageAsset)
  },
  "textAsset": {
    object (TextAsset)
  },
  "calloutAsset": {
    object (UnifiedCalloutAsset)
  },
  "sitelinkAsset": {
    object (UnifiedSitelinkAsset)
  },
  "pageFeedAsset": {
    object (UnifiedPageFeedAsset)
  },
  "mobileAppAsset": {
    object (MobileAppAsset)
  },
  "callAsset": {
    object (UnifiedCallAsset)
  },
  "callToActionAsset": {
    object (CallToActionAsset)
  },
  "locationAsset": {
    object (UnifiedLocationAsset)
  }
  // End of list of possible types for union field asset_data.
}
Pola
resourceName

string

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

customers/{customerId}/assets/{assetId}

type

enum (AssetType)

Typ zasobu.

finalUrls[]

string

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

status

enum (AssetStatus)

Stan zasobu.

creationTime

string

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

lastModifiedTime

string

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

id

string (int64 format)

Identyfikator zasobu.

name

string

Opcjonalna nazwa zasobu.

trackingUrlTemplate

string

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

engineStatus

enum (AssetEngineStatus)

Stan wyszukiwarki zasobu.

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

object (YoutubeVideoAsset)

Zasób wideo w YouTube

imageAsset

object (ImageAsset)

Komponent z obrazem.

textAsset

object (TextAsset)

Komponent tekstowy.

calloutAsset

object (UnifiedCalloutAsset)

Ujednolicony komponent z objaśnieniem.

pageFeedAsset

object (UnifiedPageFeedAsset)

Komponent z ujednoliconym plikiem z adresami stron docelowych.

mobileAppAsset

object (MobileAppAsset)

Komponent aplikacji mobilnej

callAsset

object (UnifiedCallAsset)

Ujednolicony komponent do wykonywania połączeń.

callToActionAsset

object (CallToActionAsset)

Komponent z wezwaniem do działania

locationAsset

object (UnifiedLocationAsset)

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

string

Tytuł filmu w YouTube.

youtubeVideoId

string

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 (MimeType),
  "fullSize": {
    object (ImageDimension)
  },
  "fileSize": string
}
Pola
mimeType

enum (MimeType)

Typ MIME zasobu graficznego.

fullSize

object (ImageDimension)

Metadane tego obrazu w jego oryginalnym rozmiarze.

fileSize

string (int64 format)

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

string (int64 format)

Wysokość obrazu.

widthPixels

string (int64 format)

Szerokość obrazu.

url

string

Adres URL, który zwraca obraz o tej wysokości i szerokości.

TextAsset

Zasób tekstowy.

Zapis JSON
{
  "text": string
}
Pola
text

string

Zawartość tekstowa komponentu tekstowego.

UnifiedCalloutAsset

Ujednolicony komponent z objaśnieniem.

Zapis JSON
{
  "calloutText": string,
  "startDate": string,
  "endDate": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ],
  "useSearcherTimeZone": boolean
}
Pola
calloutText

string

Tekst objaśnienia. Długość tego ciągu powinna wynosić od 1 do 25 włącznie.

startDate

string

Data rozpoczęcia wyświetlania zasobu i rozpoczęcie jego wyświetlania, w formacie rrrr-MM-dd.

endDate

string

Data końcowa wejścia tego komponentu w życie i dalszego wyświetlania, w formacie rrrr-MM-dd.

adScheduleTargets[]

object (AdScheduleInfo)

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

boolean

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 (MinuteOfHour),
  "endMinute": enum (MinuteOfHour),
  "dayOfWeek": enum (DayOfWeek),
  "startHour": integer,
  "endHour": integer
}
Pola
startMinute

enum (MinuteOfHour)

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

enum (MinuteOfHour)

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

enum (DayOfWeek)

Dzień tygodnia, którego dotyczy harmonogram.

To pole jest wymagane w przypadku operacji CREATE i nie jest dozwolone w operacjach UPDATE.

startHour

integer

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

integer

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 (AdScheduleInfo)
    }
  ],
  "trackingId": string,
  "useSearcherTimeZone": boolean,
  "mobilePreferred": boolean
}
Pola
description1

string

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

string

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

string

Data rozpoczęcia wyświetlania zasobu i rozpoczęcie jego wyświetlania, w formacie rrrr-MM-dd.

endDate

string

Data końcowa wejścia tego komponentu w życie i dalszego wyświetlania, w formacie rrrr-MM-dd.

adScheduleTargets[]

object (AdScheduleInfo)

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

string (int64 format)

Identyfikator używany do śledzenia kliknięć komponentu z linkami do podstron. To jest adres URL Yahoo! Tylko Japonia.

useSearcherTimeZone

boolean

Określa, czy komponent z linkami do podstron ma się wyświetlać w strefie czasowej użytkownika wyszukiwania. Dotyczy Microsoft Ads.

mobilePreferred

boolean

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

string

Strona internetowa, na którą reklamodawcy chcą kierować reklamy.

labels[]

string

Etykiety używane do grupowania adresów URL stron.

MobileAppAsset

Zasób reprezentujący aplikację mobilną.

Zapis JSON
{
  "appId": string,
  "appStore": enum (MobileAppVendor)
}
Pola
appId

string

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

enum (MobileAppVendor)

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 (CallConversionReportingState),
  "callConversionAction": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ],
  "callOnly": boolean,
  "callTrackingEnabled": boolean,
  "useSearcherTimeZone": boolean,
  "startDate": string,
  "endDate": string
}
Pola
countryCode

string

Dwuliterowy kod kraju numeru telefonu. Przykłady: „PL”, „us”.

phoneNumber

string

Nieprzetworzony numer telefonu reklamodawcy. Przykłady: „1234567890”, „(123)456-7890”

callConversionReportingState

enum (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

string

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[]

object (AdScheduleInfo)

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

boolean

Czy podczas połączenia wyświetlany jest tylko numer telefonu bez linku do strony internetowej. Dotyczy Microsoft Ads.

callTrackingEnabled

boolean

Określa, czy połączenie ma być włączone w śledzeniu połączeń. Dotyczy Microsoft Ads.

useSearcherTimeZone

boolean

Określa, czy rozszerzenie połączeń ma być wyświetlane w strefie czasowej użytkownika wyszukiwania. Dotyczy Microsoft Ads.

startDate

string

Data rozpoczęcia wyświetlania zasobu i rozpoczęcie jego wyświetlania, w formacie rrrr-MM-dd.

endDate

string

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 (CallToActionType)
}
Pola
callToAction

enum (CallToActionType)

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 (BusinessProfileLocation)
    }
  ],
  "locationOwnershipType": enum (LocationOwnershipType)
}
Pola
placeId

string

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[]

object (BusinessProfileLocation)

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

enum (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[]

string

Reklamodawca określił etykietę lokalizacji na koncie w Profilu Firmy. Te dane są synchronizowane z konta Profilu Firmy.

storeCode

string

Kod sklepu w profilu firmy dotyczący tej lokalizacji. Te dane są synchronizowane z konta Profilu Firmy.

listingId

string (int64 format)

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 (AssetFieldType),
  "status": enum (AssetLinkStatus)
}
Pola
resourceName

string

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

customers/{customerId}/assetGroupAssets/{asset_group_id}~{assetId}~{fieldType}

assetGroup

string

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

asset

string

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

fieldType

enum (AssetFieldType)

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

status

enum (AssetLinkStatus)

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.
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.
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.
HOTEL_PROPERTY Ten komponent jest połączony jako obiekt hotelowy w kampanii Performance Max do celów związanych z podróżami.

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 signal can be only one of the following:
  "audience": {
    object (AudienceInfo)
  }
  // End of list of possible types for union field signal.
}
Pola
resourceName

string

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

customers/{customerId}/assetGroupSignals/{asset_group_id}~{signal_id}

assetGroup

string

Grupa plików, do której należy ten sygnał.

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

object (AudienceInfo)

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

AudienceInfo

Kryterium odbiorców.

Zapis JSON
{
  "audience": string
}
Pola
audience

string

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 (ListingGroupFilterType),
  "vertical": enum (ListingGroupFilterVertical),
  "caseValue": {
    object (ListingGroupFilterDimension)
  },
  "parentListingGroupFilter": string,
  "path": {
    object (ListingGroupFilterDimensionPath)
  }
}
Pola
resourceName

string

Nazwa zasobu filtra grupy informacji o produktach w grupie plików. Nazwa zasobu filtra grup informacji o produktach w grupie plików ma taki format:

customers/{customerId}/assetGroupListingGroupFilters/{asset_group_id}~{listing_group_filter_id}

assetGroup

string

Grupa plików, do której należy ten filtr grupy informacji o produktach.

id

string (int64 format)

Identyfikator elementu ListingGroupFilter.

type

enum (ListingGroupFilterType)

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

vertical

enum (ListingGroupFilterVertical)

Branża reprezentowana przez bieżące drzewo węzłów. Wszystkie węzły w tym samym drzewie muszą należeć do tej samej branży.

caseValue

object (ListingGroupFilterDimension)

Wartość wymiaru, za pomocą której ta grupa informacji o produktach zawęża obiekt nadrzędny. Nieokreślona dla grupy głównej.

parentListingGroupFilter

string

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

path

object (ListingGroupFilterDimensionPath)

Ś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 dimension can be only one of the following:
  "productBiddingCategory": {
    object (ProductBiddingCategory)
  },
  "productBrand": {
    object (ProductBrand)
  },
  "productChannel": {
    object (ProductChannel)
  },
  "productCondition": {
    object (ProductCondition)
  },
  "productCustomAttribute": {
    object (ProductCustomAttribute)
  },
  "productItemId": {
    object (ProductItemId)
  },
  "productType": {
    object (ProductType)
  }
  // End of list of possible types for union field dimension.
}
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

object (ProductBiddingCategory)

Kategoria ustalania stawek w ofercie produktu.

productBrand

object (ProductBrand)

Marka oferty produktu.

productChannel

object (ProductChannel)

Lokalizacja oferty produktu.

productCondition

object (ProductCondition)

Stan oferty produktu.

productCustomAttribute

object (ProductCustomAttribute)

Atrybut niestandardowy oferty produktu.

productItemId

object (ProductItemId)

Identyfikator produktu w ofercie.

productType

object (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 (ListingGroupFilterBiddingCategoryLevel),
  "id": string
}
Pola
level

enum (ListingGroupFilterBiddingCategoryLevel)

Wskazuje poziom kategorii w taksonomii.

id

string (int64 format)

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

string

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

ProductChannel

Lokalizacja oferty produktu.

Zapis JSON
{
  "channel": enum (ListingGroupFilterProductChannel)
}
Pola
channel

enum (ListingGroupFilterProductChannel)

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 (ListingGroupFilterProductCondition)
}
Pola
condition

enum (ListingGroupFilterProductCondition)

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 (ListingGroupFilterCustomAttributeIndex),
  "value": string
}
Pola
index

enum (ListingGroupFilterCustomAttributeIndex)

Wskazuje indeks atrybutu niestandardowego.

value

string

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

string

Wartość identyfikatora.

ProductType

Typ oferty produktu.

Zapis JSON
{
  "level": enum (ListingGroupFilterProductTypeLevel),
  "value": string
}
Pola
level

enum (ListingGroupFilterProductTypeLevel)

Poziom typu.

value

string

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 (ListingGroupFilterDimension)
    }
  ]
}
Pola
dimensions[]

object (ListingGroupFilterDimension)

Pełna ścieżka wymiarów określonych przez hierarchię filtra grup informacji o produktach (bez węzła głównego) do tego filtra grup informacji o produktach.

AssetGroupTopCombinationView

Widok wykorzystania kombinacji komponentów reklamy w grupie reklam.

Zapis JSON
{
  "resourceName": string,
  "assetGroupTopCombinations": [
    {
      object (AssetGroupAssetCombinationData)
    }
  ]
}
Pola
resourceName

string

Nazwa zasobu dla widoku kombinacji u góry grupy plików. Nazwy zasobów widoku Najważniejsze kombinacje grupy zasobów mają format: `"customers/{customerId}/assetGroupTopCombinationViews/{asset_group_id}~{asset_combination_category}"

assetGroupTopCombinations[]

object (AssetGroupAssetCombinationData)

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

AssetGroupAssetCombinationData

Grupa plików – dane o kombinacji komponentów

Zapis JSON
{
  "assetCombinationServedAssets": [
    {
      object (AssetUsage)
    }
  ]
}
Pola
assetCombinationServedAssets[]

object (AssetUsage)

Wyświetlone komponenty.

AssetUsage

Zawiera informacje o wykorzystaniu zasobu.

Zapis JSON
{
  "asset": string,
  "servedAssetFieldType": enum (ServedAssetFieldType)
}
Pola
asset

string

Nazwa zasobu.

servedAssetFieldType

enum (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.
CALL_TO_ACTION Komponent został użyty jako wezwanie do działania.
YOU_TUBE_VIDEO Zasób był używany jako film w YouTube.
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.

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 (AssetGroupStatus),
  "path1": string,
  "path2": string,
  "adStrength": enum (AdStrength)
}
Pola
resourceName

string

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

customers/{customerId}/assetGroups/{asset_group_id}

id

string (int64 format)

Identyfikator grupy plików.

campaign

string

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

name

string

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

finalUrls[]

string

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

finalMobileUrls[]

string

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

status

enum (AssetGroupStatus)

Stan grupy plików.

path1

string

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

path2

string

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

adStrength

enum (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 (AssetSetAssetStatus)
}
Pola
resourceName

string

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

customers/{customerId}/assetSetAssets/{asset_set_id}~{assetId}

assetSet

string

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

asset

string

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

status

enum (AssetSetAssetStatus)

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

string (int64 format)

Identyfikator zestawu zasobów.

resourceName

string

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

customers/{customerId}/assetSets/{asset_set_id}

BiddingStrategy

Strategia ustalania stawek.

Zapis JSON
{
  "resourceName": string,
  "status": enum (BiddingStrategyStatus),
  "type": enum (BiddingStrategyType),
  "currencyCode": string,
  "id": string,
  "name": string,
  "effectiveCurrencyCode": string,
  "campaignCount": string,
  "nonRemovedCampaignCount": string,

  // Union field scheme can be only one of the following:
  "enhancedCpc": {
    object (EnhancedCpc)
  },
  "maximizeConversionValue": {
    object (MaximizeConversionValue)
  },
  "maximizeConversions": {
    object (MaximizeConversions)
  },
  "targetCpa": {
    object (TargetCpa)
  },
  "targetImpressionShare": {
    object (TargetImpressionShare)
  },
  "targetOutrankShare": {
    object (TargetOutrankShare)
  },
  "targetRoas": {
    object (TargetRoas)
  },
  "targetSpend": {
    object (TargetSpend)
  }
  // End of list of possible types for union field scheme.
}
Pola
resourceName

string

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

customers/{customerId}/biddingStrategies/{bidding_strategy_id}

status

enum (BiddingStrategyStatus)

Stan strategii ustalania stawek.

To pole jest tylko do odczytu.

type

enum (BiddingStrategyType)

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

To pole jest tylko do odczytu.

currencyCode

string

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

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

id

string (int64 format)

Identyfikator strategii ustalania stawek.

name

string

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

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

effectiveCurrencyCode

string

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

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

string (int64 format)

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

To pole jest tylko do odczytu.

nonRemovedCampaignCount

string (int64 format)

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

To pole jest tylko do odczytu.

Pole sumy scheme. Schemat ustalania stawek.

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

enhancedCpc

object (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

object (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

object (MaximizeConversions)

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

targetCpa

object (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

object (TargetImpressionShare)

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

targetOutrankShare

object (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

object (TargetRoas)

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

targetSpend

object (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

string (int64 format)

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

string (int64 format)

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

number

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

Średni docelowy CPA. Ta wartość docelowa powinna być co najmniej równa minimalnej jednostce podlegającej rozliczeniu na podstawie waluty konta.

cpcBidCeilingMicros

string (int64 format)

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

string (int64 format)

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.

TargetImpressionShare

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

Zapis JSON
{
  "location": enum (TargetImpressionShareLocation),
  "locationFractionMicros": string,
  "cpcBidCeilingMicros": string
}
Pola
location

enum (TargetImpressionShareLocation)

Wybrana lokalizacja na stronie wyników wyszukiwania.

locationFractionMicros

string (int64 format)

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

cpcBidCeilingMicros

string (int64 format)

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

TargetImpressionShareLocation

Wyliczenie opisujące możliwe cele.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używany tylko w przypadku zwracanej wartości. Reprezentuje wartość nieznaną w tej wersji.
ANYWHERE_ON_PAGE Dowolne miejsce na stronie internetowej.
TOP_OF_PAGE Górne pole reklam.
ABSOLUTE_TOP_OF_PAGE Boks u góry strony z reklamami.

TargetOutrankShare

Strategia automatycznego określania stawek, która ustala stawki na podstawie docelowego odsetka aukcji, w których reklamodawca powinien przelicytować określony konkurent. Ta strategia została wycofana.

Zapis JSON
{
  "cpcBidCeilingMicros": string
}
Pola
cpcBidCeilingMicros

string (Int64Value format)

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

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

number

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

string (int64 format)

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

string (int64 format)

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
(deprecated)

string (int64 format)

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

string (int64 format)

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 (BudgetDeliveryMethod),
  "period": enum (BudgetPeriod),
  "amountMicros": string
}
Pola
resourceName

string

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

customers/{customerId}/campaignBudgets/{campaign_budget_id}

deliveryMethod

enum (BudgetDeliveryMethod)

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

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

period

enum (BudgetPeriod)

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

amountMicros

string (int64 format)

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 (CampaignStatus),
  "servingStatus": enum (CampaignServingStatus),
  "biddingStrategySystemStatus": enum (BiddingStrategySystemStatus),
  "adServingOptimizationStatus": enum (AdServingOptimizationStatus),
  "advertisingChannelType": enum (AdvertisingChannelType),
  "advertisingChannelSubType": enum (AdvertisingChannelSubType),
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "realTimeBiddingSetting": {
    object (RealTimeBiddingSetting)
  },
  "networkSettings": {
    object (NetworkSettings)
  },
  "dynamicSearchAdsSetting": {
    object (DynamicSearchAdsSetting)
  },
  "shoppingSetting": {
    object (ShoppingSetting)
  },
  "geoTargetTypeSetting": {
    object (GeoTargetTypeSetting)
  },
  "labels": [
    string
  ],
  "biddingStrategyType": enum (BiddingStrategyType),
  "accessibleBiddingStrategy": string,
  "frequencyCaps": [
    {
      object (FrequencyCapEntry)
    }
  ],
  "selectiveOptimization": {
    object (SelectiveOptimization)
  },
  "optimizationGoalSetting": {
    object (OptimizationGoalSetting)
  },
  "trackingSetting": {
    object (TrackingSetting)
  },
  "engineId": string,
  "excludedParentAssetFieldTypes": [
    enum (AssetFieldType)
  ],
  "createTime": string,
  "creationTime": string,
  "lastModifiedTime": string,
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "campaignBudget": string,
  "startDate": string,
  "endDate": string,
  "finalUrlSuffix": string,
  "urlExpansionOptOut": boolean,

  // Union field campaign_bidding_strategy can be only one of the following:
  "biddingStrategy": string,
  "manualCpa": {
    object (ManualCpa)
  },
  "manualCpc": {
    object (ManualCpc)
  },
  "manualCpm": {
    object (ManualCpm)
  },
  "maximizeConversions": {
    object (MaximizeConversions)
  },
  "maximizeConversionValue": {
    object (MaximizeConversionValue)
  },
  "targetCpa": {
    object (TargetCpa)
  },
  "targetImpressionShare": {
    object (TargetImpressionShare)
  },
  "targetRoas": {
    object (TargetRoas)
  },
  "targetSpend": {
    object (TargetSpend)
  },
  "percentCpc": {
    object (PercentCpc)
  },
  "targetCpm": {
    object (TargetCpm)
  }
  // End of list of possible types for union field campaign_bidding_strategy.
}
Pola
resourceName

string

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

customers/{customerId}/campaigns/{campaign_id}

status

enum (CampaignStatus)

Stan kampanii.

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

servingStatus

enum (CampaignServingStatus)

Stan wyświetlania reklam w kampanii.

biddingStrategySystemStatus

enum (BiddingStrategySystemStatus)

Stan systemu strategii ustalania stawek w kampanii.

adServingOptimizationStatus

enum (AdServingOptimizationStatus)

Stan optymalizacji wyświetlania reklam w kampanii.

advertisingChannelType

enum (AdvertisingChannelType)

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

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

enum (AdvertisingChannelSubType)

Opcjonalne doprecyzowanie: advertisingChannelType. Musi być prawidłowym podtypem typu kanału nadrzędnego.

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

urlCustomParameters[]

object (CustomParameter)

Lista mapowań używanych do zastępowania tagów niestandardowych parametrów w elemencie trackingUrlTemplate, finalUrls lub mobile_final_urls.

realTimeBiddingSetting

object (RealTimeBiddingSetting)

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

networkSettings

object (NetworkSettings)

Ustawienia sieci w kampanii.

dynamicSearchAdsSetting

object (DynamicSearchAdsSetting)

Ustawienie do kontrolowania dynamicznych reklam w wyszukiwarce (DSA).

shoppingSetting

object (ShoppingSetting)

Ustawienie do kontrolowania kampanii produktowych.

geoTargetTypeSetting

object (GeoTargetTypeSetting)

Ustawienie kierowania geograficznego reklam.

labels[]

string

Nazwy zasobów etykiet dołączonych do tej kampanii.

biddingStrategyType

enum (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 biddingStrategy do utworzenia strategii portfolio ustalania stawek.

To pole jest tylko do odczytu.

accessibleBiddingStrategy

string

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[]

object (FrequencyCapEntry)

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

selectiveOptimization

object (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

object (OptimizationGoalSetting)

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

trackingSetting

object (TrackingSetting)

Ustawienia śledzenia informacji na poziomie kampanii.

engineId

string

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

excludedParentAssetFieldTypes[]

enum (AssetFieldType)

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

createTime

string

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

creationTime

string

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

lastModifiedTime

string

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

id

string (int64 format)

Identyfikator kampanii.

name

string

Nazwa kampanii

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

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

trackingUrlTemplate

string

Szablon URL do tworzenia linku monitorującego.

campaignBudget

string

Budżet kampanii.

startDate

string

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

endDate

string

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

finalUrlSuffix

string

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

urlExpansionOptOut

boolean

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 campaign_bidding_strategy. Strategia ustalania stawek w kampanii.

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

biddingStrategy

string

Strategia portfolio ustalania stawek używana w kampanii.

manualCpa

object (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

object (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

object (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

object (MaximizeConversions)

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

maximizeConversionValue

object (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

object (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

object (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

object (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

object (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

object (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

object (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

string

Klucz pasujący do nazwy tagu parametru.

value

string

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

boolean

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
targetSearchNetwork

boolean

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

targetContentNetwork

boolean

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

boolean

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

string

Wymagane. Nazwa domeny internetowej reprezentowanej przez to ustawienie, na przykład „google.com” lub „www.google.com”.

languageCode

string

Wymagane. Kod języka określający język domeny, np. „en”.

useSuppliedUrlsOnly

boolean

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

string

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

boolean

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

merchantId

string (int64 format)

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

salesCountry

string

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

campaignPriority

integer

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

boolean

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

GeoTargetTypeSetting

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

Zapis JSON
{
  "positiveGeoTargetType": enum (PositiveGeoTargetType),
  "negativeGeoTargetType": enum (NegativeGeoTargetType)
}
Pola
positiveGeoTargetType

enum (PositiveGeoTargetType)

Ustawienie stosowane do niewykluczającego kierowania geograficznego w tej konkretnej kampanii.

negativeGeoTargetType

enum (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[]

string

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 (OptimizationGoalType)
  ]
}
Pola
optimizationGoalTypes[]

enum (OptimizationGoalType)

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

string

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

boolean

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

string (int64 format)

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

boolean

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 (AssetLinkStatus),
  "campaign": string,
  "asset": string
}
Pola
resourceName

string

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

customers/{customerId}/campaignAssets/{campaign_id}~{assetId}~{fieldType}

status

enum (AssetLinkStatus)

Stan komponentu kampanii.

campaign

string

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

asset

string

Komponent powiązany z kampanią.

Zestaw komponentów kampanii

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

Zapis JSON
{
  "resourceName": string,
  "campaign": string,
  "assetSet": string,
  "status": enum (AssetSetLinkStatus)
}
Pola
resourceName

string

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

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

campaign

string

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

assetSet

string

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

status

enum (AssetSetLinkStatus)

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

CampaignAudienceView

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

Zapis JSON
{
  "resourceName": string
}
Pola
resourceName

string

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

customers/{customerId}/campaignAudienceViews/{campaign_id}~{criterionId}

CampaignCriterion

Kryterium kampanii.

Zapis JSON
{
  "resourceName": string,
  "displayName": string,
  "type": enum (CriterionType),
  "status": enum (CampaignCriterionStatus),
  "lastModifiedTime": string,
  "criterionId": string,
  "bidModifier": number,
  "negative": boolean,

  // Union field criterion can be only one of the following:
  "keyword": {
    object (KeywordInfo)
  },
  "location": {
    object (LocationInfo)
  },
  "device": {
    object (DeviceInfo)
  },
  "ageRange": {
    object (AgeRangeInfo)
  },
  "gender": {
    object (GenderInfo)
  },
  "userList": {
    object (UserListInfo)
  },
  "language": {
    object (LanguageInfo)
  },
  "webpage": {
    object (WebpageInfo)
  },
  "locationGroup": {
    object (LocationGroupInfo)
  }
  // End of list of possible types for union field criterion.
}
Pola
resourceName

string

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

customers/{customerId}/campaignCriteria/{campaign_id}~{criterionId}

displayName

string

Wyświetlana nazwa kryterium.

To pole jest ignorowane w przypadku mutacji.

type

enum (CriterionType)

Typ kryterium.

status

enum (CampaignCriterionStatus)

Stan kryterium.

lastModifiedTime

string

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

criterionId

string (int64 format)

Identyfikator kryterium.

To pole jest ignorowane podczas mutacji.

bidModifier

number

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

boolean

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

Pole sumy criterion. Kryterium kampanii.

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

keyword

object (KeywordInfo)

Słowo kluczowe.

location

object (LocationInfo)

Lokalizacja.

device

object (DeviceInfo)

Urządzenie.

ageRange

object (AgeRangeInfo)

Przedział wiekowy.

gender

object (GenderInfo)

Płeć.

userList

object (UserListInfo)

Lista użytkowników.

language

object (LanguageInfo)

Język.

webpage

object (WebpageInfo)

Strona internetowa.

locationGroup

object (LocationGroupInfo)

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

string

Nazwa zasobu stałej języka.

LocationGroupInfo

Promień wokół listy lokalizacji określonej za pomocą pliku danych.

Zapis JSON
{
  "geoTargetConstants": [
    string
  ],
  "radiusUnits": enum (LocationGroupRadiusUnits),
  "feedItemSets": [
    string
  ],
  "radius": string
}
Pola
geoTargetConstants[]

string

Stała kierowania geograficznego, która ogranicza zakres obszaru geograficznego w pliku danych. Obecnie dozwolona jest tylko 1 stała wartość kierowania geograficznego.

radiusUnits

enum (LocationGroupRadiusUnits)

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[]

string

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

string (int64 format)

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

string

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

campaign

string

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

label

string

Etykieta przypisana do kampanii.

CartDataSalesView

Widok sprzedaży danych koszyka.

Zapis JSON
{
  "resourceName": string
}
Pola
resourceName

string

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

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

string

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

customers/{customerId}/audiences/{audience_id}

id

string (int64 format)

Identyfikator listy odbiorców.

name

string

Wymagane. Nazwa listy odbiorców. Powinien być niepowtarzalny wśród wszystkich odbiorców. Minimalna długość to 1, a maksymalna – 255 znaków.

description

string

Opis tej listy odbiorców.

ConversionAction

Działanie powodujące konwersję.

Zapis JSON
{
  "resourceName": string,
  "creationTime": string,
  "status": enum (ConversionActionStatus),
  "type": enum (ConversionActionType),
  "category": enum (ConversionActionCategory),
  "valueSettings": {
    object (ValueSettings)
  },
  "attributionModelSettings": {
    object (AttributionModelSettings)
  },
  "floodlightSettings": {
    object (FloodlightSettings)
  },
  "id": string,
  "name": string,
  "primaryForGoal": boolean,
  "ownerCustomer": string,
  "includeInClientAccountConversionsMetric": boolean,
  "includeInConversionsMetric": boolean,
  "clickThroughLookbackWindowDays": string,
  "appId": string
}
Pola
resourceName

string

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

customers/{customerId}/conversionActions/{conversion_action_id}

creationTime

string

Sygnatura czasowa utworzenia aktywności Floodlight w formacie ISO 8601.

status

enum (ConversionActionStatus)

Stan tego działania powodującego konwersję na potrzeby gromadzenia zdarzeń konwersji.

type

enum (ConversionActionType)

Typ tego działania powodującego konwersję.

category

enum (ConversionActionCategory)

Kategoria konwersji raportowanych dla tego działania powodującego konwersję.

valueSettings

object (ValueSettings)

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

attributionModelSettings

object (AttributionModelSettings)

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

floodlightSettings

object (FloodlightSettings)

Ustawienia Floodlight dla typów konwersji Floodlight.

id

string (int64 format)

Identyfikator działania powodującego konwersję.

name

string

Nazwa działania powodującego konwersję.

To pole jest wymagane i nie powinno być puste podczas tworzenia nowych działań powodujących konwersję.

primaryForGoal

boolean

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

string

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

includeInClientAccountConversionsMetric

boolean

Określa, czy to działanie powodujące konwersję ma być uwzględnione w kolumnie „clientAccountConversions” danych.

includeInConversionsMetric

boolean

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

clickThroughLookbackWindowDays

string (int64 format)

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

appId

string

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

number

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

string

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

alwaysUseDefaultValue

boolean

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 (AttributionModel),
  "dataDrivenModelStatus": enum (DataDrivenModelStatus)
}
Pola
attributionModel

enum (AttributionModel)

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

dataDrivenModelStatus

enum (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

string

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

activityTag

string

Ciąg tekstowy służący do rozpoznawania aktywności Floodlight podczas raportowania konwersji.

activityId

string (int64 format)

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 (ConversionCustomVariableStatus),
  "ownerCustomer": string,
  "family": enum (ConversionCustomVariableFamily),
  "cardinality": enum (ConversionCustomVariableCardinality),
  "floodlightConversionCustomVariableInfo": {
    object (FloodlightConversionCustomVariableInfo)
  },
  "customColumnIds": [
    string
  ]
}
Pola
resourceName

string

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

customers/{customerId}/conversionCustomVariables/{conversion_custom_variable_id}

id

string (int64 format)

Identyfikator niestandardowej zmiennej konwersji.

name

string

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

tag

string

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

status

enum (ConversionCustomVariableStatus)

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

ownerCustomer

string

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

family

enum (ConversionCustomVariableFamily)

Rodzina zmiennej niestandardowej konwersji.

cardinality

enum (ConversionCustomVariableCardinality)

Moc zbioru niestandardowej zmiennej konwersji.

floodlightConversionCustomVariableInfo

object (FloodlightConversionCustomVariableInfo)

Pola zmiennych niestandardowych konwersji Floodlight w Search Ads 360.

customColumnIds[]

string (int64 format)

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 (FloodlightVariableType),
  "floodlightVariableDataType": enum (FloodlightVariableDataType)
}
Pola
floodlightVariableType

enum (FloodlightVariableType)

Typ zmiennej Floodlight określony w Search Ads 360.

floodlightVariableDataType

enum (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 (ConversionTrackingSetting)
  },
  "accountType": enum (AccountType),
  "doubleClickCampaignManagerSetting": {
    object (DoubleClickCampaignManagerSetting)
  },
  "accountStatus": enum (AccountStatus),
  "lastModifiedTime": string,
  "engineId": string,
  "status": enum (CustomerStatus),
  "creationTime": string,
  "id": string,
  "descriptiveName": string,
  "currencyCode": string,
  "timeZone": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": string,
  "autoTaggingEnabled": boolean,
  "manager": boolean
}
Pola
resourceName

string

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

customers/{customerId}

conversionTrackingSetting

object (ConversionTrackingSetting)

Ustawienie śledzenia konwersji dla klienta.

accountType

enum (AccountType)

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

doubleClickCampaignManagerSetting

object (DoubleClickCampaignManagerSetting)

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

accountStatus

enum (AccountStatus)

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

lastModifiedTime

string

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

engineId

string

Identyfikator konta na zewnętrznym koncie wyszukiwarki.

status

enum (CustomerStatus)

Stan klienta.

creationTime

string

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

id

string (int64 format)

Identyfikator klienta.

descriptiveName

string

Opcjonalna, nieunikalna opisowa nazwa klienta.

currencyCode

string

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

timeZone

string

Identyfikator lokalnej strefy czasowej klienta.

trackingUrlTemplate

string

Szablon URL do tworzenia linku monitorującego na podstawie parametrów.

finalUrlSuffix

string

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

autoTaggingEnabled

boolean

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

manager

boolean

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 (ConversionTrackingStatus),
  "enhancedConversionsForLeadsEnabled": boolean,
  "googleAdsConversionCustomer": string,
  "conversionTrackingId": string,
  "googleAdsCrossAccountConversionTrackingId": string,
  "crossAccountConversionTrackingId": string
}
Pola
acceptedCustomerDataTerms

boolean

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

enum (ConversionTrackingStatus)

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

enhancedConversionsForLeadsEnabled

boolean

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

string

Nazwa zasobu klienta, w którym są tworzone konwersje i zarządzanie nimi. To pole jest tylko do odczytu.

conversionTrackingId

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

networkId

string (int64 format)

Identyfikator sieci Campaign Managera powiązanej z tym klientem.

timeZone

string

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 (AssetLinkStatus)
}
Pola
resourceName

string

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

customers/{customerId}/customerAssets/{assetId}~{fieldType}

asset

string

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

status

enum (AssetLinkStatus)

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 (AssetSetLinkStatus)
}
Pola
resourceName

string

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

customers/{customerId}/customerAssetSets/{asset_set_id}

assetSet

string

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

customer

string

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

status

enum (AssetSetLinkStatus)

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 (BiddingStrategyType),
  "ownerCustomerId": string,
  "ownerDescriptiveName": string,

  // Union field scheme can be only one of the following:
  "maximizeConversionValue": {
    object (MaximizeConversionValue)
  },
  "maximizeConversions": {
    object (MaximizeConversions)
  },
  "targetCpa": {
    object (TargetCpa)
  },
  "targetImpressionShare": {
    object (TargetImpressionShare)
  },
  "targetRoas": {
    object (TargetRoas)
  },
  "targetSpend": {
    object (TargetSpend)
  }
  // End of list of possible types for union field scheme.
}
Pola
resourceName

string

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

customers/{customerId}/accessibleBiddingStrategies/{bidding_strategy_id}

id

string (int64 format)

Identyfikator strategii ustalania stawek.

name

string

Nazwa strategii ustalania stawek.

type

enum (BiddingStrategyType)

Typ strategii ustalania stawek.

ownerCustomerId

string (int64 format)

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

ownerDescriptiveName

string

opisowaNazwa klienta, który jest właścicielem strategii ustalania stawek.

Pole sumy scheme. Schemat ustalania stawek.

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

maximizeConversionValue

object (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

object (MaximizeConversions)

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

targetCpa

object (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

object (TargetImpressionShare)

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

targetRoas

object (TargetRoas)

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

targetSpend

object (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

number

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

string (int64 format)

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

targetCpaMicros

string (int64 format)

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

string (int64 format)

Średni docelowy CPA. Ta wartość docelowa powinna być co najmniej równa minimalnej jednostce podlegającej rozliczeniu na podstawie waluty konta.

TargetImpressionShare

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

Zapis JSON
{
  "location": enum (TargetImpressionShareLocation),
  "locationFractionMicros": string,
  "cpcBidCeilingMicros": string
}
Pola
location

enum (TargetImpressionShareLocation)

Wybrana lokalizacja na stronie wyników wyszukiwania.

locationFractionMicros

string (int64 format)

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

cpcBidCeilingMicros

string (int64 format)

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

TargetRoas

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

Zapis JSON
{
  "targetRoas": number
}
Pola
targetRoas

number

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
(deprecated)

string (int64 format)

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

string (int64 format)

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

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 (CustomerStatus),
  "clientCustomer": string,
  "hidden": boolean,
  "level": string,
  "timeZone": string,
  "testAccount": boolean,
  "manager": boolean,
  "descriptiveName": string,
  "currencyCode": string,
  "id": string
}
Pola
resourceName

string

Nazwa zasobu klienta klienta. Nazwy zasobów CustomerClient mają format: customers/{customerId}/customerClients/{client_customer_id}

appliedLabels[]

string

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

customers/{customerId}/labels/{label_id}

status

enum (CustomerStatus)

Stan klienta klienta. Tylko do odczytu.

clientCustomer

string

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

hidden

boolean

Określa, czy to konto jest ukryte.

Tylko do odczytu.

level

string (int64 format)

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

timeZone

string

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

testAccount

boolean

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

manager

boolean

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

descriptiveName

string

Opisowa nazwa klienta. Tylko do odczytu.

currencyCode

string

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

id

string (int64 format)

Identyfikator klienta. Tylko do odczytu.

DynamicSearchAdsSearchTermView

Widok wyszukiwanych haseł w dynamicznych reklamach w wyszukiwarce

Zapis JSON
{
  "resourceName": string,
  "landingPage": string
}
Pola
resourceName

string

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

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

landingPage

string

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

string

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

customers/{customerId}/genderViews/{ad_group_id}~{criterionId}

GeoTargetConstant

Stała kierowania geograficznego.

Zapis JSON
{
  "resourceName": string,
  "status": enum (GeoTargetConstantStatus),
  "id": string,
  "name": string,
  "countryCode": string,
  "targetType": string,
  "canonicalName": string,
  "parentGeoTarget": string
}
Pola
resourceName

string

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

geoTargetConstants/{geo_target_constant_id}

status

enum (GeoTargetConstantStatus)

Stały stan kierowania geograficznego.

id

string (int64 format)

Identyfikator stałej kierowania geograficznego.

name

string

Stała angielska nazwa kierowania geograficznego.

countryCode

string

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

targetType

string

Typ stałego kierowania geograficznego.

canonicalName

string

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

parentGeoTarget

string

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

geoTargetConstants/{parent_geo_target_constant_id}

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

string

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

customers/{customerId}/keywordViews/{ad_group_id}~{criterionId}

Etykieta

Etykieta.

Zapis JSON
{
  "resourceName": string,
  "status": enum (LabelStatus),
  "textLabel": {
    object (TextLabel)
  },
  "id": string,
  "name": string
}
Pola
resourceName

string

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

status

enum (LabelStatus)

Stan etykiety. Tylko do odczytu.

textLabel

object (TextLabel)

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

id

string (int64 format)

Identyfikator etykiety. Tylko do odczytu.

name

string

Nazwa etykiety.

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

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

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

string

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

string

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

string

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

languageConstants/{criterionId}

id

string (int64 format)

Identyfikator stałej języka.

code

string

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

name

string

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

targetable

boolean

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

string

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

customers/{customerId}/locationViews/{campaign_id}~{criterionId}

ProductBiddingCategoryConstant

Kategoria określania stawek produktu.

Zapis JSON
{
  "resourceName": string,
  "level": enum (ProductBiddingCategoryLevel),
  "status": enum (ProductBiddingCategoryStatus),
  "id": string,
  "countryCode": string,
  "productBiddingCategoryConstantParent": string,
  "languageCode": string,
  "localizedName": string
}
Pola
resourceName

string

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

productBiddingCategoryConstants/{countryCode}~{level}~{id}

level

enum (ProductBiddingCategoryLevel)

Poziom kategorii określania stawek za produkt.

status

enum (ProductBiddingCategoryStatus)

Stan kategorii określania stawek produktu.

id

string (int64 format)

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

string

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

productBiddingCategoryConstantParent

string

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

languageCode

string

Kod języka kategorii ustalania stawek produktu.

localizedName

string

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

string

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

customers/{customerId}/productGroupViews/{ad_group_id}~{criterionId}

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

string

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

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 (UserListType),
  "id": string,
  "name": string
}
Pola
resourceName

string

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

customers/{customerId}/userLists/{user_list_id}

type

enum (UserListType)

Typ tej listy.

To pole jest tylko do odczytu.

id

string (int64 format)

Identyfikator listy użytkowników.

name

string

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

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

string

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

customers/{customerId}/webpageViews/{ad_group_id}~{criterionId}

Odwiedź

Wizyta.

Zapis JSON
{
  "resourceName": string,
  "id": string,
  "criterionId": string,
  "merchantId": string,
  "adId": string,
  "clickId": string,
  "visitDateTime": string,
  "productId": string,
  "productChannel": enum (ProductChannel),
  "productLanguageCode": string,
  "productStoreId": string,
  "productCountryCode": string,
  "assetId": string,
  "assetFieldType": enum (AssetFieldType)
}
Pola
resourceName

string

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

customers/{customerId}/visits/{ad_group_id}~{criterionId}~{ds_visit_id}

id

string (int64 format)

Identyfikator wizyty.

criterionId

string (int64 format)

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

merchantId

string (int64 format)

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

string (int64 format)

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

clickId

string

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

visitDateTime

string

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

productId

string

Identyfikator klikniętego produktu.

productChannel

enum (ProductChannel)

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

productLanguageCode

string

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

productStoreId

string

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

productCountryCode

string

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

assetId

string (int64 format)

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

assetFieldType

enum (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 (ProductChannel),
  "productLanguageCode": string,
  "productStoreId": string,
  "productCountryCode": string,
  "attributionType": enum (AttributionType),
  "conversionDateTime": string,
  "conversionLastModifiedDateTime": string,
  "conversionVisitDateTime": string,
  "conversionQuantity": string,
  "conversionRevenueMicros": string,
  "floodlightOriginalRevenue": string,
  "floodlightOrderId": string,
  "status": enum (ConversionStatus),
  "assetId": string,
  "assetFieldType": enum (AssetFieldType)
}
Pola
resourceName

string

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

customers/{customerId}/conversions/{ad_group_id}~{criterionId}~{ds_conversion_id}

id

string (int64 format)

Identyfikator konwersji

criterionId

string (int64 format)

Identyfikator kryterium Search Ads 360. Wartość 0 oznacza, że kryterium jest nieprzypisane.

merchantId

string (int64 format)

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

string (int64 format)

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

clickId

string

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

visitId

string (int64 format)

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

advertiserConversionId

string

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

productId

string

Identyfikator klikniętego produktu.

productChannel

enum (ProductChannel)

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

productLanguageCode

string

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

productStoreId

string

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

productCountryCode

string

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

attributionType

enum (AttributionType)

Do czego jest przypisana konwersja: wizyta lub słowo kluczowe + reklama.

conversionDateTime

string

Sygnatura czasowa zdarzenia konwersji.

conversionLastModifiedDateTime

string

Sygnatura czasowa ostatniej modyfikacji konwersji.

conversionVisitDateTime

string

Sygnatura czasowa wizyty, do której została przypisana konwersja.

conversionQuantity

string (int64 format)

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

string (int64 format)

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

floodlightOriginalRevenue

string (int64 format)

Pierwotne, niezmienione przychody powiązane ze zdarzeniem Floodlight (w walucie bieżącego raportu) sprzed modyfikacji instrukcji dotyczących waluty Floodlight.

floodlightOrderId

string

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

status

enum (ConversionStatus)

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

assetId

string (int64 format)

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

assetFieldType

enum (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 (Value)
    }
  ],
  "conversionsValueByConversionDate": number,
  "conversionsByConversionDate": number,
  "historicalCreativeQualityScore": enum (QualityScoreBucket),
  "historicalLandingPageQualityScore": enum (QualityScoreBucket),
  "historicalSearchPredictedCtr": enum (QualityScoreBucket),
  "interactionEventTypes": [
    enum (InteractionEventType)
  ],
  "rawEventConversionMetrics": [
    {
      object (Value)
    }
  ],
  "absoluteTopImpressionPercentage": number,
  "allConversionsFromInteractionsRate": number,
  "allConversionsValue": number,
  "allConversions": number,
  "allConversionsValuePerCost": number,
  "allConversionsFromClickToCall": number,
  "allConversionsFromDirections": number,
  "allConversionsFromInteractionsValuePerInteraction": number,
  "allConversionsFromMenu": number,
  "allConversionsFromOrder": number,
  "allConversionsFromOtherEngagement": number,
  "allConversionsFromStoreVisit": number,
  "visits": number,
  "allConversionsFromStoreWebsite": number,
  "averageCost": number,
  "averageCpc": number,
  "averageCpm": number,
  "clicks": string,
  "contentBudgetLostImpressionShare": number,
  "contentImpressionShare": number,
  "contentRankLostImpressionShare": number,
  "conversionsFromInteractionsRate": number,
  "clientAccountConversionsValue": number,
  "conversionsValuePerCost": number,
  "conversionsFromInteractionsValuePerInteraction": number,
  "clientAccountConversions": number,
  "costMicros": string,
  "costPerAllConversions": number,
  "costPerConversion": number,
  "costPerCurrentModelAttributedConversion": number,
  "crossDeviceConversions": number,
  "crossDeviceConversionsValue": number,
  "ctr": number,
  "conversions": number,
  "conversionsValue": number,
  "averageQualityScore": number,
  "historicalQualityScore": string,
  "impressions": string,
  "interactionRate": number,
  "interactions": string,
  "invalidClickRate": number,
  "invalidClicks": string,
  "mobileFriendlyClicksPercentage": number,
  "searchAbsoluteTopImpressionShare": number,
  "searchBudgetLostAbsoluteTopImpressionShare": number,
  "searchBudgetLostImpressionShare": number,
  "searchBudgetLostTopImpressionShare": number,
  "searchClickShare": number,
  "searchExactMatchImpressionShare": number,
  "searchImpressionShare": number,
  "searchRankLostAbsoluteTopImpressionShare": number,
  "searchRankLostImpressionShare": number,
  "searchRankLostTopImpressionShare": number,
  "searchTopImpressionShare": number,
  "topImpressionPercentage": number,
  "valuePerAllConversions": number,
  "valuePerAllConversionsByConversionDate": number,
  "valuePerConversion": number,
  "valuePerConversionsByConversionDate": number,
  "clientAccountViewThroughConversions": string,
  "clientAccountCrossSellCostOfGoodsSoldMicros": string,
  "crossSellCostOfGoodsSoldMicros": string,
  "clientAccountCrossSellGrossProfitMicros": string,
  "crossSellGrossProfitMicros": string,
  "clientAccountCrossSellRevenueMicros": string,
  "crossSellRevenueMicros": string,
  "clientAccountCrossSellUnitsSold": number,
  "crossSellUnitsSold": number,
  "clientAccountLeadCostOfGoodsSoldMicros": string,
  "leadCostOfGoodsSoldMicros": string,
  "clientAccountLeadGrossProfitMicros": string,
  "leadGrossProfitMicros": string,
  "clientAccountLeadRevenueMicros": string,
  "leadRevenueMicros": string,
  "clientAccountLeadUnitsSold": number,
  "leadUnitsSold": number
}
Pola
allConversionsValueByConversionDate

number

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

number

Łą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[]

object (Value)

Niestandardowe dane konwersji.

conversionsValueByConversionDate

number

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

number

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

enum (QualityScoreBucket)

Historyczny wynik jakości kreacji.

historicalLandingPageQualityScore

enum (QualityScoreBucket)

Jakość historycznej oceny jakości strony docelowej.

historicalSearchPredictedCtr

enum (QualityScoreBucket)

Historyczny współczynnik klikalności (CTR) w sieci wyszukiwania.

interactionEventTypes[]

enum (InteractionEventType)

Rodzaje płatnych i bezpłatnych interakcji.

rawEventConversionMetrics[]

object (Value)

Nieprzetworzone dane konwersji zdarzeń.

absoluteTopImpressionPercentage

number

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

number

Liczba wszystkich konwersji z interakcji (przeciwieństwem do konwersji po wyświetleniu) podzielona przez liczbę interakcji z reklamą.

allConversionsValue

number

Wartość wszystkich konwersji.

allConversions

number

Łączna liczba konwersji. Obejmuje to wszystkie konwersje niezależnie od wartości includeInConversionsMetric.

allConversionsValuePerCost

number

Wartość wszystkich konwersji podzielona przez łączny koszt interakcji z reklamą (np. kliknięć reklam tekstowych lub wyświetleń reklam wideo).

allConversionsFromClickToCall

number

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

number

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

number

Wartość wszystkich konwersji z interakcji podzielona przez łączną liczbę interakcji.

allConversionsFromMenu

number

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

number

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

number

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

number

Szacunkowa liczba wizyt użytkowników w sklepie po kliknięciu reklamy.

Te dane mają zastosowanie tylko do elementów kanału.

visits

number

Kliknięcia zarejestrowane przez Search Ads 360 i przekierowane do strony docelowej reklamodawcy.

allConversionsFromStoreWebsite

number

Tyle razy użytkownicy zostali przeniesieni na stronę sklepu po kliknięciu reklamy.

Te dane mają zastosowanie tylko do elementów kanału.

averageCost

number

Średnia kwota, jaką płacisz za interakcję. To iloraz łącznego kosztu reklam i całkowitej liczby interakcji.

averageCpc

number

Łą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

number

Ś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

string (int64 format)

Liczba kliknięć.

contentBudgetLostImpressionShare

number

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

number

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

number

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

number

Ś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

number

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

number

Wartość konwersji z możliwością określenia stawki podzielona przez łączny koszt interakcji kwalifikujących się do konwersji.

conversionsFromInteractionsValuePerInteraction

number

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

number

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

string (int64 format)

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

number

Koszt interakcji z reklamą podzielony przez łączną liczbę konwersji.

costPerConversion

number

Średni koszt kwalifikujących się konwersji z możliwością określenia stawki.

costPerCurrentModelAttributedConversion

number

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

number

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

number

Suma wartości konwersji na różnych urządzeniach.

ctr

number

Liczba kliknięć reklamy (kliknięcia) podzielona przez liczbę jej wyświetleń.

conversions

number

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

number

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

number

Średni wynik jakości.

historicalQualityScore

string (int64 format)

Historyczny wynik jakości.

impressions

string (int64 format)

Liczba wyświetleń reklamy na stronie wyników wyszukiwania lub w witrynie w sieci Google.

interactionRate

number

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

string (int64 format)

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

number

Odsetek odfiltrowanych kliknięć spośród całkowitej liczby kliknięć (odfiltrowane i nieodfiltrowane) w okresie raportowania.

invalidClicks

string (int64 format)

Liczba kliknięć, które Google uznaje za nielegalne i nie pobiera za nie opłat.

mobileFriendlyClicksPercentage

number

Odsetek kliknięć z komórek, które prowadzą na stronę dostosowaną do komórek.

searchAbsoluteTopImpressionShare

number

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

number

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

number

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

number

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

number

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

number

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

number

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

number

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

number

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

number

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

number

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

number

Odsetek wyświetleń reklamy obok bezpłatnych wyników wyszukiwania u góry strony.

valuePerAllConversions

number

Wartość wszystkich konwersji podzielona przez liczbę wszystkich konwersji.

valuePerAllConversionsByConversionDate

number

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

number

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

number

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

string (int64 format)

Łą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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

number

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

number

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

number

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

number

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 value can be only one of the following:
  "booleanValue": boolean,
  "int64Value": string,
  "floatValue": number,
  "doubleValue": number,
  "stringValue": string
  // End of list of possible types for union field value.
}
Pola
Pole sumy value. Wartość. value może mieć tylko jedną z tych wartości:
booleanValue

boolean

Wartość logiczna.

int64Value

string (int64 format)

Int64.

floatValue

number

Płytka.

doubleValue

number

Podwójna szansa.

stringValue

string

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 (AdNetworkType),
  "conversionActionCategory": enum (ConversionActionCategory),
  "conversionCustomDimensions": [
    {
      object (Value)
    }
  ],
  "dayOfWeek": enum (DayOfWeek),
  "device": enum (Device),
  "keyword": {
    object (Keyword)
  },
  "productChannel": enum (ProductChannel),
  "productChannelExclusivity": enum (ProductChannelExclusivity),
  "productCondition": enum (ProductCondition),
  "productSoldCondition": enum (ProductCondition),
  "rawEventConversionDimensions": [
    {
      object (Value)
    }
  ],
  "conversionAction": string,
  "conversionActionName": string,
  "date": string,
  "geoTargetCity": string,
  "geoTargetCountry": string,
  "geoTargetMetro": string,
  "geoTargetRegion": string,
  "hour": integer,
  "month": string,
  "productBiddingCategoryLevel1": string,
  "productBiddingCategoryLevel2": string,
  "productBiddingCategoryLevel3": string,
  "productBiddingCategoryLevel4": string,
  "productBiddingCategoryLevel5": string,
  "productBrand": string,
  "productCountry": string,
  "productCustomAttribute0": string,
  "productCustomAttribute1": string,
  "productCustomAttribute2": string,
  "productCustomAttribute3": string,
  "productCustomAttribute4": string,
  "productItemId": string,
  "productLanguage": string,
  "productSoldBiddingCategoryLevel1": string,
  "productSoldBiddingCategoryLevel2": string,
  "productSoldBiddingCategoryLevel3": string,
  "productSoldBiddingCategoryLevel4": string,
  "productSoldBiddingCategoryLevel5": string,
  "productSoldBrand": string,
  "productSoldCustomAttribute0": string,
  "productSoldCustomAttribute1": string,
  "productSoldCustomAttribute2": string,
  "productSoldCustomAttribute3": string,
  "productSoldCustomAttribute4": string,
  "productSoldItemId": string,
  "productSoldTitle": string,
  "productSoldTypeL1": string,
  "productSoldTypeL2": string,
  "productSoldTypeL3": string,
  "productSoldTypeL4": string,
  "productSoldTypeL5": string,
  "productStoreId": string,
  "productTitle": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "quarter": string,
  "week": string,
  "year": integer,
  "assetInteractionTarget": {
    object (AssetInteractionTarget)
  }
}
Pola
adNetworkType

enum (AdNetworkType)

Typ sieci reklamowej.

conversionActionCategory

enum (ConversionActionCategory)

Kategoria działania powodującego konwersję.

conversionCustomDimensions[]

object (Value)

Wymiary niestandardowe konwersji.

dayOfWeek

enum (DayOfWeek)

Dzień tygodnia, np. MONDAY.

device

enum (Device)

Urządzenie, do którego mają zastosowanie dane.

keyword

object (Keyword)

Kryterium słowa kluczowego.

productChannel

enum (ProductChannel)

Kanał produktu.

productChannelExclusivity

enum (ProductChannelExclusivity)

Wyłączność kanału produktu.

productCondition

enum (ProductCondition)

Stan produktu.

productSoldCondition

enum (ProductCondition)

Stan sprzedawanego produktu.

rawEventConversionDimensions[]

object (Value)

Nieprzetworzone wymiary konwersji zdarzenia.

conversionAction

string

Nazwa zasobu działania powodującego konwersję.

conversionActionName

string

Nazwa działania powodującego konwersję.

date

string

Data, do której mają zastosowanie dane. format rrrr-MM-dd, np. 2018-04-17.

geoTargetCity

string

Nazwa zasobu ze stałą kierowania geograficznego, która reprezentuje miasto.

geoTargetCountry

string

Nazwa zasobu stałej kierowania geograficznego, która reprezentuje kraj.

geoTargetMetro

string

Nazwa zasobu ze stałą kierowania geograficznego, która reprezentuje obszar miejski.

geoTargetRegion

string

Nazwa zasobu stałej kierowania geograficznego, która reprezentuje region.

hour

integer

Pora dnia jako liczba od 0 do 23 włącznie.

month

string

Miesiąc przedstawiony jako dzień pierwszego dnia miesiąca. W formacie rrrr-MM-dd.

productBiddingCategoryLevel1

string

Kategoria ustalania stawek (poziom 1) produktu.

productBiddingCategoryLevel2

string

Kategoria ustalania stawek (poziom 2) produktu.

productBiddingCategoryLevel3

string

Kategoria ustalania stawek (poziom 3) produktu.

productBiddingCategoryLevel4

string

Kategoria ustalania stawek (poziom 4) produktu.

productBiddingCategoryLevel5

string

Kategoria ustalania stawek (poziom 5) produktu.

productBrand

string

Marka produktu.

productCountry

string

Nazwa zasobu stałej kierowania geograficznego dla kraju sprzedaży produktu.

productCustomAttribute0

string

Atrybut niestandardowy 0 produktu.

productCustomAttribute1

string

Atrybut niestandardowy 1 produktu.

productCustomAttribute2

string

Atrybut niestandardowy 2 produktu.

productCustomAttribute3

string

Atrybut niestandardowy 3 produktu.

productCustomAttribute4

string

Atrybut niestandardowy 4 produktu.

productItemId

string

Identyfikator produktu.

productLanguage

string

Nazwa zasobu stałej języka dla języka produktu.

productSoldBiddingCategoryLevel1

string

Kategoria ustalania stawek (poziom 1) sprzedanego produktu.

productSoldBiddingCategoryLevel2

string

Kategoria ustalania stawek (poziom 2) sprzedanego produktu.

productSoldBiddingCategoryLevel3

string

Kategoria ustalania stawek (poziom 3) sprzedanego produktu.

productSoldBiddingCategoryLevel4

string

Kategoria ustalania stawek (poziom 4) sprzedanego produktu.

productSoldBiddingCategoryLevel5

string

Kategoria ustalania stawek (poziom 5) sprzedanego produktu.

productSoldBrand

string

Marka sprzedawanego produktu.

productSoldCustomAttribute0

string

Atrybut niestandardowy 0 sprzedanego produktu.

productSoldCustomAttribute1

string

Atrybut niestandardowy 1 sprzedanego produktu.

productSoldCustomAttribute2

string

Atrybut niestandardowy 2 sprzedanego produktu.

productSoldCustomAttribute3

string

Atrybut niestandardowy 3 sprzedanego produktu.

productSoldCustomAttribute4

string

Atrybut niestandardowy 4 sprzedanego produktu.

productSoldItemId

string

Identyfikator sprzedanego produktu.

productSoldTitle

string

Tytuł sprzedanego produktu.

productSoldTypeL1

string

Typ (poziom 1) sprzedanego produktu.

productSoldTypeL2

string

Typ (poziom 2) sprzedanego produktu.

productSoldTypeL3

string

Typ (poziom 3) sprzedanego produktu.

productSoldTypeL4

string

Typ (poziom 4) sprzedanego produktu.

productSoldTypeL5

string

Typ (poziom 5) sprzedanego produktu.

productStoreId

string

Identyfikator sklepu produktu.

productTitle

string

Tytuł produktu.

productTypeL1

string

Typ (poziom 1) produktu.

productTypeL2

string

Typ (poziom 2) produktu.

productTypeL3

string

Typ (poziom 3) produktu.

productTypeL4

string

Typ (poziom 4) produktu.

productTypeL5

string

Typ (poziom 5) produktu.

quarter

string

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

string

Tydzień zgodnie z definicją od poniedziałku do niedzieli, oznaczony datą z poniedziałku. W formacie rrrr-MM-dd.

year

integer

Rok w formacie rrrr.

assetInteractionTarget

object (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_WATCH Filmy w YouTube
MIXED Wszystkie sieci.

Słowo kluczowe

Segment kryterium słowa kluczowego.

Zapis JSON
{
  "info": {
    object (KeywordInfo)
  },
  "adGroupCriterion": string
}
Pola
info

object (KeywordInfo)

Informacje o słowie kluczowym.

adGroupCriterion

string

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

string

Nazwa zasobu zasobu.

interactionOnThisAsset

boolean

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.