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)
  },
  "adGroupEffectiveLabel": {
    object (AdGroupEffectiveLabel)
  },
  "adGroupLabel": {
    object (AdGroupLabel)
  },
  "ageRangeView": {
    object (AgeRangeView)
  },
  "asset": {
    object (Asset)
  },
  "assetGroupAsset": {
    object (AssetGroupAsset)
  },
  "assetGroupSignal": {
    object (AssetGroupSignal)
  },
  "assetGroupListingGroupFilter": {
    object (AssetGroupListingGroupFilter)
  },
  "assetGroupTopCombinationView": {
    object (AssetGroupTopCombinationView)
  },
  "assetGroup": {
    object (AssetGroup)
  },
  "assetSetAsset": {
    object (AssetSetAsset)
  },
  "assetSet": {
    object (AssetSet)
  },
  "biddingStrategy": {
    object (BiddingStrategy)
  },
  "campaignBudget": {
    object (CampaignBudget)
  },
  "campaign": {
    object (Campaign)
  },
  "campaignAsset": {
    object (CampaignAsset)
  },
  "campaignAssetSet": {
    object (CampaignAssetSet)
  },
  "campaignAudienceView": {
    object (CampaignAudienceView)
  },
  "campaignCriterion": {
    object (CampaignCriterion)
  },
  "campaignEffectiveLabel": {
    object (CampaignEffectiveLabel)
  },
  "campaignLabel": {
    object (CampaignLabel)
  },
  "cartDataSalesView": {
    object (CartDataSalesView)
  },
  "audience": {
    object (Audience)
  },
  "conversionAction": {
    object (ConversionAction)
  },
  "conversionCustomVariable": {
    object (ConversionCustomVariable)
  },
  "customer": {
    object (Customer)
  },
  "customerAsset": {
    object (CustomerAsset)
  },
  "customerAssetSet": {
    object (CustomerAssetSet)
  },
  "accessibleBiddingStrategy": {
    object (AccessibleBiddingStrategy)
  },
  "customerManagerLink": {
    object (CustomerManagerLink)
  },
  "customerClient": {
    object (CustomerClient)
  },
  "dynamicSearchAdsSearchTermView": {
    object (DynamicSearchAdsSearchTermView)
  },
  "genderView": {
    object (GenderView)
  },
  "geoTargetConstant": {
    object (GeoTargetConstant)
  },
  "keywordView": {
    object (KeywordView)
  },
  "label": {
    object (Label)
  },
  "languageConstant": {
    object (LanguageConstant)
  },
  "locationView": {
    object (LocationView)
  },
  "productBiddingCategoryConstant": {
    object (ProductBiddingCategoryConstant)
  },
  "productGroupView": {
    object (ProductGroupView)
  },
  "shoppingPerformanceView": {
    object (ShoppingPerformanceView)
  },
  "userList": {
    object (UserList)
  },
  "webpageView": {
    object (WebpageView)
  },
  "visit": {
    object (Visit)
  },
  "conversion": {
    object (Conversion)
  },
  "metrics": {
    object (Metrics)
  },
  "segments": {
    object (Segments)
  },
  "customColumns": [
    {
      object (Value)
    }
  ]
}
Alanlar
adGroup

object (AdGroup)

Sorguda referans verilen reklam grubu.

adGroupAd

object (AdGroupAd)

Sorguda başvurulan reklam.

adGroupAdLabel

object (AdGroupAdLabel)

Sorguda referans verilen reklam grubu reklam etiketi.

adGroupAsset

object (AdGroupAsset)

Sorguda referans verilen reklam grubu öğesi.

adGroupAssetSet

object (AdGroupAssetSet)

Sorguda referans verilen reklam grubu öğe grubu.

adGroupAudienceView

object (AdGroupAudienceView)

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

adGroupBidModifier

object (AdGroupBidModifier)

Sorguda başvurulan teklif değiştirici.

adGroupCriterion

object (AdGroupCriterion)

Sorguda referans verilen ölçüt.

adGroupCriterionLabel

object (AdGroupCriterionLabel)

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

adGroupEffectiveLabel

object (AdGroupEffectiveLabel)

Sorguda referans verilen reklam grubunun etkili etiketi.

adGroupLabel

object (AdGroupLabel)

Sorguda referans verilen reklam grubu etiketi.

ageRangeView

object (AgeRangeView)

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

asset

object (Asset)

Sorguda referans verilen öğ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 referans verilen öğe grubu.

assetSetAsset

object (AssetSetAsset)

Sorguda referans verilen öğe grubu öğesi.

assetSet

object (AssetSet)

Sorguda referans verilen öğe grubu.

biddingStrategy

object (BiddingStrategy)

Sorguda referans verilen teklif stratejisi.

campaignBudget

object (CampaignBudget)

Sorguda referans verilen kampanya bütçesi.

campaign

object (Campaign)

Sorguda referans verilen kampanya.

campaignAsset

object (CampaignAsset)

Sorguda referans verilen kampanya öğesi.

campaignAssetSet

object (CampaignAssetSet)

Sorguda referans verilen kampanya öğe grubu.

campaignAudienceView

object (CampaignAudienceView)

Sorguda başvurulan kampanya kitle görünümü.

campaignCriterion

object (CampaignCriterion)

Sorguda referans verilen kampanya ölçütü.

campaignEffectiveLabel

object (CampaignEffectiveLabel)

Sorguda başvurulan kampanya etkili etiketi.

campaignLabel

object (CampaignLabel)

Sorguda referans verilen kampanya etiketi.

cartDataSalesView

object (CartDataSalesView)

Sorguda atıfta bulunulan alışveriş sepeti verileri satış görünümü.

audience

object (Audience)

Sorguda başvurulan kitle.

conversionAction

object (ConversionAction)

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

conversionCustomVariable

object (ConversionCustomVariable)

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

customer

object (Customer)

Sorguda referans verilen müşteri.

customerAsset

object (CustomerAsset)

Sorguda referans verilen müşteri öğesi.

customerAssetSet

object (CustomerAssetSet)

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

accessibleBiddingStrategy

object (AccessibleBiddingStrategy)

Sorguda atıfta bulunulan erişilebilir teklif stratejisi.

customerClient

object (CustomerClient)

Sorguda referans verilen CustomerClient.

dynamicSearchAdsSearchTermView

object (DynamicSearchAdsSearchTermView)

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

genderView

object (GenderView)

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

geoTargetConstant

object (GeoTargetConstant)

Sorguda referans verilen coğrafi hedef sabit değeri.

keywordView

object (KeywordView)

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

label

object (Label)

Sorguda başvurulan etiket.

languageConstant

object (LanguageConstant)

Sorguda referans verilen dil sabit değeri.

locationView

object (LocationView)

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

productBiddingCategoryConstant

object (ProductBiddingCategoryConstant)

Sorguda atıfta bulunulan ürün teklifi 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 referans verilen kullanıcı listesi.

webpageView

object (WebpageView)

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

visit

object (Visit)

Sorguda referans verilen etkinlik düzeyindeki ziyaret.

conversion

object (Conversion)

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

metrics

object (Metrics)

Metrikler.

segments

object (Segments)

Segmentler.

customColumns[]

object (Value)

Özel sütunlar.

Reklam Grubu

Reklam grubu.

JSON gösterimi
{
  "resourceName": string,
  "status": enum (AdGroupStatus),
  "type": enum (AdGroupType),
  "adRotationMode": enum (AdGroupAdRotationMode),
  "creationTime": string,
  "targetingSetting": {
    object (TargetingSetting)
  },
  "labels": [
    string
  ],
  "effectiveLabels": [
    string
  ],
  "engineId": string,
  "startDate": string,
  "endDate": string,
  "languageCode": string,
  "lastModifiedTime": string,
  "id": string,
  "name": string,
  "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" biçimindedir.

targetingSetting

object (TargetingSetting)

Hedeflemeyle ilgili özellikler için ayar.

labels[]

string

Bu reklam grubuna eklenmiş etiketlerin kaynak adları.

effectiveLabels[]

string

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

engineId

string

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

startDate

string

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

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

endDate

string

Reklam grubunun reklam yayınlamayı sonlandırdığı 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ı: https://docs.microsoft.com/en-us/advertising/guides/ad-languages?view=bingads-13#adlanguage

lastModifiedTime

string

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

id

string (int64 format)

Reklam grubunun kimliği.

name

string

Reklam grubunun adı.

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

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

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

cpcBidMicros

string (int64 format)

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

engineStatus

enum (AdGroupEngineStatus)

Reklam grubunun 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 değeridir.

ENABLED Reklam grubu etkinleştirilmiştir.
PAUSED Reklam grubu duraklatılmıştır.
REMOVED Reklam grubu kaldırılır.

AdGroupType

Bir reklam grubunun olası türlerini listeleyen bir enum.

Sıralamalar
UNSPECIFIED Tür belirtilmedi.
UNKNOWN

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

Bu, yalnızca yanıt değeridir.

SEARCH_STANDARD Arama Ağı kampanyaları için varsayılan reklam grubu türü.
DISPLAY_STANDARD Görüntülü Reklam Ağı kampanyaları için varsayılan reklam grubu türü.
SHOPPING_PRODUCT_ADS Standart ürün reklamları yayınlayan Alışveriş kampanyaları için reklam grubu türü.
SHOPPING_SHOWCASE_ADS Alışveriş sonuçlarında Vitrin veya Satıcı reklamları yayınlamakla sınırlı 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 Yayın içi (atlanabilir) TrueView video reklamları.
VIDEO_TRUE_VIEW_IN_DISPLAY Görüntülü TrueView (TrueView in-display) video reklamları.
VIDEO_NON_SKIPPABLE_IN_STREAM Atlanamayan yayın içi video reklamlar.
VIDEO_OUTSTREAM Yayın dışı video reklamlar.
SEARCH_DYNAMIC_ADS Dinamik Arama Ağı Reklamları reklam grupları için reklam grubu türü.
SHOPPING_COMPARISON_LISTING_ADS Alışveriş karşılaştırma listelemesi 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 değeridir.

OPTIMIZE Reklam grubu reklamlarını tıklama veya dönüşüm sayısına göre optimize edin.
ROTATE_FOREVER Eşit sıklıkta dönüşümlü olarak sonsuza kadar 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 hiçbir reklam yayınlanmıyor.
AD_GROUP_REMOVED Reklam grubu silindi.
AD_GROUP_DRAFT İlişkili reklam grubu hâlâ taslak halinde olduğundan bu reklam grubu için reklam yayınlanmıyor.
AD_GROUP_PAUSED Reklam grubu duraklatıldı.
AD_GROUP_SERVING Reklam grubu etkin ve şu anda reklam yayınlıyor.
AD_GROUP_SUBMITTED Reklam grubu gönderildi (Microsoft Bing Ads eski durumu).
CAMPAIGN_PAUSED Kampanya duraklatıldığı için bu reklam 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 hedefleme boyutu 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ştiricileri uygulayacağı ve hedeflemeyi etkilemeyeceği anlamına gelir. false değeri, bu ölçütlerin hem hedeflemeyi hem de teklif değiştiricileri uygulamayı kısıtlayacağı anlamına gelir.

TargetingDimension

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

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca döndürülen değer için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
KEYWORD Anahtar kelime ölçütleri (ör. "mars cruise"). KEYWORD, özel teklif boyutu olarak kullanılabilir. Anahtar kelimeler her zaman bir hedefleme boyutu olduğundan Hedef Kısıtlama ile "TÜMÜ" hedef boyutu olarak ayarlanamaz.
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 kullanılan konu ölçütleri (ör. Görüntülü Reklam Ağı ve Video hedeflemesi için kullanılan "category::Hayvanlar>Evcil Hayvanlar").
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 kategorileri, YouTube videoları 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 şekildedir:

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 diliminde ve "yyyy-AA-gg SS:dd:ss.ssssss" biçimindedir.

labels[]

string

Bu reklam grubu reklamına eklenmiş etiketlerin kaynak adları.

engineId

string

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

engineStatus

enum (AdGroupAdEngineStatus)

Reklamın harici arama motoru hesabındaki ek durumu. Olası durumlar (harici hesabın türüne bağlı olarak) etkin, uygun, inceleme beklemede vb. şeklindedir.

lastModifiedTime

string

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

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ştirilmiştir.
PAUSED Reklam grubu reklamı duraklatılır.
REMOVED Reklam grubu reklamı kaldırılır.

AdType

Bir reklamın olası türleri.

Sıralamalar
UNSPECIFIED Değer belirtilmedi.
UNKNOWN

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

Bu, yalnızca yanıt değeridir.

TEXT_AD Reklam bir metin reklamdır.
EXPANDED_TEXT_AD Reklam, genişletilmiş metin reklamdır.
CALL_ONLY_AD Reklam yalnızca telefon araması üreten bir reklamdır.
EXPANDED_DYNAMIC_SEARCH_AD Reklam, genişletilmiş dinamik arama ağı reklamı olmalı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ıdır.
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ı olmalıdır.
LEGACY_APP_INSTALL_AD Reklam, eski bir uygulama yükleme reklamıysa.
RESPONSIVE_DISPLAY_AD Reklam, duyarlı görüntülü reklamdır.
LOCAL_AD Reklam yerel bir reklamdır.
HTML5_UPLOAD_AD Reklam, HTML5_UPLOAD_AD ürün türüne sahip bir görüntülü ağ yükleme reklamıdır.
DYNAMIC_HTML5_AD Reklam, DYNAMIC_HTML5_* ürün türlerinden birine sahip bir görüntülü ağ yükleme reklamıdır.
APP_ENGAGEMENT_AD Reklam, uygulama etkileşim reklamıdır.
SHOPPING_COMPARISON_LISTING_AD Reklam, Alışveriş karşılaştırma girişi reklamıdır.
VIDEO_BUMPER_AD Video bumper reklam.
VIDEO_NON_SKIPPABLE_IN_STREAM_AD Atlanamayan yayın içi video reklam.
VIDEO_OUTSTREAM_AD Yayın dışı video reklamı.
VIDEO_TRUEVIEW_DISCOVERY_AD Video TrueView görüntülü reklam.
VIDEO_TRUEVIEW_IN_STREAM_AD Video TrueView yayın içi reklam.
VIDEO_RESPONSIVE_AD Duyarlı video 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

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
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "path1": string,
  "path2": string,
  "adTrackingId": string
}
Alanlar
headlines[]

object (AdTextAsset)

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

descriptions[]

object (AdTextAsset)

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

path1

string

Otomatik olarak oluşturulan görünür URL'ye 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.

AdTextAsset

Bir reklamda kullanılan metin öğesi.

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

string

Öğe metni.

SearchAds360ProductAdInfo

Bu türde alan yoktur.

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 incelenmek üzere işleniyor.
AD_GROUP_AD_PARTIALLY_INVALID Baidu: Reklam öğesi mobil cihazda geçersiz ancak masaüstünde geçerli.
AD_GROUP_AD_TO_BE_ACTIVATED Baidu: Reklam öğesi etkinleştirmeye hazır.
AD_GROUP_AD_NOT_REVIEWED Baidu: Reklam öğesi incelenmedi.
AD_GROUP_AD_ON_HOLD

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

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

AdGroupAdLabel

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

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

string

