SearchAds360Row

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

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

object (AdGroup)

Sorguda başvurulan reklam grubu.

adGroupAd

object (AdGroupAd)

Sorguda başvurulan reklam.

adGroupAdLabel

object (AdGroupAdLabel)

Sorguda başvurulan reklam grubu reklam etiketi.

adGroupAsset

object (AdGroupAsset)

Sorguda başvurulan reklam grubu öğesi.

adGroupAssetSet

object (AdGroupAssetSet)

Sorguda başvurulan reklam grubu öğe grubu.

adGroupAudienceView

object (AdGroupAudienceView)

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

adGroupBidModifier

object (AdGroupBidModifier)

Sorguda başvurulan teklif değiştirici.

adGroupCriterion

object (AdGroupCriterion)

Sorguda başvurulan ölçüt.

adGroupCriterionLabel

object (AdGroupCriterionLabel)

Sorguda başvurulan reklam grubu ölçüt etiketi.

adGroupLabel

object (AdGroupLabel)

Sorguda başvurulan reklam grubu etiketi.

ageRangeView

object (AgeRangeView)

Sorguda başvurulan yaş grubu görünümü.

asset

object (Asset)

Sorguda başvurulan öğe.

assetGroupAsset

object (AssetGroupAsset)

Sorguda başvurulan öğe grubu öğesi.

assetGroupSignal

object (AssetGroupSignal)

Sorguda başvurulan öğe grubu sinyali.

assetGroupListingGroupFilter

object (AssetGroupListingGroupFilter)

Sorguda başvurulan öğe grubu listeleme grubu filtresi.

assetGroupTopCombinationView

object (AssetGroupTopCombinationView)

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

assetGroup

object (AssetGroup)

Sorguda başvurulan öğe grubu.

assetSetAsset

object (AssetSetAsset)

Sorguda başvurulan öğe grubu öğesi.

assetSet

object (AssetSet)

Sorguda başvurulan öğe grubu.

biddingStrategy

object (BiddingStrategy)

Sorguda başvurulan teklif stratejisi.

campaignBudget

object (CampaignBudget)

Sorguda başvurulan kampanya bütçesi.

campaign

object (Campaign)

Sorguda başvurulan kampanya.

campaignAsset

object (CampaignAsset)

Sorguda referans verilen kampanya öğesi.

campaignAssetSet

object (CampaignAssetSet)

Sorguda referans verilen kampanya öğesi grubu.

campaignAudienceView

object (CampaignAudienceView)

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

campaignCriterion

object (CampaignCriterion)

Sorguda başvurulan kampanya ölçütü.

campaignLabel

object (CampaignLabel)

Sorguda başvurulan kampanya etiketi.

cartDataSalesView

object (CartDataSalesView)

Sorguda başvurulan alışveriş sepeti verileri satış görünümü.

audience

object (Audience)

Sorguda referans verilen Kitle.

conversionAction

object (ConversionAction)

Sorguda başvurulan dönüşüm işlemi.

conversionCustomVariable

object (ConversionCustomVariable)

Sorguda başvurulan 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 başvurulan CustomerClient.

dynamicSearchAdsSearchTermView

object (DynamicSearchAdsSearchTermView)

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

genderView

object (GenderView)

Sorguda başvurulan cinsiyet görünümü.

geoTargetConstant

object (GeoTargetConstant)

Sorguda başvurulan coğrafi hedef sabiti.

keywordView

object (KeywordView)

Sorguda başvurulan anahtar kelime görünümü.

label

object (Label)

Sorguda başvurulan etiket.

languageConstant

object (LanguageConstant)

Sorguda referans verilen dil sabiti.

locationView

object (LocationView)

Sorguda başvurulan konum görünümü.

productBiddingCategoryConstant

object (ProductBiddingCategoryConstant)

Sorguda başvurulan Ürün Teklif Verme Kategorisi.

productGroupView

object (ProductGroupView)

Sorguda başvurulan ürün grubu görünümü.

shoppingPerformanceView

object (ShoppingPerformanceView)

Sorguda başvurulan alışveriş performansı görünümü.

userList

object (UserList)

Sorguda başvurulan kullanıcı listesi.

webpageView

object (WebpageView)

Sorguda başvurulan web sayfası görünümü.

visit

object (Visit)

Sorguda başvurulan etkinlik düzeyindeki ziyaret.

conversion

object (Conversion)

Sorguda başvurulan etkinlik düzeyindeki dönüşüm.

metrics

object (Metrics)

Metrikler.

segments

object (Segments)

Segmentler.

customColumns[]

object (Value)

Özel sütunlar.

AdGroup

Bir reklam grubu.

JSON gösterimi
{
  "resourceName": string,
  "status": enum (AdGroupStatus),
  "type": enum (AdGroupType),
  "adRotationMode": enum (AdGroupAdRotationMode),
  "creationTime": string,
  "targetingSetting": {
    object (TargetingSetting)
  },
  "labels": [
    string
  ],
  "engineId": string,
  "startDate": string,
  "endDate": string,
  "languageCode": string,
  "lastModifiedTime": string,
  "id": string,
  "name": string,
  "cpcBidMicros": string,
  "engineStatus": enum (AdGroupEngineStatus)
}
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 dilimindedir ve "yyyy-AA-gg SS:dd:ss" biçimindedir.

targetingSetting

object (TargetingSetting)

Hedeflemeyle ilgili özellikler için ayar.

labels[]

string

Bu reklam grubuna ekli etiketlerin kaynak adları.

engineId

string

Harici motor hesabındaki reklam grubunun kimliği. Bu alan, yalnızca Google Ads harici hesaplar (örneğin, Yahoo Japan, Microsoft, Baidu vb.) içindir. Google Ads varlığı için bunun yerine "adGroup.id" değerini kullanın.

startDate

string

Bu reklam grubunun reklam yayınlamaya başladığı tarih. Varsayılan olarak, reklam grubu şimdi veya reklam grubunun başlangıç tarihi (hangisi daha sonraysa) 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ı sonlandırdığı 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 dilidir. Bu alan yalnızca Microsoft Advertising hesaplarında kullanılabilir. Daha fazla bilgi için https://docs.microsoft.com/en-us/advertising/guides/ad-languages?view=bingads-13#adlanguage adresini ziyaret edebilirsiniz.

lastModifiedTime

string

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

id

string (int64 format)

Reklam grubunun kimliği.

name

string

Reklam grubunun adı.

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

255'ten az 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.

cpcBidMicros

string (int64 format)

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

engineStatus

enum (AdGroupEngineStatus)

Reklam grubu için Motor Durumu.

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 odaklı bir değerdir.

ENABLED Reklam grubu etkinleştirilir.
PAUSED Reklam grubu duraklatıldı.
REMOVED Reklam grubu kaldırılır.

AdGroupType

Olası reklam grubu türlerini listeleyen sıralama.

Sıralamalar
UNSPECIFIED Tür belirtilmedi.
UNKNOWN

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

Bu yalnızca yanıt odaklı bir değerdir.

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ı için reklam grubu türü.
SHOPPING_SHOWCASE_ADS Alışveriş sonuçlarında Vitrin veya Satıcı reklamları yayınlamakla sınırlı olan reklam grubu 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, atlanamayan yayın içi video reklamlar.
VIDEO_TRUE_VIEW_IN_STREAM TrueView (atlanabilir) yayın içi video reklamları.
VIDEO_TRUE_VIEW_IN_DISPLAY Görüntülü (In-display) TrueView video reklamları.
VIDEO_NON_SKIPPABLE_IN_STREAM Atlanamayan video içi 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ş Karşılaştırma Girişi kampanyalarındaki reklam gruplarının türü.
PROMOTED_HOTEL_ADS Tanıtılan Otel reklam grupları için reklam grubu türü.
VIDEO_RESPONSIVE Video duyarlı reklam grupları.
VIDEO_EFFICIENT_REACH Video açısından 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 belirtilmedi.
UNKNOWN

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

Bu yalnızca yanıt odaklı bir değerdir.

OPTIMIZE Reklam grubu reklamlarını tıklamalara veya dönüşümlere 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öndürülen değer 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ği için bu reklam grubu için reklam yayınlanmıyor.
AD_GROUP_REMOVED Reklam grubu silindi.
AD_GROUP_DRAFT İlişkili reklam grubu hâlâ taslak biçiminde 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 grubu için reklam yayınlanmıyor.
ACCOUNT_PAUSED Hesap duraklatıldığı için bu reklam grubu için reklam yayınlanmıyor.

TargetingSetting

Kampanya ve reklam grubu düzeylerinde hedeflemeyle ilgili özelliklerin 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ıtlayan 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 uygulandığı hedefleme boyutu.

bidOnly

boolean

Reklamlarınızın yalnızca butargetingDimension için seçtiğiniz ölçütler için mi kısıtlanacağını, yoksa butargetingDimension için tüm değerleri hedefleyeceği ve reklamları diğer HedeflemeBoyutlarındaki hedeflemenize göre gösterip göstermeyeceğinizi belirtir. true değeri, bu ölçütlerin yalnızca teklif değiştiriciler uygulayacağı ve hedeflemeyi etkilemediği anlamına gelir. false değeri, bu ölçütlerin hedeflemeyi de kısıtlayacağı ve teklif değiştiricilerin uygulanmasını kısıtlayacağı anlamına gelir.

TargetingDimension

Olası hedefleme boyutlarını açıklayan enum.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca döndürülen değer için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
KEYWORD Anahtar kelime ölçütleri, örneğin "mars yolculuğu". KEYWORD, özel teklif boyutu olarak kullanılabilir. Anahtar kelimeler her zaman bir hedefleme boyutudur. Bu nedenle, TargetRestriction ile "TÜMÜ" bir hedef boyutu olarak ayarlanamaz.
AUDIENCE Kullanıcı listesi, kullanıcı ilgi alanı, özel yakın ilgi alanı ve pazardaki özel kitleleri içeren kitle ölçütleri.
TOPIC İçerik kategorilerini hedeflemek için kullanılan konu ölçütleri. Örneğin, "category::Hayvanlar>Evcil Hayvanlar" Görüntülü Reklam Ağı ve Video hedefleme için kullanılır.
GENDER Cinsiyet hedefleme ölçütleri.
AGE_RANGE Yaş gruplarını hedefleme ölçütleri.
PLACEMENT 'www.cicek4indirim.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

Bir reklam grubu reklamı.

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

string

Reklamın kaynak adı. Reklam grubu reklam kaynağı 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'ın oluşturulduğu zaman damgası. Tarih ve saat, müşterinin saat dilimindedir ve "yyyy-AA-gg SS:dd:ss.ssssss" biçimindedir.

labels[]

string

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

engineId

string

Reklamın harici motor hesabındaki kimliği. Bu alan yalnızca Search Ads 360 hesabı (ör. Yahoo Japan, Microsoft, Baidu vb.) içindir. Search Ads 360 haricindeki varlıklar için bunun yerine "adGroupAd.ad.id" değerini kullanın.

engineStatus

enum (AdGroupAdEngineStatus)

Harici motor hesabındaki reklamın ek durumu. Olası durumlar (harici hesabın türüne bağlı olarak) etkin, uygun, incelenmeyi bekliyor vb. durumları içerir.

lastModifiedTime

string

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

AdGroupAdStatus

Bir Reklam Grubu reklamının olası durumlarıdır.

Sıralamalar
UNSPECIFIED Değer belirtilmedi.
UNKNOWN

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

Bu yalnızca yanıt odaklı bir değerdir.

ENABLED Reklam grubu reklamı etkinleştirilir.
PAUSED Reklam grubu reklamı duraklatıldı.
REMOVED Reklam grubu reklamı kaldırılır.

AdType

Olası reklam türleri.

Sıralamalar
UNSPECIFIED Değer belirtilmedi.
UNKNOWN

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

Bu yalnızca yanıt odaklı bir değerdir.

TEXT_AD Reklam bir metin reklamdır.
EXPANDED_TEXT_AD Reklam, genişletilmiş metin reklam olmalıdır.
CALL_ONLY_AD Reklam, yalnızca telefon araması üreten bir reklamdır.
EXPANDED_DYNAMIC_SEARCH_AD Reklam, genişletilmiş dinamik arama ağı reklamı olmalıdır.
HOTEL_AD Reklam bir otel reklamı olmalıdır.
SHOPPING_SMART_AD Reklam bir Akıllı Alışveriş reklamı olmalıdır.
SHOPPING_PRODUCT_AD Reklam, standart Alışveriş reklamı.
VIDEO_AD Reklam bir video reklam olmalıdır.
GMAIL_AD Bu reklam bir Gmail reklamıdır.
IMAGE_AD Bu reklam bir Resim reklamdır.
RESPONSIVE_SEARCH_AD Reklamın duyarlı arama ağı reklamı olması
LEGACY_RESPONSIVE_DISPLAY_AD Reklam, eski bir duyarlı görüntülü reklam.
APP_AD Reklam bir uygulama reklamıdır.
LEGACY_APP_INSTALL_AD Reklam, eski bir uygulama yükleme reklamı olmalıdır.
RESPONSIVE_DISPLAY_AD Reklamın duyarlı görüntülü reklam olması.
LOCAL_AD Reklam, bir yerel reklamdır.
HTML5_UPLOAD_AD Reklam, ürün türü HTML5_UPLOAD_AD olan bir görüntülü yükleme reklamı olmalıdır.
DYNAMIC_HTML5_AD Reklam, DYNAMIC_HTML5_* ürün türlerinden birine sahip bir görüntülü yükleme reklamı olmalıdır.
APP_ENGAGEMENT_AD Reklam, bir uygulama etkileşimi reklamı olmalıdır.
SHOPPING_COMPARISON_LISTING_AD Reklam, Alışveriş karşılaştırma reklamıdır.
VIDEO_BUMPER_AD Video bumper reklamı.
VIDEO_NON_SKIPPABLE_IN_STREAM_AD Video, atlanamayan yayın içi reklam.
VIDEO_OUTSTREAM_AD Yayın dışı video reklamı.
VIDEO_TRUEVIEW_DISCOVERY_AD Video Görüntülü (In-display) TrueView reklamı.
VIDEO_TRUEVIEW_IN_STREAM_AD Video yayın içi (in-stream) TrueView 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 duyarlı 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örünen URL'si.

displayMobileUrl

string

Reklamın görünen 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

Metin, otomatik olarak oluşturulan görünür URL'ye bir ayırıcıyla eklenir.

path2

string

Metin, yol1'e bir ayırıcıyla eklendi.

adTrackingId

string (int64 format)

Reklamın izleme kimliği.

SearchAds360ResponsiveSearchAdInfo

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

JSON gösterimi
{
  "path1": string,
  "path2": string,
  "adTrackingId": string
}
Alanlar
path1

string

Metin, otomatik olarak oluşturulan görünür URL'ye bir ayırıcıyla eklenir.

path2

string

Metin, yol1'e bir ayırıcıyla eklendi.

adTrackingId

string (int64 format)

Reklamın izleme kimliği.

SearchAds360ProductAdInfo

Bu türde alan yok.

Search Ads 360 ürün reklamı.

SearchAds360ExpandedDynamicSearchAdInfo

Genişletilmiş 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

Reklam Grubu Reklam motor durumlarını sıralar.

Sıralamalar
UNSPECIFIED Değer belirtilmedi.
UNKNOWN Yalnızca döndürülen değer 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 inceleniyor.
AD_GROUP_AD_PARTIALLY_INVALID Baidu: Reklam öğesi mobil cihazda geçersiz, masaüstünde de geçerlidir.
AD_GROUP_AD_TO_BE_ACTIVATED Baidu: Reklam öğesi etkinleştirme için hazır.
AD_GROUP_AD_NOT_REVIEWED Baidu: Reklam öğesi incelenmedi.
AD_GROUP_AD_ON_HOLD

Kullanımdan kaldırıldı. Kullanmayın. Gemini tarafından daha önce kullanıldı

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

AdGroupAdLabel

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

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

string

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

adGroupAd

string

Etiketin eklendiği reklam grubu reklamı.

label

string

Reklam grubu reklamına atanan etiket.

AdGroupAsset

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ı aşağıdaki biçimdedir:

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

adGroup

string

Zorunlu. Öğenin bağlı olduğu reklam grubu.

asset

string

Zorunlu. Reklam grubuna bağlı olan öğ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öndürülen değer için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
ENABLED Öğe bağlantısı etkinleştirildi.
REMOVED Öğe bağlantısı kaldırıldı.
PAUSED Öğe bağlantısı duraklatıldı.

AdGroupAssetSet

AdGroupAssetSet, bir reklam grubu ile öğe grubu arasındaki bağlantıdır. AdGroupAssetSet oluşturulduğunda öğe grubunu bir reklam grubuna 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ğlı olduğu reklam grubu.

assetSet

string

Reklam grubuna bağlı olan öğe grubu.

status

enum (AssetSetLinkStatus)

Reklam grubu öğe grubunun durumu. Salt okunurdur.

AssetSetLinkStatus

Öğe grubu ile kapsayıcı 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 odaklı bir değerdir.
ENABLED Öğe grubu ve kapsayıcısı arasındaki bağlantı etkinleştirilir.
REMOVED Öğe grubu ve kapsayıcısı arasındaki bağlantı kaldırıldı.

