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 Biddingstrateji özelliklerinin yalnızca sınırlı bir alt kümesini gösterir.

Alanlar
resource_name

string

Erişilebilir teklif stratejisinin kaynak adı. ErişilebilirTeklif Stratejisi 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

tanımlayıcısını kullanın.

Birleştirme alanı scheme. Teklif ş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ı olacak bir otomatik teklif stratejisi.

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 maliyetle (EBM) mümkün olduğunca fazla dönüşüm elde etmenize 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_roas

TargetRoas

Belirli bir hedef reklam harcamalarından elde edilen gelir (ROAS) elde ederken gelirinizi en üst düzeye çıkarmanıza yardımcı olan bir teklif stratejisidir.

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ı olacak bir otomatik teklif stratejisi.

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 ayarlanmazsa teklif stratejisi, bütçe için mümkün olan en yüksek ROAS'a ulaşmayı hedefler.

MaximizeConversions

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

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 etmenize yardımcı olacak şekilde ayarlayan otomatik teklif stratejisidir.

Alanlar
target_cpa_micros

int64

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

TargetImpressionShare

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

Alanlar
location

TargetImpressionShareLocation

Arama sonuçları sayfasında hedeflenen konum.

location_fraction_micros

int64

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

cpc_bid_ceiling_micros

int64

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

TargetRoas

Belirli bir hedef ROAS (reklam harcamalarından elde edilen gelir) ortalaması alarak gelirinizi en üst düzeye çıkarmanıza yardımcı olan bir otomatik teklif stratejisidir.

Alanlar
target_roas

double

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

TargetSpend

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

Alanlar
target_spend_micros
(deprecated)

int64

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

cpc_bid_ceiling_micros

int64

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

Bir reklam.

Alanlar
resource_name

string

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

customers/{customer_id}/ads/{ad_id}

final_urls[]

string

Reklama ait tüm alanlar arası yönlendirmelerden sonraki 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. Bu adın benzersiz olması gerekmez ve sunulan reklamı etkilemez. Ad alanı şu anda yalnızca DisplayUploadAd, ImageAd, ShoppingComparisonListingAd ve VideoAd için desteklenmektedir.

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

SearchAds360TextAdInfo

Bir 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

Bir ü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'un oluşturulduğu zaman damgası. Zaman damgası müşterinin saat diliminde ve "yyyy-AA-gg SS:dd:ss" şeklindedir. biçimindedir.

targeting_setting

TargetingSetting

İlgili özellikleri hedefleme ayarı.

labels[]

string

Bu reklam grubuna ekli etiketlerin kaynak adları.

engine_id

string

Harici motor hesabındaki reklam grubunun kimliği. Bu alan yalnızca Google Ads dışı hesaplar içindir (ör. Yahoo Japan, Microsoft, Baidu). Google Ads varlığı için "ad_group.id" 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ınını sona erdiği tarih. Reklam grubu, varsayılan olarak reklam grubunun bitiş tarihinde sona erer. Bu alan ayarlanırsa reklam grubu, müşterinin saat diliminde belirtilen tarihin sonunda sona erer. Bu alan yalnızca Microsoft Advertising ve Facebook ağ geçidi hesapları için kullanılabilir.

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

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ı için: https://docs.microsoft.com/en-us/advertising/guides/ad-languages?view=bingads-13#adlanguage

last_modified_time

string

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

id

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.

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

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

cpc_bid_micros

int64

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

engine_status

AdGroupEngineStatus

Reklam grubu için Motor Durumu.

AdGroupAd

Bir 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'in oluşturulduğu zaman damgası. Tarih ve saat, müşterinin saat dilimindedir ve "yyyy-AA-gg SS:dd:ss.ssssss" şeklindedir. biçimindedir.

labels[]

string

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

engine_id

string

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

engine_status

AdGroupAdEngineStatus

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

last_modified_time

string

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

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

AdGroupAsset

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

