Package google.ads.searchads360.v0.resources

Dizin

AccessibleBiddingStrategy

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

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

Alanlar
resource_name

string

Erişime açık teklif stratejisinin kaynak adı. AccessibleBiddingStrategy kaynak adları şu biçimdedir:

customers/{customer_id}/accessibleBiddingStrategies/{bidding_strategy_id}

id

int64

Teklif stratejisinin kimliği.

name

string

Teklif stratejisinin adı.

type

BiddingStrategyType

Teklif stratejisinin türü.

owner_customer_id

int64

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

owner_descriptive_name

string

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

Birlik alanı scheme. Teklif verme şeması.

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

maximize_conversion_value

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.

maximize_conversions

MaximizeConversions

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

target_cpa

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.

target_impression_share

TargetImpressionShare

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

target_roas

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.

target_spend

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.

Alanlar
target_roas

double

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

Alanlar
target_cpa

int64

Hedef edinme başına maliyet (EBM) seçeneği. Bu, edinme başına harcamak istediğiniz ortalama tutardır.

target_cpa_micros

int64

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.

Alanlar
target_cpa_micros

int64

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.

Alanlar
location

TargetImpressionShareLocation

Arama sonuçları sayfasındaki hedeflenen konum.

location_fraction_micros

int64

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

cpc_bid_ceiling_micros

int64

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 reklam harcamalarından elde edilen gelir (ROAS) hedefinin ortalamasını alırken geliri en üst düzeye çıkarmanıza yardımcı olan otomatik teklif stratejisi.

Alanlar
target_roas

double

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

TargetSpend

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

Alanlar
target_spend_micros
(deprecated)

int64

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.

cpc_bid_ceiling_micros

int64

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.

Reklam.

Alanlar
resource_name

string

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

customers/{customer_id}/ads/{ad_id}

final_urls[]

string

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

type

AdType

Reklamın türü.

id

int64

Reklamın kimliği.

display_url

string

Bazı reklam biçimlerinin reklam açıklamasında görünen URL.

name

string

Reklamın adı. Bu bilgi yalnızca reklamı tanımlamak için kullanılır. Benzersiz olması gerekmez ve yayınlanan reklamı etkilemez. Ad alanı şu anda yalnızca DisplayUploadAd, ImageAd, ShoppingComparisonListingAd ve VideoAd için desteklenmektedir.

Birlik alanı ad_data. Reklam türüyle ilgili ayrıntılar. Tam olarak bir değer ayarlanmalıdır. ad_data yalnızca aşağıdakilerden biri olabilir:
text_ad

SearchAds360TextAdInfo

Metin reklamla ilgili ayrıntılar.

expanded_text_ad

SearchAds360ExpandedTextAdInfo

Genişletilmiş metin reklamla ilgili ayrıntılar.

responsive_search_ad

SearchAds360ResponsiveSearchAdInfo

Duyarlı arama ağı reklamıyla ilgili ayrıntılar.

product_ad

SearchAds360ProductAdInfo

Ürün reklamıyla ilgili ayrıntılar.

expanded_dynamic_search_ad

SearchAds360ExpandedDynamicSearchAdInfo

Genişletilmiş dinamik arama ağı reklamıyla ilgili ayrıntılar.

Reklam Grubu

Bir reklam grubu.

Alanlar
resource_name

string

Reklam grubunun kaynak adı. Reklam grubu kaynak adları şu şekildedir:

customers/{customer_id}/adGroups/{ad_group_id}

status

AdGroupStatus

Reklam grubunun durumu.

type

AdGroupType

Reklam grubunun türü.

ad_rotation_mode

AdGroupAdRotationMode

Reklam grubunun reklam rotasyonu modu.

creation_time

string

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

targeting_setting

TargetingSetting

Hedeflemeyle ilgili özellikler için ayar.

labels[]

string

Bu reklam grubuna eklenmiş etiketlerin kaynak adları.

effective_labels[]

string

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

engine_id

string

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

start_date

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

end_date

string

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

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

language_code

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

last_modified_time

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

int64

Reklam grubunun kimliği.

name

string

Reklam grubunun adı.

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

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

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

cpc_bid_micros

int64

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

engine_status

AdGroupEngineStatus

Reklam grubunun motor durumu.

AdGroupAd

Reklam grubu reklamı.

Alanlar
resource_name

string

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

customers/{customer_id}/adGroupAds/{ad_group_id}~{ad_id}

status

AdGroupAdStatus

Reklamın durumu.

ad

Ad

Reklam.

creation_time

string

Bu ad_group_ad öğesinin 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 ekli etiketlerin kaynak adları.

engine_id

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 "ad_group_ad.ad.id" değerini kullanın.

engine_status

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.

last_modified_time

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.

AdGroupAdLabel

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

Alanlar
resource_name

string

Reklam grubu reklam etiketinin kaynak adı. Reklam grubu reklam etiketi kaynak adları şu şekildedir: customers/{customer_id}/adGroupAdLabels/{ad_group_id}~{ad_id}~{label_id}

ad_group_ad

string

Etiketin eklendiği reklam grubu reklamı.

label

string

Reklam grubu reklamına atanan etiket.

