SearchAds360Row

Sorgudan döndürülen bir satır.

JSON gösterimi
{
  "adGroup": {
    object (AdGroup)
  },
  "adGroupAd": {
    object (AdGroupAd)
  },
  "adGroupAdEffectiveLabel": {
    object (AdGroupAdEffectiveLabel)
  },
  "adGroupAdLabel": {
    object (AdGroupAdLabel)
  },
  "adGroupAsset": {
    object (AdGroupAsset)
  },
  "adGroupAssetSet": {
    object (AdGroupAssetSet)
  },
  "adGroupAudienceView": {
    object (AdGroupAudienceView)
  },
  "adGroupBidModifier": {
    object (AdGroupBidModifier)
  },
  "adGroupCriterion": {
    object (AdGroupCriterion)
  },
  "adGroupCriterionEffectiveLabel": {
    object (AdGroupCriterionEffectiveLabel)
  },
  "adGroupCriterionLabel": {
    object (AdGroupCriterionLabel)
  },
  "adGroupEffectiveLabel": {
    object (AdGroupEffectiveLabel)
  },
  "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)
  },
  "campaignEffectiveLabel": {
    object (CampaignEffectiveLabel)
  },
  "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)
  },
  "userLocationView": {
    object (UserLocationView)
  },
  "webpageView": {
    object (WebpageView)
  },
  "visit": {
    object (Visit)
  },
  "conversion": {
    object (Conversion)
  },
  "metrics": {
    object (Metrics)
  },
  "segments": {
    object (Segments)
  },
  "customColumns": [
    {
      object (Value)
    }
  ]
}
Alanlar
adGroup

object (AdGroup)

Sorguda referans verilen reklam grubu.

adGroupAd

object (AdGroupAd)

Sorguda referans verilen reklam.

adGroupAdEffectiveLabel

object (AdGroupAdEffectiveLabel)

Sorguda referans verilen reklam grubu reklamı etkin etiketi.

adGroupAdLabel

object (AdGroupAdLabel)

Sorguda referans verilen reklam grubu reklam etiketi.

adGroupAsset

object (AdGroupAsset)

Sorguda referans verilen reklam grubu öğesi.

adGroupAssetSet

object (AdGroupAssetSet)

Sorguda referans verilen reklam grubu öğe grubu.

adGroupAudienceView

object (AdGroupAudienceView)

Sorguda referans verilen reklam grubu kitle görünümü.

adGroupBidModifier

object (AdGroupBidModifier)

Sorguda referans verilen teklif değiştirici.

adGroupCriterion

object (AdGroupCriterion)

Sorguda referans verilen ölçüt.

adGroupCriterionEffectiveLabel

object (AdGroupCriterionEffectiveLabel)

Sorguda referans verilen reklam grubu ölçütü etkin etiketi.

adGroupCriterionLabel

object (AdGroupCriterionLabel)

Sorguda referans verilen reklam grubu ölçütü etiketi.

adGroupEffectiveLabel

object (AdGroupEffectiveLabel)

Sorguda referans verilen reklam grubu etkili etiketi.

adGroupLabel

object (AdGroupLabel)

Sorguda referans verilen reklam grubu etiketi.

ageRangeView

object (AgeRangeView)

Sorguda referans verilen yaş aralığı görünümü.

asset

object (Asset)

Sorguda referans verilen öğe.

assetGroupAsset

object (AssetGroupAsset)

Sorguda referans verilen öğe grubu öğesi.

assetGroupSignal

object (AssetGroupSignal)

Sorguda referans verilen öğe grubu sinyali.

assetGroupListingGroupFilter

object (AssetGroupListingGroupFilter)

Sorguda referans verilen öğe grubu listeleme grubu filtresi.

assetGroupTopCombinationView

object (AssetGroupTopCombinationView)

Sorguda referans verilen öğe grubu en iyi kombinasyon görünümü.

assetGroup

object (AssetGroup)

Sorguda referans verilen öğe grubu.

assetSetAsset

object (AssetSetAsset)

Sorguda referans verilen öğe grubu öğesi.

assetSet

object (AssetSet)

Sorguda referans verilen öğe grubu.

biddingStrategy

object (BiddingStrategy)

Sorguda referans verilen teklif stratejisi.

campaignBudget

object (CampaignBudget)

Sorguda referans verilen kampanya bütçesi.

campaign

object (Campaign)

Sorguda referans verilen kampanya.

campaignAsset

object (CampaignAsset)

Sorguda referans verilen kampanya öğesi.

campaignAssetSet

object (CampaignAssetSet)

Sorguda referans verilen kampanya öğe grubu.

campaignAudienceView

object (CampaignAudienceView)

Sorguda referans verilen kampanya kitle görünümü.

campaignCriterion

object (CampaignCriterion)

Sorguda referans verilen kampanya ölçütü.

campaignEffectiveLabel

object (CampaignEffectiveLabel)

Sorguda referans verilen kampanyanın geçerlilik etiketi.

campaignLabel

object (CampaignLabel)

Sorguda referans verilen kampanya etiketi.

cartDataSalesView

object (CartDataSalesView)

Sorguda referans verilen alışveriş sepeti verileri satış görünümü.

audience

object (Audience)

Sorguda referans verilen kitle.

conversionAction

object (ConversionAction)

Sorguda referans verilen dönüşüm işlemi.

conversionCustomVariable

object (ConversionCustomVariable)

Sorguda referans verilen dönüşüm özelleştirilebilen değişkeni.

customer

object (Customer)

Sorguda referans verilen müşteri.

customerAsset

object (CustomerAsset)

Sorguda referans verilen müşteri öğesi.

customerAssetSet

object (CustomerAssetSet)

Sorguda referans verilen müşteri öğesi grubu.

accessibleBiddingStrategy

object (AccessibleBiddingStrategy)

Sorguda referans verilen erişilebilir teklif stratejisi.

customerClient

object (CustomerClient)

Sorguda referans verilen CustomerClient.

dynamicSearchAdsSearchTermView

object (DynamicSearchAdsSearchTermView)

Sorguda referans verilen dinamik arama ağı reklamları arama terimi görünümü.

genderView

object (GenderView)

Sorguda referans verilen cinsiyet görünümü.

geoTargetConstant

object (GeoTargetConstant)

Sorguda referans verilen coğrafi hedef sabiti.

keywordView

object (KeywordView)

Sorguda referans verilen anahtar kelime görünümü.

label

object (Label)

Sorguda referans verilen etiket.

languageConstant

object (LanguageConstant)

Sorguda referans verilen dil sabiti.

locationView

object (LocationView)

Sorguda referans verilen konum görünümü.

productBiddingCategoryConstant

object (ProductBiddingCategoryConstant)

Sorguda referans verilen ürün teklifi kategorisi.

productGroupView

object (ProductGroupView)

Sorguda referans verilen ürün grubu görünümü.

shoppingPerformanceView

object (ShoppingPerformanceView)

Sorguda referans verilen Alışveriş performansı görünümü.

userList

object (UserList)

Sorguda referans verilen kullanıcı listesi.

userLocationView

object (UserLocationView)

Sorguda referans verilen kullanıcı konumu görünümü.

webpageView

object (WebpageView)

Sorguda referans verilen web sayfası görünümü.

visit

object (Visit)

Sorguda referans verilen etkinlik düzeyindeki ziyaret.

conversion

object (Conversion)

Sorguda referans verilen etkinlik düzeyindeki dönüşüm.

metrics

object (Metrics)

Metrikler.

segments

object (Segments)

Segmentler.

customColumns[]

object (Value)

Özel sütunlar.

Reklam Grubu

Bir reklam grubu.

JSON gösterimi
{
  "resourceName": string,
  "status": enum (AdGroupStatus),
  "type": enum (AdGroupType),
  "adRotationMode": enum (AdGroupAdRotationMode),
  "creationTime": string,
  "targetingSetting": {
    object (TargetingSetting)
  },
  "labels": [
    string
  ],
  "effectiveLabels": [
    string
  ],
  "engineId": string,
  "startDate": string,
  "endDate": string,
  "languageCode": string,
  "lastModifiedTime": string,
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "cpcBidMicros": string,
  "engineStatus": enum (AdGroupEngineStatus),
  "finalUrlSuffix": string
}
Alanlar
resourceName

string

Reklam grubunun kaynak adı. Reklam grubu kaynak adları şu biçimdedir:

customers/{customerId}/adGroups/{ad_group_id}

status

enum (AdGroupStatus)

Reklam grubunun durumu.

type

enum (AdGroupType)

Reklam grubunun türü.

adRotationMode

enum (AdGroupAdRotationMode)

Reklam grubunun reklam rotasyonu modu.

creationTime

string

Bu reklam grubunun oluşturulduğu zamanı gösteren zaman damgası. Zaman damgası, müşterinin saat diliminde ve "yyyy-AA-gg SS:dd:ss" biçimindedir.

targetingSetting

object (TargetingSetting)

Hedeflemeyle ilgili özelliklerin ayarı.

labels[]

string

Bu reklam grubuna eklenen etiketlerin kaynak adları.

effectiveLabels[]

string

Bu reklam grubuna eklenen etkili etiketlerin kaynak adları. Etkili bir etiket, bu reklam grubuna devralınan veya doğrudan atanan bir etikettir.

engineId

string

Harici arama motoru hesabındaki reklam grubunun kimliği. Bu alan yalnızca Google Ads dışındaki hesaplar (ör. Yahoo Japan, Microsoft, Baidu vb.) içindir. Google Ads öğesi için bunun yerine "adGroup.id" kullanın.

startDate

string

Bu reklam grubunun reklam yayınlamaya başladığı tarih. Varsayılan olarak reklam grubu hemen veya reklam grubunun başlangıç tarihi (hangisi daha sonra ise) başlar. Bu alan ayarlanırsa reklam grubu, müşterinin saat diliminde belirtilen tarihin başında başlar. Bu alan yalnızca Microsoft Advertising ve Facebook ağ geçidi hesaplarında kullanılabilir.

Biçim: YYYY-AA-GG Örnek: 2019-03-14

endDate

string

Reklam grubunun reklam yayınlamayı durdurduğu tarih. Varsayılan olarak, reklam grubu reklam grubunun bitiş tarihinde sona erer. Bu alan ayarlanırsa reklam grubu, müşterinin saat diliminde belirtilen tarihin sonunda sona erer. Bu alan yalnızca Microsoft Advertising ve Facebook ağ geçidi hesaplarında kullanılabilir.

Biçim: YYYY-AA-GG Örnek: 2019-03-14

languageCode

string

Bir reklam grubundaki reklamların ve anahtar kelimelerin dili. Bu alan yalnızca Microsoft Advertising hesaplarında kullanılabilir. Daha fazla bilgi: https://docs.microsoft.com/en-us/advertising/guides/ad-languages?view=bingads-13#adlanguage

lastModifiedTime

string

Bu reklam grubunun en son değiştirildiği tarih ve saat. Tarih ve saat, müşterinin saat diliminde ve "yyyy-AA-gg SS:dd:ss.ssssss" biçimindedir.

id

string (int64 format)

Reklam grubunun kimliği.

name

string

Reklam grubunun adı.

Bu alan zorunludur ve yeni reklam grupları oluşturulurken boş bırakılmamalıdır.

255'ten az UTF-8 tam genişlikli karakter içermelidir.

Boş (kod noktası 0x0), yeni satır (kod noktası 0xA) veya satır başı karakteri (kod noktası 0xD) içermemelidir.

trackingUrlTemplate

string

İzleme URL'si oluşturmak için kullanılan URL şablonu.

cpcBidMicros

string (int64 format)

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

engineStatus

enum (AdGroupEngineStatus)

Reklam grubunun motor durumu.

finalUrlSuffix

string

Parametreleri nihai URL'ye eklemek için kullanılan URL şablonu.

AdGroupStatus

Bir reklam grubunun olası durumları.

Sıralamalar
UNSPECIFIED Durum belirtilmedi.
UNKNOWN

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

Bu, yalnızca yanıt değeri olan bir özelliktir.

ENABLED Reklam grubu etkinleştirilmiş olmalıdır.
PAUSED Reklam grubu duraklatılmış.
REMOVED Reklam grubu kaldırılır.

AdGroupType

Reklam grubunun olası türlerini listeleyen enum.

Sıralamalar
UNSPECIFIED Tür belirtilmedi.
UNKNOWN

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

Bu, yalnızca yanıt değeri olan bir özelliktir.

SEARCH_STANDARD Arama ağı kampanyaları için varsayılan reklam grubu türü.
DISPLAY_STANDARD Görüntülü Reklam Ağı kampanyaları için varsayılan reklam grubu türü.
SHOPPING_PRODUCT_ADS Standart ürün reklamları yayınlayan Alışveriş kampanyalarının reklam grubu türü.
SHOPPING_SHOWCASE_ADS Alışveriş sonuçlarında yalnızca vitrin veya satıcı reklamlarının yayınlanmasıyla sınırlı olan reklam gruplarının türü.
HOTEL_ADS Otel kampanyaları için varsayılan reklam grubu türü.
SHOPPING_SMART_ADS Akıllı Alışveriş kampanyalarındaki reklam gruplarının türü.
VIDEO_BUMPER Kısa ve atlanamayan yayın içi video reklamlar.
VIDEO_TRUE_VIEW_IN_STREAM Yayın içi (In-stream) TrueView (atlanabilir) video reklamları.
VIDEO_TRUE_VIEW_IN_DISPLAY Görüntülü TrueView (TrueView in-display) video reklamları.
VIDEO_NON_SKIPPABLE_IN_STREAM Atlanamayan yayın içi video reklamlar
VIDEO_OUTSTREAM Yayın dışı video reklamlar
SEARCH_DYNAMIC_ADS Dinamik Arama Ağı Reklamları reklam grupları için reklam grubu türü.
SHOPPING_COMPARISON_LISTING_ADS Alışveriş ürün karşılaştırma reklamı kampanyalarındaki reklam gruplarının türü.
PROMOTED_HOTEL_ADS Tanıtılan otel reklamı gruplarının reklam grubu türü.
VIDEO_RESPONSIVE Video duyarlı reklam grupları
VIDEO_EFFICIENT_REACH Video etkili erişim reklam grupları.
SMART_CAMPAIGN_ADS Akıllı kampanyalar için reklam grubu türü.
TRAVEL_ADS Seyahat kampanyaları için reklam grubu türü.

AdGroupAdRotationMode

Bir reklam grubunun olası reklam rotasyonu modları.

Sıralamalar
UNSPECIFIED Reklam rotasyonu modu belirtilmemiş.
UNKNOWN

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

Bu, yalnızca yanıt değeri olan bir özelliktir.

OPTIMIZE Reklam grubu reklamlarını tıklama veya dönüşüm sayısına göre optimize edin.
ROTATE_FOREVER Sonsuza kadar eşit sıklıkta dönüşümlü yayınla.

AdGroupEngineStatus

Reklam grubu motorunun durumu.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca dönüş değeri için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
AD_GROUP_ELIGIBLE

Kullanımdan kaldırıldı. Kullanmayın.

AD_GROUP_EXPIRED Reklam grubunun bitiş tarihi geçtiğinden bu reklam grubu için reklam yayınlanmıyor.
AD_GROUP_REMOVED Reklam grubu silindi.
AD_GROUP_DRAFT İlişkili reklam grubu henüz taslak halinde olduğundan bu reklam grubu için reklam yayınlanmıyor.
AD_GROUP_PAUSED Reklam grubu duraklatıldı.
AD_GROUP_SERVING Reklam grubu etkin ve şu anda reklam yayınlıyor.
AD_GROUP_SUBMITTED Reklam grubu gönderildi (Microsoft Bing Ads eski durumu).
CAMPAIGN_PAUSED Kampanya duraklatıldığı için bu reklam grubuyla ilgili reklam yayınlanmıyor.
ACCOUNT_PAUSED Hesap duraklatıldığı için bu reklam grubuyla ilgili reklam yayınlanmıyor.

TargetingSetting

Hedeflemeyle ilgili özelliklerin kampanya ve reklam grubu düzeyindeki ayarları. Hedefleme ayarı hakkında daha fazla bilgi için https://support.google.com/google-ads/answer/7365594 adresini ziyaret edin.

JSON gösterimi
{
  "targetRestrictions": [
    {
      object (TargetRestriction)
    }
  ]
}
Alanlar
targetRestrictions[]

object (TargetRestriction)

Kampanyanızın veya reklam grubunuzun erişimini kısıtlamak için hedefleme boyutu başına ayar.

TargetRestriction

Hedefleme boyutu başına hedefleme ayarlarının listesi.

JSON gösterimi
{
  "targetingDimension": enum (TargetingDimension),
  "bidOnly": boolean
}
Alanlar
targetingDimension

enum (TargetingDimension)

Bu ayarların geçerli olduğu hedefleme boyutu.

bidOnly

boolean

Reklamlarınızın yalnızca bu hedefleme boyutu için seçtiğiniz ölçütlere göre gösterilmesini kısıtlayıp kısıtlamayacağınızı veya bu hedefleme boyutu için tüm değerleri hedefleyip diğer hedefleme boyutlarındaki hedeflemenize göre reklam gösterip göstermeyeceğinizi belirtir. true değeri, bu ölçütlerin yalnızca teklif değiştiricileri uygulayacağı ve hedeflemeyi etkilemeyeceği anlamına gelir. false değeri, bu ölçütlerin hedeflemeyi kısıtlayacağı ve teklif değiştiricilerin uygulanacağı anlamına gelir.

TargetingDimension

Olası hedefleme boyutlarını açıklayan enum veri türü.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca dönüş değeri için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
KEYWORD Anahtar kelime ölçütleri (ör. "Mars'ta yolculuk"). KEYWORD, özel teklif boyutu olarak kullanılabilir. Anahtar kelimeler her zaman bir hedefleme boyutu olduğundan TargetRestriction ile hedef "TÜMÜ" boyutu olarak ayarlanamaz.
AUDIENCE Kullanıcı listesi, kullanıcı ilgi alanı, özel yakın ilgi alanı ve özel pazardaki kitleleri içeren kitle ölçütleri.
TOPIC İçerik kategorilerini hedeflemek için kullanılan konu ölçütleri (ör. "category::Animals>Pets"). Görüntülü reklam ve video hedefleme için kullanılır.
GENDER Cinsiyet hedefleme ölçütleri.
AGE_RANGE Yaş aralıklarını hedefleme ölçütleri.
PLACEMENT "www.flowers4sale.com" gibi web sitelerinin yanı sıra mobil uygulamaları, mobil uygulama kategorilerini, YouTube videolarını ve YouTube kanallarını içeren yerleşim ölçütleri.
PARENTAL_STATUS Ebeveynlik durumu hedefleme ölçütleri.
INCOME_RANGE Gelir aralığı hedefleme ölçütleri.

AdGroupAd

Reklam grubu reklamı.

JSON gösterimi
{
  "resourceName": string,
  "status": enum (AdGroupAdStatus),
  "ad": {
    object (Ad)
  },
  "creationTime": string,
  "labels": [
    string
  ],
  "effectiveLabels": [
    string
  ],
  "engineId": string,
  "engineStatus": enum (AdGroupAdEngineStatus),
  "lastModifiedTime": string
}
Alanlar
resourceName

string

Reklamın kaynak adı. Reklam grubu reklamı kaynak adları şu biçimdedir:

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

status

enum (AdGroupAdStatus)

Reklamın durumu.

ad

object (Ad)

Reklam.

creationTime

string

Bu adGroupAd'in oluşturulduğu zamanı gösteren zaman damgası. Tarih ve saat, müşterinin saat diliminde ve "yyyy-AA-gg SS:dd:ss.ssssss" biçimindedir.

labels[]

string

Bu reklam grubu reklamına eklenen etiketlerin kaynak adları.

effectiveLabels[]

string

Bu reklama eklenen etkili etiketlerin kaynak adları. Etkili bir etiket, bu reklama devralınan veya doğrudan atanmış bir etikettir.

engineId

string

Harici arama motoru hesabındaki reklamın kimliği. Bu alan yalnızca Search Ads 360 hesabı (ör. Yahoo Japan, Microsoft, Baidu vb.) içindir. Search Ads 360 olmayan bir öğe için bunun yerine "adGroupAd.ad.id" kullanın.

engineStatus

enum (AdGroupAdEngineStatus)

Reklamın harici motor hesabındaki ek durumu. Olası durumlar (harici hesap türüne bağlı olarak) arasında etkin, uygun, inceleme bekliyor vb. yer alır.

lastModifiedTime

string

Bu reklam grubu reklamının son değiştirildiği tarih ve saat. Tarih ve saat, müşterinin saat diliminde ve "yyyy-AA-gg SS:dd:ss.ssssss" biçimindedir.

AdGroupAdStatus

Bir AdGroupAd'in olası durumları.

Sıralamalar
UNSPECIFIED Değer belirtilmedi.
UNKNOWN

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

Bu, yalnızca yanıt değeri olan bir özelliktir.

ENABLED Reklam grubu reklamı etkinleştirilmiş olmalıdır.
PAUSED Reklam grubu reklamı duraklatılmış.
REMOVED Reklam grubu reklamı kaldırılır.

FinalAppUrl

Belirli bir işletim sistemi için uygulamaya derin bağlantı oluşturmak üzere kullanılan URL.

JSON gösterimi
{
  "osType": enum (AppUrlOperatingSystemType),
  "url": string
}
Alanlar
osType

enum (AppUrlOperatingSystemType)

Bu URL'nin hedeflediği işletim sistemi. Zorunlu.

url

string

Uygulama derin bağlantısı URL'si. Derin bağlantılar, göstermek istediğiniz içerikle eşleşen bir uygulama konumunu belirtir ve {scheme}://{host_path} biçiminde olmalıdır. Şema, hangi uygulamanın açılacağını tanımlar. Uygulamanız için, uygulamanın adıyla başlayan özel bir şema kullanabilirsiniz. Ana makine ve yol, içeriğinizin bulunduğu uygulamadaki benzersiz konumu belirtir. Örnek: "exampleapp://productid_1234". Zorunlu.

AppUrlOperatingSystemType

İşletim Sistemi

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca dönüş değeri için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
IOS Apple iOS işletim sistemi.
ANDROID Android işletim sistemi.

AdType

Bir reklamın olası türleri.

Sıralamalar
UNSPECIFIED Değer belirtilmedi.
UNKNOWN

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

Bu, yalnızca yanıt değeri olan bir özelliktir.

TEXT_AD Reklam bir metin reklamdır.
EXPANDED_TEXT_AD Reklam, genişletilmiş metin reklamdır.
CALL_ONLY_AD Reklam, yalnızca telefon araması üreten bir reklamdır.
EXPANDED_DYNAMIC_SEARCH_AD Reklam, genişletilmiş dinamik arama ağı reklamıdır.
HOTEL_AD Reklam bir otel reklamıdır.
SHOPPING_SMART_AD Reklam bir Akıllı Alışveriş reklamıdır.
SHOPPING_PRODUCT_AD Reklam, standart bir Alışveriş reklamıdır.
VIDEO_AD Reklam bir video reklamdır.
GMAIL_AD Bu reklam bir Gmail reklamıdır.
IMAGE_AD Bu reklam bir resim reklamıdır.
RESPONSIVE_SEARCH_AD Reklam, duyarlı arama ağı reklamıdır.
LEGACY_RESPONSIVE_DISPLAY_AD Reklam, eski bir duyarlı görüntülü reklamdır.
APP_AD Reklam bir uygulama reklamıdır.
LEGACY_APP_INSTALL_AD Reklam, eski bir uygulama yükleme reklamıdır.
RESPONSIVE_DISPLAY_AD Reklam, duyarlı görüntülü reklamdır.
LOCAL_AD Reklam bir yerel reklamdır.
HTML5_UPLOAD_AD Reklam, HTML5_UPLOAD_AD ürün türüne sahip bir görüntülü ağ yükleme reklamıdır.
DYNAMIC_HTML5_AD Reklam, DYNAMIC_HTML5_* ürün türlerinden birini içeren bir görüntülü reklam yükleme reklamıdır.
APP_ENGAGEMENT_AD Reklam, uygulama etkileşimi reklamı olmalıdır.
SHOPPING_COMPARISON_LISTING_AD Reklam, bir Alışveriş ürün karşılaştırma reklamıdır.
VIDEO_BUMPER_AD Video bumper reklam.
VIDEO_NON_SKIPPABLE_IN_STREAM_AD Atlanamayan yayın içi video reklam.
VIDEO_OUTSTREAM_AD Yayın dışı video reklam.
VIDEO_TRUEVIEW_DISCOVERY_AD Video TrueView görüntülü reklamı.
VIDEO_TRUEVIEW_IN_STREAM_AD Video TrueView yayın içi reklamı.
VIDEO_RESPONSIVE_AD Video duyarlı reklam
SMART_CAMPAIGN_AD Akıllı kampanya reklamı.
APP_PRE_REGISTRATION_AD Evrensel uygulama ön kayıt reklamı.
DISCOVERY_MULTI_ASSET_AD Discovery çok öğeli reklamı.
TRAVEL_AD Seyahat reklamı.
DISCOVERY_VIDEO_RESPONSIVE_AD Discovery video işlem reklamı
MULTIMEDIA_AD Multimedya reklam.

SearchAds360TextAdInfo

Search Ads 360 metin reklamı.

JSON gösterimi
{
  "headline": string,
  "description1": string,
  "description2": string,
  "displayUrl": string,
  "displayMobileUrl": string,
  "adTrackingId": string
}
Alanlar
headline

string

Reklamın başlığı.

description1

string

Reklam açıklamasının ilk satırı.

description2

string

Reklam açıklamasının ikinci satırı.

displayUrl

string

Reklamın gösterilen URL'si.

displayMobileUrl

string

Reklamın gösterilen mobil URL'si.

adTrackingId

string (int64 format)

Reklamın izleme kimliği.

SearchAds360ExpandedTextAdInfo

Search Ads 360 genişletilmiş metin reklamı.

JSON gösterimi
{
  "headline": string,
  "headline2": string,
  "headline3": string,
  "description1": string,
  "description2": string,
  "path1": string,
  "path2": string,
  "adTrackingId": string
}
Alanlar
headline

string

Reklamın başlığı.

headline2

string

Reklamın ikinci başlığı.

headline3

string

Reklamın üçüncü başlığı.

description1

string

Reklam açıklamasının ilk satırı.

description2

string

Reklam açıklamasının ikinci satırı.

path1

string

Otomatik olarak oluşturulan görünür URL'ye sınırlayıcı ile eklenen metin.

path2

string

Sınırlayıcı ile path1'e eklenen metin.

adTrackingId

string (int64 format)

Reklamın izleme kimliği.

SearchAds360ResponsiveSearchAdInfo

Bir Search Ads 360 duyarlı arama ağı reklamı.

JSON gösterimi
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "path1": string,
  "path2": string,
  "adTrackingId": string
}
Alanlar
headlines[]

object (AdTextAsset)

Başlıklar için metin öğelerinin listesi. Reklam yayınlandığında başlıklar bu listeden seçilir.

descriptions[]

object (AdTextAsset)

Açıklamalar için metin öğelerinin listesi. Reklam yayınlandığında açıklamalar bu listeden seçilir.

path1

string

Otomatik olarak oluşturulan görünür URL'ye sınırlayıcı ile eklenen metin.

path2

string

Sınırlayıcı ile path1'e eklenen metin.

adTrackingId

string (int64 format)

Reklamın izleme kimliği.

AdTextAsset

Reklam içinde kullanılan bir metin öğesi.

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

string

Öğe metni.

SearchAds360ProductAdInfo

Bu türde alan yok.

Search Ads 360 ürün reklamı.

SearchAds360ExpandedDynamicSearchAdInfo

Genişletilmiş bir Dinamik Arama Ağı reklamı.

JSON gösterimi
{
  "description1": string,
  "description2": string,
  "adTrackingId": string
}
Alanlar
description1

string

Reklam açıklamasının ilk satırı.

description2

string

Reklam açıklamasının ikinci satırı.

adTrackingId

string (int64 format)

Reklamın izleme kimliği.

AdGroupAdEngineStatus

AdGroupAd motor durumlarını numaralandırır.

Sıralamalar
UNSPECIFIED Değer belirtilmedi.
UNKNOWN Yalnızca dönüş değeri için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
AD_GROUP_AD_ELIGIBLE

Kullanımdan kaldırıldı. Kullanmayın.

AD_GROUP_AD_INAPPROPRIATE_FOR_CAMPAIGN Baidu: Reklam öğesi onaylanmadı.
AD_GROUP_AD_MOBILE_URL_UNDER_REVIEW Baidu: Mobil URL incelenmek üzere işleniyor.
AD_GROUP_AD_PARTIALLY_INVALID Baidu: Reklam öğesi mobil cihazda geçersiz ancak masaüstünde geçerli.
AD_GROUP_AD_TO_BE_ACTIVATED Baidu: Reklam öğesi etkinleştirilmeye hazır.
AD_GROUP_AD_NOT_REVIEWED Baidu: Reklam öğesi incelenmedi.
AD_GROUP_AD_ON_HOLD

Kullanımdan kaldırıldı. Kullanmayın. Daha önce Gemini tarafından kullanılmış

AD_GROUP_AD_PAUSED Reklam öğesi duraklatıldı.
AD_GROUP_AD_REMOVED Reklam öğesi kaldırıldı.
AD_GROUP_AD_PENDING_REVIEW Reklam öğesi incelenmeyi bekliyor.
AD_GROUP_AD_UNDER_REVIEW Reklam öğesi inceleniyor.
AD_GROUP_AD_APPROVED Reklam öğesi onaylandı.
AD_GROUP_AD_DISAPPROVED Reklam öğesi onaylanmadı.
AD_GROUP_AD_SERVING Reklam öğesi yayınlanıyor.
AD_GROUP_AD_ACCOUNT_PAUSED Hesap duraklatıldığı için reklam öğesi duraklatıldı.
AD_GROUP_AD_CAMPAIGN_PAUSED Kampanya duraklatıldığı için reklam öğesi de duraklatıldı.
AD_GROUP_AD_AD_GROUP_PAUSED Reklam grubu duraklatıldığı için reklam öğesi de duraklatıldı.

AdGroupAdEffectiveLabel

Bir reklam grubu reklamı ile etkili bir etiket arasındaki ilişki. Etkili bir etiket, bu reklam grubu reklamına devralınan veya doğrudan atanan bir etikettir.

JSON gösterimi
{
  "resourceName": string,
  "adGroupAd": string,
  "label": string,
  "ownerCustomerId": string
}
Alanlar
resourceName

string

Reklam grubu reklamı etkin etiketinin kaynak adı. Reklam grubu reklamı etkin etiket kaynak adları şu biçimdedir: customers/{ownerCustomerId}/adGroupAdEffectiveLabels/{ad_group_id}~{adId}~{label_id}

adGroupAd

string

Etkili etiketinin eklendiği reklam grubu reklamı.

label

string

Reklam grubu reklamına atanan etkin etiket.

ownerCustomerId

string (int64 format)

Etkin etiketin sahibi olan müşterinin kimliği.

AdGroupAdLabel

Bir reklam grubu reklamı ile etiket arasındaki ilişki.

JSON gösterimi
{
  "resourceName": string,
  "adGroupAd": string,
  "label": string,
  "ownerCustomerId": string
}
Alanlar
resourceName

string

Reklam grubu reklam etiketinin kaynak adı. Reklam grubu reklam etiketi kaynak adları şu biçimdedir: customers/{ownerCustomerId}/adGroupAdLabels/{ad_group_id}~{adId}~{label_id}

adGroupAd

string

Etiketin eklendiği reklam grubu reklamı.

label

string

Reklam grubu reklamına atanan etiket.

ownerCustomerId

string (int64 format)

Etiketin sahibi olan müşterinin kimliği.

AdGroupAsset

Bir reklam grubu ile öğe arasındaki bağlantı.

JSON gösterimi
{
  "resourceName": string,
  "adGroup": string,
  "asset": string,
  "status": enum (AssetLinkStatus)
}
Alanlar
resourceName

string

Reklam grubu öğesinin kaynak adı. AdGroupAsset kaynak adları şu biçimdedir:

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

adGroup

string

Zorunlu. Öğenin bağlandığı reklam grubu.

asset

string

Zorunlu. Reklam grubuna bağlı öğe.

status

enum (AssetLinkStatus)

Reklam grubu öğesinin durumu.

AssetLinkStatus

Bir öğe bağlantısının durumlarını açıklayan enum.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca dönüş değeri için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
ENABLED Öğe bağlantısı etkinleştirilmiş olmalıdır.
REMOVED Öğe bağlantısı kaldırıldı.
PAUSED Öğe bağlantısı duraklatıldı.

AdGroupAssetSet

AdGroupAssetSet, bir reklam grubu ile bir öğe grubu arasındaki bağlantıdır. AdGroupAssetSet oluşturmak, bir öğe grubunu bir reklam grubuyla bağlar.

JSON gösterimi
{
  "resourceName": string,
  "adGroup": string,
  "assetSet": string,
  "status": enum (AssetSetLinkStatus)
}
Alanlar
resourceName

string

Reklam grubu öğe grubunun kaynak adı. Reklam grubu öğe grubu kaynak adları şu biçimdedir:

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

adGroup

string

Bu öğe grubunun bağlandığı reklam grubu.

assetSet

string

Reklam grubuna bağlı öğe grubu.

status

enum (AssetSetLinkStatus)

Reklam grubu öğe grubunun durumu. Salt okunur.

AssetSetLinkStatus

Öğe grubu ile kapsayıcısı arasındaki bağlantının olası durumları.

Sıralamalar
UNSPECIFIED Durum belirtilmedi.
UNKNOWN Alınan değer bu sürümde bilinmiyor. Bu, yalnızca yanıt değeri olan bir özelliktir.
ENABLED Öğe grubu ile kapsayıcısı arasındaki bağlantı etkinleştirilir.
REMOVED Öğe grubu ile kapsayıcısı arasındaki bağlantı kaldırılır.

AdGroupAudienceView

Reklam grubu kitle görünümü. Görüntülü Reklam Ağı ve YouTube Ağı reklamları için ilgi alanları ve yeniden pazarlama listelerinden elde edilen performans verilerinin yanı sıra kitle düzeyinde toplanan arama ağı reklamlarına yönelik yeniden pazarlama listelerini (ARYPL) içerir.

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

