AdGroupCriterion

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

Zapis JSON 
{
  "resourceName": string,
  "displayName": string,
  "status": enum (AdGroupCriterionStatus),
  "qualityInfo": {
    object (QualityInfo)
  },
  "type": enum (CriterionType),
  "systemServingStatus": enum (CriterionSystemServingStatus),
  "approvalStatus": enum (AdGroupCriterionApprovalStatus),
  "disapprovalReasons": [
    string
  ],
  "labels": [
    string
  ],
  "effectiveCpcBidSource": enum (BiddingSource),
  "effectiveCpmBidSource": enum (BiddingSource),
  "effectiveCpvBidSource": enum (BiddingSource),
  "effectivePercentCpcBidSource": enum (BiddingSource),
  "positionEstimates": {
    object (PositionEstimates)
  },
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "criterionId": string,
  "adGroup": string,
  "negative": boolean,
  "bidModifier": number,
  "cpcBidMicros": string,
  "cpmBidMicros": string,
  "cpvBidMicros": string,
  "percentCpcBidMicros": string,
  "effectiveCpcBidMicros": string,
  "effectiveCpmBidMicros": string,
  "effectiveCpvBidMicros": string,
  "effectivePercentCpcBidMicros": string,
  "finalUrlSuffix": string,
  "trackingUrlTemplate": string,

  // Union field criterion can be only one of the following:
  "keyword": {
    object (KeywordInfo)
  },
  "placement": {
    object (PlacementInfo)
  },
  "mobileAppCategory": {
    object (MobileAppCategoryInfo)
  },
  "mobileApplication": {
    object (MobileApplicationInfo)
  },
  "listingGroup": {
    object (ListingGroupInfo)
  },
  "ageRange": {
    object (AgeRangeInfo)
  },
  "gender": {
    object (GenderInfo)
  },
  "incomeRange": {
    object (IncomeRangeInfo)
  },
  "parentalStatus": {
    object (ParentalStatusInfo)
  },
  "userList": {
    object (UserListInfo)
  },
  "youtubeVideo": {
    object (YouTubeVideoInfo)
  },
  "youtubeChannel": {
    object (YouTubeChannelInfo)
  },
  "topic": {
    object (TopicInfo)
  },
  "userInterest": {
    object (UserInterestInfo)
  },
  "webpage": {
    object (WebpageInfo)
  },
  "appPaymentModel": {
    object (AppPaymentModelInfo)
  },
  "customAffinity": {
    object (CustomAffinityInfo)
  },
  "customIntent": {
    object (CustomIntentInfo)
  },
  "customAudience": {
    object (CustomAudienceInfo)
  },
  "combinedAudience": {
    object (CombinedAudienceInfo)
  },
  "audience": {
    object (AudienceInfo)
  },
  "location": {
    object (LocationInfo)
  },
  "language": {
    object (LanguageInfo)
  }
  // End of list of possible types for union field criterion.
}
Pola
resourceName

string

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

customers/{customerId}/adGroupCriteria/{adGroupId}~{criterionId}
displayName

string

Tylko dane wyjściowe. Wyświetlana nazwa kryterium.

To pole jest ignorowane w przypadku mutacji.
status

enum (AdGroupCriterionStatus)

Stan kryterium.

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

object (QualityInfo)

Tylko dane wyjściowe. Informacje o jakości kryterium.
type

enum (CriterionType)

Tylko dane wyjściowe. Rodzaj kryterium.
systemServingStatus

enum (CriterionSystemServingStatus)

Tylko dane wyjściowe. Stan wyświetlania kryterium.
approvalStatus

enum (AdGroupCriterionApprovalStatus)

Tylko dane wyjściowe. Stan zatwierdzenia kryterium.
disapprovalReasons[]

string

Tylko dane wyjściowe. Lista powodów odrzucenia kryterium.

Informacje o różnych powodach odrzucenia kryterium znajdziesz tutaj: https://support.google.com/adspolicy/answer/6008942

To pole jest tylko do odczytu.
labels[]

string

Tylko dane wyjściowe. Nazwy zasobów etykiet dołączonych do tego kryterium grupy reklam.
effectiveCpcBidSource

enum (BiddingSource)

Tylko dane wyjściowe. Źródło efektywnej stawki CPC.
effectiveCpmBidSource

enum (BiddingSource)

Tylko dane wyjściowe. Źródło efektywnej stawki CPM.
effectiveCpvBidSource

enum (BiddingSource)

Tylko dane wyjściowe. Źródło efektywnej stawki CPV.
effectivePercentCpcBidSource

enum (BiddingSource)