AdGroupAudienceView

Reklam grubu kitle görünümü. Görüntülü Reklam Ağı ve YouTube Ağı reklamlarına yönelik ilgi alanları ve yeniden pazarlama listelerinin yanı sıra Arama Ağı reklamlarına yönelik yeniden pazarlama listelerinden (ARYPL) kitle düzeyinde birleştirilmiş performans verilerini 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

Bir 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ştiricisi kaynak adları şu biçimdedir:

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

bidModifier

number

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

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

V5'ten başlayan oluşturma işlemlerinde gereklidir. criterion şunlardan 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ılabilecek Google Ads cihazlarını sıralar.

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

AdGroupCriterion

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

JSON gösterimi
{
  "resourceName": string,
  "creationTime": string,
  "status": enum (AdGroupCriterionStatus),
  "qualityInfo": {
    object (QualityInfo)
  },
  "type": enum (CriterionType),
  "labels": [
    string
  ],
  "positionEstimates": {
    object (PositionEstimates)
  },
  "finalUrls": [
    string
  ],
  "engineId": string,
  "lastModifiedTime": string,
  "criterionId": string,
  "adGroup": string,
  "negative": boolean,
  "bidModifier": number,
  "cpcBidMicros": string,
  "effectiveCpcBidMicros": string,
  "engineStatus": enum (AdGroupCriterionEngineStatus),
  "finalUrlSuffix": string,
  "trackingUrlTemplate": string,

  // Union field criterion can be only one of the following:
  "keyword": {
    object (KeywordInfo)
  },
  "listingGroup": {
    object (ListingGroupInfo)
  },
  "ageRange": {
    object (AgeRangeInfo)
  },
  "gender": {
    object (GenderInfo)
  },
  "userList": {
    object (UserListInfo)
  },
  "webpage": {
    object (WebpageInfo)
  },
  "location": {
    object (LocationInfo)
  }
  // End of list of possible types for union field criterion.
}
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 dilimindedir 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 çalıştırılmaya uygun olup olmadığını etkileyen ek bilgiler içerebilir. Bazı durumlarda, API'da KALDIRILDIĞI bir ölçüt, kullanıcı arayüzünde etkin olarak görünmeye devam edebilir. Örneğin, kampanyalar hariç tutulmadıkça varsayılan olarak tüm yaş aralıklarındaki kullanıcılara gösterilir. Kullanıcı arayüzü, reklamları görmeye uygun olduğu için her bir yaş aralığını "etkin" olarak gösterir; ancak herhangi bir pozitif ölçüt eklenmediği için AdGroupCriterion.status "kaldırıldı" değerini gösterir.

qualityInfo

object (QualityInfo)

Ölçütün kalitesi hakkında bilgi.

type

enum (CriterionType)

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

labels[]

string

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

positionEstimates

object (PositionEstimates)

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

finalUrls[]

string

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

engineId

string

Harici motor hesabındaki reklam grubu ölçütünün kimliği. Bu alan, yalnızca Google Ads harici hesaplar (örneğin, Yahoo Japan, Microsoft, Baidu vb.) içindir. Google Ads varlığı için bunun yerine "adGroupCriterion.ölçüt_kimliği" değerini 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 dilimindedir ve "yyyy-AA-gg SS:dd:ss.ssssss" biçimindedir.

criterionId

string (int64 format)

Ölçüt kimliği.

adGroup

string

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

negative

boolean

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

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

bidModifier

number

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

cpcBidMicros

string (int64 format)

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

effectiveCpcBidMicros

string (int64 format)

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

engineStatus

enum (AdGroupCriterionEngineStatus)

Reklam grubu ölçütü için Motor Durumu.

finalUrlSuffix

string

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

trackingUrlTemplate

string

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

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

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

keyword

object (KeywordInfo)

Anahtar kelime.

listingGroup

object (ListingGroupInfo)

Giriş 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 öğesinin olası durumları.

Sıralamalar
UNSPECIFIED Değer belirtilmedi.
UNKNOWN

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

Bu yalnızca yanıt odaklı bir değerdir.

ENABLED Reklam grubu ölçütü etkinleştirildi.
PAUSED Reklam grubu ölçütü duraklatıldı.
REMOVED Reklam grubu ölçütü kaldırılır.

QualityInfo

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

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

integer

Kalite puanı.

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

CriterionType

Olası ölçüt türlerini açıklayan numaralandırma.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca döndürülen değer için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
KEYWORD Anahtar kelime, örneğin "mars yolculuğu".
PLACEMENT Web sitesi olarak da bilinen yerleşim; ör. "www.cicek4indirimi.com"
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ğı'ndaki bir konu hedefi (ör. "Evcil ve Yabani Hayvanlar").
LISTING_SCOPE Hedeflenecek giriş kapsamı.
LANGUAGE Dil.
IP_BLOCK IpBlock'a dokunun.
CONTENT_LABEL Kategori hariç tutma için İç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'na dokunun.
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 teklifleri için tahminler.

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

string (int64 format)

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

AdGroupCriterionEngineStatus

AdGroupCriterion motor durumlarını sıralar.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca döndürülen değer için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
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 inceleniyor.
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 artık etkinleştirmeniz için hazır.
AD_GROUP_CRITERION_UNDER_REVIEW Baidu: Baidu tarafından incelenmek üzere işleniyor. İkizler: Ölçüt inceleniyor.
AD_GROUP_CRITERION_NOT_REVIEWED Baidu: İncelenecek ölçüt.
AD_GROUP_CRITERION_ON_HOLD

Kullanımdan kaldırıldı. Kullanmayın. Gemini tarafından daha önce kullanıldı

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 de duraklatıldı.

KeywordInfo

Bir 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 kelime metni (en fazla 80 karakter ve 10 kelime).

KeywordMatchType

Olası Anahtar kelime eşleme türleri.

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

AgeRangeInfo

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

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

enum (AgeRangeType)

Yaş grubunun türü.

AgeRangeType

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

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

GenderInfo

Cinsiyet ölçütü.

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

enum (GenderType)

Cinsiyetin türü.

GenderType

Demografik cinsiyetlerin türü (örneğin, kadın).

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

UserListInfo

Kullanıcı Listesi ölçütü. Hedeflenecek reklamveren tarafından tanımlanan bir kullanıcı listesini temsil eder.

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

string

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

WebpageInfo

Bir reklamverenin web sitesindeki web sayfalarını hedeflemeye ilişkin bir ölçütü 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 birlikte belirlenir. Boş bir koşul listesi, kampanya web sitesindeki tüm sayfaların hedeflendiğini gösterir.

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

coveragePercentage

number

Web sitesi ölçütlerinin kapsam yüzdesi. Bu değer, reklam grubu ve kampanyadaki web sitesi hedefine, negatif web sitesi hedefine ve negatif anahtar kelimelere dayalı olarak web sitesi kapsamının hesaplanan yüzdesidir. Örneğin, kapsamın 1 olarak döndürülmesi% 100 kapsama sahip olduğunu gösterir. Bu alan salt okunurdur.

criterionName

string

Bu parametreyle tanımlanan ölçütün adı. Ad değeri, bu tür parametrelerle ölçütleri tanımlamak, sıralamak ve filtrelemek için kullanılır.

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

WebpageConditionInfo

Bir reklamverenin web sitesindeki web sayfalarını hedeflemek için mantıksal ifade.

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

enum (WebpageConditionOperand)

Web sayfası hedefleme koşulunun işlenmesi.

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öndürülen değer 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şlem.
CATEGORY Bir web sayfası kategorisi hedefleme koşulunu belirten ticaret işlemi.
PAGE_TITLE Web sayfası başlığı hedefleme koşulunu belirten bir işlem.
PAGE_CONTENT Web sayfası içeriği hedefleme koşulunu belirten bir işlem.
CUSTOM_LABEL Web sayfası özel etiketi hedefleme koşulunu belirten bir işlem.

WebpageConditionOperator

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

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca döndürülen değer için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
EQUALS Bağımsız değişken web koşulu, karşılaştırılan web koşuluna eşit.
CONTAINS Bağımsız değişken web koşulu, karşılaştırılan web koşulunun bir parçasıdır.

LocationInfo

Konum ölçütü.

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

string

Coğrafi hedef sabit kaynak adı.

AdGroupCriterionLabel

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

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

string

Reklam grubu ölçüt etiketinin kaynak adı. Reklam grubu ölçütü etiketi kaynak adları şu biçimdedir: customers/{customerId}/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.

AdGroupLabel

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

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

string

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

adGroup

string

Etiketin eklendiği reklam grubu.

label

string

Reklam grubuna atanan etiket.

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

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