string

Reklam grubu kitle görünümünün kaynak adı. Reklam grubu kitle görünümü kaynak adları şu biçimdedir:

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

AdGroupBidModifier

Reklam grubu teklif değiştiricisini temsil eder.

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

string

Reklam grubu teklif değiştiricisinin kaynak adı. Reklam grubu teklif değiştirici kaynak adları şu biçimdedir:

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

bidModifier

number

Ölçüt eşleştiğinde teklif için değiştirici. Değiştirici, 0,1-10,0 aralığında olmalıdır. PreferredContent için aralık 1,0-6,0'dır. Bir cihaz türünü devre dışı bırakmak için 0'ı kullanın.

criterion birleşik alanı. Bu reklam grubu teklif değiştiricisinin ölçütü.

V5'ten itibaren oluşturma işlemlerinde zorunludur. criterion aşağıdakilerden yalnızca biri olabilir:

device

object (DeviceInfo)

Bir cihaz ölçütü.

DeviceInfo

Bir cihaz ölçütü.

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

enum (Device)

Cihazın türü.

Cihaz

Hedefleme için kullanılabilen Google Ads cihazlarını numaralandırır.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Bu sürümde değer bilinmiyor.
MOBILE Tam işlevli tarayıcılara sahip mobil cihazlar
TABLET Tam işlevli tarayıcılara sahip tabletler
DESKTOP Bilgisayarlar'ı seçin.
CONNECTED_TV Akıllı TV'ler ve oyun konsolları
OTHER Diğer cihaz türleri.

AdGroupCriterion

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

JSON gösterimi
{
  "resourceName": string,
  "creationTime": string,
  "status": enum (AdGroupCriterionStatus),
  "qualityInfo": {
    object (QualityInfo)
  },
  "type": enum (CriterionType),
  "labels": [
    string
  ],
  "effectiveLabels": [
    string
  ],
  "positionEstimates": {
    object (PositionEstimates)
  },
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "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.
}
Alanlar
resourceName

string

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

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

creationTime

string

Bu reklam grubu ölçütünün oluşturulduğu zaman damgası. Zaman damgası, müşterinin saat diliminde ve "yyyy-AA-gg SS:dd:ss" biçimindedir.

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 yayınlanmaya uygun olup olmadığını etkileyen ek bilgiler içerebilir. Bazı durumlarda, API'de KALDIRILAN bir ölçüt kullanıcı arayüzünde etkin olarak gösterilmeye devam edebilir. Örneğin, kampanyalar hariç tutulmadığı sürece varsayılan olarak tüm yaş gruplarındaki kullanıcılara gösterilir. Kullanıcı arayüzünde her yaş aralığı, reklamları görmeye uygun oldukları için "etkin" olarak gösterilir. Ancak olumlu bir ölçüt eklenmediği için AdGroupCriterion.status "kaldırıldı" olarak gösterilir.

qualityInfo

object (QualityInfo)

Ölçütün kalitesiyle ilgili bilgiler.

type

enum (CriterionType)

Ölçütün türü.

labels[]

string

Bu reklam grubu ölçütüne eklenen etiketlerin kaynak adları.

effectiveLabels[]

string

Bu reklam grubu ölçütüne eklenen etkin etiketlerin kaynak adları. Etkili bir etiket, bu reklam grubu ölçütüne devralınan veya doğrudan atanan bir etikettir.

positionEstimates

object (PositionEstimates)

Çeşitli konumlardaki ölçüt teklifleriyle ilgili tahminler.

finalUrls[]

string

Reklam için tüm alanlar arası yönlendirmelerden sonraki olası nihai URL'lerin listesi.

finalMobileUrls[]

string

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

urlCustomParameters[]

object (CustomParameter)

trackingUrlTemplate, finalUrls veya mobile_final_urls içindeki özel parametre etiketlerinin yerine kullanılacak eşlemelerin listesi.

engineId

string

Harici arama motoru hesabındaki reklam grubu ölçütünün kimliği. Bu alan yalnızca Google Ads hesabı olmayanlar (ör. Yahoo Japan, Microsoft, Baidu vb.) içindir. Google Ads öğesi için bunun yerine "adGroupCriterion.criterion_id" kullanın.

lastModifiedTime

string

Bu reklam grubu ölçütünün en son değiştirildiği tarih ve saat. Tarih ve saat, müşterinin saat diliminde ve "yyyy-AA-gg SS:dd:ss.ssssss" biçimindedir.

criterionId

string (int64 format)

Ölçütün kimliği.

adGroup

string

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

negative

boolean

Ölçütün hedeflenip (false) hedeflenmeyeceği veya hariç tutulup (true) tutulmayacağı.

Bu alan değiştirilemez. Bir ölçütü pozitiften negatife geçirmek için önce kaldırıp sonra yeniden ekleyin.

bidModifier

number

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

cpcBidMicros

string (int64 format)

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

effectiveCpcBidMicros

string (int64 format)

Geçerli TBM (tıklama başına maliyet) teklifi.

engineStatus

enum (AdGroupCriterionEngineStatus)

Reklam grubu ölçütünün motor durumu.

finalUrlSuffix

string

Parametreleri nihai URL'ye eklemek için kullanılan URL şablonu.

trackingUrlTemplate

string

İzleme URL'si oluşturmak için kullanılan URL şablonu.

criterion birleşik alanı. Reklam grubu ölçütü.

Tam olarak bir tane ayarlanmalıdır. criterion aşağıdakilerden yalnızca biri olabilir:

keyword

object (KeywordInfo)

Anahtar kelime.

listingGroup

object (ListingGroupInfo)

Listeleme grubu.

ageRange

object (AgeRangeInfo)

Yaş grubu.

gender

object (GenderInfo)

Cinsiyet.

userList

object (UserListInfo)

Kullanıcı Listesi

webpage

object (WebpageInfo)

Web Sayfası

location

object (LocationInfo)

Konum'a dokunun.

AdGroupCriterionStatus

Bir AdGroupCriterion'un olası durumları.

Sıralamalar
UNSPECIFIED Değer belirtilmedi.
UNKNOWN

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

Bu, yalnızca yanıt değeri olan bir özelliktir.

ENABLED Reklam grubu ölçütü etkinleştirilmiş olmalıdır.
PAUSED Reklam grubu ölçütü duraklatılmış.
REMOVED Reklam grubu ölçütü kaldırılır.

QualityInfo

Reklam grubu ölçütü kalite bilgileri için bir kapsayıcı.

JSON gösterimi
{
  "qualityScore": integer
}
Alanlar
qualityScore

integer

Kalite puanı.

Google'ın bir değeri belirlemek için yeterli bilgisi yoksa bu alan doldurulmayabilir.

CriterionType

Olası ölçüt türlerini açıklayan enum veri türü.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca dönüş değeri için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
KEYWORD Anahtar kelime (ör. "Mars'ta yolculuk").
PLACEMENT Yerleşim (ör. "www.flowers4sale.com"), diğer adıyla web sitesi
MOBILE_APP_CATEGORY Hedeflenecek mobil uygulama kategorileri.
MOBILE_APPLICATION Hedeflenecek mobil uygulamalar.
DEVICE Hedeflenecek cihazlar.
LOCATION Hedeflenecek konumlar.
LISTING_GROUP Hedeflenecek listeleme grupları.
AD_SCHEDULE Reklam zaman planlaması.
AGE_RANGE Yaş grubu.
GENDER Cinsiyet.
INCOME_RANGE Gelir aralığı.
PARENTAL_STATUS Ebeveynlik durumu.
YOUTUBE_VIDEO YouTube videosu.
YOUTUBE_CHANNEL YouTube kanalı.
USER_LIST Kullanıcı listesi.
PROXIMITY Yakınlık
TOPIC Görüntülü Reklam Ağı'nda bir konu hedefi (örneğin, "Evcil Hayvanlar ve Hayvanlar").
LISTING_SCOPE Hedeflenecek giriş kapsamı.
LANGUAGE Dil.
IP_BLOCK IpBlock.
CONTENT_LABEL Kategori hariç tutma için içerik etiketi.
CARRIER Operatör.
USER_INTEREST Kullanıcının ilgilendiği bir kategori.
WEBPAGE Dinamik arama ağı reklamları için web sayfası ölçütü.
OPERATING_SYSTEM_VERSION İşletim sistemi sürümü.
APP_PAYMENT_MODEL Uygulama ödeme modeli.
MOBILE_DEVICE Mobil cihaz.
CUSTOM_AFFINITY Özel yakın ilgi alanı.
CUSTOM_INTENT Özel amaç
LOCATION_GROUP Konum grubu.
CUSTOM_AUDIENCE Özel kitle
COMBINED_AUDIENCE Birleştirilmiş kitle
KEYWORD_THEME Akıllı kampanya anahtar kelime teması
AUDIENCE Kitle
LOCAL_SERVICE_ID Yerel Hizmet Reklamları Hizmet Kimliği.
BRAND Marka
BRAND_LIST Marka Listesi
LIFE_EVENT Unutulmaz Olay

PositionEstimates

Çeşitli konumlardaki ölçüt teklifleriyle ilgili tahminler.

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

string (int64 format)

Reklamın, arama sonuçlarının ilk sayfasının en üstünde gösterilmesi için gereken TBM teklifinin tahmini değeridir.

AdGroupCriterionEngineStatus

AdGroupCriterion motor durumlarını numaralandırır.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca dönüş değeri için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
AD_GROUP_CRITERION_ELIGIBLE

Kullanımdan kaldırıldı. Kullanmayın.

AD_GROUP_CRITERION_INAPPROPRIATE_FOR_CAMPAIGN Baidu: Teklif veya kalite görüntülenemeyecek kadar düşük.
AD_GROUP_CRITERION_LOW_SEARCH_VOLUME Baidu: Düşük arama hacmi nedeniyle Baidu tarafından duraklatıldı.
AD_GROUP_CRITERION_MOBILE_URL_UNDER_REVIEW Baidu: Mobil URL incelenmek üzere işleniyor.
AD_GROUP_CRITERION_PARTIALLY_INVALID Baidu: Bir cihazın açılış sayfası geçersiz, diğer cihazın açılış sayfası geçerli.
AD_GROUP_CRITERION_TO_BE_ACTIVATED Baidu: Anahtar kelime Baidu hesap yönetimi tarafından oluşturulup duraklatıldı ve şimdi etkinleştirmeniz için hazır.
AD_GROUP_CRITERION_UNDER_REVIEW Baidu: Baidu tarafından incelenmek üzere işleniyor. Gemini: Ölçüt inceleniyor.
AD_GROUP_CRITERION_NOT_REVIEWED Baidu: İncelenecek ölçüt.
AD_GROUP_CRITERION_ON_HOLD

Kullanımdan kaldırıldı. Kullanmayın. Daha önce Gemini tarafından kullanılmış

AD_GROUP_CRITERION_PENDING_REVIEW Y!J : Ölçüt incelenmeyi bekliyor
AD_GROUP_CRITERION_PAUSED Ölçüt duraklatıldı.
AD_GROUP_CRITERION_REMOVED Ölçüt kaldırıldı.
AD_GROUP_CRITERION_APPROVED Ölçüt onaylandı.
AD_GROUP_CRITERION_DISAPPROVED Ölçüt onaylanmadı.
AD_GROUP_CRITERION_SERVING Ölçüt etkin ve yayınlanıyor.
AD_GROUP_CRITERION_ACCOUNT_PAUSED Hesap duraklatıldığı için ölçüt duraklatıldı.

CustomParameter

trackingUrlTemplate, finalUrls veya mobile_final_urls içinde özel parametre etiketleri tarafından kullanılabilen bir eşleme.

JSON gösterimi
{
  "key": string,
  "value": string
}
Alanlar
key

string

Parametre etiket adıyla eşleşen anahtar.

value

string

Yerine konulacak değer.

KeywordInfo

Anahtar kelime ölçütü.

JSON gösterimi
{
  "matchType": enum (KeywordMatchType),
  "text": string
}
Alanlar
matchType

enum (KeywordMatchType)

Anahtar kelimenin eşleme türü.

text

string

Anahtar kelimenin metni (en fazla 80 karakter ve 10 kelime).

KeywordMatchType

Olası anahtar kelime eşleme türleri.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca dönüş değeri için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
EXACT Tam eşleme.
PHRASE Sıralı eşleme.
BROAD Geniş eşleme.

ListingGroupInfo

Listeleme grubu ölçütü.

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

enum (ListingGroupType)

Listeleme grubunun türü.

ListingGroupType

Listeleme grubunun türü.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca dönüş değeri için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
SUBDIVISION Ürünlerin bazı listeleme boyutlarına göre alt bölümlere ayrılması. Bu düğümler, listeleme girişlerini hedeflemek için yayınlama tarafından kullanılmaz. Yalnızca ağacın yapısını tanımlamak için kullanılır.
UNIT Teklifi tanımlayan listeleme grubu birimi.

AgeRangeInfo

Yaş aralığı ölçütü.

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

enum (AgeRangeType)

Yaş aralığının türü.

AgeRangeType

Demografik yaş aralıklarının türü (örneğin, 18-24 yaş aralığı).

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca dönüş değeri için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
AGE_RANGE_18_24 18-24 yaş aralığında olmalıdır.
AGE_RANGE_25_34 25-34 yaş aralığında
AGE_RANGE_35_44 35-44 yaş arasında
AGE_RANGE_45_54 45-54 yaş aralığında
AGE_RANGE_55_64 55-64 yaş aralığında
AGE_RANGE_65_UP 65 yaş ve üzeri
AGE_RANGE_UNDETERMINED Belirlenmemiş yaş aralığı.

GenderInfo

Cinsiyet ölçütü.

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

enum (GenderType)

Cinsiyet türü.

GenderType

Demografik cinsiyet türü (ör. kadın).

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca dönüş değeri için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
MALE Erkek.
FEMALE Kadın.
UNDETERMINED Cinsiyet belirlenmemiş.

UserListInfo

Kullanıcı listesi ölçütü. Reklamveren tarafından hedeflenecek şekilde tanımlanan bir kullanıcı listesini temsil eder.

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

string

Kullanıcı listesi kaynağının adı.

WebpageInfo

Reklamverenin web sitesindeki web sayfalarını hedefleme ölçütünü temsil eder.

JSON gösterimi
{
  "conditions": [
    {
      object (WebpageConditionInfo)
    }
  ],
  "coveragePercentage": number,
  "criterionName": string
}
Alanlar
conditions[]

object (WebpageConditionInfo)

Web sayfası hedefleme için koşullar veya mantıksal ifadeler. Web sayfası hedefleme koşulları listesi, hedefleme için değerlendirilirken "VE" ile birleştirilir. Boş bir koşul listesi, kampanyanın web sitesinin tüm sayfalarının hedeflendiğini gösterir.

Bu alan, CREATE işlemleri için zorunludur ve UPDATE işlemlerinde yasaktır.

coveragePercentage

number

Web sitesi ölçütleri kapsamı yüzdesi. Bu, reklam grubu ve kampanyadaki web sitesi hedefi, negatif web sitesi hedefi ve negatif anahtar kelimelere göre hesaplanan web sitesi kapsamı yüzdesidir. Örneğin, kapsam 1 olarak döndürüldüğünde% 100 kapsama sahip olduğu anlaşılır. Bu alan salt okunurdur.

criterionName

string

Bu parametre tarafından tanımlanan ölçütün adı. Ad değeri, bu tür parametrelerle tanımlama, sıralama ve filtreleme ölçütleri için kullanılır.

Bu alan, CREATE işlemleri için zorunludur ve UPDATE işlemlerinde yasaktır.

WebpageConditionInfo

Bir reklamverenin web sitesinin web sayfalarını hedeflemeye yönelik mantıksal ifade.

JSON gösterimi
{
  "operand": enum (WebpageConditionOperand),
  "operator": enum (WebpageConditionOperator),
  "argument": string
}
Alanlar
operand

enum (WebpageConditionOperand)

Web sayfası hedefleme koşulunun işleneni.

operator

enum (WebpageConditionOperator)

Web sayfası hedefleme koşulunun operatörü.

argument

string

Web sayfası hedefleme koşulunun bağımsız değişkeni.

WebpageConditionOperand

Web sayfası ölçütündeki web sayfası koşulu işleneni.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca dönüş değeri için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
URL Bir web sayfası URL'si hedefleme koşulunu belirten işlenen.
CATEGORY Bir web sayfası kategorisi hedefleme koşulunu belirten işlenen.
PAGE_TITLE Bir web sayfası başlığı hedefleme koşulunu belirten işlenen.
PAGE_CONTENT Bir web sayfası içeriği hedefleme koşulunu belirten işlenen.
CUSTOM_LABEL Bir web sayfası özel etiketi hedefleme koşulunu belirten işlenen.

WebpageConditionOperator

Web sayfası ölçütündeki web sayfası koşul operatörü.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca dönüş değeri için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
EQUALS Web koşulu bağımsız değişkeni, karşılaştırılan web koşuluna eşittir.
CONTAINS Argüman web koşulu, karşılaştırılan web koşulunun bir parçasıdır.

LocationInfo

Bir konum ölçütü.

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

string

Coğrafi hedef sabitinin kaynak adı.

AdGroupCriterionEffectiveLabel

Reklam grubu ölçütü ile etkili etiket arasındaki ilişki. Etkili bir etiket, bu reklam grubu ölçütüne devralınan veya doğrudan atanan bir etikettir.

JSON gösterimi
{
  "resourceName": string,
  "adGroupCriterion": string,
  "label": string,
  "ownerCustomerId": string
}
Alanlar
resourceName

string

Reklam grubu ölçütü etkin etiketinin kaynak adı. Reklam grubu ölçütü etkin etiket kaynak adları şu biçimdedir: customers/{ownerCustomerId}/adGroupCriterionEffectiveLabels/{ad_group_id}~{criterionId}~{label_id}

adGroupCriterion

string

Etkili etiketin eklendiği reklam grubu ölçütü.

label

string

Reklam grubu ölçütüne atanan etkin etiket.

ownerCustomerId

string (int64 format)

Etkin etiketin sahibi olan müşterinin kimliği.

AdGroupCriterionLabel

Reklam grubu ölçütü ile etiket arasındaki ilişki.

JSON gösterimi
{
  "resourceName": string,
  "adGroupCriterion": string,
  "label": string,
  "ownerCustomerId": string
}
Alanlar
resourceName

string

Reklam grubu ölçütü etiketinin kaynak adı. Reklam grubu ölçütü etiketi kaynak adları şu biçimdedir: customers/{ownerCustomerId}/adGroupCriterionLabels/{ad_group_id}~{criterionId}~{label_id}

adGroupCriterion

string

Etiketin eklendiği reklam grubu ölçütü.

label

string

Reklam grubu ölçütüne atanan etiket.

ownerCustomerId

string (int64 format)

Etiketin sahibi olan müşterinin kimliği.

AdGroupEffectiveLabel

Bir reklam grubu ile etkili bir etiket arasındaki ilişki. Etkili bir etiket, bu reklam grubuna devralınan veya doğrudan atanan bir etikettir.

JSON gösterimi
{
  "resourceName": string,
  "adGroup": string,
  "label": string,
  "ownerCustomerId": string
}
Alanlar
resourceName

string

Etkili reklam grubu etiketinin kaynak adı. Reklam grubu etkin etiket kaynak adları şu biçimdedir: customers/{ownerCustomerId}/adGroupEffectiveLabels/{ad_group_id}~{label_id}

adGroup

string

Etkili etiketinin eklendiği reklam grubu.

label

string

Reklam grubuna atanan etkin etiket.

ownerCustomerId

string (int64 format)

Etkin etiketin sahibi olan müşterinin kimliği.

AdGroupLabel

Bir reklam grubu ile etiket arasındaki ilişki.

JSON gösterimi
{
  "resourceName": string,
  "adGroup": string,
  "label": string,
  "ownerCustomerId": string
}
Alanlar
resourceName

string

Reklam grubu etiketinin kaynak adı. Reklam grubu etiketi kaynak adları şu biçimdedir: customers/{ownerCustomerId}/adGroupLabels/{ad_group_id}~{label_id}

adGroup

string

Etiketin eklendiği reklam grubu.

label

string

Reklam grubuna atanan etiket.

ownerCustomerId

string (int64 format)

Etiketin sahibi olan müşterinin kimliği.

AgeRangeView

Yaş grubu görünümü.

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

string

Yaş aralığı görünümünün kaynak adı. Yaş aralığı görünümü kaynak adları şu biçimdedir:

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

Öğe

Öğeler, reklamın bir parçasıdır ve birden fazla reklamda paylaşılabilir. Öğeler; resim (ImageAsset), video (YoutubeVideoAsset) vb. olabilir. Öğeler sabittir ve kaldırılamaz. Bir öğenin yayınlanmasını durdurmak için öğeyi, kullanan varlıktan kaldırın.

JSON gösterimi
{
  "resourceName": string,
  "type": enum (AssetType),
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "status": enum (AssetStatus),
  "creationTime": string,
  "lastModifiedTime": string,
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": 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.
}
Alanlar
resourceName

string

Öğenin kaynak adı. Öğe kaynak adları şu biçimdedir:

customers/{customerId}/assets/{assetId}

type

enum (AssetType)

Öğenin türü.

finalUrls[]

string

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

finalMobileUrls[]

string

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

urlCustomParameters[]

object (CustomParameter)

trackingUrlTemplate, finalUrls ve/veya finalMobileUrls'deki URL özel parametre etiketlerinin yerine kullanılacak eşlemelerin listesi.

status

enum (AssetStatus)

Öğenin durumu.

creationTime

string

Bu öğenin oluşturulduğu zamanı gösteren zaman damgası. Zaman damgası, müşterinin saat diliminde ve "yyyy-AA-gg SS:dd:ss" biçimindedir.

lastModifiedTime

string

Bu öğenin en son değiştirildiği tarih ve saat. Tarih ve saat, müşterinin saat diliminde ve "yyyy-AA-gg SS:dd:ss.ssssss" biçimindedir.

id

string (int64 format)

Öğenin kimliği.

name

string

Öğenin isteğe bağlı adı.

trackingUrlTemplate

string

İzleme URL'si oluşturmak için kullanılan URL şablonu.

finalUrlSuffix

string

Paralel izleme ile sunulan açılış sayfası URL'lerine parametreler eklemek için kullanılan URL şablonu.

engineStatus

enum (AssetEngineStatus)

Bir öğenin motor durumu.

asset_data birleşik alanı. Öğenin türü. asset_data aşağıdakilerden yalnızca biri olabilir:
youtubeVideoAsset

object (YoutubeVideoAsset)

YouTube video öğesi.

imageAsset

object (ImageAsset)

Resim öğesi

textAsset

object (TextAsset)

Metin öğesi

calloutAsset

object (UnifiedCalloutAsset)

Birleştirilmiş açıklama metni öğesi.

pageFeedAsset

object (UnifiedPageFeedAsset)

Birleştirilmiş bir sayfa feed'i öğesi.

mobileAppAsset

object (MobileAppAsset)

Mobil uygulama öğesi

callAsset

object (UnifiedCallAsset)

Birleştirilmiş telefon öğesi.

callToActionAsset

object (CallToActionAsset)

Harekete geçirici mesaj öğesi.

locationAsset

object (UnifiedLocationAsset)

Birleştirilmiş yer öğesi.

AssetType

Olası öğe türlerini açıklayan enum veri türü.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca dönüş değeri için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
YOUTUBE_VIDEO YouTube video öğesi.
MEDIA_BUNDLE Medya paketi öğesi.
IMAGE Resim öğesi.
TEXT Metin öğesi.
LEAD_FORM Potansiyel müşteri formu öğesi.
BOOK_ON_GOOGLE Google'da Rezervasyon öğesi.
PROMOTION Promosyon öğesi.
CALLOUT Açıklama metni öğesi.
STRUCTURED_SNIPPET Ek açıklamalı snippet öğesi.
PAGE_FEED Sayfa feed'i öğesi.
DYNAMIC_EDUCATION Dinamik eğitim öğesi.
MOBILE_APP Mobil uygulama öğesi.
HOTEL_CALLOUT Otel açıklama metni öğesi.
CALL Telefon öğesi.
PRICE Fiyat öğesi.
CALL_TO_ACTION Harekete geçirici mesaj öğesi.
DYNAMIC_REAL_ESTATE Dinamik gayrimenkul öğesi.
DYNAMIC_CUSTOM Dinamik özel öğe.
DYNAMIC_HOTELS_AND_RENTALS Dinamik otel ve kiralık yer öğesi.
DYNAMIC_FLIGHTS Dinamik uçuşlar öğesi.
DYNAMIC_TRAVEL Dinamik seyahat öğesi.
DYNAMIC_LOCAL Dinamik yerel öğe.
DYNAMIC_JOBS Dinamik işler öğesi.
LOCATION Yer öğesi.
HOTEL_PROPERTY Otel mülk öğesi.

AssetStatus

Bir öğenin olası durumları.

Sıralamalar
UNSPECIFIED Durum belirtilmedi.
UNKNOWN Alınan değer bu sürümde bilinmiyor. Bu, yalnızca yanıt değeri olan bir özelliktir.
ENABLED Öğe etkinleştirilmiş olmalıdır.
REMOVED Öğe kaldırılır.
ARCHIVED Öğe arşivlendi.
PENDING_SYSTEM_GENERATED Öğe, kullanıcı incelemesi beklenirken sistem tarafından oluşturulur.

AssetEngineStatus

Olası öğe motoru durumlarını açıklayan enum veri türü.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca dönüş değeri için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
SERVING Öğe etkin olmalıdır.
SERVING_LIMITED Öğe, etkin (sınırlı) durumundadır.
DISAPPROVED Öğe onaylanmadı (uygun değil).
DISABLED Öğe etkin değil (beklemede).
REMOVED Öğe kaldırıldı.

YoutubeVideoAsset

YouTube öğesi

JSON gösterimi
{
  "youtubeVideoTitle": string,
  "youtubeVideoId": string
}
Alanlar
youtubeVideoTitle

string

YouTube video başlığı.

youtubeVideoId

string

YouTube video kimliği. Bu, YouTube videosu URL'sinde kullanılan 11 karakterlik dize değeridir.

ImageAsset

Resim öğesi

JSON gösterimi
{
  "mimeType": enum (MimeType),
  "fullSize": {
    object (ImageDimension)
  },
  "fileSize": string
}
Alanlar
mimeType

enum (MimeType)

Resim öğesinin MIME türü.

fullSize

object (ImageDimension)

Bu resmin orijinal boyutundaki meta verileri.

fileSize

string (int64 format)

Resim öğesinin bayt cinsinden dosya boyutu.

MimeType

MIME türü

Sıralamalar
UNSPECIFIED MIME türü belirtilmedi.
UNKNOWN

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

Bu, yalnızca yanıt değeri olan bir özelliktir.

IMAGE_JPEG image/jpeg MIME türü.
IMAGE_GIF Resim/gif MIME türü.
IMAGE_PNG image/png MIME türü.
FLASH application/x-shockwave-flash MIME türü.
TEXT_HTML text/html MIME türü.
PDF application/pdf MIME türü.
MSWORD application/msword MIME türü.
MSEXCEL application/vnd.ms-excel MIME türü.
RTF application/rtf MIME türü.
AUDIO_WAV audio/wav dosyasının MIME türü.
AUDIO_MP3 Ses/mp3'ün MIME türü.
HTML5_AD_ZIP application/x-html5-ad-zip MIME türü.

ImageDimension

Belirli bir boyuttaki (orijinal veya yeniden boyutlandırılmış) bir resmin meta verileri.

JSON gösterimi
{
  "heightPixels": string,
  "widthPixels": string,
  "url": string
}
Alanlar
heightPixels

string (int64 format)

Resmin yüksekliği.

widthPixels

string (int64 format)

Resmin genişliği.

url

string

Resmi bu yükseklik ve genişlikte döndüren bir URL.

TextAsset

Metin öğesi

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

string

Metin öğesinin metin içeriği.

UnifiedCalloutAsset

Birleştirilmiş açıklama metni öğesi.

JSON gösterimi
{
  "calloutText": string,
  "startDate": string,
  "endDate": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ],
  "useSearcherTimeZone": boolean
}
Alanlar
calloutText

string

Açıklama metni. Bu dizenin uzunluğu 1 ile 25 arasında (bu değerler dahil) olmalıdır.

startDate

string

Bu öğenin geçerli olduğu ve yayınlanmaya başlayabileceği başlangıç tarihi (yyyy-AA-gg biçiminde).

endDate

string

Bu öğenin geçerli olduğu ve yayınlanmaya devam ettiği son tarih (yyyy-AA-gg biçiminde).

adScheduleTargets[]

object (AdScheduleInfo)

Öğenin yayınlanabileceği tüm zaman aralıklarını belirten, çakışmayan zaman planlamalarının listesi. Günde en fazla 6, toplamda 42 zaman planlaması olabilir.

useSearcherTimeZone

boolean

Öğenin, arama yapan kullanıcının saat diliminde gösterilip gösterilmeyeceği. Microsoft Ads için geçerlidir.

AdScheduleInfo

Reklam zaman planı ölçütünü temsil eder.

AdSchedule, haftanın günü ve reklamların gösterileceği zaman aralığı olarak belirtilir.

Aynı gün için en fazla altı reklam zaman planı eklenebilir.

JSON gösterimi
{
  "startMinute": enum (MinuteOfHour),
  "endMinute": enum (MinuteOfHour),
  "dayOfWeek": enum (DayOfWeek),
  "startHour": integer,
  "endHour": integer
}
Alanlar
startMinute

enum (MinuteOfHour)

Bu programın başladığı saatten sonraki dakika.

Bu alan, CREATE işlemleri için zorunludur ve UPDATE işlemlerinde yasaktır.

endMinute

enum (MinuteOfHour)

Bu programın sona erdiği saatten sonraki dakikalar. Plan, son dakikayı içermez.

Bu alan, CREATE işlemleri için zorunludur ve UPDATE işlemlerinde yasaktır.

dayOfWeek

enum (DayOfWeek)

Programın geçerli olduğu haftanın günü.

Bu alan, CREATE işlemleri için zorunludur ve UPDATE işlemlerinde yasaktır.

startHour

integer

24 saat biçiminde başlangıç saati. Bu alan 0 ile 23 arasında (bu değerler dahil) olmalıdır.

Bu alan, CREATE işlemleri için zorunludur ve UPDATE işlemlerinde yasaktır.

endHour

integer

24 saatlik gösterimle bitiş saati; 24, günün sonunu ifade eder. Bu alan 0 ile 24 arasında (bu değerler dahil) olmalıdır.

Bu alan, CREATE işlemleri için zorunludur ve UPDATE işlemlerinde yasaktır.

MinuteOfHour

Çeyrek saatleri numaralandırır. Örneğin, "FIFTEEN"

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Bu sürümde değer bilinmiyor.
ZERO Saat başı.
FIFTEEN Saat on beş dakika geçmiş.
THIRTY Saat başından otuz dakika sonra.
FORTY_FIVE Saat geçtikten kırk beş dakika sonra.

HaftanınGünü

Haftanın günlerini (ör. "Pazartesi") listeler.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Bu sürümde değer bilinmiyor.
MONDAY Pazartesi
TUESDAY Salı
WEDNESDAY Çarşamba
THURSDAY Perşembe
FRIDAY Cuma
SATURDAY Cumartesi
SUNDAY Pazar

UnifiedSitelinkAsset

Birleştirilmiş site bağlantısı öğesi.

JSON gösterimi
{
  "linkText": string,
  "description1": string,
  "description2": string,
  "startDate": string,
  "endDate": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ],
  "trackingId": string,
  "useSearcherTimeZone": boolean,
  "mobilePreferred": boolean
}
Alanlar
description1

string

Site bağlantısının açıklamasının ilk satırı. Ayarlanırsa uzunluk 1 ile 35 arasında (bu değerler dahil) olmalı ve description2 de ayarlanmalıdır.

description2

string

Site bağlantısının açıklamasının ikinci satırı. Ayarlanırsa uzunluk 1 ile 35 arasında (bu değerler dahil) olmalı ve description1 de ayarlanmalıdır.

startDate

string

Bu öğenin geçerli olduğu ve yayınlanmaya başlayabileceği başlangıç tarihi (yyyy-AA-gg biçiminde).

endDate

string

Bu öğenin geçerli olduğu ve yayınlanmaya devam ettiği son tarih (yyyy-AA-gg biçiminde).

adScheduleTargets[]

object (AdScheduleInfo)

Öğenin yayınlanabileceği tüm zaman aralıklarını belirten, çakışmayan zaman planlamalarının listesi. Günde en fazla 6, toplamda 42 zaman planlaması olabilir.

trackingId

string (int64 format)

Site bağlantısı öğesi için tıklamaları izlemek üzere kullanılan kimlik. Bu bir Yahoo! Yalnızca Japonya'da kullanılabilir.

useSearcherTimeZone

boolean

Site bağlantısı öğesinin, arama kullanıcısının saat diliminde gösterilip gösterilmeyeceği. Microsoft Ads için geçerlidir.

mobilePreferred

boolean

Tercihin, site bağlantısı öğesinin mobil cihazlarda gösterilmesi olup olmadığı. Microsoft Ads için geçerlidir.

UnifiedPageFeedAsset

Birleşik sayfa feed'i öğesi.

JSON gösterimi
{
  "pageUrl": string,
  "labels": [
    string
  ]
}
Alanlar
pageUrl

string

Reklamverenlerin hedeflemek istediği web sayfası.

labels[]

string

Sayfa URL'lerini gruplandırmak için kullanılan etiketler.

MobileAppAsset

Mobil uygulamayı temsil eden bir öğe.

JSON gösterimi
{
  "appId": string,
  "appStore": enum (MobileAppVendor)
}
Alanlar
appId

string

Zorunlu. Bir mobil uygulamayı benzersiz şekilde tanımlayan dize. Yalnızca platforma özgü kimliği (ör. Android için "com.android.ebay" veya iOS için "12345689") içermelidir.

appStore

enum (MobileAppVendor)

Zorunlu. Bu uygulamayı dağıtan uygulama mağazası.

MobileAppVendor