Tylko dane wyjściowe. Źródło efektywnej procentowej stawki CPC.
positionEstimates

object (PositionEstimates)

Tylko dane wyjściowe. Szacunki dla stawek dla różnych kryteriów na różnych pozycjach.
finalUrls[]

string

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

string

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

object (CustomParameter)

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

string (int64 format)

Tylko dane wyjściowe. Identyfikator kryterium.

To pole jest ignorowane w przypadku mutacji.
adGroup

string

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

boolean

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

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

number

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

string (int64 format)

Stawka CPC (kosztu kliknięcia).
cpmBidMicros

string (int64 format)

Stawka CPM (koszt tysiąca widocznych wyświetleń).
cpvBidMicros

string (int64 format)

Stawka CPV (koszt obejrzenia).
percentCpcBidMicros

string (int64 format)

Kwota stawki CPC wyrażona jako ułamek reklamowanej ceny za towar lub usługę. Prawidłowy zakres tego ułamka to [0,1), a przechowywana tutaj wartość to 1 000 000 * [ułamek].
effectiveCpcBidMicros

string (int64 format)

Tylko dane wyjściowe. Efektywna stawka CPC (koszt kliknięcia).
effectiveCpmBidMicros

string (int64 format)

Tylko dane wyjściowe. Efektywna stawka CPM (koszt tysiąca widocznych wyświetleń).
effectiveCpvBidMicros

string (int64 format)

Tylko dane wyjściowe. Efektywna stawka CPV (koszt obejrzenia).
effectivePercentCpcBidMicros

string (int64 format)

Tylko dane wyjściowe. Efektywna kwota procentowej stawki CPC.
finalUrlSuffix

string

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

string

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

Pole sumy criterion. Kryterium grupy reklam.

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

object (KeywordInfo)

Stałe. Słowo kluczowe.
placement

object (PlacementInfo)

Stałe. Umiejscowienie.
mobileAppCategory

object (MobileAppCategoryInfo)

Stałe. Kategoria aplikacji mobilnej.
mobileApplication

object (MobileApplicationInfo)

Stałe. Aplikacja mobilna.
listingGroup

object (ListingGroupInfo)

Stałe. Grupa informacji o produktach.
ageRange

object (AgeRangeInfo)

Stałe. Przedział wiekowy.
gender

object (GenderInfo)

Stałe. Płeć.
incomeRange

object (IncomeRangeInfo)

Stałe. Zakres przychodu.
parentalStatus

object (ParentalStatusInfo)

Stałe. Status rodzicielski.
userList

object (UserListInfo)

Stałe. Lista użytkowników.
youtubeVideo

object (YouTubeVideoInfo)

Stałe. Film w YouTube.
youtubeChannel

object (YouTubeChannelInfo)

Stałe. Kanał w YouTube.
topic

object (TopicInfo)

Stałe. Temat.
userInterest

object (UserInterestInfo)

Stałe. Zainteresowania użytkownika.
webpage

object (WebpageInfo)

Stałe. Strona internetowa
appPaymentModel

object (AppPaymentModelInfo)

Stałe. Model płatności za aplikację.
customAffinity

object (CustomAffinityInfo)

Stałe. Niestandardowe podobieństwo.
customIntent

object (CustomIntentInfo)

Stałe. Niestandardowi odbiorcy o podobnych zamiarach.
customAudience

object (CustomAudienceInfo)

Stałe. Niestandardowa lista odbiorców.
combinedAudience

object (CombinedAudienceInfo)

Stałe. Odbiorcy z połączonych list.
audience

object (AudienceInfo)

Stałe. Odbiorcy.
location

object (LocationInfo)

Stałe. Lokalizacja.
language

object (LanguageInfo)

Stałe. Językiem

AdGroupCriterionStatus

Możliwe stany kryterium grupy reklam.

Wartości w polu enum
UNSPECIFIED Nie określono wartości.
UNKNOWN

Otrzymana wartość nie jest znana w tej wersji.

To jest wartość tylko z odpowiedzią.
ENABLED Kryterium w grupie reklam jest włączone.
PAUSED Kryterium w grupie reklam jest wstrzymane.
REMOVED Kryterium w grupie reklam zostało usunięte.

QualityInfo

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

Zapis JSON 
{
  "creativeQualityScore": enum (QualityScoreBucket),
  "postClickQualityScore": enum (QualityScoreBucket),
  "searchPredictedCtr": enum (QualityScoreBucket),
  "qualityScore": integer
}
Pola
creativeQualityScore

enum (QualityScoreBucket)

