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 öğesi grubu.

adGroupAudienceView

object (AdGroupAudienceView)

Sorguda başvurulan 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 başvurulan öğe grubu üst kombinasyonu 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 başvurulan kampanya öğesi.

campaignAssetSet

object (CampaignAssetSet)

Sorguda başvurulan kampanya öğesi grubu.

campaignAudienceView

object (CampaignAudienceView)

Sorguda başvurulan 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 başvurulan 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 başvurulan müşteri öğesi.

customerAssetSet

object (CustomerAssetSet)

Sorguda başvurulan müşteri öğesi grubu.

accessibleBiddingStrategy

object (AccessibleBiddingStrategy)

Sorguda başvurulan erişilebilir teklif stratejisi.

customerClient

object (CustomerClient)

Sorguda referans verilen CustomerClient.

dynamicSearchAdsSearchTermView

object (DynamicSearchAdsSearchTermView)

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

Reklam Grubu

Bir reklam grubu.

JSON gösterimi
{
  "resourceName": string,
  "status": enum (AdGroupStatus),
  "type": enum (AdGroupType),
  "adRotationMode": enum (AdGroupAdRotationMode),
  "creationTime": string,
  "targetingSetting": {
    object (TargetingSetting)
  },
  "labels": [
    string
  ],
  "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 şekildedir:

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 damgası. Zaman damgası müşterinin saat diliminde ve "yyyy-AA-gg SS:dd:ss" şeklindedir. biçimindedir.

targetingSetting

object (TargetingSetting)

İlgili özellikleri hedefleme 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 dışı hesaplar içindir (ör. Yahoo Japan, Microsoft, Baidu). Google Ads varlığı için "adGroup.id"yi 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ı için kullanılabilir.

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

endDate

string

Reklam grubunun reklam yayınını sona erdiği tarih. Reklam grubu, varsayılan olarak 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ı için kullanılabilir.

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

languageCode

string

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

lastModifiedTime

string

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

id

string (int64 format)

Reklam grubunun kimliği.

name

string

Reklam grubunun adı.

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

Tam genişlikte 255'ten az UTF-8 karakter içermelidir.

Boş değer (kod noktası 0x0), yeni satır sonu (kod noktası 0xA) veya satır başı karakteri (kod noktası 0xD) karakter 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 niteliğinde bir değerdir.

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

AdGroupType

Bir reklam grubunun olası 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 niteliğinde 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üdü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ı reklam gruplarının türü.
HOTEL_ADS Otel kampanyaları için varsayılan reklam grubu türü.
SHOPPING_SMART_ADS Akıllı Alışveriş kampanyalarındaki reklam gruplarının türü.
VIDEO_BUMPER Kısa, atlanamayan yayın içi video reklamlar.
VIDEO_TRUE_VIEW_IN_STREAM TrueView (atlanabilir) video içi 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 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 niteliğinde bir değerdir.

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

AdGroupEngineStatus

Reklam grubu motorunun durumu.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca dö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'in 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ıtlamak için hedefleme boyutu başına ayarı.

TargetRestriction

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

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

enum (TargetingDimension)

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

bidOnly

boolean

Reklamlarınızı bu hedefleme boyutu için yalnızca seçtiğiniz ölçütler için gösterilecek şekilde mi kısıtlayacağınızı yoksa bu hedeflemeBoyutu için tüm değerleri mi hedefleyeceğinizi ve reklamları diğer Hedefleme Boyutlarındaki hedeflemenize göre mi göstereceğinizi belirtir. true değeri, bu ölçütlerin yalnızca teklif değiştiriciler uygulayacağı ve hedeflemeyi etkilemeyacağı anlamına gelir. false değeri, bu ölçütlerin hedeflemeyi kısıtlayacağı ve teklif değiştiriciler uygulayacağı anlamına gelir.

TargetingDimension

Olası hedefleme boyutlarını açıklayan 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.
KEYWORD Anahtar kelime ölçütleri (ör. "mars deniz yolculuğu"). KEYWORD, özel teklif boyutu olarak kullanılabilir. Anahtar kelimeler her zaman bir hedefleme boyutu olduğundan "TÜMÜ" hedefi olarak ayarlanamaz daha fazla boyut seçebilirsiniz.
AUDIENCE Kullanıcı listesi, kullanıcı ilgi alanı, özel yakın ilgi alanı ve pazardaki özel gibi ölçütleri içeren kitle ölçütleri.
TOPIC İçerik kategorilerini hedeflemek için konu ölçütleri. Örneğin, "category::Hayvanlar>Evcil Hayvanlar" Görüntülü Reklam Ağı ve Video hedeflemesi için kullanılır.
GENDER Cinsiyet hedefleme ölçütleri.
AGE_RANGE Yaş grubu hedefleme ölçütleri.
PLACEMENT "www.flowers4sale.com" gibi web sitelerinin yanı sıra mobil uygulamaları, mobil uygulama kategorilerini, YouTube videolarını ve YouTube kanallarını içeren yerleşim ölçütleri.
PARENTAL_STATUS Ebeveynlik durumu hedefleme ölçütleri.
INCOME_RANGE Gelir aralığı hedefleme ölçütleri.

AdGroupAd

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" şeklindedir. biçimindedir.

labels[]

string

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

engineId

string

Harici motor hesabındaki reklamın kimliği. Bu alan yalnızca Search Ads 360 hesabı içindir (ör. Yahoo Japan, Microsoft, Baidu). Search Ads 360 olmayan varlıklar için "adGroupAd.ad.id" alanını kullanın .

engineStatus

enum (AdGroupAdEngineStatus)

Harici arama motoru hesabındaki reklamın ek durumu. Olası durumlar (harici hesabın türüne bağlı olarak) etkin, uygun, incelenmeyi bekliyor vb. 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" şeklindedir. biçimindedir.

AdGroupAdStatus

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

Sıralamalar
UNSPECIFIED Değer belirtilmedi.
UNKNOWN

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

Bu yalnızca yanıt niteliğinde bir değerdir.

ENABLED Reklam grubu reklamı etkinleştirildi.
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 niteliğinde bir değerdir.

TEXT_AD Reklam bir metin reklamdır.
EXPANDED_TEXT_AD Reklam, genişletilmiş metin reklamdır.
CALL_ONLY_AD Reklam, yalnızca telefon araması üreten bir reklamdır.
EXPANDED_DYNAMIC_SEARCH_AD Reklam bir genişletilmiş dinamik arama ağı reklamıdır.
HOTEL_AD Reklam bir otel reklamı.
SHOPPING_SMART_AD Reklam, Akıllı Alışveriş reklamıdır.
SHOPPING_PRODUCT_AD Reklam, standart bir Alışveriş reklamı.
VIDEO_AD Reklam bir video reklamdır.
GMAIL_AD Bu reklam bir Gmail reklamıdır.
IMAGE_AD Bu reklam bir resim reklamdır.
RESPONSIVE_SEARCH_AD Reklam, duyarlı arama ağı reklamıdır.
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ı.
RESPONSIVE_DISPLAY_AD Reklam, duyarlı görüntülü reklamdır.
LOCAL_AD Reklam bir yerel reklamdır.
HTML5_UPLOAD_AD Reklam, HTML5_UPLOAD_AD ürün türüne sahip bir görüntülü yükleme reklamıdır.
DYNAMIC_HTML5_AD Reklam, DYNAMIC_HTML5_* ürün türlerinden birine sahip bir görüntülü yükleme reklamıdır.
APP_ENGAGEMENT_AD Reklam bir uygulama etkileşim reklamıdır.
SHOPPING_COMPARISON_LISTING_AD Reklam, Alışveriş Karşılaştırma Girişi reklamı.
VIDEO_BUMPER_AD Bumper video reklamı.
VIDEO_NON_SKIPPABLE_IN_STREAM_AD Atlanamayan video 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.
MULTIMEDIA_AD Multimedya reklam.

SearchAds360TextAdInfo

Bir 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österilen mobil URL'si.

adTrackingId

string (int64 format)

Reklamın izleme kimliği.

SearchAds360ExpandedTextAdInfo

Search Ads 360 genişletilmiş metin reklamı.

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

string

Reklamın başlığı.

headline2

string

Reklamın ikinci başlığı.

headline3

string

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

description1

string

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

description2

string

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

path1

string

Otomatik olarak oluşturulan görünür URL'ye bir ayırıcıyla eklenen metin.

path2

string

Yol1'e ayırıcıyla eklenen metin.

adTrackingId

string (int64 format)

Reklamın izleme kimliği.

SearchAds360ResponsiveSearchAdInfo

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

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

string

Otomatik olarak oluşturulan görünür URL'ye bir ayırıcıyla eklenen metin.

path2

string

Yol1'e ayırıcıyla eklenen metin.

adTrackingId

string (int64 format)

Reklamın izleme kimliği.

SearchAds360ProductAdInfo

Bu türde alan yok.

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

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, ancak masaüstünde geçerli.
AD_GROUP_AD_TO_BE_ACTIVATED Baidu: Reklam öğesi etkinleştirilmek 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ı ve 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ıdır.

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

string

Reklam grubu öğesinin kaynak adı. AdGroupAsset kaynak adları şu şekildedir:

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

adGroup

string

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

asset

string

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

status

enum (AssetLinkStatus)

Reklam grubu öğesinin durumu.

AssetLinkStatus

Bir öğe bağlantısının durumlarını açıklayan 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.
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. Reklam Grubu Öğesi Kümesi oluşturulduğunda, bir öğe grubu bir reklam grubuna bağlanır.

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

string

Reklam grubu öğesi grubunun kaynak adı. Reklam grubu öğesi 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ı öğe grubu.

status

enum (AssetSetLinkStatus)

Reklam grubu öğesi grubunun durumu. Salt okunur.

AssetSetLinkStatus

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

Sıralamalar
UNSPECIFIED Durum belirtilmedi.
UNKNOWN Alınan değer bu sürümde bilinmiyor. Bu yalnızca yanıt niteliğinde bir değerdir.
ENABLED Öğe grubu ile kapsayıcısı arasındaki bağlantı etkinleştirildi.
REMOVED Öğe grubu ile 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 listeleri ile Arama Ağı reklamlarına yönelik yeniden pazarlama listelerinden (ARYPL) elde edilen performans verilerini içerir. Kitle düzeyinde toplu şekilde toplanır.

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

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

bidModifier

number

Ölçüt eşleştiğinde teklifin değiştiricisi. Değiştirici 0,1 - 10,0 aralığında olmalıdır. PreferredContent için aralık 1,0 - 6,0 arasındadı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)

Cihaz ölçütü.

DeviceInfo

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

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 reklam grubuna açıkça eklenen ölçütleri döndürür.

