AdGroupCriterion

Bir reklam grubu ölçütü. adGroupCriterion raporu yalnızca açıkça reklam grubuna eklenen ölçütleri döndürür.

JSON gösterimi 
{
  "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.
}
Alanlar
resourceName

string

Sabit. Reklam grubu ölçütünün kaynak adı. Reklam grubu ölçütü kaynak adları şu biçimdedir:

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

string

Yalnızca çıkış. Ölçütün görünen adı.

Bu alan, değişiklikler için yoksayılır.
status

enum (AdGroupCriterionStatus)

Ölçütün durumu.

Bu, reklam grubu ölçütü varlığının müşteri tarafından ayarlanan durumudur. Not: Kullanıcı arayüzü raporları, bir ölçütün çalıştırılmaya uygun olup olmadığını etkileyen ek bilgiler içerebilir. Bazı durumlarda, API'da KALDIRILDIĞI bir ölçüt, kullanıcı arayüzünde etkin olarak görünmeye devam edebilir. Örneğin, kampanyalar hariç tutulmadıkça varsayılan olarak tüm yaş aralıklarındaki kullanıcılara gösterilir. Kullanıcı arayüzü, reklamları görmeye uygun olduğu için her bir yaş aralığını "etkin" olarak gösterir; ancak herhangi bir pozitif ölçüt eklenmediği için AdGroupCriterion.status "kaldırıldı" değerini gösterir.
qualityInfo

object (QualityInfo)

Yalnızca çıkış. Ölçütün kalitesi hakkında bilgi.
type

enum (CriterionType)

Yalnızca çıkış. Ölçütün türü.
systemServingStatus

enum (CriterionSystemServingStatus)

Yalnızca çıkış. Ölçütün yayınlanma durumu.
approvalStatus

enum (AdGroupCriterionApprovalStatus)

Yalnızca çıkış. Ölçüt onay durumu.
disapprovalReasons[]

string

Yalnızca çıkış. Ölçütün onaylanmama nedenlerinin listesi.

Bir ölçütün reddedilmesinin farklı nedenlerini şu adreste bulabilirsiniz: https://support.google.com/adspolicy/answer/6008942

Bu alan salt okunurdur.
labels[]

string

Yalnızca çıkış. Bu reklam grubu ölçütüne ekli etiketlerin kaynak adları.
effectiveCpcBidSource

enum (BiddingSource)

Yalnızca çıkış. Etkili TBM teklifinin kaynağı.
effectiveCpmBidSource

enum (BiddingSource)

Yalnızca çıkış. Etkin BGBM teklifinin kaynağı.
effectiveCpvBidSource

enum (BiddingSource)

Yalnızca çıkış. Etkili GBM teklifinin kaynağı.
effectivePercentCpcBidSource

enum (BiddingSource)

Yalnızca çıkış. Geçerli TBM teklifi yüzdesinin kaynağı.
positionEstimates

object (PositionEstimates)

Yalnızca çıkış. Çeşitli konumlardaki ölçüt teklifleri için tahminler.
finalUrls[]

string

Reklama ilişkin tüm alanlar arası yönlendirmelerden sonraki olası nihai URL'lerin listesi.
finalMobileUrls[]

string

Tüm alanlar arası yönlendirmelerden sonraki olası mobil nihai URL'lerin listesi.
urlCustomParameters[]

object (CustomParameter)

trackingUrlTemplate, finalUrls veya mobile_final_urls içinde özel parametre etiketlerini değiştirmek için kullanılan eşleme listesi.
criterionId

string (int64 format)

Yalnızca çıkış. Ölçüt kimliği.

Bu alan, değişiklikler için yoksayılır.
adGroup

string

Sabit. Ölçütün ait olduğu reklam grubu.
negative

boolean

Sabit. Ölçütün hedeflenip hedeflenmeyeceğini (false) veya hariç tutulacağını (true) belirtir.

Bu alan sabittir. Bir ölçütü pozitiften negatife geçirmek için ölçütü kaldırıp yeniden ekleyin.
bidModifier

number

Ölçüt eşleştiğinde teklif değiştiricisi. Değiştirici şu aralıkta olmalıdır: 0,1 - 10,0. Hedeflenebilir ölçüt türlerinin çoğu değiştiricileri destekler.
cpcBidMicros

string (int64 format)

TBM (tıklama başına maliyet) teklifi.
cpmBidMicros

string (int64 format)

BGBM (görüntülenebilir bin gösterim başına maliyet) teklifi.
cpvBidMicros

string (int64 format)

GBM (görüntüleme başına maliyet) teklifi.
percentCpcBidMicros