Reklam grubu reklam etiketinin kaynak adı. Reklam grubu reklam etiketi kaynak adları şu şekildedir: 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.

ownerCustomerId

string (int64 format)

Etiketin sahibi olan müşterinin kimliği.

AdGroupAsset

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

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

string

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

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

adGroup

string

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

asset

string

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

status

enum (AssetLinkStatus)

Reklam grubu öğesinin durumu.

AssetLinkStatus

Bir öğe bağlantısının durumlarını açıklayan 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. AdGroupAssetSet 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 öğe 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 öğe grubunun durumu. Salt okunur.

AssetSetLinkStatus

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

Sıralamalar
UNSPECIFIED Durum belirtilmedi.
UNKNOWN Alınan değer bu sürümde bilinmiyor. Bu, yalnızca yanıt değeridir.
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ılır.

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 olarak elde edilir.

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

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

AdGroupBidModifier

Bir reklam grubu teklif değiştiricisini temsil eder.

JSON gösterimi
{
  "resourceName": string,
  "bidModifier": number,

  // Union field criterion can be only one of the following:
  "device": {
    object (DeviceInfo)
  }
  // End of list of possible types for union field criterion.
}
Alanlar
resourceName

string

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

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

bidModifier

number

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

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

V5'ten itibaren oluşturma işlemlerinde gereklidir. criterion yalnızca aşağıdakilerden 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 şekildedir:

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

creationTime

string

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

status

enum (AdGroupCriterionStatus)

Ölçütün durumu.

Bu, 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, hariç tutulmadıkça kampanyalar varsayılan olarak tüm yaş gruplarındaki kullanıcılara gösterilir. Kullanıcı arayüzü, reklamları görmeye uygun oldukları için her yaş aralığını "etkin" olarak gösterir ancak pozitif bir ölçüt eklenmediği için AdGroupCriterion.status "kaldırıldı" olarak gösterilir.

qualityInfo

object (QualityInfo)

Ölçünün kalitesiyle ilgili bilgiler.

type

enum (CriterionType)

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

labels[]

string

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

positionEstimates

object (PositionEstimates)

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

finalUrls[]

string

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

engineId

string

Harici arama motoru 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 bunun yerine "adGroupCriterion.ölçüt_id" değerini kullanın.

lastModifiedTime

string

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

criterionId

string (int64 format)

Ölçütün kimliği.

adGroup

string

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

negative

boolean

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

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 teklif için değiştirici. Değiştirici 0,1 ile 10,0 arası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

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

trackingUrlTemplate

string

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

Birlik alanı criterion. Reklam grubu ölçütü.

Tam olarak bir tane ayarlanmalıdır. criterion yalnızca aşağıdakilerden 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 değeridir.

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

QualityInfo

Reklam grubu ölçütü kalite bilgilerini içeren bir kapsayıcı.

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

integer

Kalite puanı.

Google'ın bir değeri belirleyecek yeterli bilgisi yoksa bu alan doldurulmayabilir.

CriterionType

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

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca döndürülen değer için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
KEYWORD Anahtar kelime (ör. "mars cruise").
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ğı'ndaki bir konu hedefi (ör. "Evcil 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 ilişkin tahmini bir tutardır.

AdGroupCriterionEngineStatus

AdGroupCriterion motor durumlarını listeler.

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 incelenmek üzere işleniyor.
AD_GROUP_CRITERION_PARTIALLY_INVALID Baidu: Bir cihazın açılış sayfası geçersiz, diğer cihazın açılış sayfası geçerli.
AD_GROUP_CRITERION_TO_BE_ACTIVATED Baidu: Anahtar kelime Baidu hesap yönetimi tarafından oluşturulup duraklatıldı ve şimdi etkinleştirmeniz için hazır.
AD_GROUP_CRITERION_UNDER_REVIEW Baidu: Baidu tarafından incelenmek üzere işleniyor. Gemini: Ölçüt inceleniyor.
AD_GROUP_CRITERION_NOT_REVIEWED Baidu: İncelenecek ölçüt.
AD_GROUP_CRITERION_ON_HOLD

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

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

KeywordInfo

Bir anahtar kelime ölçütü.

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

enum (KeywordMatchType)

Anahtar kelimenin eşleme türü.

text

string

Anahtar 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

Giriş 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 Ürünlerin bazı listeleme boyutlarına göre alt bölümlere ayrılması. Bu düğümler, listeleme girişlerini hedeflemek için yayınlanmaz, yalnızca ağacın yapısını tanımlamak için kullanılır.
UNIT Teklif tanımlayan listeleme grubu birimi.

AgeRangeInfo

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

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

enum (AgeRangeType)

Yaş grubunun türü.

AgeRangeType

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

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca döndürülen değer için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
AGE_RANGE_18_24 18-24 yaş arası.
AGE_RANGE_25_34 25-34 yaş arasında.
AGE_RANGE_35_44 35-44 yaş aralığında.
AGE_RANGE_45_54 45-54 yaş arasında.
AGE_RANGE_55_64 55-64 yaş aralığı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ü. Reklamveren tarafından hedeflenmesi için tanımlanan bir kullanıcı listesini temsil eder.

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

string

Kullanıcı listesi kaynak adı.

WebpageInfo

Bir reklamverenin web sitesinin web sayfalarını hedefleme ölçütünü temsil eder.

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

object (WebpageConditionInfo)

Web sayfası hedefleme için koşullar veya mantıksal ifadeler. Web sayfası hedefleme koşullarının listesi, hedefleme için değerlendirilirken birlikte & operatörüyle birleştirilir. 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. Bu, web sitesi hedefine, negatif web sitesi hedefine ve reklam grubundaki ve kampanyadaki negatif anahtar kelimelere göre web sitesi kapsamının hesaplanmış yüzdesidir. Örneğin, kapsam 1 olarak döndürüldüğünde% 100 kapsama alanı olduğunu gösterir. Bu alan salt okunur.

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 sitesinin web sayfalarını hedefleme için mantıksal ifade.

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

enum (WebpageConditionOperand)

Web sayfası hedefleme koşulunun operandı.

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ünde web sayfası koşulu operatı.

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 operatör.
CATEGORY Web sayfası kategorisi hedefleme koşulunu belirten operatör.
PAGE_TITLE Web sayfası başlığı hedefleme koşulunu belirten operatör.
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ünde web sayfası koşul 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

Bir 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,
  "ownerCustomerId": string
}
Alanlar
resourceName

string

Reklam grubu ölçüt etiketinin kaynak adı. Reklam grubu ölçütü etiketi kaynak adları şu şekildedir: 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.

ownerCustomerId

string (int64 format)

Etiketin sahibi olan müşterinin kimliği.

AdGroupEffectiveLabel

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

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

string

Reklam grubu etkili etiketinin kaynak adı. Reklam grubu etkili etiketi kaynak adları şu şekildedir: customers/{customerId}/adGroupEffectiveLabels/{ad_group_id}~{label_id}

adGroup

string

Etkili etiketin eklendiği reklam grubu.

label

string

Reklam grubuna atanan etkili etiket.

ownerCustomerId

string (int64 format)

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

AdGroupLabel

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

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

string

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

adGroup

string

Etiketin eklendiği reklam grubu.

label

string

Reklam grubuna atanan etiket.

ownerCustomerId

string (int64 format)

Etiketin sahibi olan Müşteri'nin kimliği.

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, bir reklamın birden fazla reklamda paylaşılabilen bir parçasıdır. Resim (ImageAsset), video (YoutubeVideoAsset) vb. olabilir. Öğeler değiştirilemez ve kaldırılamaz. Bir öğenin yayınlanmasını durdurmak için öğeyi kullanan öğeden kaldırın.

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

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

string

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

customers/{customerId}/assets/{assetId}

type

enum (AssetType)

Öğenin türü.

finalUrls[]

string

Tüm alan adları arası yönlendirmelerden sonra olası nihai URL'lerin listesi.

status

enum (AssetStatus)

Öğenin durumu.

creationTime

string

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

lastModifiedTime

string

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

id

string (int64 format)

Öğenin kimliği.

name

string

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

trackingUrlTemplate

string

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

engineStatus

enum (AssetEngineStatus)

Bir öğenin Motor Durumu.

Birlik alanı asset_data. Öğenin türü. asset_data yalnızca aşağıdakilerden 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ş bir telefon öğesi.

callToActionAsset

object (CallToActionAsset)

Harekete geçirici mesaj öğesi.

locationAsset

object (UnifiedLocationAsset)

Birleştirilmiş bir 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 değeridir.
ENABLED Öğe etkinleştirilmiş olmalıdır.
REMOVED Öğe kaldırılır.
ARCHIVED Öğe arşivlendi.
PENDING_SYSTEM_GENERATED Öğe, kullanıcı incelemesi bekleyen sistem tarafından oluşturulmuştur.

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

YoutubeVideoAsset

YouTube öğesi.

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

string

YouTube videosunun başlığı.

youtubeVideoId

string

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

ImageAsset

Resim öğesi.

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

enum (MimeType)

Resim öğesinin MIME türü.

fullSize

object (ImageDimension)

Bu resmin orijinal boyutundaki meta verileri.

fileSize

string (int64 format)

Resim öğesinin bayt cinsinden dosya boyutu.

MimeType

MIME türü

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

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

Bu, yalnızca yanıt değeridir.

IMAGE_JPEG MIME türü image/jpeg.
IMAGE_GIF MIME türü image/gif.
IMAGE_PNG Resim/png MIME türü.
FLASH application/x-shockwave-flash MIME türü.
TEXT_HTML MIME türü text/html.
PDF application/pdf MIME türü.
MSWORD application/msword 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 MIME türü.
AUDIO_MP3 Ses/mp3 dosyasının MIME türü.
HTML5_AD_ZIP application/x-html5-ad-zip 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

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

TextAsset

Metin öğesi.

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

string

Metin öğesinin metin içeriği.

UnifiedCalloutAsset

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

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

string

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

startDate

string

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

endDate

string

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

adScheduleTargets[]

object (AdScheduleInfo)

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

useSearcherTimeZone

boolean

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

AdScheduleInfo

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

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

Aynı gün için en fazla altı reklam programı 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 planın sona erdiği bitiş saatinden sonraki dakika sayısı. Program, bitiş dakikasını içermez.

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 (bu değerler dahil) olmalıdır.

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

endHour

integer

24 saatlik saat biçiminde bitiş saati; 24, günü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 saatleri listeler. Örneğin, "ON BEŞ"

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

HaftanınGünü

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

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

description2

string