JSON gösterimi
{
  "resourceName": string,
  "creationTime": string,
  "status": enum (AdGroupCriterionStatus),
  "qualityInfo": {
    object (QualityInfo)
  },
  "type": enum (CriterionType),
  "labels": [
    string
  ],
  "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 diliminde ve "yyyy-AA-gg SS:dd:ss" şeklindedir. biçimindedir.

status

enum (AdGroupCriterionStatus)

Ölçütün durumu.

Bu, müşteri tarafından ayarlanan reklam grubu ölçütü öğesinin 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'de KALDIRILAN bir ölçüt, kullanıcı arayüzünde etkin olarak gösterilmeye devam edebilir. Örneğin, kampanyalar hariç tutulmadığı sürece varsayılan olarak tüm yaş aralıklarındaki kullanıcılara gösterilir. Kullanıcı arayüzünde, reklamları görmeye uygun oldukları için her yaş grubu "etkin" olarak gösterilir; ancak hiçbir pozitif ölçüt eklenmediği için AdGroupCriterion.status "kaldırıldı" durumunu gösterir.

qualityInfo

object (QualityInfo)

Ölçütün kalitesiyle ilgili bilgiler.

type

enum (CriterionType)

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

labels[]

string

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

positionEstimates

object (PositionEstimates)

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

finalUrls[]

string

Reklama ait 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 dışı hesaplar (ör. Yahoo Japan, Microsoft, Baidu) içindir. Google Ads varlığı için "adGroupCriterion.ölçüt_id" değerini kullanın. .

lastModifiedTime

string

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

criterionId

string (int64 format)

Ölçütün kimliği.

adGroup

string

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

negative

boolean

Ölçütün hedeflenme (false) veya hariç tutulması (true).

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

bidModifier

number

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

cpcBidMicros

string (int64 format)

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

effectiveCpcBidMicros

string (int64 format)

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

engineStatus

enum (AdGroupCriterionEngineStatus)

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

finalUrlSuffix

string

Nihai URL'ye parametreler eklemek için kullanılan 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'ın olası durumları.

Sıralamalar
UNSPECIFIED Değer belirtilmedi.
UNKNOWN

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

Bu yalnızca yanıt niteliğinde bir değerdir.

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

QualityInfo

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

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

integer

Kalite puanı.

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

CriterionType

Olası ölçüt türlerini açıklayan 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.
KEYWORD Örneğin, "mars gemisi" anahtar kelimesi.
PLACEMENT Web sitesi olarak da bilinen yerleşim (ör. "www.cicekler4indirim.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ğı'nda bir konu hedefi (örneğin, "Evcil ve Yabani Hayvanlar").
LISTING_SCOPE Hedeflenecek giriş kapsamı.
LANGUAGE Dil.
IP_BLOCK IpBlock.
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.
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 teklifine dair tahmin.

AdGroupCriterionEngineStatus

AdGroupCriterion motor durumlarını belirtir.

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 şimdi etkinleştirmeniz için hazır.
AD_GROUP_CRITERION_UNDER_REVIEW Baidu: Baidu tarafından incelenmek üzere işleniyor. Gemini: Ölçüt inceleniyor.
AD_GROUP_CRITERION_NOT_REVIEWED Baidu: İncelenecek ölçüt.
AD_GROUP_CRITERION_ON_HOLD

Kullanımdan kaldırıldı. Kullanmayın. 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 sunuluyor.
AD_GROUP_CRITERION_ACCOUNT_PAUSED Hesap duraklatıldığından ölçüt 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 kelimenin metni (en fazla 80 karakter ve 10 kelime).

KeywordMatchType

Olası Anahtar kelime eşleme türleri.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca dö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 Belirli listeleme boyutlarında ürünlerin alt bölümü. Bu düğümler, giriş girişlerini hedeflemek için sunum yapılarak kullanılmaz, ancak yalnızca ağacın yapısını tanımlamak amacıyla kullanılır.
UNIT Bir teklifi tanımlayan listeleme grubu birimi.

AgeRangeInfo

Yaş grubu ölçütü.

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

enum (AgeRangeType)

Yaş grubunun türü.

AgeRangeType

Demografik yaş gruplarının türü (ör. 18-24 yaş).

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ında olanlar.
AGE_RANGE_25_34 25-34 yaş arasında.
AGE_RANGE_35_44 35-44 yaş arasında.
AGE_RANGE_45_54 45-54 yaş arasında.
AGE_RANGE_55_64 55-64 yaş arasında.
AGE_RANGE_65_UP 65 yaş ve üzeri.
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 kaynak adı.

WebpageInfo

Reklamverenin web sitesindeki web sayfalarının hedeflenmesine ilişkin bir ölçütü temsil eder.

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

object (WebpageConditionInfo)

Web sayfası hedeflemesine ilişkin koşullar veya mantıksal ifadeler. Web sayfası hedefleme koşullarının listesi, hedefleme için değerlendirilirken birlikte değerlendirilir. Boş bir koşul listesi, kampanyanın web sitesindeki tüm sayfaların hedeflendiğini gösterir.

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

coveragePercentage

number

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

criterionName

string

Bu parametre tarafından 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 gereklidir ve UPDATE işlemlerinde yasaktır.

WebpageConditionInfo

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

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

enum (WebpageConditionOperand)

Web sayfası hedefleme koşulunda işlem yapan kişi.

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 işlem.
PAGE_TITLE Web sayfası başlığı hedefleme koşulunu belirten işlem yapan.
PAGE_CONTENT Bir web sayfası içeriği hedefleme koşulunu belirten işlem.
CUSTOM_LABEL Bir web sayfası özel etiket hedefleme koşulunu belirten İş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şittir.
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

Reklam grubu ölçütü ve 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

Reklam grubu ve etiket arasındaki ilişki.

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

string

Reklam grubu etiketinin kaynak adı. Reklam grubu etiketi 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ş grubu 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, birden fazla reklamda paylaşılabilen bir reklam parçasıdır. Bu bir resim (ImageAsset), video (YouTubeVideoAsset) vb. olabilir. Öğeler değiştirilemez ve kaldırılamaz. Bir öğenin yayınlanmasını durdurmak için öğeyi kullandığı öğ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 kaynak adları şu biçimdedir:

customers/{customerId}/assets/{assetId}

type

enum (AssetType)

Öğenin türü.

finalUrls[]

string

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

status

enum (AssetStatus)

Öğenin durumudur.

creationTime

string

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

lastModifiedTime

string

Bu öğenin son değiştirildiği tarih ve saat. Tarih ve saat, müşterinin saat dilimindedir ve "yyyy-AA-gg SS:dd:ss.ssssss" şeklindedir. 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 spesifik türü. asset_data şunlardan yalnızca biri olabilir:
youtubeVideoAsset

object (YoutubeVideoAsset)

YouTube video öğesi.

imageAsset

object (ImageAsset)

Resim öğesi

textAsset

object (TextAsset)

Metin öğesi.

calloutAsset

object (UnifiedCalloutAsset)

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

pageFeedAsset

object (UnifiedPageFeedAsset)

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

mobileAppAsset

object (MobileAppAsset)

Mobil uygulama öğesi.

callAsset

object (UnifiedCallAsset)

Birleştirilmiş telefon öğesi.

callToActionAsset

object (CallToActionAsset)

Harekete geçirici mesaj öğesi.

locationAsset

object (UnifiedLocationAsset)

Birleştirilmiş yer öğesi

AssetType

Olası öğe türlerini açıklayan 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.
YOUTUBE_VIDEO YouTube video öğesi.
MEDIA_BUNDLE Medya paketi öğesi.
IMAGE Resim öğesi.
TEXT Metin öğesi.
LEAD_FORM Potansiyel müşteri formu öğesi.
BOOK_ON_GOOGLE Google'da Rezervasyon öğesi.
PROMOTION Promosyon öğesi.
CALLOUT Açıklama metni öğesi.
STRUCTURED_SNIPPET Ek açıklamalı snippet öğesi.
PAGE_FEED Sayfa feed'i öğesi.
DYNAMIC_EDUCATION Dinamik Eğitim öğesi.
MOBILE_APP Mobil uygulama öğesi.
HOTEL_CALLOUT Otel açıklama metni öğesi.
CALL Telefon öğesi.
PRICE Fiyat öğesi.
CALL_TO_ACTION Harekete geçirici mesaj öğesi.
DYNAMIC_REAL_ESTATE Dinamik gayrimenkul öğesi.
DYNAMIC_CUSTOM Dinamik özel öğe.
DYNAMIC_HOTELS_AND_RENTALS Dinamik otel ve kiralık yer öğesi.
DYNAMIC_FLIGHTS Dinamik uçuşlar öğesi.
DYNAMIC_TRAVEL Dinamik seyahat öğesi.
DYNAMIC_LOCAL Dinamik yerel öğe.
DYNAMIC_JOBS Dinamik işler öğesi.
LOCATION Yer öğesi.
HOTEL_PROPERTY Otel mülk öğesi.

AssetStatus

Bir öğenin olası durumları.

Sıralamalar
UNSPECIFIED Durum belirtilmedi.
UNKNOWN Alınan değer bu sürümde bilinmiyor. Bu yalnızca yanıt niteliğinde bir değerdir.
ENABLED Öğe etkinleştirildi.
REMOVED Öğe kaldırıldı.
ARCHIVED Öğe arşivlendi.
PENDING_SYSTEM_GENERATED Kullanıcı incelemesi beklemede olan öğe, sistem tarafından oluşturulmuş.

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.
SERVING_LIMITED Öğe etkin ve sınırlı durumda.
DISAPPROVED Öğe onaylanmadı (uygun değil).
DISABLED Öğe etkin değil (beklemede).
REMOVED Öğe kaldırıldı.

YoutubeVideoAsset

YouTube öğesi.

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

string

YouTube video başlığı.

youtubeVideoId

string

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

ImageAsset

Resim öğesi.

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

enum (MimeType)

Resim öğesinin MIME türü.

fullSize

object (ImageDimension)

Bu resmin orijinal 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 niteliğinde bir değerdir.

IMAGE_JPEG Resmin/jpeg'in MIME türü.
IMAGE_GIF Resmin/gif'in MIME türü.
IMAGE_PNG Resim/png'nin MIME türü.
FLASH uygulamasının/x-shockwave-flash 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 Uygulamanın/vnd.ms-excel'in MIME türü.
RTF Uygulamanın/rtf'nin MIME türü.
AUDIO_WAV Ses/wav'ın MIME türü.
AUDIO_MP3 Ses/mp3'ün MIME türü.
HTML5_AD_ZIP uygulamasının/x-html5-ad-zip uygulamasının MIME türü.

ImageDimension

Belirli bir boyuttaki resmin (orijinal veya yeniden boyutlandırılmış) 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ükseklik ve genişliğe sahip resmi döndüren 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 dize, 1 ile 25 arasında (1 ve 25 dahil) olmalıdır.

startDate

string

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

endDate

string

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

adScheduleTargets[]

object (AdScheduleInfo)

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

useSearcherTimeZone

boolean

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

AdScheduleInfo

Bir AdSchedule ölçütünü temsil eder.

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

Aynı gün için en fazla altı Reklam Zaman Planlaması 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 dakika sonra.

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

endMinute

enum (MinuteOfHour)

Bu programın sona erdiği bitiş saatinden sonraki dakika sayısı. Programa bitiş dakikası dahil değildir.

Bu alan CREATE işlemleri için gereklidir 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 gereklidir ve UPDATE işlemlerinde yasaktır.

startHour

integer

24 saat sonra başlangıç saati. Bu alan, 0 ile 23 arasında (0 ve 23 dahil) olmalıdır.

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

endHour

integer

24 saatlik süre içinde 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 gereklidir ve UPDATE işlemlerinde yasaktır.

MinuteOfHour

Çeyrek saatlik numaralandırmalar. Örneğin, "ONIFTEEN"

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

HaftanınGünü

Haftanın günlerini belirtir (örneğin, "Monday").

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ının ilk satırı. Ayarlanırsa uzunluk 1 ile 35 arasında (1 ve 35 dahil) olmalı ve açıklama2 de ayarlanmalıdır.

description2

string

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

startDate

string

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

endDate

string

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

adScheduleTargets[]

object (AdScheduleInfo)

Öğenin sunulabileceği tüm zaman aralıklarını belirten çakışmayan planların listesi. 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 geçerlidir.

useSearcherTimeZone

boolean

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

mobilePreferred

boolean

Tercihin, site bağlantısı öğesinin mobil cihazlarda görüntülenecek olup olmadığı. 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

Bir mobil uygulamayı temsil eden öğe.

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

string

Zorunlu. Bir mobil uygulamayı benzersiz şekilde tanımlayan bir dize. Yalnızca "com.android.ebay" gibi platformun yerel kimliğini içermelidir. Android veya "12345689" için .

appStore

enum (MobileAppVendor)

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

MobileAppVendor

Mobil uygulama tedarikçi firması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'un mobil uygulama satıcısı.
GOOGLE_APP_STORE Google App Store'un mobil uygulama satıcısı.

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", "bize".

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ı, hesap düzeyindeki ayarı uygulaması veya telefon araması dönüşümünü devre dışı bırakması gerektiğini belirtir.

callConversionAction

string

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 yalnızca, callConversionReportingState durumu, USE_SOURCE_LEVEL_CALL_CONVERSION_ACTION olarak ayarlanırsa etkili olur.

adScheduleTargets[]

object (AdScheduleInfo)

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

callOnly

boolean

Aramada, web sitesinin bağlantısı olmadan yalnızca telefon numarası gösterilip gösterilmeyeceğini belirler. 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 kullanıcısının saat diliminde gösterilip gösterilmeyeceğini belirler. Microsoft Ads için geçerlidir.

startDate

string

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

endDate

string

Bu öğenin etkili olduğu ve yayınlanmaya 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 ayarlanan telefon araması dönüşümü türünü kullanır.
USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION Telefon araması dönüşüm işlemi, kaynak (yalnızca telefon araması üreten reklamlar/telefon uzantıları) düzeyinde ayarlanan telefon araması dönüşümü türünü kullanır.

CallToActionAsset

Harekete geçirici mesaj öğesi.

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

enum (CallToActionType)

Harekete geçirici mesaj.

CallToActionType

Olası harekete geçirici mesaj türlerini açıklayan 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.
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ü şimdi uygulanır.
SIGN_UP Harekete geçirici mesaj türü kayıttır.
CONTACT_US Harekete geçirici mesaj türü "bize ulaşın" şeklindedir.
SUBSCRIBE Harekete geçirici mesaj türü "Abone ol"dur.
DOWNLOAD Harekete geçirici mesaj türü, indirmedir.
BOOK_NOW Harekete geçirici mesaj türü "hemen rezervasyon yap" şeklindedir.
SHOP_NOW Harekete geçirici mesaj türü "hemen satın alın"dır.
BUY_NOW Harekete geçirici mesaj türü "Hemen satın alın"dır.
DONATE_NOW Harekete geçirici mesaj türü "Şimdi bağış yap"dır.
ORDER_NOW Harekete geçirici mesaj türü "hemen sipariş" şeklindedir.
PLAY_NOW Harekete geçirici mesaj türü, şimdi oynatılıyor.
SEE_MORE Harekete geçirici mesaj türü, "daha fazla göster"dir.
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" şeklindedir.

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 ş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 bilgi 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şine sahip olabilirsiniz.

locationOwnershipType

enum (LocationOwnershipType)

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

BusinessProfileLocation

İşletme Profili konum verileri bağlı İşletme Profili hesabından senkronize edilir.

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

string

Reklamveren, İşletme Profili hesabında konum için belirtilen etiketi. Bu işlem, İşletme Profili hesabından senkronize edilir.

storeCode

string

Bu konumun İşletme Profili mağaza kodu. Bu işlem, İş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 Yerin İş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 eklediğinizde, bir öğeyi öğe grubuna bağlar.

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

string

Öğe grubu öğesinin kaynak adı. Öğe grubu öğe kaynak 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ı. Ö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 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.
HEADLINE Öğe, başlık olarak kullanılmak üzere bağlanmış.
DESCRIPTION Öğe, açıklama olarak kullanılmak üzere bağlanmış.
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ış.
BOOK_ON_GOOGLE Öğe, otel kampanyasının "Google'da Rezervasyon" olduğunu gösterecek şekilde bağlantılıdır etkin.
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ğlanmış.
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ışında logo olarak kullanılmak üzere bağlanmış.
CALL_TO_ACTION_SELECTION Öğe, harekete geçirici mesaj seçmek için bağlanmış.
AD_IMAGE Öğe, reklam resmi seçmek için kullanılmak üzere bağlanmış.
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. Bir sinyalin varlığı, Maksimum Performans kampanyasına dönüşüm gerçekleştirme olasılığı en yüksek olanı 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 bu 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 kaynak adı şu biçimdedir:

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

assetGroup

string

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

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

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

assetGroup

string

Bu öğe grubu listeleme grubu filtresinin dahil olduğu öğe grubu.

id

string (int64 format)

ListingGroupFilter'in 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ı sektöre 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 null.

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ı liste boyutlarıyla birlikte ürünlerin alt bölümleri.
UNIT_INCLUDED Dahil edilen bir listeleme grubu filtre yaprak düğümü.
UNIT_EXCLUDED Hariç tutulan bir listeleme grubu filtre 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 filtresi için boyutları listeleme.

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 birinin boyutu her zaman mevcuttur. dimension şunlardan yalnızca biri olabilir:
productBiddingCategory

object (ProductBiddingCategory)

Ürün teklifinin teklif verme kategorisi.

productBrand

object (ProductBrand)

Ürün teklifinin markası.

productChannel

object (ProductChannel)

Ürün teklifinin bulunduğu konum.

productCondition

object (ProductCondition)

Bir ürün teklifinin durumudur.

productCustomAttribute

object (ProductCustomAttribute)

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

productItemId

object (ProductItemId)

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

productType

object (ProductType)

Ürün teklifinin türü.

ProductBiddingCategory

Teklif kategorisinin belirli bir düzeydeki öğesi. Üst düzey kategoriler 1. düzeyde, alt öğeleri de 2. düzeydedir. Şu anda 5 seviyeye kadar destek veriyoruz. Kullanıcı, kategorinin düzeyini belirten bir boyut türü belirtmelidir. Aynı alt bölümdeki tüm durumlar aynı boyut türüne (kategori düzeyinde) sahip olmalıdır.

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

enum (ListingGroupFilterBiddingCategoryLevel)

Sınıflandırmadaki kategorinin düzeyini belirtir.

id

string (int64 format)

Ürün teklif kategorisinin kimliği.

Bu kimlik, şu makalede açıklanan google_product_category 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. Düzey.
LEVEL3 3. Düzey.
LEVEL4 4. Düzey.
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 konum.

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

enum (ListingGroupFilterProductChannel)

Konumun değeri.

ListingGroupFilterProductChannel

Bir ürün teklifinin konumunu açıklayan 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.
ONLINE Ürün internet üzerinden satılmıştır.
LOCAL Öğe yerel mağazalarda satılır.

ProductCondition

Bir ü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 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.
NEW Ürünün durumu yenidir.
REFURBISHED Ürün yenilenmiş durumda.
USED Ürün durumu kullanılır.

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 grubu filtresi özel özelliği.
INDEX3 Dördüncü listeleme grubu filtresi özel özellik.
INDEX4 Beşinci listeleme grubu filtresi özel özellik.

ProductItemId

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

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

string

Kimliğin değeri.

ProductType

Ürün teklifinin türü.

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

enum (ListingGroupFilterProductTypeLevel)

Türün düzeyi.

value

string

Türün değeri.

ListingGroupFilterProductTypeLevel

Ürün teklifi türü seviyesini açıklayan 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.
LEVEL1 1. Düzey:
LEVEL2 2. Düzey.
LEVEL3 3. Düzey.
LEVEL4 4. Düzey.
LEVEL5 5. Seviye.

ListingGroupFilterDimensionPath

Listeleme grubu filtresini tanımlayan boyutların tanımlandığı yol.

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

object (ListingGroupFilterDimension)

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

AssetGroupTopCombinationView

Reklam grubu reklam öğesi kombinasyonunun kullanımına yönelik 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 kombinasyonu 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 sunulan 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 niteliğinde 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ılıyor demektir.
HEADLINE Öğe bir başlıkta kullanıldı. Bunu yalnızca reklamda tek bir başlık varsa kullanın. Aksi halde HEADLINE_1, HEADLINE_2 veya HEADLINE_3 enumlarını kullanın
HEADLINE_IN_PORTRAIT Öğe, dikey resimde başlık olarak kullanılmıştır.
LONG_HEADLINE Öğe, uzun bir başlıkta kullanıldı (MultiAssetUyumluReklam'da kullanıldı).
DESCRIPTION Öğe bir açıklamada kullanıldı. 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ılmıştır.
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ıştır.
YOU_TUBE_VIDEO Öğe bir YouTube videosu olarak kullanıldı.
CALL Bu öğe arama olarak kullanılıyor.
MOBILE_APP Bu öğe mobil uygulama olarak kullanılıyor.
CALLOUT Bu öğe açıklama metni olarak kullanılıyor.
STRUCTURED_SNIPPET Bu öğe ek açıklamalı snippet olarak kullanılıyor.
PRICE Bu öğe fiyat olarak kullanılıyor.
PROMOTION Bu öğe promosyon olarak kullanılıyor.
AD_IMAGE Bu öğe resim olarak kullanılıyor.
LEAD_FORM Öğe, potansiyel müşteri formu olarak kullanılıyor.

AssetGroup

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

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

string

Öğe grubunun kaynak adı. Öğe grubu kaynak adları şu şekildedir:

customers/{customerId}/assetGroups/{asset_group_id}

id

string (int64 format)

Öğe grubunun kimliğidir.

campaign

string

Bu öğe grubunun ilişkili olduğu kampanya. Öğe grubuna bağlı öğedir.

name

string

Zorunlu. Öğe grubunun adı. Zorunlu. Açıklama uzunluğu en az 1, maksimum 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ıkça URL'ler varsayılan olarak genişletme için uygundur.

finalMobileUrls[]

string

Tüm alanlar arası yönlendirmelerden sonraki mobil nihai URL'lerin listesi. Maksimum Performans kampanyalarında, devre dışı bırakılmadıkça URL'ler varsayılan olarak genişletme için uygundur.

status

enum (AssetGroupStatus)

Öğe grubunun durumudur.

path1

string

Reklamın reklamda görüntülenen URL'ye eklenmiş görünebilecek ilk bölümü.

path2

string

Reklamda görüntülenen URL'ye eklenmiş görünebilecek ikinci metin bölümü. Bu alan yalnızca yol1 ayarlandığında ayarlanabilir.

adStrength

enum (AdStrength)

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

AssetGroupStatus

Bir öğe grubunun olası durumları.

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

AdStrength

Olası reklam gücü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.
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 eklemek, bir öğe grubuna sahip öğeyi bağlar.

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

string

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

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

assetSet

string

Bu öğe grubu öğesinin bağlantı oluşturduğu öğe grubudur.

asset

string

Bu öğe grubu öğesinin bağlantı oluşturduğu öğe.

status

enum (AssetSetAssetStatus)

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

AssetSetAssetStatus

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

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

AssetSet

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

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

string (int64 format)

Öğe grubunun kimliği.

resourceName

string

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

customers/{customerId}/assetSets/{asset_set_id}

BiddingStrategy

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ı belirleyerek 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üşterilerindeki teklif stratejileri için bu para birimi, oluşturma sırasında ayarlanabilir ve varsayılan olarak yönetici müşterinin para birimine ayarlanır. Hizmet veren müşterilere yönelik bu alan ayarlanamaz; hizmet veren bir müşteriye yönelik tüm stratejiler, hizmet veren müşterinin para birimini dolaylı olarak kullanır. Her durumdaeffectiveCurrencyCode alanı strateji tarafından kullanılan para birimini döndürür.

id

string (int64 format)

Teklif stratejisinin kimliği.

name

string

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

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

effectiveCurrencyCode

string

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

Yönetici müşterilerideki teklif stratejileri için reklamveren tarafından stratejiyi oluştururken ayarlanan para birimidir. Müşterilere hizmet vermek için bu, müşterinin currencyCode değeridir.

Teklif stratejisi metrikleri bu para biriminde raporlanır.

Bu alan salt okunurdur.

campaignCount

string (int64 format)

Bu teklif stratejisine eklenen kampanyaların sayısıdır.

Bu alan salt okunurdur.

nonRemovedCampaignCount

string (int64 format)

Bu teklif stratejisine eklenen kaldırılmamış kampanyaların sayısı.

Bu alan salt okunurdur.

Birleştirme alanı scheme. Teklif şeması.

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, daha düşük olasılıklı görünen tıklamalar için ise düşüren bir teklif stratejisidir.

maximizeConversionValue

object (MaximizeConversionValue)

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

maximizeConversions

object (MaximizeConversions)

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

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 gösterim yüzdesi için otomatik olarak optimizasyon yapan bir teklif stratejisidir.

targetOutrankShare

object (TargetOutrankShare)

Reklamverenin belirli bir rakibi geçmesi gereken açık artırmaların hedef oranına göre teklifler ayarlayan bir teklif stratejisidir. Bu alan kullanımdan kaldırılmıştır. Bu alanla yeni bir teklif stratejisi oluşturmak veya bir kampanyaya bu alanla teklif stratejileri eklemek başarısız olur. Bu şemanın zaten doldurulduğu stratejilerde yapılan değişikliklere izin verilir.

targetRoas

object (TargetRoas)

Belirli bir hedef reklam harcamalarından elde edilen gelir (ROAS) elde ederken gelirinizi 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

Bir 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 niteliğinde bir değerdir.

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

BiddingStrategyType

Olası teklif stratejisi türlerini açıklayan 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.
COMMISSION Komisyon, reklamverenin dönüşüm değerinin belirli bir kısmını ödediği 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ükselten, daha düşük olası tıklamalar için ise düşüren bir teklif stratejisidir.
INVALID Yalnızca döndürülen değer için kullanılır. Kampanyanın teklif stratejisi olmadığını belirtir. Bu durum, kampanyanın yayınlanmasını engeller. Örneğin, kampanya yönetici teklif stratejisine eklenebilir ve reklam sunma hesabının yönetici hesabıyla bağlantısı kaldırılır. Bu durumda, kampanya otomatik olarak artık erişilemez durumda olan 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şlem başına teklifi ayarlamasına olanak tanıyan manuel teklif verme stratejisi.
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österime dayalı teklif.
MANUAL_CPV Video görüntüleme başına yapılandırılabilir bir tutar ödeyen bir teklif stratejisidir.
MAXIMIZE_CONVERSIONS Belirli bir 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çeniz harcanırken 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 sayfadaki veya birinci sayfadaki tanıtılan alanlarda gösterimleri hedefleyecek şekilde ayarlayan Sayfa Bir Tanıtılan teklif şeması. Bu sıralama değerinin desteği sonlandırıldı.
PERCENT_CPC TBM Yüzdesi, tekliflerin bir ürün veya hizmet için reklamı yapılan fiyatın oranı olan 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 teklifleri ayarlayan otomatik teklif stratejisidir.
TARGET_CPM Hedef BGBM, belirlediğiniz bin gösterim başına maliyet (BGBM) hedefiyle mümkün olduğunca fazla gösterim elde etmenize yardımcı olacak şekilde teklifleri 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 konumda) en üstünde gösterilecek şekilde ayarlayan bir otomatik teklif stratejisidir.
TARGET_OUTRANK_SHARE Hedef Geçiş Payı, reklamverenin belirli bir rakibi geçmesi gerektiğini açık artırmaların hedef oranına göre belirleyen otomatik teklif stratejisidir. Bu sıralama değerinin desteği sonlandırıldı.
TARGET_ROAS Hedef ROAS, belirli bir ortalama ROAS (Reklam Harcamalarından Elde Edilen Gelir) hedefiyle ortalama olarak gelirinizi en üst düzeye çıkarmanıza yardımcı olan bir 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, daha düşük olasılıklı görünen tıklamalar için ise düşüren bir otomatik teklif stratejisidir.

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

MaximizeConversionValue

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

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

string (int64 format)

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

cpcBidFloorMicros

string (int64 format)

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

targetRoas

number

Reklam harcamalarından elde edilen gelir (ROAS) hedefi seçeneği. Ayarlanırsa teklif stratejisi, hedef reklam harcamalarından elde edilen gelir ortalamasını alırken geliri en üst düzeye çıkarır. Hedef ROAS yüksekse teklif stratejisi bütçenin tamamını harcayamayabilir. Hedef ROAS ayarlanmazsa teklif stratejisi, bütçe için 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ı olacak bir otomatik teklif stratejisi

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

string (int64 format)

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

cpcBidFloorMicros

string (int64 format)

Teklif stratejisi tarafından ayarlanabilecek minimum teklif sınırı. Bu sınır, strateji tarafından yönetilen tüm anahtar kelimeler için geçerlidir. Yalnızca portföy teklifi stratejileri için değiş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 hedefiyle veya bu değerin altında kalarak 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 buna eşit olmalıdır.

cpcBidCeilingMicros

string (int64 format)

Teklif stratejisi tarafından ayarlanabilecek maksimum teklif sınırı. Bu sınır, strateji tarafından yönetilen tüm anahtar kelimeler için geçerlidir. Bu değer 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ı. Bu sınır, strateji tarafından yönetilen tüm anahtar kelimeler için geçerlidir. Bu değer 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 konumda) en üstünde gösterilecek şekilde ayarlayan bir otomatik teklif stratejisidir.

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

enum (TargetImpressionShareLocation)

Arama sonuçları sayfasında hedeflenen konum.

locationFractionMicros

string (int64 format)

Hedeflenen konumda mikrosaniye cinsinden gösterilecek reklam oranı. Örneğin, %1 10.000'e eşittir.

cpcBidCeilingMicros

string (int64 format)

Otomatik teklif sisteminin belirtmesine izin verilen en yüksek TBM teklifidir. Bu, tavanı ayarlayan ve yerel mikro düzeyde belirtilen reklamveren tarafından girilen zorunlu bir alandır.

TargetImpressionShareLocation

Olası hedefleri açıklayan 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.
ANYWHERE_ON_PAGE Web sayfasındaki herhangi bir konum.
TOP_OF_PAGE Üst reklam kutusu.
ABSOLUTE_TOP_OF_PAGE Üst reklam kutusunda üst alan.

TargetOutrankShare

Reklamverenin belirli bir rakibi geçmesi gereken açık artırmaların hedef oranına göre teklifler belirleyen bir 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ı. Bu sınır, strateji tarafından yönetilen tüm anahtar kelimeler için geçerlidir.

TargetRoas

Belirli bir hedef ROAS (reklam harcamalarından elde edilen gelir) ortalaması alarak gelirinizi 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 göre). Değer, 0,01 ile 1000,0 dahil bu sayılar arasında olmalıdır.