Mobil uygulama tedarikçisinin türü

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca dönüş değeri için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
APPLE_APP_STORE Apple App Store için mobil uygulama tedarikçi firması.
GOOGLE_APP_STORE Google uygulama mağazası için mobil uygulama tedarikçi firması.

UnifiedCallAsset

Birleştirilmiş telefon öğesi.

JSON gösterimi
{
  "countryCode": string,
  "phoneNumber": string,
  "callConversionReportingState": enum (CallConversionReportingState),
  "callConversionAction": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ],
  "callOnly": boolean,
  "callTrackingEnabled": boolean,
  "useSearcherTimeZone": boolean,
  "startDate": string,
  "endDate": string
}
Alanlar
countryCode

string

Telefon numarasının iki harfli ülke kodu. Örnekler: "US", "us".

phoneNumber

string

Reklamverenin ham telefon numarası. Örnekler: "1234567890", "(123)456-7890"

callConversionReportingState

enum (CallConversionReportingState)

Bu CallAsset'in kendi telefon araması dönüşümü ayarını kullanıp kullanmayacağını, hesap düzeyi ayarı izleyip izlemeyeceğini veya telefon araması dönüşümünü devre dışı bırakıp bırakmayacağını gösterir.

callConversionAction

string

Telefon araması dönüşümünün ilişkilendirileceği dönüşüm işlemi. Ayarlanmazsa varsayılan dönüşüm işlemi kullanılır. Bu alan yalnızca callConversionReportingState, USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION olarak ayarlanırsa etkili olur.

adScheduleTargets[]

object (AdScheduleInfo)

Öğenin yayınlanabileceği tüm zaman aralıklarını belirten, çakışmayan zaman planlamalarının listesi. Günde en fazla 6, toplamda 42 zaman planlaması olabilir.

callOnly

boolean

Yalnızca arama reklamında web sitesine bağlantı olmadan telefon numarası gösterilip gösterilmediği. Microsoft Ads için geçerlidir.

callTrackingEnabled

boolean

Aramanın çağrı izlemede etkinleştirilip etkinleştirilmeyeceği. Microsoft Ads için geçerlidir.

useSearcherTimeZone

boolean

Arama yapan kullanıcının saat diliminde telefon uzantısının gösterilip gösterilmeyeceği. Microsoft Ads için geçerlidir.

startDate

string

Bu öğenin geçerli olduğu ve yayınlanmaya başlayabileceği başlangıç tarihi (yyyy-AA-gg biçiminde).

endDate

string

Bu öğenin geçerli olduğu ve yayınlanmaya devam ettiği son tarih (yyyy-AA-gg biçiminde).

CallConversionReportingState

Bir telefon araması dönüşümü işlemi durumu için olası veri türleri.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca dönüş değeri için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
DISABLED Telefon araması dönüşüm işlemi devre dışı bırakıldı.
USE_ACCOUNT_LEVEL_CALL_CONVERSION_ACTION Telefon araması dönüşümü işlemi, hesap düzeyinde ayarlanan telefon araması dönüşümü türünü kullanır.
USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION Telefon araması dönüşümü işlemi, kaynak (yalnızca telefon araması üreten reklamlar/telefon uzantıları) düzeyinde ayarlanan telefon araması dönüşümü türünü kullanır.

CallToActionAsset

Harekete geçirici mesaj öğesi.

JSON gösterimi
{
  "callToAction": enum (CallToActionType)
}
Alanlar
callToAction

enum (CallToActionType)

Harekete geçirici mesaj.

CallToActionType

Olası harekete geçirici mesaj türlerini açıklayan enum veri türü.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca dönüş değeri için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
LEARN_MORE Harekete geçirici mesaj türü "Daha fazla bilgi edinin" olmalıdır.
GET_QUOTE Harekete geçirici mesaj türü teklif al'dır.
APPLY_NOW Harekete geçirici mesaj türü "Hemen başvur" olmalıdır.
SIGN_UP Harekete geçirici mesaj türü kaydolmadır.
CONTACT_US Harekete geçirici mesaj türü "Bize ulaşın" olmalıdır.
SUBSCRIBE Harekete geçirici mesaj türü "abone ol"dur.
DOWNLOAD Harekete geçirici mesaj türü "İndir" olmalıdır.
BOOK_NOW Harekete geçirici mesaj türü "hemen rezervasyon yapın" olmalıdır.
SHOP_NOW Harekete geçirici mesaj türü "Hemen alışveriş yapın"dır.
BUY_NOW Harekete geçirici mesaj türü "Hemen satın alın" olmalıdır.
DONATE_NOW Harekete geçirici mesaj türü "Hemen bağış yapın"dır.
ORDER_NOW Harekete geçirici mesaj türü "Hemen sipariş verin"dir.
PLAY_NOW Harekete geçirici mesaj türü "Hemen oynat" olmalıdır.
SEE_MORE Harekete geçirici mesaj türü "Daha fazla göster"dir.
START_NOW Harekete geçirici mesaj türü "hemen başlayın"dır.
VISIT_SITE Harekete geçirici mesaj türü "siteyi ziyaret et"tir.
WATCH_NOW Harekete geçirici mesaj türü "Hemen izle"dir.

UnifiedLocationAsset

Birleştirilmiş yer öğesi.

JSON gösterimi
{
  "placeId": string,
  "businessProfileLocations": [
    {
      object (BusinessProfileLocation)
    }
  ],
  "locationOwnershipType": enum (LocationOwnershipType)
}
Alanlar
placeId

string

Yer kimlikleri, Google Places veritabanında ve Google Haritalar'da bir yeri benzersiz şekilde tanımlar. Bu alan, belirli bir müşteri kimliği ve öğe türü için benzersizdir. Yer kimliği hakkında daha fazla bilgi edinmek için https://developers.google.com/places/web-service/place-id adresini ziyaret edin.

businessProfileLocations[]

object (BusinessProfileLocation)

Müşterinin işletme konumlarının listesi. Bu değer yalnızca yer öğesi İşletme Profili hesabından senkronize ediliyorsa döndürülür. Aynı hesap altında, aynı yer kimliğini işaret eden birden fazla İşletme Profili girişi olabilir.

locationOwnershipType

enum (LocationOwnershipType)

Konum sahipliği türü. Tür BUSINESS_OWNER ise yer uzantısı olarak yayınlanır. Tür AFFILIATE ise satış ortağı konumu olarak yayınlanır.

BusinessProfileLocation

Bağlı İşletme Profili hesabından senkronize edilen İşletme Profili konum verileri.

JSON gösterimi
{
  "labels": [
    string
  ],
  "storeCode": string,
  "listingId": string
}
Alanlar
labels[]

string

İşletme Profili hesabındaki konum için reklamveren tarafından belirtilen etiket. Bu bilgiler, İşletme Profili hesabından senkronize edilir.

storeCode

string

Bu konumun İşletme Profili mağaza kodu. Bu bilgiler, İşletme Profili hesabından senkronize edilir.

listingId

string (int64 format)

Bu İşletme Profili konumunun listeleme kimliği. Bu bilgiler, bağlı İşletme Profili hesabından senkronize edilir.

LocationOwnershipType

Konum sahipliğinin olası türleri.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca dönüş değeri için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
BUSINESS_OWNER Konumun işletme sahibi(eski yer uzantısı - LE).
AFFILIATE Satış ortağı konumu(üçüncü taraf yer uzantısı - ALE).

AssetGroupAsset

AssetGroupAsset, bir öğe ile bir öğe grubu arasındaki bağlantıdır. AssetGroupAsset eklemek, bir öğeyi öğe grubuyla bağlar.

JSON gösterimi
{
  "resourceName": string,
  "assetGroup": string,
  "asset": string,
  "fieldType": enum (AssetFieldType),
  "status": enum (AssetLinkStatus)
}
Alanlar
resourceName

string

Öğe grubu öğesinin kaynak adı. Öğe grubu öğe kaynak adları şu biçimdedir:

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

assetGroup

string

Bu öğe grubu öğesinin bağlandığı öğe grubu.

asset

string

Bu öğe grubu öğesinin bağlandığı öğe.

fieldType

enum (AssetFieldType)

Öğenin öğe grubu içindeki yerleşiminin açıklaması. Örneğin: HEADLINE, YOUTUBE_VIDEO vb.

status

enum (AssetLinkStatus)

Bir öğe ile öğe grubu arasındaki bağlantının durumu.

AssetFieldType

Bir öğenin olası yerleşimlerini açıklayan enum veri türü.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca dönüş değeri için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
HEADLINE Öğe, başlık olarak kullanılmak üzere bağlanmıştır.
DESCRIPTION Öğe, açıklama olarak kullanılmak üzere bağlanmış olmalıdır.
MANDATORY_AD_TEXT Öğe, zorunlu reklam metni olarak kullanılmak üzere bağlanmıştır.
MARKETING_IMAGE Öğe, pazarlama resmi olarak kullanılmak üzere bağlanmış olmalıdır.
MEDIA_BUNDLE Öğe, medya paketi olarak kullanılmak üzere bağlanmış olmalıdır.
YOUTUBE_VIDEO Öğe, YouTube videosu olarak kullanılmak üzere bağlanmıştır.
BOOK_ON_GOOGLE Öğe, bir otel kampanyasında "Google üzerinden rezervasyon" özelliğinin etkinleştirildiğini belirtmek için bağlanır.
LEAD_FORM Öğe, potansiyel müşteri formu uzantısı olarak kullanılmak üzere bağlanmıştır.
PROMOTION Öğe, promosyon uzantısı olarak kullanılmak üzere bağlanmış olmalıdır.
CALLOUT Öğe, açıklama metni uzantısı olarak kullanılmak üzere bağlanmıştır.
STRUCTURED_SNIPPET Öğe, ek açıklamalı snippet uzantısı olarak kullanılmak üzere bağlanır.
MOBILE_APP Öğe, mobil uygulama uzantısı olarak kullanılmak üzere bağlanmış olmalıdır.
HOTEL_CALLOUT Öğe, otel açıklama metni uzantısı olarak kullanılmak üzere bağlanmıştır.
CALL Öğe, telefon uzantısı olarak kullanılmak üzere bağlanmıştır.
PRICE Öğe, fiyat uzantısı olarak kullanılmak üzere bağlanmıştır.
LONG_HEADLINE Öğe, uzun başlık olarak kullanılmak üzere bağlanmıştır.
BUSINESS_NAME Öğe, işletme adı olarak kullanılmak üzere bağlanmıştır.
SQUARE_MARKETING_IMAGE Öğe, kare pazarlama resmi olarak kullanılmak üzere bağlanmış olmalıdır.
PORTRAIT_MARKETING_IMAGE Öğe, dikey pazarlama görseli olarak kullanılmak üzere bağlanmıştır.
VIDEO Öğe, YouTube dışı bir logo olarak kullanılmak üzere bağlanmıştır.
CALL_TO_ACTION_SELECTION Öğe, harekete geçirici mesaj seçmek için kullanılacak şekilde bağlanır.
AD_IMAGE Öğe, reklam resmi seçmek için kullanılacak şekilde bağlanır.
HOTEL_PROPERTY Öğe, seyahat hedefleri için Maksimum Performans kampanyasında otel mülkü olarak kullanılmak üzere bağlanır.
LONG_DESCRIPTION Öğe, uzun açıklama olarak kullanılmak üzere bağlanmış olmalıdır.
CALL_TO_ACTION Öğe, harekete geçirici mesaj olarak kullanılmak üzere bağlanmıştır.

AssetGroupSignal

AssetGroupSignal, bir öğe grubundaki sinyali temsil eder. Sinyalin varlığı, dönüşüm gerçekleştirme olasılığı en yüksek olan kullanıcıları Maksimum Performans kampanyasına bildirir. Maksimum Performans kampanyaları; Arama, Görüntülü Reklam Ağı, video ve diğer platformlar genelinde dönüşüm bulmak amacıyla benzer veya daha güçlü amaca sahip yeni kullanıcıları aramak için sinyali kullanır.

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

string

Öğe grubu sinyalinin kaynak adı. Öğe grubu sinyali kaynak adının biçimi şöyledir:

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

assetGroup

string

Bu öğe grubu sinyalinin ait olduğu öğe grubu.

signal birleşik alanı. Öğe grubunun sinyali. signal aşağıdakilerden yalnızca biri olabilir:
audience

object (AudienceInfo)

Maksimum Performans kampanyası tarafından kullanılacak kitle sinyali.

AudienceInfo

Kitle ölçütü.

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

string

Kitle kaynak adı.

AssetGroupListingGroupFilter

AssetGroupListingGroupFilter, bir öğe grubundaki listeleme grubu filtre ağacı düğümünü temsil eder.

JSON gösterimi
{
  "resourceName": string,
  "assetGroup": string,
  "id": string,
  "type": enum (ListingGroupFilterType),
  "vertical": enum (ListingGroupFilterVertical),
  "caseValue": {
    object (ListingGroupFilterDimension)
  },
  "parentListingGroupFilter": string,
  "path": {
    object (ListingGroupFilterDimensionPath)
  }
}
Alanlar
resourceName

string

Öğe grubu listeleme grubu filtresinin kaynak adı. Öğe grubu listeleme grubu filtresi kaynak adı şu biçimdedir:

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

assetGroup

string

Bu öğe grubu listeleme grubu filtresinin parçası olduğu öğe grubu.

id

string (int64 format)

ListingGroupFilter'ın kimliği.

type

enum (ListingGroupFilterType)

Listeleme grubu filtre düğümünün türü.

vertical

enum (ListingGroupFilterVertical)

Geçerli düğüm ağacının temsil ettiği dikey. Aynı ağaçtaki tüm düğümler aynı sektöre ait olmalıdır.

caseValue

object (ListingGroupFilterDimension)

Bu listeleme grubunun üst öğesini daralttığı boyut değeri. Kök grup için tanımlanmamış.

parentListingGroupFilter

string

Üst listeleme grubu alt bölümünün kaynak adı. Kök listeleme grubu filtre düğümü için boş.

path

object (ListingGroupFilterDimensionPath)

Bu listeleme grubu filtresini tanımlayan boyutların yolu.

ListingGroupFilterType

Listeleme grubu filtresinin türü.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca dönüş değeri için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
SUBDIVISION Ürünlerin bazı listeleme boyutlarına göre alt bölümlere ayrılması.
UNIT_INCLUDED Dahil edilen bir listeleme grubu filtresi yaprak düğümü.
UNIT_EXCLUDED Hariç tutulan bir listeleme grubu filtresi yaprak düğümü.

ListingGroupFilterVertical

Listeleme grubu filtresinin dikey türü.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca dönüş değeri için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
SHOPPING Alışveriş temasını temsil eder. Dikey yalnızca perakende için Maksimum Performans kampanyalarında kullanılabilir.

ListingGroupFilterDimension

Öğe grubu listeleme grubu filtresi için listeleme boyutları.

JSON gösterimi
{

  // 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.
}
Alanlar
dimension birleşik alanı. Aşağıdaki türlerden birinin boyutu her zaman mevcuttur. dimension aşağıdakilerden yalnızca biri olabilir:
productBiddingCategory

object (ProductBiddingCategory)

Ürün teklifinin teklif kategorisi.

productBrand

object (ProductBrand)

Ürün teklifinin markası.

productChannel

object (ProductChannel)

Ürün teklifinin yerelliği.

productCondition

object (ProductCondition)

Ürün teklifinin durumu.

productCustomAttribute

object (ProductCustomAttribute)

Ürün teklifinin özel özelliği.

productItemId

object (ProductItemId)

Ürün teklifinin öğe kimliği.

productType

object (ProductType)

Ürün teklifinin türü.

ProductBiddingCategory

Belirli bir düzeydeki bir teklif kategorisinin bir öğesi. Üst düzey kategoriler 1. düzeyde, alt kategoriler 2. düzeyde yer alır. Şu anda 5 düzeye kadar destekliyoruz. Kullanıcı, kategorinin düzeyini belirten bir boyut türü belirtmelidir. Aynı alt bölümün tüm örnekleri aynı boyut türüne (kategori düzeyi) sahip olmalıdır.

JSON gösterimi
{
  "level": enum (ListingGroupFilterBiddingCategoryLevel),
  "id": string
}
Alanlar
level

enum (ListingGroupFilterBiddingCategoryLevel)

Kategorinin sınıflandırmadaki düzeyini gösterir.

id

string (int64 format)

Ürün teklifi kategorisinin kimliği.

Bu kimlik, https://support.google.com/merchants/answer/6324436 adresindeki makalede açıklanan google_product_category kimliğine eşdeğerdir.

ListingGroupFilterBiddingCategoryLevel

Listeleme grubu filtresi teklif kategorisinin düzeyi.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca dönüş değeri için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
LEVEL1 1. seviye
LEVEL2 2. seviye
LEVEL3 3. seviye
LEVEL4 4. seviye.
LEVEL5 5. seviye

ProductBrand

Ürünün markası.

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

string

Ürün markasının dize değeri.

ProductChannel

Ürün teklifinin yerelliği.

JSON gösterimi
{
  "channel": enum (ListingGroupFilterProductChannel)
}
Alanlar
channel

enum (ListingGroupFilterProductChannel)

Yerleşim biriminin değeri.

ListingGroupFilterProductChannel

Ürün teklifinin yerel durumunu açıklayan enum veri türü.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca dönüş değeri için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
ONLINE Öğe internette satılıyorsa
LOCAL Öğe yerel mağazalarda satılıyor.

ProductCondition

Ürün teklifinin durumu.

JSON gösterimi
{
  "condition": enum (ListingGroupFilterProductCondition)
}
Alanlar
condition

enum (ListingGroupFilterProductCondition)

Koşulun değeri.

ListingGroupFilterProductCondition

Ürün teklifinin durumunu açıklayan enum.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca dönüş değeri için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
NEW Ürünün durumu yeni olmalıdır.
REFURBISHED Ürünün durumu yenilenmiş olmalıdır.
USED Ürün durumu "ikinci el" olmalıdır.

ProductCustomAttribute

Ürün teklifinin özel özelliği.

JSON gösterimi
{
  "index": enum (ListingGroupFilterCustomAttributeIndex),
  "value": string
}
Alanlar
index

enum (ListingGroupFilterCustomAttributeIndex)

Özel özelliğin dizinini gösterir.

value

string

Ürün özel özelliğinin dize değeri.

ListingGroupFilterCustomAttributeIndex

Müşteri özelliklerinin dizini.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca dönüş değeri için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
INDEX0 İlk listeleme grubu filtresi özel özelliği.
INDEX1 İkinci listeleme grubu filtresi özel özelliği.
INDEX2 Üçüncü listeleme grubu filtresi özel özelliği.
INDEX3 Dördüncü listeleme grubu filtresi özel özelliği.
INDEX4 Beşinci listeleme grubu filtresi özel özelliği.

ProductItemId

Ürün teklifinin öğe kimliği.

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

string

Kimliğin değeri.

ProductType

Ürün teklifinin türü.

JSON gösterimi
{
  "level": enum (ListingGroupFilterProductTypeLevel),
  "value": string
}
Alanlar
level

enum (ListingGroupFilterProductTypeLevel)

Türün düzeyi.

value

string

Türün değeri.

ListingGroupFilterProductTypeLevel

Bir ürün teklifinin türünün seviyesini açıklayan enum.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca dönüş değeri için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
LEVEL1 1. seviye
LEVEL2 2. seviye
LEVEL3 3. seviye
LEVEL4 4. seviye.
LEVEL5 5. seviye

ListingGroupFilterDimensionPath

Bir listeleme grubu filtresini tanımlayan boyutların tanımlandığı yol.

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

object (ListingGroupFilterDimension)

Listeleme grubu filtre hiyerarşisi boyunca boyutların bu listeleme grubu filtresine giden tam yolu (kök düğüm hariç).

AssetGroupTopCombinationView

Öğe grubu öğelerinin en iyi kombinasyonlarının kullanımıyla ilgili bir görünüm.

JSON gösterimi
{
  "resourceName": string,
  "assetGroupTopCombinations": [
    {
      object (AssetGroupAssetCombinationData)
    }
  ]
}
Alanlar
resourceName

string

Öğe grubu üst kombinasyon görünümünün kaynak adı. AssetGroup Top Combination görünümü kaynak adları şu biçimdedir: "customers/{customerId}/assetGroupTopCombinationViews/{asset_group_id}~{asset_combination_category}"

assetGroupTopCombinations[]

object (AssetGroupAssetCombinationData)

Birlikte yayınlanan en iyi öğe kombinasyonları.

AssetGroupAssetCombinationData

Öğe grubu öğe kombinasyonu verileri

JSON gösterimi
{
  "assetCombinationServedAssets": [
    {
      object (AssetUsage)
    }
  ]
}
Alanlar
assetCombinationServedAssets[]

object (AssetUsage)

Sunulan öğeler.

AssetUsage

Öğenin kullanım bilgilerini içerir.

JSON gösterimi
{
  "asset": string,
  "servedAssetFieldType": enum (ServedAssetFieldType)
}
Alanlar
asset

string

Öğenin kaynak adı.

servedAssetFieldType

enum (ServedAssetFieldType)

Öğenin yayınlanan alan türü.

ServedAssetFieldType

Olası öğe alanı türleri.

Sıralamalar
UNSPECIFIED Değer belirtilmedi.
UNKNOWN

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

Bu, yalnızca yanıt değeri olan bir özelliktir.