string (int64 format)

Bir ürün veya hizmet için reklamı yapılan fiyatın kesirli olarak ifade edilen TBM teklifi tutarı. Kesir için geçerli aralık [0,1) ve burada depolanan değer 1.000.000 * [fraction]'dır.
effectiveCpcBidMicros

string (int64 format)

Yalnızca çıkış. Geçerli TBM (tıklama başına maliyet) teklifi.
effectiveCpmBidMicros

string (int64 format)

Yalnızca çıkış. Etkin BGBM (görüntülenebilir bin gösterim başına maliyet) teklifi.
effectiveCpvBidMicros

string (int64 format)

Yalnızca çıkış. Geçerli GBM (görüntüleme başına maliyet) teklifi.
effectivePercentCpcBidMicros

string (int64 format)

Yalnızca çıkış. Geçerli TBM teklifi yüzdesi.
finalUrlSuffix

string

Parametreleri nihai URL'ye eklemek için URL şablonu.
trackingUrlTemplate

string

İzleme URL'si oluşturmaya yönelik URL şablonu.

Birleştirme alanı criterion. Reklam grubu ölçütü.

Tam olarak bir tane ayarlanmalıdır. criterion şunlardan yalnızca biri olabilir:
keyword

object (KeywordInfo)

Sabit. Anahtar kelime.
placement

object (PlacementInfo)

Sabit. Yerleşim.
mobileAppCategory

object (MobileAppCategoryInfo)

Sabit. Mobil uygulama kategorisi.
mobileApplication

object (MobileApplicationInfo)

Sabit. Mobil uygulama.
listingGroup

object (ListingGroupInfo)

Sabit. Giriş grubu.
ageRange

object (AgeRangeInfo)

Sabit. Yaş grubu.
gender

object (GenderInfo)

Sabit. Cinsiyet.
incomeRange

object (IncomeRangeInfo)

Sabit. Gelir aralığı.
parentalStatus

object (ParentalStatusInfo)

Sabit. Ebeveynlik durumu.
userList

object (UserListInfo)

Sabit. Kullanıcı Listesi.
youtubeVideo

object (YouTubeVideoInfo)

Sabit. YouTube Videosu.
youtubeChannel

object (YouTubeChannelInfo)

Sabit. YouTube Kanalı.
topic

object (TopicInfo)

Sabit. Konu.
userInterest

object (UserInterestInfo)

Sabit. Kullanıcı İlgi Alanı.
webpage

object (WebpageInfo)

Sabit. Web Sayfası
appPaymentModel

object (AppPaymentModelInfo)

Sabit. Uygulama Ödeme Modeli.
customAffinity

object (CustomAffinityInfo)

Sabit. Özel Yakın İlgi Alanı.
customIntent

object (CustomIntentInfo)

Sabit. Özel Amaç.
customAudience

object (CustomAudienceInfo)

Sabit. Özel Kitle'yi tıklayın.
combinedAudience

object (CombinedAudienceInfo)

Sabit. Birleşik Kitle.
audience

object (AudienceInfo)

Sabit. Kitle'yi tıklayın.
location

object (LocationInfo)

Sabit. Konum'a dokunun.
language

object (LanguageInfo)

Sabit. Dil.

AdGroupCriterionStatus

Bir AdGroupCriterion öğesinin olası durumları.

Sıralamalar
UNSPECIFIED Değer belirtilmedi.
UNKNOWN

Alınan değer bu sürümde bilinmiyor.

Bu yalnızca yanıt odaklı bir değerdir.
ENABLED Reklam grubu ölçütü etkinleştirildi.
PAUSED Reklam grubu ölçütü duraklatıldı.
REMOVED Reklam grubu ölçütü kaldırılır.

QualityInfo

Reklam grubu ölçütü kalite bilgilerinin kapsayıcısıdır.

JSON gösterimi 
{
  "creativeQualityScore": enum (QualityScoreBucket),
  "postClickQualityScore": enum (QualityScoreBucket),
  "searchPredictedCtr": enum (QualityScoreBucket),
  "qualityScore": integer
}
Alanlar
creativeQualityScore

enum (QualityScoreBucket)

Yalnızca çıkış. Reklamın diğer reklamverenlere kıyasla performansı.
postClickQualityScore

enum (QualityScoreBucket)

Yalnızca çıkış. Açılış sayfasının kalite puanı.
searchPredictedCtr

enum (QualityScoreBucket)

Yalnızca çıkış. Diğer reklamverenlere kıyasla tıklama oranı.
qualityScore

integer

Yalnızca çıkış. Kalite puanı.