Site bağlantısının açıklamasının ikinci satırı. Ayarlanırsa uzunluk 1 ile 35 arasında (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 geçerli olduğu ve yayınlanmaya devam ettiği son tarih (yyyy-AA-gg biçiminde).

adScheduleTargets[]

object (AdScheduleInfo)

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

trackingId

string (int64 format)

Site bağlantısı öğesinin tıklamalarını izlemek için kullanılan kimlik. Bu bir Yahoo! Yalnızca Japonya alanı.

useSearcherTimeZone

boolean

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

mobilePreferred

boolean

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

UnifiedPageFeedAsset

Birleşik sayfa feed'i öğesi.

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

string

Reklamverenlerin hedeflemek istediği web sayfası.

labels[]

string

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

MobileAppAsset

Mobil uygulamayı temsil eden bir öğe.

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

string

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

appStore

enum (MobileAppVendor)

Zorunlu. Söz konusu uygulamayı dağıtan uygulama mağazası.

MobileAppVendor

Mobil uygulama tedarikçi firmanı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 uygulama mağazası için mobil uygulama tedarikçi firması.
GOOGLE_APP_STORE Google uygulama mağazası için mobil uygulama tedarikçi firması.

UnifiedCallAsset

Birleştirilmiş bir 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 öğesinin kendi telefon araması dönüşümü ayarını kullanıp kullanmayacağını, hesap düzeyindeki ayarı izleyip izleyemeyeceğini veya telefon araması dönüşümünü devre dışı bırakıp bırakmayacağını belirtir.

callConversionAction

string

Telefon araması dönüşümünü ilişkilendirecek dönüşüm işlemi. Ayarlanmazsa varsayılan dönüşüm işlemi kullanılır. Bu alanın etkisi yalnızca callConversionReportingState, USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION olarak ayarlanmışsa geçerlidir.

adScheduleTargets[]

object (AdScheduleInfo)

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

callOnly

boolean

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

callTrackingEnabled

boolean

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

useSearcherTimeZone

boolean

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

startDate

string

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

endDate

string

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

CallConversionReportingState

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 araması 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 bir enum.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca döndürülen değer için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
LEARN_MORE Harekete geçirici mesaj türü daha fazla bilgi edinmedir.
GET_QUOTE Harekete geçirici mesaj türü "Teklif al"dır.
APPLY_NOW Harekete geçirici mesaj türü "Şimdi başvur".
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 olma.
DOWNLOAD Harekete geçirici mesaj türü indirmedir.
BOOK_NOW Harekete geçirici mesaj türü "Hemen rezervasyon yap"tır.
SHOP_NOW Harekete geçirici mesaj türü "Hemen alışveriş yap"tır.
BUY_NOW Harekete geçirici mesaj türü "Hemen satın alın"dır.
DONATE_NOW Harekete geçirici mesaj türü "Hemen bağış yapın".
ORDER_NOW Harekete geçirici mesaj türü "Hemen sipariş ver".
PLAY_NOW Harekete geçirici mesaj türü "Şimdi oyna".
SEE_MORE Harekete geçirici mesaj türü, "daha fazla göster"dir.
START_NOW Harekete geçirici mesaj türü "Hemen başla".
VISIT_SITE Harekete geçirici mesaj türü siteyi ziyaret etmektir.
WATCH_NOW Harekete geçirici mesaj türü "Şimdi izle".

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. Place-ID hakkında daha fazla bilgi edinmek için https://developers.google.com/places/web-service/place-id adresini inceleyin.

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şi olabilir.

locationOwnershipType

enum (LocationOwnershipType)

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

BusinessProfileLocation

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

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

string

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

storeCode

string

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

listingId

string (int64 format)

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

LocationOwnershipType

Olası konum sahipliği türleri.

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

AssetGroupAsset

AssetGroupAsset, bir öğe ile öğe grubu arasındaki bağlantıdır. AssetGroupAsset eklemek, bir öğeyi bir öğ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 kaynağı adı şu biçimdedir:

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

assetGroup

string

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

asset

string

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

fieldType

enum (AssetFieldType)

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

status

enum (AssetLinkStatus)

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

AssetFieldType

Bir öğenin olası yerleşimlerini açıklayan bir enum.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca döndürülen değer için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
HEADLINE Öğe, başlık olarak kullanılmak üzere bağlanmıştır.
DESCRIPTION Öğe, açıklama olarak kullanılmak üzere bağlanmıştır.
MANDATORY_AD_TEXT Öğe, zorunlu reklam metni olarak kullanılmak üzere bağlanmıştır.
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ğlanır.
BOOK_ON_GOOGLE Öğe, bir otel kampanyasının "Google'da Rezervasyon"un etkin olduğunu gösterecek şekilde bağlantılıdır.
LEAD_FORM Öğe, potansiyel müşteri formu uzantısı olarak kullanılmak üzere bağlanmıştır.
PROMOTION Öğe, promosyon uzantısı olarak kullanılmak üzere bağlanmıştır.
CALLOUT Öğe, açıklama metni uzantısı olarak kullanılmak üzere bağlanmıştır.
STRUCTURED_SNIPPET Öğe, Ek Açıklamalı Snippet uzantısı olarak kullanılmak üzere bağlanmış.
MOBILE_APP Öğe, mobil uygulama uzantısı olarak kullanılmak üzere bağlanmıştır.
HOTEL_CALLOUT Öğe, otel açıklama metni uzantısı olarak kullanılmak üzere bağlanmıştır.
CALL Öğe, telefon uzantısı olarak kullanılmak üzere bağlanmıştır.
PRICE Öğe, fiyat uzantısı olarak kullanılmak üzere bağlanmış.
LONG_HEADLINE Öğe, uzun bir başlık olarak kullanılmak üzere bağlanmıştır.
BUSINESS_NAME Öğe, işletme adı olarak kullanılmak üzere bağlanmıştır.
SQUARE_MARKETING_IMAGE Öğe, kare pazarlama görseli olarak kullanılmak üzere bağlanmıştır.
PORTRAIT_MARKETING_IMAGE Öğe, dikey pazarlama görseli olarak kullanılmak üzere bağlanmıştır.
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ğlanır.
HOTEL_PROPERTY Öğe, seyahat hedefleri için Maksimum Performans kampanyasında otel mülkü olarak kullanılmak üzere bağlanır.

AssetGroupSignal

AssetGroupSignal, bir öğe grubundaki bir sinyali temsil eder. Sinyal varlığı, dönüşüm gerçekleştirme olasılığı en yüksek olan kullanıcıları Maksimum Performans kampanyasına bildirir. Maksimum Performans kampanyaları; Arama, Görüntülü Reklam Ağı, video ve diğer platformlar genelinde dönüşüm bulmak amacıyla benzer veya daha güçlü amaca sahip yeni kullanıcıları aramak için 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 sinyali kaynak adı şu biçimdedir:

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

assetGroup

string

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

Birlik 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 filtresi kaynak adı şu şekildedir:

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

assetGroup

string

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

id

string (int64 format)

ListingGroupFilter öğesinin kimliği.

type

enum (ListingGroupFilterType)

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

vertical

enum (ListingGroupFilterVertical)

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

caseValue

object (ListingGroupFilterDimension)

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

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 Ürünlerin bazı listeleme boyutlarına göre alt bölümlere ayrılması.
UNIT_INCLUDED Dahil edilen bir listeleme grubu filtresi yaprak düğümü.
UNIT_EXCLUDED Hariç tutulan listeleme grubu filtresi yaprak düğümü.

ListingGroupFilterVertical

Dikey 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.
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 listeleme boyutları.

JSON gösterimi
{

  // Union field dimension can be only one of the following:
  "productBiddingCategory": {
    object (ProductBiddingCategory)
  },
  "productBrand": {
    object (ProductBrand)
  },
  "productChannel": {
    object (ProductChannel)
  },
  "productCondition": {
    object (ProductCondition)
  },
  "productCustomAttribute": {
    object (ProductCustomAttribute)
  },
  "productItemId": {
    object (ProductItemId)
  },
  "productType": {
    object (ProductType)
  }
  // End of list of possible types for union field dimension.
}
Alanlar
Birlik 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 kategorisi.

productBrand

object (ProductBrand)

Ürün teklifinin markası.

productChannel

object (ProductChannel)

Ürün teklifinin bulunduğu yer.

productCondition

object (ProductCondition)

Bir ürün teklifinin durumudur.

productCustomAttribute

object (ProductCustomAttribute)

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

productItemId

object (ProductItemId)

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

productType

object (ProductType)

Ürün teklifinin türü.

ProductBiddingCategory

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

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

enum (ListingGroupFilterBiddingCategoryLevel)

Sınıflandırmadaki kategorinin seviyesini 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 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. seviye.
LEVEL2 2. seviye.
LEVEL3 3. seviye.
LEVEL4 4. seviye.
LEVEL5 5. seviye.

ProductBrand

Ürünün markası.

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

string

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

ProductChannel

Ürün teklifinin bulunduğu yer.

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

enum (ListingGroupFilterProductChannel)

Yerin değeri.

ListingGroupFilterProductChannel

Bir ürün teklifinin bulunduğu yeri açıklayan bir enum.

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

ProductCondition

Ürün teklifinin durumu.

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

enum (ListingGroupFilterProductCondition)

Koşulun değeri.

ListingGroupFilterProductCondition

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

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca döndürülen değer için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
NEW Ürünün durumu yenidir.
REFURBISHED Ürün yenilenmiş durumda.
USED Ürün durumu "kullanılmış"tı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 özelliği.
INDEX4 Beşinci listeleme grubu filtresi özel özelliği.

ProductItemId

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

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

string

Kimliğin değeri.

ProductType

Ürün teklifinin türü.

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

enum (ListingGroupFilterProductTypeLevel)

Türün düzeyi.

value

string

Türün değeri.

ListingGroupFilterProductTypeLevel

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

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

ListingGroupFilterDimensionPath

Giriş grubu filtresini tanımlayan boyutları tanımlayan yol.

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

object (ListingGroupFilterDimension)

Boyutların, listeleme grubu filtresi hiyerarşisi (kök düğüm hariç) üzerinden bu listeleme grubu filtresine giden 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 en iyi kombinasyon görünümünün kaynak adı. AssetGroup Top Combination görünümü kaynak adları şu biçimdedir: "customers/{customerId}/assetGroupTopCombinationViews/{asset_group_id}~{asset_combination_category}"

assetGroupTopCombinations[]

object (AssetGroupAssetCombinationData)

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

AssetGroupAssetCombinationData

Öğe grubu öğe kombinasyonu verileri

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

object (AssetUsage)

Yayınlanan öğeler.

AssetUsage

Öğenin kullanım bilgilerini içerir.

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

string

Öğenin kaynak adı.

servedAssetFieldType

enum (ServedAssetFieldType)

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

ServedAssetFieldType

Olası öğe alanı türleri.

Sıralamalar
UNSPECIFIED Değer belirtilmedi.
UNKNOWN

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

Bu, yalnızca yanıt değeridir.

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, 3. başlıkta kullanılıyor.
DESCRIPTION_1 Öğe, 1. açıklamada kullanılıyor.
DESCRIPTION_2 Öğe, 2. açıklamada kullanılıyor.
HEADLINE Öğe bir başlıkta kullanıldı. Bunu yalnızca reklamda tek bir başlık varsa kullanın. Aksi takdirde HEADLINE_1, HEADLINE_2 veya HEADLINE_3 enum'ları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ı (MultiAssetResponsiveAd'da kullanıldı).
DESCRIPTION Öğe bir açıklamada kullanıldı. Bu özelliği yalnızca reklamda tek 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ılıyordu.
MARKETING_IMAGE_IN_PORTRAIT Öğe, dikey resimde pazarlama resmi olarak kullanıldı.
SQUARE_MARKETING_IMAGE Öğe, kare pazarlama resmi olarak kullanıldı.
PORTRAIT_MARKETING_IMAGE Öğe, dikey pazarlama görseli olarak kullanılıyordu.
CALL_TO_ACTION Öğe, harekete geçirici mesaj olarak kullanıldı.
YOU_TUBE_VIDEO Öğe, YouTube videosu olarak kullanıldı.
CALL Bu öğe, çağrı olarak kullanılır.
MOBILE_APP Bu öğe mobil uygulama olarak kullanılır.
CALLOUT Bu öğe açıklama metni olarak kullanılıyor.
STRUCTURED_SNIPPET Bu öğe, ek açıklamalı snippet olarak kullanılır.
PRICE Bu öğe fiyat olarak kullanılır.
PROMOTION Bu öğe promosyon olarak kullanılır.
AD_IMAGE Bu öğe resim olarak kullanılır.
LEAD_FORM Öğe, potansiyel müşteri formu olarak kullanılır.

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 biçimdedir:

customers/{customerId}/assetGroups/{asset_group_id}

id

string (int64 format)

Öğe grubunun kimliği.

campaign

string

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

name

string

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

finalUrls[]

string

Tüm alan adı yönlendirmelerinden sonraki nihai URL'lerin listesi. Maksimum Performans kampanyalarında, devre dışı bırakılmadıkça URL'ler varsayılan olarak genişletmeye uygundur.

finalMobileUrls[]

string

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

status

enum (AssetGroupStatus)

Öğe grubunun durumu.

path1

string

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

path2

string

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

adStrength

enum (AdStrength)

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

AssetGroupStatus

Bir öğe grubunun olası durumları.

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

AdStrength

Olası reklam güçlerini listeleyen bir 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.
PENDING Reklam gücü şu anda beklemede.
NO_ADS Hiçbir reklam oluşturulamadı.
POOR Zayıf güç.
AVERAGE Ortalama güç.
GOOD İyi bir güç.
EXCELLENT Mükemmel bir 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 feed öğesinin bağlantı verdiği öğe grubu.

asset

string

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

status

enum (AssetSetAssetStatus)

Feed öğesinin durumu. Salt okunur.

AssetSetAssetStatus

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

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

AssetSet

Bir öğe grubunu 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ı. Varlık 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 okunur.

type

enum (BiddingStrategyType)

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

Bu alan salt okunur.

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. Yayın yapan müşteriler için bu alan ayarlanamaz. Yayın yapan müşterideki tüm stratejiler, yayın yapan müşterinin para birimini dolaylı olarak kullanır. effectiveCurrencyCode alanı her durumda strateji tarafından kullanılan para birimini döndürür.

id

string (int64 format)

Teklif stratejisinin kimliği.

name

string

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

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

effectiveCurrencyCode

string

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

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

Teklif stratejisi metrikleri bu para biriminde raporlanır.

Bu alan salt okunur.

campaignCount

string (int64 format)

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

Bu alan salt okunur.

nonRemovedCampaignCount

string (int64 format)

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

Bu alan salt okunurdur.

Birlik alanı scheme. Teklif şeması.

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

enhancedCpc

object (EnhancedCpc)

Dönüşümle sonuçlanma olasılığı daha yüksek olan tıklamalar için teklifleri artıran ve bu olasılığın daha düşük olduğu tıklamalar için teklifleri düşüren bir teklif stratejisi.

maximizeConversionValue

object (MaximizeConversionValue)

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

maximizeConversions

object (MaximizeConversions)

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

targetCpa

object (TargetCpa)

Teklifleri, belirlediğiniz hedef edinme başına maliyet (EBM) hedefiyle olabildiğince çok dönüşüm elde etmenizi sağlamaya 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 rakipten daha üst sıralarda yer alması gereken açık artırmaların hedef kesrine göre teklifler belirleyen bir teklif stratejisi. Bu alan kullanımdan kaldırılmıştır. Bu alanla yeni bir teklif stratejisi oluşturmak veya bu alanla teklif stratejilerini bir kampanyaya eklemek başarısız olur. Bu şemanın doldurulduğu stratejilere mutasyona izin verilir.

targetRoas

object (TargetRoas)

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

targetSpend

object (TargetSpend)

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

BiddingStrategyStatus

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 değeridir.

ENABLED Teklif stratejisi etkindir.
REMOVED Teklif stratejisi kaldırılır.

BiddingStrategyType

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

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca döndürülen değer için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
COMMISSION Komisyon, reklamverenin dönüşüm değerinin belirli bir bölümünü ödediği otomatik bir teklif stratejisidir.
ENHANCED_CPC Geliştirilmiş TBM, dönüşümle sonuçlanma olasılığı daha yüksek olan tıklamalar için teklifleri yükselten ve dönüşüm sağlama olasılığının daha düşük olduğu tıklamalar için teklifleri düşüren bir teklif stratejisidir.
INVALID Yalnızca döndürülen değer için kullanılır. Bir 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, artık erişilemeyen yönetici teklif stratejisinden otomatik olarak ayrılır ve geçersiz teklif stratejisi türüne geçer.
MANUAL_CPA Reklamverenin, reklamveren tarafından belirtilen işlem başına teklifi belirlemesine olanak tanıyan manuel teklif verme stratejisi.
MANUAL_CPC Kullanıcının tıklama başına ödeme yaptığı manuel tıklamaya dayalı teklif.
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 teklif stratejisi.
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 Maksimum TBM tekliflerini, google.com'daki ilk sayfadaki veya ilk sayfadaki tanıtılan slotlardaki gösterimleri hedefleyecek şekilde ayarlayan Sayfa Bir Tanıtılan Teklif Düzenlemesi. Bu enum değeri kullanımdan kaldırılmıştır.
PERCENT_CPC Yüzde TBM, tekliflerin bir ürün veya hizmetin reklamı yapılan fiyatının bir kısmını oluşturduğu teklif stratejisidir.
TARGET_CPA Hedef EBM, tekliflerinizi, belirlediğiniz hedef edinme başına maliyetle (EBM) mümkün olduğunca fazla dönüşüm elde etmenizi sağlayacak şekilde ayarlayan otomatik teklif stratejisidir.
TARGET_CPM Hedef BGBM, tekliflerinizi, belirlediğiniz hedef bin gösterim başına maliyetle (BGBM) mümkün olduğunca fazla gösterim elde etmenizi sağlayacak şekilde ayarlayan otomatik teklif stratejisidir.
TARGET_IMPRESSION_SHARE Teklifleri, arama ağı reklamlarının belirli bir yüzdesinin ilk sayfanın üst kısmında (veya hedeflenen diğer konumda) gösterileceği şekilde ayarlayan otomatik teklif stratejisi.
TARGET_OUTRANK_SHARE Hedef Geçiş Payı, reklamverenin belirli bir rakipten daha üst sıralarda yer alması gereken açık artırmaların hedef kesrine göre teklifleri ayarlayan bir otomatik teklif stratejisidir. Bu enum değeri kullanımdan kaldırılmıştır.
TARGET_ROAS Hedef ROAS, belirli bir hedef ortalama harcamalardan elde edilen geliri (ROAS) ortalama bir değerde tutarken geliri en üst düzeye çıkarmanıza yardımcı olan otomatik bir teklif stratejisidir.
TARGET_SPEND Hedef Harcama, tekliflerinizi bütçeniz dahilinde olabildiğince çok sayıda tıklama almanıza yardımcı olacak şekilde ayarlayan otomatik bir teklif stratejisidir.

EnhancedCpc

Bu türde alan yok.

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

Bu teklif stratejisinin desteği sonlandırıldı ve artık oluşturulamıyor. Eşdeğer işlev için enhancedCpcEnabled özelliği true olarak ayarlanmışken ManualCpc'yi kullanın.

MaximizeConversionValue

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

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

string (int64 format)

Teklif stratejisi tarafından belirlenebilecek maksimum teklif sınırı. 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 belirlenebilecek minimum teklif sınırı. Sınır, strateji tarafından yönetilen tüm anahtar kelimeler için geçerlidir. Yalnızca portföy teklifi stratejileri için değişebilir.

targetRoas

number

Reklam harcamalarından elde edilen gelir (ROAS) hedefi seçeneği. Ayarlanırsa teklif stratejisi, 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 ayarlanmamışsa teklif stratejisi, bütçe için mümkün olan en yüksek ROAS'ı elde etmeyi 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 belirlenebilecek maksimum teklif sınırı. Sınır, strateji tarafından yönetilen tüm anahtar kelimeler için geçerlidir. Yalnızca portföy teklifi stratejileri için değişebilir.