HEADLINE_1 Öğe, başlık 1'de kullanılıyor.
HEADLINE_2 Öğe, 2. başlıkta kullanılıyor.
HEADLINE_3 Öğe, 3. başlıkta kullanılıyor.
DESCRIPTION_1 Öğe, 1. açıklamada kullanılıyor.
DESCRIPTION_2 Öğe, açıklama 2'de kullanılıyor.
HEADLINE Öğe bir başlıkta kullanıldı. Bu özelliği yalnızca reklamda tek bir başlık varsa kullanın. Aksi takdirde HEADLINE_1, HEADLINE_2 veya HEADLINE_3 numaralandırmalarını kullanın.
HEADLINE_IN_PORTRAIT Öğe, dikey resimde başlık olarak kullanıldı.
LONG_HEADLINE Öğe, uzun bir başlıkta (MultiAssetResponsiveAd'de kullanılır) kullanıldı.
DESCRIPTION Öğe, açıklamada kullanıldı. Bu parametreyi yalnızca reklamda tek bir açıklama varsa kullanın. Aksi takdirde DESCRIPTION_1 veya DESCRIPTION_@ sabitlerini kullanın.
DESCRIPTION_IN_PORTRAIT Öğe, dikey resimde açıklama olarak kullanıldı.
BUSINESS_NAME_IN_PORTRAIT Öğe, dikey resimde işletme adı olarak kullanıldı.
BUSINESS_NAME Öğe, işletme adı olarak kullanıldı.
MARKETING_IMAGE Öğe, pazarlama resmi olarak kullanılıyordu.
MARKETING_IMAGE_IN_PORTRAIT Öğe, dikey resimlerde pazarlama resmi olarak kullanıldı.
SQUARE_MARKETING_IMAGE Öğe, kare pazarlama resmi olarak kullanılıyordu.
PORTRAIT_MARKETING_IMAGE Öğe, dikey pazarlama görseli olarak kullanılıyordu.
CALL_TO_ACTION Öğe, harekete geçirici mesaj olarak kullanıldı.
YOU_TUBE_VIDEO Öğe, YouTube videosu olarak kullanıldı.
CALL Bu öğe çağrı olarak kullanılıyor.
MOBILE_APP Bu öğe mobil uygulama olarak kullanılıyor.
CALLOUT Bu öğe açıklama metni olarak kullanılıyor.
STRUCTURED_SNIPPET Bu öğe, ek açıklamalı snippet olarak kullanılıyor.
PRICE Bu öğe fiyat olarak kullanılıyor.
PROMOTION Bu öğe promosyon olarak kullanılıyor.
AD_IMAGE Bu öğe, resim olarak kullanılıyor.
LEAD_FORM Öğe, potansiyel müşteri formu olarak kullanılır.
DESCRIPTION_PREFIX Öğe, açıklama öneki olarak kullanılır.

AssetGroup

Bir öğe grubu. AssetGroupAsset, bir öğeyi öğe grubuna bağlamak için kullanılır. AssetGroupSignal, bir sinyali öğe grubuyla ilişkilendirmek için kullanılır.

JSON gösterimi
{
  "resourceName": string,
  "id": string,
  "campaign": string,
  "name": string,
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "status": enum (AssetGroupStatus),
  "path1": string,
  "path2": string,
  "adStrength": enum (AdStrength)
}
Alanlar
resourceName

string

Öğe grubunun kaynak adı. Öğe grubu kaynak adları şu biçimdedir:

customers/{customerId}/assetGroups/{asset_group_id}

id

string (int64 format)

Öğe grubunun kimliği.

campaign

string

Bu öğe grubunun ilişkilendirildiği kampanya. Öğe grubuna bağlı öğe.

name

string

Zorunlu. Öğe grubunun adı. Zorunlu. Minimum uzunluğu 1, maksimum uzunluğu 128 olmalıdır. Kampanya içinde benzersiz olmalıdır.

finalUrls[]

string

Tüm alanlar arası yönlendirmelerden sonraki nihai URL'lerin listesi. Maksimum Performans'ta, devre dışı bırakılmadığı sürece URL'ler varsayılan olarak genişletmeye uygundur.

finalMobileUrls[]

string

Tüm alanlar arası yönlendirmelerden sonraki nihai mobil URL'lerin listesi. Maksimum Performans'ta, devre dışı bırakılmadığı sürece URL'ler varsayılan olarak genişletmeye uygundur.

status

enum (AssetGroupStatus)

Öğe grubunun durumu.

path1

string

Reklamda gösterilen URL'ye eklenmiş olarak görünebilecek metnin ilk bölümü.

path2

string

Reklamda gösterilen URL'ye eklenmiş olarak görünebilecek metnin ikinci bölümü. Bu alan yalnızca path1 ayarlandığında belirlenebilir.

adStrength

enum (AdStrength)

Bu öğe grubunun genel reklam gücü.

AssetGroupStatus

Bir öğe grubunun olası durumları.

Sıralamalar
UNSPECIFIED Durum belirtilmedi.
UNKNOWN Alınan değer bu sürümde bilinmiyor.
ENABLED Öğe grubu etkinleştirilmiş olmalıdır.
PAUSED Öğe grubu duraklatıldı.
REMOVED Öğe grubu kaldırılır.

AdStrength

Olası reklam güçlerini listeleyen enum.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca dönüş değeri için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
PENDING Reklam gücü şu anda beklemede.
NO_ADS Reklam oluşturulamadı.
POOR Zayıf güç.
AVERAGE Ortalama güç.
GOOD Güçlü bir şifre seçin.
EXCELLENT Mükemmel dayanıklılık.

AssetSetAsset

AssetSetAsset, bir öğe ile öğe grubu arasındaki bağlantıdır. AssetSetAsset eklemek, bir öğeyi öğe grubuyla ilişkilendirir.

JSON gösterimi
{
  "resourceName": string,
  "assetSet": string,
  "asset": string,
  "status": enum (AssetSetAssetStatus)
}
Alanlar
resourceName

string

Feed öğesinin kaynak adı. Öğe grubu öğe kaynak adları şu biçimdedir:

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

assetSet

string

Bu feed öğesinin bağlandığı öğe grubu.

asset

string

Bu feed öğesinin bağlandığı öğe.

status

enum (AssetSetAssetStatus)

Feed öğesinin durumu. Salt okunur.

AssetSetAssetStatus

Bir öğe grubu öğesinin olası durumları.

Sıralamalar
UNSPECIFIED Durum belirtilmedi.
UNKNOWN Alınan değer bu sürümde bilinmiyor. Bu, yalnızca yanıt değeri olan bir özelliktir.
ENABLED Feed öğesi etkinleştirilmiş olmalıdır.
REMOVED Öğe kümesi öğesi kaldırılır.

AssetSet

Bir öğe koleksiyonunu temsil eden öğe grubu. Bir öğeyi öğe grubuna bağlamak için AssetSetAsset'i kullanın.

JSON gösterimi
{
  "id": string,
  "resourceName": string
}
Alanlar
id

string (int64 format)

Öğe grubunun kimliği.

resourceName

string

Öğe grubunun kaynak adı. Öğe grubu kaynak adları şu biçimdedir:

customers/{customerId}/assetSets/{asset_set_id}

BiddingStrategy

Bir teklif stratejisi.

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

string

Teklif stratejisinin kaynak adı. Teklif stratejisi kaynak adları şu biçimdedir:

customers/{customerId}/biddingStrategies/{bidding_strategy_id}

status

enum (BiddingStrategyStatus)

Teklif stratejisinin durumu.

Bu alan salt okunurdur.

type

enum (BiddingStrategyType)

Teklif stratejisinin türü. Teklif şemasını ayarlayarak bir teklif stratejisi oluşturun.

Bu alan salt okunurdur.

currencyCode

string

Teklif stratejisi tarafından kullanılan para birimi (ISO 4217 üç harfli kodu).

Yönetici müşterilerdeki teklif stratejileri için bu para birimi oluşturma sırasında ayarlanabilir ve varsayılan olarak yönetici müşterinin para birimi kullanılır. Yayın yapan müşteriler için bu alan ayarlanamaz. Yayın yapan müşterideki tüm stratejiler, yayın yapan müşterinin para birimini kullanır. Her durumda effectiveCurrencyCode alanı, strateji tarafından kullanılan para birimini döndürür.

id

string (int64 format)

Teklif stratejisinin kimliği.

name

string

Teklif stratejisinin adı. Bir hesaptaki tüm teklif stratejileri farklı şekilde adlandırılmalıdır.

Bu dizenin uzunluğu, UTF-8 bayt cinsinden 1 ile 255 arasında (bu değerler dahil) olmalıdır (kırpılmış).

effectiveCurrencyCode

string

Teklif stratejisi tarafından kullanılan para birimi (ISO 4217 üç harfli kodu).

Yönetici müşterilerindeki teklif stratejileri için bu, strateji oluşturulurken reklamveren tarafından belirlenen para birimidir. Müşterilere hizmet sunmak için bu, müşterinin para birimi kodudur.

Teklif stratejisi metrikleri bu para biriminde raporlanır.

Bu alan salt okunurdur.

campaignCount

string (int64 format)

Bu teklif stratejisine bağlı kampanya sayısı.

Bu alan salt okunurdur.

nonRemovedCampaignCount

string (int64 format)

Bu teklif stratejisine eklenmiş ve kaldırılmamış kampanya sayısı.

Bu alan salt okunurdur.

scheme birleşik alanı. Teklif verme düzeni.

Yalnızca bir tane ayarlanabilir. scheme aşağıdakilerden yalnızca biri olabilir:

enhancedCpc

object (EnhancedCpc)

Dönüşümle sonuçlanma olasılığı daha yüksek olan tıklamalar için teklifleri yükselten, bu olasılığın daha düşük olduğu tıklamalar için ise teklifleri düşüren bir teklif stratejisidir.

maximizeConversionValue

object (MaximizeConversionValue)

Bütçenizi harcarken kampanyalarınız için en yüksek dönüşüm değerini elde etmenize yardımcı olan bir otomatik teklif stratejisidir.

maximizeConversions

object (MaximizeConversions)

Bütçenizi harcarken kampanyalarınız için en fazla dönüşümü elde etmenize yardımcı olan bir otomatik teklif stratejisidir.

targetCpa

object (TargetCpa)

Teklifleri, belirlediğiniz hedef edinme başına maliyetle (EBM) mümkün olduğunca fazla dönüşüm elde etmenizi sağlayacak şekilde ayarlayan bir teklif stratejisidir.

targetImpressionShare

object (TargetImpressionShare)

Gösterimlerin belirli bir yüzdesine göre otomatik olarak optimizasyon yapan bir teklif stratejisidir.

targetOutrankShare

object (TargetOutrankShare)

Teklifleri, reklamverenin belirli bir rakibi geride bırakması gereken açık artırmaların hedef payına göre ayarlayan bir teklif stratejisidir. Bu alan kullanımdan kaldırılmıştır. Bu alanla yeni bir teklif stratejisi oluşturma veya bu alanı içeren teklif stratejilerini bir kampanyaya ekleme işlemi başarısız olur. Bu şema zaten doldurulmuş olan stratejilerde değişiklik yapılmasına izin verilir.

targetRoas

object (TargetRoas)

Belirli bir hedef reklam harcamalarından elde edilen gelir (ROAS) ortalamasını alırken geliri en üst düzeye çıkarmanıza yardımcı olan bir teklif stratejisi.

targetSpend

object (TargetSpend)

Tekliflerinizi bütçeniz dahilinde olabildiğince çok sayıda tıklama almanıza yardımcı olacak şekilde ayarlayan bir teklif stratejisidir.

BiddingStrategyStatus

Teklif stratejisinin olası durumları.

Sıralamalar
UNSPECIFIED Değer belirtilmedi.
UNKNOWN

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

Bu, yalnızca yanıt değeri olan bir özelliktir.

ENABLED Teklif stratejisi etkin olmalıdır.
REMOVED Teklif stratejisi kaldırılır.

BiddingStrategyType

Olası teklif stratejisi türlerini açıklayan enum veri türü.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca dönüş değeri için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
COMMISSION Komisyon, reklamverenin dönüşüm değerinin belirli bir kısmını ödediği otomatik bir teklif stratejisidir.
ENHANCED_CPC Geliştirilmiş TBM, dönüşümle sonuçlanma olasılığı daha yüksek olan tıklamalar için teklifleri yükselten, daha düşük olanlar için ise düşüren bir teklif stratejisidir.
INVALID Yalnızca dönüş değeri için kullanılır. Bir kampanyanın teklif stratejisi olmadığını gösterir. Bu durum, kampanyanın yayınlanmasını engeller. Örneğin, bir kampanya yönetici teklifi stratejisine eklenmiş olabilir ve sunum yapan hesabın yönetici hesabıyla bağlantısı daha sonra kaldırılabilir. Bu durumda kampanya, artık erişilemeyen yönetici teklif stratejisinden otomatik olarak ayrılır ve GEÇERSİZ teklif stratejisi türüne geçer.
MANUAL_CPA Reklamverenin, reklamveren tarafından belirtilen işlem başına teklif belirlemesine olanak tanıyan manuel teklif verme stratejisi.
MANUAL_CPC Kullanıcının tıklama başına ödeme yaptığı manuel tıklamaya dayalı teklif verme.
MANUAL_CPM Kullanıcının bin gösterim başına ödeme yaptığı manuel gösterime dayalı teklif verme.
MANUAL_CPV Video görüntüleme başına yapılandırılabilir bir tutar ödeyen teklif stratejisidir.
MAXIMIZE_CONVERSIONS Günlük bütçe göz önünde bulundurularak dönüşüm sayısını otomatik olarak en üst düzeye çıkaran bir teklif stratejisidir.
MAXIMIZE_CONVERSION_VALUE Bütçenizi harcarken geliri en üst düzeye çıkarmak için teklifleri otomatik olarak ayarlayan bir otomatik teklif stratejisidir.
PAGE_ONE_PROMOTED Maksimum TBM tekliflerini google.com'daki birinci sayfada veya birinci sayfada tanıtılan yerlerdeki hedef gösterimlere göre ayarlayan birinci sayfada tanıtım teklifi şeması. Bu enum değeri kullanımdan kaldırılmıştır.
PERCENT_CPC Yüzde TBM, tekliflerin bir ürün veya hizmet için reklamı yapılan fiyatın bir kısmı olduğu teklif stratejisidir.
TARGET_CPA Hedef EBM, tekliflerinizi, belirlediğiniz hedef edinme başına maliyetle (EBM) mümkün olduğunca fazla dönüşüm elde etmenizi sağlayacak şekilde ayarlayan otomatik teklif stratejisidir.
TARGET_CPM Hedef BGBM, teklifleri, belirlediğiniz hedef bin gösterim başına maliyetle (BGBM) mümkün olduğunca fazla gösterim elde etmenize yardımcı olacak şekilde ayarlayan otomatik teklif stratejisidir.
TARGET_IMPRESSION_SHARE Arama ağı reklamlarının belirli bir yüzdesinin ilk sayfanın üst kısmında (veya hedeflenen diğer konumda) gösterilmesi için teklifleri ayarlayan bir otomatik teklif stratejisi.
TARGET_OUTRANK_SHARE Hedef geçiş payı, teklifleri reklamverenin belirli bir rakibin önüne geçmesi gereken açık artırmaların hedef payına göre ayarlayan otomatik teklif stratejisidir. Bu enum değeri kullanımdan kaldırılmıştır.
TARGET_ROAS Hedef ROAS, belirli bir reklam harcamalarından elde edilen gelir hedefini (ROAS) ortalama bir değerde tutarken geliri en üst düzeye çıkarmanıza yardımcı olan otomatik bir teklif stratejisidir.
TARGET_SPEND Hedef harcama, tekliflerinizi bütçeniz dahilinde olabildiğince çok sayıda tıklama almanıza yardımcı olacak şekilde ayarlayan otomatik bir teklif stratejisidir.

EnhancedCpc

Bu türde alan yok.

Dönüşümle sonuçlanma olasılığı daha yüksek olan tıklamalar için teklifleri artıran, daha düşük olan tıklamalar için ise teklifleri düşüren otomatik bir teklif stratejisidir.

Bu teklif stratejisinin desteği sonlandırıldı ve artık oluşturulamaz. Eşdeğer işlevsellik için enhancedCpcEnabled parametresi true olarak ayarlanmış ManualCpc'yi kullanın.

MaximizeConversionValue

Bütçenizi harcarken kampanyalarınız için en yüksek dönüşüm değerini elde etmenize yardımcı olan bir otomatik teklif stratejisidir.

JSON gösterimi
{
  "cpcBidCeilingMicros": string,
  "cpcBidFloorMicros": string,
  "targetRoas": number
}
Alanlar
cpcBidCeilingMicros

string (int64 format)

Teklif stratejisi tarafından belirlenebilecek maksimum teklif sınırı. Bu sınır, strateji tarafından yönetilen tüm anahtar kelimeler için geçerlidir. Yalnızca portföy teklifi stratejileri için değiştirilebilir.

cpcBidFloorMicros

string (int64 format)

Teklif stratejisi tarafından belirlenebilecek minimum teklif sınırı. Bu sınır, strateji tarafından yönetilen tüm anahtar kelimeler için geçerlidir. Yalnızca portföy teklifi stratejileri için değiştirilebilir.

targetRoas

number

Reklam harcamalarından elde edilen gelir hedefi (ROAS) seçeneği. Ayarlanırsa teklif stratejisi, reklam harcamalarından elde edilen gelir hedefini ortalama bir değerde tutarken geliri en üst düzeye çıkarır. Hedef ROAS yüksekse teklif stratejisi, bütçenin tamamını harcamayabilir. Hedef ROAS ayarlanmamışsa teklif stratejisi, bütçe için mümkün olan en yüksek ROAS'ı elde etmeyi amaçlar.

MaximizeConversions

Bütçenizi harcarken kampanyalarınız için en fazla dönüşümü elde etmenize yardımcı olan bir otomatik teklif stratejisidir.

JSON gösterimi
{
  "cpcBidCeilingMicros": string,
  "cpcBidFloorMicros": string,
  "targetCpaMicros": string
}
Alanlar
cpcBidCeilingMicros

string (int64 format)

Teklif stratejisi tarafından belirlenebilecek maksimum teklif sınırı. Bu sınır, strateji tarafından yönetilen tüm anahtar kelimeler için geçerlidir. Yalnızca portföy teklifi stratejileri için değiştirilebilir.

cpcBidFloorMicros

string (int64 format)

Teklif stratejisi tarafından belirlenebilecek minimum teklif sınırı. Bu sınır, strateji tarafından yönetilen tüm anahtar kelimeler için geçerlidir. Yalnızca portföy teklifi stratejileri için değiştirilebilir.

targetCpaMicros

string (int64 format)

İşlem başına maliyet (EBM) hedefi seçeneği. Bu, teklif stratejisinin para biriminin mikro birimleriyle belirtilen dönüşüm işlemi başına harcamak istediğiniz ortalama tutardır. Ayarlanırsa teklif stratejisi, hedef işlem başına maliyet dahilinde veya altında olabildiğince fazla dönüşüm elde eder. Hedef EBM ayarlanmamışsa teklif stratejisi, bütçe göz önünde bulundurulduğunda mümkün olan en düşük EBM'yi elde etmeyi amaçlar.

TargetCpa

Teklifleri, belirlediğiniz hedef edinme başına maliyetle (EBM) olabildiğince çok dönüşüm elde etmenizi sağlamaya yardımcı olacak şekilde ayarlayan bir otomatik teklif stratejisidir.

JSON gösterimi
{
  "targetCpaMicros": string,
  "cpcBidCeilingMicros": string,
  "cpcBidFloorMicros": string
}
Alanlar
targetCpaMicros

string (int64 format)

Ortalama EBM hedefi. Bu hedef, hesabın para birimine göre minimum faturalandırılabilir birimden büyük veya bu birime eşit olmalıdır.

cpcBidCeilingMicros

string (int64 format)

Teklif stratejisi tarafından belirlenebilecek maksimum teklif sınırı. Bu sınır, strateji tarafından yönetilen tüm anahtar kelimeler için geçerlidir. Bu ayar yalnızca portföy teklifi stratejileri için belirlenmelidir.

cpcBidFloorMicros

string (int64 format)

Teklif stratejisi tarafından belirlenebilecek minimum teklif sınırı. Bu sınır, strateji tarafından yönetilen tüm anahtar kelimeler için geçerlidir. Bu ayar yalnızca portföy teklifi stratejileri için belirlenmelidir.

TargetImpressionShare

Arama ağı reklamlarının belirli bir yüzdesinin ilk sayfanın üst kısmında (veya hedeflenen diğer konumda) gösterilmesi için teklifleri ayarlayan bir otomatik teklif stratejisi.

JSON gösterimi
{
  "location": enum (TargetImpressionShareLocation),
  "locationFractionMicros": string,
  "cpcBidCeilingMicros": string
}
Alanlar
location

enum (TargetImpressionShareLocation)

Arama sonuçları sayfasındaki hedeflenen konum.

locationFractionMicros

string (int64 format)

Hedeflenen konumda gösterilecek reklamların seçilen kesri (mikro cinsinden). Örneğin, %1,10.000'e eşittir.

cpcBidCeilingMicros

string (int64 format)

Otomatik teklif sistemi tarafından belirtilmesine izin verilen en yüksek TBM teklifi. Bu, reklamveren tarafından girilen, tavanı belirleyen ve yerel mikro verilerde belirtilen zorunlu bir alandır.

TargetImpressionShareLocation

Olası hedefleri açıklayan enum veri türü.

Enum veri türleri
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca dönüş değeri için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
ANYWHERE_ON_PAGE Web sayfasının herhangi bir yeri.
TOP_OF_PAGE Üst reklam kutusu.
ABSOLUTE_TOP_OF_PAGE En üst reklam kutusundaki en üst slot.

TargetOutrankShare

Reklamverenin belirli bir rakibi geride bırakması gereken açık artırmaların hedef payına göre teklifleri ayarlayan otomatik teklif stratejisidir. Bu stratejinin desteği sonlandırılmıştır.

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

string (Int64Value format)

Teklif stratejisi tarafından belirlenebilecek maksimum teklif sınırı. Bu sınır, strateji tarafından yönetilen tüm anahtar kelimeler için geçerlidir.

TargetRoas

Belirli bir reklam harcamalarından elde edilen gelir (ROAS) hedefini ortalama bir değerde tutarken geliri en üst düzeye çıkarmanıza yardımcı olan otomatik teklif stratejisi.

JSON gösterimi
{
  "targetRoas": number,
  "cpcBidCeilingMicros": string,
  "cpcBidFloorMicros": string
}
Alanlar
targetRoas

number

Zorunlu. Harcama birimi başına seçilen gelir (dönüşüm verilerine göre). Değer, 0,01 ile 1.000,0 arasında (değerler dahil) olmalıdır.

cpcBidCeilingMicros

string (int64 format)

Teklif stratejisi tarafından belirlenebilecek maksimum teklif sınırı. Bu sınır, strateji tarafından yönetilen tüm anahtar kelimeler için geçerlidir. Bu ayar yalnızca portföy teklifi stratejileri için belirlenmelidir.

cpcBidFloorMicros

string (int64 format)

Teklif stratejisi tarafından belirlenebilecek minimum teklif sınırı. Bu sınır, strateji tarafından yönetilen tüm anahtar kelimeler için geçerlidir. Bu ayar yalnızca portföy teklifi stratejileri için belirlenmelidir.

TargetSpend

Bütçeniz dahilinde olabildiğince çok sayıda tıklama almanıza yardımcı olacak şekilde tekliflerinizi ayarlayan otomatik bir teklif stratejisidir.

JSON gösterimi
{
  "targetSpendMicros": string,
  "cpcBidCeilingMicros": string
}
Alanlar
targetSpendMicros
(deprecated)

string (int64 format)

Kullanımdan kaldırıldı: Tıklamaların en üst düzeye çıkarılacağı hedef harcama. Hedef harcama teklifi veren, bu değerin veya doğal sınırlama harcama tutarının daha küçüğünü harcamaya çalışır. Belirtilmezse bütçe, harcama hedefi olarak kullanılır. Bu alan kullanımdan kaldırıldı ve artık kullanılmamalıdır. Ayrıntılar için https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html adresini ziyaret edin.

cpcBidCeilingMicros

string (int64 format)

Teklif stratejisi tarafından belirlenebilecek maksimum teklif sınırı. Bu sınır, strateji tarafından yönetilen tüm anahtar kelimeler için geçerlidir.

CampaignBudget

Kampanya bütçesi.

JSON gösterimi
{
  "resourceName": string,
  "deliveryMethod": enum (BudgetDeliveryMethod),
  "period": enum (BudgetPeriod),
  "amountMicros": string
}
Alanlar
resourceName

string

Kampanya bütçesinin kaynak adı. Kampanya bütçesi kaynak adları şu biçimdedir:

customers/{customerId}/campaignBudgets/{campaign_budget_id}

deliveryMethod

enum (BudgetDeliveryMethod)

Kampanya bütçesinin harcanma hızını belirleyen yayınlama yöntemi.

Oluşturma işleminde belirtilmezse varsayılan olarak STANDARD değerine ayarlanır.

period

enum (BudgetPeriod)

Bütçenin harcanacağı dönem. Belirtilmezse varsayılan olarak DAILY (GÜNLÜK) değerine ayarlanır.

amountMicros

string (int64 format)

Bütçe tutarı, hesabın yerel para biriminde. Tutar, mikro birim olarak belirtilir. Bir milyon, bir para birimine eşittir. Aylık harcama, bu tutarın 30,4 katıyla sınırlıdır.

BudgetDeliveryMethod

Bütçenin olası yayınlanma yöntemleri.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca dönüş değeri için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
STANDARD Bütçe sunucusu, yayınlamayı tüm süre boyunca eşit şekilde kısıtlar.
ACCELERATED Bütçe sunucusu yayınlamayı kısıtlamaz ve reklamlar mümkün olduğunca hızlı yayınlanır.

BudgetPeriod

Bütçenin olası dönemi.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca dönüş değeri için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
DAILY Günlük bütçe.
FIXED_DAILY Sabit günlük bütçe.
CUSTOM_PERIOD Özel bütçe, yaşam boyu bütçe sınırını belirtmek için total_amount ile birlikte kullanılabilir.

Kampanya

Kampanya.

JSON gösterimi
{
  "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)
  },
  "effectiveLabels": [
    string
  ],
  "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,
  "feedTypes": [
    enum (AssetSetType)
  ],
  "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.
}
Alanlar
resourceName

string

Kampanyanın kaynak adı. Kampanya kaynağı adları şu biçime sahiptir:

customers/{customerId}/campaigns/{campaign_id}

status

enum (CampaignStatus)

Kampanyanın durumu.

Yeni bir kampanya eklendiğinde durum varsayılan olarak ETKİN olur.

servingStatus

enum (CampaignServingStatus)

Kampanyanın reklam sunma durumu.

biddingStrategySystemStatus

enum (BiddingStrategySystemStatus)

Kampanyanın teklif stratejisinin sistem durumu.

adServingOptimizationStatus

enum (AdServingOptimizationStatus)

Kampanyanın reklam sunma optimizasyonu durumu.

advertisingChannelType

enum (AdvertisingChannelType)

Kampanyadaki reklamlar için birincil yayın hedefi. Hedefleme seçenekleri networkSettings bölümünde hassaslaştırılabilir.

Bu alan zorunludur ve yeni kampanyalar oluşturulurken boş bırakılmamalıdır.

Yalnızca kampanya oluşturulurken ayarlanabilir. Bu alan, kampanya oluşturulduktan sonra değiştirilemez.

advertisingChannelSubType

enum (AdvertisingChannelSubType)

advertisingChannelType için isteğe bağlı iyileştirme. Üst kanal türünün geçerli bir alt türü olmalıdır.

Yalnızca kampanya oluşturulurken ayarlanabilir. Kampanya oluşturulduktan sonra bu alan değiştirilemez.

urlCustomParameters[]

object (CustomParameter)

trackingUrlTemplate, finalUrls veya mobile_final_urls içindeki özel parametre etiketlerinin yerine kullanılacak eşlemelerin listesi.

realTimeBiddingSetting

object (RealTimeBiddingSetting)

Yalnızca Ad Exchange ağını hedefleyen kampanyalarda kullanılabilen bir özellik olan gerçek zamanlı teklif verme ayarları.

networkSettings

object (NetworkSettings)

Kampanyanın ağ ayarları.

dynamicSearchAdsSetting

object (DynamicSearchAdsSetting)

Dinamik Arama Ağı Reklamları'nı (DSA) kontrol etmeye yönelik ayar.

shoppingSetting

object (ShoppingSetting)

Alışveriş kampanyalarını kontrol etme ayarı.

geoTargetTypeSetting

object (GeoTargetTypeSetting)

Reklam coğrafi hedefleme ayarı.

effectiveLabels[]

string

Bu kampanyaya eklenen etkili etiketlerin kaynak adları. Etkili bir etiket, bu kampanyaya devralınan veya doğrudan atanmış bir etikettir.

labels[]

string

Bu kampanyaya eklenen etiketlerin kaynak adları.

biddingStrategyType

enum (BiddingStrategyType)

Teklif stratejisinin türü.

Teklif stratejisi, teklif düzeni standart teklif stratejisi oluşturacak şekilde veya biddingStrategy alanı portföy teklifi stratejisi oluşturacak şekilde ayarlanarak oluşturulabilir.

Bu alan salt okunurdur.

accessibleBiddingStrategy

string

AccessibleBiddingStrategy'nin kaynak adı. Bu, "biddingStrategy" ile tanımlanan ekli portföy teklifi stratejisinin sınırsız özelliklerinin salt okunur görünümüdür. Kampanya portföy stratejisi kullanmıyorsa boş. Sınırsız strateji özellikleri, stratejinin paylaşıldığı tüm müşteriler tarafından kullanılabilir ve AccessibleBiddingStrategy kaynağında okunur. Buna karşılık, kısıtlanmış özellikler yalnızca stratejinin sahibi olan müşteriye ve yöneticilerine sunulur. Kısıtlanmış özellikler yalnızca BiddingStrategy kaynağında okunabilir.

frequencyCaps[]

object (FrequencyCapEntry)

Her kullanıcının bu kampanyanın reklamlarını ne sıklıkta göreceğini sınırlayan bir liste.

selectiveOptimization

object (SelectiveOptimization)

Bu kampanya için seçici optimizasyon ayarı. Bu ayar, kampanyanın optimize edileceği bir dizi dönüşüm işlemi içerir. Bu özellik yalnızca AdvertisingChannelType olarak MULTI_CHANNEL'ı ve AdvertisingChannelSubType olarak APP_CAMPAIGN veya APP_CAMPAIGN_FOR_ENGAGEMENT'ı kullanan uygulama kampanyaları için geçerlidir.

optimizationGoalSetting

object (OptimizationGoalSetting)

Bu kampanya için optimizasyon hedefi ayarı (bir dizi optimizasyon hedefi türü içerir).

trackingSetting

object (TrackingSetting)

İzleme bilgileri için kampanya düzeyinde ayarlar.

engineId

string

Harici arama motoru hesabındaki kampanyanın kimliği. Bu alan yalnızca Google Ads dışındaki hesaplar (ör. Yahoo Japan, Microsoft, Baidu vb.) içindir. Google Ads öğesi için bunun yerine "campaign.id" kullanın.

excludedParentAssetFieldTypes[]

enum (AssetFieldType)

Bu kampanyadan hariç tutulması gereken öğe alanı türleri. Bu alan türlerine sahip öğe bağlantıları, bu kampanya tarafından üst düzeyden devralınmaz.

createTime

string

Bu kampanyanın oluşturulduğu zamanı gösteren zaman damgası. Zaman damgası, müşterinin saat diliminde ve "yyyy-AA-gg SS:dd:ss " biçimindedir. createTime, v1'de kullanımdan kaldırılacak. Bunun yerine creationTime özelliğini kullanın.

creationTime

string

Bu kampanyanın oluşturulduğu zamanı gösteren zaman damgası. Zaman damgası, müşterinin saat diliminde ve "yyyy-AA-gg SS:dd:ss" biçimindedir.

lastModifiedTime

string

Bu kampanyanın en son değiştirildiği tarih ve saat. Tarih ve saat, müşterinin saat diliminde ve "yyyy-AA-gg SS:dd:ss.ssssss" biçimindedir.

feedTypes[]

enum (AssetSetType)

Doğrudan bu kampanyaya eklenen feed türleri.

id

string (int64 format)

Kampanyanın kimliği.

name

string

Kampanyanın adı.

Bu alan zorunludur ve yeni kampanyalar oluşturulurken boş bırakılmamalıdır.

Boş (kod noktası 0x0), yeni satır (kod noktası 0xA) veya satır başı karakteri (kod noktası 0xD) içermemelidir.

trackingUrlTemplate

string

İzleme URL'si oluşturmak için kullanılan URL şablonu.

campaignBudget

string

Kampanyanın kampanya bütçesinin kaynak adı.

startDate

string

Kampanyanın, YYYY-AA-GG biçiminde, müşterinin saat diliminde yayınlanmaya başladığı tarih.

endDate

string

Kampanyanın, müşterinin saat diliminde YYYY-AA-GG biçimindeki son günü. Oluşturma sırasında varsayılan olarak 30.12.2037 tarihi belirlenir. Bu da kampanyanın süresiz olarak yayınlanacağı anlamına gelir. Mevcut bir kampanyanın süresiz olarak yayınlanmasını sağlamak için bu alanı 2037-12-30 olarak ayarlayın.

finalUrlSuffix

string

Paralel izleme ile sunulan açılış sayfalarına sorgu parametreleri eklemek için kullanılan sonek.

urlExpansionOptOut

boolean

URL genişletmenin daha hedeflenmiş URL'lere genişletilmesini devre dışı bırakmayı ifade eder. Devre dışı bırakılırsa (doğru), yalnızca öğe grubundaki nihai URL'ler veya reklamverenin Google Merchant Center ya da iş verileri feed'lerinde belirtilen URL'ler hedeflenir. Etkinleştirilirse (yanlış), alanın tamamı hedeflenir. Bu alan yalnızca varsayılan değerin yanlış olduğu Maksimum Performans kampanyaları için ayarlanabilir.

campaign_bidding_strategy birleşik alanı. Kampanyanın teklif stratejisi.

Portföy (BiddingStrategy hizmeti aracılığıyla oluşturulmuş) veya kampanyaya yerleştirilmiş standart teklif stratejisi olmalıdır. campaign_bidding_strategy aşağıdakilerden yalnızca biri olabilir:

biddingStrategy

string

Kampanya tarafından kullanılan portföy teklifi stratejisinin kaynak adı.

manualCpa

object (ManualCpa)

Standart manuel EBM teklif stratejisi. Reklamverenin, reklamveren tarafından belirtilen işlem başına teklif belirlemesine olanak tanıyan manuel teklif verme stratejisi. Yalnızca Yerel Hizmet kampanyalarında desteklenir.

manualCpc

object (ManualCpc)

Standart manuel TBM teklifi verme stratejisi. Kullanıcının tıklama başına ödeme yaptığı manuel tıklama tabanlı teklif verme.

manualCpm

object (ManualCpm)

Standart manuel BGBM teklif stratejisi. Kullanıcının bin gösterim başına ödeme yaptığı manuel gösterime dayalı teklif verme.

maximizeConversions

object (MaximizeConversions)

Bütçenizi harcarken dönüşüm sayısını otomatik olarak en üst düzeye çıkaran standart dönüşümleri artırma teklif stratejisi.

maximizeConversionValue

object (MaximizeConversionValue)

Bütçenizi harcarken geliri en üst düzeye çıkarmak için teklifleri otomatik olarak belirleyen standart dönüşüm değerini artırma teklif stratejisi.

targetCpa

object (TargetCpa)

Belirlediğiniz hedef edinme başına maliyetle (EBM) mümkün olduğunca fazla dönüşüm elde etmenize yardımcı olmak için teklifleri otomatik olarak belirleyen standart hedef EBM teklifi stratejisi.

targetImpressionShare

object (TargetImpressionShare)

Hedef gösterim payı teklif stratejisi. Teklifleri, seçilen bir gösterim yüzdesine ulaşacak şekilde ayarlayan otomatik bir teklif stratejisidir.

targetRoas

object (TargetRoas)

Belirli bir reklam harcamalarından elde edilen gelir (ROAS) hedefini ortalama bir değerde tutarken geliri otomatik olarak en üst düzeye çıkaran standart hedef ROAS teklifi stratejisi.

targetSpend

object (TargetSpend)

Bütçeniz dahilinde olabildiğince çok sayıda tıklama almanıza yardımcı olmak için tekliflerinizi otomatik olarak ayarlayan standart bir hedef harcama teklif stratejisidir.

percentCpc

object (PercentCpc)

Tekliflerin, bazı ürün veya hizmetlerin reklamı yapılan fiyatının bir kısmı olduğu standart TBM yüzdesi teklif stratejisi.

targetCpm

object (TargetCpm)

Bin gösterim başına maliyeti otomatik olarak optimize eden bir teklif stratejisi.

CampaignStatus

Bir kampanyanın olası durumları.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca dönüş değeri için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
ENABLED Kampanya etkin ve reklam gösterebilir durumda.
PAUSED Kampanya, kullanıcı tarafından duraklatıldı.
REMOVED Kampanya kaldırıldı.

CampaignServingStatus

Bir kampanyanın olası yayın durumları.

Sıralamalar
UNSPECIFIED Değer belirtilmedi.
UNKNOWN

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

Bu, yalnızca yanıt değeri olan bir özelliktir.

SERVING Yayınlanıyor.
NONE Yok.
ENDED Sona erdi.
PENDING Pending.
SUSPENDED Askıya alındı.

BiddingStrategySystemStatus

Bir BiddingStrategy'nin olası sistem durumları.

Sıralamalar
UNSPECIFIED Beklenmeyen bir hata oluştuğunu belirten sinyaller (ör. teklif stratejisi türü veya durum bilgisi bulunamadı).
UNKNOWN Yalnızca dönüş değeri için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
ENABLED Teklif stratejisi etkin ve AdWords, stratejiyle ilgili herhangi bir sorun bulamıyor.
LEARNING_NEW Teklif stratejisi yakın zamanda oluşturulduğu veya yeniden etkinleştirildiği için öğrenme sürecindedir.
LEARNING_SETTING_CHANGE Teklif stratejisi, son ayar değişikliği nedeniyle öğreniyor.
LEARNING_BUDGET_CHANGE Teklif stratejisi, yakın zamanda yapılan bir bütçe değişikliği nedeniyle öğreniyor.
LEARNING_COMPOSITION_CHANGE Teklif stratejisine bağlı kampanya, reklam grubu veya anahtar kelime sayısında yapılan son değişiklik nedeniyle teklif stratejisi öğreniyor.
LEARNING_CONVERSION_TYPE_CHANGE Teklif stratejisi, dönüşüm raporlamasına bağlıdır ve müşteri kısa süre önce teklif stratejisiyle alakalı dönüşüm türlerini değiştirmiştir.
LEARNING_CONVERSION_SETTING_CHANGE Teklif stratejisi, dönüşüm raporlamasına bağlıdır ve müşteri yakın zamanda dönüşüm ayarlarını değiştirmiştir.
LIMITED_BY_CPC_BID_CEILING Teklif stratejisi, teklif tavanıyla sınırlanır.
LIMITED_BY_CPC_BID_FLOOR Teklif stratejisi, teklif tabanıyla sınırlıdır.
LIMITED_BY_DATA Geçtiğimiz haftalarda yeterli dönüşüm trafiği olmadığından teklif stratejisi sınırlı.
LIMITED_BY_BUDGET Bu teklif stratejisindeki anahtar kelimelerin önemli bir kısmı bütçeyle sınırlı.
LIMITED_BY_LOW_PRIORITY_SPEND Harcamasına öncelik verilmediği için teklif stratejisi hedef harcamasına ulaşamıyor.
LIMITED_BY_LOW_QUALITY Bu teklif stratejisindeki anahtar kelimelerin önemli bir bölümünün kalite puanı düşük.
LIMITED_BY_INVENTORY Teklif stratejisi, dar hedefleme nedeniyle bütçesini tam olarak harcayamaz.
MISCONFIGURED_ZERO_ELIGIBILITY SSC için dönüşüm izleme (ping yok) ve/veya yeniden pazarlama listeleri eksik.
MISCONFIGURED_CONVERSION_TYPES Teklif stratejisi, dönüşüm raporlamasına bağlıdır ve müşteride bu stratejiye göre raporlanabilecek dönüşüm türleri yoktur.
MISCONFIGURED_CONVERSION_SETTINGS Teklif stratejisi, dönüşüm raporlamasına bağlıdır ve müşterinin dönüşüm ayarları yanlış yapılandırılmıştır.
MISCONFIGURED_SHARED_BUDGET Teklif stratejisi dışında, stratejiye dahil edilen kampanyalarla aynı bütçeleri paylaşan kampanyalar var.
MISCONFIGURED_STRATEGY_TYPE Kampanya geçersiz bir strateji türüne sahip ve yayınlanmıyor.
PAUSED Teklif stratejisi etkin değil. Teklif stratejisine bağlı etkin kampanya, reklam grubu veya anahtar kelime yoktur. Teklif stratejisine bağlı etkin bütçe yoksa
UNAVAILABLE Bu teklif stratejisi şu anda durum raporlamasını desteklemiyor.
MULTIPLE_LEARNING Söz konusu dönemde bu teklif stratejisi için birden fazla LEARNING_* sistem durumu vardı.
MULTIPLE_LIMITED Söz konusu dönemde bu teklif stratejisi için birden fazla SINIRLI_* sistem durumu vardı.
MULTIPLE_MISCONFIGURED Söz konusu dönemde bu teklif stratejisi için birden fazla YANLIŞ_YAPILANDIRILMIŞ_* sistem durumu vardı.
MULTIPLE Söz konusu dönemde bu teklif stratejisi için birden fazla sistem durumu vardı.

AdServingOptimizationStatus

Olası yayın durumlarını açıklayan enum veri türü.

Sıralamalar
UNSPECIFIED Değer belirtilmedi.
UNKNOWN

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

Bu, yalnızca yanıt değeri olan bir özelliktir.

OPTIMIZE Reklam sunumu, kampanyanın TO'suna göre optimize edilir.
CONVERSION_OPTIMIZE Reklam sunumu, kampanyanın TO'su * dönüşümüne göre optimize edilir. Kampanya, dönüşüm optimize edici teklif stratejisinde değilse varsayılan olarak OPTIMIZED (OPTİMİZE EDİLMİŞ) olur.
ROTATE Reklamlar 90 gün boyunca eşit sıklıkta dönüşümlü yayınlanır, ardından tıklamalar için optimize edilir.
ROTATE_INDEFINITELY Daha düşük performanslı reklamları daha yüksek performanslı reklamlarla daha eşit aralıklarla gösterin ve optimizasyon yapmayın.
UNAVAILABLE Reklam sunma optimizasyonu durumu kullanılamaz.

AdvertisingChannelType

Çeşitli reklam kanalı türlerini açıklayan enum.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca dönüş değeri için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
SEARCH Arama Ağı'nı seçin. Görüntülü reklam paketi ve Arama Ağı+ kampanyalarını içerir.
DISPLAY Yalnızca Google Görüntülü Reklam Ağı.
SHOPPING Alışveriş kampanyaları, alışveriş mülkünde ve google.com arama sonuçlarında yayınlanır.
HOTEL Otel reklamı kampanyaları
VIDEO Video kampanyaları
MULTI_CHANNEL Birden fazla kanalda yayınlanan uygulama kampanyaları ve etkileşime yönelik uygulama kampanyaları
LOCAL Yerel reklam kampanyaları.
SMART Akıllı kampanyalar
PERFORMANCE_MAX Maksimum Performans kampanyaları
LOCAL_SERVICES Yerel Hizmetler kampanyaları
DISCOVERY Discovery kampanyaları
TRAVEL Seyahat kampanyaları.
SOCIAL Sosyal kampanyalar.

AdvertisingChannelSubType

Farklı kanal alt türlerini açıklayan enum.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca dönüş değeri olarak kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
SEARCH_MOBILE_APP Arama Ağı için mobil uygulama kampanyaları.
DISPLAY_MOBILE_APP Görüntülü Reklam Ağı için mobil uygulama kampanyaları.
SEARCH_EXPRESS Arama Ağı için AdWords Express kampanyaları.
DISPLAY_EXPRESS Görüntülü reklamlar için AdWords Express kampanyaları.
SHOPPING_SMART_ADS Akıllı Alışveriş kampanyaları
DISPLAY_GMAIL_AD Gmail reklam kampanyaları
DISPLAY_SMART_CAMPAIGN Akıllı görüntülü reklam kampanyaları: Bu alt türde yeni kampanyalar oluşturulamaz.
VIDEO_OUTSTREAM Yayın dışı video kampanyaları
VIDEO_ACTION Video TrueView for Action kampanyaları.
VIDEO_NON_SKIPPABLE Atlanamayan video reklamların kullanıldığı video kampanyaları.
APP_CAMPAIGN Arama Ağı, Play, YouTube ve Google Görüntülü Reklam Ağı dahil olmak üzere Android veya iOS uygulamanızı Google'ın en büyük mülklerinde kolayca tanıtmanıza olanak tanıyan uygulama kampanyası.
APP_CAMPAIGN_FOR_ENGAGEMENT Etkileşim için uygulama kampanyası: Arama, YouTube ve Google Görüntülü Reklam Ağı dahil olmak üzere Google'ın en önemli mülklerinden bazılarında uygulamayla yeniden etkileşimi artırmaya odaklanır.
LOCAL_CAMPAIGN Yerel reklamcılık için özel olarak tasarlanmış kampanyalar.
SHOPPING_COMPARISON_LISTING_ADS Alışveriş ürün karşılaştırma kampanyaları.
SMART_CAMPAIGN Standart Akıllı kampanyalar
VIDEO_SEQUENCE Sıralı video reklamlar içeren video kampanyaları.
APP_CAMPAIGN_FOR_PRE_REGISTRATION Google Play, YouTube ve Görüntülü Reklam Ağı'ndaki birden fazla reklam kanalını hedefleyen, mobil uygulama ön kaydı reklamcılığına özel ön kayıt uygulama kampanyası.
VIDEO_REACH_TARGET_FREQUENCY Hedef sıklık teklifi verme stratejisine sahip video erişim kampanyası.
TRAVEL_ACTIVITIES Seyahat Etkinlikleri kampanyaları.
SOCIAL_FACEBOOK_TRACKING_ONLY Facebook yalnızca sosyal medya kampanyalarını izler.

RealTimeBiddingSetting

Yalnızca Ad Exchange ağını hedefleyen kampanyalarda kullanılabilen bir özellik olan gerçek zamanlı teklif verme ayarları.

JSON gösterimi
{
  "optIn": boolean
}
Alanlar
optIn

boolean

Kampanyanın gerçek zamanlı teklif verme özelliğini kullanıp kullanmadığı.

NetworkSettings

Kampanyanın ağ ayarları.

JSON gösterimi
{
  "targetGoogleSearch": boolean,
  "targetSearchNetwork": boolean,
  "targetContentNetwork": boolean,
  "targetPartnerSearchNetwork": boolean
}
Alanlar
targetSearchNetwork