Alanlar
resource_name

string

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

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

Alanlar
resource_name

string

Reklam grubu öğesi grubunun kaynak adı. Reklam grubu öğesi 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 öğesi 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 şekilde toplanır.

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

Bir 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 teklifin değiştiricisi. Değiştirici 0,1 - 10,0 aralığında olmalıdır. PreferredContent için aralık 1,0 - 6,0 arasındadır. Bir cihaz türünü devre dışı bırakmak için 0 değerini kullanın.

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

V5'ten başlayan oluşturma işlemlerinde gereklidir. criterion şunlardan yalnızca biri olabilir:

device

DeviceInfo

Cihaz ölçütü.

AdGroupCriterion

Bir 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 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" şeklindedir. 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, kampanyalar hariç tutulmadığı sürece varsayılan olarak tüm yaş aralıklarındaki kullanıcılara gösterilir. Kullanıcı arayüzünde, reklamları görmeye uygun oldukları için her yaş grubu "etkin" olarak gösterilir; ancak hiçbir pozitif ölçüt eklenmediğinden AdGroupCriterion.status "kaldırıldı" durumunu gösterir.

quality_info

QualityInfo

Ölçütün kalitesiyle ilgili bilgiler.

type

CriterionType

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

labels[]

string

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

position_estimates

PositionEstimates

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

final_urls[]

string

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

engine_id

string

Harici motor hesabındaki reklam grubu ölçütünün kimliği. Bu alan yalnızca Google Ads dışı hesaplar (ör. Yahoo Japan, Microsoft, Baidu) içindir. Google Ads varlığı için "ad_group_ölçüt.ölçüt_id" özelliğini kullanın. .

last_modified_time

string

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

criterion_id

int64

Ölçütün kimliği.

ad_group

string

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

negative

bool

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

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

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

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

tracking_url_template

string

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

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

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

keyword

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 dair tahmin.

QualityInfo

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

Alanlar
quality_score

int32

Kalite puanı.

Google bir değer belirlemek için yeterli bilgiye sahip değilse 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 biçimdedir: 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.

AdGroupLabel

Reklam grubu ve 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.

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

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.

status

AssetStatus

Öğenin durumudur.

creation_time

string

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

last_modified_time

string

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

id

int64

Öğenin kimliği.

name

string

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

tracking_url_template

string

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

engine_status

AssetEngineStatus

Bir öğenin Motor Durumu.

Birleştirme alanı asset_data. Öğenin spesifik türü. asset_data şunlardan 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ş 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 bir öğe grubuyla ilişkilendirmek için kullanılır.

Alanlar
resource_name

string

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

customers/{customer_id}/assetGroups/{asset_group_id}

id

int64

Öğe grubunun kimliğidir.

campaign

string

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

name

string

Zorunlu. Öğe grubunun adı. Zorunlu. Açıklama uzunluğu en az 1, maksimum 128 olmalıdır. Bir kampanya altında benzersiz olmalıdır.

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şletme için uygundur.

final_mobile_urls[]

string

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

status

AssetGroupStatus

Öğe grubunun durumudur.

path1

string

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

path2

string

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

ad_strength

AdStrength

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

AssetGroupAsset

AssetGroupAsset, bir öğe ile öğe grubu arasındaki bağlantıdır. AssetGroupAsset eklediğinizde, bir öğeyi öğ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 filtre 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 dahil olduğu öğe grubu.

id

int64

ListingGroupFilter'in 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 sektör. 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ımlanmadı.

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 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 Ağı, Görüntülü Reklam Ağı, video ve diğer platformlar genelinde dönüşüm bulmak amacıyla benzer veya daha güçlü amaca sahip yeni kullanıcıları aramak için bu sinyali kullanır.

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 şunlardan yalnızca 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 üst 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

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

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

asset_set

string

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

asset

string

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

status

AssetSetAssetStatus

Öğe grubu öğesinin durumudur. 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 getirmenizi sağlayan etkili bir hedefleme seçeneğidir.