JSON gösterimi
{
  "resourceName": string,
  "type": enum (AssetType),
  "finalUrls": [
    string
  ],
  "status": enum (AssetStatus),
  "creationTime": string,
  "lastModifiedTime": string,
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "engineStatus": enum (AssetEngineStatus),

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

string

Öğenin kaynak adı. Öğe kaynağı 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.

status

enum (AssetStatus)

Öğenin durumudur.

creationTime

string

Bu öğenin oluşturulduğu zaman damgası. Zaman damgası müşterinin saat dilimindedir 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 dilimindedir 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şturmaya yönelik URL şablonu.

engineStatus

enum (AssetEngineStatus)

Bir öğenin motor durumu.

Birleştirme alanı asset_data. Öğenin belirli türüdür. asset_data şunlardan yalnızca biri olabilir:
youtubeVideoAsset

object (YoutubeVideoAsset)

YouTube video öğesi.

imageAsset

object (ImageAsset)

Resim öğesidir.

textAsset

object (TextAsset)

Metin öğesidir.

calloutAsset

object (UnifiedCalloutAsset)

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

pageFeedAsset

object (UnifiedPageFeedAsset)

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

mobileAppAsset

object (MobileAppAsset)

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

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca döndürülen değer için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
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 oteller ve kiralık yerler öğesi.
DYNAMIC_FLIGHTS Dinamik uçuş öğ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ıdır.

Sıralamalar
UNSPECIFIED Durum belirtilmedi.
UNKNOWN Alınan değer bu sürümde bilinmiyor. Bu yalnızca yanıt odaklı bir değerdir.
ENABLED Öğe etkinleştirildi.
REMOVED Öğe kaldırılır.
ARCHIVED Öğe arşivlendi.
PENDING_SYSTEM_GENERATED Öğe, sistem tarafından oluşturulmuş ve kullanıcı tarafından incelenmeyi bekliyordur.

AssetEngineStatus

Sonraki Kimlik = 11

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca döndürülen değer için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
SERVING Öğe etkin durumda.
SERVING_LIMITED Öğe etkin ve sınırlı.
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 video 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 boyutunda 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 odaklı bir değerdir.

IMAGE_JPEG Resmin MIME türü.
IMAGE_GIF Resmin/gif'in MIME türü.
IMAGE_PNG Resmin/png'nin MIME türü.
FLASH Uygulamanın/x-shockwave-flash'ın MIME türü.
TEXT_HTML Metin/html'nin MIME türü.
PDF Uygulamanın/pdf'nin MIME türü.
MSWORD Uygulamanın/msword'ün MIME türü.
MSEXCEL Uygulama/vnd.ms-excel MIME türü.
RTF Uygulamanın/rtf'nin MIME türü.
AUDIO_WAV Ses/wav'nin MIME türü.
AUDIO_MP3 Ses/mp3 MIME türü.
HTML5_AD_ZIP Uygulama/x-html5-ad-zip'in MIME türü.

ImageDimension

Belirli bir boyuttaki, orijinal veya yeniden boyutlandırılmış 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

Bu yüksekliğe ve genişliğe sahip resmi 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 (1 ve 25 dahil) olmalıdır.

startDate

string

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

endDate

string

Bu öğenin etkin olduğu ve hâlâ sunulmaya 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 programların listesi. Bir günde en fazla 6, toplamda 42 program olabilir.

useSearcherTimeZone

boolean

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

AdScheduleInfo

Bir AdSchedule ö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ı AdSchedules 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ığı başlangıç saatinden 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 bitiş saatinden sonraki dakikalar. Programa bitiş dakikası dahil değildir.

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 saatlik biçimde başlangıç saati. Bu alan 0 ile 23 arasında (0 ve 23 dahil) olmalıdır.

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

endHour

integer

24 saatlik biçimde bitiş saati; 24, gün sonunu belirtir. Bu alan 0 ile 24 arasında (0 ve 24 dahil) olmalıdır.

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

MinuteOfHour

Çeyrek saatlerin sayıları. Örneğin, "ON BAŞLIK"

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Değer, bu sürümde bilinmiyor.
ZERO Saatin üzerinden sıfır dakika geçti.
FIFTEEN Saat on beş dakika geçiyor.
THIRTY Saat otuz dakika geçiyor.
FORTY_FIVE Saat kırk beş dakika geçti.

DayOfWeek

Haftanın günlerini sıralar (örneğin, "Pazartesi").

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Değer, bu sürümde 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ı açıklamasının ilk satırı. Ayarlanırsa uzunluk 1 ile 35 arasında (her iki değer de dahil) olmalıdır ve açıklama2 de ayarlanmalıdır.

description2

string

Site bağlantısının açıklamanın ikinci satırı. Ayarlanırsa uzunluk 1 ile 35 arasında (her iki değer de dahil) olmalıdır ve açıklama1 de ayarlanmalıdır.

startDate

string

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

endDate

string

Bu öğenin etkin olduğu ve hâlâ sunulmaya 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 programların listesi. Bir günde en fazla 6, toplamda 42 program olabilir.

trackingId

string (int64 format)

Site bağlantısı öğesine ilişkin tıklamaları izlemek için kullanılan kimlik. Bu bir Yahoo! Japan için kullanılabilir.

useSearcherTimeZone

boolean

Site bağlantısı öğesinin, arama yapan kullanıcı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österilip gösterilmeyeceği. Microsoft Ads için geçerlidir.

UnifiedPageFeedAsset

Birleştirilmiş 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 bir dize. Yalnızca platform yerel kimliğini (ör. Android için "com.android.ebay" veya iOS için "12345689") içermelidir.

appStore

enum (MobileAppVendor)

Zorunlu. Belirli bir uygulamayı dağıtan uygulama mağazası.

MobileAppVendor

Mobil uygulama satıcısının türü

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca döndürülen değer için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
APPLE_APP_STORE Apple App Store için mobil uygulama tedarikçi firması.
GOOGLE_APP_STORE Google App Store 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: "TR", "biz".

phoneNumber

string

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

callConversionReportingState

enum (CallConversionReportingState)

Bu CallAsset'in kendi telefon araması dönüşümü ayarını kullanması mı, hesap düzeyindeki ayarı takip etmesi mi yoksa telefon araması dönüşümünü devre dışı bırakmak mı gerektiğini belirtir.

callConversionAction

string

Bir telefon araması dönüşümünün ilişkilendirileceği dönüşüm işlemi. Politika ayarlanmazsa varsayılan dönüşüm işlemi kullanılır. Bu alanın etkisi 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 programların listesi. Bir günde en fazla 6, toplamda 42 program olabilir.

callOnly

boolean

Telefon aramasında, web sitesinin bağlantısı olmadan yalnızca telefon numarasının gösterilip gösterilmediği. Microsoft Ads için geçerlidir.

callTrackingEnabled

boolean

Arama izlemede aramanın etkinleştirilip etkinleştirilmeyeceği. Microsoft Ads için geçerlidir.

useSearcherTimeZone

boolean

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

startDate

string

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

endDate

string

Bu öğenin etkin olduğu ve hâlâ sunulmaya devam ettiği son tarih (yyyy-AA-gg biçiminde).

CallConversionReportingState

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

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca döndürülen değer için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
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 belirlenen 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 ayarlanmış 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.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca döndürülen değer için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
LEARN_MORE Harekete geçirici mesaj türü "daha fazla bilgi"dir.
GET_QUOTE Harekete geçirici mesaj türü "Fiyat teklifi al"dır.
APPLY_NOW Harekete geçirici mesaj türü uygulanır.
SIGN_UP Harekete geçirici mesaj türü "kaydolma"dır.
CONTACT_US Harekete geçirici mesaj türü bizimle iletişime geçin.
SUBSCRIBE Harekete geçirici mesaj türü "Abone ol"dur.
DOWNLOAD Harekete geçirici mesaj türü "indir"dir.
BOOK_NOW Harekete geçirici mesaj türü "hemen yer ayırtın"dır.
SHOP_NOW Harekete geçirici mesaj türü "Hemen satın al"dır.
BUY_NOW Harekete geçirici mesaj türü "Hemen satın al"dır.
DONATE_NOW Harekete geçirici mesaj türü "Şimdi bağış yap"tır.
ORDER_NOW Harekete geçirici mesaj türü "Şimdi sipariş ver"dir.
PLAY_NOW Harekete geçirici mesaj türü "Şimdi oynat"tır.
SEE_MORE Harekete geçirici mesaj türü daha fazla gösterir.
START_NOW Harekete geçirici mesaj türü şimdi başlıyor.
VISIT_SITE Harekete geçirici mesaj türü, siteyi ziyaret et'tir.
WATCH_NOW Harekete geçirici mesaj türü "Şimdi izle"dir.

UnifiedLocationAsset

Birleştirilmiş yer öğesi.

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

string

Yer kimlikleri, Google Rehber veritabanında ve Google Haritalar'da bir yeri benzersiz bir ş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 adresine bakın.

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ğine işaret eden birden fazla İşletme Profili girişi olabilir.

locationOwnershipType

enum (LocationOwnershipType)

Konum sahipliğinin türü. Tür BUSINESS_OWNER ise yer uzantısı olarak sunulur. Tür SATIŞ ORTAĞI ise satış ortağı konumu olarak sunulur.

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

Reklamveren, İşletme Profili hesabında konum için etiket belirtti. Bu veriler İşletme Profili hesabından senkronize edilir.

storeCode

string

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

listingId

string (int64 format)

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

LocationOwnershipType

Olası konum sahipliği türleri.

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

AssetGroupAsset

AssetGroupAsset, bir öğe ile öğe grubu arasındaki bağlantıdır. AssetGroupAsset eklendiğinde, bir öğe bir öğe grubuna bağlanır.

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 kaynağı adı şu biçimdedir:

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

assetGroup

string

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

asset

string

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

fieldType

enum (AssetFieldType)

Öğe grubundaki öğenin yerleşiminin açıklamasıdır. Ö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.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca döndürülen değer için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
HEADLINE Öğe, başlık olarak kullanılmak üzere bağlıdır.
DESCRIPTION Öğe, açıklama olarak kullanılmak üzere bağlanmıştır.
MANDATORY_AD_TEXT Öğe, zorunlu reklam metni olarak kullanılmak üzere bağlanmış.
MARKETING_IMAGE Öğe, pazarlama resmi olarak kullanılmak üzere bağlanmış.
MEDIA_BUNDLE Öğe, medya paketi olarak kullanılmak üzere bağlanmış.
YOUTUBE_VIDEO Öğe, YouTube videosu olarak kullanılmak üzere bağlanmıştır.
BOOK_ON_GOOGLE Bir otel kampanyasında "Google'da rezervasyon yap" özelliğinin etkin olduğunu belirtmek için öğe bağlanır.
LEAD_FORM Öğe, potansiyel müşteri formu uzantısı olarak kullanılmak üzere bağlanmış.
PROMOTION Öğe, promosyon uzantısı olarak kullanılmak üzere bağlanmış.
CALLOUT Öğe, açıklama metni uzantısı olarak kullanılmak üzere bağlanmış.
STRUCTURED_SNIPPET Öğe, Ek Açıklamalı Snippet uzantısı olarak kullanılmak üzere bağlanmış.
MOBILE_APP Öğe, Mobil Uygulama uzantısı olarak kullanılmak üzere bağlanmış.
HOTEL_CALLOUT Öğe, otel açıklama metni uzantısı olarak kullanılmak üzere bağlanmış.
CALL Öğe, telefon uzantısı olarak kullanılmak üzere bağlanmış.
PRICE Öğe, fiyat uzantısı olarak kullanılmak üzere bağlandı.
LONG_HEADLINE Öğe, uzun başlık olarak kullanılmak üzere bağlanmış.
BUSINESS_NAME Öğe, işletme adı olarak kullanılmak üzere bağlanmış.
SQUARE_MARKETING_IMAGE Öğe, kare pazarlama resmi olarak kullanılmak üzere bağlanmış.
PORTRAIT_MARKETING_IMAGE Öğe, dikey pazarlama resmi olarak kullanılmak üzere bağlanmış.
VIDEO Öğe, YouTube dışı bir logo olarak kullanılmak üzere bağlanmış.
CALL_TO_ACTION_SELECTION Öğe, harekete geçirici mesaj seçmek için kullanılmak üzere bağlıdır.
AD_IMAGE Öğe, reklam resmi seçmek için kullanılmak üzere bağlıdır.
HOTEL_PROPERTY Öğe, seyahat hedefleri için Maksimum Performans kampanyasında otel mülkü olarak kullanılmak üzere bağlanmış.

AssetGroupSignal

AssetGroupSignal, bir öğe grubundaki bir sinyali temsil eder. Sinyalin varlığı, dönüşüm gerçekleştirme olasılığı en yüksek olan Maksimum Performans kampanyasını bildirir. Maksimum Performans kampanyaları; Arama Ağı, 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 sinyal kaynağı adı şu biçimdedir:

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

assetGroup

string

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

Birleştirme alanı signal. Öğe grubunun sinyali. signal şunlardan yalnızca biri olabilir:
audience

object (AudienceInfo)

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

AudienceInfo

Bir kitle ölçütü.

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

string

Kitle kaynak adı.

AssetGroupListingGroupFilter

AssetGroupListingGroupFilter, bir öğe grubundaki bir 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 filtre kaynağı 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 öğesinin 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 sektör. Aynı ağaçtaki tüm düğümler aynı temaya ait olmalıdır.

caseValue

object (ListingGroupFilterDimension)

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

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öndürülen değer için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
SUBDIVISION Bazı listeleme boyutları boyunca ürünlerin alt bölümü.
UNIT_INCLUDED Dahil edilen bir listeleme grubu filtre yaprak düğümü.
UNIT_EXCLUDED Hariç tutulan listeleme grubu filtresi yaprak düğümü.

ListingGroupFilterVertical

Listeleme grubu filtre temasının türü.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca döndürülen değer için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
SHOPPING Alışveriş sektörünü temsil eder. Sektöre yalnızca Perakende için Maksimum Performans kampanyalarında izin verilir.

ListingGroupFilterDimension

Öğe grubu listeleme grubu filtresinin giriş 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
Birleştirme alanı dimension. Aşağıdaki türlerden birindeki boyut her zaman mevcuttur. dimension şunlardan yalnızca biri olabilir:
productBiddingCategory

object (ProductBiddingCategory)

Bir ürün teklifinin teklif kategorisi.

productBrand

object (ProductBrand)

Bir ürün teklifinin markası.

productChannel

object (ProductChannel)

Ürün teklifinin bulunduğu yer.

productCondition

object (ProductCondition)

Ürün teklifinin durumudur.

productCustomAttribute

object (ProductCustomAttribute)

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

productItemId

object (ProductItemId)

Bir ürün teklifinin öğe kimliğidir.

productType

object (ProductType)

Ürün teklifinin türü.

ProductBiddingCategory

Belirli bir düzeydeki teklif kategorisinin bir öğesi. Üst düzey kategoriler 1. düzeydedir, onların alt kategorileri 2. düzeydedir vb. Şu anda en fazla 5 seviye desteklenmektedir. Kullanıcı, kategori düzeyini belirten bir boyut türü belirtmelidir. Aynı alt bölümün tüm durumları aynı boyut türüne (kategori düzeyi) sahip olmalıdır.

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

enum (ListingGroupFilterBiddingCategoryLevel)

Sınıflandırmadaki kategori seviyesini gösterir.

id

string (int64 format)

Ürün teklif kategorisinin kimliği.

Bu kimlik, şu makalede açıklanan google_product_category [google_ürün_kategorisi] kimliğine eşdeğerdir: https://support.google.com/merchants/answer/6324436

ListingGroupFilterBiddingCategoryLevel

Listeleme grubu filtresi teklif verme kategorisinin düzeyi.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca döndürülen değer için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
LEVEL1 1. Düzey:
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 bulunduğu yer.

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

enum (ListingGroupFilterProductChannel)

Konumun değeri.

ListingGroupFilterProductChannel

Bir ürün teklifinin konumunu açıklayan enum.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca döndürülen değer için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
ONLINE Ürün, internet üzerinden satılmaktadır.
LOCAL Ürün yerel mağazalarda satılmaktadır.

ProductCondition

Ürün teklifinin durumudur.

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

enum (ListingGroupFilterProductCondition)

Koşulun değeri.

ListingGroupFilterProductCondition

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

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca döndürülen değer için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
NEW Ürünün durumu yenidir.
REFURBISHED Ürün yenilenmiş durumda.
USED Ürün durumu kullanılıyor.

ProductCustomAttribute

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

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

enum (ListingGroupFilterCustomAttributeIndex)

Özel özelliğin dizinini belirtir.

value

string

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

ListingGroupFilterCustomAttributeIndex

Müşteri özellikleri dizini.

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

ProductItemId

Bir ürün teklifinin öğe kimliğidir.

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

Ürün teklifi türünün düzeyini açıklayan enum.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca döndürülen değer için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
LEVEL1 1. Düzey:
LEVEL2 2. Seviye:
LEVEL3 3. Seviye:
LEVEL4 4. Seviye:
LEVEL5 5. Seviye:

ListingGroupFilterDimensionPath

Listeleme grubu filtresini tanımlayan boyutları tanımlayan yol.

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

object (ListingGroupFilterDimension)

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

AssetGroupTopCombinationView

Reklam grubu reklam öğesi kombinasyonunun kullanımıyla ilgili 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 En İyi Kombinasyon 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 kombinasyon verileri

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

object (AssetUsage)

Yayınlanan öğ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 odaklı bir değerdir.

HEADLINE_1 Öğe, başlık 1'de kullanılıyor.
HEADLINE_2 Öğe, başlık 2'de kullanılıyor.
HEADLINE_3 Öğe, başlık 3'te kullanılıyor.
DESCRIPTION_1 Öğe, açıklama 1'de kullanılıyor.
DESCRIPTION_2 Öğe, açıklama 2'de kullanılmış.
HEADLINE Öğe, bir başlıkta kullanıldı. Bunu yalnızca reklamda yalnızca bir başlık varsa kullanın. Aksi takdirde HEADLINE_1, HEADLINE_2 veya HEADLINE_3 sıralamalarını kullanın
HEADLINE_IN_PORTRAIT Öğe, dikey resimde başlık olarak kullanıldı.
LONG_HEADLINE Öğe, uzun bir başlıkta kullanılmış (MultiAssetUyumluAd'de kullanılır).
DESCRIPTION Öğe, açıklamada kullanılmış. Bunu yalnızca reklamda yalnızca bir açıklama varsa kullanın. Aksi takdirde, DESCRIPTION_1 veya DESCRIPTION_@ numaralandırmalarını 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ıldı.
MARKETING_IMAGE_IN_PORTRAIT Öğe, dikey resimde pazarlama resmi olarak kullanıldı.
SQUARE_MARKETING_IMAGE Öğe, kare pazarlama resmi olarak kullanıldı.
PORTRAIT_MARKETING_IMAGE Öğe, dikey pazarlama resmi olarak kullanıldı.
CALL_TO_ACTION Öğe, harekete geçirici mesaj olarak kullanılmış.
YOU_TUBE_VIDEO Öğe, YouTube videosu olarak kullanıldı.
CALL Bu öğe bir telefon olarak kullanılıyor.
MOBILE_APP Bu öğe mobil uygulama olarak kullanılıyor.
CALLOUT Bu öğe açıklama metni olarak kullanılır.
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.

AssetGroup

Bir öğe grubudur. AssetGroupAsset, bir öğeyi öğe grubuna bağlamak için kullanılır. AssetGroupSignal, bir öğe grubuyla bir sinyali 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 uzunluk 1, maksimum uzunluk 128 olmalıdır. Bir kampanya altında benzersiz olmalıdır.

finalUrls[]

string

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

finalMobileUrls[]

string

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

status

enum (AssetGroupStatus)

Öğe grubunun durumudur.

path1

string

Metnin, reklamda görüntülenen URL'nin sonuna eklenmiş görünebilecek ilk bölümü.

path2

string

Metnin, reklamda görüntülenen URL'nin sonuna eklenmiş görünebilecek ikinci bölümü. Bu alan yalnızca yol1 ayarlandığında ayarlanabilir.

adStrength

enum (AdStrength)

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

AssetGroupStatus

Bir öğe grubunun olası durumlarıdır.

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

AdStrength

Olası reklam güçlerini listeleyen sıralama.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca döndürülen değer için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
PENDING Reklam gücü şu anda beklemede.
NO_ADS Reklam oluşturulamadı.
POOR Güç zayıf.
AVERAGE Ortalama güç.
GOOD İyi güç.
EXCELLENT Mükemmel güç.

AssetSetAsset

AssetSetAsset, bir öğe ile öğe grubu arasındaki bağlantıdır. AssetSetAsset eklendiğinde bir öğe, öğe grubuna bağlanır.

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

string

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

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

assetSet

string

Bu öğe grubu öğesinin bağlantı verdiği öğe grubu.

asset

string

Bu öğe grubu öğesinin bağlantı verdiği öğe.

status

enum (AssetSetAssetStatus)

Öğe grubu öğesinin durumudur. Salt okunurdur.

AssetSetAssetStatus

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

Sıralamalar
UNSPECIFIED Durum belirtilmedi.
UNKNOWN Alınan değer bu sürümde bilinmiyor. Bu yalnızca yanıt odaklı bir değerdir.
ENABLED Öğe grubu öğesi etkinleştirildi.
REMOVED Öğe grubu öğesi kaldırıldı.

AssetSet

Öğe koleksiyonunu temsil eden bir öğ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

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üşterilerin teklif stratejilerinde bu para birimi, oluşturma sırasında ayarlanabilir ve varsayılan olarak yönetici müşterinin para birimine ayarlanır. Hizmet veren müşteriler için bu alan ayarlanamaz. Reklam yayınlayan bir müşterideki tüm stratejiler, reklam yayınlayan müşterinin para birimini dolaylı olarak kullanır. Her durumda, currentCurrencyCode 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 stratejilerinin farklı bir şekilde adlandırılması gerekir.

Bu dizenin uzunluğu UTF-8 bayt cinsinden (kırpılmış) dahil olmak üzere 1 ile 255 arasında olmalıdır.

effectiveCurrencyCode

string

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

Yönetici müşterilerdeki teklif stratejileri için bu, stratejiyi oluştururken reklamveren tarafından ayarlanan para birimidir. Hizmet veren müşterilere bu kod, müşterinin currencyCode'udur.

Teklif stratejisi metrikleri bu para biriminde raporlanır.

Bu alan salt okunurdur.

campaignCount

string (int64 format)

Bu teklif stratejisine ekli kampanyaların sayısı.

Bu alan salt okunurdur.

nonRemovedCampaignCount

string (int64 format)

Bu teklif stratejisine ekli, kaldırılmayan kampanyaların sayısı.

Bu alan salt okunurdur.

Birleştirme alanı scheme. Teklif düzeni

Yalnızca bir tane ayarlanabilir. scheme şunlardan 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 ve daha düşük göründüğü tıklamalar için düşüren bir teklif stratejisidir.

maximizeConversionValue

object (MaximizeConversionValue)

Bütçenizi harcarken kampanyalarınız için en fazla 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 etmenize yardımcı olacak şekilde ayarlayan bir teklif stratejisidir.

targetImpressionShare

object (TargetImpressionShare)

Seçilen bir gösterim yüzdesine göre otomatik olarak optimizasyon yapan bir teklif stratejisidir.

targetOutrankShare

object (TargetOutrankShare)

Teklifleri, reklamverenin belirli bir rakibini geçmesi gereken açık artırmaların hedef oranına göre ayarlayan bir teklif stratejisidir. Bu alan kullanımdan kaldırılmıştır. Bu alanla yeni bir teklif stratejisi oluşturmak veya bu alana sahip teklif stratejileri bir kampanyaya eklemek başarısız olur. Bu şemanın hâlihazırda doldurulmuş olduğu stratejilerde yapılan değişikliklere izin verilir.

targetRoas

object (TargetRoas)

Reklam harcamalarından elde edilen gelir (ROAS) için belirli bir hedefin ortalamasını alarak geliri en üst düzeye çıkarmanıza yardımcı olan bir teklif stratejisidir.

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 odaklı bir değerdir.

ENABLED Teklif stratejisi etkinleştirilir.
REMOVED Teklif stratejisi kaldırılır.

BiddingStrategyType

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

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca döndürülen değer için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
COMMISSION Komisyon, reklamverenin dönüşüm değerinin belirli bir kısmını ödediği bir otomatik teklif stratejisidir.
ENHANCED_CPC Geliştirilmiş TBM, dönüşümle sonuçlanma olasılığı daha yüksek olan tıklamalar için teklifleri yükseltirken, daha düşük göründüğü tıklamalar için bu teklifleri düşürür.
INVALID Yalnızca döndürülen değer için kullanılır. Bir kampanyanın teklif stratejisine sahip olmadığını belirtir. Bu durum, kampanyanın yayınlanmasını engeller. Örneğin, bir kampanya yönetici teklif stratejisine eklenebilir ve reklam sunma hesabının daha sonra yönetici hesabıyla olan bağlantısı kaldırılır. Bu durumda, kampanya otomatik olarak artık erişilemeyen yönetici teklif stratejisinden çıkarılır ve GEÇERSİZ teklif stratejisi türüne geçirilir.
MANUAL_CPA Reklamverenin, reklamveren tarafından belirtilen işleme göre teklif ayarlamasına olanak tanıyan manuel teklif verme stratejisidir.
MANUAL_CPC Kullanıcının tıklama başına ödeme yaptığı manuel tıklamaya dayalı teklif.
MANUAL_CPM Kullanıcının bin gösterim başına ödeme yaptığı manuel gösterim temelli teklif.
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 dahilinde dönüşüm sayısını otomatik olarak artıran 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 Maks. TBM tekliflerini, google.com'daki birinci sayfada veya birinci sayfada tanıtılan alanlarda bulunan gösterimleri hedefleyecek şekilde ayarlayan Sayfa Bir Tanıtılan teklif şeması. Bu sıralama değerinin desteği sonlandırılmıştır.
PERCENT_CPC TBM Yüzdesi, tekliflerin belirli bir ürün veya hizmet için reklamı yapılan fiyatın çok altında olduğu bir teklif stratejisidir.
TARGET_CPA Hedef EBM, belirlediğiniz hedef edinme başına maliyetle (EBM) olabildiğince çok dönüşüm elde etmenizi sağlamaya yardımcı olacak şekilde tekliflerinizi ayarlayan otomatik teklif stratejisidir.
TARGET_CPM Hedef BGBM, belirlediğiniz hedef bin gösterim başına maliyetle (BGBM) olabildiğince çok gösterim elde etmenizi sağlamaya yardımcı olacak şekilde tekliflerinizi ayarlayan otomatik teklif stratejisidir.
TARGET_IMPRESSION_SHARE Teklifleri, arama ağı reklamlarının belirli bir yüzdesinin ilk sayfanın (veya hedeflenen başka bir konumun) en üstünde (veya hedeflenen diğer bir konum) en üstünde gösterilmesini sağlayacak şekilde ayarlayan otomatik teklif stratejisidir.
TARGET_OUTRANK_SHARE Hedef Geçiş Payı, teklifleri reklamverenin belirli bir rakibi aşması gereken açık artırmaların hedef oranına göre ayarlayan otomatik teklif stratejisidir. Bu enum değerinin desteği sonlandırıldı.
TARGET_ROAS Hedef ROAS, belirli bir hedef Ortalama Harcama Getirisi (ROAS) ortalamasını alırken geliri en üst düzeye çıkarmanıza yardımcı olan otomatik 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 teklif stratejisidir.

EnhancedCpc

Bu türde alan yok.

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

Bu teklif stratejisi kullanımdan kaldırıldı ve artık oluşturulamaz. Eşdeğer işlevler için enhancedCpcEnabled doğru değerine ayarlanmış şekilde ManualCpc'yi kullanın.

MaximizeConversionValue

Bütçenizi harcarken kampanyalarınız için en fazla 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 ayarlanabilecek maksimum teklif sınırı. 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şebilir.

cpcBidFloorMicros

string (int64 format)

Teklif stratejisi tarafından ayarlanabilecek minimum teklif sınırı. 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şebilir.

targetRoas

number

Reklam harcamalarından elde edilen gelir (ROAS) hedefi seçeneği. Ayarlanırsa teklif stratejisi, reklam harcamalarından elde edilen gelir hedefini ortalamasını alırken geliri en üst düzeye çıkarır. Hedef ROAS değeri yüksekse teklif stratejisi bütçenin tamamını harcayamayabilir. Hedef ROAS ayarlanmazsa teklif stratejisi, bütçe dahilinde mümkün olan en yüksek ROAS'a ulaşmayı hedefler.

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 ayarlanabilecek maksimum teklif sınırı. 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şebilir.

cpcBidFloorMicros

string (int64 format)

Teklif stratejisi tarafından ayarlanabilecek minimum teklif sınırı. 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şebilir.

targetCpaMicros

string (int64 format)

İşlem başına maliyet (EBM) hedefi seçeneği. Bu, teklif stratejisinin para biriminin mikro birimleri cinsinden belirtilen dönüşüm işlemi başına harcamak istediğiniz ortalama tutardır. Ayarlanırsa teklif stratejisi, işlem başına maliyet hedefi veya altında mümkün olduğunca fazla dönüşüm elde eder. Hedef EBM ayarlanmazsa teklif stratejisi, bütçe dahilinde mümkün olan en düşük EBM'ye ulaşmayı hedefler.

TargetCpa

Teklifleri, belirlediğiniz hedef edinme başına maliyetle (EBM) mümkün olduğunca fazla dönüşüm elde etmenize yardımcı olacak şekilde ayarlayan 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 bağlı olarak minimum faturalandırılabilir birimden büyük veya bu değere eşit olmalıdır.

cpcBidCeilingMicros

string (int64 format)

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

cpcBidFloorMicros

string (int64 format)

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

TargetImpressionShare

Teklifleri, arama ağı reklamlarının belirli bir yüzdesinin ilk sayfanın (veya hedeflenen başka bir konumun) en üstünde (veya hedeflenen diğer bir konum) en üstünde gösterilmesini sağlayacak şekilde ayarlayan otomatik teklif stratejisidir.

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 yerde gösterilecek reklamların seçilen kısmı (mikrosaniye cinsinden). Örneğin% 1, 10.000'e eşittir.

cpcBidCeilingMicros

string (int64 format)

Otomatik teklif sisteminin belirtmesine izin verilen en yüksek TBM teklifi. Bu, reklamveren tarafından girilen, üst sınırı ayarlayan ve yerel mikrolarda belirtilen zorunlu bir alandır.

TargetImpressionShareLocation

Olası hedefleri açıklayan enum.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca döndürülen değer için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
ANYWHERE_ON_PAGE Web sayfasındaki herhangi bir konum.
TOP_OF_PAGE Üst reklam kutusu.
ABSOLUTE_TOP_OF_PAGE En üstteki reklam kutusunda en üst yuva.

TargetOutrankShare

Teklifleri, reklamverenin belirli bir rakibi aşması gereken açık artırmaların hedef oranına göre ayarlayan otomatik teklif stratejisidir. Bu strateji kullanımdan kaldırılmıştır.

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

string (Int64Value format)

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

TargetRoas

Reklam harcamalarından elde edilen gelir (ROAS) için belirli bir hedefin ortalamasını alırken geliri en üst düzeye çıkarmanıza yardımcı olan bir otomatik teklif stratejisidir.

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

number

Zorunlu. Harcama birimi başına seçilen gelir (dönüşüm verilerine dayalı olarak). Değer 0,01 ile 1000,0 (her ikisi de dahil) arasında olmalıdır.

cpcBidCeilingMicros

string (int64 format)

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

cpcBidFloorMicros

string (int64 format)

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

TargetSpend

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

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

string (int64 format)

Tıklamaların en üst düzeye çıkarılacağı harcama hedefi. Hedef Harcama teklif vereni, bu değerden veya doğal kısıtlama harcama tutarından daha küçük olanı harcamaya çalışır. Belirtilmezse harcama hedefi olarak bütçe kullanılır. Bu alan kullanımdan kaldırılmıştır 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 adresine bakın.

cpcBidCeilingMicros

string (int64 format)

Teklif stratejisi tarafından ayarlanabilecek maksimum teklif sınırı. 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çe kaynak adları şu biçimdedir:

customers/{customerId}/campaignBudgets/{campaign_budget_id}

deliveryMethod

enum (BudgetDeliveryMethod)

Kampanya bütçesinin harcanma oranını belirleyen yayınlanma yöntemi.

Oluşturma işleminde belirtilmezse varsayılan olarak STANDARD kullanılır.

period

enum (BudgetPeriod)

Bütçenin harcanacağı dönem. Belirtilmezse varsayılan olarak DAILY kullanılır.

amountMicros

string (int64 format)

Hesabın yerel para birimindeki bütçe tutarı. Tutar, mikro cinsinden belirtilir. Burada, bir milyon, bir para birimine eşittir. Aylık harcama, bu tutarın 30,4 katı ile sınırlıdır.

BudgetDeliveryMethod

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

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca döndürülen değer için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
STANDARD Bütçe sunucusu, sunumu tüm dönem boyunca eşit şekilde kısıtlar.
ACCELERATED Bütçe sunucusu yayını 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öndürülen değer 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, ömür 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)
  },
  "labels": [
    string
  ],
  "biddingStrategyType": enum (BiddingStrategyType),
  "accessibleBiddingStrategy": string,
  "frequencyCaps": [
    {
      object (FrequencyCapEntry)
    }
  ],
  "selectiveOptimization": {
    object (SelectiveOptimization)
  },
  "optimizationGoalSetting": {
    object (OptimizationGoalSetting)
  },
  "trackingSetting": {
    object (TrackingSetting)
  },
  "engineId": string,
  "excludedParentAssetFieldTypes": [
    enum (AssetFieldType)
  ],
  "createTime": string,
  "creationTime": string,
  "lastModifiedTime": string,
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "campaignBudget": string,
  "startDate": string,
  "endDate": string,
  "finalUrlSuffix": string,
  "urlExpansionOptOut": boolean,

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