cpcBidFloorMicros

string (int64 format)

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

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, hedef işlem başına maliyeti aşmayacak şekilde mümkün olduğunca fazla dönüşüm elde eder. Hedef EBM ayarlanmazsa teklif stratejisi, bütçeye göre 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 etmenizi sağlayacak şekilde ayarlayan bir otomatik teklif stratejisidir.

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

string (int64 format)

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

cpcBidCeilingMicros

string (int64 format)

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

cpcBidFloorMicros

string (int64 format)

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

TargetImpressionShare

Teklifleri, arama ağı reklamlarının belirli bir yüzdesinin ilk sayfanın üst kısmında (veya hedeflenen diğer konumda) gösterileceği şekilde ayarlayan otomatik teklif stratejisi.

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

cpcBidCeilingMicros

string (int64 format)

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

TargetImpressionShareLocation

Olası hedefleri açıklayan bir enum.

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

TargetOutrankShare

Reklamverenin belirli bir rakipten daha üst sıralarda yer alması gereken açık artırmaların hedef kesrine göre teklifler belirleyen otomatik teklif stratejisi. Bu stratejinin desteği sonlandırılmıştır.

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

string (Int64Value format)

Teklif stratejisi tarafından belirlenebilecek maksimum teklif sınırı. 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 1.000,0 (başlangıç ve bitiş değerleri dahil) arasında olmalıdır.

cpcBidCeilingMicros

string (int64 format)

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

cpcBidFloorMicros

string (int64 format)

Teklif stratejisi tarafından belirlenebilecek minimum teklif sınırı. Sınır, strateji tarafından yönetilen tüm anahtar kelimeler için geçerlidir. Bu ayar yalnızca portföy teklifi stratejileri için yapılmalı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)

Desteği sonlandırıldı: Tıklamaların en üst düzeye çıkarılacağı harcama hedefi. TargetSpend teklif vereni, bu değer ile doğal akış kısıtlaması harcama tutarı arasından daha küçük olanı harcamaya çalışır. Belirtilmezse bütçe, harcama hedefi olarak kullanılır. Bu alanın desteği sonlandırıldı ve artık kullanılmamalıdır. Ayrıntılar için https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html adresini inceleyin.

cpcBidCeilingMicros

string (int64 format)

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

CampaignBudget

Kampanya bütçesi.

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

string

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

customers/{customerId}/campaignBudgets/{campaign_budget_id}

deliveryMethod

enum (BudgetDeliveryMethod)

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

Oluşturma işleminde belirtilmezse varsayılan olarak STANDARD olur.

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 biriminde bütçe tutarı. Tutar, mikro cinsinden belirtilir. Bir milyon, bir para birimine karşılık gelir. 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, yayını tüm dönem boyunca eşit şekilde kısıtlar.
ACCELERATED Bütçe sunucusu yayını kısıtlamaz ve reklamlar olabildiğince hızlı yayınlanır.

BudgetPeriod

Bütçenin olası dönemi.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca döndürülen değer için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
DAILY Günlük bütçe.
FIXED_DAILY Sabit günlük bütçe.
CUSTOM_PERIOD Özel bütçe, ömür boyu bütçe sınırını belirtmek için total_amount ile 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)
  },
  "effectiveLabels": [
    string
  ],
  "labels": [
    string
  ],
  "biddingStrategyType": enum (BiddingStrategyType),
  "accessibleBiddingStrategy": string,
  "frequencyCaps": [
    {
      object (FrequencyCapEntry)
    }
  ],
  "selectiveOptimization": {
    object (SelectiveOptimization)
  },
  "optimizationGoalSetting": {
    object (OptimizationGoalSetting)
  },
  "trackingSetting": {
    object (TrackingSetting)
  },
  "engineId": string,
  "excludedParentAssetFieldTypes": [
    enum (AssetFieldType)
  ],
  "createTime": string,
  "creationTime": string,
  "lastModifiedTime": string,
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "campaignBudget": string,
  "startDate": string,
  "endDate": string,
  "finalUrlSuffix": string,
  "urlExpansionOptOut": boolean,

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

string

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

customers/{customerId}/campaigns/{campaign_id}

status

enum (CampaignStatus)

Kampanyanın durumu.

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

servingStatus

enum (CampaignServingStatus)

Kampanyanın reklam sunma durumu.

biddingStrategySystemStatus

enum (BiddingStrategySystemStatus)

Kampanyanın teklif stratejisinin sistem durumu.

adServingOptimizationStatus

enum (AdServingOptimizationStatus)

Kampanyanın reklam sunma optimizasyonu durumu.

advertisingChannelType

enum (AdvertisingChannelType)

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

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

Yalnızca kampanya oluştururken ayarlanabilir. Alan, kampanya oluşturulduktan sonra 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çindeki özel parametre etiketlerinin yerine geçmek 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)

Reklamların coğrafi hedefleme ayarı.

effectiveLabels[]

string

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

labels[]

string

Bu kampanyaya eklenmiş 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 okunur.

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. Sınırsız strateji özellikleri, stratejinin paylaşıldığı tüm müşteriler tarafından kullanılabilir ve AccessibleBiddingStrategy kaynağından okunur. Buna karşılık, kısıtlanmış özellikler yalnızca stratejinin sahibi olan müşteri ve yöneticileri tarafından kullanılabilir. Kısıtlanmış özellikler yalnızca BiddingStrategy kaynağından okunabilir.

frequencyCaps[]

object (FrequencyCapEntry)

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

selectiveOptimization

object (SelectiveOptimization)

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

optimizationGoalSetting

object (OptimizationGoalSetting)

Bu kampanya için 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 arama motoru hesabındaki kampanyanın kimliği. Bu alan yalnızca Google Ads dışı hesaplar (ör. Yahoo Japan, Microsoft, Baidu vb.) içindir. Google Ads öğesi için bunun yerine "campaign.id" değerini kullanın.

excludedParentAssetFieldTypes[]

enum (AssetFieldType)

Bu kampanyadan hariç tutulması gereken öğe alanı türleri. Bu alan türlerine sahip öğe bağlantıları, üst düzeyden bu kampanya tarafından 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" biçimindedir. createTime, v1 sürümünde kullanımdan kaldırılacaktır. Bunun yerine creationTime parametresini 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" biçimindedir.

lastModifiedTime

string

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

id

string (int64 format)

Kampanyanın kimliği.

name

string

Kampanyanın adı.

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

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

trackingUrlTemplate

string

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

campaignBudget

string

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

startDate

string

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

endDate

string

Müşterinin saat diliminde kampanyanın son günü (YYYY-AA-GG biçiminde). 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 hedefli 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ştirildiyse (false) alanın tamamı hedeflenir. Bu alan yalnızca varsayılan değerin yanlış olduğu Maksimum Performans kampanyaları için ayarlanabilir.

Birlik alanı campaign_bidding_strategy. Kampanyanın teklif stratejisi.

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

biddingStrategy

string

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

manualCpa

object (ManualCpa)

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

manualCpc

object (ManualCpc)

Standart manuel TBM teklif stratejisi. Kullanıcının tıklama başına ödeme yaptığı manuel tıklama tabanlı 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çenizi harcarken dönüşüm sayısını otomatik olarak en üst düzeye çıkaran standart dönüşümleri artırma teklif stratejisi.

maximizeConversionValue

object (MaximizeConversionValue)

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

targetCpa

object (TargetCpa)

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

targetImpressionShare

object (TargetImpressionShare)

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

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 hizmetin reklamı yapılan fiyatının bir kısmını oluşturduğu standart yüzde TBM teklif stratejisi.

targetCpm

object (TargetCpm)

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

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 değeridir.

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 bir bütçe değişikliği nedeniyle öğreniyor.
LEARNING_COMPOSITION_CHANGE Teklif stratejisi, kendisine bağlı kampanya, reklam grubu veya anahtar kelime sayısında yapılan 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 tavanı ile sınırlıdır.
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 Harcamasının önceliği kaldırıldığı için teklif stratejisi 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 harcayamıyor.
MISCONFIGURED_ZERO_ELIGIBILITY SSC için dönüşüm izleme (ping yok) ve/veya yeniden pazarlama listeleri eksik.
MISCONFIGURED_CONVERSION_TYPES Teklif stratejisi dönüşüm raporlarına bağlıdır ve müşterinin 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, stratejiye dahil edilen kampanyalarla bütçe paylaşan kampanyalar var.
MISCONFIGURED_STRATEGY_TYPE Kampanya geçersiz bir strateji türüne sahip ve yayınlanmıyor.
PAUSED Teklif stratejisi etkin değil. Teklif stratejisine bağlı etkin kampanya, reklam grubu veya anahtar kelime yoktur. Veya teklif stratejisine bağlı etkin bütçe yok.
UNAVAILABLE Bu teklif stratejisi şu anda durum raporlamasını desteklemiyor.
MULTIPLE_LEARNING Söz konusu dönemde bu teklif stratejisi için birden fazla LEARNING_* sistem durumu vardı.
MULTIPLE_LIMITED Söz konusu dönemde bu teklif stratejisi için birden fazla 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 değeridir.

OPTIMIZE Reklam sunumu, kampanyanın TO'suna göre optimize edilir.
CONVERSION_OPTIMIZE Reklam sunumu, kampanyanın TO * Dönüşüm değerine göre optimize edilir. Kampanya, dönüşüm optimize edici teklif stratejisinde değilse varsayılan olarak OPTİMİZE EDİLDİ olarak ayarlanır.
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 performanslı reklamları daha yüksek performanslı reklamlarla daha dengeli bir şekilde gösterin ve optimizasyon yapmayın.
UNAVAILABLE Reklam sunma optimizasyonu durumu kullanılamaz.

AdvertisingChannelType

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

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

AdvertisingChannelSubType

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

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca döndürülen değer olarak kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
SEARCH_MOBILE_APP Arama Ağı için mobil uygulama kampanyaları
DISPLAY_MOBILE_APP Görüntülü Reklam Ağı için mobil uygulama kampanyaları.
SEARCH_EXPRESS Arama Ağı için AdWords Express kampanyaları.
DISPLAY_EXPRESS Görüntülü Reklam Ağı için AdWords Express kampanyaları.
SHOPPING_SMART_ADS Akıllı Alışveriş kampanyaları.
DISPLAY_GMAIL_AD Gmail reklam kampanyaları.
DISPLAY_SMART_CAMPAIGN Akıllı görüntülü reklam kampanyaları: Bu alt türde yeni kampanyalar oluşturulamaz.
VIDEO_OUTSTREAM Yayın dışı video kampanyaları.
VIDEO_ACTION Video TrueView for Action kampanyaları.
VIDEO_NON_SKIPPABLE Atlanamayan video reklamların yer aldığı video kampanyaları.
APP_CAMPAIGN Android veya iOS uygulamanızı Arama, Play, YouTube ve Google Görüntülü Reklam Ağı dahil olmak üzere Google'ın en popüler mülklerinde kolayca tanıtmanıza olanak tanıyan uygulama kampanyası.
APP_CAMPAIGN_FOR_ENGAGEMENT Etkileşim için uygulama kampanyası: Arama, YouTube ve Google Görüntülü Reklam Ağı dahil olmak üzere Google'ın en önemli mülklerinde uygulamayla yeniden etkileşimi artırmaya odaklanır.
LOCAL_CAMPAIGN Yerel reklamcılık için özelleştirilmiş kampanyalar.
SHOPPING_COMPARISON_LISTING_ADS Alışveriş karşılaştırma girişi 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 kayıt reklamcılığına özel ön kayıt için 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 Yalnızca sosyal medya kampanyalarını izleyen Facebook.

CustomParameter

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

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

string

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

value

string

Yerine konulacak değer.

RealTimeBiddingSetting

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

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

boolean

Kampanyanın gerçek zamanlı teklif verme özelliğinin etkinleştirilip etkinleştirilmediği.

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ı tarafından 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ı (ör. "google.com" veya "www.google.com").

languageCode

string

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

useSuppliedUrlsOnly

boolean

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

ShoppingSetting

Alışveriş kampanyaları ayarı. 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. feedLabel alanı, salesCountry yerine kullanılırsa aynı biçimdeki ülke kodlarını kabul eder (ör. "XX"). Aksi takdirde, Google Merchant Center'da feed etiketi için kullanılan herhangi bir dize olabilir.

useVehicleInventory

boolean

Araç listelemesi envanterinin hedeflenip hedeflenmeyeceği.

merchantId

string (int64 format)

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

salesCountry

string

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

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 dahil edilip edilmeyeceği.

GeoTargetTypeSetting

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

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

enum (PositiveGeoTargetType)

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

negativeGeoTargetType

enum (NegativeGeoTargetType)

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

PositiveGeoTargetType

Olası pozitif coğrafi hedef türleri.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Değer bu sürümde bilinmiyor.
PRESENCE_OR_INTEREST Kullanıcı reklamverenin hedeflediği konumlarda bulunuyorsa veya bu konumlara ilgi gösteriyorsa reklamın tetiklendiğini belirtir.
SEARCH_INTEREST Kullanıcı reklamverenin hedeflediği konumları ararsa bir reklamın tetiklendiğini belirtir. Bu özellik yalnızca Arama Ağı ve Standart Alışveriş kampanyalarında kullanılabilir.
PRESENCE Kullanıcı reklamverenin hedeflediği konumlardaysa veya bu konumlara düzenli olarak gidiyorsa reklamın tetiklendiğ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ç tutulan yerlerinde bulunan veya bu yerlere ilgi gösteren kullanıcıların reklamı görmemesinin belirtilmesi.
PRESENCE Reklamverenin hariç tutulan konumlarında bulunan kullanıcıların reklamı görmemesinin belirtilmesi.

FrequencyCapEntry

Bu türde alan yoktur.

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çici optimizasyon ayarı. Bu ayar, kampanyanın optimize edileceği bir dizi dönüşüm işlemi içerir. Bu özellik yalnızca AdvertisingChannelType olarak MULTI_CHANNEL ve AdvertisingChannelSubType olarak APP_CAMPAIGN veya APP_CAMPAIGN_FOR_ENGAGEMENT olarak kullanılan uygulama kampanyaları için geçerlidir.

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

string

Bu kampanyanın optimizasyonu için dönüşüm işlemleri için seçilen kaynak adı grubu.

OptimizationGoalSetting

Bu kampanyanın optimizasyon hedefi ayarı. Bu ayar, bir dizi optimizasyon hedefi türünü içerir.

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

enum (OptimizationGoalType)

Optimizasyon hedefi türlerinin listesi.

OptimizationGoalType

Optimizasyon hedefinin türü

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca döndürülen değer olarak kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
CALL_CLICKS Telefon araması tıklamaları için optimizasyon yapın. Telefon araması tıklaması dönüşümleri, kullanıcıların bir reklamı görüntüledikten sonra mağazayla iletişime geçmek için "Ara"yı seçtiği durumları ifade eder.
DRIVING_DIRECTIONS Araçla yol tarifleri için optimizasyon yapın. Arabayla yol tarifi dönüşümleri, kullanıcıların bir reklamı görüntüledikten sonra mağazaya gitmek için "Yol tarifi al"ı seçmeleridir.
APP_PRE_REGISTRATION Ön kayıt için optimize edin. Ön kayıt dönüşümleri, uygulama kullanıma sunulduğunda bildirim alacak ön kayıt yaptıran kullanıcıları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.