cpcBidCeilingMicros

string (int64 format)

Teklif stratejisi tarafından ayarlanabilecek maksimum teklif sınırı. Bu sınır, strateji tarafından yönetilen tüm anahtar kelimeler için geçerlidir. Bu değer 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ı. Bu sınır, strateji tarafından yönetilen tüm anahtar kelimeler için geçerlidir. Bu değer 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 bir otomatik teklif stratejisidir.

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

string (int64 format)

Kullanımdan kaldırıldı: Tıklamaları en üst düzeye çıkarmak için gereken harcama hedefi. Hedef Harcama teklifi veren, bu değerden veya doğal kısıtlama harcama tutarından daha küçük olanı harcamaya çalışır. Belirtilmezse bütçe, harcama hedefi olarak kullanılır. Bu alan kullanımdan kaldırıldığı için artık kullanılmamalıdır. Ayrıntılı bilgi için https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html sayfasına göz atın.

cpcBidCeilingMicros

string (int64 format)

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

CampaignBudget

Kampanya bütçesi.

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

string

Kampanya bütçesinin kaynak adı. Kampanya bütçe kaynağı adları şu şekildedir:

customers/{customerId}/campaignBudgets/{campaign_budget_id}

deliveryMethod

enum (BudgetDeliveryMethod)

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

Oluşturma işleminde belirtilmemişse varsayılan olarak STANDART değerine ayarlanır.

period

enum (BudgetPeriod)

Bütçenin harcanacağı dönem. Belirtilmezse varsayılan olarak DAILY değerine ayarlanır.

amountMicros

string (int64 format)

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

BudgetDeliveryMethod

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

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

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 kullanılabilir.

Kampanya

Bir 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 şekildedir:

customers/{customerId}/campaigns/{campaign_id}

status

enum (CampaignStatus)

Kampanyanın durumu.

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

servingStatus

enum (CampaignServingStatus)

Kampanyanın reklam sunma durumu.

biddingStrategySystemStatus

enum (BiddingStrategySystemStatus)

Kampanyanın teklif stratejisinin sistem durumu.

adServingOptimizationStatus

enum (AdServingOptimizationStatus)

Kampanyanın reklam sunma optimizasyon durumu.

advertisingChannelType

enum (AdvertisingChannelType)

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

Bu alan zorunludur ve yeni kampanya oluştururken 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ı ayrıntılandırma. Üst kanal türünün 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şlemelerin listesi.

realTimeBiddingSetting

object (RealTimeBiddingSetting)

Yalnızca Ad Exchange ağını hedefleyen kampanyalarda kullanılabilen Gerçek Zamanlı Teklif Verme özelliğinin 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)

Reklam coğrafi hedefleme ayarı.

labels[]

string

Bu kampanyaya ekli etiketlerin kaynak adları.

biddingStrategyType

enum (BiddingStrategyType)

Teklif stratejisinin türü.

Teklif stratejisi, standart teklif stratejisi oluşturmak için teklif şeması veya portföy teklif stratejisi oluşturmak için biddingStrategy alanı ayarlanarak oluşturulabilir.

Bu alan salt okunurdur.

accessibleBiddingStrategy

string

"Teklif Stratejisi" ile tanımlanan, ekli portföy teklifi stratejisinin kısıtlanmamış özelliklerinin salt okunur görünümü olan Accessible Biddingstrateji'nin kaynak adı. 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 Accessible Biddingstrateji kaynağından okunur. Öte yandan, 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 BiddingStrateji kaynağından okunabilir.

frequencyCaps[]

object (FrequencyCapEntry)

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

selectiveOptimization

object (SelectiveOptimization)

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

optimizationGoalSetting

object (OptimizationGoalSetting)

Bu kampanya için bir dizi optimizasyon hedefi türünü içeren optimizasyon hedefi ayarı.

trackingSetting

object (TrackingSetting)

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

engineId

string

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

excludedParentAssetFieldTypes[]

enum (AssetFieldType)

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

createTime

string

Bu kampanyanın oluşturulduğu zaman damgası. Zaman damgası müşterinin saat diliminde ve "yyyy-AA-gg SS:dd:ss" şeklindedir. biçimindedir. createTime desteği v1 sürümünde sonlandırılacaktır. Bunun yerine generateTime'ı kullanın.

creationTime

string

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

lastModifiedTime

string

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

id

string (int64 format)

Kampanyanın kimliği.

name

string

Kampanyanın adı.

Bu alan zorunludur ve yeni kampanya oluştururken boş bırakılmamalıdır.