Tylko dane wyjściowe. Skuteczność reklamy w porównaniu z innymi reklamodawcami.
postClickQualityScore

enum (QualityScoreBucket)

Tylko dane wyjściowe. Wynik jakości strony docelowej.
searchPredictedCtr

enum (QualityScoreBucket)

Tylko dane wyjściowe. Współczynnik klikalności w porównaniu ze współczynnikiem innych reklamodawców.
qualityScore

integer

Tylko dane wyjściowe. Wynik jakości.

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

CriterionSystemServingStatus

Liczy stany obsługi kryteriów w systemie.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Wartość jest nieznana w tej wersji.
ELIGIBLE Odpowiednia.
RARELY_SERVED Mała liczba wyszukiwań.

AdGroupCriterionApprovalStatus

Wylicza stany zatwierdzenia Grupy reklam.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Wartość jest nieznana w tej wersji.
APPROVED Zatwierdzony.
DISAPPROVED Odrzucony.
PENDING_REVIEW Oczekuje na sprawdzenie.
UNDER_REVIEW W trakcie sprawdzania.

PositionEstimates

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

Zapis JSON 
{
  "firstPageCpcMicros": string,
  "firstPositionCpcMicros": string,
  "topOfPageCpcMicros": string,
  "estimatedAddClicksAtFirstPositionCpc": string,
  "estimatedAddCostAtFirstPositionCpc": string
}
Pola
firstPageCpcMicros

string (int64 format)

Tylko dane wyjściowe. Szacunkowa stawka CPC wymagana do wyświetlenia reklamy na pierwszej stronie wyników wyszukiwania.
firstPositionCpcMicros

string (int64 format)

Tylko dane wyjściowe. Szacunkowa stawka CPC wymagana do wyświetlenia reklamy na pierwszej pozycji u góry pierwszej strony wyników wyszukiwania.
topOfPageCpcMicros

string (int64 format)

Tylko dane wyjściowe. Szacunkowa stawka CPC wymagana do wyświetlenia reklamy na górze pierwszej strony wyników wyszukiwania.
estimatedAddClicksAtFirstPositionCpc

string (int64 format)

Tylko dane wyjściowe. Oszacuj, ile kliknięć tygodniowo możesz uzyskać, zmieniając stawkę za słowo kluczowe na wartość firstPositionCpcMicros.
estimatedAddCostAtFirstPositionCpc

string (int64 format)

Tylko dane wyjściowe. Szacunkowy tygodniowy koszt, który może zmienić się po zmianie stawki za słowo kluczowe na wartość z kolumny firstPositionCpcMicros.

ListingGroupInfo

Kryterium grupy informacji o produktach.

Zapis JSON 
{
  "type": enum (ListingGroupType),
  "caseValue": {
    object (ListingDimensionInfo)
  },
  "parentAdGroupCriterion": string,
  "path": {
    object (ListingDimensionPath)
  }
}
Pola
type

enum (ListingGroupType)

Typ grupy informacji o produktach.
caseValue

object (ListingDimensionInfo)

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

string

Nazwa zasobu kryterium grupy reklam, które jest nadrzędnym podziałem w grupie informacji o produktach. Wartość null w przypadku grupy głównej.
path

object (ListingDimensionPath)

Ścieżka wymiarów określających tę grupę informacji o produktach.

ListingGroupType

Typ grupy informacji o produktach.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
SUBDIVISION Podział produktów według niektórych wymiarów informacji o produkcie. Te węzły nie są używane do kierowania na wpisy z listą, ale służą tylko do definiowania struktury drzewa.
UNIT Jednostka grupy informacji o produktach określająca stawkę.

ListingDimensionPath

Ścieżka wymiarów określających grupę informacji o produktach.

Zapis JSON 
{
  "dimensions": [
    {
      object (ListingDimensionInfo)
    }
  ]
}
Pola
dimensions[]

object (ListingDimensionInfo)

Pełna ścieżka wymiarów w hierarchii grup informacji o produktach, od elementu głównego (z wyłączeniem jednostki głównej) do danej grupy informacji o produktach.

AppPaymentModelInfo

Kryterium modelu płatności za aplikację.

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

enum (AppPaymentModelType)

Typ modelu płatności za aplikację.

AppPaymentModelType

Wartość Enum opisująca możliwe modele płatności za aplikacje.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
PAID Reprezentuje płatne aplikacje.

CustomIntentInfo

Niestandardowe kryterium odbiorców o podobnych zamiarach. Kryterium tego typu można kierować tylko na kryterium tego typu.

Zapis JSON 
{
  "customIntent": string
}
Pola
customIntent

string

Nazwa zasobu CustomInterest.