boolean

Reklamların Google Arama Ağı'ndaki iş ortağı sitelerinde yayınlanıp yayınlanmayacağı (targetGoogleSearch seçeneğinin de true olması gerekir).

targetContentNetwork

boolean

Reklamların Google Görüntülü Reklam Ağı'ndaki belirtilen yerleşimlerde yayınlanıp yayınlanmayacağı. Yerleşimler, yerleşim ölçütü kullanılarak belirtilir.

targetPartnerSearchNetwork

boolean

Reklamların Google iş ortağı ağında yayınlanıp yayınlanmayacağı. Bu özellik yalnızca belirli Google iş ortağı hesaplarında kullanılabilir.

DynamicSearchAdsSetting

Dinamik Arama Ağı Reklamları'nı (DSA) kontrol etmeye yönelik ayar.

JSON gösterimi
{
  "domainName": string,
  "languageCode": string,
  "useSuppliedUrlsOnly": boolean
}
Alanlar
domainName

string

Zorunlu. Bu ayarın temsil ettiği internet alan adı (ör. "google.com" veya "www.google.com").

languageCode

string

Zorunlu. Alan adının dilini belirten dil kodu (ör. "en").

useSuppliedUrlsOnly

boolean

Kampanyanın yalnızca reklamveren tarafından sağlanan URL'leri kullanıp kullanmadığı.

ShoppingSetting

Alışveriş kampanyaları için ayar. Kampanya tarafından reklamı yapılabilecek ürünler evrenini ve bu kampanyanın diğer Alışveriş kampanyalarıyla nasıl etkileşimde bulunduğunu tanımlar.

JSON gösterimi
{
  "feedLabel": string,
  "useVehicleInventory": boolean,
  "merchantId": string,
  "salesCountry": string,
  "campaignPriority": integer,
  "enableLocal": boolean
}
Alanlar
feedLabel

string

Kampanyaya dahil edilecek ürünlerin feed etiketi. Yalnızca feedLabel veya salesCountry ayarlanabilir. salesCountry yerine kullanılıyorsa feedLabel alanı, aynı biçimde ülke kodlarını kabul eder. Örneğin: "XX". Aksi takdirde, Google Merchant Center'da feed etiketi için kullanılan herhangi bir dize olabilir.

useVehicleInventory

boolean

Araç listeleme envanterinin hedeflenip hedeflenmeyeceği.

merchantId

string (int64 format)

Merchant Center hesabının kimliği. Bu alan, oluşturma işlemleri için gereklidir. Bu alan, Alışveriş kampanyaları için değiştirilemez.

salesCountry

string

Kampanyaya dahil edilecek ürünlerin satış ülkesi.

campaignPriority

integer

Kampanyanın önceliği. Sayısal olarak daha yüksek önceliklere sahip kampanyalar, daha düşük önceliklere sahip kampanyalara göre önceliklidir. Bu alan, Alışveriş kampanyaları için gereklidir ve değerler 0 ile 2 arasında (bu değerler dahil) olmalıdır. Bu alan, Akıllı Alışveriş kampanyaları için isteğe bağlıdır ancak ayarlanırsa 3'e eşit olmalıdır.

enableLocal

boolean

Yerel ürünlerin dahil edilip edilmeyeceği.

GeoTargetTypeSetting

Reklamların coğrafi hedeflemesiyle ilgili bir ayar koleksiyonunu temsil eder.

JSON gösterimi
{
  "positiveGeoTargetType": enum (PositiveGeoTargetType),
  "negativeGeoTargetType": enum (NegativeGeoTargetType)
}
Alanlar
positiveGeoTargetType

enum (PositiveGeoTargetType)

Bu kampanyada pozitif coğrafi hedefleme için kullanılan ayar.

negativeGeoTargetType

enum (NegativeGeoTargetType)

Bu kampanyada negatif coğrafi hedefleme için kullanılan ayar.

PositiveGeoTargetType

Olası pozitif coğrafi hedef türleri.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Bu sürümde değer bilinmiyor.
PRESENCE_OR_INTEREST Kullanıcı, reklamverenin hedeflediği konumlarda bulunuyorsa veya bu konumlara ilgi gösteriyorsa reklamın tetikleneceğini belirtir.
SEARCH_INTEREST Kullanıcı, reklamverenin hedeflediği konumları aradığında reklamın tetiklenmesini belirtir. Bu özellik yalnızca Arama Ağı ve standart Alışveriş kampanyalarında kullanılabilir.
PRESENCE Kullanıcı, reklamverenin hedeflediği konumlarda bulunuyorsa veya düzenli olarak bu konumlarda bulunuyorsa reklamın tetikleneceğini belirtir.

NegativeGeoTargetType

Olası negatif coğrafi hedef türleri.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Bu sürümde değer bilinmiyor.
PRESENCE_OR_INTEREST Kullanıcının, reklamverenin hariç tuttuğu yerlerde bulunması veya bu yerlere ilgi göstermesi durumunda reklamı görmesinin engellendiğini belirtir.
PRESENCE Kullanıcının, reklamverenin hariç tutulan konumlarında bulunması durumunda reklamı görmesinin engellendiğini belirtir.

FrequencyCapEntry

Bu türde alan yok.

Bir reklamın (veya bir grup reklamın) belirli bir dönemde bir kullanıcıya gösterilebileceği maksimum sayıyı belirten bir kural.

SelectiveOptimization

Bu kampanya için seçici optimizasyon ayarı. Bu ayar, kampanyanın optimize edileceği bir dizi dönüşüm işlemi içerir. Bu özellik yalnızca AdvertisingChannelType olarak MULTI_CHANNEL'ı ve AdvertisingChannelSubType olarak APP_CAMPAIGN veya APP_CAMPAIGN_FOR_ENGAGEMENT'ı kullanan uygulama kampanyaları için geçerlidir.

JSON gösterimi
{
  "conversionActions": [
    string
  ]
}
Alanlar
conversionActions[]

string

Bu kampanyayı optimize etmek için dönüşüm işlemleriyle ilgili seçilen kaynak adı grubu.

OptimizationGoalSetting

Bu kampanya için optimizasyon hedefi ayarı (bir dizi optimizasyon hedefi türü içerir).

JSON gösterimi
{
  "optimizationGoalTypes": [
    enum (OptimizationGoalType)
  ]
}
Alanlar
optimizationGoalTypes[]

enum (OptimizationGoalType)

Optimizasyon hedefi türlerinin listesi.

OptimizationGoalType

Optimizasyon hedefinin türü

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca dönüş değeri olarak kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
CALL_CLICKS Telefon araması tıklamaları için optimizasyon yapın. Telefon araması tıklaması dönüşümleri, kullanıcıların bir reklamı görüntüledikten sonra mağazayla iletişime geçmek için "Ara"yı seçme sayısıdır.
DRIVING_DIRECTIONS Yol tarifleri için optimizasyon yapın. Yol tarifi dönüşümleri, kullanıcıların bir reklamı görüntüledikten sonra mağazaya gitmek için "Yol tarifi al"ı seçme sayısıdır.
APP_PRE_REGISTRATION Ön kayıt için optimizasyon yapın. Ön kayıt dönüşümleri, uygulama yayınlandığında bildirim almak için yapılan ön kayıt sayısıdır.

TrackingSetting

İzleme bilgileri için kampanya düzeyinde ayarlar.

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

string

Dinamik izleme için kullanılan URL.

AssetSetType

Olası öğe grubu türleri.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca dönüş değeri için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
PAGE_FEED Sayfa öğesi grubu.
DYNAMIC_EDUCATION Dinamik eğitim öğesi grubu.
MERCHANT_CENTER_FEED Google Merchant Center öğe grubu.
DYNAMIC_REAL_ESTATE Dinamik gayrimenkul öğe grubu.
DYNAMIC_CUSTOM Dinamik özel öğe grubu.
DYNAMIC_HOTELS_AND_RENTALS Dinamik otel ve kiralık yer öğesi grubu.
DYNAMIC_FLIGHTS Dinamik uçuşlar öğe grubu.
DYNAMIC_TRAVEL Dinamik seyahat öğesi grubu.
DYNAMIC_LOCAL Dinamik yerel öğe grubu.
DYNAMIC_JOBS Dinamik işler öğe grubu.
LOCATION_SYNC Yer senkronizasyonu düzeyinde öğe grubu.
BUSINESS_PROFILE_DYNAMIC_LOCATION_GROUP İşletme Profili yer grubu öğe grubu.
CHAIN_DYNAMIC_LOCATION_GROUP Hem sahip olunan konumlar hem de satış ortağı konumları için kullanılabilen zincir yer grubu öğe grubu.
STATIC_LOCATION_GROUP Hem sahip olunan yerler hem de satış ortağı yerleri için kullanılabilen statik yer grubu öğe grubu.
HOTEL_PROPERTY Otel mülkü feed'ini seyahat hedefleri için Maksimum Performans kampanyalarına bağlamak üzere kullanılan otel mülkü öğe grubu.
TRAVEL_FEED Seyahat feed'i öğe grubu türü. Otel feed'ini veya Yapılacak Şeyler (etkinlikler) feed'ini temsil edebilir.

ManualCpa

Bu türde alan yok.

Reklamverenin, reklamveren tarafından belirtilen işlem başına teklif belirlemesine olanak tanıyan manuel teklif verme stratejisi.

ManualCpc

Kullanıcının tıklama başına ödeme yaptığı manuel tıklama tabanlı teklif verme.

JSON gösterimi
{
  "enhancedCpcEnabled": boolean
}
Alanlar
enhancedCpcEnabled

boolean

Tekliflerin, dönüşüm optimize edici verilerine göre artırılıp artırılmayacağı.

ManualCpm

Bu türde alan yok.

Kullanıcının bin gösterim başına ödeme yaptığı manuel gösterime dayalı teklif verme.

PercentCpc

Tekliflerin, bazı ürün veya hizmetlerin reklamı yapılan fiyatının bir kısmı olduğu teklif stratejisi.

JSON gösterimi
{
  "cpcBidCeilingMicros": string,
  "enhancedCpcEnabled": boolean
}
Alanlar
cpcBidCeilingMicros

string (int64 format)

Teklif stratejisi tarafından belirlenebilecek maksimum teklif sınırı. Bu, reklamveren tarafından girilen ve yerel mikro sitelerde belirtilen isteğe bağlı bir alandır. Not: Sıfır değeri, bid_ceiling tanımlanmamış gibi yorumlanır.

enhancedCpcEnabled

boolean

Dönüşüm olasılığına bağlı olarak her açık artırmadaki teklifi artırır veya azaltır. Tek tek teklifler cpcBidCeilingMicros değerini aşabilir ancak bir kampanyanın ortalama teklif tutarı bu değeri aşmamalıdır.

TargetCpm

Bu türde alan yok.

Hedef BGBM (bin gösterim başına maliyet), belirlediğiniz hedef BGBM'ye göre performansı optimize etmek için teklifleri belirleyen bir otomatik teklif stratejisidir.

CampaignAsset

Kampanya ile öğe arasındaki bağlantı.

JSON gösterimi
{
  "resourceName": string,
  "status": enum (AssetLinkStatus),
  "campaign": string,
  "asset": string
}
Alanlar
resourceName

string

Kampanya öğesinin kaynak adı. CampaignAsset kaynak adları şu biçimdedir:

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

status

enum (AssetLinkStatus)

Kampanya öğesinin durumu.

campaign

string

Öğenin bağlı olduğu kampanya.

asset

string

Kampanyaya bağlı öğe.

CampaignAssetSet

CampaignAssetSet, bir kampanya ile bir öğe grubu arasındaki bağlantıdır. CampaignAssetSet eklemek, bir öğe grubunu kampanyayla ilişkilendirir.

JSON gösterimi
{
  "resourceName": string,
  "campaign": string,
  "assetSet": string,
  "status": enum (AssetSetLinkStatus)
}
Alanlar
resourceName

string

Kampanya öğe grubunun kaynak adı. Öğe grubu öğe kaynak adları şu biçimdedir:

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

campaign

string

Bu öğe grubunun bağlı olduğu kampanya.

assetSet

string

Kampanyaya bağlı öğe grubu.

status

enum (AssetSetLinkStatus)

Kampanya öğe grubu öğesinin durumu. Salt okunur.

CampaignAudienceView

Kampanya kitle görünümü. Kampanya ve kitle ölçütüne göre toplanan, Görüntülü Reklam Ağı ve YouTube Ağı reklamları için ilgi alanları ve yeniden pazarlama listeleri ile arama ağı reklamlarına yönelik yeniden pazarlama listelerinden (ARYPL) elde edilen performans verilerini içerir. Bu görünüm yalnızca kampanya düzeyinde eklenen kitleleri içerir.

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

string

Kampanya kitle görünümünün kaynak adı. Kampanya kitle görünümü kaynak adları şu biçimdedir:

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

CampaignCriterion

Kampanya ölçütü.

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

string

Kampanya ölçütünün kaynak adı. Kampanya kriteri kaynak adları şu biçimdedir:

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

displayName

string

Ölçütün görünen adı.

Bu alan, mutasyonlar için yoksayılır.

type

enum (CriterionType)

Ölçütün türü.

status

enum (CampaignCriterionStatus)

Ölçütün durumu.

lastModifiedTime

string

Bu kampanya ölçütünün en son değiştirildiği tarih ve saat. Tarih ve saat, müşterinin saat diliminde ve "yyyy-AA-gg SS:dd:ss.ssssss" biçimindedir.

criterionId

string (int64 format)

Ölçütün kimliği.

Bu alan, değiştirme sırasında yoksayılır.

bidModifier

number

Ölçüt eşleştiğinde teklifler için değiştirici. Değiştirici, 0,1-10,0 aralığında olmalıdır. Hedeflenebilir ölçüt türlerinin çoğu değiştiricileri destekler. Bir cihaz türünü devre dışı bırakmak için 0'ı kullanın.

negative

boolean

Ölçütün hedeflenip (false) hedeflenmeyeceği veya hariç tutulup (true) tutulmayacağı.

criterion birleşik alanı. Kampanya ölçütü.

Tam olarak bir tane ayarlanmalıdır. criterion aşağıdakilerden yalnızca biri olabilir:

keyword

object (KeywordInfo)

Anahtar kelime.

location

object (LocationInfo)

Konum'a dokunun.

device

object (DeviceInfo)

Cihaz) belirtin.

ageRange

object (AgeRangeInfo)

Yaş grubu.

gender

object (GenderInfo)

Cinsiyet.

userList

object (UserListInfo)

Kullanıcı Listesi

language

object (LanguageInfo)

Dil.

webpage

object (WebpageInfo)

Web sayfası.

locationGroup

object (LocationGroupInfo)

Yer grubu

CampaignCriterionStatus

CampaignCriterion'ın olası durumları.

Sıralamalar
UNSPECIFIED Değer belirtilmedi.
UNKNOWN

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

Bu, yalnızca yanıt değeri olan bir özelliktir.

ENABLED Kampanya ölçütü etkinleştirilmiş olmalıdır.
PAUSED Kampanya ölçütü duraklatıldı.
REMOVED Kampanya ölçütü kaldırıldı.

LanguageInfo

Dil ölçütü

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

string

Dil sabiti kaynak adı.

LocationGroupInfo

Bir feed aracılığıyla belirtilen konum listesinin etrafındaki yarıçap.

JSON gösterimi
{
  "geoTargetConstants": [
    string
  ],
  "radiusUnits": enum (LocationGroupRadiusUnits),
  "feedItemSets": [
    string
  ],
  "radius": string
}
Alanlar
geoTargetConstants[]

string

Feed'deki coğrafi alanın kapsamını kısıtlayan coğrafi hedef sabiti. Şu anda yalnızca bir coğrafi hedef sabiti kullanılabilir.

radiusUnits

enum (LocationGroupRadiusUnits)

Yarıçap birimi. Coğrafi hedef sabitleri için mil ve metre desteklenir. Feed öğesi kümeleri için mil ve metre desteklenir. Bu değer zorunludur ve CREATE işlemlerinde ayarlanmalıdır.

feedItemSets[]

string

FeedItem'ları hedeflenen FeedItemSet'ler. Birden fazla kimlik belirtilirse en az bir sette görünen tüm öğeler hedeflenir. Bu alan, geoTargetConstants ile kullanılamaz. Bu isteğe bağlıdır ve yalnızca CREATE işlemlerinde ayarlanabilir.

radius

string (int64 format)

Hedeflenen konumların çevresindeki yarıçapı belirten birimlerdeki mesafe. Bu değer zorunludur ve CREATE işlemlerinde ayarlanmalıdır.

LocationGroupRadiusUnits

Yer grubundaki yarıçap mesafesinin birimi (örneğin, MILES)

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca dönüş değeri için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
METERS Metre
MILES Mil
MILLI_MILES Milli Miles

CampaignEffectiveLabel

Bir kampanya ile etkili bir etiket arasındaki ilişkiyi gösterir. Etkili bir etiket, bu kampanyaya devralınan veya doğrudan atanmış bir etikettir.

JSON gösterimi
{
  "resourceName": string,
  "campaign": string,
  "label": string,
  "ownerCustomerId": string
}
Alanlar
resourceName

string

Kaynağın adı. CampaignEffectivelabel kaynak adları şu biçime sahiptir: customers/{ownerCustomerId}/campaignEffectiveLabels/{campaign_id}~{label_id}

campaign

string

Etkili etiketin eklendiği kampanya.

label

string

Kampanyaya atanan etkin etiket.

ownerCustomerId

string (int64 format)

Etkin etiketin sahibi olan müşterinin kimliği.

CampaignLabel

Bir kampanya ile bir etiket arasındaki ilişkiyi gösterir.

JSON gösterimi
{
  "resourceName": string,
  "campaign": string,
  "label": string,
  "ownerCustomerId": string
}
Alanlar
resourceName

string

Kaynağın adı. Kampanya etiketi kaynak adları şu biçime sahiptir: customers/{ownerCustomerId}/campaignLabels/{campaign_id}~{label_id}

campaign

string

Etiketin eklendiği kampanya.

label

string

Kampanyaya atanan etiket.

ownerCustomerId

string (int64 format)

Etiketin sahibi olan müşterinin kimliği.

CartDataSalesView

Alışveriş sepeti verileriyle satış görünümü.

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

string

Alışveriş sepeti verileri satış görünümünün kaynak adı. Alışveriş sepeti verileri satış görünümü kaynak adları şu biçimdedir: customers/{customerId}/cartDataSalesView

Kitle

Kitle, hedef segmentlerinizin bölümlerini temsil eden kitleler oluşturabilmeniz için ayrıntılı demografi ve yakın ilgi alanları gibi farklı segment özelliklerini bir araya getirmenizi sağlayan etkili bir hedefleme seçeneğidir.

JSON gösterimi
{
  "resourceName": string,
  "id": string,
  "name": string,
  "description": string
}
Alanlar
resourceName

string

Kitlenin kaynak adı. Kitle adları şu biçime sahiptir:

customers/{customerId}/audiences/{audience_id}

id

string (int64 format)

Kitlenin kimliği.

name

string

Zorunlu. Kitlenin adı. Tüm kitleler arasında benzersiz olmalıdır. En az 1, en fazla 255 karakter uzunluğunda olmalıdır.

description

string

Bu kitlenin açıklaması.

ConversionAction

Dönüşüm işlemi

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

string

Dönüşüm işleminin kaynak adı. Dönüşüm işlemi kaynak adları şu biçimdedir:

customers/{customerId}/conversionActions/{conversion_action_id}

creationTime

string

ISO 8601 biçiminde Floodlight etkinliğinin oluşturulma zaman damgası.

status

enum (ConversionActionStatus)

Dönüşüm etkinliği birikimi için bu dönüşüm işleminin durumu.

type

enum (ConversionActionType)

Bu dönüşüm işleminin türü.

category

enum (ConversionActionCategory)

Bu dönüşüm işlemi için bildirilen dönüşümlerin kategorisi.

valueSettings

object (ValueSettings)

Bu dönüşüm işlemiyle ilişkili dönüşüm etkinliklerinin değeriyle ilgili ayarlar.

attributionModelSettings

object (AttributionModelSettings)

Bu dönüşüm işleminin ilişkilendirme modeliyle ilgili ayarlar.

floodlightSettings

object (FloodlightSettings)

Floodlight dönüşüm türleri için Floodlight ayarları.

id

string (int64 format)

Dönüşüm işleminin kimliği.

name

string

Dönüşüm işleminin adı.

Bu alan zorunludur ve yeni dönüşüm işlemleri oluşturulurken boş bırakılmamalıdır.

primaryForGoal

boolean

Bir dönüşüm işleminin primaryForGoal biti yanlışsa dönüşüm işlemi, müşteri dönüşüm hedefi veya kampanya dönüşüm hedefinden bağımsız olarak tüm kampanyalar için teklif verilebilir değildir. Ancak özel dönüşüm hedefleri primaryForGoal özelliğini dikkate almaz. Bu nedenle, bir kampanyada primaryForGoal = false dönüşüm işlemiyle yapılandırılmış özel bir dönüşüm hedefi varsa bu dönüşüm işlemi teklif verilebilir olmaya devam eder. Ayarlanmamışsa varsayılan olarak primaryForGoal değeri true olur. V9 'da primaryForGoal, isteğe bağlı olarak bildirilmediği için yalnızca oluşturulduktan sonra bir "güncelleme" işlemiyle false olarak ayarlanabilir.

ownerCustomer

string

Dönüşüm işlemi sahibinin müşteri kaynak adı veya sistem tarafından tanımlanmış bir dönüşüm işlemiyse null.

includeInClientAccountConversionsMetric

boolean

Bu dönüşüm işleminin "clientAccountConversions" metriğine dahil edilip edilmeyeceği.

includeInConversionsMetric

boolean

Bu dönüşüm işleminin "dönüşümler" metriğine dahil edilip edilmeyeceği.

clickThroughLookbackWindowDays

string (int64 format)

Bir etkileşim (ör. tıklama) ile dönüşüm etkinliği arasında geçebilecek maksimum gün sayısı.

appId

string

Uygulama dönüşümü işlemi için uygulama kimliği.

ConversionActionStatus

Dönüşüm işleminin olası durumları.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca dönüş değeri için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
ENABLED Dönüşümler kaydedilir.
REMOVED Dönüşümler kaydedilmez.
HIDDEN Dönüşümler kaydedilmez ve dönüşüm işlemi kullanıcı arayüzünde görünmez.

ConversionActionType

Dönüşüm işleminin olası türleri.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca dönüş değeri için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
AD_CALL Kullanıcı bir reklamın telefon uzantısını tıkladığında gerçekleşen dönüşümler.
CLICK_TO_CALL Mobil cihazdaki bir kullanıcının telefon numarasını tıkladığında gerçekleşen dönüşümler.
GOOGLE_PLAY_DOWNLOAD Kullanıcı bir mobil uygulamayı Google Play Store'dan indirdiğinde gerçekleşen dönüşümler.
GOOGLE_PLAY_IN_APP_PURCHASE Kullanıcının Android faturalandırma aracılığıyla bir uygulamada satın alma işlemi gerçekleştirmesiyle oluşan dönüşümler.
UPLOAD_CALLS Reklamveren tarafından izlenen ve yüklenen telefon araması dönüşümleri.
UPLOAD_CLICKS Reklamveren tarafından izlenen ve ilişkilendirilmiş tıklamalarla yüklenen dönüşümler.
WEBPAGE Web sayfasında gerçekleşen dönüşümler.
WEBSITE_CALL Kullanıcının, reklamverenin web sitesinden dinamik olarak oluşturulmuş bir telefon numarasını aradığında gerçekleşen dönüşümler.
STORE_SALES_DIRECT_UPLOAD Birinci taraf veya üçüncü taraf satıcı verisi yüklemelerine dayalı mağaza satışı dönüşümü. Yalnızca izin verilenler listesindeki müşteriler mağaza satışları doğrudan yükleme türlerini kullanabilir.
STORE_SALES Birinci taraf veya üçüncü taraf satıcı verisi yüklemelerine ve/veya ödeme ağlarındaki kartların kullanıldığı mağaza içi satın alma işlemlerine dayalı mağaza satışları dönüşümü. Mağaza satışı türlerini yalnızca izin verilenler listesindeki müşteriler kullanabilir. Salt okunur.
FIREBASE_ANDROID_FIRST_OPEN Firebase aracılığıyla izlenen Android uygulaması ilk açılış dönüşümleri.
FIREBASE_ANDROID_IN_APP_PURCHASE Firebase üzerinden izlenen uygulama içi satın alma dönüşümleri.
FIREBASE_ANDROID_CUSTOM Firebase üzerinden izlenen Android uygulaması özel dönüşümleri.
FIREBASE_IOS_FIRST_OPEN Firebase üzerinden izlenen iOS uygulaması ilk açılış dönüşümleri.
FIREBASE_IOS_IN_APP_PURCHASE Firebase üzerinden izlenen iOS uygulamasındaki uygulama içi satın alma dönüşümleri.
FIREBASE_IOS_CUSTOM Firebase üzerinden izlenen iOS uygulaması özel dönüşümleri.
THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN Üçüncü taraf uygulama analizi aracılığıyla izlenen Android uygulaması ilk açılış dönüşümleri.
THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE Üçüncü taraf uygulama analizleri aracılığıyla izlenen uygulama içi satın alma dönüşümleri.
THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM Üçüncü taraf uygulama analizleri aracılığıyla izlenen Android uygulaması özel dönüşümleri.
THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN iOS uygulamasının ilk açılış dönüşümleri, üçüncü taraf uygulama analizleri aracılığıyla izlenir.
THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE Üçüncü taraf uygulama analizleri aracılığıyla izlenen uygulama içi satın alma dönüşümleri.
THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM Üçüncü taraf uygulama analizleri aracılığıyla izlenen iOS uygulaması özel dönüşümleri.
ANDROID_APP_PRE_REGISTRATION Bir kullanıcının Google Play Store'dan bir mobil uygulamaya ön kayıt yaptırdığında gerçekleşen dönüşümler. Salt okunur.
ANDROID_INSTALLS_ALL_OTHER_APPS Uygulamaya özel bir tür tarafından izlenmeyen tüm Google Play indirmelerini izleyen dönüşümler. Salt okunur.
FLOODLIGHT_ACTION Kullanıcıların bir reklamverenin reklamlarından birini gördükten veya tıkladıktan sonra belirli bir web sayfasını kaç kez ziyaret ettiğini sayan Floodlight etkinliği. Salt okunur.
FLOODLIGHT_TRANSACTION Yapılan satış sayısını veya satın alınan öğe sayısını izleyen Floodlight etkinliği. Her satışın toplam değerini de yakalayabilir. Salt okunur.
GOOGLE_HOSTED Bir reklamla etkileşimden sonra Google'ın ürün ve hizmetlerindeki yerel işlemleri izleyen dönüşümler. Salt okunur.
LEAD_FORM_SUBMIT Kullanıcı bir potansiyel müşteri formu gönderdiğinde bildirilen dönüşümler. Salt okunur.
SALESFORCE

Kullanımdan kaldırıldı: Salesforce entegrasyonu kaldırılacak ve dönüşümlerinizi Salesforce'tan içe aktarmak için geliştirilmiş bir yöntemle değiştirilecek. - https://support.google.com/google-ads/answer/14728349 adresine göz atın.

SEARCH_ADS_360 Search Ads 360 Floodlight verilerinden içe aktarılan dönüşümler. Salt okunur.
SMART_CAMPAIGN_AD_CLICKS_TO_CALL Akıllı kampanya özel ölçütleri kullanılarak, arama izleme ayarı yapılmadan akıllı kampanya reklamlarında gerçekleşen telefon araması dönüşümleri. Salt okunur.
SMART_CAMPAIGN_MAP_CLICKS_TO_CALL Kullanıcı, Google Haritalar'daki bir arama öğesini tıklar. Yalnızca akıllı kampanyalar. Salt okunur.
SMART_CAMPAIGN_MAP_DIRECTIONS Kullanıcı, Google Haritalar'da bir işletme konumuna yol tarifi ister. Yalnızca akıllı kampanyalar. Salt okunur.
SMART_CAMPAIGN_TRACKED_CALLS Akıllı kampanya özel ölçütleri kullanılarak çağrı izleme kurulumuyla Akıllı kampanya reklamlarında gerçekleşen telefon araması dönüşümleri. Salt okunur.
STORE_VISITS Kullanıcı bir reklamverenin perakende mağazasını ziyaret ettiğinde gerçekleşen dönüşümler. Salt okunur.
WEBPAGE_CODELESS Ayrı ayrı kodlanmış etkinlik snippet'leri kullanmayan, web sitesi etkinliklerinden (ör. form gönderimleri veya sayfa yüklemeleri) oluşturulan dönüşümler. Salt okunur.
UNIVERSAL_ANALYTICS_GOAL Bağlı Universal Analytics hedeflerinden gelen dönüşümler.
UNIVERSAL_ANALYTICS_TRANSACTION Bağlı Universal Analytics işlemlerinden gelen dönüşümler.
GOOGLE_ANALYTICS_4_CUSTOM Bağlı Google Analytics 4 özel etkinlik dönüşümlerinden gelen dönüşümler.
GOOGLE_ANALYTICS_4_PURCHASE Bağlı Google Analytics 4 satın alma dönüşümlerinden gelen dönüşümler.

ConversionActionCategory

Bir ConversionAction ile ilişkilendirilen dönüşümlerin kategorisi.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca dönüş değeri için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
DEFAULT Varsayılan kategori.
PAGE_VIEW Bir sayfayı ziyaret eden kullanıcı
PURCHASE Satın alma, satış veya "sipariş verildi" etkinliği.
SIGNUP Kullanıcı kaydı işlemi.
LEAD Potansiyel müşteri kazandıran işlem.
DOWNLOAD Yazılım indirme işlemi (ör. uygulama indirme).
ADD_TO_CART Bir reklamveren sitesinde alışveriş sepetine veya çantasına ürün eklenmesi.
BEGIN_CHECKOUT Bir kullanıcının reklamverenin sitesinde ödeme akışına girmesi
SUBSCRIBE_PAID Bir ürün veya hizmet için ücretli aboneliğin başlangıcı.
PHONE_CALL_LEAD Bir reklamverenin teklifiyle ilgilenildiğini belirten bir çağrı.
IMPORTED_LEAD Harici bir kaynaktan Google Ads'e aktarılan bir potansiyel müşteri dönüşümü.
SUBMIT_LEAD_FORM Bir reklamveren sitesinde işletme ilgisini belirten bir formun gönderilmesi.
BOOK_APPOINTMENT Reklamverenin işletmesiyle randevu alma
REQUEST_QUOTE Fiyat teklifi veya fiyat tahmini isteği.
GET_DIRECTIONS Bir reklamverenin işletme konumunu ziyaret etme niyetiyle yapılan arama.
OUTBOUND_CLICK Bir reklamverenin iş ortağının sitesine yapılan tıklama.
CONTACT Reklamverene yapılan telefon araması, SMS, e-posta, sohbet veya diğer iletişim türleri.
ENGAGEMENT Uzun site süresi veya Google Analytics (GA) akıllı hedefi gibi bir web sitesi etkileşimi etkinliği. GA, Firebase ve GA Gold hedef içe aktarma işlemleri için kullanılmak üzere tasarlanmıştır.
STORE_VISIT Fiziksel mağaza konumuna yapılan ziyaret.
STORE_SALE Fiziksel mağazada gerçekleşen satış.
QUALIFIED_LEAD Harici bir kaynaktan Google Ads'e aktarılan ve reklamveren (pazarlama/satış ekibi) tarafından uygunluğu belirlenen bir potansiyel müşteri dönüşümü. Potansiyel müşteriden satışa giden yolculukta reklamverenler potansiyel müşteriler edinir ve ardından tüketiciye ulaşarak bu potansiyel müşteriler üzerinde işlem yapar. Tüketici ilgileniyorsa ve ürünü satın alabilirse reklamveren bu tür potansiyel müşterileri "nitelikli potansiyel müşteriler" olarak işaretler.
CONVERTED_LEAD Harici bir kaynaktan Google Ads'e aktarılan ve potansiyel müşteri kazanma reklamvereni tarafından tanımlanan seçili bir aşamayı tamamlamış potansiyel müşteri dönüşümü.

ValueSettings

Bu dönüşüm işlemiyle ilişkili dönüşüm etkinliklerinin değeriyle ilgili ayarlar.

JSON gösterimi
{
  "defaultValue": number,
  "defaultCurrencyCode": string,
  "alwaysUseDefaultValue": boolean
}
Alanlar
defaultValue

number

Bu dönüşüm işlemi için dönüşüm etkinlikleri geçersiz, izin verilmeyen veya eksik bir değerle gönderildiğinde ya da bu dönüşüm işlemi her zaman varsayılan değeri kullanacak şekilde yapılandırıldığında kullanılacak değer.

defaultCurrencyCode

string

Bu dönüşüm işlemi için dönüşüm etkinlikleri geçersiz veya eksik bir para birimi koduyla gönderildiğinde ya da bu dönüşüm işlemi her zaman varsayılan değeri kullanacak şekilde yapılandırıldığında kullanılacak para birimi kodu.

alwaysUseDefaultValue

boolean

Bu dönüşüm işlemi için dönüşüm etkinliklerinde belirtilen değer ve para birimi kodu yerine varsayılan değerin ve varsayılan para birimi kodunun kullanılıp kullanılmayacağını kontrol eder.

AttributionModelSettings

Bu dönüşüm işleminin ilişkilendirme modeliyle ilgili ayarlar.

JSON gösterimi
{
  "attributionModel": enum (AttributionModel),
  "dataDrivenModelStatus": enum (DataDrivenModelStatus)
}
Alanlar
attributionModel

enum (AttributionModel)

Bu dönüşüm işleminin ilişkilendirme modeli türü.

dataDrivenModelStatus

enum (DataDrivenModelStatus)

Dönüşüm işlemi için veriye dayalı ilişkilendirme modelinin durumu.

AttributionModel

