Package google.ads.searchads360.v0.resources

Dizin

AccessibleBiddingStrategy

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

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

Alanlar
resource_name

string

Erişilebilir 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 açıklayıcı adı.

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

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

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 bir otomatik teklif stratejisidir.

maximize_conversions

MaximizeConversions

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

target_cpa

TargetCpa

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

target_impression_share

TargetImpressionShare

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

target_roas

TargetRoas

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

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 bir otomatik teklif stratejisidir.

Alanlar
target_roas

double

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

MaximizeConversions

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

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) olabildiğince çok dönüşüm elde etmenizi sağlamaya yardımcı olacak ş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

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

Alanlar
location

TargetImpressionShareLocation

Arama sonuçları sayfasındaki hedeflenen konum.

location_fraction_micros

int64

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

cpc_bid_ceiling_micros

int64

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

TargetRoas

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

Alanlar
target_roas

double

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

TargetSpend

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

Alanlar
target_spend_micros
(deprecated)

int64

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

cpc_bid_ceiling_micros

int64

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.

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 sonraki olası nihai URL'lerin listesi.

final_app_urls[]

FinalAppUrl

Kullanıcının belirli bir uygulaması yüklüyse mobil cihazlarda kullanılacak nihai uygulama URL'lerinin listesi.

final_mobile_urls[]

string

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

type

AdType

Reklamın türü.

id

int64

Reklamın kimliği.

tracking_url_template

string

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

final_url_suffix

string

Nihai URL oluştururken kullanılacak sonek.

display_url

string

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

name

string

Reklamın adı. Bu yalnızca reklamı tanımlamak için kullanılır. Benzersiz olması gerekmez ve yayınlanan reklamı etkilemez.

ad_data birleşik alanı. Reklam türüyle ilgili ayrıntılar. Tam olarak bir değer ayarlanmalıdır. ad_data aşağıdakilerden yalnızca 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 biçimdedir:

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

targeting_setting

TargetingSetting

Hedeflemeyle ilgili özelliklerin ayarı.

labels[]

string

Bu reklam grubuna eklenen etiketlerin kaynak adları.

effective_labels[]

string

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

engine_id

string

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

start_date

string

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

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

end_date

string

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

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

language_code

string

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

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şturulurken boş bırakılmamalıdır.

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

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

tracking_url_template

string

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

cpc_bid_micros

int64

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

engine_status

AdGroupEngineStatus

Reklam grubunun motor durumu.

final_url_suffix

string

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

AdGroupAd

Reklam grubu reklamı.

Alanlar
resource_name

string

Reklamın kaynak adı. Reklam grubu reklamı kaynak 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 eklenen etiketlerin kaynak adları.

effective_labels[]

string

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

engine_id

string

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

engine_status

AdGroupAdEngineStatus

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

last_modified_time

string

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

AdGroupAdEffectiveLabel

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

Alanlar
resource_name

string

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

ad_group_ad

string

Etkili etiketinin eklendiği reklam grubu reklamı.

label

string

Reklam grubu reklamına atanan etkin etiket.

owner_customer_id

int64

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

AdGroupAdLabel

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

Alanlar
resource_name

string

