Reklamlar için performans metrikleri ve yapılandırma özellikleri.
Bu rapor yalnızca asenkron istek (yani Reports.request() yöntemi) ile döndürülebilir.
Alıntı isteğinde bulunma
Normal bir Reports.request() istek gövdesi gönderin ancak "reportType": "ad" değerini belirtin.
{
...
"reportType": "ad",
"columns": [
{
"columnName":string ,
"headerText":string ,
"startDate":string ,
"endDate":string
}
],
"filters": [
{
"column": {
"columnName":string ,
},
...
},
...
],
...
}
Raporda döndürülmesini veya filtrelenmesini istediğiniz her sütun için aşağıdaki tabloda listelenen columnName değerini belirtin.
İsteğe bağlı olarak headerText, startDate ve endDate özelliklerini de belirtebilirsiniz.
Bazı sütunların filtrelenemediğini unutmayın. Aşağıdaki tabloda "Filtrelenebilir" sütununa bakın.
columnName | Açıklama | Davranış | Tür | Filtrelenebilir |
|---|---|---|---|---|
status |
Reklamın durumu: Active, Paused veya Removed. Kampanyaların, reklam gruplarının, anahtar kelimelerin ve reklamların her birinin kendi durumunun olduğunu unutmayın. Durum bölümüne bakın. |
özellik | Status |
Evet |
engineStatus |
Reklamın harici arama motoru hesabındaki ek durumu. Olası durumlar (harici hesabın türüne bağlı olarak) active, eligible, creative deleted, creative approved family safe vb.'dir. |
özellik | String |
Evet |
creationTimestamp |
ISO 8601 biçiminde, reklamın oluşturulduğu zaman damgası. | özellik | Timestamp |
Evet |
lastModifiedTimestamp |
Reklamın en son değiştirildiği zaman damgası (ISO 8601 biçiminde). | özellik | Timestamp |
Evet |
agency |
Ajans adı. | özellik | String |
Evet |
agencyId |
DS ajans kimliği. | özellik | ID |
Evet |
advertiser |
Reklamveren adı. | özellik | String |
Evet |
advertiserId |
DS reklamveren kimliği. | özellik | ID |
Evet |
account |
Arama motoru hesabı adı. | özellik | String |
Evet |
accountId |
DS arama motoru hesap kimliği. | özellik | ID |
Evet |
accountEngineId |
Harici arama motoru hesabındaki hesabın kimliği. | özellik | String |
Evet |
accountType |
Motor hesabı türü: Google AdWords, Bing Ads, Yahoo Japan Listing Ads, Yahoo Search Marketing, Yahoo Gemini, Baidu veya Comparison Shopping. |
özellik | Engine type |
Evet |
campaign |
Kampanya adı. | özellik | String |
Evet |
campaignId |
DS kampanya kimliği. | özellik | ID |
Evet |
campaignStatus |
Bu öğeyi içeren kampanyanın durumu. | özellik | Status |
Evet |
adGroup |
Reklam grubu adı. | özellik | String |
Evet |
adGroupId |
DS reklam grubu kimliği. | özellik | ID |
Evet |
adGroupStatus |
Bu öğeyi içeren reklam grubunun durumu. | özellik | Status |
Evet |
ad |
Reklam adı. | özellik | String |
Evet |
adId |
DS reklam kimliği. 0 değeri, reklamın ilişkilendirilmediğini gösterir. | özellik | ID |
Evet |
adEngineId |
Harici arama motoru hesabındaki reklamın kimliği. | özellik | ID |
Evet |
isUnattributedAd |
Bu satırdaki metriklerin belirli bir reklamla ilişkilendirilip ilişkilendirilemediğini belirtir. Örneğin, desteklenmeyen bir biçime veya hatalı bir tıklama sunucusu URL'sine sahip bir reklam, DS'nin metrikleri bir reklamla ilişkilendirmesini engelleyebilir. | özellik | Boolean |
Evet |
adHeadline |
Reklam başlığı. | özellik | String |
Evet |
adHeadline2 |
Reklam başlığı 2; bazı motorlarda kullanılamaz. | özellik | String |
Evet |
adHeadline3 |
Reklam başlığı 3; bazı motorlarda kullanılamaz. | özellik | String |
Evet |
adDescription1 |
Reklam açıklaması satırı 1. | özellik | String |
Evet |
adDescription2 |
Reklam açıklaması satırı 2; bazı motorlar için kullanılamaz. | özellik | String |
Evet |
adDisplayUrl |
Reklamın görünen URL'si. | özellik | String |
Evet |
adLandingPage |
Reklam açılış sayfası. Açılış sayfası ve tıklama sunucusu URL'leri bölümüne bakın. | özellik | String |
Evet |
adType |
Reklam türü: Text, Product, Dynamic search, Mobile app install, Call-Only, Expanded text veya Expanded dynamic search. |
özellik | Ad type |
Evet |
adPromotionLine |
Reklam tanıtım satırı. Ürün reklamı için kısa bir tanıtım mesajı. | özellik | String |
Evet |
adLabels |
Doğrudan bu reklama atanan etiketlerin adları (devralınan etiketler dahil değildir). | özellik | String list |
Evet |
adPathField1 |
Reklam yolu alanı 1. 1. ve 2. yol alanları, reklamda gösterilen URL'yi oluşturmak için adDisplayUrl ile birleştirilir. | özellik | String |
Evet |
adPathField2 |
Reklam yolu alanı 2. 1. ve 2. yol alanları, reklamda gösterilen URL'yi oluşturmak için adDisplayUrl ile birleştirilir. | özellik | String |
Evet |
effectiveLabels |
Bu reklama devralınan veya doğrudan atanan tüm etiketlerin adları. | özellik | String list |
Evet |
dfaActions |
Campaign Manager işlemlerinin toplam sayısı. | metrik | Integer |
Evet |
dfaRevenue |
Campaign Manager işlemleri tarafından oluşturulan toplam gelir. | metrik | Money |
Evet |
dfaTransactions |
Campaign Manager işlemlerinin toplam sayısı. | metrik | Integer |
Evet |
dfaWeightedActions |
Campaign Manager işlemlerinin ağırlıklı toplamı. | metrik | Number |
Evet |
dfaActionsCrossEnv |
Çevreler arası Campaign Manager işlemlerinin toplam sayısı. | metrik | Number |
Evet |
dfaRevenueCrossEnv |
Çevreler arası Campaign Manager işlemleri tarafından oluşturulan toplam gelir. | metrik | Money |
Evet |
dfaTransactionsCrossEnv |
Ortamlar arası Campaign Manager işlemlerinin toplam sayısı. | metrik | Number |
Evet |
dfaWeightedActionsCrossEnv |
Çevreler arası Campaign Manager işlemlerinin ağırlıklı toplamı. | metrik | Number |
Evet |
avgCpc |
Ortalama tıklama başına maliyet. | metrik | Money |
Evet |
avgCpm |
Ortalama bin gösterim başına maliyet. | metrik | Money |
Evet |
avgPos |
Ortalama konum. | metrik | Number |
Evet |
clicks |
Toplu tıklamalar. | metrik | Integer |
Evet |
cost |
Arama motoru hesaplarına ödenen toplam maliyet. | metrik | Money |
Evet |
ctr |
Ortalama tıklama oranı. | metrik | Number |
Evet |
impr |
Toplam gösterim sayısı. | metrik | Integer |
Evet |
adWordsConversions |
Reklamverenin Google Ads Dönüşümler sütununda raporlanması için ayarladığı veriler. Bir Google Ads dönüşüm işlemi oluşturulduğunda reklamveren, bu dönüşümlerin Dönüşümler raporlama sütununda sayılıp sayılmayacağını seçebilir. | metrik | Number |
Evet |
adWordsConversionValue |
Google Ads dönüşümlerinin toplam değeri. | metrik | Number |
Evet |
adWordsViewThroughConversions |
Google Ads görüntüleme dönüşümlerinin toplam sayısı. | metrik | Integer |
Evet |
visits |
DS ziyaretlerinin toplam sayısı. | metrik | Integer |
Evet |
date |
Raporu günlere göre segmentlere ayırır. Her satır ve toplam metrikleri, her gün için bir tane olmak üzere birden çok satıra bölünür. Bu sütun, her satırın tarihini döndürür. | segmentlere ayır | Date |
Evet |
monthStart |
Raporu aylara göre segmentlere ayırır. Her satır ve toplam metrikleri, her ay için bir tane olmak üzere birden fazla satıra bölünür. Bu sütun, her satırın ayın ilk gününü döndürür. | segmentlere ayır | Date |
Evet |
monthEnd |
Raporu aylara göre segmentlere ayırır. Her satır ve toplam metrikleri, her ay için bir tane olmak üzere birden fazla satıra bölünür. Bu sütun, her satırın ayın son gününü döndürür. | segmentlere ayır | Date |
Evet |
quarterStart |
Raporu çeyreklere göre segmentlere ayırır. Her satır ve bu satırın toplu metrikleri, her çeyrek için bir tane olmak üzere birden fazla satıra bölünür. Bu sütun, her satırın üç aylık döneminin ilk gününü döndürür. | segmentlere ayır | Date |
Evet |
quarterEnd |
Raporu çeyreklere göre segmentlere ayırır. Her satır ve bu satırın toplu metrikleri, her çeyrek için bir tane olmak üzere birden fazla satıra bölünür. Bu sütun, her satırın üç aylık döneminin son gününü döndürür. | segmentlere ayır | Date |
Evet |
weekStart |
Raporu haftaya göre segmentlere ayırır (pazardan cumartesiye); her satır ve toplam metrikleri her hafta için birden fazla satıra bölünür. Bu sütun, her satırın ilk gününü (Pazar) döndürür. | segmentlere ayır | Date |
Evet |
weekEnd |
Raporu haftaya göre segmentlere ayırır (pazardan cumartesiye); her satır ve toplam metrikleri her hafta için birden fazla satıra bölünür. Bu sütun, her satırın son gününü (Cumartesi) döndürür. | segmentlere ayır | Date |
Evet |
yearStart |
Raporu yıllara göre segmentlere ayırır. Her satır ve toplam metrikleri, her yıl için bir tane olmak üzere birden fazla satıra bölünür. Bu sütun, her satırın yılın ilk gününü döndürür. | segmentlere ayır | Date |
Evet |
yearEnd |
Raporu yıllara göre segmentlere ayırır. Her satır ve toplam metrikleri, her yıl için bir tane olmak üzere birden fazla satıra bölünür. Bu sütun, her satırın yılın son gününü döndürür. | segmentlere ayır | Date |
Evet |
deviceSegment |
Raporu cihaza göre segmentlere ayırır. Her satır ve toplu metrikleri, her cihaz segmenti için en fazla bir tane olmak üzere birden fazla satıra bölünür. Bu sütun, her satırın cihaz segmentini döndürür. | segmentlere ayır | Device segment |
Evet |
floodlightGroup |
Raporu Floodlight gruplarına göre segmentlere ayırır. Her satır ve birleştirilmiş metrikleri, her Floodlight grubu için en fazla bir tane olmak üzere birden çok satıra bölünür. Bu sütun, her satırın Floodlight grup adını döndürür. Tıklamalar ve ziyaretler gibi bazı metriklerin Floodlight segmentlere ayrılmış değerlerinin olmadığını unutmayın. | segmentlere ayır | String |
Evet |
floodlightGroupId |
Raporu Floodlight gruplarına göre segmentlere ayırır. Her satır ve birleştirilmiş metrikleri, her Floodlight grubu için en fazla bir tane olmak üzere birden çok satıra bölünür. Bu sütun, her satırın DS Floodlight grup kimliğini döndürür. Tıklamalar ve ziyaretler gibi bazı metriklerin Floodlight segmentlere ayrılmış değerlerinin olmadığını unutmayın. | segmentlere ayır | ID |
Evet |
floodlightGroupTag |
Raporu Floodlight gruplarına göre segmentlere ayırır. Her satır ve birleştirilmiş metrikleri, her Floodlight grubu için en fazla bir tane olmak üzere birden çok satıra bölünür. Bu sütun, her satırın Floodlight grup etiketini döndürür. Tıklamalar ve ziyaretler gibi bazı metriklerin Floodlight segmentlere ayrılmış değerlerinin olmadığını unutmayın. | segmentlere ayır | String |
Evet |
floodlightActivity |
Raporu Floodlight etkinliklerine göre segmentlere ayırır. Her satır ve birleştirilmiş metrikleri, her Floodlight etkinliği için en fazla bir tane olmak üzere birden fazla satıra bölünür. Bu sütun, her satırın Floodlight etkinliği adını döndürür. Tıklamalar ve ziyaretler gibi bazı metriklerin Floodlight segmentlere ayrılmış değerlerinin olmadığını unutmayın. | segmentlere ayır | String |
Evet |
floodlightActivityId |
Raporu Floodlight etkinliklerine göre segmentlere ayırır. Her satır ve birleştirilmiş metrikleri, her Floodlight etkinliği için en fazla bir tane olmak üzere birden fazla satıra bölünür. Bu sütun, her satırın DS Floodlight etkinlik kimliğini döndürür. Tıklamalar ve ziyaretler gibi bazı metriklerin Floodlight segmentlere ayrılmış değerlerinin olmadığını unutmayın. | segmentlere ayır | ID |
Evet |
floodlightActivityTag |
Raporu Floodlight etkinliklerine göre segmentlere ayırır. Her satır ve birleştirilmiş metrikleri, her Floodlight etkinliği için en fazla bir tane olmak üzere birden fazla satıra bölünür. Bu sütun, her satırın Floodlight etkinlik etiketini döndürür. Tıklamalar ve ziyaretler gibi bazı metriklerin Floodlight segmentlere ayrılmış değerlerinin olmadığını unutmayın. | segmentlere ayır | String |
Evet |