string

Kampanyanın kaynak adı. Kampanya kaynak adları şu biçimdedir:

customers/{customerId}/campaigns/{campaign_id}

status

enum (CampaignStatus)

Kampanyanın durumu.

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

servingStatus

enum (CampaignServingStatus)

Kampanyanın reklam sunma durumu.

biddingStrategySystemStatus

enum (BiddingStrategySystemStatus)

Kampanyanın teklif stratejisinin sistem durumu.

adServingOptimizationStatus

enum (AdServingOptimizationStatus)

Kampanyanın reklam sunma optimizasyon durumu.

advertisingChannelType

enum (AdvertisingChannelType)

Kampanyadaki reklamlar için birincil yayın hedefi. Hedefleme seçenekleri, networkSettings içinde hassaslaştırılabilir.

Yeni kampanya oluştururken bu alan zorunludur ve boş bırakılmamalıdır.

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

advertisingChannelSubType

enum (AdvertisingChannelSubType)

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

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

urlCustomParameters[]

object (CustomParameter)

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

realTimeBiddingSetting

object (RealTimeBiddingSetting)

Yalnızca Ad Exchange ağını hedefleyen kampanyalarda kullanılabilen Gerçek Zamanlı Teklif Verme için ayarlar.

networkSettings

object (NetworkSettings)

Kampanyanın ağ ayarları.

dynamicSearchAdsSetting

object (DynamicSearchAdsSetting)

Dinamik Arama Ağı Reklamlarını (DSA) kontrol etme ayarı.

shoppingSetting

object (ShoppingSetting)

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

geoTargetTypeSetting

object (GeoTargetTypeSetting)

Reklamlar için coğrafi hedefleme ayarı.

labels[]

string

Bu kampanyaya ekli etiketlerin kaynak adları.

biddingStrategyType

enum (BiddingStrategyType)

Teklif stratejisinin türü.

Standart teklif stratejisi oluşturmak için teklif şeması veya portföy teklifi stratejisi oluşturmak için biddingStrategy alanı ayarlanarak teklif stratejisi oluşturulabilir.

Bu alan salt okunurdur.

accessibleBiddingStrategy

string

AccessibleTeklif Stratejisinin kaynak adı. Bu, "teklif stratejisi" tarafından tanımlanan ekli portföy teklifi stratejisinin kısıtlanmamış özelliklerinin salt okunur görünümüdür. Kampanyada portföy stratejisi kullanılmıyorsa boştur. Kısıtlanmamış strateji özellikleri, stratejinin paylaşıldığı tüm müşteriler tarafından kullanılabilir ve AccessibleBiddingStrategy kaynağından okunur. Buna karşılık, kısıtlanmış özellikler yalnızca stratejinin sahibi olan müşteri ve onların yöneticileri tarafından kullanılabilir. Kısıtlanmış özellikler yalnızca BiddingStrategy kaynağından okunabilir.

frequencyCaps[]

object (FrequencyCapEntry)

Her bir kullanıcının bu kampanyadaki reklamları görme sıklığını sınırlayan bir liste.

selectiveOptimization

object (SelectiveOptimization)

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

optimizationGoalSetting

object (OptimizationGoalSetting)

Bir dizi optimizasyon hedefi türünü içeren bu kampanya için optimizasyon hedefi ayarı.

trackingSetting

object (TrackingSetting)

İzleme bilgilerine ilişkin kampanya düzeyindeki ayarlar.

engineId

string

Kampanyanın harici motor hesabındaki kimliği. Bu alan, yalnızca Google Ads harici hesaplar (örneğin, Yahoo Japan, Microsoft, Baidu vb.) içindir. Google Ads varlığı için bunun yerine "campaign.id" değerini 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 damgası. Zaman damgası, müşterinin saat dilimindedir ve "yyyy-AA-gg SS:dd:ss " biçimindedir. createTime, v1'de kullanımdan kaldırılacaktır. Bunun yerine createTime'ı kullanın.

creationTime

string

Bu kampanyanın oluşturulduğu zaman damgası. Zaman damgası müşterinin saat dilimindedir 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 dilimindedir ve "yyyy-AA-gg SS:dd:ss.ssssss" biçimindedir.

id

string (int64 format)

Kampanyanın kimliği.

name

string

Kampanyanın adı.

Yeni kampanya oluştururken bu alan zorunludur ve 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şturmaya yönelik URL şablonu.

campaignBudget

string

Kampanyanın bütçesi.

startDate

string

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

endDate

string

Kampanyanın, müşterinin saat diliminde YYYY-AA-GG biçiminde sunulan son günü. Oluşturma işleminde varsayılan olarak "2037-12-30" değeri ayarlanır. Bu, kampanyanın süresiz olarak yayınlanacağı anlamına gelir. Mevcut bir kampanyayı süresiz olarak yayınlanacak şekilde ayarlamak için bu alanı 30.12.2037 olarak ayarlayın.

finalUrlSuffix

string

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

urlExpansionOptOut

boolean

Daha iyi hedeflenmiş URL'ler için URL genişletmesinin devre dışı bırakılmasını temsil 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 (false) alanın tamamı hedeflenir. Bu alan yalnızca varsayılan değer "false" olan Maksimum Performans kampanyaları için ayarlanabilir.

Birleştirme alanı campaign_bidding_strategy. Kampanyanın teklif stratejisi.

Kampanyaya yerleştirilmiş bir portföy (Teklif Stratejisi hizmeti aracılığıyla oluşturulmuş) veya standart olmalıdır. campaign_bidding_strategy şunlardan yalnızca biri olabilir:

biddingStrategy

string

Kampanya tarafından kullanılan portföy teklifi stratejisi.

manualCpa

object (ManualCpa)

Standart Manuel EBM teklif stratejisi Reklamverenin, reklamveren tarafından belirtilen işleme göre teklif ayarlamasına olanak tanıyan manuel teklif verme stratejisidir. Yalnızca Yerel Hizmetler kampanyaları için desteklenir.

manualCpc

object (ManualCpc)

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

manualCpm

object (ManualCpm)

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

maximizeConversions

object (MaximizeConversions)

Bütçenizi harcarken dönüşüm sayısını otomatik olarak artıran 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 ayarlayan standart dönüşüm değerini artırma teklif stratejisidir.

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 ayarlayan Standart Hedef EBM teklif stratejisidir.

targetImpressionShare

object (TargetImpressionShare)

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

targetRoas

object (TargetRoas)

Reklam harcamalarından elde edilen gelir (ROAS) için belirli bir hedefin ortalamasını alırken geliri otomatik olarak artıran standart Hedef ROAS teklif stratejisi.

targetSpend

object (TargetSpend)

Tekliflerinizi, bütçeniz dahilinde olabildiğince çok sayıda tıklama almanıza yardımcı olacak şekilde otomatik olarak ayarlayan Standart Hedef Harcama teklif stratejisi.

percentCpc

object (PercentCpc)

Tekliflerin, belirli bir ürün veya hizmet için reklamı yapılan fiyatın çok altında olduğu Standart TBM teklifi stratejisi

targetCpm

object (TargetCpm)

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

CampaignStatus

Bir kampanyanın olası durumları.

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

CampaignServingStatus

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

Sıralamalar
UNSPECIFIED Değer belirtilmedi.
UNKNOWN

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

Bu yalnızca yanıt odaklı bir değerdir.

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

BiddingStrategySystemStatus

Bir Teklif Stratejisinin olası sistem durumları.

Sıralamalar
UNSPECIFIED Beklenmedik bir hata oluştuğunu (ör. teklif stratejisi türü bulunamadığı veya durum bilgisinin bulunamadığı) gösterir.
UNKNOWN Yalnızca döndürülen değer 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 kısa süre önce yeniden etkinleştirildiği için öğreniyor.
LEARNING_SETTING_CHANGE Teklif stratejisi, yakın zamanda yapılan bir 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 stratejisi, kendisine ekli kampanya, reklam grubu veya anahtar kelime sayısındaki son değişiklik nedeniyle öğ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ı olan 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 üst limiti ile sınırlı.
LIMITED_BY_CPC_BID_FLOOR Teklif stratejisi, teklif tabanıyla sınırlı.
LIMITED_BY_DATA Geçtiğimiz haftalarda yeterli dönüşüm trafiği olmadığı için teklif stratejisi sınırlıdır.
LIMITED_BY_BUDGET Bu teklif stratejisindeki anahtar kelimelerin önemli bir kısmı bütçeyle sınırlı.
LIMITED_BY_LOW_PRIORITY_SPEND Teklif stratejisi, harcamasının önceliği azaltıldığı için hedef harcamasına ulaşamıyor.
LIMITED_BY_LOW_QUALITY Bu teklif stratejisindeki anahtar kelimelerin önemli bir kısmı düşük bir Kalite Puanına sahip.
LIMITED_BY_INVENTORY Teklif stratejisi, dar hedefleme nedeniyle bütçesinin tamamını harcayamıyor.
MISCONFIGURED_ZERO_ELIGIBILITY Akıllı Alışveriş Kampanyası 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üşterinin bu stratejiye göre raporlanabilecek dönüşüm türleri yoktur.
MISCONFIGURED_CONVERSION_SETTINGS Teklif stratejisi, dönüşüm raporlarına bağlıdır ve müşterinin dönüşüm ayarları hatalı yapılandırılmıştır.
MISCONFIGURED_SHARED_BUDGET Teklif stratejisinin dışında, stratejiye dahil edilen kampanyalarla bütçe paylaşan kampanyalar var.
MISCONFIGURED_STRATEGY_TYPE Kampanyanın strateji türü geçersiz ve yayınlanmıyor.
PAUSED Teklif stratejisi etkin değildir. Teklif stratejisine bağlı etkin kampanya, reklam grubu veya anahtar kelime yok. Teklif stratejisine bağlı etkin bütçe olmaması da mümkündür.
UNAVAILABLE Bu teklif stratejisi şu anda durum raporlamayı 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 LIMITED_* sistem durumu vardı.
MULTIPLE_MISCONFIGURED Söz konusu dönemde bu teklif stratejisi için birden fazla MISCONFIGURED_* sistem durumu vardı.
MULTIPLE Söz konusu dönemde bu teklif stratejisi için birden fazla sistem durumu mevcuttu.