Reklam grubu reklam etiketinin kaynak adı. Reklam grubu reklam etiketi kaynak adları şu biçimdedir: customers/{owner_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

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

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ğlandığı reklam grubu.

asset

string

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

status

AssetLinkStatus

Reklam grubu öğesinin durumu.

AdGroupAssetSet

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

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ğlandığı 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ı için ilgi alanları ve yeniden pazarlama listelerinden elde edilen performans verilerinin yanı sıra kitle düzeyinde toplanan arama ağı reklamlarına yönelik yeniden pazarlama listelerini (ARYPL) içerir.

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ştiricisini temsil eder.

Alanlar
resource_name

string

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

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

bid_modifier

double

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

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

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

device

DeviceInfo

Bir cihaz ölçütü.

AdGroupCriterion

Reklam grubu ölçütü. ad_group_criterion raporu yalnızca reklam grubuna açıkça 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 biçimdedir:

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

quality_info

QualityInfo

Ölçütün kalitesiyle ilgili bilgiler.

type

CriterionType

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

labels[]

string

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

effective_labels[]

string

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

position_estimates

PositionEstimates

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

final_urls[]

string

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

final_mobile_urls[]

string

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

url_custom_parameters[]

CustomParameter

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

engine_id

string

Harici arama motoru hesabındaki reklam grubu ölçütünün kimliği. Bu alan yalnızca Google Ads dışındaki hesaplar (ör. Yahoo Japan, Microsoft, Baidu vb.) içindir. Google Ads öğesi için bunun yerine "ad_group_criterion.criterion_id" 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ği veya hariç tutulup (true) tutulmayacağı.

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

bid_modifier

double

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

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ünün motor durumu.

final_url_suffix

string

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

tracking_url_template

string

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

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

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

keyword

KeywordInfo

Anahtar kelime.

listing_group

ListingGroupInfo

Listeleme 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 teklifleriyle ilgili tahminler.

Alanlar
top_of_page_cpc_micros

int64

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

QualityInfo

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

Alanlar
quality_score

int32

Kalite puanı.

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

AdGroupCriterionEffectiveLabel

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

Alanlar
resource_name

string

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

ad_group_criterion

string

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

label

string

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

owner_customer_id

int64

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

AdGroupCriterionLabel

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

Alanlar
resource_name

string

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

AdGroupEffectiveLabel

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

Alanlar
resource_name

string

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

ad_group

string

Etkili etiketinin eklendiği reklam grubu.

label

string

Reklam grubuna atanan etkin etiket.

owner_customer_id

int64

Etkin etiketin sahibi olan müşterinin 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/{owner_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ş aralığı 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

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

Alanlar
resource_name

string

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

customers/{customer_id}/assets/{asset_id}

type

AssetType

Öğenin türü.

final_urls[]

string

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

final_mobile_urls[]

string

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

url_custom_parameters[]

CustomParameter

tracking_url_template, final_urls ve/veya final_mobile_urls'deki URL özel parametre etiketlerinin yerine kullanılacak eşlemelerin listesi.

status

AssetStatus

Öğenin durumu.

creation_time

string

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

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 kullanılan URL şablonu.

final_url_suffix

string

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

engine_status

AssetEngineStatus

Bir öğenin motor durumu.

asset_data birleşik alanı. Öğenin türü. asset_data aşağıdakilerden yalnızca 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ş bir sayfa feed'i öğesi.

mobile_app_asset

MobileAppAsset

Mobil uygulama öğesi

call_asset

UnifiedCallAsset

Birleştirilmiş 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 öğ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şkilendirildiği kampanya. Öğe grubuna bağlı öğe.

name

string

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

final_urls[]

string

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

final_mobile_urls[]

string

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

status

AssetGroupStatus

Öğe grubunun durumu.

path1

string

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

path2

string

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

ad_strength

AdStrength

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

AssetGroupAsset

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

Alanlar
resource_name

string

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

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

asset_group

string

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

asset

string

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

field_type

AssetFieldType

Öğenin öğe grubu içindeki 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

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

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

asset_group

string

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

id

int64

ListingGroupFilter'ın kimliği.

type

ListingGroupFilterType

Listeleme grubu filtre 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 daralttığı boyut değeri. Kök grup için tanımlanmamış.

parent_listing_group_filter

string

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

path

ListingGroupFilterDimensionPath

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

AssetGroupSignal

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

Alanlar
resource_name

string

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

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

asset_group

string

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

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

AudienceInfo

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

AssetGroupTopCombinationView

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

Alanlar
resource_name

string

Öğe grubu üst kombinasyon görünümünün kaynak adı. Öğe grubu üst 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 öğeyi öğe grubuyla ilişkilendirir.

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ğlandığı öğe grubu.

asset

string

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

status

AssetSetAssetStatus

Feed öğesinin durumu. Salt okunur.

Kitle

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

Alanlar
resource_name

string

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

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. En az 1, en fazla 255 karakter uzunluğunda olmalıdır.

description

string

Bu kitlenin açıklaması.

BiddingStrategy

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

type

BiddingStrategyType

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

Bu alan salt okunurdur.

currency_code

string

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

Yönetici müşterilerdeki teklif stratejileri için bu para birimi oluşturma sırasında ayarlanabilir ve varsayılan olarak yönetici müşterinin para birimi kullanılır. Yayın yapan müşteriler için bu alan ayarlanamaz. Yayın yapan müşterideki tüm stratejiler, yayın yapan müşterinin para birimini kullanır. Her durumda effective_currency_code alanı, 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 (bu değerler dahil) olmalıdır (kırpılmış).

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, strateji oluşturulurken reklamveren tarafından belirlenen para birimidir. Müşterilere hizmet sunmak için bu, müşterinin currency_code'udur.

Teklif stratejisi metrikleri bu para biriminde raporlanır.

Bu alan salt okunurdur.

campaign_count

int64

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

Bu alan salt okunurdur.

non_removed_campaign_count

int64

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

Bu alan salt okunurdur.

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

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

enhanced_cpc

EnhancedCpc

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

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 bir otomatik teklif stratejisidir.

maximize_conversions

MaximizeConversions

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

target_cpa

TargetCpa

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

target_impression_share

TargetImpressionShare

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

target_outrank_share

TargetOutrankShare

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

target_roas

TargetRoas

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

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

Kampanya.

Alanlar
resource_name

string

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

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ın hedefi. Hedefleme seçenekleri network_settings bölümünde hassaslaştırılabilir.

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

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

advertising_channel_sub_type

AdvertisingChannelSubType

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

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

url_custom_parameters[]

CustomParameter

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

real_time_bidding_setting

RealTimeBiddingSetting

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

network_settings

NetworkSettings

Kampanyanın ağ ayarları.

dynamic_search_ads_setting

DynamicSearchAdsSetting

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

shopping_setting

ShoppingSetting

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

geo_target_type_setting

GeoTargetTypeSetting

Reklam coğrafi hedefleme ayarı.

effective_labels[]

string

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

labels[]

string

Bu kampanyaya eklenen etiketlerin kaynak adları.

bidding_strategy_type

BiddingStrategyType

Teklif stratejisinin türü.

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

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 kampanya için optimizasyon hedefi ayarı (bir dizi optimizasyon hedefi türü içerir).

tracking_setting

TrackingSetting

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

engine_id

string

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

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ı gösteren zaman damgası. Zaman damgası, müşterinin saat diliminde ve "yyyy-AA-gg SS:dd:ss " biçimindedir. create_time, v1'de kullanımdan kaldırılacaktır. Bunun yerine creation_time özelliğini kullanın.

creation_time

string

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

last_modified_time

string

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

feed_types[]

AssetSetType

Doğrudan bu kampanyaya eklenen feed türleri.

id

int64

Kampanyanın kimliği.

name

string

Kampanyanın adı.

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

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

tracking_url_template

string

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

campaign_budget

string

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

start_date

string

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

end_date

string

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

final_url_suffix

string

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

url_expansion_opt_out

bool

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

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

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

bidding_strategy

string

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

manual_cpa

ManualCpa

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

manual_cpc

ManualCpc

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

manual_cpm

ManualCpm

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

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çenizi harcarken geliri en üst düzeye çıkarmak için teklifleri otomatik olarak belirleyen standart dönüşüm değerini artırma teklif stratejisi.

target_cpa

TargetCpa

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

target_impression_share

TargetImpressionShare

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

target_roas

TargetRoas

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

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 bir hedef harcama teklif stratejisidir.

percent_cpc

PercentCpc

Tekliflerin, bazı ürün veya hizmetlerin reklamı yapılan fiyatının bir kısmı olduğu standart TBM yüzdesi 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 etmeye yönelik 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 adının dilini belirten dil kodu (ör. "en").

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ğı (target_google_search seçeneğinin de true olması gerekir).

target_content_network

bool

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

target_partner_search_network

bool

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

OptimizationGoalSetting

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

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 kampanyayı optimize etmek için dönüşüm işlemleriyle ilgili seçilen kaynak adı grubu.

ShoppingSetting

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

Alanlar
feed_label

string

Kampanyaya dahil edilecek ürünlerin feed etiketi. Yalnızca feed_label veya sales_country özelliklerinden biri ayarlanabilir. sales_country yerine kullanıldığında 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ç listeleme 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ı için değiştirilemez.

sales_country

string

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

campaign_priority

int32

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

enable_local

bool

Yerel ürünlerin dahil edilip edilmeyeceği.

TrackingSetting

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

Alanlar
tracking_url

string

Dinamik izleme için kullanılan URL.

CampaignAsset

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

Alanlar
resource_name

string

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

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 bir öğe grubu arasındaki bağlantıdır. CampaignAssetSet eklemek, bir öğe grubunu 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 öğe grubu öğesinin durumu. Salt okunur.

CampaignAudienceView

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

Alanlar
resource_name

string

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

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 değerine ayarlanır.

period

BudgetPeriod

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

amount_micros

int64

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

CampaignCriterion

Kampanya ölçütü.

Alanlar
resource_name

string

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

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

display_name

string

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

Bu alan, mutasyonlar 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, değiştirme 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-10,0 aralığında olmalıdır. Hedeflenebilir ölçüt türlerinin çoğu değiştiricileri destekler. Bir cihaz türünü devre dışı bırakmak için 0'ı kullanın.

negative

bool

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

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

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

keyword

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 gösterir. Etkili bir etiket, bu kampanyaya devralınan veya doğrudan atanmış bir etikettir.

Alanlar
resource_name

string

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

campaign

string

Etkili etiketin eklendiği kampanya.

label

string

Kampanyaya atanan etkin etiket.

owner_customer_id

int64

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

CampaignLabel

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

Alanlar
resource_name

string

Kaynağın adı. Kampanya etiketi kaynak adları şu biçime sahiptir: customers/{owner_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üşterinin kimliği.

CartDataSalesView

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

Alanlar
resource_name

string

Alışveriş sepeti verileri satış görünümünün kaynak adı. Alışveriş sepeti verileri satış görünümü kaynak adları şu biçimdedir: customers/{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 biçimdedir:

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şkilendirilmediğini gösterir.

merchant_id

int64

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

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 benzersiz bir dize. Tıklama kimliği URL parametresi olarak açılış sayfasına iletilir.

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. Reklamverenlerin bu tür bir kimlik belirtmediği durumlarda Search Ads 360 bir kimlik oluşturur. Online dönüşümlerde bu değer, reklamverenin Floodlight talimatlarına bağlı olarak 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

Tıklanan yerel envanter reklamındaki 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çimi).

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 anın 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 öğe miktarı (qty URL parametresiyle belirlenir). Reklamveren, parametreyi (ör. dönüşümde satılan öğe sayısı) dinamik olarak doldurmaktan sorumludur. Aksi takdirde, varsayılan olarak 1 değeri kullanılır.

conversion_revenue_micros

int64

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

floodlight_original_revenue

int64

Floodlight para birimi talimatı değişikliklerinden önce, Floodlight etkinliğiyle ilişkili orijinal ve değişmemiş gelir (mevcut raporun para biriminde).

floodlight_order_id

string

Reklamverenin dönüşüm için sağladığı Floodlight sipariş kimliği.

status

ConversionStatus

Dönüşümün durumu (ENABLED veya REMOVED).

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

customers/{customer_id}/conversionActions/{conversion_action_id}

creation_time

string

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

status

ConversionActionStatus

Dönüşüm etkinliği birikimi 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 bildirilen dönüşümlerin 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şturulurken boş bırakılmamalıdır.

primary_for_goal

bool

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

owner_customer

string

Dönüşüm işlemi sahibinin müşteri kaynak adı veya sistem tarafından tanımlanmış 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ği.

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

Uygulama dönüşümü işlemi için 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üşümler raporlanırken bir Floodlight etkinlik grubunu tanımlamak için kullanılan dize.

activity_tag

string

Dönüşümler raporlanırken 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şlemi için dönüşüm etkinlikleri geçersiz, izin verilmeyen veya eksik bir değerle gönderildiğinde ya da bu dönüşüm işlemi her zaman varsayılan değeri kullanacak şekilde yapılandırıldığında kullanılacak değer.

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şlemi için dönüşüm etkinliklerinde belirtilen değer ve para birimi kodu yerine varsayılan değerin ve varsayılan para birimi kodunun kullanılıp kullanılmayacağını kontrol eder.

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.

Alanlar
resource_name

string

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

customers/{customer_id}/conversionCustomVariables/{conversion_custom_variable_id}

id

int64

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

name

string

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

tag

string

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

status

ConversionCustomVariableStatus

Dönüşüm etkinliği birikimi 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 özel değişkenini kullanan özel sütunların kimlikleri.

FloodlightConversionCustomVariableInfo

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

Alanlar
floodlight_variable_type

FloodlightVariableType

Search Ads 360'ta tanımlanan Floodlight değişken 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 izleme ile ilgili, müşteri genelinde bir ayar 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 okunurdur. 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 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 belirtir). Bu alan salt okunurdur.

google_ads_cross_account_conversion_tracking_id

int64

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

cross_account_conversion_tracking_id

int64

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

CustomColumn

Özel sütun. Search Ads 360 özel sütununu https://support.google.com/sa360/answer/9633916 adresinde bulabilirsiniz.

Alanlar
resource_name

string

Özel sütunun kaynak adı. Özel sütun kaynak adları şu biçimdedir:

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 referans veriyorsa doğru.

references_metrics

bool

Özel sütun bir veya daha fazla metriği ifade ettiğinde doğru olur.

queryable

bool

Özel sütun, SearchAds360Service.Search ve SearchAds360Service.SearchStream sorgusunda kullanılabilir olduğunda doğru olur.

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ı" adlı özel sütun, {"metrics.clicks", "metrics.impressions"} sistem sütunlarına referans veriyor.

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

customers/{customer_id}

conversion_tracking_setting

ConversionTrackingSetting

Bir müşteri için 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üşterisi için DoubleClick Campaign Manager (DCM) ayarı.

account_status

AccountStatus

Hesap durumu (ör. Etkin, Duraklatıldı, Kaldırıldı 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ı gösteren zaman damgası. Zaman damgası, müşterinin saat diliminde ve "yyyy-AA-gg SS:dd:ss" biçimindedir.

manager_id

int64

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

manager_descriptive_name

string

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

sub_manager_id

int64

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

sub_manager_descriptive_name

string

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

associate_manager_id

int64

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

associate_manager_descriptive_name

string

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

account_level

AccountLevelType

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

id

int64

Müşterinin kimliği.

descriptive_name

string

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

currency_code

string

Hesabın işlem yaptığı 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

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

auto_tagging_enabled

bool

Otomatik etiketlemenin müşteri için 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çime sahiptir:

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

asset

string

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

status

AssetLinkStatus

Müşteri öğesinin durumu.

CustomerAssetSet

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

Alanlar
resource_name

string

Müşteri öğesi 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 öğesi grubu öğesinin durumu. Salt okunur.

CustomerClient

Belirtilen müşteri ile bir müşteri müşterisi arasındaki bağlantı. CustomerClients yalnızca yönetici müşteriler için vardır. Doğrudan ve dolaylı tüm müşteri müşterileri ile yöneticinin kendisi dahildir.

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

İstemde bulunan müşteriye ait olan ve istemci müşteriye uygulanan etiketlerin kaynak adları. Etiket kaynak adları şu biçime sahiptir:

customers/{customer_id}/labels/{label_id}

status

CustomerStatus

Müşteri müşterinin durumu. Salt okunur.

client_customer

string

Belirli bir müşteriye bağlı olan istemci müşterisinin kaynak adı. Salt okunur.

hidden

bool

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

Salt okunur.

level

int64

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

time_zone

string

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

test_account

bool

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

manager

bool

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

descriptive_name

string

Müşteri için açıklayıcı ad. Salt okunur.

currency_code

string

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

id

int64

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

DoubleClickCampaignManagerSetting

Bir yönetici müşterisi 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

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

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ğı reklamları arama terimi görünümü kaynak adları şu biçimdedir:

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, etkili yayın durumunu yansıtır. Cinsiyet ölçütleri olmayan bir reklam grubu varsayılan olarak tüm cinsiyetlere gösterilir. Bu nedenle, cinsiyet_görünümünde tüm cinsiyetler istatistiklerle birlikte görünür.

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 sabiti için kaynak adı. Coğrafi hedef sabit kaynak adları şu biçimdedir:

geoTargetConstants/{geo_target_constant_id}

status

GeoTargetConstantStatus

Coğrafi hedef sabiti durumu.

id

int64

Coğrafi hedef sabiti kimliği.

name

string

Coğrafi hedef sabiti İngilizce adı.

country_code

string

Hedefle ilişkilendirilmiş ISO-3166-1 alfa-2 ülke kodu.

target_type

string

Coğrafi hedef sabit hedef türü.

canonical_name

string

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

parent_geo_target

string

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

geoTargetConstants/{parent_geo_target_constant_id}

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çime sahiptir:

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

Şirket

Bir etiket.

Alanlar
resource_name

string

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

status

LabelStatus

Etiketin durumu. Salt okunur.

text_label

TextLabel

Renkli bir arka plan üzerinde 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şturulurken boş bırakılmamalıdır.

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

LanguageConstant

Bir dil.

Alanlar
resource_name

string

Dil sabiti için kaynak adı. Dil sabitinin kaynak adları şu biçimdedir:

languageConstants/{criterion_id}

id

int64

Dil sabitinin kimliği.

code

string

Dil kodu (örneğin, "en_US", "en_AU", "es", "fr" vb.)

name

string

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

targetable

bool

Dilin hedeflenebilir olup olmadığı.

ListingGroupFilterDimension

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

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

ProductBiddingCategory

Ürün teklifinin teklif kategorisi.

product_brand

ProductBrand

Ürün teklifinin markası.

product_channel

ProductChannel

Ürün teklifinin yerelliği.

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

Alanlar
level

ListingGroupFilterBiddingCategoryLevel

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

id

int64

Ürün teklifi kategorisinin kimliği.

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

ProductBrand

Ürünün markası.

Alanlar
value

string

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

ProductChannel

Ürün teklifinin yerelliği.

Alanlar
channel

ListingGroupFilterProductChannel

Yerleşim biriminin değeri.

ProductCondition

Ürün teklifinin durumu.

Alanlar
condition

ListingGroupFilterProductCondition

Koşulun değeri.

ProductCustomAttribute

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

Alanlar
index

ListingGroupFilterCustomAttributeIndex

Özel özelliğin dizinini gösterir.

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

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

Alanlar
dimensions[]

ListingGroupFilterDimension

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

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çime sahiptir:

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

ProductBiddingCategoryConstant

Ürün teklifi kategorisi.

Alanlar
resource_name

string

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

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

level

ProductBiddingCategoryLevel

Ürün teklif kategorisinin düzeyi.

status

ProductBiddingCategoryStatus

Ürün teklif kategorisinin durumu.

id

int64

Ürün teklifi kategorisinin kimliği.

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

country_code

string

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

product_bidding_category_constant_parent

string

Ana ürün teklif kategorisinin kaynak adı.

language_code

string

Ürün teklif kategorisinin dil kodu.

localized_name

string

Ürün teklifi kategorisinin, language_code'a göre yerelleştirilmiş değerini gösterir.

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 (yapı).

Alanlar
resource_name

string

Yapının kaynak adı. Yapılandırma kaynağı adları şu biçimdedir:

SearchAds360Fields/{name}

category

SearchAds360FieldCategory

Yapay nesnenin kategorisi.

selectable_with[]

string

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

attribute_resources[]

string

Açıklanan yapıyla seçilebilen tüm kaynakların adları. Bu kaynaklardaki alanlar, arama sorgularına dahil edildiklerinde metrikleri segmentlere ayırmaz.

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

metrics[]

string

Bu alanda, FROM ifadesinde kullanıldığında açıklanan yapıyla seçilebilen tüm metriklerin adları listelenir. Yalnızca kategorisi RESOURCE olan yapay nesneler için ayarlanır.

segments[]

string

Bu alanda, arama sorgularına dahil edildiğinde segment metrikleri oluşturan ve açıklanan yapının FROM ifadesinde kullanıldığı tüm yapıların (segment veya başka bir kaynak) adları listelenir. Yalnızca kategorisi RESOURCE olan yapay nesneler için ayarlanır.

enum_values[]

string

Öğenin, ENUM türünde bir alan olması durumunda kabul edebileceği değerler.

Bu alan yalnızca SEGMENT veya ATTRIBUTE kategorisindeki yapılar için ayarlanır.

data_type

SearchAds360FieldDataType

Bu alan, WHERE ifadelerinde yapıyla birlikte kullanılabilecek operatörleri belirler.

name

string

Yapıtın adı.

selectable

bool

Yapının, arama sorgularında SELECT ifadesinde kullanılıp kullanılamayacağı.

filterable

bool

Yapının, arama sorgularında WHERE ifadesinde kullanılıp kullanılamayacağı.

sortable

bool

Yapının, arama sorgularında ORDER BY ifadesinde kullanılıp kullanılamayacağı.

type_url

string

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

is_repeated

bool

Alan yapay nesnesinin tekrarlanıp tekrarlanmadığı.

ShoppingPerformanceView

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

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çime sahiptir: 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çime sahiptir:

customers/{customer_id}/userLists/{user_list_id}

type

UserListType

Bu listenin türü.

Bu alan salt okunurdur.

id

int64

Kullanıcı listesinin kimliği.

name

string

Bu kullanıcı listesinin adı. Erişim nedenine bağlı olarak kullanıcı listesi adı benzersiz olmayabilir (örneğin, access_reason=SHARED ise).

UserLocationView

Kullanıcı konumu görünümü.

Kullanıcı Konumu Görünümü, ülke düzeyinde toplanan tüm metrikleri içerir ve her ülke için bir satır gösterilir. Hedeflenen veya hedeflenmeyen konuma göre kullanıcının gerçek fiziksel konumundaki metrikleri bildirir. Diğer segment alanları kullanılıyorsa ülke başına birden fazla satır elde edebilirsiniz.

Alanlar
resource_name

string

Kullanıcı konumu görünümünün kaynak adı. UserLocation görünümü kaynak adları şu biçimdedir:

customers/{customer_id}/userLocationViews/{country_criterion_id}~{targeting_location}

country_criterion_id

int64

Ülkenin ölçüt kimliği.

targeting_location

bool

Konumun hedeflenip hedeflenmediğini belirtir.

Ziyaret edin

Ziyaret

Alanlar
resource_name

string

Ziyaretin kaynak adı. Ziyaret kaynağı 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 kimlik, Search Ads 360'ta bir envanter hesabı bağladığınızda Search Ads 360 tarafından oluşturulur.

ad_id

int64

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

click_id

string

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

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

Tıklanan yerel envanter reklamındaki 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ç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üntüleme

Alanlar
resource_name

string

Web sayfası görünümünün kaynak adı. Web sayfası görüntüleme kaynağı adları şu biçime sahiptir:

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