Google bir değeri belirlemek için yeterli bilgiye sahip değilse bu alan doldurulmayabilir.

CriterionSystemServingStatus

Ölçüt sistemi sunma durumlarını sıralar.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Değer, bu sürümde bilinmiyor.
ELIGIBLE Uygun.
RARELY_SERVED Düşük arama hacmi.

AdGroupCriterionApprovalStatus

AdGroupCriterion onay durumlarını sıralar.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Değer, bu sürümde bilinmiyor.
APPROVED Onaylandı.
DISAPPROVED Onaylanmadı.
PENDING_REVIEW İncelenmeyi Bekliyor.
UNDER_REVIEW İnceleniyor.

PositionEstimates

Çeşitli konumlardaki ölçüt teklifleri için tahminler.

JSON gösterimi 
{
  "firstPageCpcMicros": string,
  "firstPositionCpcMicros": string,
  "topOfPageCpcMicros": string,
  "estimatedAddClicksAtFirstPositionCpc": string,
  "estimatedAddCostAtFirstPositionCpc": string
}
Alanlar
firstPageCpcMicros

string (int64 format)

Yalnızca çıkış. Reklamın, arama sonuçlarının ilk sayfasında gösterilmesi için gereken TBM teklifi tahminidir.
firstPositionCpcMicros

string (int64 format)

Yalnızca çıkış. Reklamın, arama sonuçlarının ilk sayfasının üst kısmında, ilk konumda gösterilmesi için gereken TBM teklifi tahminidir.
topOfPageCpcMicros

string (int64 format)

Yalnızca çıkış. Reklamın, arama sonuçlarının ilk sayfasının üst kısmında gösterilmesi için gereken TBM teklifi tahminidir.
estimatedAddClicksAtFirstPositionCpc

string (int64 format)

Yalnızca çıkış. Anahtar kelime teklifinizi firstPositionCpcMicros'taki değerle değiştirerek haftada kaç tıklama alabileceğinizi tahmin edin.
estimatedAddCostAtFirstPositionCpc

string (int64 format)

Yalnızca çıkış. Anahtar kelime teklifinizi firstPositionCpcMicros değeriyle değiştirdiğinizde haftalık maliyetinizin nasıl değişebileceğine dair tahmin.

ListingGroupInfo

Listeleme grubu ölçütü.

JSON gösterimi 
{
  "type": enum (ListingGroupType),
  "caseValue": {
    object (ListingDimensionInfo)
  },
  "parentAdGroupCriterion": string,
  "path": {
    object (ListingDimensionPath)
  }
}
Alanlar
type

enum (ListingGroupType)

Listeleme grubunun türü.
caseValue

object (ListingDimensionInfo)

Bu listeleme grubunun üst öğesini hassaslaştırdığı boyut değeri. Kök grup için tanımlanmadı.
parentAdGroupCriterion

string

Üst listeleme grubu alt bölümü olan reklam grubu ölçütünün kaynak adı. Kök grup için null (boş).
path

object (ListingDimensionPath)

Bu listeleme grubunu tanımlayan boyutların yolu.

ListingGroupType

Listeleme grubunun türü.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca döndürülen değer için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
SUBDIVISION Bazı listeleme boyutları boyunca ürünlerin alt bölümü. Bu düğümler, listeleme girişlerini hedeflemek için sunum yapılarak kullanılmaz; yalnızca ağacın yapısını tanımlamak için kullanılır.
UNIT Bir teklifi tanımlayan listeleme grubu birimi.

ListingDimensionPath

Bir listeleme grubunu tanımlayan boyutların yolu.

JSON gösterimi 
{
  "dimensions": [
    {
      object (ListingDimensionInfo)
    }
  ]
}
Alanlar
dimensions[]

object (ListingDimensionInfo)

Kökten (kökün kendisi hariç) bu listeleme grubuna kadar listeleme grubu hiyerarşisinde boyutların tam yolu.

AppPaymentModelInfo

Uygulama ödeme modeli ölçütü.

JSON gösterimi 
{
  "type": enum (AppPaymentModelType)
}
Alanlar
type

enum (AppPaymentModelType)

Uygulama ödeme modelinin türü.

AppPaymentModelType

Olası uygulama ödeme modellerini açıklayan enum.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca döndürülen değer için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
PAID Ücretli uygulamaları temsil eder.

CustomIntentInfo

Özel amaç ölçütü. Bu türdeki bir ölçüt yalnızca hedeflenebilir.

JSON gösterimi 
{
  "customIntent": string
}
Alanlar
customIntent

string

Custominterest kaynağının adı.