Belirli bir dönüşüm için kredinin, olası birçok önceki etkileşim arasında nasıl dağıtılacağını açıklayan ilişkilendirme modeli.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca dönüş değeri için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
EXTERNAL Harici ilişkilendirme kullanır.
GOOGLE_ADS_LAST_CLICK Dönüşüm kredisinin tamamını son tıklamayla ilişkilendirir.
GOOGLE_SEARCH_ATTRIBUTION_FIRST_CLICK Google Arama ilişkilendirmesini kullanarak dönüşümle ilgili tüm krediyi ilk tıklamayla ilişkilendirir.
GOOGLE_SEARCH_ATTRIBUTION_LINEAR Google Arama ilişkilendirmesini kullanarak dönüşüm kredisini tüm tıklamaları arasında eşit olarak dağıtır.
GOOGLE_SEARCH_ATTRIBUTION_TIME_DECAY Google Arama ilişkilendirmesini kullanarak dönüşüm için kredinin katlanarak artan bir bölümünü daha yeni tıklamalarla ilişkilendirir (yarılanma süresi 1 haftadır).
GOOGLE_SEARCH_ATTRIBUTION_POSITION_BASED Dönüşüm kredisinin% 40'ını ilk ve son tıklamalarla ilişkilendirir. Kalan% 20, diğer tüm tıklamalar arasında eşit olarak dağıtılır. Bu, Google Arama ilişkilendirmesini kullanır.
GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN Google Arama ilişkilendirmesini kullanarak tıklamalar arasında uygun kredi dağıtımını belirlemek için makine öğrenimini kullanan esnek bir modeldir.

DataDrivenModelStatus

Veriye dayalı model durumlarını numaralandırır.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca dönüş değeri için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
AVAILABLE Veriye dayalı model kullanılabilir.
STALE Veriye dayalı model güncel değildir. En az 7 gündür güncellenmemişse Hâlâ kullanılıyor ancak 30 gün boyunca güncellenmezse süresi dolar.
EXPIRED Veriye dayalı modelin süresi doldu. En az 30 gündür güncellenmediği için kullanılamaz. Bu durumun en yaygın nedeni, son 30 günlük dönemde gerekli sayıda etkinlik olmamasıdır.
NEVER_GENERATED Veriye dayalı model hiç oluşturulmamış. Bunun en yaygın nedeni, herhangi bir 30 günlük dönemde hiçbir zaman gerekli sayıda etkinlik olmamasıdır.

FloodlightSettings

Floodlight dönüşüm işlemiyle ilgili ayarlar.

JSON gösterimi
{
  "activityGroupTag": string,
  "activityTag": string,
  "activityId": string
}
Alanlar
activityGroupTag

string

Dönüşümler raporlanırken bir Floodlight etkinlik grubunu tanımlamak için kullanılan dize.

activityTag

string

Dönüşümler raporlanırken bir Floodlight etkinliğini tanımlamak için kullanılan dize.

activityId

string (int64 format)

DoubleClick Campaign Manager'daki (DCM) Floodlight etkinliğinin kimliği.

ConversionCustomVariable

Dönüşüm özelleştirilebilen değişkeni https://support.google.com/sa360/answer/13567857 adresindeki "Yeni Search Ads 360'taki özel Floodlight metrikleri ve boyutları hakkında" başlıklı makaleyi inceleyin.

JSON gösterimi
{
  "resourceName": string,
  "id": string,
  "name": string,
  "tag": string,
  "status": enum (ConversionCustomVariableStatus),
  "ownerCustomer": string,
  "family": enum (ConversionCustomVariableFamily),
  "cardinality": enum (ConversionCustomVariableCardinality),
  "floodlightConversionCustomVariableInfo": {
    object (FloodlightConversionCustomVariableInfo)
  },
  "customColumnIds": [
    string
  ]
}
Alanlar
resourceName

string

Dönüşüm özelleştirilebilen değişkeninin kaynak adı. Dönüşüm özelleştirilebilen değişkeni kaynak adları şu biçimdedir:

customers/{customerId}/conversionCustomVariables/{conversion_custom_variable_id}

id

string (int64 format)

Dönüşüm özel değişkeninin kimliği.

name

string

Zorunlu. Dönüşüm özelleştirilebilen değişkeninin adı. Ad benzersiz olmalıdır. Adın maksimum uzunluğu 100 karakterdir. Öncesinde ve sonrasında fazladan boşluk olmamalıdır.

tag

string

Zorunlu. Dönüşüm özelleştirilebilen değişkeninin etiketi. Etiket benzersiz olmalı ve doğrudan 100'den küçük veya 100'e eşit bir sayıyla devam eden bir "u" karakterinden oluşmalıdır. Örneğin: "u4".

status

enum (ConversionCustomVariableStatus)

Dönüşüm etkinliği birikimi için dönüşüm özelleştirilebilen değişkeninin durumu.

ownerCustomer

string

Dönüşüm özelleştirilebilen değişkeninin sahibi olan müşterinin kaynak adı.

family

enum (ConversionCustomVariableFamily)

Dönüşüm özelleştirilebilen değişkeninin ailesi.

cardinality

enum (ConversionCustomVariableCardinality)

Dönüşüm özelleştirilebilen değişkeninin kardinalitesi.

floodlightConversionCustomVariableInfo

object (FloodlightConversionCustomVariableInfo)

Search Ads 360 Floodlight dönüşümü özel değişkenleri için alanlar.

customColumnIds[]

string (int64 format)

Bu dönüşüm özel değişkenini kullanan özel sütunların kimlikleri.

ConversionCustomVariableStatus

Dönüşüm özelleştirilebilen değişkeninin olası durumları.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca dönüş değeri için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
ACTIVATION_NEEDED

Dönüşüm özelleştirilebilen değişkeninin etkinleştirilmesi bekleniyor ve ENABLED olarak ayarlanana kadar istatistikler birikmeyecek.

Bu durum, CREATE ve UPDATE isteklerinde kullanılamaz.

ENABLED Dönüşüm özelleştirilebilen değişkeni etkinleştirilir ve istatistikler toplanır.
PAUSED Dönüşüm özelleştirilebilen değişkeni duraklatıldı ve tekrar ETKİN olarak ayarlanana kadar istatistik biriktirmez.

ConversionCustomVariableFamily

Dönüşüm özelleştirilebilen değişkeninin ailesi.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca dönüş değeri için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
STANDARD Standart dönüşüm özelleştirilebilen değişkeni. Müşterilerin kullanmadan önce etkinleştirmesi gerekir.
FLOODLIGHT Dönüşüm özel değişkeni, özel bir Floodlight değişkeninden içe aktarılır.

ConversionCustomVariableCardinality

Dönüşüm özelleştirilebilen değişkeninin kardinalitesi.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca dönüş değeri için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
BELOW_ALL_LIMITS Dönüşüm özelleştirilebilen değişkeninin kardinalitesi tüm sınırların altındadır. Değişken segmentasyon için kullanılabilir ve değişken etkinleştirilirse yeni değerler için istatistikler toplanabilir.
EXCEEDS_SEGMENTATION_LIMIT_BUT_NOT_STATS_LIMIT Dönüşüm özelleştirilebilen değişkeninin kardinalitesi, segmentasyon sınırını aşıyor ancak istatistik sınırını aşmıyor. Segmentasyon devre dışı bırakılır ancak değişken etkinse yeni değerler için istatistikler toplanabilir.
APPROACHES_STATS_LIMIT Dönüşüm özelleştirilebilen değişkeni, segmentasyon sınırlarını aştı ve istatistik sınırlarına yaklaşıyor (> %90). Segmentasyon devre dışı bırakılır ancak değişken etkinse yeni değerler için istatistikler toplanabilir.
EXCEEDS_STATS_LIMIT Dönüşüm özelleştirilebilen değişkeni hem segmentasyon sınırlarını hem de istatistik sınırlarını aştı. Segmentasyon devre dışı bırakılır ve etkinleştirilen değişkenlerin istatistikleri yalnızca mevcut değerler değişkenin kardinalitesini daha fazla artırmazsa toplanabilir.

FloodlightConversionCustomVariableInfo

Search Ads 360 Floodlight Dönüşümü Özel Değişkenleri ile ilgili bilgiler.

JSON gösterimi
{
  "floodlightVariableType": enum (FloodlightVariableType),
  "floodlightVariableDataType": enum (FloodlightVariableDataType)
}
Alanlar
floodlightVariableType

enum (FloodlightVariableType)

Search Ads 360'ta tanımlanan Floodlight değişken türü.

floodlightVariableDataType

enum (FloodlightVariableDataType)

Search Ads 360'ta tanımlanan Floodlight değişkeni veri türü.

FloodlightVariableType

Search Ads 360'ta tanımlandığı şekliyle Floodlight değişkeninin türü. Daha fazla bilgi edinmek için https://support.google.com/searchads/answer/4397154?hl=en adresini ziyaret edin.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca dönüş değeri için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
DIMENSION Boyut Floodlight değişkeni türü.
METRIC Metrik Floodlight değişkeni türü.
UNSET Floodlight değişken türü ayarlanmamış.

FloodlightVariableDataType

Search Ads 360'ta tanımlandığı şekliyle Floodlight değişkeninin veri türü. Daha fazla bilgi edinmek için https://support.google.com/searchads/answer/4397154?hl=en adresini ziyaret edin.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca dönüş değeri için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
NUMBER "Sayı" türünde bir Floodlight değişkenini temsil eder. Bu değişken, BOYUT veya METRİK türündeki Floodlight değişkenlerine atanabilir.
STRING "Dize" türünde bir Floodlight değişkenini temsil eder. Bu değişken, BOYUT türündeki Floodlight değişkenlerine atanabilir.

Müşteri

Müşteri

JSON gösterimi
{
  "resourceName": string,
  "conversionTrackingSetting": {
    object (ConversionTrackingSetting)
  },
  "accountType": enum (AccountType),
  "doubleClickCampaignManagerSetting": {
    object (DoubleClickCampaignManagerSetting)
  },
  "accountStatus": enum (AccountStatus),
  "lastModifiedTime": string,
  "engineId": string,
  "status": enum (CustomerStatus),
  "creationTime": string,
  "managerId": string,
  "managerDescriptiveName": string,
  "subManagerId": string,
  "subManagerDescriptiveName": string,
  "associateManagerId": string,
  "associateManagerDescriptiveName": string,
  "accountLevel": enum (AccountLevelType),
  "id": string,
  "descriptiveName": string,
  "currencyCode": string,
  "timeZone": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": string,
  "autoTaggingEnabled": boolean,
  "manager": boolean
}
Alanlar
resourceName

string

Müşterinin kaynak adı. Müşteri kaynağı adları şu biçimdedir:

customers/{customerId}

conversionTrackingSetting

object (ConversionTrackingSetting)

Bir müşteri için dönüşüm izleme ayarı.

accountType

enum (AccountType)

Arama motoru hesabı türü (ör. Google Ads, Microsoft Advertising, Yahoo Japan, Baidu, Facebook, Engine Track vb.)

doubleClickCampaignManagerSetting

object (DoubleClickCampaignManagerSetting)

Bir yönetici müşterisi için DoubleClick Campaign Manager (DCM) ayarı.

accountStatus

enum (AccountStatus)

Hesap durumu (ör. Etkin, Duraklatıldı, Kaldırıldı vb.)

lastModifiedTime

string

Bu müşterinin en son değiştirildiği tarih ve saat. Tarih ve saat, müşterinin saat diliminde ve "yyyy-AA-gg SS:dd:ss.ssssss" biçimindedir.

engineId

string

Harici arama motoru hesabındaki hesabın kimliği.

status

enum (CustomerStatus)

Müşterinin durumu.

creationTime

string

Bu müşterinin oluşturulduğu zamanı gösteren zaman damgası. Zaman damgası, müşterinin saat diliminde ve "yyyy-AA-gg SS:dd:ss" biçimindedir.

managerId

string (int64 format)

Yöneticinin müşteri kimliği. 0 değeri, müşterinin SA360 yöneticisi olmadığını gösterir.

managerDescriptiveName

string

Yöneticinin açıklayıcı adı.

subManagerId

string (int64 format)

Alt yöneticinin müşteri kimliği. 0 değeri, müşterinin alt SA360 yöneticisi olmadığını gösterir.

subManagerDescriptiveName

string

Alt yöneticinin açıklayıcı adı.

associateManagerId

string (int64 format)

Hesap yönetici yardımcısının müşteri kimliği. 0 değeri, müşterinin SA360 ile ilişkili bir yöneticisinin olmadığını gösterir.

associateManagerDescriptiveName

string

İlişkilendirilmiş yöneticinin açıklayıcı adı.

accountLevel

enum (AccountLevelType)

Müşterinin hesap düzeyi: yönetici, alt yönetici, yönetici yardımcısı, hizmet hesabı.

id

string (int64 format)

Müşterinin kimliği.

descriptiveName

string

İsteğe bağlı, benzersiz olmayan açıklayıcı müşteri adı.

currencyCode

string

Hesabın işlem yaptığı para birimi. ISO 4217 standardındaki para birimi kodlarının bir alt kümesi desteklenir.

timeZone

string

Müşterinin yerel saat dilimi kimliği.

trackingUrlTemplate

string

Parametrelerden izleme URL'si oluşturmak için kullanılan URL şablonu.

finalUrlSuffix

string

Parametreleri nihai URL'ye eklemek için kullanılan URL şablonu.

autoTaggingEnabled

boolean

Otomatik etiketlemenin müşteri için etkin olup olmadığı.

manager

boolean

Müşterinin yönetici olup olmadığı

ConversionTrackingSetting

Search Ads 360 dönüşüm izleme ile ilgili, müşteri genelinde bir ayar koleksiyonu.

JSON gösterimi
{
  "acceptedCustomerDataTerms": boolean,
  "conversionTrackingStatus": enum (ConversionTrackingStatus),
  "enhancedConversionsForLeadsEnabled": boolean,
  "googleAdsConversionCustomer": string,
  "conversionTrackingId": string,
  "googleAdsCrossAccountConversionTrackingId": string,
  "crossAccountConversionTrackingId": string
}
Alanlar
acceptedCustomerDataTerms

boolean

Müşterinin müşteri verisi şartlarını kabul edip etmediği. Hesaplar arası dönüşüm izleme kullanılıyorsa bu değer yöneticiden devralınır. Bu alan salt okunurdur. Daha fazla bilgi için https://support.google.com/adspolicy/answer/7475709 adresini ziyaret edin.

conversionTrackingStatus

enum (ConversionTrackingStatus)

Dönüşüm izleme durumu. Müşterinin dönüşüm izlemeyi kullanıp kullanmadığını ve bu müşterinin dönüşüm izleme sahibinin kim olduğunu gösterir. Bu müşteri hesaplar arası dönüşüm izlemeyi kullanıyorsa döndürülen değer, isteğin login-customer-id göre değişir.

enhancedConversionsForLeadsEnabled

boolean

Müşterinin potansiyel müşteriler için gelişmiş dönüşümleri etkinleştirip etkinleştirmediği. Hesaplar arası dönüşüm izleme kullanılıyorsa bu değer yöneticiden devralınır. Bu alan salt okunurdur.

googleAdsConversionCustomer

string

Dönüşümlerin oluşturulduğu ve yönetildiği müşterinin kaynak adı. Bu alan salt okunurdur.

conversionTrackingId

string (int64 format)

Bu hesap için kullanılan dönüşüm izleme kimliği. Bu kimlik, müşterinin dönüşüm izlemeyi kullanıp kullanmadığını belirtmez (conversionTrackingStatus belirtir). Bu alan salt okunurdur.

googleAdsCrossAccountConversionTrackingId

string (int64 format)

Müşterinin yöneticisinin dönüşüm izleme kimliği. Bu parametre, müşteri dönüşüm izlemeyi etkinleştirdiğinde ayarlanır ve conversionTrackingId parametresini geçersiz kılar. Bu alan yalnızca Google Ads kullanıcı arayüzü üzerinden yönetilebilir. Bu alan salt okunurdur.

crossAccountConversionTrackingId

string (int64 format)

Müşterinin yöneticisinin dönüşüm izleme kimliği. Bu, müşteri hesaplar arası dönüşüm izlemeyi etkinleştirdiğinde ayarlanır ve conversionTrackingId'yi geçersiz kılar.

ConversionTrackingStatus

Müşterinin dönüşüm izleme durumu.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca dönüş değeri için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
NOT_CONVERSION_TRACKED Müşteri herhangi bir dönüşüm izleme özelliği kullanmıyor.
CONVERSION_TRACKING_MANAGED_BY_SELF Dönüşüm işlemleri bu müşteri tarafından oluşturulur ve yönetilir.
CONVERSION_TRACKING_MANAGED_BY_THIS_MANAGER Dönüşüm işlemleri, isteğin login-customer-id bölümünde belirtilen yönetici tarafından oluşturulur ve yönetilir.
CONVERSION_TRACKING_MANAGED_BY_ANOTHER_MANAGER Dönüşüm işlemleri, isteğin login-customer-id bölümünde belirtilen müşteriden veya yöneticiden farklı bir yönetici tarafından oluşturulup yönetiliyor.

AccountType

Olası arama motoru hesabı türleri.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca dönüş değeri için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
BAIDU Baidu hesabı.
ENGINE_TRACK Arama motoru izleme hesabı.
FACEBOOK Facebook hesabı.
FACEBOOK_GATEWAY Ağ geçidi üzerinden yönetilen Facebook hesabı
GOOGLE_ADS Google Ads hesabı.
MICROSOFT Microsoft Advertising hesabı
SEARCH_ADS_360 Search Ads 360 yönetici hesabı.
YAHOO_JAPAN Yahoo Japan hesabınızla oturum açın.

DoubleClickCampaignManagerSetting

Bir yönetici müşterisi için DoubleClick Campaign Manager (DCM) ayarı.

JSON gösterimi
{
  "advertiserId": string,
  "networkId": string,
  "timeZone": string
}
Alanlar
advertiserId

string (int64 format)

Bu müşteriyle ilişkili Campaign Manager reklamvereninin kimliği.

networkId

string (int64 format)

Bu müşteriyle ilişkili Campaign Manager ağının kimliği.

timeZone

string

IANA Saat Dilimi Veritabanı biçiminde (ör. America/New_York) bu müşteriyle ilişkili Campaign Manager ağının saat dilimi.

AccountStatus

Hesabın olası durumları.

Sıralamalar
UNSPECIFIED Varsayılan değer.
UNKNOWN Bilinmeyen değer.
ENABLED Hesap reklam yayınlayabilir.
PAUSED Hesap, kullanıcı tarafından devre dışı bırakıldı.
SUSPENDED Hesap, dahili bir işlemle devre dışı bırakılır.
REMOVED Hesap geri döndürülemez şekilde devre dışı bırakıldı.
DRAFT Hesap kurulumu hâlâ devam ediyor ve henüz ETKİNLEŞTİRİLMEDİ.

CustomerStatus

Müşterinin olası durumları.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca dönüş değeri için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
ENABLED Reklam yayınlayabilen etkin bir hesabı gösterir.
CANCELED Reklam yayınlayamayan iptal edilmiş bir hesabı gösterir. Yönetici kullanıcı tarafından yeniden etkinleştirilebilir.
SUSPENDED Reklam yayınlayamayan, askıya alınmış bir hesabı gösterir. Yalnızca Google Destek Ekibi tarafından etkinleştirilebilir.
CLOSED Reklam yayınlayamayan kapalı bir hesabı gösterir. Test hesabı da KAPALI durumunda olur. Durum kalıcıdır ve yeniden açılamaz.

AccountLevelType

Olası hesap düzeylerini açıklayan enum veri türü.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca dönüş değeri için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
CLIENT_ACCOUNT_FACEBOOK Müşteri hesabı (Facebook)
CLIENT_ACCOUNT_GOOGLE_ADS Müşteri hesabı (Google Ads)
CLIENT_ACCOUNT_MICROSOFT Müşteri hesabı (Microsoft)
CLIENT_ACCOUNT_YAHOO_JAPAN Müşteri hesabı (Yahoo Japan)
CLIENT_ACCOUNT_ENGINE_TRACK Müşteri hesabı (Engine Track)
MANAGER Üst düzey yönetici.
SUB_MANAGER Alt yönetici.
ASSOCIATE_MANAGER Yönetici yardımcısı

CustomerAsset

Müşteri ile öğe arasındaki bağlantı.

JSON gösterimi
{
  "resourceName": string,
  "asset": string,
  "status": enum (AssetLinkStatus)
}
Alanlar
resourceName

string

Müşteri öğesinin kaynak adı. CustomerAsset kaynak adları şu biçime sahiptir:

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

asset

string

Zorunlu. Müşteriye bağlı olan öğe.

status

enum (AssetLinkStatus)

Müşteri öğesinin durumu.

CustomerAssetSet

CustomerAssetSet, bir müşteri ile bir öğe grubu arasındaki bağlantıdır. CustomerAssetSet eklemek, bir öğe grubunu müşteriyle ilişkilendirir.

JSON gösterimi
{
  "resourceName": string,
  "assetSet": string,
  "customer": string,
  "status": enum (AssetSetLinkStatus)
}
Alanlar
resourceName

string

Müşteri öğesi grubunun kaynak adı. Öğe grubu öğe kaynak adları şu biçimdedir:

customers/{customerId}/customerAssetSets/{asset_set_id}

assetSet

string

Müşteriye bağlı öğe grubu.

customer

string

Bu öğe grubunun bağlı olduğu müşteri.

status

enum (AssetSetLinkStatus)

Müşteri öğesi grubu öğesinin durumu. Salt okunur.

AccessibleBiddingStrategy

Müşteriye ait ve müşteriyle paylaşılan teklif stratejilerinin görünümünü temsil eder.

BiddingStrategy'nin aksine bu kaynak, müşteriye ait stratejilerin yanı sıra müşterinin yöneticilerine ait olup bu müşteriyle paylaşılan stratejileri de içerir. Bu kaynak metrik sağlamaz ve yalnızca teklif stratejisi özelliklerinin sınırlı bir alt kümesini kullanıma sunar.

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

string

Erişilebilir teklif stratejisinin kaynak adı. AccessibleBiddingStrategy kaynak adları şu biçimdedir:

customers/{customerId}/accessibleBiddingStrategies/{bidding_strategy_id}

id

string (int64 format)

Teklif stratejisinin kimliği.

name

string

Teklif stratejisinin adı.

type

enum (BiddingStrategyType)

Teklif stratejisinin türü.

ownerCustomerId

string (int64 format)

Teklif stratejisinin sahibi olan müşterinin kimliği.

ownerDescriptiveName

string

Teklif stratejisinin sahibi olan müşterinin açıklayıcı adı.

scheme birleşik alanı. Teklif verme düzeni.

Yalnızca bir tane ayarlanabilir. scheme aşağıdakilerden yalnızca biri olabilir:

maximizeConversionValue

object (MaximizeConversionValue)

Bütçenizi harcarken kampanyalarınız için en yüksek dönüşüm değerini elde etmenize yardımcı olan bir otomatik teklif stratejisidir.

maximizeConversions

object (MaximizeConversions)

Bütçenizi harcarken kampanyalarınız için en fazla dönüşümü elde etmenize yardımcı olan bir otomatik teklif stratejisidir.

targetCpa

object (TargetCpa)

Teklifleri, belirlediğiniz hedef edinme başına maliyetle (EBM) mümkün olduğunca fazla dönüşüm elde etmenizi sağlayacak şekilde ayarlayan bir teklif stratejisidir.

targetImpressionShare

object (TargetImpressionShare)

Gösterimlerin belirli bir yüzdesine göre otomatik olarak optimizasyon yapan bir teklif stratejisidir.

targetRoas

object (TargetRoas)

Belirli bir hedef reklam harcamalarından elde edilen gelir (ROAS) ortalamasını alırken geliri en üst düzeye çıkarmanıza yardımcı olan bir teklif stratejisi.

targetSpend

object (TargetSpend)

Tekliflerinizi bütçeniz dahilinde olabildiğince çok sayıda tıklama almanıza yardımcı olacak şekilde ayarlayan bir teklif stratejisidir.

MaximizeConversionValue

Bütçenizi harcarken kampanyalarınız için en yüksek dönüşüm değerini elde etmenize yardımcı olan bir otomatik teklif stratejisidir.

JSON gösterimi
{
  "targetRoas": number
}
Alanlar
targetRoas

number

Reklam harcamalarından elde edilen gelir hedefi (ROAS) seçeneği. Ayarlanırsa teklif stratejisi, reklam harcamalarından elde edilen gelir hedefini ortalama bir değerde tutarken geliri en üst düzeye çıkarır. Hedef ROAS yüksekse teklif stratejisi, bütçenin tamamını harcamayabilir. Hedef ROAS ayarlanmamışsa teklif stratejisi, bütçe için mümkün olan en yüksek ROAS'ı elde etmeyi amaçlar.

MaximizeConversions

Bütçenizi harcarken kampanyalarınız için en fazla dönüşümü elde etmenize yardımcı olan bir otomatik teklif stratejisidir.

JSON gösterimi
{
  "targetCpa": string,
  "targetCpaMicros": string
}
Alanlar
targetCpa

string (int64 format)

Hedef edinme başına maliyet (EBM) seçeneği. Bu, edinme başına harcamak istediğiniz ortalama tutardır.

targetCpaMicros

string (int64 format)

Hedef edinme başına maliyet (EBM) seçeneği. Bu, edinme başına harcamak istediğiniz ortalama tutardır.

TargetCpa

Teklifleri, belirlediğiniz hedef edinme başına maliyetle (EBM) olabildiğince çok dönüşüm elde etmenizi sağlamaya yardımcı olacak şekilde ayarlayan bir otomatik teklif stratejisidir.

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

string (int64 format)

Ortalama EBM hedefi. Bu hedef, hesabın para birimine göre minimum faturalandırılabilir birimden büyük veya bu birime eşit olmalıdır.

TargetImpressionShare

Arama ağı reklamlarının belirli bir yüzdesinin ilk sayfanın üst kısmında (veya hedeflenen diğer konumda) gösterilmesi için teklifleri ayarlayan bir otomatik teklif stratejisi.

JSON gösterimi
{
  "location": enum (TargetImpressionShareLocation),
  "locationFractionMicros": string,
  "cpcBidCeilingMicros": string
}
Alanlar
location

enum (TargetImpressionShareLocation)

Arama sonuçları sayfasındaki hedeflenen konum.

locationFractionMicros

string (int64 format)

Hedeflenen konumda gösterilecek reklamların seçilen kesri (mikro cinsinden). Örneğin, %1,10.000'e eşittir.

cpcBidCeilingMicros

string (int64 format)

Otomatik teklif sistemi tarafından belirtilmesine izin verilen en yüksek TBM teklifi. Bu, reklamveren tarafından girilen, tavanı belirleyen ve yerel mikro verilerde belirtilen zorunlu bir alandır.

TargetRoas

Belirli bir reklam harcamalarından elde edilen gelir (ROAS) hedefini ortalama bir değerde tutarken geliri en üst düzeye çıkarmanıza yardımcı olan otomatik teklif stratejisi.

JSON gösterimi
{
  "targetRoas": number
}
Alanlar
targetRoas

number

Harcama birimi başına seçilen gelir (dönüşüm verilerine göre).

TargetSpend

Bütçeniz dahilinde olabildiğince çok sayıda tıklama almanıza yardımcı olacak şekilde tekliflerinizi ayarlayan otomatik bir teklif stratejisidir.

JSON gösterimi
{
  "targetSpendMicros": string,
  "cpcBidCeilingMicros": string
}
Alanlar
targetSpendMicros
(deprecated)

string (int64 format)

Tıklamaların en üst düzeye çıkarılacağı hedef harcama. Hedef harcama teklifi veren, bu değerin veya doğal sınırlama harcama tutarının daha küçüğünü harcamaya çalışır. Belirtilmezse bütçe, harcama hedefi olarak kullanılır. Bu alan kullanımdan kaldırıldı ve artık kullanılmamalıdır. Ayrıntılar için https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html adresini ziyaret edin.

cpcBidCeilingMicros

string (int64 format)

Teklif stratejisi tarafından belirlenebilecek maksimum teklif sınırı. Bu sınır, strateji tarafından yönetilen tüm anahtar kelimeler için geçerlidir.

ManagerLinkStatus

Bağlantının olası durumları.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca dönüş değeri için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
ACTIVE Yürürlükteki mevcut ilişkiyi gösterir.
INACTIVE Sonlandırılan ilişkiyi gösterir.
PENDING İlişkinin yönetici tarafından istendiğini ancak müşterinin henüz kabul etmediğini gösterir.
REFUSED İlişki, yönetici tarafından istendi ancak müşteri tarafından reddedildi.
CANCELED İlişkinin yönetici tarafından istendiğini ancak yöneticinin isteği iptal ettiğini gösterir.

CustomerClient

Belirtilen müşteri ile bir müşteri müşterisi arasındaki bağlantı. CustomerClients yalnızca yönetici müşteriler için vardır. Doğrudan ve dolaylı tüm müşteri müşterileri ile yöneticinin kendisi dahildir.

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

string

Müşteri istemcisinin kaynak adı. CustomerClient kaynak adları şu biçimdedir: customers/{customerId}/customerClients/{client_customer_id}

appliedLabels[]

string

İstemde bulunan müşteriye ait olan ve istemci müşteriye uygulanan etiketlerin kaynak adları. Etiket kaynak adları şu biçime sahiptir:

customers/{customerId}/labels/{label_id}

status

enum (CustomerStatus)

Müşteri müşterinin durumu. Salt okunur.

clientCustomer

string

Belirli bir müşteriye bağlı olan istemci müşterisinin kaynak adı. Salt okunur.

hidden

boolean

Bunun gizli bir hesap olup olmadığını belirtir.

Salt okunur.

level

string (int64 format)

Belirli bir müşteri ile istemci arasındaki mesafe. Kendine bağlantı için seviye değeri 0 olur. Salt okunur.

timeZone

string

İstemcinin saat diliminin Common Locale Data Repository (CLDR) dize gösterimi (ör. America/Los_Angeles). Salt okunur.

testAccount

boolean

Müşterinin bir test hesabı olup olmadığını tanımlar. Salt okunur.

manager

boolean

Müşterinin yönetici olup olmadığını belirler. Salt okunur.

descriptiveName

string

Müşteri için açıklayıcı ad. Salt okunur.

currencyCode

string

Müşterinin para birimi kodu (örneğin, "USD", "EUR"). Salt okunur.

id

string (int64 format)

İstemci müşterisinin kimliği. Salt okunur.

DynamicSearchAdsSearchTermView

Dinamik Arama Ağı reklamları arama terimi görünümü.

JSON gösterimi
{
  "resourceName": string,
  "landingPage": string
}
Alanlar
resourceName

string

Dinamik Arama Ağı reklamları arama terimi görünümünün kaynak adı. Dinamik Arama Ağı reklamları arama terimi görünümü kaynak adları şu biçimdedir:

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

landingPage

string

Gösterimin dinamik olarak seçilen açılış sayfası URL'si.

Bu alan salt okunurdur.

GenderView

Cinsiyet görünümü. genderView kaynağı, hangi ölçütlerin eklendiğinden ziyade etkin yayın durumunu yansıtır. Cinsiyet ölçütleri olmayan bir reklam grubu varsayılan olarak tüm cinsiyetlere gösterilir. Bu nedenle, cinsiyet görünümünde tüm cinsiyetler istatistiklerle birlikte görünür.

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

string

Cinsiyet görünümünün kaynak adı. Cinsiyet görünümü kaynak adları şu biçimdedir:

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

GeoTargetConstant

Coğrafi hedef sabiti.

JSON gösterimi
{
  "resourceName": string,
  "status": enum (GeoTargetConstantStatus),
  "id": string,
  "name": string,
  "countryCode": string,
  "targetType": string,
  "canonicalName": string,
  "parentGeoTarget": string
}
Alanlar
resourceName

string

Coğrafi hedef sabiti için kaynak adı. Coğrafi hedef sabit kaynak adları şu biçimdedir:

geoTargetConstants/{geo_target_constant_id}

status

enum (GeoTargetConstantStatus)

Coğrafi hedef sabiti durumu.

id

string (int64 format)

Coğrafi hedef sabiti kimliği.

name

string

Coğrafi hedef sabiti İngilizce adı.

countryCode

string

Hedefle ilişkilendirilmiş ISO-3166-1 alfa-2 ülke kodu.

targetType

string

Coğrafi hedef sabit hedef türü.

canonicalName

string

Hedefin adı, üst öğesinin adı ve ülkesinden oluşan tam nitelikli İngilizce ad.

parentGeoTarget

string

Üst coğrafi hedef sabiti için kaynak adı. Coğrafi hedef sabit kaynak adları şu biçimdedir:

geoTargetConstants/{parent_geo_target_constant_id}

GeoTargetConstantStatus

Coğrafi hedef sabiti için olası durumlar.

Sıralamalar
UNSPECIFIED Değer belirtilmedi.
UNKNOWN

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

Bu, yalnızca yanıt değeri olan bir özelliktir.

ENABLED Coğrafi hedef sabiti geçerlidir.
REMOVAL_PLANNED Coğrafi hedef sabiti eski olduğundan kaldırılacak.

KeywordView

Anahtar kelime görünümü.

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

string

Anahtar kelime görünümünün kaynak adı. Anahtar kelime görünümü kaynak adları şu biçime sahiptir:

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

Şirket

Bir etiket.

JSON gösterimi
{
  "resourceName": string,
  "status": enum (LabelStatus),
  "textLabel": {
    object (TextLabel)
  },
  "id": string,
  "name": string
}
Alanlar
resourceName

string

Kaynağın adı. Etiket kaynak adları şu biçime sahiptir: customers/{ownerCustomerId}/labels/{label_id}

status

enum (LabelStatus)

Etiketin durumu. Salt okunur.

textLabel

object (TextLabel)

Renkli bir arka plan üzerinde metin gösteren bir etiket türü.

id

string (int64 format)

Etiketin kimliği. Salt okunur.

name

string

Etiketin adı.

Bu alan zorunludur ve yeni bir etiket oluşturulurken boş bırakılmamalıdır.

Bu dizenin uzunluğu 1 ile 80 arasında (bu değerler dahil) olmalıdır.

LabelStatus

Bir etiketin olası durumları.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca dönüş değeri için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
ENABLED Etiket etkinleştirilmiş olmalıdır.
REMOVED Etiket kaldırılır.

TextLabel