ManuelEBM

Bu türde alan yok.

Reklamverenin, reklamveren tarafından belirtilen işlem başına teklifi belirlemesine 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 verilerine göre geliştirilip geliştirilmeyeceği.

ManualCpm

Bu türde alan yoktur.

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

PercentCpc

Tekliflerin, bir ürün veya hizmetin reklamı yapılan fiyatının bir kısmını oluşturduğu teklif stratejisi.

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

string (int64 format)

Teklif stratejisi tarafından ayarlanabilecek maksimum teklif sınırı. Bu, reklamveren tarafından girilen ve yerel mikro boyutlarda belirtilen isteğe bağlı bir alandır. Not: Sıfır değer, bid_ceiling değerinin tanımlanmamış olmasıyla aynı şekilde yorumlanır.

enhancedCpcEnabled

boolean

Dönüşüm olasılığına bağlı olarak her açık artırma için teklifi yukarı veya aşağı ayarlar. Teklifler cpcBidCeilingMicros değerini aşabilir ancak kampanyanın ortalama teklif tutarı aşmamalıdır.

TargetCpm

Bu türde alan yoktur.

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 ile öğe arasındaki bağlantı.

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

string

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

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 eklemek, bir öğe grubunu bir kampanyayla ilişkilendirir.

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 öğe grubu öğesinin durumu. Salt okunur.

CampaignAudienceView

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

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

string

Kampanya kitle görünümünün kaynak adı. Kampanya kitle görünümü kaynak adları şu ş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 en son değiştirildiği tarih ve saat. Tarih ve saat, müşterinin saat diliminde ve "yyyy-AA-gg SS:dd:ss.ssssss" biçimindedir.

criterionId

string (int64 format)

Ölçütün kimliği.

Bu alan, mutasyon sırasında yoksayılır.

bidModifier

number

Ölçüt eşleştiğinde teklifler için değiştirici. Değiştirici 0,1 ile 10,0 arası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 hedeflenip (false) hedeflenmeyeceğini (true) belirtir.

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

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

keyword

object (KeywordInfo)

Anahtar kelime.

location

object (LocationInfo)

Konum'a dokunun.

device

object (DeviceInfo)

Cihaz) belirtin.

ageRange

object (AgeRangeInfo)

Yaş grubu.

gender

object (GenderInfo)

Cinsiyet.

userList

object (UserListInfo)

Kullanıcı Listesi.

language

object (LanguageInfo)

Dil.

webpage

object (WebpageInfo)

Web sayfası.

locationGroup

object (LocationGroupInfo)

Konum Grubu

CampaignCriterionStatus

CampaignCriterion öğesinin olası durumları.

Sıralamalar
UNSPECIFIED Değer belirtilmedi.
UNKNOWN

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

Bu, yalnızca yanıt değeridir.

ENABLED Kampanya ölçütü etkindir.
PAUSED Kampanya ölçütü duraklatılır.
REMOVED Kampanya ölçütü kaldırılır.

LanguageInfo

Dil ölçütü.

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

string

Dil sabit kaynağının 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 sabitleri. Şu anda yalnızca bir coğrafi hedef sabit değerine izin verilmektedir.

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 zorunludur ve CREATE işlemlerinde ayarlanmalıdır.

feedItemSets[]

string

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

radius

string (int64 format)

Hedeflenen konumların çevresindeki yarıçapı belirten birim cinsinden mesafe. Bu zorunludur ve CREATE işlemlerinde ayarlanmalıdır.

LocationGroupRadiusUnits

Konum grubundaki yarıçap mesafesinin birimi (ör. MİL)

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 Milli Miles

CampaignEffectiveLabel

Bir kampanya ile etkili bir etiket arasındaki ilişkiyi temsil eder. Etkili etiket, devralınan veya doğrudan bu kampanyaya atanan bir etikettir.

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

string

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

campaign

string

Etkili etiketin eklendiği kampanya.

label

string

Kampanyaya atanan etkili etiket.

ownerCustomerId

string (int64 format)

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

CampaignLabel

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