Alanlar
resource_name

string

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

customers/{customer_id}/audiences/{audience_id}

id

int64

Kitlenin kimliği.

name

string

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

description

string

Bu kitlenin açıklaması.

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

type

BiddingStrategyType

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

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

effective_currency_code

string

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

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

Teklif stratejisi metrikleri bu para biriminde raporlanır.

Bu alan salt okunurdur.

campaign_count

int64

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

Bu alan salt okunurdur.

non_removed_campaign_count

int64

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

Bu alan salt okunurdur.

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

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

enhanced_cpc

EnhancedCpc

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

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ı olacak bir otomatik teklif stratejisi.

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 maliyetle (EBM) mümkün olduğunca fazla dönüşüm elde etmenize 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 rakibi geçmesi gereken açık artırmaların hedef oranına göre teklifler ayarlayan bir teklif stratejisidir. Bu alan kullanımdan kaldırılmıştır. Bu alanla yeni bir teklif stratejisi oluşturmak veya bir kampanyaya bu alanla teklif stratejileri eklemek başarısız olur. Bu şemanın zaten doldurulduğu stratejilerde yapılan değişikliklere izin verilir.

target_roas

TargetRoas

Belirli bir hedef reklam harcamalarından elde edilen gelir (ROAS) elde ederken gelirinizi en üst düzeye çıkarmanıza yardımcı olan bir teklif stratejisidir.

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 optimizasyon durumu.

advertising_channel_type

AdvertisingChannelType

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

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

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

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çinde özel parametre etiketlerini değiştirmek 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

Reklam coğrafi hedefleme ayarı.

labels[]

string

Bu kampanyaya ekli etiketlerin kaynak adları.

bidding_strategy_type

BiddingStrategyType

Teklif stratejisinin türü.

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

Bu alan salt okunurdur.

accessible_bidding_strategy

string

"bid_strategy" ile tanımlanan ekli portföy teklifi stratejisinin kısıtlanmamış özelliklerinin salt okunur görünümü olan Accessible Biddingstrateji'nin kaynak adı. Kampanyada portföy stratejisi kullanılmıyorsa boştur. Kısıtlanmamış strateji özellikleri, stratejinin paylaşıldığı tüm müşteriler tarafından kullanılabilir ve Accessible Biddingstrateji kaynağından okunur. Öte yandan, kısıtlanmış özellikler yalnızca stratejinin sahibi olan müşteri ve onların yöneticileri tarafından kullanılabilir. Kısıtlanmış özellikler yalnızca BiddingStrateji kaynağından okunabilir.

frequency_caps[]

FrequencyCapEntry

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

selective_optimization

SelectiveOptimization

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

optimization_goal_setting

OptimizationGoalSetting

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

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 içindir (ör. Yahoo Japan, Microsoft, Baidu). Google Ads varlığı için "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 damgası. Zaman damgası müşterinin saat diliminde ve "yyyy-AA-gg SS:dd:ss" şeklindedir. biçimindedir. create_time, v1'de desteği sonlandırılacak. Bunun yerine create_time'ı 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" şeklindedir. biçimindedir.

last_modified_time

string

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

id

int64

Kampanyanın kimliği.

name

string

Kampanyanın adı.

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

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

tracking_url_template

string

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

campaign_budget

string

Kampanyanın bütçesi.

start_date

string

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

end_date

string

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

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 iyi hedeflenmiş URL'lere URL genişletmesinin devre dışı bırakılmasını temsil eder. Devre dışı bırakılırsa (doğru) yalnızca, öğe grubundaki nihai URL'ler veya reklamverenin Google Merchant Center ya da iş verileri feed'lerinde belirtilen URL'ler hedeflenir. Etkinleştirilirse (false) alanın tamamı hedeflenir. Bu alan yalnızca varsayılan değerin false (yanlış) olduğu Maksimum Performans kampanyaları için ayarlanabilir.

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

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

