Rapor Türü: reklam

Reklamlar için performans metrikleri ve yapılandırma özellikleri.

Bu rapor yalnızca eşzamansız bir istek (yani Reports.request() yöntemi).

Alıntı iste

Düzenli olarak gönder Reports.request() istek gövdesi, 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. Ayrıca isteğe bağlı olarak headerText, startDate, ve endDate. Bazı sütunların filtrelenemeyeceğini unutmayın; "Filtrelenebilir" bulabilirsiniz.

columnNameAçıklamaDavranışTürFiltrelenebilir
status Reklamın durumu: Active, Paused veya Removed. Kampanyaların, reklam gruplarının, anahtar kelimelerin ve reklamların her birinin kendi durumu olduğunu unutmayın. Durumu öğrenin. özellik Status Evet
engineStatus Harici arama motoru 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. şeklindedir. özellik String Evet
creationTimestamp Reklamın ISO 8601 biçiminde biçimlendirilmiş zaman damgası. özellik Timestamp Evet
lastModifiedTimestamp Reklamda yapılan en son değişikliğin ISO 8601 biçimindeki 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 Arama motoru 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 Arama motoru 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şkilendirilemeyeceğini belirtir. Örneğin, desteklenmeyen 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çıklama satırı 1. özellik String Evet
adDescription2 Reklam açıklama satırı 2; bazı motorlarda 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ın 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ı. Bir ü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 edilmez. özellik String list Evet
adPathField1 Reklam yolu alanı 1. Yol alanları 1 ve 2, reklamda gösterilen URL'yi oluşturmak için adDisplayUrl ile birleştirilir. özellik String Evet
adPathField2 Reklam yolu alanı 2. Yol alanları 1 ve 2, reklamda gösterilen URL'yi oluşturmak için adDisplayUrl ile birleştirilir. özellik String Evet
effectiveLabels Devralınan veya doğrudan bu reklama 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 oluşturulan toplu 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 toplu 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 Tıklama başına ortalama 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 raporlanmak üzere ayarladığı veriler. Bir Google Ads dönüşüm işlemi oluşturulduğunda reklamveren bu dönüşümleri Dönüşümler raporlama sütununda sayıp saymayacağı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 bu satıra ait toplam metrikler, her gün için bir tane olacak şekilde birden fazla 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 bu satıra ait toplam metrikler, her ay için bir tane olacak şekilde birden fazla satıra bölünür. Bu sütun, her bir 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 bu satıra ait toplam metrikler, her ay için bir tane olacak şekilde birden fazla satıra bölünür. Bu sütun, her bir satırın 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 bu satırın toplam metrikleri, her üç aylık dönem için bir tane olacak şekilde birden çok satıra bölünür. Bu sütun, her bir satırın çeyreğinin 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 bu satırın toplam metrikleri, her üç aylık dönem için bir tane olacak şekilde birden çok satıra bölünür. Bu sütun, her bir satırın çeyreğinin son gününü döndürür. segmentlere ayır Date Evet
weekStart Raporu haftalara göre (pazardan cumartesiye) segmentlere ayırır; Her satır ve bu satıra ait toplam metrikler, her hafta için bir tane olacak şekilde 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 haftalara göre (pazardan cumartesiye) segmentlere ayırır; Her satır ve bu satıra ait toplam metrikler, her hafta için bir tane olacak şekilde 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 bu satıra ait toplam metrikler, her yıl için bir tane olacak şekilde 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 bu satıra ait toplam metrikler, her yıl için bir tane olacak şekilde 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 toplam 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 toplam metrikleri, her Floodlight grubu için en fazla bir tane olacak şekilde birden çok satıra bölünür. Bu sütun, her bir satırın Floodlight grubu adını döndürür. Bazı metriklerin tıklamalar ve ziyaretler gibi Floodlight segmentlere ayrılmış değerlerine sahip olmadığını unutmayın. segmentlere ayır String Evet
floodlightGroupId Raporu Floodlight gruplarına göre segmentlere ayırır; her satır ve toplam metrikleri, her Floodlight grubu için en fazla bir tane olacak şekilde birden çok satıra bölünür. Bu sütun, her bir satırın DS Floodlight grup kimliğini döndürür. Bazı metriklerin tıklamalar ve ziyaretler gibi Floodlight segmentlere ayrılmış değerlerine sahip olmadığını unutmayın. segmentlere ayır ID Evet
floodlightGroupTag Raporu Floodlight gruplarına göre segmentlere ayırır; her satır ve toplam metrikleri, her Floodlight grubu için en fazla bir tane olacak şekilde birden çok satıra bölünür. Bu sütun, her bir satırın Floodlight grubu etiketini döndürür. Bazı metriklerin tıklamalar ve ziyaretler gibi Floodlight segmentlere ayrılmış değerlerine sahip olmadığını unutmayın. segmentlere ayır String Evet
floodlightActivity Raporu Floodlight etkinliklerine göre segmentlere ayırır; her satır ve toplam metrikleri, her Floodlight etkinliği için bir taneye kadar birden çok satıra bölünür. Bu sütun, her bir satırın Floodlight etkinlik adını döndürür. Bazı metriklerin tıklamalar ve ziyaretler gibi Floodlight segmentlere ayrılmış değerlerine sahip olmadığını unutmayın. segmentlere ayır String Evet
floodlightActivityId Raporu Floodlight etkinliklerine göre segmentlere ayırır; her satır ve toplam metrikleri, her Floodlight etkinliği için bir taneye kadar birden çok satıra bölünür. Bu sütun, her bir satırın DS Floodlight etkinlik kimliğini döndürür. Bazı metriklerin tıklamalar ve ziyaretler gibi Floodlight segmentlere ayrılmış değerlerine sahip olmadığını unutmayın. segmentlere ayır ID Evet
floodlightActivityTag Raporu Floodlight etkinliklerine göre segmentlere ayırır; her satır ve toplam metrikleri, her Floodlight etkinliği için bir taneye kadar birden çok satıra bölünür. Bu sütun, her bir satırın Floodlight etkinlik etiketini döndürür. Bazı metriklerin tıklamalar ve ziyaretler gibi Floodlight segmentlere ayrılmış değerlerine sahip olmadığını unutmayın. segmentlere ayır String Evet