Renkli bir arka plan üzerinde metin gösteren bir etiket türü.

JSON gösterimi
{
  "backgroundColor": string,
  "description": string
}
Alanlar
backgroundColor

string

Etiketin onaltılık biçimdeki arka plan rengi. Bu dize, "^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$" normal ifadesiyle eşleşmelidir. Not: Arka plan rengi, yönetici hesaplarında görünmeyebilir.

description

string

Etiketin kısa bir açıklaması. Uzunluk en fazla 200 karakter olmalıdır.

LanguageConstant

Bir dil.

JSON gösterimi
{
  "resourceName": string,
  "id": string,
  "code": string,
  "name": string,
  "targetable": boolean
}
Alanlar
resourceName

string

Dil sabiti için kaynak adı. Dil sabitinin kaynak adları şu biçimdedir:

languageConstants/{criterionId}

id

string (int64 format)

Dil sabitinin kimliği.

code

string

Dil kodu (örneğin, "en_US", "en_AU", "es", "fr" vb.)

name

string

Dilin İngilizce tam adı (ör. "English (US)", "Spanish" vb.)

targetable

boolean

Dilin hedeflenebilir olup olmadığı.

LocationView

Konum görünümü, kampanyaların performansını bir konum ölçütüne göre özetler.

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

string

Konum görünümünün kaynak adı. Konum görünümü kaynak adları şu biçime sahiptir:

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

ProductBiddingCategoryConstant

Ürün teklifi kategorisi.

JSON gösterimi
{
  "resourceName": string,
  "level": enum (ProductBiddingCategoryLevel),
  "status": enum (ProductBiddingCategoryStatus),
  "id": string,
  "countryCode": string,
  "productBiddingCategoryConstantParent": string,
  "languageCode": string,
  "localizedName": string
}
Alanlar
resourceName

string

Ürün teklif kategorisinin kaynak adı. Ürün teklifi kategorisi kaynak adları şu biçimdedir:

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

level

enum (ProductBiddingCategoryLevel)

Ürün teklif kategorisinin düzeyi.

status

enum (ProductBiddingCategoryStatus)

Ürün teklif kategorisinin durumu.

id

string (int64 format)

Ürün teklifi kategorisinin kimliği.

Bu kimlik, https://support.google.com/merchants/answer/6324436 adresindeki makalede açıklanan google_product_category kimliğine eşdeğerdir.

countryCode

string

Ürün teklif kategorisinin iki harfli büyük harf ülke kodu.

productBiddingCategoryConstantParent

string

Ana ürün teklif kategorisinin kaynak adı.

languageCode

string

Ürün teklif kategorisinin dil kodu.

localizedName

string

Ürün teklif kategorisinin, languageCode'a göre yerelleştirilmiş değerini gösterir.

ProductBiddingCategoryLevel

Ürün teklif kategorisinin düzeyini açıklayan enum.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca dönüş değeri için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
LEVEL1 1. seviye
LEVEL2 2. seviye
LEVEL3 3. seviye
LEVEL4 4. seviye.
LEVEL5 5. seviye

ProductBiddingCategoryStatus

Ürün teklif kategorisinin durumunu açıklayan enum.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca dönüş değeri için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
ACTIVE Kategori etkin ve teklif verme için kullanılabilir.
OBSOLETE Kategori artık kullanılmıyor. Yalnızca raporlama amacıyla kullanılır.

ProductGroupView

Ürün grubu görünümü.

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

string

Ürün grubu görünümünün kaynak adı. Ürün grubu görünümü kaynak adları şu biçimdedir:

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

ShoppingPerformanceView

Alışveriş performansı görünümü. Alışveriş kampanyası istatistiklerini çeşitli ürün boyutu düzeylerinde toplar. Merchant Center'daki marka, kategori, özel özellikler, ürün durumu ve ürün türü gibi ürün boyutu değerleri, ilgili etkinliğin kaydedildiği tarih ve saat itibarıyla her boyutun durumunu yansıtır.

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

string

Alışveriş performansı görünümünün kaynak adı. Alışveriş performansı görünümü kaynak adları şu biçime sahiptir: customers/{customerId}/shoppingPerformanceView

UserList

Kullanıcı listesi. Bu, bir müşterinin hedefleyebileceği kullanıcıların listesidir.

JSON gösterimi
{
  "resourceName": string,
  "type": enum (UserListType),
  "id": string,
  "name": string
}
Alanlar
resourceName

string

Kullanıcı listesinin kaynak adı. Kullanıcı listesi kaynak adları şu biçime sahiptir:

customers/{customerId}/userLists/{user_list_id}

type

enum (UserListType)

Bu listenin türü.

Bu alan salt okunurdur.

id

string (int64 format)

Kullanıcı listesinin kimliği.

name

string

Bu kullanıcı listesinin adı. Erişim nedenine bağlı olarak kullanıcı listesi adı benzersiz olmayabilir (örneğin, access_reason=SHARED ise).

UserListType

Olası kullanıcı listesi türlerini içeren enum.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca dönüş değeri için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
REMARKETING Kullanıcı listesi, dönüşüm türleri koleksiyonu olarak gösterilir.
LOGICAL Diğer kullanıcı listelerinin/ilgi alanlarının bir kombinasyonu olarak temsil edilen UserList.
EXTERNAL_REMARKETING Google Ad Manager platformunda oluşturulan UserList.
RULE_BASED Bir kural ile ilişkilendirilmiş UserList.
SIMILAR Başka bir UserList'teki kullanıcılara benzer kullanıcıların bulunduğu UserList.
CRM_BASED Reklamveren tarafından e-posta veya başka biçimlerde sağlanan birinci taraf CRM verilerinin kullanıcı listesi.

UserLocationView

Kullanıcı konumu görünümü.

Kullanıcı Konumu Görünümü, ülke düzeyinde toplanan tüm metrikleri içerir ve her ülke için bir satır gösterilir. Hedeflenen veya hedeflenmeyen konuma göre kullanıcının gerçek fiziksel konumundaki metrikleri bildirir. Diğer segment alanları kullanılıyorsa ülke başına birden fazla satır elde edebilirsiniz.

JSON gösterimi
{
  "resourceName": string,
  "countryCriterionId": string,
  "targetingLocation": boolean
}
Alanlar
resourceName

string

Kullanıcı konumu görünümünün kaynak adı. UserLocation görünümü kaynak adları şu biçimdedir:

customers/{customerId}/userLocationViews/{countryCriterionId}~{targetingLocation}

countryCriterionId

string (int64 format)

Ülkenin ölçüt kimliği.

targetingLocation

boolean

Konumun hedeflenip hedeflenmediğini belirtir.

WebpageView

Web sayfası görüntüleme

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

string

Web sayfası görünümünün kaynak adı. Web sayfası görüntüleme kaynağı adları şu biçime sahiptir:

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

Ziyaret edin

Ziyaret

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

string

Ziyaretin kaynak adı. Ziyaret kaynağı adları şu biçimdedir:

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

id

string (int64 format)

Ziyaretin kimliği.

criterionId

string (int64 format)

Search Ads 360 anahtar kelime kimliği. 0 değeri, anahtar kelimenin ilişkilendirilmediğini gösterir.

merchantId

string (int64 format)

Tıklanan ürünü içeren Search Ads 360 envanter hesabı kimliği. Bu kimlik, Search Ads 360'ta bir envanter hesabı bağladığınızda Search Ads 360 tarafından oluşturulur.

adId

string (int64 format)

Reklam kimliği. 0 değeri, reklamın ilişkilendirilmediğini gösterir.

clickId

string

Her ziyaret için benzersiz bir dize, tıklama kimliği URL parametresi olarak açılış sayfasına iletilir.

visitDateTime

string

Ziyaret etkinliğinin zaman damgası. Zaman damgası, müşterinin saat diliminde ve "yyyy-AA-gg SS:dd:ss" biçimindedir.

productId

string

Tıklanan ürünün kimliği.

productChannel

enum (ProductChannel)

Tıklanan ürünün satış kanalı: online veya yerel.

productLanguageCode

string

Ürünle ilgili verileri içeren Merchant Center feed'i için ayarlanan dil (ISO-639-1).

productStoreId

string

Tıklanan yerel envanter reklamındaki mağaza. Bu değer, yerel ürünler feed'inizde kullanılan mağaza kimlikleriyle eşleşmelidir.

productCountryCode

string

Tıklanan ürünü içeren envanter feed'i için kaydedilen ülke (ISO-3166 biçimi).

assetId

string (int64 format)

Ziyaret etkinliği sırasında etkileşimde bulunulan öğenin kimliği.

assetFieldType

enum (AssetFieldType)

Ziyaret etkinliğinin öğe alanı türü.

ProductChannel

Ürün teklifinin yerel durumunu açıklayan enum veri türü.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca dönüş değeri için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
ONLINE Öğe internette satılıyorsa
LOCAL Öğe yerel mağazalarda satılıyor.

Dönüşüm

Dönüşüm

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

string

Dönüşümün kaynak adı. Dönüşüm kaynağı adları şu biçimdedir:

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

id

string (int64 format)

Dönüşümün kimliği

criterionId

string (int64 format)

Search Ads 360 ölçüt kimliği. 0 değeri, ölçütün ilişkilendirilmediğini gösterir.

merchantId

string (int64 format)

Tıklanan ürünü içeren Search Ads 360 envanter hesabı kimliği. Bu kimlik, Search Ads 360'ta bir envanter hesabı bağladığınızda Search Ads 360 tarafından oluşturulur.

adId

string (int64 format)

Reklam kimliği. 0 değeri, reklamın ilişkilendirilmediğini gösterir.

clickId

string

Dönüşümün ilişkilendirildiği ziyaret için benzersiz bir dize. Tıklama kimliği URL parametresi olarak açılış sayfasına iletilir.

visitId

string (int64 format)

Dönüşümün ilişkilendirildiği Search Ads 360 ziyaret kimliği.

advertiserConversionId

string

Çevrimdışı dönüşümler için bu, reklamverenler tarafından sağlanan bir kimliktir. Reklamverenlerin bu tür bir kimlik belirtmediği durumlarda Search Ads 360 bir kimlik oluşturur. Online dönüşümlerde bu değer, reklamverenin Floodlight talimatlarına bağlı olarak id sütununa veya floodlightOrderId sütununa eşittir.

productId

string

Tıklanan ürünün kimliği.

productChannel

enum (ProductChannel)

Tıklanan ürünün satış kanalı: online veya yerel.

productLanguageCode

string

Ürünle ilgili verileri içeren Merchant Center feed'i için ayarlanan dil (ISO-639-1).

productStoreId

string

Tıklanan yerel envanter reklamındaki mağaza. Bu değer, yerel ürünler feed'inizde kullanılan mağaza kimlikleriyle eşleşmelidir.

productCountryCode

string

Tıklanan ürünü içeren envanter feed'i için kaydedilen ülke (ISO-3166 biçimi).

attributionType

enum (AttributionType)

Dönüşümün ilişkilendirildiği öğe: Ziyaret veya Anahtar Kelime+Reklam.

conversionDateTime

string

Dönüşüm etkinliğinin zaman damgası.

conversionLastModifiedDateTime

string

Dönüşümün en son değiştirildiği anın zaman damgası.

conversionVisitDateTime

string

Dönüşümün ilişkilendirildiği ziyaretin zaman damgası.

conversionQuantity

string (int64 format)

Dönüşüm tarafından kaydedilen öğe miktarı (qty URL parametresiyle belirlenir). Reklamveren, parametreyi (ör. dönüşümde satılan öğe sayısı) dinamik olarak doldurmaktan sorumludur. Aksi takdirde, varsayılan olarak 1 değeri kullanılır.

conversionRevenueMicros

string (int64 format)

Dönüşüm etkinliği için mikrolar cinsinden ayarlanmış gelir. Bu değer her zaman yayın yapan hesabın para biriminde olur.

floodlightOriginalRevenue

string (int64 format)

Floodlight para birimi talimatı değişikliklerinden önce, Floodlight etkinliğiyle ilişkili orijinal ve değişmemiş gelir (mevcut raporun para biriminde).

floodlightOrderId

string

Reklamverenin dönüşüm için sağladığı Floodlight sipariş kimliği.

status

enum (ConversionStatus)

Dönüşümün durumu (ENABLED veya REMOVED).

assetId

string (int64 format)

Dönüşüm etkinliği sırasında etkileşimde bulunulan öğenin kimliği.

assetFieldType

enum (AssetFieldType)

Dönüşüm etkinliğinin öğe alanı türü.

AttributionType

Search Ads 360'taki dönüşüm ilişkilendirme türü

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca dönüş değeri için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
VISIT Dönüşüm, bir ziyaretle ilişkilendirilir.
CRITERION_AD Dönüşüm, bir ölçüt ve reklam çiftiyle ilişkilendirilir.

ConversionStatus

Dönüşümün olası durumları.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca dönüş değeri için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
ENABLED Dönüşüm etkinleştirilmiş olmalıdır.
REMOVED Dönüşüm kaldırıldı.

Metrikler

Metrik verileri.

JSON gösterimi
{
  "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,
  "crossDeviceConversionsByConversionDate": number,
  "crossDeviceConversionsValue": number,
  "crossDeviceConversionsValueByConversionDate": number,
  "ctr": number,
  "conversions": number,
  "conversionsValue": number,
  "averageQualityScore": number,
  "historicalQualityScore": string,
  "impressions": string,
  "interactionRate": number,
  "interactions": string,
  "invalidClickRate": number,
  "invalidClicks": string,
  "generalInvalidClickRate": number,
  "generalInvalidClicks": 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,
  "uniqueUsers": string,
  "averageImpressionFrequencyPerUser": number
}
Alanlar
allConversionsValueByConversionDate

number

Tüm dönüşümlerin değeri. Bu sütun tarihle birlikte seçildiğinde, tarih sütunundaki değerler dönüşüm tarihini ifade eder. by_conversion_date sütunlarıyla ilgili ayrıntıları https://support.google.com/sa360/answer/9250611 adresinde bulabilirsiniz.

allConversionsByConversionDate

number

Toplam dönüşüm sayısı. Bu, includeInConversionsMetric değerinden bağımsız olarak tüm dönüşümleri içerir. Bu sütun tarihle birlikte seçildiğinde, tarih sütunundaki değerler dönüşüm tarihini ifade eder. by_conversion_date sütunlarıyla ilgili ayrıntıları https://support.google.com/sa360/answer/9250611 adresinde bulabilirsiniz.

conversionCustomMetrics[]

object (Value)

Dönüşüm özel metrikleri.

conversionsValueByConversionDate

number

Dönüşüm tarihine göre teklif verilebilir dönüşümlerin değerinin toplamı. Bu sütun tarihle birlikte seçildiğinde, tarih sütunundaki değerler dönüşüm tarihini ifade eder.

conversionsByConversionDate

number

Teklif verilebilir dönüşüm türleri için dönüşüm tarihine göre dönüşümlerin toplamı. İlişkilendirme modellemesi nedeniyle kesirli olabilir. Bu sütun tarihle birlikte seçildiğinde, tarih sütunundaki değerler dönüşüm tarihini ifade eder.

historicalCreativeQualityScore

enum (QualityScoreBucket)

Reklam öğesinin geçmiş kalite puanı.

historicalLandingPageQualityScore

enum (QualityScoreBucket)

Geçmişteki açılış sayfası deneyiminin kalitesi.

historicalSearchPredictedCtr

enum (QualityScoreBucket)

Geçmişteki arama için tahmin edilen tıklama oranı (TO).

interactionEventTypes[]

enum (InteractionEventType)

Ücretli ve ücretsiz etkileşim türleri.

rawEventConversionMetrics[]

object (Value)

Ham etkinlik dönüşümü metrikleri.

absoluteTopImpressionPercentage

number

Arama Ağı mutlak üst gösterim payı, en belirgin Arama Ağı konumunda gösterilen Arama Ağı reklamı gösterimlerinizin yüzdesidir.

allConversionsFromInteractionsRate

number

Etkileşimlerden elde edilen tüm dönüşümlerin (görüntüleme dönüşümlerinin aksine) reklam etkileşimi sayısına bölünmesiyle hesaplanır.

allConversionsValue

number

Tüm dönüşümlerin değeri.

allConversions

number

Toplam dönüşüm sayısı. Bu, includeInConversionsMetric değerinden bağımsız olarak tüm dönüşümleri içerir.

allConversionsValuePerCost

number

Tüm dönüşümlerin değerinin, reklam etkileşimlerinin (ör. metin reklam tıklamaları veya video reklam görüntülemeleri) toplam maliyetine bölünmesiyle hesaplanır.

allConversionsFromClickToCall

number

Kullanıcıların bir reklamı tıklarken veya tıkladıktan sonra mağazayı telefonla aramak için "Ara" düğmesini tıklama sayısı. Bu sayı, bağlanan ve bağlanmayan arama sayısını veya görüşmelerin süresini içermez.

Bu metrik yalnızca feed öğeleri için geçerlidir.

allConversionsFromDirections

number

Kullanıcıların bir reklamı tıkladıktan sonra mağazaya gitmek için "Yol tarifi al" düğmesini tıklama sayısı.

Bu metrik yalnızca feed öğeleri için geçerlidir.

allConversionsFromInteractionsValuePerInteraction

number

Etkileşimlerden elde edilen tüm dönüşümlerin değerinin, toplam etkileşim sayısına bölünmesiyle hesaplanır.

allConversionsFromMenu

number

Kullanıcıların bir reklamı tıkladıktan sonra mağazanın menüsünü görüntülemek için bir bağlantıyı tıklama sayısı.

Bu metrik yalnızca feed öğeleri için geçerlidir.

allConversionsFromOrder

number

Kullanıcıların bir reklamı tıkladıktan sonra mağazada sipariş verme sayısı.

Bu metrik yalnızca feed öğeleri için geçerlidir.

allConversionsFromOtherEngagement

number

Kullanıcılar bir reklamı tıkladıktan sonra gerçekleşen diğer dönüşümlerin (örneğin, yorum gönderme veya mağaza konumunu kaydetme) sayısı.

Bu metrik yalnızca feed öğeleri için geçerlidir.

allConversionsFromStoreVisit

number

Kullanıcıların bir reklamı tıkladıktan sonra mağazayı ziyaret etme tahmini sayısı.

Bu metrik yalnızca feed öğeleri için geçerlidir.

visits

number

Search Ads 360'ın başarıyla kaydedip bir reklamverenin açılış sayfasına yönlendirdiği tıklamalar.

allConversionsFromStoreWebsite

number

Kullanıcıların bir reklamı tıkladıktan sonra mağazanın URL'sine yönlendirilme sayısı.

Bu metrik yalnızca feed öğeleri için geçerlidir.

averageCost

number

Etkileşim başına ödediğiniz ortalama tutar. Bu tutar, reklamlarınızın toplam maliyetinin, toplam etkileşim sayısına bölünmesiyle hesaplanır.

averageCpc

number

Tüm tıklamaların toplam maliyetinin alınan toplam tıklama sayısına bölünmesiyle hesaplanır. Bu metrik, parasal bir değerdir ve varsayılan olarak müşterinin para biriminde döndürülür. https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause adresindeki metrics_currency parametresine bakın.

averageCpm

number

Ortalama bin gösterim başına maliyet (BGBM). Bu metrik, parasal bir değerdir ve varsayılan olarak müşterinin para biriminde döndürülür. https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause adresindeki metrics_currency parametresine bakın.

clicks

string (int64 format)

Tıklama sayısı.

contentBudgetLostImpressionShare

number

Reklamınızın Görüntülü Reklam Ağı'nda gösterilmeye uygun olduğu ancak bütçeniz çok düşük olduğu için gösterilmediği tahmini süre yüzdesi. Not: İçerik bütçesi nedeniyle kaybedilen gösterim payı 0-0,9 aralığında raporlanır. 0,9'un üzerindeki değerler 0,9001 olarak bildirilir.

contentImpressionShare

number

Görüntülü Reklam Ağı'nda aldığınız gösterim sayısının, almaya uygun olduğunuz tahmini gösterim sayısına bölünmesiyle elde edilen orandır. Not: İçerik gösterim payı 0,1 ile 1 aralığında bildirilir. 0,1'in altındaki değerler 0,0999 olarak bildirilir.

contentRankLostImpressionShare

number

Reklamlarınızın düşük reklam sıralaması nedeniyle Görüntülü Reklam Ağı'nda alamadığı tahmini gösterim yüzdesi. Not: İçerik sıralaması nedeniyle kaybedilen gösterim payı 0 ile 0,9 aralığında raporlanır. 0,9'un üzerindeki değerler 0,9001 olarak bildirilir.

conversionsFromInteractionsRate

number

Dönüşüme uygun etkileşim başına ortalama teklif verilebilir dönüşüm sayısı (etkileşimden). Bir reklam etkileşiminin ortalama ne sıklıkta teklif verilebilir bir dönüşümle sonuçlandığını gösterir.

clientAccountConversionsValue

number

Müşteri hesabı dönüşümlerinin değeri. Yalnızca IncludeInClientAccountConversionsMetric özelliği doğru olarak ayarlanmış dönüşüm işlemleri bu kapsama girer. Dönüşüme dayalı teklif kullanıyorsanız teklif stratejileriniz bu dönüşümler için optimize edilir.

conversionsValuePerCost

number

Teklif verilebilir dönüşümün değerinin, dönüşüme uygun etkileşimlerin toplam maliyetine bölünmesiyle hesaplanır.

conversionsFromInteractionsValuePerInteraction

number

Etkileşimlerden elde edilen dönüşümlerin değerinin, reklam etkileşimi sayısına bölünmesiyle hesaplanır. Yalnızca includeInConversionsMetric özelliği doğru olarak ayarlanmış dönüşüm işlemleri bu kapsama girer. Dönüşüme dayalı teklif kullanıyorsanız teklif stratejileriniz bu dönüşümler için optimize edilir.

clientAccountConversions

number

Müşteri hesabı dönüşümlerinin sayısı. Yalnızca IncludeInClientAccountConversionsMetric özelliği doğru olarak ayarlanmış dönüşüm işlemleri bu kapsama girer. Dönüşüme dayalı teklif kullanıyorsanız teklif stratejileriniz bu dönüşümler için optimize edilir.

costMicros

string (int64 format)

Bu dönemdeki tıklama başına maliyet (TBM) ve bin gösterim başına maliyet (BGBM) maliyetlerinizin toplamı. Bu metrik, parasal bir değerdir ve varsayılan olarak müşterinin para biriminde döndürülür. https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause adresindeki metrics_currency parametresine bakın.

costPerAllConversions

number

Reklam etkileşimlerinin maliyetinin tüm dönüşümlere bölünmesiyle hesaplanır.

costPerConversion

number

Teklif verilebilir dönüşüm başına dönüşüme uygun ortalama maliyet.

costPerCurrentModelAttributedConversion

number

Reklam etkileşimlerinin maliyetinin, geçerli modelle ilişkilendirilen dönüşümlere bölünmesiyle hesaplanır. Yalnızca includeInConversionsMetric özelliği doğru olarak ayarlanmış dönüşüm işlemleri bu kapsama girer. Dönüşüme dayalı teklif kullanıyorsanız teklif stratejileriniz bu dönüşümler için optimize edilir.

crossDeviceConversions

number

Müşterinin bir cihazda reklamı tıklayıp farklı bir cihazda veya tarayıcıda dönüşüm gerçekleştirdiği durumlardaki dönüşümler. Cihazlar arası dönüşümler, allConversions'a zaten dahil edilmiştir.

crossDeviceConversionsByConversionDate

number

Dönüşüm tarihine göre cihazlar arası dönüşüm sayısı. by_conversion_date sütunlarıyla ilgili ayrıntıları https://support.google.com/sa360/answer/9250611 adresinde bulabilirsiniz.

crossDeviceConversionsValue

number

Cihazlar arası dönüşümlerin değerinin toplamı.

crossDeviceConversionsValueByConversionDate

number

Dönüşüm tarihine göre cihazlar arası dönüşüm değerinin toplamı. by_conversion_date sütunlarıyla ilgili ayrıntıları https://support.google.com/sa360/answer/9250611 adresinde bulabilirsiniz.

ctr

number

Reklamınızın aldığı tıklama sayısının (tıklamalar), reklamınızın gösterilme sayısına (gösterimler) bölünmesiyle elde edilen orandır.

conversions

number

Dönüşüm sayısı. Yalnızca includeInConversionsMetric özelliği doğru olarak ayarlanmış dönüşüm işlemleri bu kapsama girer. Dönüşüme dayalı teklif kullanıyorsanız teklif stratejileriniz bu dönüşümler için optimize edilir.

conversionsValue

number

"Dönüşümler" alanına dahil edilen dönüşümlerin dönüşüm değerlerinin toplamı. Bu metrik yalnızca, dönüşüm işlemleriniz için bir değer girmeniz durumunda işe yarar.

averageQualityScore

number

Ortalama kalite puanı.

historicalQualityScore

string (int64 format)

Kalite puanı geçmişi.

impressions

string (int64 format)

Reklamınızın bir arama sonuçları sayfasında veya Google Ağı'ndaki bir web sitesinde görünme sıklığı.

interactionRate

number

Reklamınız kullanıcılara gösterildikten sonra kullanıcıların reklamınızla ne sıklıkta etkileşimde bulunduğu. Bu oran, etkileşim sayısının reklamınızın gösterilme sayısına bölünmesiyle elde edilir.

interactions

string (int64 format)

Etkileşim sayısı. Etkileşim, reklam biçimiyle ilişkilendirilmiş ana kullanıcı işlemidir (ör. metin ve Alışveriş reklamları için tıklamalar, video reklamlar için görüntülemeler vb.).

invalidClickRate

number

Raporlama döneminde toplam tıklama sayınızdan (filtrelenmiş + filtrelenmemiş tıklamalar) filtrelenen tıklamaların yüzdesi.

invalidClicks

string (int64 format)

Google'ın kurallara aykırı kabul ettiği ve sizden ücret almadığı tıklamaların sayısı.

generalInvalidClickRate

number

Geçersiz olması nedeniyle filtrelenerek toplam tıklama sayınızın (filtrelenmiş + filtrelenmemiş tıklamalar) dışında tutulan tıklamaların yüzdesi. Bunlar, Google'ın geçersiz kabul ettiği ve rutin filtreleme yöntemleriyle (ör. bilinen geçersiz veri merkezi trafiği, botlar ve örümcekler ya da diğer tarayıcılar, düzensiz kalıplar) tespit edilen tıklamalardır. Bu tıklamalar için ödeme yapmazsınız ve bunlar hesap istatistiklerini etkilemez. Ayrıntılar için https://support.google.com/campaignmanager/answer/6076504 adresindeki yardım sayfasına bakın.

generalInvalidClicks

string (int64 format)

Genel geçersiz tıklama sayısı. Bunlar, rutin filtreleme yöntemleri (ör. bilinen geçersiz veri merkezi trafiği, botlar ve örümcekler ya da diğer tarayıcılar, düzensiz kalıplar vb.) aracılığıyla algılanan geçersiz tıklamalarınızın alt kümesidir. Bu tıklamalar için ödeme yapmazsınız ve bunlar hesap istatistiklerini etkilemez. Ayrıntılar için https://support.google.com/campaignmanager/answer/6076504 adresindeki yardım sayfasına bakın.

mobileFriendlyClicksPercentage

number

Mobil uyumlu bir sayfaya yönlendiren mobil tıklamaların yüzdesi.

searchAbsoluteTopImpressionShare

number

Müşterinin en belirgin Alışveriş konumunda gösterilen Alışveriş veya Arama Ağı reklamı gösterimlerinin yüzdesi. Ayrıntılar için https://support.google.com/sa360/answer/9566729 adresine bakın. 0,1'in altındaki değerler 0,0999 olarak bildirilir.

searchBudgetLostAbsoluteTopImpressionShare

number

Reklamınızın düşük bütçe nedeniyle arama sonuçlarındaki üst kısımdaki reklamlar arasında ne sıklıkta ilk sırada yer almadığını tahmin eden sayı. Not: Arama Ağı bütçesi nedeniyle kaybedilen mutlak üst gösterim payı, 0 ile 0,9 aralığında bildirilir. 0,9'un üzerindeki değerler 0,9001 olarak bildirilir.

searchBudgetLostImpressionShare

number

Reklamınızın Arama Ağı'nda gösterilmeye uygun olduğu ancak bütçeniz çok düşük olduğu için gösterilmediği tahmini süre yüzdesi. Not: Arama Ağı bütçesi nedeniyle kaybedilen gösterim payı 0 ile 0,9 aralığında raporlanır. 0,9'un üzerindeki değerler 0,9001 olarak bildirilir.

searchBudgetLostTopImpressionShare

number

Reklamınızın düşük bütçe nedeniyle üstteki organik arama sonuçlarının yanında ne sıklıkla gösterilmediğini tahmin eden sayı. Not: Arama Ağı bütçesi nedeniyle kaybedilen üst gösterim payı, 0 ile 0,9 arasında bir aralıkta bildirilir. 0,9'un üzerindeki değerler 0,9001 olarak bildirilir.

searchClickShare

number

Arama Ağı'nda aldığınız tıklama sayısının, almaya uygun olduğunuz tahmini tıklama sayısına bölünmesiyle elde edilen değer. Not: Arama Ağı tıklama payı 0,1 ile 1 arasında bir aralıkta bildirilir. 0,1'in altındaki değerler 0,0999 olarak bildirilir.

searchExactMatchImpressionShare

number

Anahtar kelime eşleme türlerinizden bağımsız olarak, anahtar kelimelerinizle tam olarak eşleşen (veya anahtar kelimelerinizin yakın varyasyonları olan) arama terimleri için Arama Ağı'nda aldığınız gösterim sayısının, almaya uygun olduğunuz tahmini gösterim sayısına bölünmesiyle elde edilen orandır. Not: Arama Ağı tam eşleme gösterim payı, 0,1 ile 1 arasında bir aralıkta bildirilir. 0,1'in altındaki değerler 0,0999 olarak bildirilir.

searchImpressionShare

number

Arama Ağı'nda aldığınız gösterim sayısının, almaya uygun olduğunuz tahmini gösterim sayısına bölünmesiyle elde edilen orandır. Not: Arama Ağı gösterim payı 0,1 ile 1 arasında bir aralıkta raporlanır. 0,1'in altındaki değerler 0,0999 olarak bildirilir.

searchRankLostAbsoluteTopImpressionShare

number

Reklamınızın düşük reklam sıralaması nedeniyle arama sonuçlarındaki üst kısımdaki reklamlar arasında ne sıklıkta ilk sırada yer almadığını tahmin eden sayı. Not: Arama Ağı sıralaması kaybedilen mutlak üst gösterim payı, 0 ile 0,9 arasında bir aralıkta bildirilir. 0,9'un üzerindeki değerler 0,9001 olarak bildirilir.

searchRankLostImpressionShare

number

Reklamlarınızın düşük reklam sıralaması nedeniyle Arama Ağı'nda almadığı tahmini gösterim yüzdesi. Not: Arama sıralaması nedeniyle kaybedilen gösterim payı, 0 ile 0,9 aralığında raporlanır. 0,9'un üzerindeki değerler 0,9001 olarak bildirilir.

searchRankLostTopImpressionShare

number

Reklamınızın düşük reklam sıralaması nedeniyle üstteki organik arama sonuçlarının yanında ne sıklıkla gösterilmediğini tahmin eden sayı. Not: Arama sıralaması kaybedilen üst gösterim payı, 0 ile 0,9 aralığında bildirilir. 0,9'un üzerindeki değerler 0,9001 olarak bildirilir.

searchTopImpressionShare

number

Üst kısımdaki reklamlar arasında aldığınız gösterimlerin, üst kısımdaki reklamlar arasında almaya uygun olduğunuz tahmini gösterim sayısıyla karşılaştırması. Not: Arama Ağı üst gösterim payı 0,1 ile 1 arasında bir aralıkta bildirilir. 0,1'in altındaki değerler 0,0999 olarak bildirilir.

Üst kısımdaki reklamlar genellikle üstteki organik sonuçların üstünde yer alır. Ancak belirli sorgularda üst kısımdaki reklamlar üstteki organik sonuçların altında gösterilebilir.

topImpressionPercentage

number

Üstteki organik arama sonuçlarının yanında gösterilen reklam gösterimlerinizin yüzdesi.

valuePerAllConversions

number

Tüm dönüşümlerin değerinin, tüm dönüşümlerin sayısına bölünmesiyle hesaplanır.

valuePerAllConversionsByConversionDate

number

Tüm dönüşümlerin değerinin, tüm dönüşümlerin sayısına bölünmesiyle hesaplanır. Bu sütun tarihle birlikte seçildiğinde, tarih sütunundaki değerler dönüşüm tarihini ifade eder. by_conversion_date sütunlarıyla ilgili ayrıntıları https://support.google.com/sa360/answer/9250611 adresinde bulabilirsiniz.

valuePerConversion

number

Teklif verilebilir dönüşüm değerinin, teklif verilebilir dönüşüm sayısına bölünmesiyle hesaplanır. Teklif verilebilir dönüşümlerin her birinin ortalama değerini gösterir.

valuePerConversionsByConversionDate

number

Dönüşüm tarihine göre teklif verilebilir dönüşüm değerinin, dönüşüm tarihine göre teklif verilebilir dönüşüm sayısına bölünmesiyle hesaplanır. Teklif verilebilir dönüşümlerin her birinin ortalama değerini (dönüşüm tarihine göre) gösterir. Bu sütun tarihle birlikte seçildiğinde, tarih sütunundaki değerler dönüşüm tarihini ifade eder.

clientAccountViewThroughConversions

string (int64 format)

Toplam görüntüleme dönüşümü sayısı. Bu dönüşümler, bir müşteri bir resim veya zengin medya reklamı gördükten sonra başka bir reklamla etkileşime geçmeden (ör. başka bir reklamı tıklamadan) sitenizde dönüşüm gerçekleştirdiğinde gerçekleşir.

clientAccountCrossSellCostOfGoodsSoldMicros

string (int64 format)