bidding_strategy

string

Kampanyada kullanılan portföy teklifi stratejisi.

manual_cpa

ManualCpa

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

manual_cpc

ManualCpc

Standart Manuel TBM teklif verme stratejisi. Kullanıcının tıklama başına ödeme yaptığı manuel tıklamaya dayalı 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çeniz harcanırken dönüşüm sayısını otomatik olarak artıran Standart dönüşümleri artırma teklif stratejisidir.

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

Standart Hedef EBM teklif stratejisi, belirlediğiniz hedef edinme başına maliyetle (EBM) mümkün olduğunca fazla dönüşüm elde etmenize yardımcı olmak için teklifleri otomatik olarak belirler.

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 hedef ROAS (reklam harcamalarından elde edilen gelir) ortalamasını alırken geliri otomatik olarak en üst düzeye çıkaran Standart Hedef ROAS teklif stratejisi.

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

percent_cpc

PercentCpc

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

target_cpm

TargetCpm

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

DynamicSearchAdsSetting

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

Alanlar
domain_name

string

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

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

Alanlar
conversion_actions[]

string

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

ShoppingSetting

Alışveriş kampanyaları ayarı. Kampanya tarafından reklamı yapılabilecek ürün evrenini ve bu kampanyanın diğer Alışveriş kampanyalarıyla nasıl etkileşime girdiğini tanımlar.

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ç girişi envanterinin hedeflenip hedeflenmeyeceğini belirler.

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

enable_local

bool

Yerel ürünlerin eklenip eklenmeyeceğini belirtir.

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

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 eklendiğinde bir öğe grubunu bir kampanyaya bağlar.

Alanlar
resource_name

string

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

CampaignAudienceView

Kampanya kitle görünümü. Kampanya ve kitle ölçütüne göre birleştirilmiş, Görüntülü Reklam Ağı ve YouTube Ağı reklamlarına yönelik yeniden pazarlama listelerinden ve Arama Ağı reklamlarına yönelik yeniden pazarlama listelerinden (ARYPL) elde edilen performans verilerini içerir. Bu görünüm yalnızca kampanya düzeyinde eklenmiş kitleleri içerir.

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

customers/{customer_id}/campaignBudgets/{campaign_budget_id}

delivery_method

BudgetDeliveryMethod

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

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

period

BudgetPeriod

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

amount_micros

int64

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

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

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

negative

bool

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

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

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

keyword

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

Konum Grubu

CampaignLabel

Bir kampanya ve etiket 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.

CartDataSalesView

Alışveriş sepeti verileri 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 ş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. 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şkilendirilmemiş olduğunu 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 reklamverenler tarafından sağlanan bir kimliktir. Reklamveren böyle bir kimlik belirtmezse Search Ads 360 bir kimlik oluşturur. Çevrimiçi dönüşümler için bu değer, reklamverenin Floodlight talimatlarına bağlı olarak kimlik sütununa veya floodlight_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ı: Çevrimiçi veya Yerel.

product_language_code

string

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

product_store_id

string

Yerel envanter reklamındaki tıklanan mağaza. Bu değer, yerel ürünler feed'inizde kullanılan mağaza kimlikleriyle eşleşmelidir.

product_country_code

string

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

attribution_type

AttributionType

Dönüşümün neyle ilişkilendirildiği: 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

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

conversion_revenue_micros

int64

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

floodlight_original_revenue

int64