Boş değer (kod noktası 0x0), yeni satır sonu (kod noktası 0xA) veya satır başı karakteri (kod noktası 0xD) karakter 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

Müşterinin saat diliminde YYYY-AA-GG biçiminde yayınlanan son günü. Oluşturma sırasında varsayılan olarak 30.12.2037 değerini alı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 izlemeyle sunulan açılış sayfalarına sorgu parametreleri eklemek için kullanılan son ek.

urlExpansionOptOut

boolean

Daha iyi hedeflenmiş URL'lere 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ğerin false (yanlış) olduğu Maksimum Performans kampanyaları için ayarlanabilir.

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

Kampanyaya yerleştirilmiş portföy (Biddingstrateji hizmeti ile oluşturulmuş) veya standart olmalıdır. campaign_bidding_strategy şunlardan yalnızca biri olabilir:

biddingStrategy

string

Kampanyada kullanılan portföy teklifi stratejisi.

manualCpa

object (ManualCpa)

Standart Manuel EBM teklif stratejisi. Reklamverenin, reklamveren tarafından belirtilen işlem başına teklifi ayarlamasına olanak tanıyan manuel teklif verme stratejisi. Yalnızca Yerel Hizmetler kampanyaları için desteklenir.

manualCpc

object (ManualCpc)

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

manualCpm

object (ManualCpm)

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

maximizeConversions

object (MaximizeConversions)

Bütçeniz harcanırken dönüşüm sayısını otomatik olarak artıran Standart dönüşümleri artırma teklif stratejisidir.

maximizeConversionValue

object (MaximizeConversionValue)

Bütçeniz harcanırken 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)

Standart Hedef EBM teklif stratejisi, 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 belirler.

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)

Belirli bir hedef ROAS (reklam harcamalarından elde edilen gelir) ortalamasını alırken geliri otomatik olarak en üst düzeye çıkaran Standart Hedef ROAS teklif stratejisi.

targetSpend

object (TargetSpend)

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

percentCpc

object (PercentCpc)

Tekliflerin bir ürün veya hizmet için reklamı yapılan fiyatın oranı olan Standart TBM Yüzdesi teklif stratejisi.

targetCpm

object (TargetCpm)

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

CampaignStatus

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 etkindir ve reklam gösterebilir.
PAUSED Kampanya, kullanıcı tarafından duraklatıldı.
REMOVED Kampanya kaldırıldı.

CampaignServingStatus

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 niteliğinde 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 Beklenmeyen bir hata oluştuğunu (ör. teklif stratejisi türü veya durum bilgisi bulunamadı) belirten sinyaller.
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 yeniden etkinleştirildiği için öğrenme aşamasındadır.
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 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 raporlarına ve müşterinin yakın zamanda teklif stratejisiyle alakalı olan dönüşüm türlerini değiştirdiğine bağlıdır.
LEARNING_CONVERSION_SETTING_CHANGE Teklif stratejisi, dönüşüm raporları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çen hafta boyunca yeterli dönüşüm trafiği olmadığından teklif stratejisi sınırlı.
LIMITED_BY_BUDGET Bu teklif stratejisindeki anahtar kelimelerin önemli bir bölümü 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ının Kalite Puanı düşük.
LIMITED_BY_INVENTORY Teklif stratejisi, dar hedefleme nedeniyle bütçesini tam olarak harcayamaz.
MISCONFIGURED_ZERO_ELIGIBILITY SSC için dönüşüm izleme eksik (ping yok) ve/veya yeniden pazarlama listeleri.
MISCONFIGURED_CONVERSION_TYPES Teklif stratejisi dönüşüm raporlamaya bağlıdır ve müşteride bu stratejiye göre raporlanabilecek dönüşüm türleri eksiktir.
MISCONFIGURED_CONVERSION_SETTINGS Teklif stratejisi, dönüşüm raporlamasını temel alıyor ve müşterinin dönüşüm ayarları hatalı yapılandırılmış.
MISCONFIGURED_SHARED_BUDGET Teklif stratejisinin dışında, stratejide yer alan kampanyalarla bütçe paylaşan kampanyalar varsa.
MISCONFIGURED_STRATEGY_TYPE Kampanya, geçersiz bir strateji türüne sahip ve yayınlanmıyor.
PAUSED Teklif stratejisi etkin değil. Teklif stratejisine bağlı etkin kampanya, reklam grubu veya anahtar kelime yok. Teklif stratejisine bağlı etkin bütçe yoksa
UNAVAILABLE Bu teklif stratejisi şu anda durum raporlamasını desteklemiyor.
MULTIPLE_LEARNING Söz konusu dönemde bu teklif stratejisi için birden fazla LEARNING_* sistem durumu vardı.
MULTIPLE_LIMITED Söz konusu dönemde bu teklif stratejisi için birden çok 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 vardı.

AdServingOptimizationStatus

Olası yayınlama durumlarını açıklayan sıralama.

Sıralamalar
UNSPECIFIED Değer belirtilmedi.
UNKNOWN

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

Bu yalnızca yanıt niteliğinde bir değerdir.

OPTIMIZE Reklam sunumu, kampanyanın TO'suna göre optimize edilir.
CONVERSION_OPTIMIZE Reklam sunumu, kampanyanın TO * dönüşümü temel alınarak 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, ardından 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 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.
SEARCH Arama Ağı'nı seçin. Gruplandırılmış Görüntülü Reklam Ağı kampanyalarını ve Arama+ 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 fazla kanalda yayınlanan uygulama kampanyaları ve etkileşime yönelik uygulama kampanyaları.
LOCAL Yerel reklam kampanyaları.
SMART Akıllı kampanyalar.
PERFORMANCE_MAX Maksimum Performans kampanyaları.
LOCAL_SERVICES Yerel Hizmet kampanyaları.
DISCOVERY Discovery kampanyaları.
TRAVEL Seyahat kampanyaları.
SOCIAL Sosyal kampanyalar.

AdvertisingChannelSubType

Farklı kanal alt türlerini açıklayan sıralama.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca dönüş değeri olarak kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
SEARCH_MOBILE_APP Arama Ağı için mobil uygulama kampanyaları
DISPLAY_MOBILE_APP Görüntülü Reklam Ağı için mobil uygulama kampanyaları.
SEARCH_EXPRESS Arama Ağı'na yönelik 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 Video 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ğı da 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ğı da dahil olmak üzere Google'ın en önemli birçok mülkünde uygulamayla yeniden etkileşimi artırmaya odaklanan etkileşime yönelik Uygulama Kampanyası.
LOCAL_CAMPAIGN Yerel reklamcılık için özel kampanyalar.
SHOPPING_COMPARISON_LISTING_ADS Alışveriş ürün karşılaştırma kampanyaları.
SMART_CAMPAIGN Standart Akıllı kampanyalar.
VIDEO_SEQUENCE Sıra video reklamlara sahip 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ını tanıtmak için özel olarak hazırlanmış ön kayıt amaçlı Uygulama Kampanyası.
VIDEO_REACH_TARGET_FREQUENCY Hedef sıklık teklif stratejisinin kullanıldığı video erişim kampanyası.
TRAVEL_ACTIVITIES Seyahat Aktiviteleri kampanyaları.
SOCIAL_FACEBOOK_TRACKING_ONLY Facebook'ta yalnızca sosyal medya kampanyalarını izleme.

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 etiketi 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 özelliğinin 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 öğesinin de true olması gerekir).

targetContentNetwork

boolean

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

targetPartnerSearchNetwork

boolean

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

DynamicSearchAdsSetting

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

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

string

Zorunlu. Bu ayarın temsil ettiği internet alan adı. Örneğin, "google.com" veya "www.google.com" adresini ziyaret edin.

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ı. Kampanya tarafından reklamı yapılabilecek ürün evrenini ve bu kampanyanın diğer Alışveriş kampanyalarıyla nasıl etkileşime girdiğini 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ılırsa feedLabel alanı aynı biçimde ülke kodlarını kabul eder, örneğin: "XX". Aksi takdirde, Google Merchant Center'da feed etiketi için kullanılan herhangi bir dize olabilir.

useVehicleInventory

boolean

Araç girişi 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ı için değiştirilemez.

salesCountry

string

Kampanyaya dahil edilecek ürünlerin satışa sunulduğu ülke.

campaignPriority

integer

Kampanyanın önceliği. Sayısal olarak daha yüksek önceliğe sahip kampanyalar, düşük önceliğe sahip olanlara göre önceliklidir. Bu alan, 0 ile 2 arasında (0 ve 2 dahil) değerler olan Alışveriş kampanyaları için zorunludur. 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 eklenip eklenmeyeceğini belirtir.

GeoTargetTypeSetting

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

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

enum (PositiveGeoTargetType)

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

negativeGeoTargetType

enum (NegativeGeoTargetType)

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

PositiveGeoTargetType

Olası pozitif coğrafi hedef türleri.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Değer bu sürümde bilinmiyor.
PRESENCE_OR_INTEREST Kullanıcı, reklamverenin hedeflediği konumlarda olduğunda veya bu yerlere ilgi gösterirse bir reklamın tetikleneceğ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 yerlerde veya düzenli olarak bu yerlere giderse 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 Reklamverenin hariç tuttuğu konumlarda bulunan veya bu yerlere ilgi gösteren kullanıcıların reklamı görmekten hariç tutulacağını belirtir.
PRESENCE Reklamverenin hariç tuttuğu konumlarda bulunan kullanıcıların reklamı görmekten hariç tutulacağını belirtir.

FrequencyCapEntry

Bu türde alan yok.

Bir reklamın (veya bazı reklamlar grubunun) belirli bir dönem boyunca kullanıcıya maksimum kaç kez gösterilebileceğini belirten bir kural.

SelectiveOptimization

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

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

string

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

OptimizationGoalSetting

Bu kampanya için bir dizi optimizasyon hedefi türünü içeren 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önüş değeri olarak kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
CALL_CLICKS Telefon araması tıklamaları için optimizasyon yapın. Telefon araması tıklama dönüşümleri, kullanıcıların "Arama"yı seçtiği zamanlardır mağazayla iletişime geçmelerini sağlıyor.
DRIVING_DIRECTIONS Arabayla yol tarifleri için optimize edin. Arabayla yol tarifi dönüşümleri, kullanıcıların "Yol tarifi al"ı seçtiği zamanlardır reklamı görüntüledikten sonra mağazaya gitmek için
APP_PRE_REGISTRATION Ön kayıt için optimize edin. Ön kayıt dönüşümleri, uygulama yayınlandığında bildirim almak için yapılan ön kayıt kayıtlarının sayısıdır.

TrackingSetting

İzleme bilgileri için 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şlem başına teklifi ayarlamasına olanak tanıyan manuel teklif verme stratejisi.

ManualCpc

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

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

boolean

Tekliflerin, Dönüşüm Optimize Edici verileri temel alınarak geliştirilip geliştirilmeyeceği.

ManualCpm

Bu türde alan yok.

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

PercentCpc

Tekliflerin bir ürün veya hizmet için reklamı yapılan fiyatın oranı olan bir teklif stratejisidir.

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 mikro boyutlarda belirtilen isteğe bağlı bir alandır. Not: Sıfır değeri, teklif_taahhütünün tanımlanmamış olmasıyla aynı şekilde yorumlanır.

enhancedCpcEnabled

boolean

Her açık artırmanın teklifini, dönüşüm olasılığına bağlı olarak yukarı veya aşağı doğru ayarlar. Ayrı teklifler cpcBidCeilingMicros'u aşabilir, ancak bir kampanyanın ortalama teklif tutarı geçmemelidir.

TargetCpm

Bu türde alan yok.

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

CampaignAsset

Kampanya ve öğe arasında bağlantı.

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

string

Kampanya öğesinin kaynak adı. CampaignAsset kaynak adları şu şekildedir:

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

status

enum (AssetLinkStatus)

Kampanya öğesinin durumu.

campaign

string

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

asset

string

Kampanyaya bağlı öğe.

CampaignAssetSet

CampaignAssetSet, bir kampanya ile öğe grubu arasındaki bağlantıdır. CampaignAssetSet eklendiğinde bir öğe grubunu bir kampanyaya bağlar.

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

string

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

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

campaign

string

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

assetSet

string

Kampanyaya bağlı öğe grubu.

status

enum (AssetSetLinkStatus)

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

CampaignAudienceView

Kampanya kitle görünümü. Kampanya ve kitle ölçütüne göre birleştirilmiş, Görüntülü Reklam Ağı ve YouTube Ağı reklamlarına yönelik yeniden pazarlama listelerinden ve 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 şekildedir:

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 şekildedir:

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

displayName

string

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

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

criterionId

string (int64 format)

Ölçütün kimliği.

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

bidModifier

number

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

negative

boolean

Ölçütün hedeflenme (false) veya hariç tutulması (true).

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)

Konum Grubu

CampaignCriterionStatus

CampaignCriterion'ın olası durumları.

Sıralamalar
UNSPECIFIED Değer belirtilmedi.
UNKNOWN

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

Bu yalnızca yanıt niteliğinde bir değerdir.

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

LanguageInfo

Dil ölçütü.

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

string

Dil sabit kaynak adı.

LocationGroupInfo

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

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

string

Feed'deki coğrafi alanın kapsamını kısıtlayan coğrafi hedef sabit değerleri. Şu anda yalnızca bir coğrafi hedef sabitine izin verilir.

radiusUnits

enum (LocationGroupRadiusUnits)

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

feedItemSets[]

string

FeedItem'leri hedeflenen FeedItemSet'ler. Birden fazla 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 konumların çevresindeki yarıçapı belirten birimler cinsinden mesafe. Bu gereklidir ve CREATE işlemlerinde ayarlanmalıdır.

LocationGroupRadiusUnits