owner_customer_id

int64

Etiketin sahibi olan müşterinin kimliği.

AdGroupAsset

Reklam grubu ile öğe arasındaki bağlantıdır.

Alanlar
resource_name

string

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

customers/{customer_id}/adGroupAssets/{ad_group_id}~{asset_id}~{field_type}

ad_group

string

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

asset

string

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

status

AssetLinkStatus

Reklam grubu öğesinin durumu.

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.

Alanlar
resource_name

string

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

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

ad_group

string

Bu öğe grubunun bağlı olduğu reklam grubu.

asset_set

string

Reklam grubuna bağlı öğe grubu.

status

AssetSetLinkStatus

Reklam grubu öğe grubunun durumu. Salt okunur.

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.

Alanlar
resource_name

string

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

customers/{customer_id}/adGroupAudienceViews/{ad_group_id}~{criterion_id}

AdGroupBidModifier

Reklam grubu teklif değiştiriciyi temsil eder.

Alanlar
resource_name

string

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

customers/{customer_id}/adGroupBidModifiers/{ad_group_id}~{criterion_id}

bid_modifier

double

Ölçüt eşleştiğinde teklifin değiştiricisi. Değiştirici 0,1 - 10,0 aralığında olmalıdır. PreferredContent için aralık 1,0 - 6,0'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 başlayan oluşturma işlemlerinde gereklidir. criterion yalnızca aşağıdakilerden biri olabilir:

device

DeviceInfo

Cihaz ölçütü.

AdGroupCriterion

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

Alanlar
resource_name

string

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

customers/{customer_id}/adGroupCriteria/{ad_group_id}~{criterion_id}

creation_time

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

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.

quality_info

QualityInfo

Ölçünün kalitesiyle ilgili bilgiler.

type

CriterionType

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

labels[]

string

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

position_estimates

PositionEstimates

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

final_urls[]

string

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

engine_id

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 vb.) içindir. Google Ads öğesi için bunun yerine "ad_group_criterion.criterion_id" değerini kullanın.

last_modified_time

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.

criterion_id

int64

Ölçütün kimliği.

ad_group

string

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

negative

bool

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

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

bid_modifier

double

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

cpc_bid_micros

int64

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

effective_cpc_bid_micros

int64

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

engine_status

AdGroupCriterionEngineStatus

Reklam grubu ölçütü için motor durumu.

final_url_suffix

string

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

tracking_url_template

string

İzleme URL'si oluşturmaya yönelik 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

KeywordInfo

Anahtar kelime.

listing_group

ListingGroupInfo

Giriş grubu.

age_range

AgeRangeInfo

Yaş grubu.

gender

GenderInfo

Cinsiyet.

user_list

UserListInfo

Kullanıcı Listesi.

webpage

WebpageInfo

Web Sayfası

location

LocationInfo

Konum'a dokunun.

PositionEstimates

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

Alanlar
top_of_page_cpc_micros

int64

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.

QualityInfo

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

Alanlar
quality_score

int32

Kalite puanı.

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

AdGroupCriterionLabel

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

Alanlar
resource_name

string

Reklam grubu ölçütü etiketinin kaynak adı. Reklam grubu ölçütü etiketi kaynak adları şu şekildedir: customers/{customer_id}/adGroupCriterionLabels/{ad_group_id}~{criterion_id}~{label_id}

ad_group_criterion

string

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

label

string

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

owner_customer_id

int64

Etiketin sahibi olan Müşteri'nin 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.

Alanlar
resource_name

string

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

ad_group

string

Etkili etiketin eklendiği reklam grubu.

label

string

Reklam grubuna atanan etkili etiket.

owner_customer_id

int64

Geçerli etikete sahip olan Müşteri'nin kimliği.

AdGroupLabel

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

Alanlar
resource_name

string

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

ad_group

string

Etiketin eklendiği reklam grubu.

label

string

Reklam grubuna atanan etiket.

owner_customer_id

int64

Etiketin sahibi olan müşterinin kimliği.

AgeRangeView

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

Alanlar
resource_name

string

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

customers/{customer_id}/ageRangeViews/{ad_group_id}~{criterion_id}

Öğ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.

Alanlar
resource_name

string

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

customers/{customer_id}/assets/{asset_id}

type

AssetType

Öğenin türü.

final_urls[]

string

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

status

AssetStatus

Öğenin durumu.

creation_time

string

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

last_modified_time

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

int64

Öğenin kimliği.

name

string

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

tracking_url_template

string

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

engine_status

AssetEngineStatus

Bir öğenin motor durumu.

Birlik alanı asset_data. Öğenin türü. asset_data yalnızca aşağıdakilerden biri olabilir:
youtube_video_asset

YoutubeVideoAsset

YouTube video öğesi.

image_asset

ImageAsset

Resim öğesi.

text_asset

TextAsset

Metin öğesi.

callout_asset

UnifiedCalloutAsset

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

page_feed_asset

UnifiedPageFeedAsset

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

mobile_app_asset

MobileAppAsset

Mobil uygulama öğesi.

call_asset

UnifiedCallAsset

Birleştirilmiş bir telefon öğesi.

call_to_action_asset

CallToActionAsset