AdServingOptimizationStatus

Olası yayınlama durumlarını açıklayan enum.

Sıralamalar
UNSPECIFIED Değer belirtilmedi.
UNKNOWN

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

Bu yalnızca yanıt odaklı bir değerdir.

OPTIMIZE Reklam sunumu, kampanyanın TO'suna göre optimize edilir.
CONVERSION_OPTIMIZE Reklam sunumu, kampanyanın TO * dönüşümüne göre optimize edilir. Kampanya, Dönüşüm Optimize Edici teklif stratejisinde yer almıyorsa varsayılan olarak OPTİMİZE EDİLMİŞ olur.
ROTATE Reklamlar 90 gün boyunca eşit sıklıkta dönüşümlü olarak yayınlanır, daha sonra tıklamalar için optimize edilir.
ROTATE_INDEFINITELY Düşük performans gösteren reklamları, yüksek performans sergileyen reklamlarla daha dengeli bir şekilde gösterin ve optimizasyon yapmayın.
UNAVAILABLE Reklam sunma optimizasyon durumu kullanılamıyor.

AdvertisingChannelType

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

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca döndürülen değer için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
SEARCH Arama Ağı'nı seçin. Gruplandırılmış görüntülü reklamlar 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 reklamları kampanyaları.
VIDEO Video kampanyaları.
MULTI_CHANNEL Birden çok 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 hizmet kampanyaları.
DISCOVERY Discovery kampanyaları.
TRAVEL Seyahat kampanyaları.

AdvertisingChannelSubType

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

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca döndürülen değer 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ü Reklam Ağı 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 TrueView for Action kampanyaları.
VIDEO_NON_SKIPPABLE Atlanamayan video reklamlar içeren video kampanyaları
APP_CAMPAIGN Android veya iOS uygulamanızı Arama Ağı, Play, YouTube ve Google Görüntülü Reklam Ağı dahil olmak üzere Google'ın en önemli mülklerinde kolayca tanıtmanıza olanak tanıyan Uygulama Kampanyası.
APP_CAMPAIGN_FOR_ENGAGEMENT Arama Ağı, YouTube ve Google Görüntülü Reklam Ağı dahil olmak üzere Google'ın en önemli mülklerinden birkaçında uygulamayla yeniden etkileşimi artırmaya odaklanan etkileşime yönelik Uygulama Kampanyası.
LOCAL_CAMPAIGN Yerel reklamcılığa özel kampanyalar.
SHOPPING_COMPARISON_LISTING_ADS Alışveriş Karşılaştırma Girişi kampanyaları.
SMART_CAMPAIGN Standart Akıllı kampanyalar.
VIDEO_SEQUENCE Video reklamlar dizisi içeren video kampanyaları.
APP_CAMPAIGN_FOR_PRE_REGISTRATION Google Play, YouTube ve Görüntülü Reklam Ağı'nda birden fazla reklam kanalını hedefleyen, mobil uygulama ön kaydı reklamcılığı için uzmanlaşmış ön kayıt için Uygulama Kampanyası.
VIDEO_REACH_TARGET_FREQUENCY Hedef Sıklık teklif stratejisiyle video erişim kampanyası
TRAVEL_ACTIVITIES Seyahat etkinlikleri kampanyaları.

CustomParameter

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

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

string

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

value

string

Değiştirilecek değer.

RealTimeBiddingSetting

Yalnızca Ad Exchange ağını hedefleyen kampanyalarda kullanılabilen Gerçek Zamanlı Teklif Verme için ayarlar.

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

boolean

Kampanyada gerçek zamanlı teklif verme seçeneğinin etkin olup olmadığı.

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 değerinin de true olması gerekir).

targetContentNetwork

boolean

Reklamların Google Görüntülü Reklam Ağı'ndaki belirli yerleşimlerde sunulup sunulmayacağı. Yerleşimler, Yerleşim ölçütü kullanılarak belirtilir.

targetPartnerSearchNetwork

boolean

Reklamların Google İş Ortağı Ağı'nda sunulup sunulmayacağı. Bu özellikten yalnızca belirli Google iş ortağı hesapları yararlanabilir.

DynamicSearchAdsSetting

Dinamik Arama Ağı Reklamlarını (DSA) kontrol etme ayarı.

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

string

Zorunlu. Bu ayarın temsil ettiği İnternet alan adı; örneğin, "google.com" veya "www.google.com".

languageCode

string

Zorunlu. Alanın dilini belirten dil kodudur (ör. "tr").

useSuppliedUrlsOnly

boolean

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

ShoppingSetting

Alışveriş kampanyaları ayarı. Kampanyanın reklamını yapabileceği ürün evrenini ve bu kampanyanın diğer Alışveriş kampanyalarıyla nasıl etkileşim kurduğ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. feedLabel veya salesCountry özelliklerinden yalnızca biri ayarlanabilir. SalesCountry yerine kullanılması durumunda feedLabel alanı aynı biçimdeki ü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ğini belirler.

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ında değiştirilemez.

salesCountry

string

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

campaignPriority

integer

Kampanyanın önceliği. Sayısal olarak daha yüksek önceliğe sahip olan kampanyalar, düşük önceliğe sahip kampanyalara göre önceliklidir. Bu alan, 0 ile 2 arasında (0 ve 2 dahil) değerlere sahip Alışveriş kampanyaları için gereklidir. 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 ayarların bir 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 Değer, bu sürümde bilinmiyor.
PRESENCE_OR_INTEREST Kullanıcı, reklamverenin hedeflediği konumlarda olduğunda veya bu yerlere ilgi gösterdiğinde bir reklamın tetiklendiğini belirtir.
SEARCH_INTEREST Kullanıcı reklamverenin hedeflediği konumları aradığında bir reklamın tetikleneceğini belirtir. Bu özellik yalnızca Arama Ağı ve standart Alışveriş kampanyalarında kullanılabilir.
PRESENCE Kullanıcı, reklamverenin hedeflediği konumlarda bulunan veya bu yerlere düzenli olarak gittiğinde bir reklamın tetikleneceğini belirtir.

NegativeGeoTargetType

Olası negatif coğrafi hedef türleri.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Değer, bu sürümde bilinmiyor.
PRESENCE_OR_INTEREST Bir kullanıcının, reklamverenin hariç tutulan konumlarında olması veya bu konumlara ilgi göstermesi durumunda reklamı göremeyeceğini belirtir.
PRESENCE Reklamverenin hariç tutulduğu konumlarda bulunan kullanıcıların, reklamı göremeyeceklerini belirtir.

FrequencyCapEntry

Bu türde alan yok.

Bir reklamın (veya bir grup reklamın) belirli bir dönem boyunca bir kullanıcıya maksimum kaç kez gösterilebileceğini belirten bir kuraldır.

SelectiveOptimization

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

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

string

Bu kampanyanın optimize edilmesi için seçili dönüşüm işlemleri grubu.

OptimizationGoalSetting

Bir dizi optimizasyon hedefi türünü içeren bu kampanya için optimizasyon hedefi ayarı.

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öndürülen değer olarak kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
CALL_CLICKS Telefon araması tıklamaları için optimize edin. Telefon araması tıklama dönüşümü sayısı, kullanıcıların reklamı görüntüledikten sonra mağazayla iletişime geçmek için "Arama"yı seçme sayısıdır.
DRIVING_DIRECTIONS Arabayla yol tarifleri için optimize edin. Arabayla 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 optimize et Ön kayıt dönüşümleri, uygulama yayınlandığında bildirim alacak ön kayıt kayıtlarının sayısıdır.

TrackingSetting

İzleme bilgilerine ilişkin kampanya düzeyindeki ayarlar.

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

string

Dinamik izleme için kullanılan URL.

ManualCpa

Bu türde alan yok.

Reklamverenin, reklamveren tarafından belirtilen işleme göre teklif ayarlamasına olanak tanıyan manuel teklif verme stratejisidir.

ManualCpc

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

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

boolean

Tekliflerin dönüşüm optimize edici verilerine göre geliştirilip geliştirilmeyeceği.

ManualCpm

Bu türde alan yok.

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

PercentCpc

Tekliflerin, belirli bir ürün veya hizmet için reklamı yapılan fiyatın bir kısmı kadar olduğu bir teklif stratejisi.

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

string (int64 format)

Teklif stratejisi tarafından ayarlanabilecek maksimum teklif sınırı. Bu, reklamveren tarafından girilen ve yerel mikrolarda belirtilen isteğe bağlı bir alandır. Not: Sıfır değeri, teklif_tavanı özelliğinin tanımlanmamış olması gibi yorumlanır.

enhancedCpcEnabled

boolean

Her açık artırmanın teklifini dönüşüm olasılığına bağlı olarak artırır veya azaltır. Ayrı teklifler cpcBidCeilingMicros değerini aşabilir, ancak bir kampanyanın ortalama teklif tutarı aşamaz.

TargetCpm

Bu türde alan yok.

Hedef BGBM (bin gösterim başına maliyet), tekliflerinizi, belirlediğiniz hedef BGBM'ye göre performansı optimize edecek şekilde ayarlayan 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ı. KampanyaÖğesi 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, kampanya ile öğe grubu arasındaki bağlantıdır. CampaignAssetSet eklendiğinde bir öğe grubu bir kampanyaya bağlanır.

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

string

Kampanya öğesi grubunun kaynak adı. Öğe grubu öğe kaynağı 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 öğesi grubu öğesinin durumu. Salt okunurdur.

CampaignAudienceView

Kampanya kitle görünümü. Görüntülü Reklam Ağı ve YouTube Ağı reklamlarına yönelik ilgi alanları ve yeniden pazarlama listelerinin yanı sıra 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 eklenmiş 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 ölçütü kaynak adları şu biçimdedir:

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

displayName

string

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

Bu alan, değişiklikler 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 dilimindedir ve "yyyy-AA-gg SS:dd:ss.ssssss" biçimindedir.

criterionId

string (int64 format)

Ölçüt 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 şu aralıkta olmalıdır: 0,1 - 10,0. Hedeflenebilir ölçüt türlerinin çoğu değiştiricileri destekler. Bir cihaz türünü devre dışı bırakmak için 0 değerini kullanın.

negative

boolean

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

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

Tam olarak bir tane ayarlanmalıdır. criterion şunlardan 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

Bir CampaignCriterion öğesinin olası durumları.

Sıralamalar
UNSPECIFIED Değer belirtilmedi.
UNKNOWN

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

Bu yalnızca yanıt odaklı bir değerdir.

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

LanguageInfo

Bir dil ölçütü.

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

string

Dil sabit kaynak adı.

LocationGroupInfo

Feed aracılığıyla belirtilen konumların yer aldığı bir listenin çevresindeki yarıçap.

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

string

Feed içindeki coğrafi alanın kapsamını kısıtlayan coğrafi hedef sabit değerleri. Şu anda yalnızca bir coğrafi hedef sabitine izin verilmektedir.

radiusUnits

enum (LocationGroupRadiusUnits)

Yarıçap birimi. Coğrafi hedef sabitleri için mil ve metre değerleri desteklenir. Feed öğesi grupları için milli mil ve metre değerleri desteklenir. Bu gereklidir ve CREATE işlemlerinde ayarlanmalıdır.

feedItemSets[]

string

FeedItems'inin hedeflendiği FeedItemSet'ler. Birden çok kimlik belirtilirse en az bir grupta 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 yerlerin çevresindeki yarıçapı belirten birim cinsinden mesafe. Bu gereklidir 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öndürülen değer için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
METERS Metre
MILES Mil
MILLI_MILES Mili mil

CampaignLabel

Bir kampanya ile etiket arasındaki ilişkiyi temsil eder.

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

string

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

campaign

string

Etiketin eklendiği kampanya.

label

string

Kampanyaya atanan etiket.

CartDataSalesView

Alışveriş sepeti verileri 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şturmak için farklı segment özelliklerini (ör. ayrıntılı demografi ve yakın ilgi alanları) birleştirmenize olanak tanıyan 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çimdedir:

customers/{customerId}/audiences/{audience_id}

id

string (int64 format)

Kitlenin kimliği.

name

string

Zorunlu. Kitlenin adı. Tüm kitleler için benzersiz olmalıdır. Minimum uzunluk 1, maksimum uzunluk 255 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

Floodlight etkinliğinin oluşturulmasının ISO 8601'de biçimlendirilmiş zaman damgası.

status

enum (ConversionActionStatus)

Dönüşüm etkinliği tahakkuku 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 raporlanan dönüşüm 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ı.

Yeni dönüşüm işlemleri oluştururken bu alan, doldurulması zorunlu bir alandır ve 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 hiçbir kampanyada teklif verilemez. Ancak, özel dönüşüm hedefleri primaryForGoal'ı dikkate almaz. Bu nedenle, bir kampanyanın primaryForGoal = yanlış dönüşüm işlemi ile yapılandırılmış bir özel dönüşüm hedefi varsa bu dönüşüm işlemi teklif verilebilir durumda kalır. Varsayılan olarak, ayarlanmazsa primaryForGoal doğru olacaktır. V9 'da primaryForGoal yalnızca bir "güncelleme" işlemiyle oluşturulduktan sonra isteğe bağlı olarak bildirilmediğinden yanlış değerine ayarlanabilir.

ownerCustomer

string

Dönüşüm işlemi sahibi müşterinin kaynak adı. Bu sistem tanımlı 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

Bir uygulama dönüşüm işleminin uygulama kimliği.

ConversionActionStatus

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

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca döndürülen değer için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
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