Yer grubundaki yarıçap mesafesinin birimi (ör. 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 ve 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 ayrıntılı demografi ve yakın ilgi alanları gibi farklı segment özelliklerini bir araya getirmenizi sağlayan etkili bir hedefleme seçeneğidir.

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

string

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

customers/{customerId}/audiences/{audience_id}

id

string (int64 format)

Kitlenin kimliği.

name

string

Zorunlu. Kitlenin adı. Tüm kitlelerde benzersiz olmalıdır. Açıklama uzunluğu en az 1, maksimum 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 şekildedir:

customers/{customerId}/conversionActions/{conversion_action_id}

creationTime

string

Floodlight etkinliği oluşturma işleminin 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üşümlerin kategorisi.

valueSettings

object (ValueSettings)

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

attributionModelSettings

object (AttributionModelSettings)

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

floodlightSettings

object (FloodlightSettings)

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

id

string (int64 format)

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

name

string

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

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

primaryForGoal

boolean

Bir dönüşüm işleminin birincilForGoal biti yanlışsa müşteri dönüşüm hedefi veya kampanya dönüşüm hedefinden bağımsız olarak tüm kampanyalar için dönüşüm işlemi teklif edilemez. Ancak, özel dönüşüm hedefleri birincilForGoal'a uymaz. Bu nedenle, bir kampanyanın birincilForGoal = 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 olmaya devam eder. Varsayılan olarak, ayarlanmazsa birincilForGoal doğru olur. V9'da, primaryForGoal yalnızca bir "güncelleme" ile oluşturulduktan sonra false olarak ayarlanabilir işlemidir.

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" sütununa dahil edilip edilmeyeceği metriğine karşılık gelir.

includeInConversionsMetric

boolean

Bu dönüşüm işleminin "dönüşümler"e dahil edilip edilmeyeceği metriğine karşılık gelir.

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ı bir reklamın telefon uzantısını tıkladığında gerçekleşen dönüşümlerdir.
CLICK_TO_CALL Mobil cihaz kullanıcısı bir telefon numarasını tıkladığında gerçekleşen dönüşümler.
GOOGLE_PLAY_DOWNLOAD Kullanıcı Google Play Store'dan bir mobil uygulama indirdiğinde gerçekleşen dönüşümler.
GOOGLE_PLAY_IN_APP_PURCHASE Kullanıcılar Android faturalandırması üzerinden bir uygulamada satın alma işlemi gerçekleştirdiğinde gerçekleşen dönüşümlerdir.
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ı, reklamverenin web sitesinden dinamik olarak oluşturulan 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ışları 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 alımlara dayalı Mağaza Satışları dönüşümü. Mağaza satışı türlerini yalnızca izin verilenler listesindeki müşteriler kullanabilir. Salt okunur.
FIREBASE_ANDROID_FIRST_OPEN Firebase aracılığıyla izlenen Android uygulaması ilk açılış dönüşümleri.
FIREBASE_ANDROID_IN_APP_PURCHASE Android uygulaması satın alma dönüşümleri Firebase üzerinden izlenir.
FIREBASE_ANDROID_CUSTOM Firebase aracılığıyla 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ı uygulama içi satın alma dönüşümleri Firebase aracılığıyla izlenir.
FIREBASE_IOS_CUSTOM Firebase aracılığıyla 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 Analizleri aracılığıyla izlenen Android uygulaması satın alma dönüşümleri.
THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM Android uygulaması özel dönüşümleri Üçüncü Taraf Uygulama Analizleri ile izlenir.
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 Üçüncü Taraf Uygulama Analizleri aracılığıyla izlenen iOS uygulaması satın alma dönüşümleri.
THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM Üçüncü Taraf Uygulama Analizleri 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üşümlerdir. Salt okunur.
ANDROID_INSTALLS_ALL_OTHER_APPS Uygulamaya özel bir türe göre izlenmeyen tüm Google Play indirme işlemlerini izleyen dönüşümler. Salt okunur.
FLOODLIGHT_ACTION Kullanıcıların bir reklamverenin reklamlarından birini gördükten veya tıkladıktan sonra belirli bir web sayfasını kaç kez ziyaret ettiğini sayan Floodlight etkinliği. Salt okunur.
FLOODLIGHT_TRANSACTION Yapılan satış sayısını veya satın alınan öğe sayısını izleyen Floodlight etkinliği. Her satışın toplam değerini de yakalayabilir. Salt okunur.
GOOGLE_HOSTED Bir reklamla etkileşimde bulunduktan sonra Google'ın ürün ve hizmetlerindeki 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, çağrı izleme ayarları yapılmadan Akıllı kampanya reklamlarında gerçekleşen telefon araması dönüşümleri. Salt okunur.
SMART_CAMPAIGN_MAP_CLICKS_TO_CALL Kullanıcı, Google Haritalar'da bir telefon öğ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 ister. Yalnızca akıllı kampanya. Salt okunur.
SMART_CAMPAIGN_TRACKED_CALLS Akıllı kampanya özel ölçütleri kullanılarak çağrı izleme ayarları yapılan Akıllı kampanya reklamlarında gerçekleşen telefon araması dönüşümleri. Salt okunur.
STORE_VISITS Kullanıcı bir reklamverenin perakende mağazasını ziyaret ettiğinde gerçekleşen dönüşümlerdir. Salt okunur.
WEBPAGE_CODELESS Ayrı olarak kodlanmış etkinlik snippet'lerinin kullanılmadığı 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üşümlerdir.
UNIVERSAL_ANALYTICS_TRANSACTION Bağlı Universal Analytics işlemlerinden gelen dönüşümlerdir.
GOOGLE_ANALYTICS_4_CUSTOM Bağlı Google Analytics 4 özel etkinlik dönüşümlerinden gelen dönüşümlerdir.
GOOGLE_ANALYTICS_4_PURCHASE Bağlı Google Analytics 4 satın alma dönüşümlerinden gelen dönüşümlerdir.

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" unutmayın.
SIGNUP Kullanıcı kaydetme işlemi.
LEAD Olası satış yaratma işlemi.
DOWNLOAD Yazılım indirme işlemi (uygulamada olduğu gibi).
ADD_TO_CART Öğelerin, reklamveren sitesinde bir alışveriş sepetine veya çantasına eklenmesi.
BEGIN_CHECKOUT Kullanıcı reklamverenin 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 teklifiyle ilgilendiğini belirtmek için yapılan bir çağrı.
IMPORTED_LEAD Harici bir kaynaktan Google Ads'e aktarılan potansiyel müşteri dönüşümü.
SUBMIT_LEAD_FORM Reklamveren sitesinde işletmeyle ilgilendiğini belirten bir form gönderilmesi.
BOOK_APPOINTMENT Bir reklamverenin işletmesiyle yapılan randevu.
REQUEST_QUOTE Fiyat teklifi veya fiyat tahmini isteği.
GET_DIRECTIONS Bir reklamverenin ziyaret etmek amacıyla işletmesinin bulunduğu konum için yapılan arama.
OUTBOUND_CLICK Reklamverenin iş ortağı sitesine yapılan tıklama.
CONTACT Reklamverene telefon etme, SMS, e-posta, sohbet veya diğer türde kişiler.
ENGAGEMENT Uzun site süresi veya Google Analytics (GA) Akıllı Hedefi gibi bir web sitesi etkileşim etkinliği. GA, Firebase, GA Altın hedef içe aktarma işlemleri için kullanılmak üzere tasarlanmıştır.
STORE_VISIT Fiziksel mağaza ziyareti.
STORE_SALE Fiziksel mağazada gerçekleşen satış.
QUALIFIED_LEAD Reklamveren (pazarlama/satış ekibi) tarafından daha da uygun hale getirilmiş harici bir kaynaktan Google Ads'e aktarılan bir potansiyel müşteri dönüşümü. Potansiyel müşteriden satışa giden yolculukta reklamverenler potansiyel müşteriler elde eder ve ardından tüketiciye ulaşarak bunlarla ilgili işlem yapar. Tüketici, ürünle ilgileniyorsa ve ürü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 reklamvereni tarafından tanımlanan belirli bir aşamayı tamamlayan 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şlemiyle ilgili 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ğerin ve varsayılan para birimi kodunun kullanılıp kullanılmayacağını kontrol eder.

AttributionModelSettings

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

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

enum (AttributionModel)

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

dataDrivenModelStatus

enum (DataDrivenModelStatus)

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

AttributionModel

Belirli bir dönüşüme ilişkin kredinin potansiyel olarak çok sayıda önceki etkileşim arasında 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ır.
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üşümün tüm kredisini ilk tıklamasıyla ilişkilendirir.
GOOGLE_SEARCH_ATTRIBUTION_LINEAR Google Arama ilişkilendirmesini kullanarak bir dönüşüme ilişkin krediyi tüm tıklamalar arasında eşit şekilde ilişkilendirir.
GOOGLE_SEARCH_ATTRIBUTION_TIME_DECAY Google Arama ilişkilendirmesini kullanarak, bir dönüşümü daha yeni tıklamalarıyla katlanarak daha fazla krediyle ilişkilendirir (yarı ömür 1 haftadır).
GOOGLE_SEARCH_ATTRIBUTION_POSITION_BASED Bir dönüşüm kredisinin% 40'ını ilk ve son tıklamalarıyla ilişkilendirir. Kalan% 20 ise 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 Google Arama ilişkilendirmesini kullanarak kredinin tıklamalar arasında uygun dağılımını belirlemek için makine öğrenimini kullanan esnek model.

DataDrivenModelStatus

Veriye dayalı model durumlarını belirtir.

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üncellenmemiş. Teklif hâlâ kullanılıyor ancak 30 gün boyunca güncellenmezse süresi dolar.
EXPIRED Veriye dayalı modelin süresi doldu. En az 30 gündür güncellenmemiş olduğu için kullanılamaz. Bunun en yaygın nedeni, son 30 gün içinde gereken sayıda etkinlik olmamasıdır.
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 olmamasıdır.

FloodlightSettings

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

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

string

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

activityTag

string

Dönüşümler bildirilirken 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 "Yeni Search Ads 360'taki özel Floodlight metrikleri ve boyutları hakkında" bölümünü inceleyin https://support.google.com/sa360/answer/13567857

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

string

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

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. Ad en fazla 100 karakterden oluşabilir. Ö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 "u" harfinden oluşmalıdır karakteri ile birlikte 100'e kadar orme eş değer bir sayı gelir. Ö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ü özelleştirilebilen değişkenlerine ilişkin alanlar.

customColumnIds[]

string (int64 format)

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

ConversionCustomVariableStatus

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

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca dö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şkeninin etkinleştirilmesi bekleniyor ve bu değişken ETKİN olarak ayarlanana kadar istatistik oluşturmayacak.

Bu durum CREATE ve UPDATE isteklerinde kullanılamaz.

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

ConversionCustomVariableFamily

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 kullanımdan önce etkinleştirmeleri gerekir.
FLOODLIGHT Özel bir Floodlight değişkeninden içe aktarılan dönüşüm özelleştirilebilen değişkeni.

ConversionCustomVariableCardinality

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şkeninin, segmentasyon sınırını aşan ancak istatistik sınırını aşmayan kardinalitesi var. Segmentasyon devre dışı bırakılır, ancak değişken etkinleştirilirse yeni değerler için istatistikler oluşturulabilir.
APPROACHES_STATS_LIMIT Dönüşüm özelleştirilebilen değişkeni, segmentasyon sınırlarını aştı ve istatistik sınırlarına (> %90) yaklaşıyor. Segmentasyon devre dışı bırakılır, ancak değişken etkinleştirilirse yeni değerler için istatistikler oluşturulabilir.
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 etkinleştirilmiş değişkenlere ait istatistikler yalnızca mevcut değerler değişkenin kardinalitesini daha fazla artırmıyorsa elde edilebilir.

FloodlightConversionCustomVariableInfo

Search Ads 360 Floodlight dönüşümü özelleştirilebilen değişkenlerine ilişkin bilgiler.

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

enum (FloodlightVariableType)

Search Ads 360'ta tanımlanan Floodlight değişkeni 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şkeni türü.
UNSET Floodlight değişken türü ayarlanmamış.

FloodlightVariableDataType

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

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca döndürülen değer için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
NUMBER "Sayı" Floodlight değişkenini gösterir türü. Bu değişken, DIMENSION veya METRIC türündeki Floodlight değişkenlerine atanabilir.
STRING "Dize" Floodlight değişkenini temsil eder türü. Bu değişken, DIMENSION türündeki Floodlight değişkenlerine atanabilir.

Müşteri

Müşteri.

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

string

Müşterinin kaynak adı. Müşteri kaynağı adları şu şekildedir:

customers/{customerId}

conversionTrackingSetting

object (ConversionTrackingSetting)

Müşterinin 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)

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

accountStatus

enum (AccountStatus)

Hesap durumu (örneğin, 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" şeklindedir. 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 diliminde ve "yyyy-AA-gg SS:dd:ss" şeklindedir. 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 çalıştığı 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

Nihai URL'ye parametreler 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ıyorsanız bu değer yöneticiden devralınır. Bu alan salt okunurdur. Daha fazla bilgi için https://support.google.com/adspolicy/answer/7475709 adresine göz atın.

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 belirtir. Bu müşteri hesaplar arası dönüşüm izlemeyi kullanıyorsa döndürülen değer, isteğin login-customer-id değerine göre değişir.

enhancedConversionsForLeadsEnabled

boolean

Müşterinin, potansiyel müşteriler için gelişmiş dönüşümleri etkinleştirip etkinleştirmediği Hesaplar arası dönüşüm izleme kullanıyorsanız 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 kullanır). Bu alan salt okunurdur.

googleAdsCrossAccountConversionTrackingId

string (int64 format)

Müşteri yöneticisinin dönüşüm izleme kimliği. Bu değer, müşteri dönüşüm izlemeyi etkinleştirdiğinde ayarlanır ve conversionTrackingId'yi 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üşteri yöneticisinin dönüşüm izleme kimliği. Bu değer, müşteri hesaplar arası dönüşüm izlemeyi etkinleştirdiğinde ayarlanır ve conversionTrackingId'yi geçersiz kılar.

ConversionTrackingStatus

Müşterinin Dönüşüm İ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 dönüşüm izleme kullanmıyor.
CONVERSION_TRACKING_MANAGED_BY_SELF Dönüşüm işlemleri bu müşteri tarafından oluşturulur ve yönetilir.
CONVERSION_TRACKING_MANAGED_BY_THIS_MANAGER Dönüşüm işlemleri, isteğin login-customer-id bölümünde belirtilen yönetici tarafından oluşturulur ve yönetilir.
CONVERSION_TRACKING_MANAGED_BY_ANOTHER_MANAGER Dönüşüm işlemleri, isteğin login-customer-id öğesinde 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 ile yönetiliyor.
GOOGLE_ADS Google Ads hesabınızla oturum açın.
MICROSOFT Microsoft Advertising hesabı.
SEARCH_ADS_360 Search Ads 360 yönetici hesabı.
YAHOO_JAPAN Yahoo Japan hesabınızla oturum açın.

DoubleClickCampaignManagerSetting

Bir yönetici müş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şkilendirilen Campaign Manager ağının kimliği.

timeZone

string

Amerika/New_York gibi IANA Saat Dilimi Veritabanı biçiminde, bu müşteriyle ilişkilendirilmiş Campaign Manager ağının saat dilimi.

AccountStatus

Hesabın olası durumları.

Sıralamalar
UNSPECIFIED Varsayılan değer.
UNKNOWN Bilinmeyen değer.
ENABLED Hesap reklam yayınlayabilir.
PAUSED Hesap, kullanıcı tarafından devre dışı bırakıldı.
SUSPENDED Hesap, dahili bir iş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ınlayabilen etkin bir hesabı belirtir.
CANCELED İptal edilen 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 Kapalı bir hesabın reklam yayınlayamadığını belirtir. Test hesabının durumu da KAPATILDI olur. Durum kalıcıdır ve yeniden açılamaz.

CustomerAsset

Müşteri ile öğe arasındaki 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ı şu şekildedir:

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

asset

string

Zorunlu. Müşteriye bağlı öğedir.

status

enum (AssetLinkStatus)

Müşteri öğesinin durumu.

CustomerAssetSet

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

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

string

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

customers/{customerId}/customerAssetSets/{asset_set_id}

assetSet

string

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

customer

string

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

status

enum (AssetSetLinkStatus)

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

AccessibleBiddingStrategy

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

BiddingStrateji'nin aksine bu kaynak, müşterinin yöneticilerine ait olan ve bu müşteriyle paylaşılan stratejilerin yanı sıra müşterinin sahip olduğu stratejileri içerir. Bu kaynak, metrik sağlamaz ve Biddingstrateji ö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ı. ErişilebilirTeklif 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

identifierName (Müşterinin teklif stratejisine sahip olan açıklayıcı adı).

Birleştirme alanı scheme. Teklif şeması.

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

maximizeConversionValue

object (MaximizeConversionValue)

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

maximizeConversions