Harekete geçirici mesaj öğesi.

location_asset

UnifiedLocationAsset

Birleştirilmiş yer öğesi

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.

Alanlar
resource_name

string

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

customers/{customer_id}/assetGroups/{asset_group_id}

id

int64

Öğ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.

final_urls[]

string

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

final_mobile_urls[]

string

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

status

AssetGroupStatus

Öğe grubunun durumu.

path1

string

Reklamda görüntülenen URL'ye eklenmiş olarak 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.

ad_strength

AdStrength

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

AssetGroupAsset

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

Alanlar
resource_name

string

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

customers/{customer_id}/assetGroupAssets/{asset_group_id}~{asset_id}~{field_type}

asset_group

string

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

asset

string

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

field_type

AssetFieldType

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

status

AssetLinkStatus

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

AssetGroupAssetCombinationData

Öğe grubu öğe kombinasyonu verileri

Alanlar
asset_combination_served_assets[]

AssetUsage

Yayınlanan öğeler.

AssetGroupListingGroupFilter

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

Alanlar
resource_name

string

Öğe grubu listeleme grubu filtresinin kaynak adı. Öğe grubu listeleme grubu filtresi kaynak adı şu şekildedir:

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

asset_group

string

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

id

int64

ListingGroupFilter öğesinin kimliği.

type

ListingGroupFilterType

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

vertical

ListingGroupFilterVertical

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

case_value

ListingGroupFilterDimension

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

parent_listing_group_filter

string

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

path

ListingGroupFilterDimensionPath

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

AssetGroupSignal

AssetGroupSignal, bir öğe grubundaki bir sinyali temsil eder. Bir sinyalin mevcut olması, dönüşüm gerçekleştirme olasılığı en yüksek olan Maksimum Performans kampanyasına bilgi verir. 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.

Alanlar
resource_name

string

Öğe grubu sinyalinin kaynak adı. Öğe grubu sinyal kaynak adı şu biçimdedir:

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

asset_group

string

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

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

AudienceInfo

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

AssetGroupTopCombinationView

Reklam grubu reklam öğesi kombinasyonunun kullanımına yönelik görünüm.

Alanlar
resource_name

string