Olası dönüşüm işlemi türleri.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca döndürülen değer için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
AD_CALL Kullanıcılar bir reklamın telefon uzantısını tıkladığında gerçekleşen dönüşümler.
CLICK_TO_CALL Mobil cihaz kullanıcısı bir telefon numarasını tıkladığında gerçekleşen dönüşümler.
GOOGLE_PLAY_DOWNLOAD Bir kullanıcı Google Play Store'dan mobil uygulama indirdiğinde oluşan dönüşümler.
GOOGLE_PLAY_IN_APP_PURCHASE Bir kullanıcı, Android faturalandırması üzerinden bir uygulamada satın alma işlemi gerçekleştirdiğinde 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şkilendirilen tıklamalarla yüklenen dönüşümler.
WEBPAGE Bir web sayfasında gerçekleşen dönüşümler.
WEBSITE_CALL Kullanıcılar bir reklamverenin web sitesinden dinamik olarak oluşturulmuş bir telefon numarasını aradığında gerçekleşen dönüşümlerdir.
STORE_SALES_DIRECT_UPLOAD Birinci taraf veya üçüncü taraf satıcı verisi yüklemelerine dayalı Mağaza Satışı dönüşümü. Mağaza satışları doğrudan yükleme türlerini yalnızca izin verilenler listesindeki müşteriler kullanabilir.
STORE_SALES Birinci taraf veya üçüncü taraf satıcı verisi yüklemelerine ve/veya ödeme ağlarındaki kartlar kullanılarak yapılan mağaza içi satın alma işlemlerine dayalı Mağaza Satışı dönüşümü. Mağaza satışı türlerini yalnızca izin verilenler listesindeki müşteriler kullanabilir. Salt okunur.
FIREBASE_ANDROID_FIRST_OPEN Android uygulaması ilk açılış dönüşümlerinin Firebase üzerinden izlenmesi.
FIREBASE_ANDROID_IN_APP_PURCHASE Android uygulamasının uygulama içi satın alma dönüşümleri Firebase üzerinden izlendi.
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 iOS uygulamasının uygulama içi satın alma dönüşümleri Firebase üzerinden izleniyor.
FIREBASE_IOS_CUSTOM Firebase üzerinden izlenen iOS uygulaması özel dönüşümleri.
THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN Üçüncü Taraf Uygulama Analizi ile izlenen Android uygulaması ilk açılış dönüşümleri.
THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE Üçüncü Taraf Uygulama Analizi ile izlenen Android uygulaması uygulama içi satın alma dönüşümleri.
THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM Üçüncü Taraf Uygulama Analizi ile izlenen Android uygulaması özel dönüşümleri.
THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN Üçüncü Taraf Uygulama Analizi ile izlenen iOS uygulaması ilk açılış dönüşümleri.
THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE iOS uygulamasının uygulama içi satın alma dönüşümleri Üçüncü Taraf Uygulama Analizi ile izleniyor.
THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM Üçüncü Taraf Uygulama Analizi ile izlenen iOS uygulaması özel dönüşümleri.
ANDROID_APP_PRE_REGISTRATION Kullanıcı 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üre göre izlenmeyen tüm Google Play indirmelerini izleyen dönüşümler. Salt okunur.
FLOODLIGHT_ACTION Kullanıcıların, 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 yakalayabilirsiniz. Salt okunur.
GOOGLE_HOSTED Bir reklamla etkileşimde bulunduktan sonra Google'ın ürün ve hizmetlerine ait yerel işlemleri izleyen dönüşümler. Salt okunur.
LEAD_FORM_SUBMIT Kullanıcılar potansiyel müşteri formu gönderdiğinde raporlanan dönüşümler. Salt okunur.
SALESFORCE Salesforce'tan gelen dönüşümler. Salt okunur.
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 kurulumu olmadan 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'da bir arama öğesini tıklar. Yalnızca akıllı kampanya. Salt okunur.
SMART_CAMPAIGN_MAP_DIRECTIONS Kullanıcı, Google Haritalar'da bir işletme konumu için yol tarifi istiyor. Yalnızca akıllı kampanya. Salt okunur.
SMART_CAMPAIGN_TRACKED_CALLS Akıllı kampanya özel ölçütleri kullanılarak telefon araması izleme kurulumuyla Akıllı kampanya Reklamlarında gerçekleşen telefon araması dönüşümleri. Salt okunur.
STORE_VISITS Kullanıcılar reklamverenin perakende mağazasını ziyaret ettiğinde gerçekleşen dönüşümlerdir. Salt okunur.
WEBPAGE_CODELESS Ayrı ayrı kodlanmış etkinlik snippet'leri kullanmayan web sitesi etkinliklerinden (form gönderimleri veya sayfa yüklemeleri gibi) 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öndürülen değer için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
DEFAULT Varsayılan kategori.
PAGE_VIEW Sayfayı ziyaret eden kullanıcı.
PURCHASE Satın alma, satış veya "sipariş verildi" etkinliği.
SIGNUP Kullanıcı kaydını yapma işlemi.
LEAD Olası satış yaratma işlemi.
DOWNLOAD Yazılım indirme işlemi (uygulama için olduğu gibi).
ADD_TO_CART Bir reklamveren sitesinde alışveriş sepetine veya çantasına ürün eklenmesi.
BEGIN_CHECKOUT Bir kullanıcının reklamveren sitesinde ödeme akışına girmesidir.
SUBSCRIBE_PAID Bir ürün veya hizmet için ücretli aboneliğin başlangıcı.
PHONE_CALL_LEAD Bir reklamverenin sunduğu ürün veya hizmetlere ilgi göstermek için yapılan çağrı.
IMPORTED_LEAD Harici bir kaynaktan Google Ads'e aktarılan bir potansiyel müşteri dönüşümü.
SUBMIT_LEAD_FORM Reklamverenin sitesinde işletmeyle ilgilendiğini belirten bir form gönderimi.
BOOK_APPOINTMENT Bir reklamverenin işletmesinden randevu alınması.
REQUEST_QUOTE Fiyat teklifi veya fiyat tahmini isteği.
GET_DIRECTIONS Bir reklamverenin işletmesini ziyaret etmek amacıyla yapılan arama.
OUTBOUND_CLICK Bir reklamverenin iş ortağı sitesine yapılan tıklama.
CONTACT Bir reklamverene yönelik arama, SMS, e-posta, sohbet veya başka bir iletişim türü.
ENGAGEMENT Sitede geçirilen uzun süre veya Google Analytics (GA) Akıllı Hedefi gibi bir web sitesi etkileşim etkinliği. GA, Firebase ve GA Altın hedefleri içe aktarma işlemlerinde kullanılmak üzere tasarlanmıştır.
STORE_VISIT Fiziksel mağaza konumuna yapılan ziyaret.
STORE_SALE Fiziksel mağazada yapılan satış.
QUALIFIED_LEAD Harici bir kaynaktan Google Ads'e aktarılan ve reklamveren (pazarlama/satış ekibi) tarafından daha da nitelikli hale getirilmiş bir potansiyel müşteri dönüşümüdür. Potansiyel müşteriden satışa giden yolda, reklamverenler potansiyel müşteriler elde eder ve ardından tüketiciye ulaşarak bu potansiyel müşteriyle ilgili işlem yapar. Tüketici, ürünle ilgileniyorsa ve nihayetinde ürününü satın alacaksa reklamveren, bu tür potansiyel müşterileri "uygun potansiyel müşteriler" olarak işaretler.
CONVERTED_LEAD Harici bir kaynaktan Google Ads'e aktarılan ve olası satış yaratma reklamvereninin tanımladığı belirli bir aşamanın daha da tamamlandığı 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 kodunun yerine varsayılan değer 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üşüme ilişkin kredinin, potansiyel olarak önceki birçok etkileşime nasıl dağıtılacağını açıklayan ilişkilendirme modeli.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca döndürülen değer için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
EXTERNAL Harici ilişkilendirme kullanılıyor.
GOOGLE_ADS_LAST_CLICK Bir dönüşüme ilişkin tüm krediyi son tıklamasıyla ilişkilendirir.
GOOGLE_SEARCH_ATTRIBUTION_FIRST_CLICK Google Arama ilişkilendirmesini kullanarak bir dönüşüme ilişkin tüm krediyi ilk tıklamasıyla ilişkilendirir.
GOOGLE_SEARCH_ATTRIBUTION_LINEAR Google Arama ilişkilendirmesi kullanarak dönüşüme ilişkin krediyi tüm tıklamalarında eşit olarak ilişkilendirir.
GOOGLE_SEARCH_ATTRIBUTION_TIME_DECAY Google Arama ilişkilendirmesi (yarı ömrü 1 haftadır) kullanarak bir dönüşüme katlanarak daha fazla krediyi daha yeni tıklamalarına ilişkilendirir.
GOOGLE_SEARCH_ATTRIBUTION_POSITION_BASED Dönüşüm kredisinin% 40'ını ilk ve son tıklamalarına atar. Kalan% 20, diğer tüm tıklamalar arasında eşit olarak dağıtılır. Bu özellik, Google Arama ilişkilendirmesi kullanır.
GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN Kredinin tıklamalar arasında uygun dağıtımını belirlemek için Google Arama ilişkilendirmesi kullanılarak makine öğreniminden yararlanan esnek model.

DataDrivenModelStatus

Veriye dayalı model durumlarını sıralar.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca döndürülen değer için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
AVAILABLE Veriye dayalı model kullanılabilir.
STALE Veriye dayalı model eski. En az 7 gündür güncellenmedi. Bu bilgiler hâlâ kullanılıyor, ancak 30 gün boyunca güncellenmezse süresi dolacak.
EXPIRED Veriye dayalı modelin süresi doldu. En az 30 gündür güncellenmediği için kullanılamaz. Bunun en yaygın nedeni, son 30 günlük süre içinde gerekli sayıda etkinlik gerçekleşmemesidir.
NEVER_GENERATED Veriye dayalı model hiç oluşturulmadı. Bunun en yaygın nedeni, herhangi bir 30 günlük dönemde gerekli sayıda etkinlik gerçekleşmemesidir.

FloodlightSettings

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

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

string

Dönüşümleri raporlarken bir Floodlight etkinlik grubunu tanımlamak için kullanılan dize.

activityTag

string

Dönüşümleri raporlarken 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 adresinden "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şken kaynak adları şu biçimdedir:

customers/{customerId}/conversionCustomVariables/{conversion_custom_variable_id}

id

string (int64 format)

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

name

string

Zorunlu. Dönüşüm özelleştirilebilen değişkeninin adı. Ad benzersiz olmalıdır. Maksimum ad 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 "u" karakterinin ardından 100'e ormequal'den küçük bir sayı gelmelidir. Örneğin: "u4".

status

enum (ConversionCustomVariableStatus)

Dönüşüm etkinliği tahakkuku 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şkenlerine ilişkin 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şkenlerinin olası durumları.

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

Dönüşüm özelleştirilebilen değişkeni etkinleştirilmeyi bekliyor ve ETKİN olarak ayarlanana kadar istatistik birikmeyecek.

Bu durum, CREATE ve UPDATE isteklerinde kullanılamaz.

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

ConversionCustomVariableFamily

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

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

ConversionCustomVariableCardinality

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

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca döndürülen değer için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
BELOW_ALL_LIMITS Dönüşüm özelleştirilebilen değişkeninin kardinalitesi tüm sınırların altında. Değişken segmentasyon için kullanılabilir ve değişken etkinse yeni değerler için istatistikler toplanabilir.
EXCEEDS_SEGMENTATION_LIMIT_BUT_NOT_STATS_LIMIT Dönüşüm özelleştirilebilen değişkeni, segmentasyon sınırını aşan ancak istatistik sınırını aşmayan kardinaliteye sahip. 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 hem de istatistik sınırlarını aştı. Segmentasyon devre dışı bırakılır ve etkin değişkenlere ilişkin istatistikler yalnızca mevcut değerler, değişkenin kardinalitesini daha fazla artırmıyorsa biriktirilebilir.

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öndürülen değer için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
DIMENSION Boyut Floodlight değişken türü.
METRIC Metrik Floodlight değişken 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öndürülen değer için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
NUMBER "Sayı" türündeki bir Floodlight değişkenini temsil eder. Bu değişken, DIMENSION veya METRIC türlerindeki Floodlight değişkenlerine atanabilir.
STRING "Dize" türündeki bir Floodlight değişkenini temsil eder. Bu değişken, DIMENSION türündeki Floodlight değişkenlerine atanabilir.

Müşteri

Bir 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,
  "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 kaynakları şu biçimdedir:

customers/{customerId}

conversionTrackingSetting

object (ConversionTrackingSetting)

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, Arama Motoru İzleme vb.)

doubleClickCampaignManagerSetting

object (DoubleClickCampaignManagerSetting)

Yönetici müşteri 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 son değiştirildiği tarih ve saat. Tarih ve saat, müşterinin saat dilimindedir ve "yyyy-AA-gg SS:dd:ss.ssssss" biçimindedir.

engineId

string

Harici motor hesabındaki hesabın kimliği.

status

enum (CustomerStatus)

Müşterinin durumu.

creationTime

string

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

id

string (int64 format)

Müşterinin kimliği.

descriptiveName

string

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

currencyCode

string

Hesabın faaliyet gösterdiği 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şturmaya yönelik 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 İzleme ile ilgili müşteri genelinde geçerli ayarlar 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 inceleyin.

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 izleme kullanıyorsa döndürülen değer, isteğin login-customer-id değerine göre farklılık gösterir.

enhancedConversionsForLeadsEnabled

boolean

Müşterinin, potansiyel müşteriler için gelişmiş dönüşümler özelliğini 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 bunu kullanıyor). Bu alan salt okunurdur.

googleAdsCrossAccountConversionTrackingId

string (int64 format)

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

crossAccountConversionTrackingId

string (int64 format)

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

ConversionTrackingStatus

Müşterinin Dönüşüm İzleme durumu.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca döndürülen değer için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
NOT_CONVERSION_TRACKED Müşteri, herhangi bir dönüşüm izleme kullanmıyor.
CONVERSION_TRACKING_MANAGED_BY_SELF Dönüşüm işlemleri bu müşteri tarafından oluşturulup 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üşteri veya yöneticiden farklı bir yönetici tarafından oluşturulur ve yönetilir.

AccountType

Olası arama motoru hesabı türleri.

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

DoubleClickCampaignManagerSetting

Yönetici müşteri 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şkilendirilen Campaign Manager reklamvereninin kimliği.

networkId

string (int64 format)

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

timeZone

string

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

AccountStatus

Bir hesabın olası durumları.

Sıralamalar
UNSPECIFIED Varsayılan değer.
UNKNOWN Bilinmeyen değer.
ENABLED Hesap reklam yayınlayabiliyor.
PAUSED Hesap, kullanıcı tarafından devre dışı bırakıldı.
SUSPENDED Hesap, dahili bir işlem tarafından devre dışı bırakıldı.
REMOVED Hesap, geri alınamaz bir şekilde devre dışı bırakıldı.
DRAFT Hesap hâlâ kurulum aşamasında, henüz ETKİN değil.

CustomerStatus

Müşterinin olası durumları.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca döndürülen değer için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
ENABLED Reklam yayınlayabilecek etkin bir hesabı belirtir.
CANCELED İptal edilmiş bir hesabın reklam yayınlayamadığını belirtir. Yönetici kullanıcı tarafından yeniden etkinleştirilebilir.
SUSPENDED Askıya alınmış bir hesabın reklam yayınlayamadığını belirtir. Yalnızca Google destek ekibi tarafından etkinleştirilebilir.
CLOSED Kapatılmış bir hesabın reklam yayınlayamadığını belirtir. Ayrıca, test hesabı KAPATILDI durumunda olur. Durum kalıcıdır ve yeniden açılamayabilir.

CustomerAsset

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

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

string

Müşteri öğesinin kaynak adı. CustomerAsset kaynak adları aşağıdaki biçimdedir:

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

asset

string

Zorunlu. Müşteriyle bağlantılı öğe.

status

enum (AssetLinkStatus)

Müşteri öğesinin durumu.

CustomerAssetSet

CustomerAssetSet, müşteriyle öğe grubu arasındaki bağlantıdır. CustomerAssetSet eklendiğinde bir öğe grubu müşteriyle bağlanır.

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

string

Müşteri öğe grubunun kaynak adı. Öğe grubu öğe kaynağı 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 durumudur. Salt okunurdur.

AccessibleBiddingStrategy

Müşterinin sahip olduğu ve müşteriyle paylaşılan Teklif Verme stratejilerinin bir görünümünü temsil eder.

Teklif Stratejisinin aksine bu kaynak, bu müşterinin sahip olduğu stratejilerin yanı sıra müşterinin yöneticilerine ait olan ve bu müşteriyle paylaşılan stratejileri içerir. Bu kaynak, metrik sağlamaz ve BiddingStrategy özelliklerinin yalnızca sınırlı bir alt kümesini gösterir.

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ı. AccessibleTeklif Stratejisi 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ı.

Birleştirme alanı scheme. Teklif düzeni

Yalnızca bir tane ayarlanabilir. scheme şunlardan yalnızca biri olabilir:

maximizeConversionValue

object (MaximizeConversionValue)

Bütçenizi harcarken kampanyalarınız için en fazla 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 etmenize yardımcı olacak şekilde ayarlayan bir teklif stratejisidir.

targetImpressionShare

object (TargetImpressionShare)

Seçilen bir gösterim yüzdesine göre otomatik olarak optimizasyon yapan bir teklif stratejisidir.

targetRoas

object (TargetRoas)

Reklam harcamalarından elde edilen gelir (ROAS) için belirli bir hedefin ortalamasını alarak geliri en üst düzeye çıkarmanıza yardımcı olan bir teklif stratejisidir.

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 fazla 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 (ROAS) hedefi seçeneği. Ayarlanırsa teklif stratejisi, reklam harcamalarından elde edilen gelir hedefini ortalamasını alırken geliri en üst düzeye çıkarır. Hedef ROAS değeri yüksekse teklif stratejisi bütçenin tamamını harcayamayabilir. Hedef ROAS ayarlanmazsa teklif stratejisi, bütçe dahilinde mümkün olan en yüksek ROAS'a ulaşmayı hedefler.

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) mümkün olduğunca fazla dönüşüm elde etmenize yardımcı olacak şekilde ayarlayan otomatik teklif stratejisidir.

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

string (int64 format)

Ortalama EBM hedefi. Bu hedef, hesabın para birimine bağlı olarak minimum faturalandırılabilir birimden büyük veya bu değere eşit olmalıdır.

TargetImpressionShare

Teklifleri, arama ağı reklamlarının belirli bir yüzdesinin ilk sayfanın (veya hedeflenen başka bir konumun) en üstünde (veya hedeflenen diğer bir konum) en üstünde gösterilmesini sağlayacak şekilde ayarlayan otomatik teklif stratejisidir.

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 yerde gösterilecek reklamların seçilen kısmı (mikrosaniye cinsinden). Örneğin% 1, 10.000'e eşittir.

cpcBidCeilingMicros

string (int64 format)

Otomatik teklif sisteminin belirtmesine izin verilen en yüksek TBM teklifi. Bu, reklamveren tarafından girilen, üst sınırı ayarlayan ve yerel mikrolarda belirtilen zorunlu bir alandır.

TargetRoas

Reklam harcamalarından elde edilen gelir (ROAS) için belirli bir hedefin ortalamasını alırken geliri en üst düzeye çıkarmanıza yardımcı olan bir otomatik teklif stratejisidir.

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

number

Harcama birimi başına seçilen gelir (dönüşüm verilerine dayalı olarak).

TargetSpend

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

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

string (int64 format)