object (MaximizeConversions)

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

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 gösterim yüzdesi için otomatik olarak optimizasyon yapan bir teklif stratejisidir.

targetRoas

object (TargetRoas)

Belirli bir hedef reklam harcamalarından elde edilen gelir (ROAS) elde ederken gelirinizi 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 yüksek dönüşüm değerini elde etmenize yardımcı olacak bir otomatik teklif stratejisi.

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

number

Reklam harcamalarından elde edilen gelir (ROAS) hedefi seçeneği. Ayarlanırsa teklif stratejisi, hedef reklam harcamalarından elde edilen gelir ortalamasını alırken geliri en üst düzeye çıkarır. Hedef ROAS yüksekse teklif stratejisi bütçenin tamamını harcayamayabilir. Hedef ROAS ayarlanmazsa teklif stratejisi, bütçe için 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ı olacak bir otomatik teklif stratejisi

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 buna eşit olmalıdır.

TargetImpressionShare

Teklifleri, arama ağı reklamlarının belirli bir yüzdesinin ilk sayfanın (veya hedeflenen başka bir konumda) en üstünde gösterilecek şekilde ayarlayan bir otomatik teklif stratejisidir.

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

enum (TargetImpressionShareLocation)

Arama sonuçları sayfasında hedeflenen konum.

locationFractionMicros

string (int64 format)

Hedeflenen konumda mikrosaniye cinsinden gösterilecek reklam oranı. Örneğin, %1 10.000'e eşittir.

cpcBidCeilingMicros

string (int64 format)

Otomatik teklif sisteminin belirtmesine izin verilen en yüksek TBM teklifidir. Bu, tavanı ayarlayan ve yerel mikro düzeyde belirtilen reklamveren tarafından girilen zorunlu bir alandır.

TargetRoas

Belirli bir hedef ROAS (reklam harcamalarından elde edilen gelir) ortalaması alarak gelirinizi 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 göre).

TargetSpend

Tekliflerinizi, bütçeniz dahilinde olabildiğince çok sayıda tıklama almanıza yardımcı olacak şekilde ayarlayan bir 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 teklifi veren, bu değerden veya doğal kısıtlama harcama tutarından daha küçük olanı harcamaya çalışır. Belirtilmezse bütçe, harcama hedefi olarak kullanılır. Bu alan kullanımdan kaldırıldığı için artık kullanılmamalıdır. Ayrıntılı bilgi için https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html sayfasına göz atın.

cpcBidCeilingMicros

string (int64 format)

Teklif stratejisi tarafından ayarlanabilecek maksimum teklif sınırı. Bu 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şkisini gösterir
INACTIVE Sonlandırılmış ilişkiyi gösterir
PENDING Yönetici tarafından ilişkinin istendiğini ancak müşterinin henüz bunu kabul etmediğini gösterir.
REFUSED Yönetici, ilişkiyle ilgili istekte bulundu ancak müşteri bu isteği reddetti.
CANCELED Yönetici tarafından ilişkinin istendiğini, ancak yöneticinin iptal ettiğini gösterir.

CustomerClient

Belirtilen müşteri ile müşteri arasındaki bağlantı. CustomerClients yalnızca yönetici müşteriler için mevcuttur. Yöneticinin yanı sıra doğrudan ve dolaylı müşterilerin tümü bu kapsama 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 etiketlerin müşteri müşterisine uygulanan kaynak adları. Etiket kaynağı adları şu biçimdedir:

customers/{customerId}/labels/{label_id}

status

enum (CustomerStatus)

Müşterinin durumu. Salt okunur.

clientCustomer

string

Belirtilen müşteriye bağlı müşteri-müşterinin kaynak adı. Salt okunur.

hidden

boolean

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

Salt okunur.

level

string (int64 format)

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

timeZone

string

İstemcinin saat diliminin Ortak Yerel Veri Deposu (CLDR) dizesi gösterimi (ör. Amerika/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

Müşteri 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, geçerli yayın durumunu yansıtır. Cinsiyet ölçütü olmayan bir reklam grubu, varsayılan olarak tüm cinsiyetlere gösterilir. Dolayısıyla, 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 hedef adının 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

Bir 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 niteliğinde bir değerdir.

ENABLED Coğrafi hedef sabiti geçerli.
REMOVAL_PLANNED Coğrafi hedef sabit değeri 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 kaynağı adları şu biçimdedir: customers/{customerId}/labels/{label_id}

status

enum (LabelStatus)

Etiketin durumu. Salt okunur.

textLabel

object (TextLabel)

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

Bu alan zorunludur ve yeni etiket oluştururken boş bırakılmamalıdır.

Bu dize, 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

Metinleri 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: Arka plan rengi yönetici hesapları için görünmeyebilir.

description

string

Etiketin kısa bir açıklaması. Uzunluk 200 karakterden fazla olmamalıdır.

LanguageConstant

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 şekildedir:

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 verme kategorisinin kaynak adı. Ürün teklif verme kategorisi kaynak adları şu şekildedir:

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

level

enum (ProductBiddingCategoryLevel)

Ürün teklif kategorisinin düzeyi.

status

enum (ProductBiddingCategoryStatus)

Ürün teklif kategorisinin durumu.

id

string (int64 format)

Ürün teklif kategorisinin kimliği.

Bu kimlik, şu makalede açıklanan google_product_category 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

Ürün teklif kategorisinin, languageCode'a göre yerelleştirilmiş değeri gösterilir.

ProductBiddingCategoryLevel

Ürün teklif kategorisinin düzeyini açıklayan 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.
LEVEL1 1. Düzey:
LEVEL2 2. Düzey.
LEVEL3 3. Düzey.
LEVEL4 4. Düzey.
LEVEL5 5. Seviye.

ProductBiddingCategoryStatus

Ürün teklif kategorisinin durumunu açıklayan 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.
ACTIVE Kategori etkindir ve teklif vermek için kullanılabilir.
OBSOLETE Kategori artık kullanılmıyor. Yalnızca raporlama amacıyla kullanılır.

ProductGroupView

Ürün grubu görünümü.

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

string

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

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

ShoppingPerformanceView

Alışveriş performansı görünümü. Çeşitli ürün boyutu düzeylerinde birleştirilmiş 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 bir boyutun durumunu yansıtır.

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

string

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

UserList

Kullanıcı listesi. Bu, 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 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.
REMARKETING Dönüşüm türlerinin bir koleksiyonu olarak temsil edilen UserList adlı kullanıcı listesi.
LOGICAL Kullanıcı listeleri, diğer kullanıcı listelerinin/ilgi alanlarının bir kombinasyonu olarak temsil edilir.
EXTERNAL_REMARKETING Google Ad Manager platformunda oluşturulan Kullanıcı Listesi.
RULE_BASED Bir kuralla ilişkilendirilmiş Kullanıcı Listesi.
SIMILAR Başka bir UserList kullanıcıya benzer kullanıcılara sahip kullanıcı listesi.
CRM_BASED Reklamveren tarafından e-posta veya diğer biçimlerde sağlanan birinci taraf CRM verilerinin Kullanıcı Listesi.

WebpageView

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

Ziyaret edin

Ziyaret.

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

string

Ziyaretin kaynak adı. Ziyaret kaynağı adları şu biçimdedir:

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

id

string (int64 format)

Ziyaretin kimliği.

criterionId

string (int64 format)

Search Ads 360 anahtar kelime kimliği. 0 değeri, anahtar kelimenin ilişkilendirilmemiş olduğunu gösterir.

merchantId

string (int64 format)

Tıklanan ürünü içeren Search Ads 360 envanter hesabı kimliği. Bu kimliği Search Ads 360'ta bir envanter hesabı bağladığınızda Search Ads 360 oluşturur.

adId

string (int64 format)

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

clickId

string

Her ziyaret için, tıklama kimliği URL parametresi olarak açılış sayfasına iletilen benzersiz bir dize.

visitDateTime

string

Ziyaret etkinliğinin zaman damgası. Zaman damgası müşterinin saat diliminde ve "yyyy-AA-gg SS:dd:ss" şeklindedir. 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 verileri içeren Merchant Center feed'i için ayarlanan dildir (ISO-639-1).

productStoreId

string

Yerel envanter reklamındaki tıklanan 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ç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 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.
ONLINE Ürün internet üzerinden satılmıştır.
LOCAL Öğe yerel mağazalarda satılır.

Dönüşüm

Dönüşüm.

JSON gösterimi
{
  "resourceName": string,
  "id": string,
  "criterionId": string,
  "merchantId": string,
  "adId": string,
  "clickId": string,
  "visitId": string,
  "advertiserConversionId": string,
  "productId": string,
  "productChannel": enum (ProductChannel),
  "productLanguageCode": string,
  "productStoreId": string,
  "productCountryCode": string,
  "attributionType": enum (AttributionType),
  "conversionDateTime": string,
  "conversionLastModifiedDateTime": string,
  "conversionVisitDateTime": string,
  "conversionQuantity": string,
  "conversionRevenueMicros": string,
  "floodlightOriginalRevenue": string,
  "floodlightOrderId": string,
  "status": enum (ConversionStatus),
  "assetId": string,
  "assetFieldType": enum (AssetFieldType)
}
Alanlar
resourceName

string

Dönüşümün kaynak adı. Dönüşüm kaynağı adları şu şekildedir:

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şkilendirilmemiş olduğunu gösterir.

merchantId

string (int64 format)

Tıklanan ürünü içeren Search Ads 360 envanter hesabı kimliği. Bu kimliği Search Ads 360'ta bir envanter hesabı bağladığınızda Search Ads 360 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 iletilen benzersiz bir dize.

visitId

string (int64 format)

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

advertiserConversionId

string

Çevrimdışı dönüşümler için reklamverenler tarafından sağlanan bir kimliktir. Reklamveren böyle bir kimlik belirtmezse Search Ads 360 bir kimlik oluşturur. Çevrimiçi dönüşümler için bu değer, reklamverenin Floodlight talimatlarına bağlı olarak kimlik sütununa veya floodlight OrderId 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 verileri içeren Merchant Center feed'i için ayarlanan dildir (ISO-639-1).

productStoreId

string

Yerel envanter reklamındaki tıklanan 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'inin kayıtlı olduğu ülke (ISO-3166 biçimi).

attributionType

enum (AttributionType)

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

conversionDateTime

string

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

conversionLastModifiedDateTime

string

Dönüşümün en son değiştirildiği zamanı gösteren zaman damgası.

conversionVisitDateTime

string

Dönüşümün ilişkilendirildiği ziyaretin zaman damgası.

conversionQuantity

string (int64 format)

qty URL parametresi ile belirlenen, dönüşüm tarafından kaydedilen öğe miktarı. Parametreyi dinamik olarak doldurmaktan (dönüşümde satılan öğelerin sayısı gibi) reklamveren sorumludur. Aksi takdirde, varsayılan olarak 1 değerini alır.

conversionRevenueMicros

string (int64 format)

Dönüşüm etkinliği için mikro cinsinden düzenlenmiş gelir. Bu tutar her zaman sunucu 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üşümlerin 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,
  "averageQualityScore": number,
  "historicalQualityScore": string,
  "impressions": string,
  "interactionRate": number,
  "interactions": string,
  "invalidClickRate": number,
  "invalidClicks": string,
  "mobileFriendlyClicksPercentage": number,
  "searchAbsoluteTopImpressionShare": number,
  "searchBudgetLostAbsoluteTopImpressionShare": number,
  "searchBudgetLostImpressionShare": number,
  "searchBudgetLostTopImpressionShare": number,
  "searchClickShare": number,
  "searchExactMatchImpressionShare": number,
  "searchImpressionShare": number,
  "searchRankLostAbsoluteTopImpressionShare": number,
  "searchRankLostImpressionShare": number,
  "searchRankLostTopImpressionShare": number,
  "searchTopImpressionShare": number,
  "topImpressionPercentage": number,
  "valuePerAllConversions": number,
  "valuePerAllConversionsByConversionDate": number,
  "valuePerConversion": number,
  "valuePerConversionsByConversionDate": number,
  "clientAccountViewThroughConversions": string,
  "clientAccountCrossSellCostOfGoodsSoldMicros": string,
  "crossSellCostOfGoodsSoldMicros": string,
  "clientAccountCrossSellGrossProfitMicros": string,
  "crossSellGrossProfitMicros": string,
  "clientAccountCrossSellRevenueMicros": string,
  "crossSellRevenueMicros": string,
  "clientAccountCrossSellUnitsSold": number,
  "crossSellUnitsSold": number,
  "clientAccountLeadCostOfGoodsSoldMicros": string,
  "leadCostOfGoodsSoldMicros": string,
  "clientAccountLeadGrossProfitMicros": string,
  "leadGrossProfitMicros": string,
  "clientAccountLeadRevenueMicros": string,
  "leadRevenueMicros": string,
  "clientAccountLeadUnitsSold": number,
  "leadUnitsSold": number
}
Alanlar
allConversionsValueByConversionDate

number

Tüm dönüşümlerin değeri. Bu sütun tarihle birlikte seçildiğinde tarih sütunundaki değerler, dönüşüm tarihini ifade eder. by_conversion_date sütunlarıyla ilgili ayrıntıları https://support.google.com/sa360/answer/9250611 adresinde bulabilirsiniz.

allConversionsByConversionDate

number

Toplam dönüşüm sayısı. Bu, includeInConversionsMetric değerinden bağımsız olarak tüm dönüşümleri içerir. Bu sütun tarihle birlikte seçildiğinde tarih sütunundaki değerler, dönüşüm tarihini ifade eder. by_conversion_date sütunlarıyla ilgili ayrıntıları https://support.google.com/sa360/answer/9250611 adresinde bulabilirsiniz.

conversionCustomMetrics[]

object (Value)

Dönüşüm özel metrikleri

conversionsValueByConversionDate

number

Dönüşüm tarihine göre teklif verilebilir dönüşüm değerlerinin toplamı. Bu sütun tarihle birlikte seçildiğinde tarih sütunundaki değerler, dönüşüm tarihini ifade eder.

conversionsByConversionDate

number

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

historicalCreativeQualityScore

enum (QualityScoreBucket)

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

historicalLandingPageQualityScore

enum (QualityScoreBucket)

Açılış sayfası deneyiminin kalitesi

historicalSearchPredictedCtr

enum (QualityScoreBucket)

Geçmiş aramadaki tahmini tıklama oranı (TO).

interactionEventTypes[]

enum (InteractionEventType)

Ücretli ve ücretsiz etkileşimlerin 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ümü.

allConversionsValue

number

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

allConversions

number

Toplam dönüşüm sayısı. Bu, includeInConversionsMetric değerinden bağımsız olarak tüm dönüşümleri içerir.

allConversionsValuePerCost

number

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

allConversionsFromClickToCall

number

Kullanıcıların "Ara"yı tıklama sayısı düğmesini tıklayın. 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 "Yol tarifi al" düğmesini tıklama sayısı düğmeyi tıklayın.

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

allConversionsFromInteractionsValuePerInteraction

number

Etkileşimlerden elde edilen tüm dönüşümlerin 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ştirilen diğer dönüşümlerin (ör. yorumu gönderme veya mağaza konumunu kaydetme) sayısı.

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

allConversionsFromStoreVisit

number

Kullanıcıların bir reklamı tıkladıktan sonra mağazayı ziyaret etme tahmini sayısı.

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

visits

number