Floodlight para birimi talimatı değişikliklerinden önce, Floodlight etkinliğiyle ilişkilendirilen orijinal, değişmemiş gelir (geçerli 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ği oluşturma işleminin ISO 8601'de biçimlendirilmiş zaman damgası.

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üşü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ş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 birincil_for_goal parametresini dikkate almaz. Bu nedenle, bir kampanyanın birincil_for_goal = yanlış dönüşüm işlemi ile yapılandırılmış bir özel dönüşüm hedefi varsa, bu dönüşüm işlemi teklif verilebilir. Varsayılan olarak, birincil_for_goal ayarlanmazsa doğru olur. V9'da, birincil_for_goal yalnızca bir "güncelleme" aracılığıyla oluşturulduktan sonra yanlış olarak ayarlanabilir işlemidir.

owner_customer

string

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

include_in_conversions_metric

bool

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

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

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

Alanlar
activity_group_tag

string

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

activity_tag

string

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

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 kodunun 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" bölümünü inceleyin https://support.google.com/sa360/answer/13567857

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 en fazla 100 karakterden oluşabilir. Öncesinde ve sonrasında fazladan boşluk olmamalıdır.

tag

string

Zorunlu. Dönüşüm özelleştirilebilen değişkeninin etiketi. Etiket benzersiz olmalı ve "u" harfinden oluşmalıdır karakteri ile birlikte 100'e kadar orme eş değer bir sayı gelir. Örneğin: "u4".

status

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ü özelleştirilebilen değişkenlerine ilişkin 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ü özelleştirilebilen değişkenlerine ilişkin bilgiler.

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

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

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ıyorsanız 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 kullanır). Bu alan salt okunurdur.

google_ads_cross_account_conversion_tracking_id

int64

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

cross_account_conversion_tracking_id

int64

Müşteri yöneticisinin dönüşüm izleme kimliği. Bu değer, müşteri hesaplar arası dönüşüm izlemeyi etkinleştirdiğinde ayarlanır ve 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 görebilirsiniz.

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 bulunuyorsa 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ılabilir olduğunda doğru değerini döndürür.

referenced_system_columns[]

string

Bu özel sütunda başvurulan sistem sütunlarının listesi. Örneğin, "Gösterimlerin ve tıklamaların toplamı" özel bir sütunu , {"metrics.clicks", "metrics.impressions"} sistem sütununa referans verdi.

Müşteri

Müşteri.

Alanlar
resource_name

string

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

customers/{customer_id}

conversion_tracking_setting

ConversionTrackingSetting

Müşterinin dönüşüm izleme ayarı

account_type

AccountType

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

double_click_campaign_manager_setting

DoubleClickCampaignManagerSetting

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

account_status

AccountStatus

Hesap durumu (örneğin, Etkin, Duraklatıldı, Kaldırıldı vb.)

last_modified_time

string

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

engine_id

string

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

id

int64

Müşterinin kimliği.

descriptive_name

string

İsteğe bağlı, müşterinin 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şturmaya yönelik URL şablonu.

final_url_suffix

string

Nihai URL'ye parametreler 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ıdır.

Alanlar
resource_name

string

Müşteri öğesinin kaynak adı. CustomerAsset kaynak adları şu şekildedir:

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 bir müşteriye bağlar.

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

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 müşteri arasındaki bağlantı. CustomerClients yalnızca yönetici müşteriler için mevcuttur. Yöneticinin yanı sıra doğrudan ve dolaylı müşterilerin tümü bu kapsama dahil edilir.

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 etiketlerin müşteri müşterisine uygulanan kaynak adları. Etiket kaynağı adları şu biçimdedir:

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

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

Salt okunur.

level

int64

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

time_zone

string

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

descriptive_name

string

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

currency_code

string

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

id

int64

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şkilendirilen Campaign Manager reklamvereninin kimliği.

network_id

int64

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

time_zone

string

Amerika/New_York gibi IANA Saat Dilimi Veritabanı biçiminde, bu müşteriyle ilişkilendirilmiş 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üntüleme 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, geçerli yayın durumunu yansıtır. Cinsiyet ölçütü olmayan bir reklam grubu, varsayılan olarak tüm cinsiyetlere gösterilir. Dolayısıyla, tüm cinsiyetler gender_view öğesinde 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 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 sabit İ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 adı ile hedef adının 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 kaynağı adları şu biçimdedir: customers/{customer_id}/labels/{label_id}