JSON gösterimi
{
  "resourceName": string,
  "campaign": string,
  "label": string,
  "ownerCustomerId": 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.

ownerCustomerId

string (int64 format)

Etiketin sahibi olan müşterinin kimliği.

CartDataSalesView

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

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

string

Alışveriş sepeti verileriyle 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 getirmenize olanak tanıyan etkili bir hedefleme seçeneğidir.

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

string

Kitlenin kaynak adı. Kitle adları şu şekildedir:

customers/{customerId}/audiences/{audience_id}

id

string (int64 format)

Kitlenin kimliği.

name

string

Zorunlu. Kitlenin adı. Tüm kitleler arasında benzersiz olmalıdır. Minimum uzunluğu 1, maksimum uzunluğu 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ğinin oluşturulduğu zaman damgası (ISO 8601 biçiminde).

status

enum (ConversionActionStatus)

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

type

enum (ConversionActionType)

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

category

enum (ConversionActionCategory)

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

valueSettings

object (ValueSettings)

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

attributionModelSettings

object (AttributionModelSettings)

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

floodlightSettings

object (FloodlightSettings)

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

id

string (int64 format)

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

name

string

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

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 primaryForGoal'a uymaz. Bu nedenle, bir kampanyada primaryForGoal = false dönüşüm işlemiyle yapılandırılan bir özel dönüşüm hedefi varsa bu dönüşüm işlemi için teklif verilebilir. Ayarlanmamışsa primaryForGoal varsayılan olarak doğru olur. 9. sürümde, primaryForGoal isteğe bağlı olarak tanımlanmadığı için yalnızca oluşturulduktan sonra bir "update" işlemiyle false olarak ayarlanabilir.

ownerCustomer

string

Dönüşüm işlemi sahibi müşterinin kaynak adı veya sistem tanımlı bir dönüşüm işlemiyse null.

includeInClientAccountConversionsMetric

boolean

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

includeInConversionsMetric

boolean

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

clickThroughLookbackWindowDays

string (int64 format)

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

appId

string

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

ConversionActionStatus

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

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

ConversionActionType

Dönüşüm işleminin olası 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 kullanan bir kullanıcı telefon numarasını tıkladığında gerçekleşen dönüşümler.
GOOGLE_PLAY_DOWNLOAD Kullanıcı Google Play Store'dan mobil uygulama indirdiğinde gerçekleşen dönüşümler.
GOOGLE_PLAY_IN_APP_PURCHASE Kullanıcı bir uygulamada Android faturalandırması üzerinden satın alma işlemi gerçekleştirdiğinde gerçekleşen dönüşümler.
UPLOAD_CALLS Reklamveren tarafından izlenen ve yüklenen telefon araması dönüşümleri.
UPLOAD_CLICKS Reklamveren tarafından izlenen ve ilişkilendirilmiş tıklamalarla yüklenen dönüşümler.
WEBPAGE Bir web sayfasında gerçekleşen dönüşümler.
WEBSITE_CALL Kullanıcı bir reklamverenin web sitesinden dinamik olarak oluşturulmuş bir telefon numarasını aradığında gerçekleşen dönüşümler.
STORE_SALES_DIRECT_UPLOAD Birinci taraf veya üçüncü taraf satıcı verisi yüklemelerine dayalı Mağaza Satış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ı verilerinin yüklenmesine ve/veya ödeme ağlarından alınan kartların kullanıldığı mağaza içi satın alma işlemlerine dayalı mağaza satışı dönüşümü. Mağaza satışı türlerini yalnızca izin verilenler listesindeki müşteriler kullanabilir. Salt okunur.
FIREBASE_ANDROID_FIRST_OPEN Firebase üzerinden izlenen Android uygulamasının ilk açılışı dönüşümleri.
FIREBASE_ANDROID_IN_APP_PURCHASE Firebase üzerinden izlenen Android uygulaması uygulama içi satın alma dönüşümleri.
FIREBASE_ANDROID_CUSTOM Firebase üzerinden izlenen Android uygulaması özel dönüşümleri.
FIREBASE_IOS_FIRST_OPEN Firebase aracılığıyla izlenen iOS uygulamasının ilk açılışı dönüşümleri.
FIREBASE_IOS_IN_APP_PURCHASE Firebase üzerinden izlenen iOS uygulaması uygulama içi satın alma dönüşümleri.
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ı uygulama içi satın alma dönüşümleri.
THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM Üçüncü Taraf Uygulama Analizleri aracılığıyla izlenen Android uygulaması özel dönüşümleri.
THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN Üçüncü Taraf Uygulama Analizleri aracılığıyla izlenen iOS uygulamasının 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 aracılığıyla izlenen iOS uygulaması özel dönüşümleri.
ANDROID_APP_PRE_REGISTRATION Kullanıcı Google Play Store'dan bir mobil uygulamaya ön kayıt yaptığında gerçekleşen dönüşümler. Salt okunur.
ANDROID_INSTALLS_ALL_OTHER_APPS Uygulamaya özel bir türe göre izlenmeyen tüm Google Play 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 yakalayabilirsiniz. Salt okunur.
GOOGLE_HOSTED Bir reklamla etkileşimden sonra Google'ın ürün ve hizmetlerindeki yerel işlemleri izleyen dönüşümler. Salt okunur.
LEAD_FORM_SUBMIT Kullanıcı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, telefon araması izleme ayarı yapılmadan Akıllı kampanya reklamlarında gerçekleşen telefon araması dönüşümleri. Salt okunur.
SMART_CAMPAIGN_MAP_CLICKS_TO_CALL Kullanıcı, Google Haritalar'daki bir arama öğesini tıklar. Yalnızca akıllı kampanya. Salt okunur.
SMART_CAMPAIGN_MAP_DIRECTIONS Kullanıcı, Google Haritalar'da bir işletmenin konumuna 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üşümler. Salt okunur.
WEBPAGE_CODELESS Web sitesi etkinliklerinden (ör. form gönderimleri veya sayfa yüklemeleri) oluşturulan ve ayrı ayrı kodlanmış etkinlik snippet'leri kullanılmayan dönüşümler. Salt okunur.
UNIVERSAL_ANALYTICS_GOAL Bağlı Universal Analytics hedeflerinden gelen dönüşümler.
UNIVERSAL_ANALYTICS_TRANSACTION Bağlı Universal Analytics işlemlerinden gelen dönüşümler.
GOOGLE_ANALYTICS_4_CUSTOM Bağlı Google Analytics 4 özel etkinlik dönüşümlerinden gelen dönüşümler.
GOOGLE_ANALYTICS_4_PURCHASE Bağlı Google Analytics 4 satın alma dönüşümlerinden gelen dönüşümler.

ConversionActionCategory

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

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca döndürülen değer için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
DEFAULT Varsayılan kategori.
PAGE_VIEW Sayfayı ziyaret eden kullanıcı.
PURCHASE Satın alma, satış veya "sipariş verildi" etkinliği.
SIGNUP Kullanıcının kaydolması işlemi.
LEAD Olası satış yaratma işlemi.
DOWNLOAD Yazılım indirme işlemi (uygulama için).
ADD_TO_CART Bir reklamveren sitesinde alışveriş sepetine veya çantaya ürün 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 teklifine olan ilgiyi belirtmek için yapılan arama.
IMPORTED_LEAD Harici bir kaynaktan Google Ads'e aktarılan potansiyel müşteri dönüşümü.
SUBMIT_LEAD_FORM Reklamveren sitesinde, işletmeyle ilgilenildiğini belirten bir form gönderimi.
BOOK_APPOINTMENT Reklamverenin işletmesiyle randevu rezervasyonu.
REQUEST_QUOTE Fiyat teklifi veya fiyat tahmini isteği.
GET_DIRECTIONS Reklamverenin işletmesinin bulunduğu konumu ziyaret etme amacıyla yapılan arama.
OUTBOUND_CLICK Reklamverenin iş ortağı sitesine yapılan tıklama.
CONTACT Reklamverenle yapılan telefon araması, SMS, e-posta, sohbet veya başka bir iletişim şekli.
ENGAGEMENT Uzun site süresi veya Google Analytics (GA) Akıllı Hedef gibi bir web sitesi etkileşim etkinliği. GA, Firebase, GA Gold hedefi içe aktarma işlemleri için kullanılacak şekilde tasarlanmıştır.
STORE_VISIT Fiziksel mağaza konumuna yapılan ziyaret.
STORE_SALE Fiziksel bir mağazada gerçekleşen satış.
QUALIFIED_LEAD Harici bir kaynaktan Google Ads'e aktarılan ve reklamveren (pazarlama/satış ekibi) tarafından daha da uygunluğu belirlenen 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 bu potansiyel müşterilerle ilgili işlem yapar. Tüketici ilgileniyorsa ve ürünü satın alabilirse 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 potansiyel müşteri kazanma reklamvereni tarafından tanımlanan bir aşamayı tamamlamış olan 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şlemine ait 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şlemine ait 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şleminin dönüşüm etkinliklerinde belirtilen değer ve para birimi kodu yerine varsayılan değerin ve varsayılan para birimi kodunun kullanılıp kullanılmayacağını kontrol eder.

AttributionModelSettings

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

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

enum (AttributionModel)

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

dataDrivenModelStatus

enum (DataDrivenModelStatus)

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

AttributionModel

Belirli bir dönüşümün kredisinin, muhtemelen birçok önceki etkileşime nasıl dağıtılacağını açıklayan ilişkilendirme modeli.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca döndürülen değer için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
EXTERNAL Harici ilişkilendirmeyi kullanır.
GOOGLE_ADS_LAST_CLICK Dönüşümle ilgili tüm krediyi son tıklamayla 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 dönüşüm için daha fazla krediyi daha yeni tıklamalarla ilişkilendirir (yarı ömrü 1 haftadır).
GOOGLE_SEARCH_ATTRIBUTION_POSITION_BASED 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 yöntemde Google Arama ilişkilendirmesi kullanılır.
GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN Google Arama ilişkilendirmesini kullanarak tıklamalar arasında kredinin uygun dağıtı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. Bu durum genellikle son 30 gün içinde gerekli sayıda etkinlik gerçekleşmediği için yaşanır.
NEVER_GENERATED Veriye dayalı model hiç oluşturulmamış. Bu durum genellikle 30 günlük herhangi bir dönemde gerekli sayıda etkinlik gerçekleşmediği için yaşanı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üşümleri raporlarken 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 (DCM)'daki Floodlight etkinliğinin kimliği.

ConversionCustomVariable

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

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

string

Dönüşüm özelleştirilebilen değişkeninin kaynak adı. Dönüşüm özelleştirilebilen değişkeni 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ın maksimum uzunluğu 100 karakterdir. Öncesinde veya 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" karakterinden hemen sonra 100'den küçük veya 100'e eşit bir sayı içermelidir. Örneğin: "u4".

status

enum (ConversionCustomVariableStatus)

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

ownerCustomer

string

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

family

enum (ConversionCustomVariableFamily)

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

cardinality

enum (ConversionCustomVariableCardinality)

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

floodlightConversionCustomVariableInfo

object (FloodlightConversionCustomVariableInfo)

Search Ads 360 Floodlight dönüşümü özel değişkenleri için 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şkeni etkinleşmeyi bekliyor ve ENABLED olarak ayarlanana kadar istatistik biriktirmez.

Bu durum, CREATE ve UPDATE isteklerinde kullanılamaz.

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

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, kullanmadan önce etkinleştirmesi gerekir.
FLOODLIGHT Özel Floodlight değişkeninden içe aktarılan dönüşüm özel 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ındadır. 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 kardinalitesi, segmentasyon sınırını aşmış ancak istatistik sınırını aşmamıştır. Segmentasyon devre dışı bırakılır ancak değişken etkinleştirilirse yeni değerler için istatistikler toplanabilir.
APPROACHES_STATS_LIMIT Dönüşüm özelleştirilebilen değişkeni segmentasyon sınırlarını aştı ve istatistik sınırlarına yaklaşıyor (> %90). Segmentasyon devre dışı bırakılır ancak değişken etkinleştirilirse yeni değerler için istatistikler toplanabilir.
EXCEEDS_STATS_LIMIT Dönüşüm özelleştirilebilen değişkeni, hem segmentasyon hem de istatistik sınırlarını aştı. Segmentasyon devre dışı bırakılır ve etkinleştirilen değişkenlerle ilgili istatistikler yalnızca mevcut değerler değişkenin kardinalitesini daha fazla artırmadığı takdirde toplanabilir.

FloodlightConversionCustomVariableInfo

Search Ads 360 Floodlight Dönüşüm Özel Değişkenleri hakkında bilgi.

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ığı şekilde Floodlight değişkeninin türü. Daha fazla bilgi için https://support.google.com/searchads/answer/4397154?hl=en adresine bakı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.
DIMENSION Boyut Floodlight değişkeni türü.
METRIC Metrik Floodlight değişkeni türü.
UNSET Floodlight değişkeni türü ayarlanmamış.

FloodlightVariableDataType

Search Ads 360'ta tanımlandığı şekilde Floodlight değişkeninin veri türü. Daha fazla bilgi için https://support.google.com/searchads/answer/4397154?hl=en adresine bakı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.
NUMBER "Sayı" türündeki bir Floodlight değişkenini temsil eder. Bu değişken, BOYUT veya METREK türünde Floodlight değişkenlerine atanabilir.
STRING "Dize" türündeki bir Floodlight değişkenini temsil eder. Bu değişken, BOYUT türündeki Floodlight değişkenlerine atanabilir.

Müşteri

Müşteri.

JSON gösterimi
{
  "resourceName": string,
  "conversionTrackingSetting": {
    object (ConversionTrackingSetting)
  },
  "accountType": enum (AccountType),
  "doubleClickCampaignManagerSetting": {
    object (DoubleClickCampaignManagerSetting)
  },
  "accountStatus": enum (AccountStatus),
  "lastModifiedTime": string,
  "engineId": string,
  "status": enum (CustomerStatus),
  "creationTime": string,
  "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 kaynak adları şu biçimdedir:

customers/{customerId}

conversionTrackingSetting

object (ConversionTrackingSetting)

Bir müşterinin dönüşüm izleme ayarı.

accountType

enum (AccountType)

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

doubleClickCampaignManagerSetting

object (DoubleClickCampaignManagerSetting)

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 diliminde ve "yyyy-AA-gg SS:dd:ss.ssssss" biçimindedir.

engineId

string

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

status

enum (CustomerStatus)

Müşterinin durumu.

creationTime

string

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

id

string (int64 format)

Müşterinin kimliği.

descriptiveName

string

Müşterinin isteğe bağlı, 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şturmak için kullanılan URL şablonu.

finalUrlSuffix

string

Nihai URL'ye parametre eklemek için kullanılan URL şablonu.

autoTaggingEnabled

boolean

Müşteri için otomatik etiketlemenin etkin olup olmadığı.

manager

boolean

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

ConversionTrackingSetting

Search Ads 360 Dönüşüm İzleme ile ilgili müşteri genelindeki ayarların bir 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ğini belirtir. Hesaplar arası dönüşüm izleme kullanılıyorsa bu değer yöneticiden devralınır. Bu alan salt okunur. Daha fazla bilgi için https://support.google.com/adspolicy/answer/7475709 adresini ziyaret edin.

conversionTrackingStatus

enum (ConversionTrackingStatus)

Dönüşüm izleme durumu. Müşterinin dönüşüm izlemeyi kullanıp kullanmadığını ve bu müşterinin dönüşüm izleme sahibinin kim olduğunu 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ılıyorsa bu değer yöneticiden devralınır. Bu alan salt okunurdur.

googleAdsConversionCustomer

string

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

conversionTrackingId

string (int64 format)

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

googleAdsCrossAccountConversionTrackingId

string (int64 format)

Müşterinin yöneticisinin dönüşüm izleme kimliği. Bu, 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 okunur.

crossAccountConversionTrackingId

string (int64 format)

Müşterinin 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 izlemeyi 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, istekteki login-customer-id alanında belirtilen müşteriden 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 Geçiş noktası üzerinden yönetilen Facebook hesabı.
GOOGLE_ADS Google Ads hesabınız.
MICROSOFT Microsoft Advertising hesabı.
SEARCH_ADS_360 Search Ads 360 yönetici hesabı.
YAHOO_JAPAN Yahoo Japan hesabı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şkili Campaign Manager reklamvereninin kimliği.

networkId

string (int64 format)

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

timeZone

string

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

AccountStatus

Hesapları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ılır.
SUSPENDED Hesap, dahili bir işlemle devre dışı bırakılır.
REMOVED Hesap geri alınamaz şekilde devre dışı bırakılır.
DRAFT Hesap hâlâ kurulum aşamasında ancak henüz ETKİN değil.

CustomerStatus

Bir 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ı gösterir.
CANCELED Reklam yayınlayamayan iptal edilmiş bir hesabı gösterir. 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 KAPALI olur. Durum kalıcıdır ve yeniden açılamaz.

CustomerAsset

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

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

string

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

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 öğe grubunun kaynak adı. Öğe grubu öğe kaynak adları şu biçimdedir:

customers/{customerId}/customerAssetSets/{asset_set_id}

assetSet

string

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

customer

string

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

status

enum (AssetSetLinkStatus)

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

AccessibleBiddingStrategy

Müşteriye ait olan ve müşteriyle paylaşılan BiddingStrategies'in bir görünümünü temsil eder.

BiddingStrategy'nin aksine bu kaynak, müşterinin sahip olduğu stratejilerin yanı sıra müşterinin yöneticilerine ait olan ve müşteriyle paylaşılan stratejileri de içerir. Bu kaynak metrik sağlamaz ve yalnızca BiddingStrategy özelliklerinin 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ı. AccessibleBiddingStrategy kaynak adları şu biçimdedir:

customers/{customerId}/accessibleBiddingStrategies/{bidding_strategy_id}

id

string (int64 format)

Teklif stratejisinin kimliği.

name

string

Teklif stratejisinin adı.

type

enum (BiddingStrategyType)

Teklif stratejisinin türü.

ownerCustomerId

string (int64 format)

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

ownerDescriptiveName

string

Teklif stratejisinin sahibi olan müşterinin descriptiveName değeri.

Birlik alanı scheme. Teklif verme ş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 otomatik bir teklif stratejisidir.

targetCpa

object (TargetCpa)

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

targetImpressionShare

object (TargetImpressionShare)

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

targetRoas

object (TargetRoas)

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

targetSpend

object (TargetSpend)

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

MaximizeConversionValue

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

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

number

Reklam harcamalarından elde edilen gelir (ROAS) hedefi seçeneği. Ayarlanırsa teklif stratejisi, 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 ayarlanmamışsa teklif stratejisi, bütçe için mümkün olan en yüksek ROAS'ı elde etmeyi 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 etmenizi sağlayacak şekilde ayarlayan bir otomatik teklif stratejisidir.

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

string (int64 format)

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

TargetImpressionShare

Teklifleri, arama ağı reklamlarının belirli bir yüzdesinin ilk sayfanın üst kısmında (veya hedeflenen diğer konumda) gösterileceği şekilde ayarlayan otomatik teklif stratejisi.

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

cpcBidCeilingMicros

string (int64 format)

Otomatik teklif sisteminin belirtmesine izin verilen en yüksek TBM teklifi. Bu, reklamveren tarafından girilen ve üst sınırı belirleyen ve yerel mikrolarda belirtilen 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 dayalı).

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. TargetSpend teklif vereni, bu değer ile doğal akış kısıtlaması harcama tutarı arasından daha küçük olanı harcamaya çalışır. Belirtilmezse bütçe, harcama hedefi olarak kullanılır. Bu alanın desteği sonlandırıldı ve 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 belirlenebilecek maksimum teklif sınırı. Sınır, strateji tarafından yönetilen tüm anahtar kelimeler için geçerlidir.

ManagerLinkStatus

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

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca döndürülen değer için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
ACTIVE Geçerli etkin ilişkisini gösterir
INACTIVE Sonlandırılan ilişkiyi gösterir
PENDING İlişkinin yönetici tarafından istendiğini ancak müşterinin henüz kabul etmediğini gösterir.
REFUSED 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 müşterisi arasındaki bağlantı. CustomerClients yalnızca yönetici müşteriler için mevcuttur. Yöneticinin yanı sıra tüm doğrudan ve dolaylı müşteriler dahildir.

JSON gösterimi
{
  "resourceName": string,
  "appliedLabels": [
    string
  ],
  "status": enum (CustomerStatus),
  "clientCustomer": string,
  "hidden": boolean,
  "level": string,
  "timeZone": string,
  "testAccount": boolean,
  "manager": boolean,
  "descriptiveName": string,
  "currencyCode": string,
  "id": string
}
Alanlar
resourceName

string

Müşteri istemcisinin kaynak adı. CustomerClient kaynak adları şu biçimdedir: customers/{customerId}/customerClients/{client_customer_id}

appliedLabels[]

string

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

customers/{customerId}/labels/{label_id}

status

enum (CustomerStatus)

Müşterinin durumu. Salt okunur.

clientCustomer

string

Belirli bir müşteriye bağlı müşteri-istemcinin kaynak adı. Salt okunur.

hidden

boolean

Hesabın gizli olup olmadığını belirtir.

Salt okunur.

level

string (int64 format)

Belirli bir müşteri ile müşterinin bulunduğu yer arasındaki mesafe. Kendi kendine bağlantı için seviye değeri 0 olur. Salt okunur.

timeZone

string

İstemcinin saat diliminin Common Locale Data Repository (CLDR) dize temsili (ör. America/Los_Angeles). Salt okunur.

testAccount

boolean

Müşterinin bir test hesabı olup olmadığını tanımlar. Salt okunur.

manager

boolean

Müşterinin yönetici olup olmadığını tanımlar. Salt okunur.

descriptiveName

string

İstemcinin 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ğı reklamı arama terimi görünümü kaynak adları şu şekildedir:

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

GenderView

Cinsiyet görünümü. genderView kaynağı, hangi ölçütlerin eklendiği yerine etkili 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, üst öğesinin 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ğişkeni artık kullanılmıyor ve kaldırılacak.

KeywordView

Anahtar kelime görünümü.

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

string

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

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

Şirket

Etiket.

JSON gösterimi
{
  "resourceName": string,
  "status": enum (LabelStatus),
  "textLabel": {
    object (TextLabel)
  },
  "id": string,
  "name": string
}
Alanlar
resourceName

string

Kaynağın adı. Etiket kaynak adları şu biçime sahiptir: customers/{customerId}/labels/{label_id}

status

enum (LabelStatus)

Etiketin durumu. Salt okunur.

textLabel

object (TextLabel)

Renkli bir arka planda metin gösteren bir etiket türü.

id

string (int64 format)

Etiketin kimliği. Salt okunur.

name

string

Etiketin adı.

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

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

LabelStatus

Bir etiketin olası durumları.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca dö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ılır.

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 HEX 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ında görünmeyebilir.

description

string

Etiketin kısa bir açıklaması. Uzunluk en fazla 200 karakter olmalıdır.

LanguageConstant

Bir dil.

JSON gösterimi
{
  "resourceName": string,
  "id": string,
  "code": string,
  "name": string,
  "targetable": boolean
}
Alanlar
resourceName

string

Dil sabitinin kaynak adı. Dil sabit kaynak adları şu şekildedir:

languageConstants/{criterionId}

id

string (int64 format)

Dil sabitinin kimliği.

code

string

Dil kodu (ör. "en_US", "en_AU", "es", "fr" vb.).

name

string

Dilin İngilizce tam adı (ör. "English (US)", "Spanish" vb.).

targetable

boolean

Dilin hedeflenip hedeflenemeyeceği.

LocationView

Konum görünümü, kampanyaların performansını bir konum ölçütüne göre özetler.

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

string

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

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

ProductBiddingCategoryConstant

Ürün Teklif Verme Kategorisi.

JSON gösterimi
{
  "resourceName": string,
  "level": enum (ProductBiddingCategoryLevel),
  "status": enum (ProductBiddingCategoryStatus),
  "id": string,
  "countryCode": string,
  "productBiddingCategoryConstantParent": string,
  "languageCode": string,
  "localizedName": string
}
Alanlar
resourceName

string

Ürün teklifi kategorisinin kaynak adı. Ürün teklifli sistem kategorisi kaynak adları şu biçimdedir:

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

level

enum (ProductBiddingCategoryLevel)

Ürün teklifi kategorisinin seviyesi.

status

enum (ProductBiddingCategoryStatus)

Ürün teklifi kategorisinin durumu.

id

string (int64 format)

Ürün teklif kategorisinin kimliği.

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

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 teklifi kategorisinin dil kodu.

localizedName

string

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

ProductBiddingCategoryLevel

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

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

ProductBiddingCategoryStatus

Ürün teklifi kategorisinin durumunu açıklayan bir enum.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca döndürülen değer için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
ACTIVE Kategori etkindir ve teklif verme için kullanılabilir.
OBSOLETE Kategori artık geçerli değil. Yalnızca raporlama amacıyla kullanılır.

ProductGroupView

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

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

string

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

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

ShoppingPerformanceView

Alışveriş performansı görünümü. Alışveriş kampanyası istatistiklerini çeşitli ürün boyutu düzeylerinde toplanmış olarak sağlar. Merchant Center'daki marka, kategori, özel özellikler, ürün durumu ve ürün türü gibi ürün boyutu değerleri, ilgili etkinliğin kaydedildiği tarih ve saat itibarıyla her boyutun durumunu yansıtır.

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

string

Alışveriş performansı görünümünün kaynak adı. Alışveriş performans görünümü kaynak adları şu biç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 değerine bağlı olarak kullanıcı listesi adı benzersiz olmayabilir (ör. access_reason=SHARED ise)

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 Diğer kullanıcı listelerinin/ilgi alanlarının bir kombinasyonu olarak sunulan Kullanıcı Listesi.
EXTERNAL_REMARKETING Google Ad Manager platformunda oluşturulan UserList.
RULE_BASED Bir kuralla ilişkilendirilmiş UserList.
SIMILAR Başka bir UserList'in kullanıcılarına benzer kullanıcıları içeren UserList adlı kullanıcı listesi.
CRM_BASED Reklamveren tarafından e-posta veya başka biçimlerde sağlanan birinci taraf CRM verilerinin UserList'i.

WebpageView

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

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

string

Web sayfası görünümünün kaynak adı. Web sayfası görüntüleme kaynak adları şu şekildedir:

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

Ziyaret edin

Ziyaret.

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

string

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

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

id

string (int64 format)

Ziyaretin kimliği.

criterionId

string (int64 format)

Search Ads 360 anahtar kelime kimliği. 0 değeri, anahtar kelimenin ilişkilendirilmediğini gösterir.

merchantId

string (int64 format)

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

adId

string (int64 format)

Reklam kimliği. 0 değeri, reklamın ilişkilendirilmediğini gösterir.

clickId

string

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

visitDateTime

string

Ziyaret etkinliğinin zaman damgası. Zaman damgası, müşterinin saat diliminde ve "yyyy-AA-gg SS:dd:ss" biçimindedir.

productId

string

Tıklanan ürünün kimliği.

productChannel

enum (ProductChannel)

Tıklanan ürünün satış kanalı: Online veya Yerel.

productLanguageCode

string

Ürünle ilgili verileri içeren Merchant Center feed'i için ayarlanan dil (ISO-639-1).

productStoreId

string

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 kaydedilen ülke (ISO-3166 biçiminde).

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 internetten satılıyor.
LOCAL Öğe yerel mağazalarda satılıyor.

Dönüşüm

Dönüşüm.

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

string

Dönüşümün kaynak adı. Dönüşüm kaynağı adları şu ş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şkilendirilmediğini gösterir.

merchantId

string (int64 format)

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

adId

string (int64 format)

Reklam kimliği. 0 değeri, reklamın ilişkilendirilmediğini gösterir.

clickId

string

Dönüşümün ilişkilendirildiği ziyaret için açılış sayfasına tıklama kimliği URL parametresi olarak 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 bu, reklamverenler tarafından sağlanan bir kimliktir. Reklamverenler böyle bir kimlik belirtmezse Search Ads 360 bir kimlik oluşturur. Online dönüşümler için bu, reklamverenin Floodlight talimatlarına bağlı olarak kimlik sütununa veya floodlightOrderId sütununa eşittir.

productId

string

Tıklanan ürünün kimliği.

productChannel

enum (ProductChannel)

Tıklanan ürünün satış kanalı: Online veya Yerel.

productLanguageCode

string

Ürünle ilgili verileri içeren Merchant Center feed'i için ayarlanan dil (ISO-639-1).

productStoreId

string

Yerel envanter reklamında 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 kaydedilen ülke (ISO-3166 biçiminde).

attributionType

enum (AttributionType)

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

conversionDateTime

string

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

conversionLastModifiedDateTime

string

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

conversionVisitDateTime

string

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

conversionQuantity

string (int64 format)

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

conversionRevenueMicros

string (int64 format)

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

floodlightOriginalRevenue

string (int64 format)

Floodlight para birimi talimatında yapılan değişikliklerden önce Floodlight etkinliğiyle ilişkili orijinal, değiştirilmemiş gelir (mevcut raporun para biriminde).

floodlightOrderId

string

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

status

enum (ConversionStatus)

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

assetId

string (int64 format)

Dönüşüm etkinliği sırasında etkileşimde bulunulan öğenin kimliği.

assetFieldType

enum (AssetFieldType)

Dönüşüm etkinliğinin öğe alanı türü.

AttributionType

Search Ads360'taki dönüşüm ilişkilendirme türü

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca döndürülen değer için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
VISIT Dönüşüm, bir ziyaretle ilişkilendirilir.
CRITERION_AD Dönüşüm bir ölçüt ve reklam çiftiyle ilişkilendirilir.

ConversionStatus

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

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

Metrikler

Metrik verileri.

JSON gösterimi
{
  "allConversionsValueByConversionDate": number,
  "allConversionsByConversionDate": number,
  "conversionCustomMetrics": [
    {
      object (Value)
    }
  ],
  "conversionsValueByConversionDate": number,
  "conversionsByConversionDate": number,
  "historicalCreativeQualityScore": enum (QualityScoreBucket),
  "historicalLandingPageQualityScore": enum (QualityScoreBucket),
  "historicalSearchPredictedCtr": enum (QualityScoreBucket),
  "interactionEventTypes": [
    enum (InteractionEventType)
  ],
  "rawEventConversionMetrics": [
    {
      object (Value)
    }
  ],
  "absoluteTopImpressionPercentage": number,
  "allConversionsFromInteractionsRate": number,
  "allConversionsValue": number,
  "allConversions": number,
  "allConversionsValuePerCost": number,
  "allConversionsFromClickToCall": number,
  "allConversionsFromDirections": number,
  "allConversionsFromInteractionsValuePerInteraction": number,
  "allConversionsFromMenu": number,
  "allConversionsFromOrder": number,
  "allConversionsFromOtherEngagement": number,
  "allConversionsFromStoreVisit": number,
  "visits": number,
  "allConversionsFromStoreWebsite": number,
  "averageCost": number,
  "averageCpc": number,
  "averageCpm": number,
  "clicks": string,
  "contentBudgetLostImpressionShare": number,
  "contentImpressionShare": number,
  "contentRankLostImpressionShare": number,
  "conversionsFromInteractionsRate": number,
  "clientAccountConversionsValue": number,
  "conversionsValuePerCost": number,
  "conversionsFromInteractionsValuePerInteraction": number,
  "clientAccountConversions": number,
  "costMicros": string,
  "costPerAllConversions": number,
  "costPerConversion": number,
  "costPerCurrentModelAttributedConversion": number,
  "crossDeviceConversions": number,
  "crossDeviceConversionsByConversionDate": number,
  "crossDeviceConversionsValue": number,
  "crossDeviceConversionsValueByConversionDate": number,
  "ctr": number,
  "conversions": number,
  "conversionsValue": number,
  "averageQualityScore": number,
  "historicalQualityScore": string,
  "impressions": string,
  "interactionRate": number,
  "interactions": string,
  "invalidClickRate": number,
  "invalidClicks": string,
  "generalInvalidClickRate": number,
  "generalInvalidClicks": string,
  "mobileFriendlyClicksPercentage": number,
  "searchAbsoluteTopImpressionShare": number,
  "searchBudgetLostAbsoluteTopImpressionShare": number,
  "searchBudgetLostImpressionShare": number,
  "searchBudgetLostTopImpressionShare": number,
  "searchClickShare": number,
  "searchExactMatchImpressionShare": number,
  "searchImpressionShare": number,
  "searchRankLostAbsoluteTopImpressionShare": number,
  "searchRankLostImpressionShare": number,
  "searchRankLostTopImpressionShare": number,
  "searchTopImpressionShare": number,
  "topImpressionPercentage": number,
  "valuePerAllConversions": number,
  "valuePerAllConversionsByConversionDate": number,
  "valuePerConversion": number,
  "valuePerConversionsByConversionDate": number,
  "clientAccountViewThroughConversions": string,
  "clientAccountCrossSellCostOfGoodsSoldMicros": string,
  "crossSellCostOfGoodsSoldMicros": string,
  "clientAccountCrossSellGrossProfitMicros": string,
  "crossSellGrossProfitMicros": string,
  "clientAccountCrossSellRevenueMicros": string,
  "crossSellRevenueMicros": string,
  "clientAccountCrossSellUnitsSold": number,
  "crossSellUnitsSold": number,
  "clientAccountLeadCostOfGoodsSoldMicros": string,
  "leadCostOfGoodsSoldMicros": string,
  "clientAccountLeadGrossProfitMicros": string,
  "leadGrossProfitMicros": string,
  "clientAccountLeadRevenueMicros": string,
  "leadRevenueMicros": string,
  "clientAccountLeadUnitsSold": number,
  "leadUnitsSold": number
}
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ğerinin toplamı. Bu sütun tarihle birlikte seçildiğinde tarih sütunundaki değerler, dönüşüm tarihini ifade eder.

conversionsByConversionDate

number

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

historicalCreativeQualityScore

enum (QualityScoreBucket)

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

historicalLandingPageQualityScore

enum (QualityScoreBucket)

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

historicalSearchPredictedCtr

enum (QualityScoreBucket)

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

interactionEventTypes[]

enum (InteractionEventType)

Ücretli ve ücretsiz etkileşim türleri.

rawEventConversionMetrics[]

object (Value)

İşlenmemiş 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şimlerin sağladığı tüm dönüşümlerin (görüntülemeden dönüşümlerin aksine) reklam etkileşimi sayısına bölünmesiyle elde edilen değerdir.

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 bir reklamı tıklarken veya tıkladıktan sonra mağazayı telefonla aramak için "Ara" düğmesini tıklama sayısı. Bu sayı, aramaların bağlanıp bağlanmadığını veya aramaların süresini içermez.

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

allConversionsFromDirections

number

Kullanıcıların bir reklamı tıkladıktan sonra mağazaya gitmek için "Yol tarifi al" düğmesini tıklama sayısı.

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

allConversionsFromInteractionsValuePerInteraction

number

Etkileşimlerin tümünden elde edilen dönüşümlerin değerinin toplam etkileşim sayısına bölünmesiyle elde edilen değer.

allConversionsFromMenu

number

Kullanıcıların bir reklamı tıkladıktan sonra mağaza 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 adresinde metrics_currency parametresini inceleyin.

clicks

string (int64 format)

Tıklama sayısı.

contentBudgetLostImpressionShare

number

Reklamınızın Görüntülü Reklam Ağı'nda gösterilmeye uygun olduğu ancak bütçeniz çok düşük olduğu için gösterilmediği tahmini yüzde. Not: İçerik bütçesi kaybedilen gösterim payı 0 ile 0,9 arası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 düşük Reklam Sıralaması nedeniyle Görüntülü Reklam Ağı'nda alamadığı gösterimlerin tahmini yüzdesidir. Not: İçerik sıralaması nedeniyle kaybedilen gösterim payı, 0 ile 0,9 arasında raporlanır. 0,9'un üzerindeki değerler 0,9001 olarak raporlanır.

conversionsFromInteractionsRate

number

Dönüşüm için uygun etkileşim başına ortalama teklif verilebilir dönüşüm (etkileşimden). Bir reklam etkileşiminin ortalama ne sıklıkta teklif verilebilir bir dönüşü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 stratejisi kullanıyorsanız teklif stratejileriniz bu dönüşümler için optimize edilir.

conversionsValuePerCost

number

Teklif verilebilir dönüşümün değerinin, dönüşüm için uygun etkileşimlerin toplam maliyetine bölünmesiyle elde edilir.

conversionsFromInteractionsValuePerInteraction

number

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

clientAccountConversions

number

Müşteri hesabı dönüşümlerinin sayısı. Bu, yalnızca includeInClientAccountConversionsMetric özelliği true olarak ayarlanmış dönüşüm işlemlerini içerir. 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 maliyet (TBM) ve bin gösterim başına maliyet (BGBM) maliyetlerinizin toplamıdır. Bu metrik, parasal bir değerdir ve varsayılan olarak müşterinin para biriminde döndürülür. https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause adresindeki metrics_currency 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 uygun maliyeti.

costPerCurrentModelAttributedConversion

number

Reklam etkileşimlerinin maliyetinin, mevcut modele ilişkilendirilmiş dönüşümlere bölünmesiyle hesaplanır. Bu, yalnızca includeInConversionsMetric özelliği true olarak ayarlanmış dönüşüm işlemlerini içerir. Dönüşüme dayalı teklif verme özelliğini kullanıyorsanız teklif stratejileriniz bu dönüşümler için optimize edilir.

crossDeviceConversions

number

Müşterilerin bir cihazda reklam tıklayıp ardından farklı bir cihaz veya tarayıcıda gerçekleştirdiği dönüşümler. Cihazlar arası dönüşümler, allConversions sütununa zaten dahildir.

crossDeviceConversionsByConversionDate

number

Dönüşüm tarihine göre cihazlar arası dönüşümlerin sayısı. by_conversion_date sütunlarıyla ilgili ayrıntıları https://support.google.com/sa360/answer/9250611 adresinde bulabilirsiniz.

crossDeviceConversionsValue

number

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

crossDeviceConversionsValueByConversionDate

number

Dönüşüm tarihine göre cihazlar arası dönüşüm değerinin toplamı. by_conversion_date sütunlarıyla ilgili ayrıntıları https://support.google.com/sa360/answer/9250611 adresinde bulabilirsiniz.

ctr

number

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

conversions

number

Dönüşüm sayısı. Bu, yalnızca includeInConversionsMetric özelliği true olarak ayarlanmış dönüşüm işlemlerini içerir. Dönüşüme dayalı teklif stratejisi kullanıyorsanız teklif stratejileriniz bu dönüşümler için optimize edilir.

conversionsValue

number

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

averageQualityScore

number

Ortalama kalite puanı.

historicalQualityScore

string (int64 format)

Geçmiş kalite puanı.

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österildiğinin sayısı.

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şim sayısı. Etkileşim, reklam biçimiyle ilişkilendirilmiş ana kullanıcı işlemidir (ör. metin ve Alışveriş reklamları için tıklamalar, video reklamların görüntülenmesi vb.).

invalidClickRate

number

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

invalidClicks

string (int64 format)

Google'ın geçersiz kabul ettiği ve sizden ücret alınmayan tıklama sayısı.

generalInvalidClickRate

number

Geçersiz olması nedeniyle filtrelenerek toplam tıklama sayınızın dışında tutulan tıklamaların yüzdesidir. Bunlar, Google'ın geçersiz kabul ettiği ve rutin filtreleme yöntemleriyle (ör. bilinen geçersiz veri merkezi trafiği, botlar ve örümcekler ya da diğer tarayıcılar, düzensiz kalıplar) tespit edilen tıklamalardır. Bu tıklamalar için ödeme yapmazsınız ve bunlar hesap istatistiklerini etkilemez. Ayrıntılar için https://support.google.com/campaignmanager/answer/6076504 adresindeki yardım sayfasına bakın.

generalInvalidClicks

string (int64 format)

Genel geçersiz tıklamaların sayısı. Bunlar, rutin filtreleme yöntemleri (ör. bilinen geçersiz veri merkezi trafiği, botlar ve örümcekler ya da diğer tarayıcılar, düzensiz kalıplar vb.) aracılığıyla algılanan geçersiz tıklamalarınızın alt kümesidir. Bu tıklamalar için ödeme yapmazsınız ve bunlar hesap istatistiklerini etkilemez. Ayrıntılar için https://support.google.com/campaignmanager/answer/6076504 adresindeki yardım sayfasını inceleyin.

mobileFriendlyClicksPercentage

number

Mobil uyumlu bir sayfaya yönlendiren mobil tıklamaların yüzdesidir.

searchAbsoluteTopImpressionShare

number

Müşterinin Alışveriş veya Arama Ağı reklamı gösterimleri içinde en belirgin Alışveriş konumunda gösterilen gösterimlerin yüzdesidir. 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 arama sonuçlarındaki en iyi reklamlar arasında ne sıklıkla ilk sırada yer almadığını tahmin eden sayı. Not: Arama Ağı bütçesi kaybedilen mutlak üst gösterim payı, 0 ila 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 gösterilmediği tahmini yüzde. Not: Arama ağı bütçesi kaybedilen gösterim payı 0 ile 0,9 arası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ıkla gösterilmediğini tahmin eden sayı. Not: Arama Ağı bütçesi kaybedilen üst gösterim payı, 0 ila 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 değer. 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 arası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 arası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ındaki üstteki reklamlar arasında ne sıklıkla ilk sırada yer almadığını tahmin eden sayı. Not: Arama Ağı sıralaması kaybedilen mutlak üst gösterim payı 0 ile 0,9 arasında raporlanır. 0,9'un üzerindeki değerler 0,9001 olarak raporlanır.

searchRankLostImpressionShare

number

Arama Ağı'nda, reklamlarınızın düşük Reklam Sıralaması nedeniyle alamadığı tahmini gösterim yüzdesidir. Not: Arama sıralaması kaybedilen gösterim payı, 0 ile 0,9 arası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

Üstteki reklamlar arasında aldığınız gösterimlerin, üstteki reklamlar arasında almaya uygun olduğunuz tahmini gösterim sayısıyla karşılaştırması. Not: Arama Ağı üst gösterim payı 0,1 ile 1 arasında 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ünmesiyle elde edilen değer.

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

clientAccountViewThroughConversions

string (int64 format)

Toplam görüntüleme dönüşümü sayısı. Bu dönüşümler, bir müşteri bir resim veya zengin medya reklamı gördüğünde ve daha sonra başka bir reklamla etkileşime geçmeden (ör. tıklamadan) sitenizde dönüşüm gerçekleştirdiğinde gerçekleşir.

clientAccountCrossSellCostOfGoodsSoldMicros

string (int64 format)

Müşteri hesabı çapraz satış SMM'si, farklı bir ürünün reklamının yapılması sonucunda satılan ürünlerin toplam maliyetidir. İşleyiş şekli: Web sitenizde tamamlanan satın alma işlemleri için alışveriş sepeti verileriyle dönüşümleri raporlarsınız. Satın alma işleminden önce etkileşimde bulunulan reklamın ilişkili bir ürünü varsa (bkz. Alışveriş reklamları) bu ürün, reklamı yapılan ürün olarak kabul edilir. Müşterinin verdiği siparişi eklenen her ürün, satılan üründür. Bu ürünlerin eşleşmemesi, çapraz satış olarak kabul edilir. Satılan malların çapraz satış maliyeti, reklamı yapılmayan ancak satılan ürünlerin toplam maliyetidir. Örnek: Bir müşteri, şapka tanıtılan bir Alışveriş reklamını tıklayıp söz konusu şapkayla birlikte bir gömlek satın alır. Şapkanın "satılan malların maliyeti" değerinin 3 TL, gömleğin "satılan malların maliyeti" değerinin ise 5 TL olduğunu varsayalım. Bu sipariş için "satılan malların çapraz satış maliyeti" değeri 5 TL'dir. Bu metrik yalnızca alışveriş sepeti verileriyle dönüşümler raporlanıyorsa kullanılabilir. Bu metrik parasal bir değerdir ve varsayılan olarak müşterinin para biriminde döndürülür. https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause adresinde metrics_currency parametresini inceleyin.

crossSellCostOfGoodsSoldMicros

string (int64 format)

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

clientAccountCrossSellGrossProfitMicros

string (int64 format)

Müşteri hesabı çapraz satışından elde edilen brüt kâr, farklı bir ürünün reklamının yapılması sonucunda satılan ürünlerden kazanılan gelirden satılan malların maliyeti (SMM) çıkarılarak hesaplanır. İşleyiş şekli: Web sitenizde tamamlanan satın alma işlemleri için alışveriş sepeti verileriyle dönüşümleri raporlarsınız. Satın alma işleminden önce etkileşimde bulunulan reklamın ilişkili bir ürünü varsa (bkz. Alışveriş reklamları) bu ürün, reklamı yapılan ürün olarak kabul edilir. Satın alma işlemine dahil edilen tüm ürünler, satılan üründür. 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 adresinde metrics_currency parametresini inceleyin.

crossSellGrossProfitMicros

string (int64 format)

Çapraz satıştan elde edilen brüt kâr, farklı bir ürünün reklamının yapılması sonucunda satılan ürünlerden kazanılan gelirden satılan malların maliyeti (SMM) çıkarılarak hesaplanır. İşleyiş şekli: Web sitenizde tamamlanan satın alma işlemleri için alışveriş sepeti verileriyle dönüşümleri raporlarsınız. Satın alma işleminden önce etkileşimde bulunulan reklamın ilişkili bir ürünü varsa (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ır. Tişört 20 TL ve satılan malların maliyetinin 5 TL olduğunu varsayalım. Bu siparişin çapraz satıştan elde edilen brüt kârı 15 TL = 20 TL - 5 TL'dir. Bu metrik yalnızca alışveriş sepeti verileriyle dönüşümler raporlanıyorsa kullanılabilir. Bu metrik, parasal bir değerdir ve varsayılan olarak müşterinin para biriminde döndürülür. https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause adresinde metrics_currency parametresini inceleyin.

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 reklamın ilişkili bir ürünü varsa (bkz. Alışveriş reklamları) bu ürün, reklamı yapılan ürün olarak kabul edilir. Müşterinin verdiği siparişi eklenen her ürün, satılan üründür. Bu ürünlerin eşleşmemesi, çapraz satış olarak kabul edilir. Çapraz satıştan elde edilen gelir, reklamlarınızla ilişkilendirilen çapraz satışlardan elde ettiğiniz toplam değerdir. Örnek: Bir müşteri, şapka tanıtılan bir Alışveriş reklamını tıklayıp söz konusu şapkayla birlikte bir gömlek satın alır. Şapka 10 TL, gömlek ise 20 TL'dir. Dolayısıyla bu siparişin çapraz satış geliri 20 TL'dir. Bu metrik yalnızca alışveriş sepeti verileriyle dönüşümler raporlanıyorsa kullanılabilir. Bu metrik, parasal bir değerdir ve varsayılan olarak müşterinin para biriminde döndürülür. https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause adresindeki metrics_currency parametresini 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 reklamın ilişkili bir ürünü varsa (bkz. Alışveriş reklamları) bu ürün, reklamı yapılan ürün olarak kabul edilir. Müşterinin verdiği siparişi eklenen her ürün, satılan üründür. Bu ürünlerin eşleşmemesi, çapraz satış olarak kabul edilir. Çapraz satıştan elde edilen gelir, reklamlarınızla ilişkilendirilen çapraz satışlardan elde ettiğiniz toplam değerdir. Örnek: Bir müşteri, şapka tanıtılan bir Alışveriş reklamını tıklayıp söz konusu şapkayla birlikte bir gömlek satın alır. Şapka 10 TL, gömlek ise 20 TL'dir. Dolayısıyla bu siparişin çapraz satış geliri 20 TL'dir. Bu metrik yalnızca alışveriş sepeti verileriyle dönüşümler raporlanıyorsa kullanılabilir. Bu metrik, parasal bir değerdir ve varsayılan olarak müşterinin para biriminde döndürülür. https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause adresindeki metrics_currency parametresini 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 reklamın ilişkili bir ürünü varsa (bkz. Alışveriş reklamları) bu ürün, reklamı yapılan ürün olarak kabul edilir. Müşterinin verdiği siparişi eklenen her ürün, satılan üründür. 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 reklamın ilişkili bir ürünü varsa (bkz. Alışveriş reklamları) bu ürün, reklamı yapılan ürün olarak kabul edilir. Müşterinin verdiği siparişi eklenen her ürün, satılan üründür. Bu ürünlerin eşleşmemesi, çapraz satış olarak kabul edilir. Çapraz satışla satılan birim sayısı, reklamlarınızla ilişkilendirilen tüm siparişlerdeki çapraz satışla satılan toplam ürün sayısıdır. Örnek: Bir müşteri, şapka tanıtılan bir Alışveriş reklamını tıklayıp söz konusu şapkayla birlikte bir gömlek ve ceket satın alır. Bu siparişteki çapraz satışla satılan birim sayısı 2'dir. Bu metrik yalnızca alışveriş sepeti verileriyle dönüşümler raporlanıyorsa kullanılabilir.

clientAccountLeadCostOfGoodsSoldMicros

string (int64 format)

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

leadCostOfGoodsSoldMicros

string (int64 format)

Reklamı yapıldıktan sonra satılan malların maliyeti (SMM), bir ürünün reklamının yapılması sonucunda bu üründen satılan birimlerin toplam maliyetidir. İşleyiş şekli: Web sitenizde tamamlanan satın alma işlemleri için alışveriş sepeti verileriyle dönüşümleri raporlarsınız. Etkileşimde bulunulan reklamla ilişkilendirilmiş bir ürün varsa (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 adresinde metrics_currency parametresini inceleyin.

clientAccountLeadGrossProfitMicros

string (int64 format)

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

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 adresinde metrics_currency parametresini inceleyin.

leadRevenueMicros

string (int64 format)

Reklamı yapılan üründen elde edilen gelir, bir ürünün reklamının yapılması sonucunda satılan birimlerinden elde edilen toplam tutardır. İşleyiş şekli: Web sitenizde tamamlanan satın alma işlemleri için alışveriş sepeti verileriyle dönüşümleri raporlarsınız. Satın alma işleminden önce etkileşimde bulunulan 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ır. Şapka 10 TL, gömlek ise 20 TL'dir. Bu sipariş için "reklamı yapılan üründen elde edilen gelir" 10 TL'dir. Bu metrik yalnızca alışveriş sepeti verileriyle dönüşümler raporlanıyorsa kullanılabilir. Bu metrik, parasal bir değerdir ve varsayılan olarak müşterinin para biriminde döndürülür. https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause adresinde metrics_currency parametresini inceleyin.

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

leadUnitsSold

number

Satılan potansiyel müşteri birimi sayısı, bir ürünün reklamının yapılması sonucunda bu üründen satılan toplam birim sayısıdır. İşleyiş şekli: Web sitenizde tamamlanan satın alma işlemleri için alışveriş sepeti verileriyle dönüşümleri raporlarsınız. Satın alma işleminden önce etkileşimde bulunulan reklamın ilişkili bir ürünü varsa (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ır. Bu siparişte satılan potansiyel müşteri birimi sayısı 1'dir. Bu metrik yalnızca alışveriş sepeti verileriyle dönüşümler raporlanıyorsa kullanılabilir.

Değer

Genel bir veri kapsayıcısı.

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

boolean

Boole değeri.

int64Value

string (int64 format)

Bir int64.

floatValue

number

Bir kayan.

doubleValue

number

Çift.

stringValue

string

Dize.

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 ortalamadır.
ABOVE_AVERAGE Reklam öğesinin kalitesi ortalamanın üzerindedir.

InteractionEventType

Ödenebilir ve ücretsiz etkileşim türlerini açıklayan bir enum.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca döndürülen değer için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
CLICK Siteyi tıklayın. Çoğu durumda bu etkileşim, kullanıcıyı harici bir konuma (genellikle reklamverenin açılış sayfasına) yönlendirir. Bu, tıklama etkinlikleri için varsayılan InteractionEventType değeridir.
ENGAGEMENT Kullanıcının, reklamla etkileşim kurmak için ifade ettiği amaç.
VIDEO_VIEW Kullanıcı bir video reklamı görüntüledi.
NONE Reklam dönüşümü etkinlikleri için varsayılan InteractionEventType. Bu, bir reklam dönüşümü satırı ücretsiz etkileşimlerin (ör. reklam dönüşümleri) "tanıtılması" ve temel metriklerin bir parçası olarak raporlanması gerektiğini İŞARET ETMEDİĞİNDE kullanılır. Bunlar, diğer (reklam) dönüşümleridir.

Segmentler

Yalnızca segment alanları.

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

enum (AdNetworkType)

Reklam ağı türü.

conversionActionCategory

enum (ConversionActionCategory)

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

conversionCustomDimensions[]

object (Value)

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

dayOfWeek

enum (DayOfWeek)

Haftanın günü (ör. PAZARTESİ).

device

enum (Device)

Metriklerin 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, ör. 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 metroyu temsil eden coğrafi hedef sabitinin kaynak adı.

geoTargetRegion

string

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

hour

integer

Günün saati (0 ile 23 arasında bir sayı).

month

string

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

productBiddingCategoryLevel1

string

Ürünün teklif kategorisi (1. seviye).

productBiddingCategoryLevel2

string

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

productBiddingCategoryLevel3

string

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

productBiddingCategoryLevel4

string

Ürünün teklif kategorisi (4. seviye).

productBiddingCategoryLevel5

string

Ürünün teklif kategorisi (5. seviye).

productBrand

string

Ürünün markası.

productCountry

string

Ürünün satış yapılan ülkesi için coğrafi hedef sabitinin kaynak adı.

productCustomAttribute0

string

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

productCustomAttribute1

string

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

productCustomAttribute2

string

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

productCustomAttribute3

string

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

productCustomAttribute4

string

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

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 kategorisi (1. seviye).

productSoldBiddingCategoryLevel2

string

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

productSoldBiddingCategoryLevel3

string

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

productSoldBiddingCategoryLevel4

string

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

productSoldBiddingCategoryLevel5

string

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

productSoldBrand

string

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

productSoldCustomAttribute0

string

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

productSoldCustomAttribute1

string

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

productSoldCustomAttribute2

string

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

productSoldCustomAttribute3

string

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

productSoldCustomAttribute4

string

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

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

Çeyreğin 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 biçimindedir.

week

string

Pazartesiden pazara kadar olan ve pazartesi tarihiyle temsil edilen hafta. yyyy-AA-gg biçimindedir.

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), birlikte yayınlandıklarında yayınlanan reklamın tüm bölümlerinde (ör. reklamın kendisi ve Site bağlantıları gibi diğer bileşenler) sayılır. interactionOnThisAsset doğru olduğunda etkileşimlerin bu öğede olduğu, interactionOnThisAsset yanlış olduğunda ise etkileşimlerin bu öğede değil, bu öğenin yayınlandığı reklamın diğer bölümlerinde olduğu anlamına gelir.

AdNetworkType

Google Ads ağ türlerini listeler.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Değer bu sürümde bilinmiyor.
SEARCH Google'da arama.
SEARCH_PARTNERS Arama Ağı iş ortakları.
CONTENT Görüntülü Reklam Ağı.
YOUTUBE_WATCH YouTube Videoları
MIXED Ağlar arası.

Keyword

Anahtar kelime ölçütü segmenti.

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

object (KeywordInfo)

Anahtar kelime bilgileri.

adGroupCriterion

string

AdGroupCriterion kaynak adı.

ProductChannelExclusivity

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

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca döndürülen değer için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
SINGLE_CHANNEL Ürün, ProductChannel özelliğinde belirtildiği gibi yerel mağazalar veya internet üzerinden yalnızca bir kanal üzerinden satılıyor.
MULTI_CHANNEL Öğe, online veya yerel mağazalardaki eşdeğeriyle eşleştirilir. Bu, ürünün her iki ShoppingProductChannels'de de 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ılmış"tır.

AssetInteractionTarget

AssetEngagementTarget segmentidir.

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.