Search Ads 360'ın başarıyla 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 inceleyebilirsiniz.

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

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 ile 0,9 aralığında raporlanır. 0,9'un üzerindeki değerler 0,9001 olarak raporlanır.

contentImpressionShare

number

Görüntülü Reklam Ağı'nda aldığınız gösterim sayısının, almaya uygun olduğunuz tahmini gösterim sayısına bölünmesiyle elde edilen orandır. Not: İçerik gösterim payı 0,1 ile 1 aralığında raporlanır. 0,1'in altındaki değerler 0,0999 olarak raporlanır.

contentRankLostImpressionShare

number

Reklamlarınızın Görüntülü Reklam Ağı'nda düşük Reklam Sıralaması nedeniyle almadığı gösterimlerin tahmini yüzdesi. Not: İçerik sıralaması kaybedilen gösterim payı 0 ile 0,9 aralığında raporlanır. 0,9'un üzerindeki değerler 0,9001 olarak raporlanır.

conversionsFromInteractionsRate

number

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

clientAccountConversionsValue

number

Müşteri hesabı dönüşümlerinin değeri. Yalnızca includeInClientAccountConversionsMetric özelliğinin doğru olarak ayarlandığı dönüşüm işlemleri buna dahildir. Dönüşüme dayalı teklif verme özelliğini kullanıyorsanız teklif stratejileriniz bu dönüşümler için optimize edilir.

conversionsValuePerCost

number

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

conversionsFromInteractionsValuePerInteraction

number

Etkileşimlerden elde edilen dönüşümlerin değerinin reklam etkileşimleri sayısına bölünmesiyle elde edilen değer. Yalnızca includeInConversionsMetric özelliğinin doğru olarak ayarlandığı dönüşüm işlemleri bu kapsama girer. Dönüşüme dayalı teklif verme özelliğini kullanıyorsanız teklif stratejileriniz bu dönüşümler için optimize edilir.

clientAccountConversions

number

Müşteri hesabı dönüşümlerinin sayısı. Yalnızca includeInClientAccountConversionsMetric özelliğinin doğru olarak ayarlandığı dönüşüm işlemleri buna dahildir. Dönüşüme dayalı teklif verme özelliğini kullanıyorsanız teklif stratejileriniz bu dönüşümler için optimize edilir.

costMicros

string (int64 format)

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

costPerAllConversions

number

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

costPerConversion

number

Teklif verilebilir dönüşüm başına ortalama dönüşüm maliyeti.

costPerCurrentModelAttributedConversion

number

Reklam etkileşimlerinin maliyetinin, mevcut modelle ilişkilendirilen dönüşüm sayısına bölünmesiyle elde edilen değer. Yalnızca includeInConversionsMetric özelliğinin doğru olarak ayarlandığı dönüşüm işlemleri bu kapsama girer. Dönüşüme dayalı teklif verme özelliğini kullanıyorsanız teklif stratejileriniz bu dönüşümler için optimize edilir.

crossDeviceConversions

number

Müşterinin bir cihazda bir reklamı tıklayıp farklı bir cihaz veya tarayıcıda gerçekleştirdiği dönüşümler. Cihazlar arası dönüşümler zaten tüm Dönüşümler'e dahil edilmiştir.

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 sayısına (Gösterimler) bölünmesiyle elde edilen orandır.

conversions

number

Dönüşüm sayısı. Yalnızca includeInConversionsMetric özelliğinin doğru olarak ayarlandığı dönüşüm işlemleri bu kapsama girer. Dönüşüme dayalı teklif verme özelliğini kullanıyorsanız teklif stratejileriniz bu dönüşümler için optimize edilir.

conversionsValue

number

"Dönüşümler" sütununa dahil edilen dönüşümlerin dönüşüm değerlerinin toplamı girin. Bu metrik yalnızca, dönüşüm işlemleriniz için bir değer girmeniz durumunda işe yarar.

averageQualityScore

number

Ortalama kalite puanı.

historicalQualityScore

string (int64 format)

Kalite puanı geçmişi.

impressions

string (int64 format)

Reklamınızın 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

Kullanıcıların reklamınızı gördükten sonra reklamınızla etkileşim kurma sıklığı. 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şimlerin sayısı. Etkileşim, reklam biçimiyle ilişkilendirilmiş ana kullanıcı işlemidir. Metin ve alışveriş reklamlarına yapılan tıklamalar, video reklamların görüntülenmesi vb.

invalidClickRate

number

Raporlama dönemi boyunca toplam tıklama sayınızdan (filtrelenmiş + filtrelenmemiş tıklamalar) filtrelenen tıklamaların yüzdesi.

invalidClicks

string (int64 format)

Google'ın kurallara aykırı olarak kabul ettiğ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 adresine bakın. 0,1'in altındaki değerler 0,0999 olarak raporlanır.

searchBudgetLostAbsoluteTopImpressionShare

number

Reklamınızın düşük bütçe nedeniyle ne sıklıkla arama sonuçlarında üst kısımdaki reklamlar arasında ilk sırada yer almadığını tahmin eden sayı. Not: Arama Ağı bütçesi kaybedilen mutlak üst gösterim payı 0 ile 0,9 aralığında raporlanır. 0,9'un üzerindeki değerler 0,9001 olarak raporlanır.

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 dair tahmini yüzde. Not: Arama Ağı bütçesi kaybedilen gösterim payı 0 ile 0,9 aralığında raporlanır. 0,9'un üzerindeki değerler 0,9001 olarak raporlanır.

searchBudgetLostTopImpressionShare

number

Reklamınızın düşük bütçe nedeniyle üstteki organik arama sonuçlarının yanında ne sıklıkta gösterilmediğini tahmin eden rakam. Not: Arama Ağı bütçesi kaybedilen üst gösterim payı 0 ile 0,9 aralığında raporlanır. 0,9'un üzerindeki değerler 0,9001 olarak raporlanır.

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 ile 1 aralığında raporlanır. 0,1'in altındaki değerler 0,0999 olarak raporlanır.

searchExactMatchImpressionShare

number

Anahtar kelime eşleme türünüz ne olursa olsun, aldığınız gösterim sayısının, Arama Ağı'nda anahtar kelimelerinizle tam olarak eşleşen (veya anahtar kelimelerinizin yakın varyasyonları olan) arama terimleri için almaya uygun olduğunuz tahmini gösterim sayısına bölünmesiyle elde edilen orandır. Not: Arama Ağı tam eşleme gösterim payı 0,1 ile 1 aralığında raporlanır. 0,1'in altındaki değerler 0,0999 olarak raporlanır.

searchImpressionShare

number

Arama Ağı'nda aldığınız gösterim sayısının, almaya uygun olduğunuz tahmini gösterim sayısına bölünmesiyle elde edilen orandır. Not: Arama Ağı gösterim payı 0,1 ile 1 aralığında raporlanır. 0,1'in altındaki değerler 0,0999 olarak raporlanır.

searchRankLostAbsoluteTopImpressionShare

number

Reklamınızın düşük Reklam Sıralaması nedeniyle arama sonuçlarında üst kısımdaki reklamlar arasında ne sıklıkta ilk sırada yer almadığını tahmin eden sayı. Not: Arama sıralaması kaybedilen mutlak üst gösterim payı 0 ile 0,9 aralığında raporlanır. 0,9'un üzerindeki değerler 0,9001 olarak raporlanır.

searchRankLostImpressionShare

number

Reklamlarınızın Arama Ağı'nda düşük Reklam Sıralaması nedeniyle almadığı gösterimlerin tahmini yüzdesi. Not: Arama sıralaması kaybedilen gösterim payı 0 ile 0,9 aralığında raporlanır. 0,9'un üzerindeki değerler 0,9001 olarak raporlanır.

searchRankLostTopImpressionShare

number

Reklamınızın, düşük reklam sıralaması nedeniyle üstteki organik arama sonuçlarının yanında ne sıklıkta gösterilmediğini tahmin eden sayı. Not: Arama sıralaması kaybedilen üst gösterim payı 0 ile 0,9 aralığında raporlanır. 0,9'un üzerindeki değerler 0,9001 olarak raporlanır.

searchTopImpressionShare

number

Üst kısımdaki reklamlar arasında aldığınız gösterim sayısının, üst kısımdaki reklamlar arasında almaya uygun olduğunuz tahmini gösterim sayısıyla karşılaştırması. Not: Arama Ağı üst gösterim payı 0,1 ile 1 aralığında raporlanır. 0,1'in altındaki değerler 0,0999 olarak raporlanır.

Üst kısımdaki reklamlar genellikle üstteki organik sonuçların üstünde yer alır. Ancak belirli sorgularda üst kısımdaki reklamlar üstteki organik sonuçların altında gösterilebilir.

topImpressionPercentage

number

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

valuePerAllConversions

number

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

valuePerAllConversionsByConversionDate

number

Tüm dönüşümlerin değerinin tüm dönüşümlerin sayısına bölümü. Bu sütun tarihle birlikte seçildiğinde tarih sütunundaki değerler, dönüşüm tarihini ifade eder. by_conversion_date sütunlarıyla ilgili ayrıntıları https://support.google.com/sa360/answer/9250611 adresinde bulabilirsiniz.

valuePerConversion

number

Teklif verilebilir dönüşümün değerinin, teklif verilebilir dönüşüm sayısına bölünmesiyle elde edilen değer. Her bir teklif verilebilir dönüşümlerin 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üşümlerin ortalama değerini (dönüşüm tarihine göre) gösterir. Bu sütun tarihle birlikte seçildiğinde tarih sütunundaki değerler, dönüşüm tarihini ifade eder.

clientAccountViewThroughConversions

string (int64 format)

Görüntüleme dönüşümlerinin toplam sayısı. Müşteri, bir resim reklamı veya rich media reklamını görüp daha sonra başka bir reklamla etkileşimde bulunmadan (örneğin, tıklamadan) sitenizde bir dönüşüm gerçekleştirirse bu durum 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 reklamla ilişkilendirilmiş bir ürün varsa (bkz. Alışveriş reklamları) bu ürün, reklamı yapılan ürün olarak kabul edilir. Müşterinin verdiği siparişi eklenen her ürün, satılan üründür. 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ıyor. Şapkanın "satılan malların maliyeti" değerinin 3 TL, gömleğin "satılan malların maliyeti" değerinin ise 5 TL olduğunu varsayalım. Bu sipariş için "satılan malların çapraz satış maliyeti" değeri 5 TL'dir. Bu metrik yalnızca alışveriş sepeti verileriyle dönüşümler raporlanıyorsa kullanılabilir. Bu metrik parasal bir değerdir ve varsayılan olarak müşterinin para biriminde döndürülür. https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause adresindeki metrics_currency parametresini inceleyebilirsiniz.

crossSellCostOfGoodsSoldMicros

string (int64 format)

Satılan malların çapraz satış maliyeti (SMM), farklı bir ürünün reklamının yapılması sonucunda satılan ürünlerin toplam maliyetidir. İşleyiş şekli: Web sitenizde tamamlanan satın alma işlemleri için alışveriş sepeti verileriyle dönüşümleri raporlarsınız. Satın alma işleminden önce etkileşimde bulunulan reklamla ilişkilendirilmiş bir ürün varsa (bkz. Alışveriş reklamları) bu ürün, reklamı yapılan ürün olarak kabul edilir. Müşterinin verdiği siparişi eklenen her ürün, satılan üründür. 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ıyor. Şapkanın "satılan malların maliyeti" değerinin 3 TL, gömleğin "satılan malların maliyeti" değerinin ise 5 TL olduğunu varsayalım. Bu sipariş için "satılan malların çapraz satış maliyeti" değeri 5 TL'dir. Bu metrik yalnızca alışveriş sepeti verileriyle dönüşümler raporlanıyorsa kullanılabilir. Bu metrik parasal bir değerdir ve varsayılan olarak müşterinin para biriminde döndürülür. https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause adresindeki metrics_currency parametresini inceleyebilirsiniz.

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 reklamla ilişkilendirilmiş bir ürün varsa (bkz. Alışveriş reklamları) bu ürün, reklamı yapılan ürün olarak kabul edilir. Satın alma işlemine dahil edilen tüm ürünler, satılan üründür. 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ıyor. Tişört 20 TL ve satılan malların maliyetinin 5 TL olduğunu varsayalım. Bu siparişin çapraz satıştan elde edilen brüt kârı 15 TL = 20 TL - 5 TL'dir. Bu metrik yalnızca alışveriş sepeti verileriyle dönüşümler raporlanıyorsa kullanılabilir. Bu metrik parasal bir değerdir ve varsayılan olarak müşterinin para biriminde döndürülür. https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause adresindeki metrics_currency parametresini inceleyebilirsiniz.

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 reklamla ilişkilendirilmiş bir ürün varsa (bkz. Alışveriş reklamları) bu ürün, reklamı yapılan ürün olarak kabul edilir. Satın alma işlemine dahil edilen tüm ürünler, satılan üründür. 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ıyor. Tişört 20 TL ve satılan malların maliyetinin 5 TL olduğunu varsayalım. Bu siparişin çapraz satıştan elde edilen brüt kârı 15 TL = 20 TL - 5 TL'dir. Bu metrik yalnızca alışveriş sepeti verileriyle dönüşümler raporlanıyorsa kullanılabilir. Bu metrik parasal bir değerdir ve varsayılan olarak müşterinin para biriminde döndürülür. https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause adresindeki metrics_currency parametresini inceleyebilirsiniz.

clientAccountCrossSellRevenueMicros

string (int64 format)

Müşteri hesabı ç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 reklamla ilişkilendirilmiş bir ürün varsa (bkz. Alışveriş reklamları) bu ürün, reklamı yapılan ürün olarak kabul edilir. Müşterinin verdiği siparişi eklenen her ürün, satılan üründür. 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ıyor. Şapka 10 TL, gömlek ise 20 TL'dir. Dolayısıyla bu siparişin çapraz satış geliri 20 TL'dir. Bu metrik yalnızca alışveriş sepeti verileriyle dönüşümler raporlanıyorsa kullanılabilir. Bu metrik parasal bir değerdir ve varsayılan olarak müşterinin para biriminde döndürülür. https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause adresindeki metrics_currency parametresini inceleyebilirsiniz.

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 reklamla ilişkilendirilmiş bir ürün varsa (bkz. Alışveriş reklamları) bu ürün, reklamı yapılan ürün olarak kabul edilir. Müşterinin verdiği siparişi eklenen her ürün, satılan üründür. 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ıyor. Şapka 10 TL, gömlek ise 20 TL'dir. Dolayısıyla bu siparişin çapraz satış geliri 20 TL'dir. Bu metrik yalnızca alışveriş sepeti verileriyle dönüşümler raporlanıyorsa kullanılabilir. Bu metrik parasal bir değerdir ve varsayılan olarak müşterinin para biriminde döndürülür. https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause adresindeki metrics_currency parametresini inceleyebilirsiniz.

clientAccountCrossSellUnitsSold

number

Müşteri hesabı çapraz satışla satılan birim sayısı, farklı bir ürünün reklamının yapılması sonucunda satılan ürünlerin toplam sayısıdır. İşleyiş şekli: Web sitenizde tamamlanan satın alma işlemleri için alışveriş sepeti verileriyle dönüşümleri raporlarsınız. Satın alma işleminden önce etkileşimde bulunulan reklamla ilişkilendirilmiş bir ürün varsa (bkz. Alışveriş reklamları) bu ürün, reklamı yapılan ürün olarak kabul edilir. Müşterinin verdiği siparişi eklenen her ürün, satılan üründür. 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ıyor. Bu siparişteki çapraz satışla satılan birim sayısı 2'dir. Bu metrik yalnızca alışveriş sepeti verileriyle dönüşümler raporlanıyorsa kullanılabilir.

