Reklamlar için performans metrikleri ve yapılandırma özellikleri.
Bu rapor yalnızca eşzamansız bir istekle (yani Reports.request() yöntemiyle) döndürülebilir.
Alıntı iste
Normal bir Reports.request() istek gövdesi gönderin ancak "reportType": "ad" 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 bir sütun için aşağıdaki tabloda listelenen columnName değerini belirtin.
İsteğe bağlı olarak headerText, startDate ve endDate'i de belirtebilirsiniz.
Bazı sütunların filtrelenemediğini unutmayın; aşağıdaki tabloda "Filtrelenebilir"e 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 kendi durumları olduğunu unutmayın. Durumu inceleyin. |
özellik | Status |
Evet |
engineStatus |
Harici motor hesabındaki reklamın ek durumu. Olası durumlar (harici hesabın türüne bağlı olarak) active, eligible, creative deleted, creative approved family safe vb. içerir. |
özellik | String |
Evet |
creationTimestamp |
ISO 8601 biçimindeki reklam oluşturma zaman damgası. | özellik | Timestamp |
Evet |
lastModifiedTimestamp |
ISO 8601 biçiminde biçimlendirilmiş, en son reklam değişikliğinin zaman damgası. | ö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 |
Motor hesabı adı. | özellik | String |
Evet |
accountId |
DS motor hesabı kimliği. | özellik | ID |
Evet |
accountEngineId |
Harici motor 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şkilendirilmemiş olduğunu gösterir. | özellik | ID |
Evet |
adEngineId |
Harici motor hesabındaki reklamın kimliği. | özellik | ID |
Evet |
isUnattributedAd |
Bu satırdaki metriklerin belirli bir reklamla 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ı motorlar için kullanılamaz. | özellik | String |
Evet |
adHeadline3 |
Reklam başlığı 3; bazı motorlar için kullanılamaz. | özellik | String |
Evet |
adDescription1 |
Reklam açıklama satırı 1. | özellik | String |
Evet |
adDescription2 |
Reklam açıklama satırı 2; bazı motorlar için kullanılamaz. | özellik | String |
Evet |
adDisplayUrl |
Reklam 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 promosyon 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ı, bir 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ı, bir reklamda gösterilen URL'yi oluşturmak için adDisplayUrl ile birleştirilir. | özellik | String |
Evet |
effectiveLabels |
Devralınan veya bu reklama 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şlemlerinden elde edilen 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 |
Ortamlar arası Campaign Manager işlemlerinin toplam sayısı. | metrik | Number |
Evet |
dfaRevenueCrossEnv |
Ortamlar arası Campaign Manager işlemlerinden elde edilen toplam gelir. | metrik | Money |
Evet |
dfaTransactionsCrossEnv |
Ortamlar arası Campaign Manager işlemlerinin toplam sayısı. | metrik | Number |
Evet |
dfaWeightedActionsCrossEnv |
Ortamlar 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üşümleri sütununda raporlanacak şekilde ayarladığı veriler. Google Ads dönüşüm işlemi oluşturulduğunda dönüşüm raporlama sütununda reklamveren bu dönüşümlerin 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 toplu metrikleri, her gün için bir satır olacak şekilde 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 aya göre segmentlere ayırır. Her satır ve toplu metrikleri, her ay için bir tane olacak şekilde birden fazla satıra bölünür. Bu sütun, her satırdaki ayın ilk gününü döndürür. | segmentlere ayır | Date |
Evet |
monthEnd |
Raporu aya göre segmentlere ayırır. Her satır ve toplu metrikleri, her ay için bir tane olacak şekilde birden fazla satıra bölünür. Bu sütun, her satırdaki ayın son gününü döndürür. | segmentlere ayır | Date |
Evet |
quarterStart |
Raporu üç aylık dönemlere göre segmentlere ayırır. Her satır ve toplu metrikleri, her üç aylık dönem için bir satır olacak şekilde birden fazla satıra bölünür. Bu sütun, her satırdaki üç aylık dönemin ilk gününü döndürür. | segmentlere ayır | Date |
Evet |
quarterEnd |
Raporu üç aylık dönemlere göre segmentlere ayırır. Her satır ve toplu metrikleri, her üç aylık dönem için bir satır olacak şekilde birden fazla satıra bölünür. Bu sütun, her satırdaki üç aylık dönemin son gününü döndürür. | segmentlere ayır | Date |
Evet |
weekStart |
Raporu haftalara (pazardan cumartesiye) göre segmentlere ayırır. Her satır ve toplu metrikleri, her hafta için bir satır olacak şekilde birden çok 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 haftalara (pazardan cumartesiye) göre segmentlere ayırır. Her satır ve toplu metrikleri, her hafta için bir satır olacak şekilde birden çok 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 toplu metrikleri, her yıl için bir satır olacak şekilde birden fazla satıra bölünür. Bu sütun her satırdaki 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 toplu metrikleri, her yıl için bir satır olacak şekilde birden fazla satıra bölünür. Bu sütun, her satırda 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 satır olacak şekilde 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 toplu metrikleri, her Floodlight grubu için en fazla bir satır olacak şekilde birden fazla satıra bölünür. Bu sütun, her satırın Floodlight grubu adını döndürür. Tıklamalar ve ziyaretler gibi bazı metriklerin Floodlight segmentlere ayrılmış değerleri olmadığını unutmayın. | segmentlere ayır | String |
Evet |
floodlightGroupId |
Raporu Floodlight gruplarına göre segmentlere ayırır. Her satır ve toplu metrikleri, her Floodlight grubu için en fazla bir satır olacak şekilde birden fazla satıra bölünür. Bu sütun, her bir satırın DS Floodlight grubu kimliğini döndürür. Tıklamalar ve ziyaretler gibi bazı metriklerin Floodlight segmentlere ayrılmış değerleri olmadığını unutmayın. | segmentlere ayır | ID |
Evet |
floodlightGroupTag |
Raporu Floodlight gruplarına göre segmentlere ayırır. Her satır ve toplu metrikleri, her Floodlight grubu için en fazla bir satır olacak şekilde birden fazla satıra bölünür. Bu sütun, her satırın Floodlight grubu etiketini döndürür. Tıklamalar ve ziyaretler gibi bazı metriklerin Floodlight segmentlere ayrılmış değerleri olmadığını unutmayın. | segmentlere ayır | String |
Evet |
floodlightActivity |
Raporu Floodlight etkinliklerine göre segmentlere ayırır; her bir satır ve toplu metrikleri, her bir Floodlight etkinliği için en fazla bir satır olacak şekilde birden çok satıra bölünür. Bu sütun, her bir satırın Floodlight etkinliği adını döndürür. Tıklamalar ve ziyaretler gibi bazı metriklerin Floodlight segmentlere ayrılmış değerleri olmadığını unutmayın. | segmentlere ayır | String |
Evet |
floodlightActivityId |
Raporu Floodlight etkinliklerine göre segmentlere ayırır; her bir satır ve toplu metrikleri, her bir Floodlight etkinliği için en fazla bir satır olacak şekilde birden çok satıra bölünür. Bu sütun, her bir satırın DS Floodlight etkinliği kimliğini döndürür. Tıklamalar ve ziyaretler gibi bazı metriklerin Floodlight segmentlere ayrılmış değerleri olmadığını unutmayın. | segmentlere ayır | ID |
Evet |
floodlightActivityTag |
Raporu Floodlight etkinliklerine göre segmentlere ayırır; her bir satır ve toplu metrikleri, her bir Floodlight etkinliği için en fazla bir satır olacak şekilde birden çok satıra bölünür. Bu sütun, her satırın Floodlight etkinliği etiketini döndürür. Tıklamalar ve ziyaretler gibi bazı metriklerin Floodlight segmentlere ayrılmış değerleri olmadığını unutmayın. | segmentlere ayır | String |
Evet |