Tıklamaların en üst düzeye çıkarılacağı harcama hedefi. Hedef Harcama teklif vereni, bu değerden veya doğal kısıtlama harcama tutarından daha küçük olanı harcamaya çalışır. Belirtilmezse harcama hedefi olarak bütçe kullanılır. Bu alan kullanımdan kaldırılmıştır 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 adresine bakın.

cpcBidCeilingMicros

string (int64 format)

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

ManagerLinkStatus

Bir bağlantının olası durumları.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca döndürülen değer için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
ACTIVE Geçerli etkin ilişkiyi gösterir
INACTIVE Sonlandırılmış ilişkiyi belirtir
PENDING İlişkinin yönetici tarafından talep edildiğini ancak müşterinin henüz bunu kabul etmediğini gösterir.
REFUSED Yönetici, ilişki kurmak istedi ancak müşteri reddetti.
CANCELED İlişkinin yönetici tarafından talep edildiğini ancak yöneticinin bunu iptal ettiğini gösterir.

CustomerClient

Belirtilen müşteriyle müşteri arasındaki bağlantı. CustomerClients yalnızca yönetici müşteriler için mevcuttur. Yöneticinin kendisi ve doğrudan ve dolaylı müşteri müşterileri dahil edilir.

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

İstekte bulunan müşteriye ait olan ve müşteri müşteriye uygulanan etiketlerin kaynak adları. Etiket kaynak adları şu biçimdedir:

customers/{customerId}/labels/{label_id}

status

enum (CustomerStatus)

Müşterinin durumu. Salt okunur.

clientCustomer

string

Belirtilen müşteriyle bağlantılı olan istemci-müşteri kaynak adı. Salt okunur.

hidden

boolean

Bunun gizli bir hesap olup olmadığını belirtir.

Salt okunur.

level

string (int64 format)

Belirli bir müşteriyle müşteri arasındaki mesafe. Öz bağlantı için seviye değeri 0 olur. Salt okunur.

timeZone

string

Müşterinin saat diliminin Ortak Yerel Ayar Veri Deposu (CLDR) dize gösterimi, örneğin, 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ı tanımlar. Salt okunur.

descriptiveName

string

İstemci için açıklayıcı ad. Salt okunur.

currencyCode

string

Müşterinin para birimi kodu (ör. "USD", "EUR"). Salt okunur.

id

string (int64 format)

Müşterinin 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üntüleme 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ğini değil, etkin sunma durumunu gösterir. Cinsiyet ölçütü bulunmayan bir reklam grubu, varsayılan olarak tüm cinsiyetlere gösterilir. Bu nedenle, tüm cinsiyetler genderView'da 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 sabitinin kaynak adı. Coğrafi hedef sabit kaynak adları şu biçimdedir:

geoTargetConstants/{geo_target_constant_id}

status

enum (GeoTargetConstantStatus)

Coğrafi hedef sabit durumu.

id

string (int64 format)

Coğrafi hedef sabitinin kimliği.

name

string

Coğrafi hedef sabit İngilizce adı.

countryCode

string

Hedefle ilişkilendirilen ISO-3166-1 alpha-2 ülke kodu.

targetType

string

Coğrafi hedef sabit hedef türü.

canonicalName

string

Hedefin adı ile ana ülkesinin ve ülkesinin adından oluşan, tam nitelikli İngilizce ad.

parentGeoTarget

string

Üst coğrafi hedef sabitinin kaynak adı. Coğrafi hedef sabit kaynak adları şu biçimdedir:

geoTargetConstants/{parent_geo_target_constant_id}

GeoTargetConstantStatus

Coğrafi hedef sabitinin olası durumları.

Sıralamalar
UNSPECIFIED Değer belirtilmedi.
UNKNOWN

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

Bu yalnızca yanıt odaklı bir değerdir.

ENABLED Coğrafi hedef sabiti geçerlidir.
REMOVAL_PLANNED Coğrafi hedef sabiti eski ve 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çimdedir:

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

Şirket

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çimdedir: customers/{customerId}/labels/{label_id}

status

enum (LabelStatus)

Etiketin durumu. Salt okunur.

textLabel

object (TextLabel)

Metni renkli arka plan üzerinde görüntüleyen bir etiket türü.

id

string (int64 format)

Etiketin kimliği. Salt okunur.

name

string

Etiketin adı.

Yeni etiket oluştururken bu alan zorunludur ve boş bırakılmamalıdır.

Bu dizenin uzunluğu 1 ile 80 arasında (1 ve 80 dahil) olmalıdır.

LabelStatus

Bir etiketin olası durumları.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca döndürülen değer için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
ENABLED Etiket etkinleştirildi.
REMOVED Etiket kaldırıldı.

TextLabel

Metni renkli arka plan üzerinde görüntüleyen bir etiket türü.

JSON gösterimi
{
  "backgroundColor": string,
  "description": string
}
Alanlar
backgroundColor

string

Etiketin RGB biçimindeki arka plan rengi. Bu dize, '^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$' normal ifadesiyle eşleşmelidir. Not: Yönetici hesapları için arka plan rengi 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 sabitinin kaynak adı. Dil sabit 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ı; örneğin, "İngilizce (ABD)", "İspanyolca" 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çimdedir:

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

ProductBiddingCategoryConstant

Ürün Teklif Verme 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 teklifli sistem kategorisi kaynak adları şu biçimdedir:

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

level

enum (ProductBiddingCategoryLevel)

Ürün teklif kategorisi düzeyi.

status

enum (ProductBiddingCategoryStatus)

Ürün teklif verme kategorisinin durumu.

id

string (int64 format)

Ürün teklif kategorisinin kimliği.

Bu kimlik, şu makalede açıklanan google_product_category [google_ürün_kategorisi] kimliğine eşdeğerdir: https://support.google.com/merchants/answer/6324436.

countryCode

string

Ürün teklif verme kategorisinin iki harfli büyük harfli ülke kodu.

productBiddingCategoryConstantParent

string

Üst ürün teklif verme kategorisinin kaynak adı.

languageCode

string

Ürün teklif kategorisinin dil kodu.

localizedName

string

languageCode'a göre yerelleştirilmiş ürün teklif kategorisinin değerini görüntüleyin.

ProductBiddingCategoryLevel

Ürün teklif kategorisi düzeyini açıklayan enum.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca döndürülen değer için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
LEVEL1 1. Düzey:
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öndürülen değer için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
ACTIVE Kategori etkin ve teklif vermek için kullanılabilir.
OBSOLETE Kategori eski. 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ü. Çeşitli ürün boyutu düzeylerinde toplu Alışveriş kampanyası istatistikleri sunar. 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üntüleme kaynak adları şu biçimdedir: 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çimdedir:

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ı. access_reason'a bağlı olarak kullanıcı listesi adı benzersiz olmayabilir (örneğin, access_reason=SHARED)

UserListType

Olası kullanıcı listesi türlerini içeren enum.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca döndürülen değer için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
REMARKETING Dönüşüm türleri koleksiyonu olarak temsil edilen UserList.
LOGICAL Diğer kullanıcı listelerinin/ilgi alanlarının kombinasyonu olarak gösterilen UserList.
EXTERNAL_REMARKETING Google Ad Manager platformunda oluşturulan Kullanıcı Listesi.
RULE_BASED Bir kuralla ilişkili Kullanıcı Listesi.
SIMILAR Başka bir UserList ile benzer kullanıcılara sahip UserList.
CRM_BASED Reklamveren tarafından e-posta veya diğer biçimlerde sağlanan birinci taraf CRM verilerinin Kullanıcı Listesi.

WebpageView

Web sayfası görünümü.

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

string

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

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

Şu adrese gidin:

Bir 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. Search Ads 360, bu kimliği Search Ads 360'ta bir envanter hesabı bağladığınızda oluşturur.

adId

string (int64 format)

Reklam kimliği. 0 değeri, reklamın ilişkilendirilmemiş olduğunu gösterir.

clickId

string

Tıklama kimliği URL'si parametresi olarak açılış sayfasına iletilen her ziyaret için benzersiz bir dizedir.

visitDateTime

string

Ziyaret etkinliğinin zaman damgası. Zaman damgası müşterinin saat dilimindedir 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ı: Çevrimiçi veya Yerel.

productLanguageCode

string

Ürünle ilgili verilerin yer aldığı Merchant Center feed'i için ayarlanan dildir (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 kayıtlı ülkedir (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

Bir ürün teklifinin konumunu açıklayan enum.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca döndürülen değer için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
ONLINE Ürün, internet üzerinden satılmaktadır.
LOCAL Ürün yerel mağazalarda satılmaktadır.

Dönüşüm

Bir 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 Ads360 envanter hesabı kimliği. Search Ads360, Search Ads360'ta bir envanter hesabı bağladığınızda bu kimliği oluşturur.

adId

string (int64 format)

Reklam kimliği. 0 değeri, reklamın ilişkilendirilmemiş olduğunu gösterir.

clickId

string

Dönüşümün ilişkilendirildiği ziyaret için tıklama kimliği URL parametresi olarak açılış sayfasına aktarılan benzersiz bir dize.

visitId

string (int64 format)

Dönüşümün ilişkilendirildiği Search Ads360 ziyaret kimliği.

advertiserConversionId

string

Çevrimdışı dönüşümler için bu, reklamverenler tarafından sağlanan bir kimliktir. Reklamveren böyle bir kimlik belirtmezse Search Ads 360 bir tane oluşturur. Online dönüşümler için bu, reklamverenin Floodlight talimatlarına bağlı olarak kimlik 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ı: Çevrimiçi veya Yerel.

productLanguageCode

string

Ürünle ilgili verilerin yer aldığı Merchant Center feed'i için ayarlanan dildir (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 kayıtlı ülke (ISO-3166 biçimli).

attributionType

enum (AttributionType)

Dönüşüm neyle ilişkilendirilir: Ziyaret veya Anahtar Kelime+Reklam.

conversionDateTime

string

Dönüşüm etkinliğinin zaman damgası.

conversionLastModifiedDateTime

string

Dönüşümün 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)

qty url parametresiyle belirlendiği şekilde, dönüşüm tarafından kaydedilen öğelerin miktarı. Parametreyi (dönüşümde satılan öğe sayısı gibi) dinamik olarak doldurmaktan reklamveren sorumludur, aksi takdirde varsayılan olarak 1 değeri kullanılır.

conversionRevenueMicros

string (int64 format)

Dönüşüm etkinliği için mikro cinsinden düzenlenmiş gelir. Bu değer, her zaman reklam sunma hesabının para biriminde olur.

floodlightOriginalRevenue

string (int64 format)

Floodlight para birimi talimatı değişikliklerinden önce, Floodlight etkinliğiyle ilişkilendirilen orijinal, değişmemiş gelir (geçerli raporun para biriminde).

floodlightOrderId

string

Dönüşüm için reklamveren tarafından sağlanan Floodlight sipariş kimliği.

status

enum (ConversionStatus)

Dönüşümün durumu (ETKİN veya KALDIRILDI).

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 Ads360'taki dönüşüm ilişkilendirme türü

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca döndürülen değer için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
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öndürülen değer için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
ENABLED Dönüşüm etkinleştirildi.
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,
  "crossDeviceConversionsValue": number,
  "ctr": number,
  "conversions": number,
  "conversionsValue": number,
  "historicalQualityScore": string,
  "impressions": string,
  "interactionRate": number,
  "interactions": string,
  "invalidClickRate": number,
  "invalidClicks": string,
  "mobileFriendlyClicksPercentage": number,
  "searchAbsoluteTopImpressionShare": number,
  "searchBudgetLostAbsoluteTopImpressionShare": number,
  "searchBudgetLostImpressionShare": number,
  "searchBudgetLostTopImpressionShare": number,
  "searchClickShare": number,
  "searchExactMatchImpressionShare": number,
  "searchImpressionShare": number,
  "searchRankLostAbsoluteTopImpressionShare": number,
  "searchRankLostImpressionShare": number,
  "searchRankLostTopImpressionShare": number,
  "searchTopImpressionShare": number,
  "topImpressionPercentage": number,
  "valuePerAllConversions": number,
  "valuePerAllConversionsByConversionDate": number,
  "valuePerConversion": number,
  "valuePerConversionsByConversionDate": number,
  "clientAccountViewThroughConversions": string,
  "clientAccountCrossSellCostOfGoodsSoldMicros": string,
  "crossSellCostOfGoodsSoldMicros": string,
  "clientAccountCrossSellGrossProfitMicros": string,
  "crossSellGrossProfitMicros": string,
  "clientAccountCrossSellRevenueMicros": string,
  "crossSellRevenueMicros": string,
  "clientAccountCrossSellUnitsSold": number,
  "crossSellUnitsSold": number,
  "clientAccountLeadCostOfGoodsSoldMicros": string,
  "leadCostOfGoodsSoldMicros": string,
  "clientAccountLeadGrossProfitMicros": string,
  "leadGrossProfitMicros": string,
  "clientAccountLeadRevenueMicros": string,
  "leadRevenueMicros": string,
  "clientAccountLeadUnitsSold": number,
  "leadUnitsSold": number
}
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 tarihi anlamına gelir. 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ı. Buna, includeInConversionsMetric değerinden bağımsız olarak tüm dönüşümler dahildir. Bu sütun tarihle birlikte seçildiğinde, tarih sütunundaki değerler dönüşüm tarihi anlamına gelir. 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üşüm değerlerinin toplamı. Bu sütun tarihle birlikte seçildiğinde, tarih sütunundaki değerler dönüşüm tarihi anlamına gelir.

conversionsByConversionDate

number

Teklif verilebilir dönüşüm türleri için dönüşüm tarihine göre dönüşümlerin toplamı. İlişkilendirme modelleme nedeniyle kesirli olabilir. Bu sütun tarihle birlikte seçildiğinde, tarih sütunundaki değerler dönüşüm tarihi anlamına gelir.

historicalCreativeQualityScore

enum (QualityScoreBucket)

Reklam öğesi geçmiş kalite puanı.

historicalLandingPageQualityScore

enum (QualityScoreBucket)

Geçmişteki açılış sayfası deneyiminin kalitesi.

historicalSearchPredictedCtr

enum (QualityScoreBucket)

Geçmiş Arama'da tahmin edilen tıklama oranı (TO).

interactionEventTypes[]

enum (InteractionEventType)

Ödenebilir 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şimleri sayısına bölünmesiyle elde edilir.

allConversionsValue

number

Tüm dönüşümlerin değeri.

allConversions

number

Toplam dönüşüm sayısı. Buna, includeInConversionsMetric değerinden bağımsız olarak tüm dönüşümler dahildir.

allConversionsValuePerCost

number

Tüm dönüşümlerin değerinin reklam etkileşimlerinin (metin reklamlar için tıklanma ve video reklamlar için görüntülenme gibi) toplam maliyetine bölünmesiyle elde edilir.

allConversionsFromClickToCall

number

Kullanıcıların bir reklamı tıklarken veya tıkladıktan sonra mağazaya telefon etmek için "Ara" düğmesini tıklama sayısı. Bu sayı, aramaların bağlanıp bağlanmadığını veya aramaların 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 elde edilen değer.

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 yayınlama 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 sonraki mağaza ziyaretlerinin tahmini sayısı.

Bu metrik yalnızca feed öğeleri için geçerlidir.

visits

number

Search Ads 360'ın başarıyla kaydettiği ve 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 tutardır. 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 elde edilen değer. 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 parametresini inceleyin

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 parametresini inceleyin

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 kaç kez gösterilmediğine ilişkin tahmini yüzde. Not: İçerik bütçesi kaybedilen gösterim payı 0-0,9 aralığında raporlanır. 0,9'dan büyük 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-1 aralığında rapor edilir. 0,1'in altındaki değerler 0,0999 olarak bildirilir.

contentRankLostImpressionShare

number

Reklamlarınızın Görüntülü Reklam Ağı'nda düşük Reklam Sıralaması nedeniyle elde edemediği gösterimlerin tahmini yüzdesidir. Not: İçerik sıralaması kaybedilen gösterim payı 0-0,9 aralığında raporlanır. 0,9'dan büyük değerler 0,9001 olarak bildirilir.

conversionsFromInteractionsRate

number

Dönüşüme uygun etkileşim başına ortalama teklif verilebilir dönüşüm (etkileşimden). Bir reklam etkileşiminin ortalama ne sıklıkta teklif verilebilir bir dönüşüm sağladığını gösterir.

clientAccountConversionsValue

number

Müşteri hesabı dönüşümlerinin değeri. Bu, yalnızca includeInClientAccountConversionsMetric özelliğinin doğru değerine ayarlandığı dönüşüm işlemlerini içerir. Dönüşüme dayalı teklif verme kullanıyorsanız teklif stratejileriniz bu dönüşümler için optimize edilir.

conversionsValuePerCost

number

Teklif verilebilir dönüşüm değerinin, uygun dönüşüm etkileşimlerinin toplam maliyetine bölümü.

conversionsFromInteractionsValuePerInteraction

number

Etkileşimlerden elde edilen dönüşümlerin değerinin reklam etkileşimleri sayısına bölünmesiyle elde edilir. Bu, yalnızca includeInConversionsMetric özelliğinin doğru değerine ayarlandığı dönüşüm işlemlerini içerir. Dönüşüme dayalı teklif verme kullanıyorsanız teklif stratejileriniz bu dönüşümler için optimize edilir.