status

LabelStatus

Etiketin durumu. Salt okunur.

text_label

TextLabel

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

id

int64

Etiketin kimliği. Salt okunur.

name

string

Etiketin adı.

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

Bu dize, 1 ile 80 arasında (1 ve 80 dahil) olmalıdır.

LanguageConstant

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 (örneğin, "en_US", "en_AU", "es", "fr" vb.

name

string

Dilin İngilizce tam adı; örneğin, "İngilizce (ABD)", "İspanyolca" vb.

targetable

bool

Dilin hedeflenebilir olup olmadığı.

ListingGroupFilterDimension

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

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

ProductBiddingCategory

Ürün teklifinin teklif verme kategorisi.

product_brand

ProductBrand

Ürün teklifinin markası.

product_channel

ProductChannel

Ürün teklifinin bulunduğu konum.

product_condition

ProductCondition

Bir ürün teklifinin durumudur.

product_custom_attribute

ProductCustomAttribute

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

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

Alanlar
level

ListingGroupFilterBiddingCategoryLevel

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

id

int64

Ürün teklif kategorisinin kimliği.

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

ProductBrand

Ürünün markası.

Alanlar
value

string

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

ProductChannel

Ürün teklifinin bulunduğu konum.

Alanlar
channel

ListingGroupFilterProductChannel

Konumun değeri.

ProductCondition

Bir ürün teklifinin durumudur.

Alanlar
condition

ListingGroupFilterProductCondition

Koşulun değeri.

ProductCustomAttribute

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

Alanlar
index

ListingGroupFilterCustomAttributeIndex

Özel özelliğin dizinini belirtir.

value

string

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

ProductItemId

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

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

Alanlar
dimensions[]

ListingGroupFilterDimension

Listeleme grubu filtre hiyerarşisinden (kök düğüm hariç) bu listeleme grubu filtresine giden boyutların 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 şekildedir:

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 teklif verme kategorisi kaynak adları şu şekildedir:

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

level

ProductBiddingCategoryLevel

Ürün teklif kategorisinin düzeyi.

status

ProductBiddingCategoryStatus

Ürün teklif kategorisinin durumu.

id

int64

Ürün teklif kategorisinin kimliği.

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

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

localized_name

string

Ürün teklif kategorisinin, language_code değerine göre yerelleştirilmiş değeri gösterilir.

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

SearchAds360Fields/{name}

category

SearchAds360FieldCategory

Yapının 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 edildiğinde metrikleri segmentlere ayırmaz.

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

metrics[]

string

Bu alanda, FROM yan tümcesinde kullanıldığında açıklanan yapıyla seçilebilen tüm metriklerin adları listelenir. Yalnızca kategorisi SOURCE olan yapı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 SOURCE olan yapı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 ATTRIBUTE kategorisindeki yapı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

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

filterable

bool

Yapının arama sorgularında WHERE yan tümcesinde 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 protonun URL'si.

is_repeated

bool

Alan yapısının tekrarlanıp tekrarlanmadığı.

ShoppingPerformanceView

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

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

id

int64

Kullanıcı listesinin kimliği.

name

string

Bu kullanıcı listesinin adı. Access_reason'a bağlı olarak kullanıcı listesi adı benzersiz olmayabilir (örneğin, access_reason=SHARED)

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

click_id

string

Her ziyaret için, tıklama kimliği URL parametresi olarak açılış sayfasına 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" şeklindedir. biçimindedir.

product_id

string

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

product_channel

ProductChannel

Tıklanan ürünün satış kanalı: Çevrimiçi veya Yerel.

product_language_code

string

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

product_store_id

string

Yerel envanter reklamındaki tıklanan mağaza. Bu değer, yerel ürünler feed'inizde kullanılan mağaza kimlikleriyle eşleşmelidir.

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

Bir web sayfası görünümü.

Alanlar
resource_name

string

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

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