crossSellUnitsSold

number

Çapraz satışla satılan birim sayısı, farklı bir ürünün reklamının yapılması sonucunda satılan ürünlerin toplam sayısıdır. İşleyiş şekli: Web sitenizde tamamlanan satın alma işlemleri için alışveriş sepeti verileriyle dönüşümleri raporlarsınız. Satın alma işleminden önce etkileşimde bulunulan reklamla ilişkilendirilmiş bir ürün varsa (bkz. Alışveriş reklamları) bu ürün, reklamı yapılan ürün olarak kabul edilir. Müşterinin verdiği siparişi eklenen her ürün, satılan üründür. 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ıyor. Bu siparişteki çapraz satışla satılan birim sayısı 2'dir. Bu metrik yalnızca alışveriş sepeti verileriyle dönüşümler raporlanıyorsa kullanılabilir.

clientAccountLeadCostOfGoodsSoldMicros

string (int64 format)

Müşteri hesabı reklamı yapıldıktan sonra satılan malların maliyeti (SMM), bir ürünün reklamının yapılması sonucunda 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 (bkz. Alışveriş reklamları) bu ürün, reklamı yapılan ürün olarak kabul edilir. Müşterinin verdiği siparişi eklenen her ürün, satılan üründür. Reklamı yapılan ürünlerle satılan ürünler eşleşiyorsa bu ürünlerin maliyeti, reklamı yapıldıktan sonra satılan malların maliyeti altında hesaplanır. Örnek: Bir müşteri, şapka tanıtılan bir Alışveriş reklamını tıklayıp söz konusu şapkayla birlikte bir gömlek satın alıyor. Şapkanın "satılan malların maliyeti" değerinin 3 TL, gömleğin "satılan malların maliyeti" değerinin ise 5 TL olduğunu varsayalım. Bu sipariş için "reklamı yapıldıktan sonra satılan malların maliyeti" değeri 3 TL'dir. Bu metrik yalnızca alışveriş sepeti verileriyle dönüşümler raporlanıyorsa kullanılabilir. Bu metrik parasal bir değerdir ve varsayılan olarak müşterinin para biriminde döndürülür. https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause adresindeki metrics_currency parametresini inceleyebilirsiniz.

leadCostOfGoodsSoldMicros

string (int64 format)

Reklamı yapıldıktan sonra satılan malların maliyeti (SMM), bir ürünün reklamının yapılması sonucunda bu üründen satılan birimlerin toplam maliyetidir. İşleyiş şekli: Web sitenizde tamamlanan satın alma işlemleri için alışveriş sepeti verileriyle dönüşümleri raporlarsınız. Etkileşimde bulunulan reklamla ilişkilendirilmiş bir ürün varsa (bkz. Alışveriş reklamları) bu ürün, reklamı yapılan ürün olarak kabul edilir. Müşterinin verdiği siparişi eklenen her ürün, satılan üründür. Reklamı yapılan ürünlerle satılan ürünler eşleşiyorsa bu ürünlerin maliyeti, reklamı yapıldıktan sonra satılan malların maliyeti altında hesaplanır. Örnek: Bir müşteri, şapka tanıtılan bir Alışveriş reklamını tıklayıp söz konusu şapkayla birlikte bir gömlek satın alıyor. Şapkanın "satılan malların maliyeti" değerinin 3 TL, gömleğin "satılan malların maliyeti" değerinin ise 5 TL olduğunu varsayalım. Bu sipariş için "reklamı yapıldıktan sonra satılan malların maliyeti" değeri 3 TL'dir. Bu metrik yalnızca alışveriş sepeti verileriyle dönüşümler raporlanıyorsa kullanılabilir. Bu metrik parasal bir değerdir ve varsayılan olarak müşterinin para biriminde döndürülür. https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause adresindeki metrics_currency parametresini inceleyebilirsiniz.

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 reklamla ilişkilendirilmiş bir ürün varsa (bkz. Alışveriş reklamları) bu ürün, reklamı yapılan ürün olarak kabul edilir. Müşterinin verdiği siparişi eklenen her ürün, satılan üründür. Reklamı yapılan ürünlerle satılan ürünler eşleşiyorsa "reklamı yapılan üründen elde edilen brüt kâr" değeriniz, bu satışlardan elde ettiğiniz gelirden satılan malların maliyeti çıkarılarak bulunur. Örnek: Bir müşteri, şapka tanıtılan bir Alışveriş reklamını tıklayıp söz konusu şapkayla birlikte bir gömlek satın alıyor. Şapka 10 TL, şapkanın "satılan malların maliyeti" değeri ise 3 TL'dir. Dolayısıyla, bu sipariş için "reklamı yapılan üründen elde edilen brüt kâr" değeri 7 TL (10 TL - 3 TL) olarak bulunur. Bu metrik yalnızca alışveriş sepeti verileriyle dönüşümler raporlanıyorsa kullanılabilir. Bu metrik parasal bir değerdir ve varsayılan olarak müşterinin para biriminde döndürülür. https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause adresindeki metrics_currency parametresini inceleyebilirsiniz.

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 reklamla ilişkilendirilmiş bir ürün varsa (bkz. Alışveriş reklamları) bu ürün, reklamı yapılan ürün olarak kabul edilir. Müşterinin verdiği siparişi eklenen her ürün, satılan üründür. Reklamı yapılan ürünlerle satılan ürünler eşleşiyorsa "reklamı yapılan üründen elde edilen brüt kâr" değeriniz, bu satışlardan elde ettiğiniz gelirden satılan malların maliyeti çıkarılarak bulunur. Örnek: Bir müşteri, şapka tanıtılan bir Alışveriş reklamını tıklayıp söz konusu şapkayla birlikte bir gömlek satın alıyor. Şapka 10 TL, şapkanın "satılan malların maliyeti" değeri ise 3 TL'dir. Dolayısıyla, bu sipariş için "reklamı yapılan üründen elde edilen brüt kâr" değeri 7 TL (10 TL - 3 TL) olarak bulunur. Bu metrik yalnızca alışveriş sepeti verileriyle dönüşümler raporlanıyorsa kullanılabilir. Bu metrik parasal bir değerdir ve varsayılan olarak müşterinin para biriminde döndürülür. https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause adresindeki metrics_currency parametresini inceleyebilirsiniz.

clientAccountLeadRevenueMicros

string (int64 format)

Müşteri hesabı potansiyel müşteri 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 reklamla ilişkilendirilmiş bir ürün varsa (bkz. Alışveriş reklamları) bu ürün, reklamı yapılan ürün olarak kabul edilir. Müşterinin verdiği siparişi eklenen her ürün, satılan üründür. Reklamı yapılan ürünlerle satılan ürünler eşleşiyorsa bu ürünlerin satışından elde ettiğiniz toplam değer, reklamı yapılan üründen elde edilen gelir altında gösterilir. Örnek: Bir müşteri, şapka tanıtılan bir Alışveriş reklamını tıklayıp söz konusu şapkayla birlikte bir gömlek satın alıyor. Şapka 10 TL, gömlek ise 20 TL'dir. Bu sipariş için "reklamı yapılan üründen elde edilen gelir" 10 TL'dir. Bu metrik yalnızca alışveriş sepeti verileriyle dönüşümler raporlanıyorsa kullanılabilir. Bu metrik parasal bir değerdir ve varsayılan olarak müşterinin para biriminde döndürülür. https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause adresindeki metrics_currency parametresini inceleyebilirsiniz.

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 reklamla ilişkilendirilmiş bir ürün varsa (bkz. Alışveriş reklamları) bu ürün, reklamı yapılan ürün olarak kabul edilir. Müşterinin verdiği siparişi eklenen her ürün, satılan üründür. Reklamı yapılan ürünlerle satılan ürünler eşleşiyorsa bu ürünlerin satışından elde ettiğiniz toplam değer, reklamı yapılan üründen elde edilen gelir altında gösterilir. Örnek: Bir müşteri, şapka tanıtılan bir Alışveriş reklamını tıklayıp söz konusu şapkayla birlikte bir gömlek satın alıyor. Şapka 10 TL, gömlek ise 20 TL'dir. Bu sipariş için "reklamı yapılan üründen elde edilen gelir" 10 TL'dir. Bu metrik yalnızca alışveriş sepeti verileriyle dönüşümler raporlanıyorsa kullanılabilir. Bu metrik parasal bir değerdir ve varsayılan olarak müşterinin para biriminde döndürülür. https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause adresindeki metrics_currency parametresini inceleyebilirsiniz.

clientAccountLeadUnitsSold

number

Müşteri hesabı potansiyel müşteri birimi sayısı, bir ürünün reklamının yapılması sonucunda satılan toplam ürün 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 reklamla ilişkilendirilmiş bir ürün varsa (bkz. Alışveriş reklamları) bu ürün, reklamı yapılan ürün olarak kabul edilir. Müşterinin verdiği siparişi eklenen her ürün, satılan üründür. Reklamı yapılan ürünlerle satılan ürünler eşleşiyorsa bu ürünlerin toplam sayısı, satılan potansiyel müşteri birimi sayısı altında gösterilir. Örnek: Bir müşteri, şapka tanıtılan bir Alışveriş reklamını tıklayıp söz konusu şapkayla birlikte bir gömlek ve ceket satın alıyor. Bu siparişte satılan potansiyel müşteri birimi sayısı 1'dir. Bu metrik yalnızca alışveriş sepeti verileriyle dönüşümler raporlanıyorsa kullanılabilir.

leadUnitsSold

number

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 reklamla ilişkilendirilmiş bir ürün varsa (bkz. Alışveriş reklamları) bu ürün, reklamı yapılan ürün olarak kabul edilir. Müşterinin verdiği siparişi eklenen her ürün, satılan üründür. Reklamı yapılan ürünlerle satılan ürünler eşleşiyorsa bu ürünlerin toplam sayısı, satılan potansiyel müşteri birimi sayısı altında gösterilir. Örnek: Bir müşteri, şapka tanıtılan bir Alışveriş reklamını tıklayıp söz konusu şapkayla birlikte bir gömlek ve ceket satın alıyor. Bu siparişte satılan potansiyel müşteri birimi sayısı 1'dir. Bu metrik yalnızca alışveriş sepeti verileriyle dönüşümler raporlanıyorsa kullanılabilir.

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. Değer value şunlardan yalnızca biri olabilir:
booleanValue

boolean

Boole.

int64Value

string (int64 format)

int64

floatValue

number

Kayan.

doubleValue

number

Çift kişilik.

stringValue

string

Dizedir.

QualityScoreBucket

Olası kalite puanı gruplarını listeleyen 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.
BELOW_AVERAGE Reklam öğesinin kalitesi ortalamanın altında.
AVERAGE Reklam öğesinin kalitesi ortalama.
ABOVE_AVERAGE Reklam öğesinin kalitesi ortalamanın üzerinde.

InteractionEventType

Olası ücretli ve ücretsiz etkileşim türlerini açıklayan 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.
CLICK Siteye gitmek için tıklayın. Çoğu durumda, bu etkileşim harici bir konuma (genellikle reklamverenin açılış sayfası) gider. Bu aynı zamanda tıklama etkinlikleri için varsayılan EngagementEventType'tır.
ENGAGEMENT Kullanıcının, reklamla yerinde etkileşim kurma niyetini ifade etmesi.
VIDEO_VIEW Kullanıcı, bir video reklamı görüntüledi.
NONE Reklam dönüşüm etkinlikleri için varsayılan EngagementEventType. Bu parametre, reklam dönüşümü satırı ücretsiz etkileşimlerin (örneğin, reklam dönüşümleri) "tanıtımı" olması gerektiğini İLGİ VERMEDİĞİNDE kullanılır. temel metriklerin bir parçası olarak raporlanır. Bunlar yalnızca diğer (reklam) dönüşümlerdir.

Segmentler

Salt segment alanları.

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

enum (AdNetworkType)

Reklam ağı türü.

conversionActionCategory

enum (ConversionActionCategory)

Dönüşüm işlemi kategorisi.

conversionCustomDimensions[]

object (Value)

Dönüşüm özel boyutları.

dayOfWeek

enum (DayOfWeek)

Haftanın günü (örneğin, PAZAR).

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

geoTargetCity

string

Bir şehri temsil eden coğrafi hedef sabitinin kaynak adı.

geoTargetCountry

string

Bir ülkeyi temsil eden coğrafi hedef sabitinin kaynak adı.

geoTargetMetro

string

Bir metropolü temsil eden coğrafi hedef sabitinin kaynak adı.

geoTargetRegion

string

Bir bölgeyi temsil eden coğrafi hedef sabitinin kaynak adı.

hour

integer

0 ile 23 arasında (bu değerler dahil) günün saati.

month

string

Bir ayın ilk gününün tarihiyle temsil edilen ay. yyyy-AA-gg olarak biçimlendirilmiştir.

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 (3. düzey).

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ış yapılan ü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. düzey).

productSoldBiddingCategoryLevel2

string

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

productSoldBiddingCategoryLevel3

string

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

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 başlığı.

productSoldTypeL1

string

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

productSoldTypeL2

string

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

productSoldTypeL3

string

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

productSoldTypeL4

string

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

productSoldTypeL5

string

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

productStoreId

string

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

productTitle

string

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

productTypeL1

string

Ürünün türü (1. seviye).

productTypeL2

string

Ürünün türü (2. seviye).

productTypeL3

string

Ürünün türü (3. seviye).

productTypeL4

string

Ürünün türü (4. seviye).

productTypeL5

string

Ürünün türü (5. seviye).

quarter

string

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

week

string

Hafta, pazartesiden pazara kadar tanımlanır ve pazartesi günüyle temsil edilir. yyyy-AA-gg olarak biçimlendirilmiştir.

year

integer

Yıl, yyyy biçimindedir.

assetInteractionTarget

object (AssetInteractionTarget)

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

AdNetworkType

Google Ads ağ türlerini belirtir.

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

Bir anahtar kelime ölçütü segmenti.

JSON gösterimi
{
  "info": {
    object (KeywordInfo)
  },
  "adGroupCriterion": string
}
Alanlar
info

object (KeywordInfo)

Anahtar kelime bilgileri.

adGroupCriterion

string

AdGroupCriterion kaynak adı.

ProductChannelExclusivity

Bir ürün teklifinin kullanılabilirliğini açıklayan 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.
SINGLE_CHANNEL Öğe, yalnızca yerel mağazalardan veya ProductChannel'da belirtildiği şekilde çevrimiçi olarak tek bir kanal üzerinden satılır.
MULTI_CHANNEL Öğe, online veya yerel mağazalardaki eşdeğeriyle eşlenir. Bu, her iki ShoppingProductChannels'da da satın alınabileceğini gösterir.

ProductCondition

Bir ürün teklifinin durumunu açıklayan 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.
OLD Ürünün durumu eski.
NEW Ürünün durumu yenidir.
REFURBISHED Ürün yenilenmiş durumda.
USED Ürün durumu kullanılır.

AssetInteractionTarget

AssetEtkileşimHedef 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 veya reklam biriminde mi gerçekleştiğini belirtir.