clientAccountConversions

number

Müşteri hesabı dönüşümlerinin sayısı. Bu, yalnızca includeInClientAccountConversionsMetric özelliğinin doğru değerine ayarlandığı dönüşüm işlemlerini içerir. Dönüşüme dayalı teklif verme kullanıyorsanız teklif stratejileriniz bu dönüşümler için optimize edilir.

costMicros

string (int64 format)

İlgili dönemdeki tıklama başına maliyetiniz (TBM) ile bin gösterim başına maliyetinizin (BGBM) 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 parametresini inceleyin

costPerAllConversions

number

Reklam etkileşimlerinin maliyetinin tüm dönüşümlere bölünmesiyle elde edilen değer.

costPerConversion

number

Dönüşüm için uygun olan teklif verilebilir dönüşüm başına ortalama dönüşüm maliyeti.

costPerCurrentModelAttributedConversion

number

Reklam etkileşimleri maliyetinin, modelle ilişkilendirilen mevcut dönüşümlere bölünmesiyle elde edilen değer. Bu, yalnızca includeInConversionsMetric özelliğinin doğru değerine ayarlandığı dönüşüm işlemlerini içerir. Dönüşüme dayalı teklif verme kullanıyorsanız teklif stratejileriniz bu dönüşümler için optimize edilir.

crossDeviceConversions

number

Müşterinin bir cihazda bir reklamı tıklayıp ardından farklı bir cihaz veya tarayıcıda dönüşüm gerçekleştirmesinden elde edilen dönüşümler. Cihazlar arası dönüşümler zaten tüm Dönüşümler'e dahil edilmiş.

crossDeviceConversionsValue

number

Cihazlar arası dönüşümlerin toplam değeri.

ctr

number

Reklamınızın aldığı tıklama sayısının (Tıklamalar) reklamınızın gösterilme (Gösterimler) sayısına bölünmesiyle elde edilen orandır.

conversions

number

Dönüşüm sayısı. Bu, yalnızca includeInConversionsMetric özelliğinin doğru değerine ayarlandığı dönüşüm işlemlerini içerir. Dönüşüme dayalı teklif verme 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.

historicalQualityScore

string (int64 format)

Kalite puanı geçmişi.

impressions

string (int64 format)

Reklamınızın Google Ağı'ndaki bir arama sonuçları sayfasında veya web sitesinde ne sıklıkta göründüğünün sayısıdır.

interactionRate

number

Reklamınız kullanıcılara gösterildikten sonra, kullanıcıların reklamınızla etkileşime geçme sıklığıdır. 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. Metin reklamlar veya Alışveriş reklamları için tıklamalar, video reklamların görüntülenmesi vb.

invalidClickRate

number

Raporlama dönemi boyunca toplam tıklama sayınız (filtrelenmiş ve filtrelenmemiş tıklamalar) içinden filtrelenen tıklamaların yüzdesi.

invalidClicks

string (int64 format)

Google'ın kurallara aykırı olarak değerlendirdiği ve sizden ücret almadığı tıklamaların sayısı.

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 adresini ziyaret edin. 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ında en üst sıralarda yer alan reklamlar arasında ne sıklıkta en baştaki reklam olmadığını tahmin eden sayı. Not: Arama Ağı bütçesi kaybedilen mutlak üst gösterim payı 0-0,9 aralığında raporlanır. 0,9'dan büyük 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 kaç kez gösterilmediğine ilişkin tahmini yüzde. Not: Arama Ağı bütçesi kaybedilen gösterim payı 0-0,9 aralığında raporlanır. 0,9'dan büyük değerler 0,9001 olarak bildirilir.

searchBudgetLostTopImpressionShare

number

Reklamınızın düşük bütçe nedeniyle en üst sıradaki organik arama sonuçlarının yanında ne sıklıkta gösterilmediğine ilişkin tahmini sayı. Not: Arama Ağı bütçesi kaybedilen üst gösterim payı 0-0,9 aralığında raporlanır. 0,9'dan büyük 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 orandır. Not: Arama tıklama payı 0,1 - 1 aralığında rapor edilir. 0,1'in altındaki değerler 0,0999 olarak bildirilir.

searchExactMatchImpressionShare

number

Anahtar kelime eşleme türlerinizden bağımsız olarak, aldığınız gösterim sayısı, Arama Ağı'nda anahtar kelimelerinizle tam olarak eşleşen (veya anahtar kelimenizin yakın varyasyonları olan) arama terimleri için almaya uygun olduğunuz tahmini gösterim sayısına bölünür. Not: Arama Ağı tam eşleme gösterim payı 0,1-1 aralığında rapor edilir. 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-1 aralığında rapor edilir. 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ında en üst sıralarda yer alan reklamlar arasında ne sıklıkta en baştaki reklam olmadığını tahmin eden sayı. Not: Arama sıralaması kaybedilen mutlak üst gösterim payı 0-0,9 aralığında raporlanır. 0,9'dan büyük değerler 0,9001 olarak bildirilir.

searchRankLostImpressionShare

number

Arama Ağı'nda reklamlarınızın düşük Reklam Sıralaması nedeniyle elde edemediği gösterimlerin tahmini yüzdesidir. Not: Arama sıralaması kaybedilen gösterim payı 0-0,9 aralığında raporlanır. 0,9'dan büyük değerler 0,9001 olarak bildirilir.

searchRankLostTopImpressionShare

number

Reklamınızın, düşük Reklam Sıralaması nedeniyle en üst sıradaki organik arama sonuçlarının yanında ne sıklıkta gösterilmediğine ilişkin tahmini sayı. Not: Arama sıralaması kaybedilen üst gösterim payı 0-0,9 aralığında raporlanır. 0,9'dan büyük değerler 0,9001 olarak bildirilir.

searchTopImpressionShare

number

En iyi reklamlar arasında aldığınız gösterim sayısının, en iyi 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-1 aralığında rapor edilir. 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

En üstteki organik arama sonuçlarının yanında gösterilen reklam gösterimlerinizin yüzdesidir.

valuePerAllConversions

number

Tüm dönüşümlerin değerinin tüm dönüşümlerin sayısına bölünmesiyle elde edilir.

valuePerAllConversionsByConversionDate

number

Tüm dönüşümlerin değerinin tüm dönüşümlerin sayısına bölünmesiyle elde edilir. Bu sütun tarihle birlikte seçildiğinde, tarih sütunundaki değerler dönüşüm tarihi anlamına gelir. 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üşümlerin sayısına bölümü. Her bir teklif verilebilir dönüşümün 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ümü. Her bir teklif verilebilir dönüşümün 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 tarihi anlamına gelir.

clientAccountViewThroughConversions

string (int64 format)

Görüntüleme dönüşümlerinin toplam sayısı. Bunlar, müşteri bir resim reklamı veya zengin medya reklamını görüp daha sonra başka bir reklamla etkileşimde bulunmadan (örneğin, tıklamadan) sitenizde bir dönüşümü tamamladığında gerçekleşir.

clientAccountCrossSellCostOfGoodsSoldMicros

string (int64 format)

Müşteri hesabı 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 (Alışveriş reklamlarına bakın) 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. Bu ü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ır. Ş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 parametresini inceleyin

crossSellCostOfGoodsSoldMicros

string (int64 format)

Satılan malların çapraz satış maliyeti (çapraz satış 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 (Alışveriş reklamlarına bakın) 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. Bu ü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ır. Ş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 parametresini inceleyin

clientAccountCrossSellGrossProfitMicros

string (int64 format)

Müşteri hesabı çapraz satıştan elde edilen brüt kâr, farklı bir ürünün reklamının yapılması sonucunda satılan ürünlerden elde ettiğiniz 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 (Alışveriş reklamlarına bakın) 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. Bu ü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ır. 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 parametresini inceleyin

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 (Alışveriş reklamlarına bakın) 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. Bu ü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ır. 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 parametresini inceleyin

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 (Alışveriş reklamlarına bakın) 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. Bu ü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ır. Ş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 parametresini inceleyin

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 (Alışveriş reklamlarına bakın) 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. Bu ü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ır. Ş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 parametresini inceleyin

clientAccountCrossSellUnitsSold

number

Müşteri hesabında ç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 (Alışveriş reklamlarına bakın) 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. Bu ü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ır. 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 (Alışveriş reklamlarına bakın) 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. Bu ü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ır. 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 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. Etkileşimde bulunulan reklamla ilişkilendirilmiş bir ürün varsa (Alışveriş reklamlarına bakın) 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ır. Ş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 parametresini inceleyin

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 (Alışveriş reklamlarına bakın) 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ır. Ş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 parametresini inceleyin

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 ürünlerden elde ettiğiniz 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 (Alışveriş reklamlarına bakın) 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ır. Ş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 parametresini inceleyin

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 (Alışveriş reklamlarına bakın) 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ır. Ş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 parametresini inceleyin

clientAccountLeadRevenueMicros

string (int64 format)

Müşteri hesabı reklamı geliri, 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 (Alışveriş reklamlarına bakın) 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ır. Ş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 parametresini inceleyin

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 (Alışveriş reklamlarına bakın) 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ır. Ş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 parametresini inceleyin

clientAccountLeadUnitsSold

number

Müşteri hesabında satılan potansiyel müşteri birimi sayısı, 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 (Alışveriş reklamlarına bakın) 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ır. 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

Satılan potansiyel müşteri birimi 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 (Alışveriş reklamlarına bakın) 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ır. 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.

Değer

Genel bir veri kapsayıcısıdır.

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
Birleştirme alanı value. Bir değer. value şunlardan yalnızca biri olabilir:
booleanValue

boolean

Bir boole.

int64Value

string (int64 format)

Bir int64.

floatValue

number

Kayan.

doubleValue

number

Çift.

stringValue

string

Bir dize.

QualityScoreBucket

Olası kalite puanı gruplarını listeleyen sıralama.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca döndürülen değer için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
BELOW_AVERAGE Reklam öğesinin kalitesi ortalamanın altında.
AVERAGE Reklam öğesinin kalitesi ortalama düzeyde.
ABOVE_AVERAGE Reklam öğesinin kalitesi ortalamanın üzerinde.

InteractionEventType

Olası ödenebilir ve ücretsiz etkileşim türlerini açıklayan enum.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca döndürülen değer için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
CLICK Tıklayarak siteye gidin. Çoğu durumda, bu etkileşim harici bir konuma (genellikle reklamverenin açılış sayfasına) yönlendirir. Bu ayrıca, tıklama etkinlikleri için varsayılan EngagementEventType'tır.
ENGAGEMENT Kullanıcının reklamla yerinde etkileşim kurma niyeti.
VIDEO_VIEW Kullanıcı bir video reklam görüntüledi.
NONE Reklam dönüşüm etkinlikleri için varsayılan EngagementEventType. Bu parametre, bir reklam dönüşümü satırı ücretsiz etkileşimlerin (örneğin, reklam dönüşümleri) temel metriklerin bir parçası olarak "tanıtılması" ve raporlanması gerektiğini BELİRTMEDİĞİNDE kullanılır. Bunlar kısaca diğer (reklam) dönüşümlerdir.

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,
  "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ü, örneğin MONDAY.

device

enum (Device)

Metriklerin geçerli olduğu cihaz.

keyword

object (Keyword)

Anahtar kelime ölçütü.

productChannel

enum (ProductChannel)

Ürünün kanalı.

productChannelExclusivity

enum (ProductChannelExclusivity)

Ürünün kanal ayrıcalığı.

productCondition

enum (ProductCondition)

Ürünün durumu.

productSoldCondition

enum (ProductCondition)

Satılan ürünün durumu.

rawEventConversionDimensions[]

object (Value)

Ham 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çimi, örneğin, 2018-04-17.

month

string

Ayın ilk gününün tarihiyle temsil edilen ay. yyyy-AA-gg olarak biçimlendirilir.

productBiddingCategoryLevel1

string

Ürünün teklif verme kategorisi (1. düzey).

productBiddingCategoryLevel2

string

Ürünün teklif verme kategorisi (2. düzey).

productBiddingCategoryLevel3

string

Ürünün teklif verme kategorisi (seviye 3).

productBiddingCategoryLevel4

string

Ürünün teklif verme kategorisi (4. düzey).

productBiddingCategoryLevel5

string

Ürünün teklif verme kategorisi (5. düzey).

productBrand

string

Ürünün markası.

productCountry

string

Ürünün satıldığı ülke için coğrafi hedef sabitinin kaynak adı.

productCustomAttribute0

string

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

productCustomAttribute1

string

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

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 dili için dil sabitinin kaynak adı.

productSoldBiddingCategoryLevel1

string

Satılan ürünün teklif verme kategorisi (1. seviye).

productSoldBiddingCategoryLevel2

string

Satılan ürünün teklif verme kategorisi (2. düzey).

productSoldBiddingCategoryLevel3

string

Satılan ürünün teklif verme kategorisi (seviye 3).

productSoldBiddingCategoryLevel4

string

Satılan ürünün teklif verme kategorisi (4. düzey).

productSoldBiddingCategoryLevel5

string

Satılan ürünün teklif verme kategorisi (5. düzey).

productSoldBrand

string

Satılan ürünün markası.

productSoldCustomAttribute0

string

Satılan ürünün özel özelliği 0.

productSoldCustomAttribute1

string

Satılan ürünün özel özelliği 1.

productSoldCustomAttribute2

string

Satılan ürünün özel özelliği 2.

productSoldCustomAttribute3

string

Satılan ürünün özel özelliği 3.

productSoldCustomAttribute4

string

Satılan ürünün özel özelliği 4.

productSoldItemId

string

Satılan ürünün öğe kimliği.

productSoldTitle

string

Satılan ürünün adı.

productSoldTypeL1

string

Satılan ürünün türü (seviye 1).

productSoldTypeL2

string

Satılan ürünün türü (seviye 2).

productSoldTypeL3

string

Satılan ürünün türü (seviye 3).

productSoldTypeL4

string

Satılan ürünün türü (düzey 4).

productSoldTypeL5

string

Satılan ürünün türü (seviye 5).

productStoreId

string

Ürünün mağaza kimliği.

productTitle

string

Ürünün başlığı.

productTypeL1

string

Ürünün türü (düzey 1).

productTypeL2

string

Ürünün türü (düzey 2).

productTypeL3

string

Ürünün türü (düzey 3).

productTypeL4

string

Ürünün türü (düzey 4).

productTypeL5

string

Ürünün türü (düzey 5).

quarter

string

Bir üç aylık dönemin ilk gününün tarihiyle temsil edilen çeyrek. Üç aylık dönemler için takvim yılını kullanır. Örneğin, 2018'in ikinci çeyreği 01.04.2018'de başlar. yyyy-AA-gg olarak biçimlendirilir.

week

string

Pazartesi ile Pazar arası olarak tanımlanan ve Pazartesi gününün tarihiyle temsil edilen hafta. yyyy-AA-gg olarak biçimlendirilir.

year

integer

Yıl, yyyy biçiminde olmalıdır.

assetInteractionTarget

object (AssetInteractionTarget)

Yalnızca CustomerAsset, CampaignAsset ve AdGroupAsset metrikleriyle kullanılır. Etkileşim metriklerinin öğenin kendisinde mi yoksa farklı bir öğede ya da reklam biriminde mi gerçekleştiğini belirtir. Etkileşimler (örneğin, tıklamalar), birlikte sunulduklarında, sunulan reklamın tüm bölümlerinde (örneğin, Reklamın kendisi ve Site Bağlantıları gibi diğer bileşenler) sayılır. engagementOnThisAsset doğru değerine ayarlandığında, etkileşimlerin söz konusu öğede olduğu, engagementOnThisAsset öğesinin yanlış değeri ise etkileşimlerin bu belirli öğede değil, bu öğenin sunulduğu, sunulan reklamın diğer bölümlerinde yer aldığı anlamına gelir.

AdNetworkType

Google Ads ağ türlerini sıralar.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Değer, bu sürümde 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

Bir ürün teklifinin kullanılabilirliğini açıklayan enum.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca döndürülen değer için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
SINGLE_CHANNEL Öğe, ProductChannel'da belirtildiği şekilde yerel mağazalarda veya çevrimiçi olarak yalnızca bir kanal üzerinden satılır.
MULTI_CHANNEL Öğe, çevrimiçi veya yerel mağazadaki eşdeğeriyle eşleştirilir ve böylece, her iki ShoppingProductChannels'da da satın alınabileceğini belirtir.

ProductCondition

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

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca döndürülen değer için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
OLD Ürünün durumu eski.
NEW Ürünün durumu yenidir.
REFURBISHED Ürün yenilenmiş durumda.
USED Ürün durumu kullanılıyor.

AssetInteractionTarget

AssetEtkileşimTarget segmenti.

JSON gösterimi
{
  "asset": string,
  "interactionOnThisAsset": boolean
}
Alanlar
asset

string

Öğe kaynağının adı.

interactionOnThisAsset

boolean

Yalnızca CustomerAsset, CampaignAsset ve AdGroupAsset metrikleriyle kullanılır. Etkileşim metriklerinin öğenin kendisinde mi yoksa farklı bir öğede ya da reklam biriminde mi gerçekleştiğini belirtir.