Müşteri hesabı çapraz satışından elde edilen satılan malların maliyeti (SMM), farklı bir ürünün reklamının yapılması sonucunda satılan ürünlerin toplam maliyetidir. İşleyiş şekli: Web sitenizde tamamlanan satın alma işlemleri için alışveriş sepeti verileriyle dönüşümleri raporlarsınız. Satın alma işleminden önce etkileşimde bulunulan reklamın ilişkili bir ürünü varsa (bkz. Alışveriş reklamları) bu ürün, reklamı yapılan ürün olarak kabul edilir. Müşterinin verdiği siparişe eklenen her ürün, satılan üründür. Reklamı yapılan ürünlerle müşterinin siparişindeki ürünlerin eşleşmemesi çapraz satış olarak kabul edilir. Satılan malların çapraz satış maliyeti, reklamı yapılmayan ancak satılan ürünlerin toplam maliyetidir. Örnek: Bir müşteri, şapka tanıtılan bir Alışveriş reklamını tıklayıp söz konusu şapkayla birlikte bir gömlek satın alıyor. Şapkanın "satılan malların maliyeti" değerinin 3 TL, gömleğin "satılan malların maliyeti" değerinin ise 5 TL olduğunu varsayalım. Bu sipariş için "satılan malların çapraz satış maliyeti" değeri 5 TL'dir. Bu metrik yalnızca alışveriş sepeti verileriyle dönüşümler raporlanıyorsa kullanılabilir. Bu metrik, parasal bir değerdir ve varsayılan olarak müşterinin para biriminde döndürülür. https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause adresindeki metrics_currency parametresine bakın.

crossSellCostOfGoodsSoldMicros

string (int64 format)

Satılan malların çapraz satış maliyeti (SMM), farklı bir ürünün reklamının yapılması sonucunda satılan ürünlerin toplam maliyetidir. İşleyiş şekli: Web sitenizde tamamlanan satın alma işlemleri için alışveriş sepeti verileriyle dönüşümleri raporlarsınız. Satın alma işleminden önce etkileşimde bulunulan reklamın ilişkili bir ürünü varsa (bkz. Alışveriş reklamları) bu ürün, reklamı yapılan ürün olarak kabul edilir. Müşterinin verdiği siparişe eklenen her ürün, satılan üründür. Reklamı yapılan ürünlerle müşterinin siparişindeki ürünlerin eşleşmemesi çapraz satış olarak kabul edilir. Satılan malların çapraz satış maliyeti, reklamı yapılmayan ancak satılan ürünlerin toplam maliyetidir. Örnek: Bir müşteri, şapka tanıtılan bir Alışveriş reklamını tıklayıp söz konusu şapkayla birlikte bir gömlek satın alıyor. Şapkanın "satılan malların maliyeti" değerinin 3 TL, gömleğin "satılan malların maliyeti" değerinin ise 5 TL olduğunu varsayalım. Bu sipariş için "satılan malların çapraz satış maliyeti" değeri 5 TL'dir. Bu metrik yalnızca alışveriş sepeti verileriyle dönüşümler raporlanıyorsa kullanılabilir. Bu metrik, parasal bir değerdir ve varsayılan olarak müşterinin para biriminde döndürülür. https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause adresindeki metrics_currency parametresine bakın.

clientAccountCrossSellGrossProfitMicros

string (int64 format)

Müşteri hesabı çapraz satışından elde edilen brüt kâr, farklı bir ürünün reklamının yapılması sonucunda satılan ürünlerden kazanılan gelirden satılan malların maliyeti (SMM) çıkarılarak hesaplanır. İşleyiş şekli: Web sitenizde tamamlanan satın alma işlemleri için alışveriş sepeti verileriyle dönüşümleri raporlarsınız. Satın alma işleminden önce etkileşimde bulunulan reklamın ilişkili bir ürünü varsa (bkz. Alışveriş reklamları) bu ürün, reklamı yapılan ürün olarak kabul edilir. Satın alma işlemine dahil edilen tüm ürünler, satılan üründür. Reklamı yapılan ürünlerle müşterinin siparişindeki ürünlerin eşleşmemesi çapraz satış olarak kabul edilir. Çapraz satıştan elde edilen brüt kâr, reklamlarınızla ilişkilendirilmiş çapraz satıştan elde ettiğiniz gelirden satılan malların maliyeti çıkarılarak hesaplanır. Örnek: Bir müşteri, şapka tanıtılan bir Alışveriş reklamını tıklayıp söz konusu şapkayla birlikte bir gömlek satın alıyor. Tişört 20 TL ve satılan malların maliyetinin 5 TL olduğunu varsayalım. Bu siparişin çapraz satıştan elde edilen brüt kârı 15 TL = 20 TL - 5 TL'dir. Bu metrik yalnızca alışveriş sepeti verileriyle dönüşümler raporlanıyorsa kullanılabilir. Bu metrik, parasal bir değerdir ve varsayılan olarak müşterinin para biriminde döndürülür. https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause adresindeki metrics_currency parametresine bakın.

crossSellGrossProfitMicros

string (int64 format)

Çapraz satıştan elde edilen brüt kâr, farklı bir ürünün reklamının yapılması sonucunda satılan ürünlerden kazanılan gelirden satılan malların maliyeti (SMM) çıkarılarak hesaplanır. İşleyiş şekli: Web sitenizde tamamlanan satın alma işlemleri için alışveriş sepeti verileriyle dönüşümleri raporlarsınız. Satın alma işleminden önce etkileşimde bulunulan reklamın ilişkili bir ürünü varsa (bkz. Alışveriş reklamları) bu ürün, reklamı yapılan ürün olarak kabul edilir. Satın alma işlemine dahil edilen tüm ürünler, satılan üründür. Reklamı yapılan ürünlerle müşterinin siparişindeki ürünlerin eşleşmemesi çapraz satış olarak kabul edilir. Çapraz satıştan elde edilen brüt kâr, reklamlarınızla ilişkilendirilmiş çapraz satıştan elde ettiğiniz gelirden satılan malların maliyeti çıkarılarak hesaplanır. Örnek: Bir müşteri, şapka tanıtılan bir Alışveriş reklamını tıklayıp söz konusu şapkayla birlikte bir gömlek satın alıyor. Tişört 20 TL ve satılan malların maliyetinin 5 TL olduğunu varsayalım. Bu siparişin çapraz satıştan elde edilen brüt kârı 15 TL = 20 TL - 5 TL'dir. Bu metrik yalnızca alışveriş sepeti verileriyle dönüşümler raporlanıyorsa kullanılabilir. Bu metrik, parasal bir değerdir ve varsayılan olarak müşterinin para biriminde döndürülür. https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause adresindeki metrics_currency parametresine bakın.

clientAccountCrossSellRevenueMicros

string (int64 format)

Müşteri hesabı çapraz satış geliri, farklı bir ürünün reklamının yapılması sonucunda satılan ürünlerden elde ettiğiniz toplam tutardır. İşleyiş şekli: Web sitenizde tamamlanan satın alma işlemleri için alışveriş sepeti verileriyle dönüşümleri raporlarsınız. Satın alma işleminden önce etkileşimde bulunulan reklamın ilişkili bir ürünü varsa (bkz. Alışveriş reklamları) bu ürün, reklamı yapılan ürün olarak kabul edilir. Müşterinin verdiği siparişe eklenen her ürün, satılan üründür. Reklamı yapılan ürünlerle müşterinin siparişindeki ürünlerin eşleşmemesi çapraz satış olarak kabul edilir. Çapraz satıştan elde edilen gelir, reklamlarınızla ilişkilendirilen çapraz satışlardan elde ettiğiniz toplam değerdir. Örnek: Bir müşteri, şapka tanıtılan bir Alışveriş reklamını tıklayıp söz konusu şapkayla birlikte bir gömlek satın alıyor. Şapka 10 TL, gömlek ise 20 TL'dir. Dolayısıyla bu siparişin çapraz satış geliri 20 TL'dir. Bu metrik yalnızca alışveriş sepeti verileriyle dönüşümler raporlanıyorsa kullanılabilir. Bu metrik, parasal bir değerdir ve varsayılan olarak müşterinin para biriminde döndürülür. https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause adresindeki metrics_currency parametresine bakın.

crossSellRevenueMicros

string (int64 format)

Çapraz satıştan elde edilen gelir, farklı bir ürünün reklamının yapılması sonucunda satılan ürünlerden elde ettiğiniz toplam tutardır. İşleyiş şekli: Web sitenizde tamamlanan satın alma işlemleri için alışveriş sepeti verileriyle dönüşümleri raporlarsınız. Satın alma işleminden önce etkileşimde bulunulan reklamın ilişkili bir ürünü varsa (bkz. Alışveriş reklamları) bu ürün, reklamı yapılan ürün olarak kabul edilir. Müşterinin verdiği siparişe eklenen her ürün, satılan üründür. Reklamı yapılan ürünlerle müşterinin siparişindeki ürünlerin eşleşmemesi çapraz satış olarak kabul edilir. Çapraz satıştan elde edilen gelir, reklamlarınızla ilişkilendirilen çapraz satışlardan elde ettiğiniz toplam değerdir. Örnek: Bir müşteri, şapka tanıtılan bir Alışveriş reklamını tıklayıp söz konusu şapkayla birlikte bir gömlek satın alıyor. Şapka 10 TL, gömlek ise 20 TL'dir. Dolayısıyla bu siparişin çapraz satış geliri 20 TL'dir. Bu metrik yalnızca alışveriş sepeti verileriyle dönüşümler raporlanıyorsa kullanılabilir. Bu metrik, parasal bir değerdir ve varsayılan olarak müşterinin para biriminde döndürülür. https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause adresindeki metrics_currency parametresine bakın.

clientAccountCrossSellUnitsSold

number

Müşteri hesabı çapraz satışla satılan birim sayısı, farklı bir ürünün reklamının yapılması sonucunda satılan ürünlerin toplam sayısıdır. İşleyiş şekli: Web sitenizde tamamlanan satın alma işlemleri için alışveriş sepeti verileriyle dönüşümleri raporlarsınız. Satın alma işleminden önce etkileşimde bulunulan reklamın ilişkili bir ürünü varsa (bkz. Alışveriş reklamları) bu ürün, reklamı yapılan ürün olarak kabul edilir. Müşterinin verdiği siparişe eklenen her ürün, satılan üründür. Reklamı yapılan ürünlerle müşterinin siparişindeki ürünlerin eşleşmemesi çapraz satış olarak kabul edilir. Çapraz satışla satılan birim sayısı, reklamlarınızla ilişkilendirilen tüm siparişlerdeki çapraz satışla satılan toplam ürün sayısıdır. Örnek: Bir müşteri, şapka tanıtılan bir Alışveriş reklamını tıklayıp söz konusu şapkayla birlikte bir gömlek ve ceket satın alıyor. Bu siparişteki çapraz satışla satılan birim sayısı 2'dir. Bu metrik yalnızca alışveriş sepeti verileriyle dönüşümler raporlanıyorsa kullanılabilir.

crossSellUnitsSold

number

Çapraz satışla satılan birim sayısı, farklı bir ürünün reklamının yapılması sonucunda satılan ürünlerin toplam sayısıdır. İşleyiş şekli: Web sitenizde tamamlanan satın alma işlemleri için alışveriş sepeti verileriyle dönüşümleri raporlarsınız. Satın alma işleminden önce etkileşimde bulunulan reklamın ilişkili bir ürünü varsa (bkz. Alışveriş reklamları) bu ürün, reklamı yapılan ürün olarak kabul edilir. Müşterinin verdiği siparişe eklenen her ürün, satılan üründür. Reklamı yapılan ürünlerle müşterinin siparişindeki ürünlerin eşleşmemesi çapraz satış olarak kabul edilir. Çapraz satışla satılan birim sayısı, reklamlarınızla ilişkilendirilen tüm siparişlerdeki çapraz satışla satılan toplam ürün sayısıdır. Örnek: Bir müşteri, şapka tanıtılan bir Alışveriş reklamını tıklayıp söz konusu şapkayla birlikte bir gömlek ve ceket satın alıyor. Bu siparişteki çapraz satışla satılan birim sayısı 2'dir. Bu metrik yalnızca alışveriş sepeti verileriyle dönüşümler raporlanıyorsa kullanılabilir.

clientAccountLeadCostOfGoodsSoldMicros

string (int64 format)

Müşteri hesabı reklamı yapıldıktan sonra satılan malların maliyeti (SMM), bir ürünün reklamının yapılması sonucunda bu üründen satılan birimlerin toplam maliyetidir. İşleyiş şekli: Web sitenizde tamamlanan satın alma işlemleri için alışveriş sepeti verileriyle dönüşümleri raporlarsınız. Etkileşimde bulunulan reklamla ilişkilendirilmiş bir ürün varsa (bkz. Alışveriş reklamları) bu ürün, reklamı yapılan ürün olarak kabul edilir. Müşterinin verdiği siparişi eklenen her ürün, satılan üründür. Reklamı yapılan ürünlerle satılan ürünler eşleşiyorsa bu ürünlerin maliyeti, reklamı yapıldıktan sonra satılan malların maliyeti altında hesaplanır. Örnek: Bir müşteri, şapka tanıtılan bir Alışveriş reklamını tıklayıp söz konusu şapkayla birlikte bir gömlek satın alıyor. Şapkanın "satılan malların maliyeti" değerinin 3 TL, gömleğin "satılan malların maliyeti" değerinin ise 5 TL olduğunu varsayalım. Bu sipariş için "reklamı yapıldıktan sonra satılan malların maliyeti" değeri 3 TL'dir. Bu metrik yalnızca alışveriş sepeti verileriyle dönüşümler raporlanıyorsa kullanılabilir. Bu metrik, parasal bir değerdir ve varsayılan olarak müşterinin para biriminde döndürülür. https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause adresindeki metrics_currency parametresine bakın.

leadCostOfGoodsSoldMicros

string (int64 format)

Reklamı yapıldıktan sonra satılan malların maliyeti (SMM), bir ürünün reklamının yapılması sonucunda bu üründen satılan birimlerin toplam maliyetidir. İşleyiş şekli: Web sitenizde tamamlanan satın alma işlemleri için alışveriş sepeti verileriyle dönüşümleri raporlarsınız. Etkileşimde bulunulan reklamla ilişkilendirilmiş bir ürün varsa (bkz. Alışveriş reklamları) bu ürün, reklamı yapılan ürün olarak kabul edilir. Müşterinin verdiği siparişi eklenen her ürün, satılan üründür. Reklamı yapılan ürünlerle satılan ürünler eşleşiyorsa bu ürünlerin maliyeti, reklamı yapıldıktan sonra satılan malların maliyeti altında hesaplanır. Örnek: Bir müşteri, şapka tanıtılan bir Alışveriş reklamını tıklayıp söz konusu şapkayla birlikte bir gömlek satın alıyor. Şapkanın "satılan malların maliyeti" değerinin 3 TL, gömleğin "satılan malların maliyeti" değerinin ise 5 TL olduğunu varsayalım. Bu sipariş için "reklamı yapıldıktan sonra satılan malların maliyeti" değeri 3 TL'dir. Bu metrik yalnızca alışveriş sepeti verileriyle dönüşümler raporlanıyorsa kullanılabilir. Bu metrik, parasal bir değerdir ve varsayılan olarak müşterinin para biriminde döndürülür. https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause adresindeki metrics_currency parametresine bakın.

clientAccountLeadGrossProfitMicros

string (int64 format)

Müşteri hesabı reklamı yapılan üründen elde edilen brüt kâr, bir ürünün reklamının yapılması sonucunda satılan birimlerinden kazanılan kârdan, satılan malların maliyeti (SMM) çıkarılarak hesaplanır. İşleyiş şekli: Web sitenizde tamamlanan satın alma işlemleri için alışveriş sepeti verileriyle dönüşümleri raporlarsınız. Satın alma işleminden önce etkileşimde bulunulan reklamın ilişkili bir ürünü varsa (bkz. Alışveriş reklamları) bu ürün, reklamı yapılan ürün olarak kabul edilir. Müşterinin verdiği siparişi eklenen her ürün, satılan üründür. Reklamı yapılan ürünlerle satılan ürünler eşleşiyorsa "reklamı yapılan üründen elde edilen brüt kâr" değeriniz, bu satışlardan elde ettiğiniz gelirden satılan malların maliyeti çıkarılarak bulunur. Örnek: Bir müşteri, şapka tanıtılan bir Alışveriş reklamını tıklayıp söz konusu şapkayla birlikte bir gömlek satın alıyor. Şapka 10 TL, şapkanın "satılan malların maliyeti" değeri ise 3 TL'dir. Dolayısıyla, bu sipariş için "reklamı yapılan üründen elde edilen brüt kâr" değeri 7 TL (10 TL - 3 TL) olarak bulunur. Bu metrik yalnızca alışveriş sepeti verileriyle dönüşümler raporlanıyorsa kullanılabilir. Bu metrik, parasal bir değerdir ve varsayılan olarak müşterinin para biriminde döndürülür. https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause adresindeki metrics_currency parametresine bakın.

leadGrossProfitMicros

string (int64 format)

Reklamı yapılan üründen elde edilen brüt kâr, bir ürünün reklamının yapılması sonucunda satılan birimlerinden kazanılan kârdan, satılan malların maliyeti (SMM) çıkarılarak hesaplanır. İşleyiş şekli: Web sitenizde tamamlanan satın alma işlemleri için alışveriş sepeti verileriyle dönüşümleri raporlarsınız. Satın alma işleminden önce etkileşimde bulunulan reklamın ilişkili bir ürünü varsa (bkz. Alışveriş reklamları) bu ürün, reklamı yapılan ürün olarak kabul edilir. Müşterinin verdiği siparişi eklenen her ürün, satılan üründür. Reklamı yapılan ürünlerle satılan ürünler eşleşiyorsa "reklamı yapılan üründen elde edilen brüt kâr" değeriniz, bu satışlardan elde ettiğiniz gelirden satılan malların maliyeti çıkarılarak bulunur. Örnek: Bir müşteri, şapka tanıtılan bir Alışveriş reklamını tıklayıp söz konusu şapkayla birlikte bir gömlek satın alıyor. Şapka 10 TL, şapkanın "satılan malların maliyeti" değeri ise 3 TL'dir. Dolayısıyla, bu sipariş için "reklamı yapılan üründen elde edilen brüt kâr" değeri 7 TL (10 TL - 3 TL) olarak bulunur. Bu metrik yalnızca alışveriş sepeti verileriyle dönüşümler raporlanıyorsa kullanılabilir. Bu metrik, parasal bir değerdir ve varsayılan olarak müşterinin para biriminde döndürülür. https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause adresindeki metrics_currency parametresine bakın.

clientAccountLeadRevenueMicros

string (int64 format)

Müşteri hesabı reklamı yapılan üründen elde edilen gelir, bir ürünün reklamının yapılması sonucunda satılan birimlerinden elde edilen toplam tutardır. İşleyiş şekli: Web sitenizde tamamlanan satın alma işlemleri için alışveriş sepeti verileriyle dönüşümleri raporlarsınız. Satın alma işleminden önce etkileşimde bulunulan reklamın ilişkili bir ürünü varsa (bkz. Alışveriş reklamları) bu ürün, reklamı yapılan ürün olarak kabul edilir. Müşterinin verdiği siparişi eklenen her ürün, satılan üründür. Reklamı yapılan ürünlerle satılan ürünler eşleşiyorsa bu ürünlerin satışından elde ettiğiniz toplam değer, reklamı yapılan üründen elde edilen gelir altında gösterilir. Örnek: Bir müşteri, şapka tanıtılan bir Alışveriş reklamını tıklayıp söz konusu şapkayla birlikte bir gömlek satın alıyor. Şapka 10 TL, gömlek ise 20 TL'dir. Bu sipariş için "reklamı yapılan üründen elde edilen gelir" 10 TL'dir. Bu metrik yalnızca alışveriş sepeti verileriyle dönüşümler raporlanıyorsa kullanılabilir. Bu metrik, parasal bir değerdir ve varsayılan olarak müşterinin para biriminde döndürülür. https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause adresindeki metrics_currency parametresine bakın.

leadRevenueMicros

string (int64 format)

Reklamı yapılan üründen elde edilen gelir, bir ürünün reklamının yapılması sonucunda satılan birimlerinden elde edilen toplam tutardır. İşleyiş şekli: Web sitenizde tamamlanan satın alma işlemleri için alışveriş sepeti verileriyle dönüşümleri raporlarsınız. Satın alma işleminden önce etkileşimde bulunulan reklamın ilişkili bir ürünü varsa (bkz. Alışveriş reklamları) bu ürün, reklamı yapılan ürün olarak kabul edilir. Müşterinin verdiği siparişi eklenen her ürün, satılan üründür. Reklamı yapılan ürünlerle satılan ürünler eşleşiyorsa bu ürünlerin satışından elde ettiğiniz toplam değer, reklamı yapılan üründen elde edilen gelir altında gösterilir. Örnek: Bir müşteri, şapka tanıtılan bir Alışveriş reklamını tıklayıp söz konusu şapkayla birlikte bir gömlek satın alıyor. Şapka 10 TL, gömlek ise 20 TL'dir. Bu sipariş için "reklamı yapılan üründen elde edilen gelir" 10 TL'dir. Bu metrik yalnızca alışveriş sepeti verileriyle dönüşümler raporlanıyorsa kullanılabilir. Bu metrik, parasal bir değerdir ve varsayılan olarak müşterinin para biriminde döndürülür. https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause adresindeki metrics_currency parametresine bakın.

clientAccountLeadUnitsSold

number

Müşteri hesabı reklamı yapılan üründen satılan birim sayısı, bir ürünün reklamının yapılması sonucunda bu üründen satılan toplam birim sayısıdır. İşleyiş şekli: Web sitenizde tamamlanan satın alma işlemleri için alışveriş sepeti verileriyle dönüşümleri raporlarsınız. Satın alma işleminden önce etkileşimde bulunulan reklamın ilişkili bir ürünü varsa (bkz. Alışveriş reklamları) bu ürün, reklamı yapılan ürün olarak kabul edilir. Müşterinin verdiği siparişi eklenen her ürün, satılan üründür. Reklamı yapılan ürünlerle satılan ürünler eşleşiyorsa bu ürünlerin toplam sayısı, satılan potansiyel müşteri birimi sayısı altında gösterilir. Örnek: Bir müşteri, şapka tanıtılan bir Alışveriş reklamını tıklayıp söz konusu şapkayla birlikte bir gömlek ve ceket satın alıyor. Bu siparişte satılan potansiyel müşteri birimi sayısı 1'dir. Bu metrik yalnızca alışveriş sepeti verileriyle dönüşümler raporlanıyorsa kullanılabilir.

leadUnitsSold

number

Reklamı yapıldıktan sonra satılan birim sayısı, bir ürünün reklamının yapılması sonucunda bu üründen satılan toplam birim sayısıdır. İşleyiş şekli: Web sitenizde tamamlanan satın alma işlemleri için alışveriş sepeti verileriyle dönüşümleri raporlarsınız. Satın alma işleminden önce etkileşimde bulunulan reklamın ilişkili bir ürünü varsa (bkz. Alışveriş reklamları) bu ürün, reklamı yapılan ürün olarak kabul edilir. Müşterinin verdiği siparişi eklenen her ürün, satılan üründür. Reklamı yapılan ürünlerle satılan ürünler eşleşiyorsa bu ürünlerin toplam sayısı, satılan potansiyel müşteri birimi sayısı altında gösterilir. Örnek: Bir müşteri, şapka tanıtılan bir Alışveriş reklamını tıklayıp söz konusu şapkayla birlikte bir gömlek ve ceket satın alıyor. Bu siparişte satılan potansiyel müşteri birimi sayısı 1'dir. Bu metrik yalnızca alışveriş sepeti verileriyle dönüşümler raporlanıyorsa kullanılabilir.

uniqueUsers

string (int64 format)

İstenen dönemde reklamınızı gören benzersiz kullanıcıların sayısı. Bu metrik toplanamaz ve yalnızca 92 gün veya daha kısa tarih aralıkları için istenebilir. Bu metrik; Görüntülü Reklam Ağı, Video, Discovery ve uygulama kampanyası türlerinde kullanılabilir.

averageImpressionFrequencyPerUser

number

İstenen dönemde tekil bir kullanıcının reklamınızı ortalama kaç kez gördüğünü belirten sayıdır. Bu metrik toplanamaz ve yalnızca 92 gün veya daha kısa tarih aralıkları için istenebilir. Bu metrik; Görüntülü Reklam Ağı, Video, Discovery ve uygulama kampanyası türlerinde kullanılabilir.

Değer

Genel bir veri kapsayıcısı.

JSON gösterimi
{

  // 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.
}
Alanlar
value birleşik alanı. Bir değer. value aşağıdakilerden yalnızca biri olabilir:
booleanValue

boolean

Boole değeri.

int64Value

string (int64 format)

Bir int64.

floatValue

number

Bir şamandıra.

doubleValue

number

Çift kişilik.

stringValue

string

Dize.

QualityScoreBucket

Olası kalite puanı gruplarını listeleyen enum.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca dönüş değeri için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
BELOW_AVERAGE Reklam öğesinin kalitesi ortalamanın altında.
AVERAGE Reklam öğesinin kalitesi ortalamadır.
ABOVE_AVERAGE Reklam öğesinin kalitesi ortalamanın üzerinde.

InteractionEventType

Ücretli ve ücretsiz etkileşimlerin olası türlerini açıklayan enum veri türü.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca dönüş değeri için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
CLICK Siteyi tıklayın. Çoğu durumda bu etkileşim, genellikle reklamverenin açılış sayfası olan harici bir konuma yönlendirir. Bu, tıklama etkinlikleri için varsayılan InteractionEventType'tır.
ENGAGEMENT Kullanıcının, reklamla yerinde etkileşim kurma isteğini belirtmesi.
VIDEO_VIEW Kullanıcı bir video reklamı görüntüledi.
NONE Reklam dönüşümü etkinlikleri için varsayılan InteractionEventType. Bu, bir reklam dönüşümü satırı, ücretsiz etkileşimlerin (ör. reklam dönüşümleri) "tanıtılması" ve temel metriklerin bir parçası olarak raporlanması gerektiğini belirtmediğinde kullanılır. Bunlar yalnızca diğer (reklam) dönüşümleridir.

Segmentler

Yalnızca segment alanları.

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

enum (AdNetworkType)

Reklam ağı türü.

conversionActionCategory

enum (ConversionActionCategory)

Dönüşüm işlemi kategorisi.

conversionCustomDimensions[]

object (Value)

Dönüşüm özel boyutları.

dayOfWeek

enum (DayOfWeek)

Haftanın günü (ör. PAZARTESİ).

device

enum (Device)

Metriklerin uygulandığı cihaz.

keyword

object (Keyword)

Anahtar kelime ölçütü.

productChannel

enum (ProductChannel)

Ürünün kanalı.

productChannelExclusivity

enum (ProductChannelExclusivity)

Ürünün kanal ayrıcalığı durumu.

productCondition

enum (ProductCondition)

Ürünün durumu.

productSoldCondition

enum (ProductCondition)

Satılan ürünün durumu.

rawEventConversionDimensions[]

object (Value)

İşlenmemiş etkinlik dönüşümü boyutları.

conversionAction

string

Dönüşüm işleminin kaynak adı.

conversionActionName

string

Dönüşüm işleminin adı.

date

string

Metriklerin geçerli olduğu tarih. yyyy-AA-gg biçiminde olmalıdır (ör. 2018-04-17).

geoTargetCity

string

Bir şehri temsil eden coğrafi hedef sabiti için kaynak adı.

geoTargetCountry

string

Bir ülkeyi temsil eden coğrafi hedef sabiti için kaynak adı.

geoTargetMetro

string

Bir metropolü temsil eden coğrafi hedef sabiti için kaynak adı.

geoTargetRegion

string

Bir bölgeyi temsil eden coğrafi hedef sabiti için kaynak adı.

hour

integer

Günün saati, 0 ile 23 arasında (ikisi de dahil) bir sayı olarak.

month

string

Ay, ayın ilk gününün tarihiyle gösterilir. yyyy-AA-gg olarak biçimlendirilmiş olmalıdır.

productBiddingCategoryLevel1

string

Ürünün teklif kategorisi (1. seviye).

productBiddingCategoryLevel2

string

Ürünün teklif kategorisi (2. seviye).

productBiddingCategoryLevel3

string

Ürünün teklif kategorisi (3. seviye).

productBiddingCategoryLevel4

string

Ürünün teklif kategorisi (4. seviye).

productBiddingCategoryLevel5

string

Ürünün teklif kategorisi (5. seviye).

productBrand

string

Ürünün markası.

productCountry

string

Ürünün satış yapılan ülkesi için coğrafi hedef sabitinin kaynak adı.

productCustomAttribute0

string

Ürünün özel özelliği 0.

productCustomAttribute1

string

Ürünün 1. özel özelliği.

productCustomAttribute2

string

Ürünün özel özelliği 2.

productCustomAttribute3

string

Ürünün özel özelliği 3.

productCustomAttribute4

string

Ürünün özel özelliği 4.

productItemId

string

Ürünün öğe kimliği.

productLanguage

string

Ürünün diline ait dil sabitinin kaynak adı.

productSoldBiddingCategoryLevel1

string

Satılan ürünün teklif kategorisi (1. seviye).

productSoldBiddingCategoryLevel2

string

Satılan ürünün teklif kategorisi (2. seviye).

productSoldBiddingCategoryLevel3

string

Satılan ürünün teklif kategorisi (3. seviye).

productSoldBiddingCategoryLevel4

string

Satılan ürünün teklif kategorisi (4. seviye).

productSoldBiddingCategoryLevel5

string

Satılan ürünün teklif kategorisi (5. seviye).

productSoldBrand

string

Satılan ürünün markası.

productSoldCustomAttribute0

string

Satılan ürünün özel özellik 0'ı.

productSoldCustomAttribute1

string

Satılan ürünün 1. özel özelliği.

productSoldCustomAttribute2

string

Satılan ürünün özel özellik 2'si.

productSoldCustomAttribute3

string

Satılan ürünün özel özellik 3'ü.

productSoldCustomAttribute4

string

Satılan ürünün özel özellik 4'ü.

productSoldItemId

string

Satılan ürünün öğe kimliği.

productSoldTitle

string

Satılan ürünün başlığı.

productSoldTypeL1

string

Satılan ürünün türü (1. seviye).

productSoldTypeL2

string

Satılan ürünün türü (2. seviye).

productSoldTypeL3

string

Satılan ürünün türü (3. seviye).

productSoldTypeL4

string

Satılan ürünün türü (4. seviye).

productSoldTypeL5

string

Satılan ürünün türü (5. seviye).

productStoreId

string

Ürünün mağaza kimliği.

productTitle

string

Ürünün başlığı.

productTypeL1

string

Ürünün türü (1. seviye).

productTypeL2

string

Ürünün türü (2. seviye).

productTypeL3

string

Ürünün türü (3. seviye).

productTypeL4

string

Ürünün türü (4. seviye).

productTypeL5

string

Ürünün türü (5. seviye).

quarter

string

Çeyrek, bir çeyreğin ilk gününün tarihiyle gösterilir. Üç aylık dönemler için takvim yılını kullanır. Örneğin, 2018'in ikinci üç aylık dönemi 2018-04-01 tarihinde başlar. yyyy-AA-gg olarak biçimlendirilmiş olmalıdır.

week

string

Hafta, pazartesiden pazara kadar olan süre olarak tanımlanır ve pazartesi tarihiyle gösterilir. yyyy-AA-gg olarak biçimlendirilmiş olmalıdır.

year

integer

Yıl, yyyy olarak biçimlendirilmiş.

assetInteractionTarget

object (AssetInteractionTarget)

Yalnızca CustomerAsset, CampaignAsset ve AdGroupAsset metrikleriyle kullanılır. Etkileşim metriklerinin öğenin kendisinde mi yoksa farklı bir öğede veya reklam biriminde mi gerçekleştiğini gösterir. Etkileşimler (ör. tıklamalar), birlikte yayınlandıklarında yayınlanan reklamın tüm bölümlerinde (ör. reklamın kendisi ve site bağlantıları gibi diğer bileşenler) sayılır. interactionOnThisAsset doğru olduğunda etkileşimlerin bu belirli öğede gerçekleştiği, yanlış olduğunda ise etkileşimlerin bu belirli öğede değil, bu öğenin yayınlandığı yayınlanan reklamın diğer bölümlerinde gerçekleştiği anlamına gelir.

AdNetworkType

Google Ads ağ türlerini numaralandırır.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Bu sürümde değer bilinmiyor.
SEARCH Google'da arama.
SEARCH_PARTNERS Arama Ağı iş ortakları
CONTENT Görüntülü Reklam Ağı.
YOUTUBE_WATCH YouTube Videoları
MIXED Ağlar arası.

Keyword

Anahtar kelime ölçütü segmenti.

JSON gösterimi
{
  "info": {
    object (KeywordInfo)
  },
  "adGroupCriterion": string
}
Alanlar
info

object (KeywordInfo)

Anahtar kelime bilgileri.

adGroupCriterion

string

AdGroupCriterion kaynağının adı.

ProductChannelExclusivity

Ürün teklifinin stok durumunu açıklayan enum.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca dönüş değeri için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
SINGLE_CHANNEL Öğe, ProductChannel özelliğiyle belirtildiği gibi yalnızca bir kanal (yerel mağazalar veya online) üzerinden satılıyor.
MULTI_CHANNEL Öğe, online veya yerel mağazalardaki karşılığıyla eşleştirilir. Bu, öğenin her iki ShoppingProductChannels'da da satın alınabileceğini gösterir.

ProductCondition

Ürün teklifinin durumunu açıklayan enum.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca dönüş değeri için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
OLD Ürünün durumu eski.
NEW Ürünün durumu yeni olmalıdır.
REFURBISHED Ürünün durumu yenilenmiş olmalıdır.
USED Ürün durumu "ikinci el" olmalıdır.

AssetInteractionTarget

Bir AssetInteractionTarget segmenti.

JSON gösterimi
{
  "asset": string,
  "interactionOnThisAsset": boolean
}
Alanlar
asset

string

Öğe kaynak adı.

interactionOnThisAsset

boolean

Yalnızca CustomerAsset, CampaignAsset ve AdGroupAsset metrikleriyle kullanılır. Etkileşim metriklerinin öğenin kendisinde mi yoksa farklı bir öğede veya reklam biriminde mi gerçekleştiğini gösterir.