Öğe grubu en iyi kombinasyon görünümünün kaynak adı. AssetGroup En İyi Kombinasyon görünümü kaynak adları şu biçimdedir: `"customers/{customer_id}/assetGroupTopCombinationViews/{asset_group_id}~{asset_combination_category}"

asset_group_top_combinations[]

AssetGroupAssetCombinationData

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

AssetSet

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

Alanlar
id

int64

Öğe grubunun kimliği.

resource_name

string

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

customers/{customer_id}/assetSets/{asset_set_id}

AssetSetAsset

AssetSetAsset, bir öğe ile öğe grubu arasındaki bağlantıdır. AssetSetAsset eklemek, bir öğe grubuna sahip öğeyi bağlar.

Alanlar
resource_name

string

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

customers/{customer_id}/assetSetAssets/{asset_set_id}~{asset_id}

asset_set

string

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

asset

string

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

status

AssetSetAssetStatus

Feed öğesinin durumu. Salt okunur.

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.

Alanlar
resource_name

string

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

customers/{customer_id}/audiences/{audience_id}

id

int64

Kitlenin kimliği.

name

string

Zorunlu. Kitlenin adı. Tüm kitleler arasında benzersiz olmalıdır. Açıklama uzunluğu en az 1, maksimum 255 olmalıdır.

description

string

Bu kitlenin açıklaması.

BiddingStrategy

Teklif stratejisi.

Alanlar
resource_name

string

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

customers/{customer_id}/biddingStrategies/{bidding_strategy_id}

status

BiddingStrategyStatus

Teklif stratejisinin durumu.

Bu alan salt okunur.

type

BiddingStrategyType

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

Bu alan salt okunur.

currency_code

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şturulurken ayarlanabilir ve varsayılan olarak yönetici müşterinin para birimi olur. 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. effective_currency_code alanı her durumda strateji tarafından kullanılan para birimini döndürür.

id

int64

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.

effective_currency_code

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 vermek için bu değer, müşterinin currency_code değeridir.

Teklif stratejisi metrikleri bu para biriminde raporlanır.

Bu alan salt okunur.

campaign_count

int64

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

Bu alan salt okunur.

non_removed_campaign_count

int64

Bu teklif stratejisine bağlı, kaldırılmamış kampanyaların sayısı.

Bu alan salt okunur.

Birlik alanı scheme. Teklif verme şeması.

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

enhanced_cpc

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.

maximize_conversion_value

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.

maximize_conversions

MaximizeConversions

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

target_cpa

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.

target_impression_share

TargetImpressionShare

Seçilen gösterim yüzdesi için otomatik olarak optimizasyon yapan bir teklif stratejisidir.

target_outrank_share

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 bir kampanyaya bu alanla teklif stratejileri eklemek başarısız olur. Bu şemanın doldurulduğu stratejilere mutasyona izin verilir.

target_roas

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.

target_spend

TargetSpend

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

Kampanya

Bir kampanya.

Alanlar
resource_name

string

Kampanyanın kaynak adı. Kampanya kaynak adları şu şekildedir:

customers/{customer_id}/campaigns/{campaign_id}

status

CampaignStatus

Kampanyanın durumu.

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

serving_status

CampaignServingStatus

Kampanyanın reklam sunma durumu.

bidding_strategy_system_status

BiddingStrategySystemStatus

Kampanyanın teklif stratejisinin sistem durumu.

ad_serving_optimization_status

AdServingOptimizationStatus

Kampanyanın reklam sunma optimizasyonu durumu.

advertising_channel_type

AdvertisingChannelType

Kampanyadaki reklamlar için birincil yayınlama hedefi. Hedefleme seçenekleri network_settings 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.

advertising_channel_sub_type

AdvertisingChannelSubType

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

url_custom_parameters[]

CustomParameter

tracking_url_template, final_urls veya mobile_final_urls içindeki özel parametre etiketlerinin yerine geçmek için kullanılan eşlemelerin listesi.

real_time_bidding_setting

RealTimeBiddingSetting

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

network_settings

NetworkSettings

Kampanyanın ağ ayarları.

dynamic_search_ads_setting

DynamicSearchAdsSetting

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

shopping_setting

ShoppingSetting

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

geo_target_type_setting

GeoTargetTypeSetting

Reklamların coğrafi hedefleme ayarı.

effective_labels[]

string

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

labels[]

string

Bu kampanyaya eklenmiş etiketlerin kaynak adları.

bidding_strategy_type

BiddingStrategyType

Teklif stratejisinin türü.

Teklif stratejisi, teklif şeması standart bir teklif stratejisi oluşturacak şekilde veya bidding_strategy alanı portföy teklifi stratejisi oluşturacak şekilde ayarlanarak oluşturulabilir.

Bu alan salt okunurdur.

accessible_bidding_strategy

string

AccessibleBiddingStrategy adlı kaynağın adı. Bu kaynak, "bidding_strategy" ile tanımlanan ekteki portföy teklifi stratejisinin sınırsız özelliklerinin salt okunur bir görünümüdür. 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.

frequency_caps[]

FrequencyCapEntry

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

selective_optimization

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.

optimization_goal_setting

OptimizationGoalSetting

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

tracking_setting

TrackingSetting

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

engine_id

string

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

excluded_parent_asset_field_types[]

AssetFieldType

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

create_time

string

Bu kampanyanın oluşturulduğu zaman damgası. Zaman damgası, müşterinin saat diliminde ve "yyyy-AA-gg SS:dd:ss" biçimindedir. create_time, v1 sürümünde kullanımdan kaldırılacaktır. Bunun yerine creation_time parametresini kullanın.

creation_time

string

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

last_modified_time

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

int64

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.

tracking_url_template

string

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

campaign_budget

string

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

start_date

string

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

end_date

string

Müşterinin saat diliminde kampanyanın son günü (YYYY-AA-GG biçiminde). Oluşturulma sırasında varsayılan olarak 30.12.2037 olarak ayarlanır. Bu, kampanyanın süresiz olarak yayınlanacağı anlamına gelir. Mevcut bir kampanyayı süresiz olarak yayınlanacak şekilde ayarlamak için bu alanı 30.12.2037 olarak ayarlayın.

final_url_suffix

string

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

url_expansion_opt_out

bool

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.

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

bidding_strategy

string

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

manual_cpa

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.

manual_cpc

ManualCpc

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

manual_cpm

ManualCpm

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

maximize_conversions

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.

maximize_conversion_value

MaximizeConversionValue

Bütçeniz harcanırken geliri en üst düzeye çıkarmak için teklifleri otomatik olarak ayarlayan Standart Dönüşüm Değerini Artırma teklif stratejisidir.

target_cpa

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.

target_impression_share

TargetImpressionShare

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

target_roas

TargetRoas

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

target_spend

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

percent_cpc

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.

target_cpm

TargetCpm

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

DynamicSearchAdsSetting

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

Alanlar
domain_name

string

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

language_code

string

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

use_supplied_urls_only

bool

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

GeoTargetTypeSetting

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

Alanlar
positive_geo_target_type

PositiveGeoTargetType

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

negative_geo_target_type

NegativeGeoTargetType

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

NetworkSettings

Kampanyanın ağ ayarları.

Alanlar
target_search_network

bool

Reklamların Google Arama Ağı'ndaki iş ortağı sitelerinde yayınlanıp yayınlanmayacağını belirtir (target_google_search için true değerinin de true olması gerekir).

target_content_network

bool

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.

target_partner_search_network

bool

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

OptimizationGoalSetting

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

Alanlar
optimization_goal_types[]

OptimizationGoalType

Optimizasyon hedefi türlerinin listesi.

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.

Alanlar
conversion_actions[]

string

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

ShoppingSetting

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

Alanlar
feed_label

string

Kampanyaya dahil edilecek ürünlerin feed etiketi. feed_label veya sales_country değerlerinden yalnızca biri belirlenebilir. satış_ülkesi yerine kullanılırsa feed_label alanı aynı biçimde ülke kodlarını (ör. "XX") kabul eder. Aksi takdirde, Google Merchant Center'da feed etiketi için kullanılan herhangi bir dize olabilir.

use_vehicle_inventory

bool

Araç listelemesi envanterinin hedeflenip hedeflenmeyeceği.

merchant_id

int64

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.

sales_country

string

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

campaign_priority

int32

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 ayarlanmışsa 3'e eşit olmalıdır.

enable_local

bool

Yerel ürünlerin dahil edilip edilmeyeceği.

TrackingSetting

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

Alanlar
tracking_url

string

Dinamik izleme için kullanılan URL.

CampaignAsset

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

Alanlar
resource_name

string

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

customers/{customer_id}/campaignAssets/{campaign_id}~{asset_id}~{field_type}

status

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.

Alanlar
resource_name

string

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

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

campaign

string

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

asset_set

string

Kampanyaya bağlı öğe grubu.

status

AssetSetLinkStatus

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

Alanlar
resource_name

string

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

customers/{customer_id}/campaignAudienceViews/{campaign_id}~{criterion_id}

CampaignBudget

Kampanya bütçesi.

Alanlar
resource_name

string

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

customers/{customer_id}/campaignBudgets/{campaign_budget_id}

delivery_method

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

BudgetPeriod

Bütçenin harcanacağı dönem. Belirtilmezse varsayılan olarak GÜNLÜK olur.

amount_micros

int64

Hesabın yerel para biriminde bütçe tutarı. Miktar, bir milyonun bir para birimi birimine eşit olduğu mikro birim cinsinden belirtilir. Aylık harcama, bu tutarın 30,4 katı ile sınırlıdır.

CampaignCriterion

Kampanya ölçütü.

Alanlar
resource_name

string

Kampanya ölçütünün kaynak adı. Kampanya ölçütü kaynak adları şu şekildedir:

customers/{customer_id}/campaignCriteria/{campaign_id}~{criterion_id}

display_name

string

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

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

type

CriterionType

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

status

CampaignCriterionStatus

Ölçütün durumu.

last_modified_time

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.

criterion_id

int64

Ölçütün kimliği.

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

bid_modifier

float

Ö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

bool

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

Birlik alanı criterion. Kampanya ölçütü.

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

keyword

KeywordInfo

Anahtar kelime.

location

LocationInfo

Konum'a dokunun.

device

DeviceInfo

Cihaz) belirtin.

age_range

AgeRangeInfo

Yaş grubu.

gender

GenderInfo

Cinsiyet.

user_list

UserListInfo

Kullanıcı Listesi.

language

LanguageInfo

Dil.

webpage

WebpageInfo

Web sayfası.

location_group

LocationGroupInfo

Yer grubu

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.

Alanlar
resource_name

string

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

campaign

string

Etkili etiketin eklendiği kampanya.

label

string

Kampanyaya atanan etkili etiket.

owner_customer_id

int64

Geçerli etikete sahip olan Müşteri'nin kimliği.

CampaignLabel

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

Alanlar
resource_name

string

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

campaign

string

Etiketin eklendiği kampanya.

label

string

Kampanyaya atanan etiket.

owner_customer_id

int64

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

CartDataSalesView

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

Alanlar
resource_name

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/{customer_id}/cartDataSalesView

Dönüşüm

Dönüşüm.

Alanlar
resource_name

string

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

customers/{customer_id}/conversions/{ad_group_id}~{criterion_id}~{ds_conversion_id}

id

int64

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

criterion_id

int64

Search Ads 360 ölçüt kimliği. 0 değeri, ölçütün ilişkilendirilmemiş olduğunu gösterir.

merchant_id

int64

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.

ad_id

int64

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

click_id

string

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

visit_id

int64

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

advertiser_conversion_id

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 floodlight_order_id sütununa eşittir.

product_id

string

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

product_channel

ProductChannel

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

product_language_code

string

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

product_store_id

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.

product_country_code

string

Tıklanan ürünü içeren envanter feed'i için kaydedilen ülke (ISO-3166 biçiminde).

attribution_type

AttributionType

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

conversion_date_time

string

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

conversion_last_modified_date_time

string

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

conversion_visit_date_time

string

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

conversion_quantity

int64

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

conversion_revenue_micros

int64

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

floodlight_original_revenue

int64

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

floodlight_order_id

string

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

status

ConversionStatus

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

asset_id

int64

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

asset_field_type

AssetFieldType

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

ConversionAction

Dönüşüm işlemi.

Alanlar
resource_name

string

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

customers/{customer_id}/conversionActions/{conversion_action_id}

creation_time

string

Floodlight etkinliğinin oluşturulduğu zaman damgası (ISO 8601 biçiminde).

status

ConversionActionStatus

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

type

ConversionActionType

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

category

ConversionActionCategory

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

value_settings

ValueSettings

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

attribution_model_settings

AttributionModelSettings

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

floodlight_settings

FloodlightSettings

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

id

int64

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.

primary_for_goal

bool

Bir dönüşüm işleminin birincil_for_goal biti yanlışsa müşteri dönüşüm hedefi veya kampanya dönüşüm hedefinden bağımsız olarak, dönüşüm işlemi tüm kampanyalar için teklif edilemez. Ancak özel dönüşüm hedefleri, primary_for_goal özelliğine uymaz. Bu nedenle, bir kampanyada primary_for_goal = false dönüşüm işlemiyle yapılandırılmış bir özel dönüşüm hedefi varsa bu dönüşüm işlemi için yine de teklif verilebilir. Ayarlanmamışsa primary_for_goal varsayılan olarak true (doğru) olur. 9. sürümde, primary_for_goal isteğe bağlı olarak tanımlanmadığı için yalnızca oluşturulduktan sonra bir "update" işlemiyle false olarak ayarlanabilir.

owner_customer

string

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

include_in_client_account_conversions_metric

bool

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

include_in_conversions_metric

bool

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

click_through_lookback_window_days

int64

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

app_id

string

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

AttributionModelSettings

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

Alanlar
attribution_model

AttributionModel

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

data_driven_model_status

DataDrivenModelStatus

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

FloodlightSettings

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

Alanlar
activity_group_tag

string

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

activity_tag

string

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

activity_id

int64

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

ValueSettings

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

Alanlar
default_value

double

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.

default_currency_code

string

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

always_use_default_value

bool

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.

ConversionCustomVariable

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

Alanlar
resource_name

string

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

customers/{customer_id}/conversionCustomVariables/{conversion_custom_variable_id}

id

int64

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

ConversionCustomVariableStatus

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

owner_customer

string

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

family

ConversionCustomVariableFamily

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

cardinality

ConversionCustomVariableCardinality

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

floodlight_conversion_custom_variable_info

FloodlightConversionCustomVariableInfo

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

custom_column_ids[]

int64

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

FloodlightConversionCustomVariableInfo

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

Alanlar
floodlight_variable_type

FloodlightVariableType

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

floodlight_variable_data_type

FloodlightVariableDataType

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

ConversionTrackingSetting

Search Ads 360 Dönüşüm İzleme ile ilgili müşteri genelindeki ayarların bir koleksiyonu.

Alanlar
accepted_customer_data_terms

bool

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

conversion_tracking_status

ConversionTrackingStatus

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

enhanced_conversions_for_leads_enabled

bool

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.

google_ads_conversion_customer

string

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

conversion_tracking_id

int64

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 (conversion_tracking_status bunu belirtir). Bu alan salt okunur.

google_ads_cross_account_conversion_tracking_id

int64

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

cross_account_conversion_tracking_id

int64

Müşteri yöneticisinin dönüşüm izleme kimliği. Bu parametre, müşteri hesaplar arası dönüşüm izlemeyi etkinleştirdiğinde ayarlanır ve conversion_tracking_id parametresinin geçersiz kılınmasına neden olur.

CustomColumn

Özel sütun. Search Ads 360 özel sütunu hakkında bilgi edinmek için https://support.google.com/sa360/answer/9633916 adresini ziyaret edin.

Alanlar
resource_name

string

Özel sütunun kaynak adı. Özel sütun kaynağı adları şu şekildedir:

customers/{customer_id}/customColumns/{custom_column_id}

id

int64

Özel sütunun kimliği.

name

string

Özel sütunun kullanıcı tanımlı adı.

description

string

Özel sütunun kullanıcı tanımlı açıklaması.

value_type

CustomColumnValueType

Özel sütunun sonuç değerinin türü.

references_attributes

bool

Özel sütun bir veya daha fazla özelliğe atıfta bulunduğunda doğru değerini döndürür.

references_metrics

bool

Özel sütun bir veya daha fazla metriğe başvurduğunda doğru değerini döndürür.

queryable

bool

Özel sütun, SearchAds360Service.Search ve SearchAds360Service.SearchStream sorgusunda kullanılabiliyorsa doğru değerini döndürür.

referenced_system_columns[]

string

Bu özel sütunun referans verilen sistem sütunlarının listesi. Örneğin, "gösterim ve tıklama sayısı toplamı" adlı özel bir sütun, {"metrics.clicks", "metrics.impressions"} sistem sütunlarına referans vermiştir.

render_type

CustomColumnRenderType

Özel sütunun sonuç değerinin nasıl yorumlanması gerektiği.

Müşteri

Müşteri.

Alanlar
resource_name

string

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

customers/{customer_id}

conversion_tracking_setting

ConversionTrackingSetting

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

account_type

AccountType

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

double_click_campaign_manager_setting

DoubleClickCampaignManagerSetting

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

account_status

AccountStatus

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

last_modified_time

string

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

engine_id

string

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

status

CustomerStatus

Müşterinin durumu.

creation_time

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

int64

Müşterinin kimliği.

descriptive_name

string

Müşterinin isteğe bağlı, benzersiz olmayan açıklayıcı adı.

currency_code

string

Hesabın çalıştığı para birimi. ISO 4217 standardındaki para birimi kodlarının bir alt kümesi desteklenir.

time_zone

string

Müşterinin yerel saat dilimi kimliği.

tracking_url_template

string

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

final_url_suffix

string

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

auto_tagging_enabled

bool

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

manager

bool

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

CustomerAsset

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

Alanlar
resource_name

string

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

customers/{customer_id}/customerAssets/{asset_id}~{field_type}

asset

string

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

status

AssetLinkStatus

Müşteri öğesinin durumu.

CustomerAssetSet

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

Alanlar
resource_name

string

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

customers/{customer_id}/customerAssetSets/{asset_set_id}

asset_set

string

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

customer

string

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

status

AssetSetLinkStatus

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

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 doğrudan ve dolaylı müşterilerin tümü bu kapsama dahil edilir.

Alanlar
resource_name

string

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

applied_labels[]

string

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

customers/{customer_id}/labels/{label_id}

status

CustomerStatus

Müşterinin durumu. Salt okunur.

client_customer

string

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

hidden

bool

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

Salt okunur.

level

int64

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.

time_zone

string

İstemcinin saat diliminin Ortak Yerel Veri Deposu (CLDR) dize gösterimi (ör. Amerika/Los_Angeles). Salt okunur.

test_account

bool

İstemcinin test hesabı olup olmadığını tanımlar. Salt okunur.

manager

bool

İstemcinin yönetici olup olmadığını belirtir. Salt okunur.

descriptive_name

string

İstemcinin açıklayıcı adı. Salt okunur.

currency_code

string

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

id

int64

İstemci müşterinin kimliği. Salt okunur.

DoubleClickCampaignManagerSetting

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

Alanlar
advertiser_id

int64

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

network_id

int64

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

time_zone

string

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

DynamicSearchAdsSearchTermView

Dinamik Arama Ağı Reklamları arama terimi görünümü.

Alanlar
resource_name

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/{customer_id}/dynamicSearchAdsSearchTermViews/{ad_group_id}~{search_term_fingerprint}~{headline_fingerprint}~{landing_page_fingerprint}~{page_url_fingerprint}

landing_page

string

Gösterimin dinamik olarak seçilen açılış sayfası URL'si.

Bu alan salt okunurdur.

GenderView

Cinsiyet görünümü. gender_view kaynağı, hangi ölçütlerin eklendiğini değil, geçerli yayın durumunu yansıtır. Cinsiyet ölçütü olmayan bir reklam grubu varsayılan olarak tüm cinsiyetlere gösterilir. Bu nedenle, tüm cinsiyetler istatistiklerle birlikte gender_view'da görünür.

Alanlar
resource_name

string

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

customers/{customer_id}/genderViews/{ad_group_id}~{criterion_id}

GeoTargetConstant

Coğrafi hedef sabiti.

Alanlar
resource_name

string

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

geoTargetConstants/{geo_target_constant_id}

status

GeoTargetConstantStatus

Coğrafi hedef sabit durumu.

id

int64

Coğrafi hedef sabitinin kimliği.

name

string

Coğrafi hedef sabitinin İngilizce adı.

country_code

string

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

target_type

string

Coğrafi hedef sabit hedef türü.

canonical_name

string

Hedefin, üst öğesinin ve ülkesinin adından oluşan tam nitelikli İngilizce ad.

parent_geo_target

string

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

geoTargetConstants/{parent_geo_target_constant_id}

KeywordView

Anahtar kelime görünümü.

Alanlar
resource_name

string

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

customers/{customer_id}/keywordViews/{ad_group_id}~{criterion_id}

Şirket

Etiket.

Alanlar
resource_name

string

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

status

LabelStatus

Etiketin durumu. Salt okunur.

text_label

TextLabel

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

id

int64

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 dize, 1 ile 80 arasında (1 ve 80 dahil) olmalıdır.

LanguageConstant

Bir dil.

Alanlar
resource_name

string

Dil sabitinin kaynak adı. Dil sabit kaynak adları şu biçimdedir:

languageConstants/{criterion_id}

id

int64

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

bool

Dilin hedeflenip hedeflenemeyeceği.

ListingGroupFilterDimension

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

Alanlar
Birleştirme alanı dimension. Aşağıdaki türlerden birinin boyutu her zaman mevcuttur. dimension yalnızca aşağıdakilerden biri olabilir:
product_bidding_category

ProductBiddingCategory

Ürün teklifinin teklif kategorisi.

product_brand

ProductBrand

Ürün teklifinin markası.

product_channel

ProductChannel

Ürün teklifinin bulunduğu konum.

product_condition

ProductCondition

Ürün teklifinin durumu.

product_custom_attribute

ProductCustomAttribute

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

product_item_id

ProductItemId

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

product_type

ProductType

Ürün teklifinin türü.

ProductBiddingCategory

Belirli bir seviyedeki teklif kategorisinin bir öğ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.

Alanlar
level

ListingGroupFilterBiddingCategoryLevel

Sınıflandırmadaki kategorinin seviyesini belirtir.

id

int64

Ürün teklifi kategorisinin kimliği.

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

ProductBrand

Ürünün markası.

Alanlar
value

string

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

ProductChannel

Ürün teklifinin bulunduğu yer.

Alanlar
channel

ListingGroupFilterProductChannel

Yerin değeri.

ProductCondition

Bir ürün teklifinin durumudur.

Alanlar
condition

ListingGroupFilterProductCondition

Koşulun değeri.

ProductCustomAttribute

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

Alanlar
index

ListingGroupFilterCustomAttributeIndex

Özel özelliğin dizin numarasını belirtir.

value

string

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

ProductItemId

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

Alanlar
value

string

Kimliğin değeri.

ProductType

Ürün teklifinin türü.

Alanlar
level

ListingGroupFilterProductTypeLevel

Türün düzeyi.

value

string

Türün değeri.

ListingGroupFilterDimensionPath

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

Alanlar
dimensions[]

ListingGroupFilterDimension

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

LocationView

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

Alanlar
resource_name

string

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

customers/{customer_id}/locationViews/{campaign_id}~{criterion_id}

ProductBiddingCategoryConstant

Ürün Teklif Verme Kategorisi.

Alanlar
resource_name

string

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

productBiddingCategoryConstants/{country_code}~{level}~{id}

level

ProductBiddingCategoryLevel

Ürün teklifi kategorisinin seviyesi.

status

ProductBiddingCategoryStatus

Ürün teklifi kategorisinin durumu.

id

int64

Ürün teklifi kategorisinin kimliği.

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

country_code

string

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

product_bidding_category_constant_parent

string

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

language_code

string

Ürün teklifi kategorisinin dil kodu.

localized_name

string

language_code parametresine göre yerelleştirilmiş ürün teklifi kategorisinin değerini görüntüler.

ProductGroupView

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

Alanlar
resource_name

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/{customer_id}/productGroupViews/{ad_group_id}~{criterion_id}

SearchAds360Field

SearchAds360Service tarafından kullanılan bir alan veya kaynak (öğe).

Alanlar
resource_name

string

Yapının kaynak adı. Yapı kaynağı adlarının biçimi şu şekildedir:

SearchAds360Fields/{name}

category

SearchAds360FieldCategory

Öğenin kategorisi.

selectable_with[]

string

Açıklanan yapıyla seçilebilir olan tüm kaynakların, segmentlerin ve metriklerin adları.

attribute_resources[]

string

Açıklanan yapıyla seçilebilir olan tüm kaynakların adları. Bu kaynaklardaki alanlar, arama sorgularına dahil edildiğinde metrikleri segmentlere ayırmaz.

Bu alan yalnızca kategorisi RESOURCE olan yapı taşları için ayarlanır.

metrics[]

string

Bu alan, FROM yan tümcesinde kullanıldığında açıklanan yapıyla seçilebilir olan tüm metriklerin adlarını listeler. Yalnızca kategorisi RESOURCE olan yapı taşları için ayarlanır.

segments[]

string

Bu alanda, arama sorgularına dahil edildiğinde ve açıklanan yapı FROM yan tümcesinde kullanıldığında segment metriklerine karşılık gelen tüm yapıların adları listelenir (segment veya başka bir kaynak). Yalnızca kategorisi RESOURCE olan yapı taşları için ayarlanır.

enum_values[]

string

Yapının ENUM türünde bir alan olması halinde kabul edebileceği değerler.

Bu alan yalnızca SEGMENT veya ÖZELLİK kategorisindeki yapı taşları için ayarlanır.

data_type

SearchAds360FieldDataType

Bu alan, WHERE yan tümcelerindeki yapıyla kullanılabilecek operatörleri belirler.

name

string

Yapının adı.

selectable

bool

Artefakın, arama sorgularındaki SELECT yan tümcesinde kullanılıp kullanılamayacağını belirtir.

filterable

bool

Artefakın, arama sorgularındaki WHERE yan tümcesinde kullanılıp kullanılamayacağını belirtir.

sortable

bool

Artefağın, arama sorgularındaki ORDER BY yan tümcesinde kullanılıp kullanılamayacağını belirtir.

type_url

string

Yapının veri türünü açıklayan protonun URL'si.

is_repeated

bool

Alan yapısını tekrarlayıp tekrarlamadığını belirtir.

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.

Alanlar
resource_name

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/{customer_id}/shoppingPerformanceView

UserList

Kullanıcı listesi. Bu, bir müşterinin hedefleyebileceği kullanıcıların listesidir.

Alanlar
resource_name

string

Kullanıcı listesinin kaynak adı. Kullanıcı listesi kaynak adları şu biçimdedir:

customers/{customer_id}/userLists/{user_list_id}

type

UserListType

Bu listenin türü.

Bu alan salt okunur.

id

int64

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)

Ziyaret edin

Ziyaret.

Alanlar
resource_name

string

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

customers/{customer_id}/visits/{ad_group_id}~{criterion_id}~{ds_visit_id}

id

int64

Ziyaretin kimliği.

criterion_id

int64

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

merchant_id

int64

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

ad_id

int64

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

click_id

string

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

visit_date_time

string

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

product_id

string

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

product_channel

ProductChannel

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

product_language_code

string

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

product_store_id

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.

product_country_code

string

Tıklanan ürünü içeren envanter feed'i için kayıtlı ülke (ISO-3166 biçimi).

asset_id

int64

Ziyaret etkinliği sırasında etkileşimde bulunulan öğenin kimliği.

asset_field_type

AssetFieldType

Ziyaret etkinliğinin öğe alanı türü.

WebpageView

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

Alanlar
resource_name

string

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

customers/{customer_id}/webpageViews/{ad_group_id}~{criterion_id}