Rapor Türü: anahtar kelime

Anahtar kelimelerin 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": "keyword" değerini belirtin. 

{
...
  "reportType": "keyword",
  "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 Anahtar kelimenin 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 motor hesabındaki anahtar kelimenin ek durumu. Olası durumlar (harici hesabın türüne bağlı olarak) criterion rarely served, criterion below first page bid, criterion low quality score, review, campaign paused vb. şeklindedir. özellik String Evet
creationTimestamp Anahtar kelimenin oluşturulma zaman damgası (ISO 8601'de biçimlendirilmiştir). özellik Timestamp Evet
lastModifiedTimestamp Anahtar kelimede 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
keywordId DS anahtar kelime kimliği. 0 değeri, anahtar kelimenin ilişkilendirilmemiş olduğunu gösterir. özellik ID Evet
keywordMatchType Anahtar kelime eşleme türü: Broad, Exact, Phrase veya Content. özellik Match type Evet
keywordText Anahtar kelime metni. özellik String Evet
keywordEngineId Harici motor hesabındaki anahtar kelimenin kimliği. özellik ID Evet
keywordMaxCpc Reklam grubunun maks. TBM'sini geçersiz kılar ve bir kullanıcı bu anahtar kelime için bir reklamı tıkladığında ödemek istediğiniz maksimum tutarı belirler. Bu alan boşsa anahtar kelime, reklam grubunun maks. TBM'sini kullanır. özellik Money Evet
effectiveKeywordMaxCpc Bu anahtar kelime için yürürlükte olan maks. TBM (maksimum tıklama başına maliyet). Bu değer, reklam grubunun maks. TBM'siyle aynı değer veya anahtar kelime reklam grubunun ayarını geçersiz kılıyorsa, anahtar kelimenin kendi maks. TBM'si olur. özellik Money Evet
keywordLandingPage Kullanıcının reklamınızı tıkladıktan sonra ziyaret edeceği nihai URL. Açılış sayfası ve tıklama sunucusu URL'leri bölümüne bakın. özellik String Evet
keywordClickserverUrl DS'nin etkinliği izlemek için kullandığı URL. Bir reklamı tıklayan kullanıcı önce tıklama sunucusu URL'sini ziyaret eder, ardından son açılış sayfasına yönlendirilir. Açılış sayfası ve tıklama sunucusu URL'leri bölümüne bakın. özellik String Evet
isDisplayKeyword Bunun görüntülü reklam ve yerleşim raporlaması için kullanılan bir yer tutucu anahtar kelime olup olmadığını belirtir. özellik Boolean Evet
keywordMaxBid Bu anahtar kelime bir DS teklif stratejisi tarafından yönetiliyorsa teklif stratejisi hiçbir zaman teklifleri bu sınırın üzerine çıkarmaz. Anahtar kelimelere teklif stratejisi uygulama bölümüne bakın. özellik Money Evet
keywordMinBid Bu anahtar kelime bir DS teklif stratejisi tarafından yönetiliyorsa teklif stratejisi hiçbir zaman teklifleri bu sınırın altına düşürmez. Anahtar kelimelere teklif stratejisi uygulama bölümüne bakın. özellik Money Evet
keywordUrlParams Açılış sayfasına eklenen fazladan URL parametreleri. URL parametreleri ekleme bölümüne bakın. özellik String Evet
bingKeywordParam2 Bing Ads anahtar kelimesinin param2. özellik String Evet
bingKeywordParam3 Bing Ads anahtar kelimesinin param3. özellik String Evet
keywordLabels Doğrudan bu anahtar kelimeye atanan etiketlerin adları; devralınan etiketler dahil edilmez. özellik String list Evet
qualityScoreCurrent Yalnızca Google Ads ve Bing Ads. Bir anahtar kelimeye ait motorun Kalite puanının (KP) en son değeri. Bu sütunun, raporun zaman aralığından bağımsız olarak her zaman bir anahtar kelime için en son KP'yi raporladığını unutmayın. özellik Integer Evet
topOfPageBidCurrent Yalnızca Google Ads. Reklamınızın her zaman arama sonuçlarının yukarısındaki en üst konumlarda görünmesi için gereken TBM teklifini tahmin eder. Bu sütunun, raporun zaman aralığından bağımsız olarak her zaman şu anda gerekli olan TBM'yi bildirdiğini unutmayın. özellik Money Evet
effectiveBidStrategyId Bu varlığa atanan veya bu varlık tarafından devralınan teklif stratejisinin DS kimliği. özellik ID Evet
effectiveBidStrategy Bu varlığa atanan veya bu varlık tarafından devralınan teklif stratejisinin adı. özellik String Evet
bidStrategyInherited Bu varlığın teklif stratejisinin devralınıp alınmadığını belirtir. özellik Boolean Evet
effectiveLabels Devralınan veya doğrudan bu anahtar kelimeye 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
qualityScoreAvg Yalnızca Google Ads ve Bing Ads. Rapor kapsamındaki tüm günler ve anahtar kelimeler genelinde motorun Kalite puanının (KP) gösterim ağırlıklı ortalaması. metrik Number Evet
topOfPageBidAvg Yalnızca Google Ads. Reklamlarınızın arama sonuçlarının yukarısındaki en üst konumlarda düzenli olarak görünmesi için raporun zaman aralığı boyunca gereken ortalama TBM teklifini tahmin eder. metrik Money 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
ad Raporu reklamlara göre segmentlere ayırma Her satır ve bu satıra ait toplam metrikler, her reklam için en fazla bir tane olacak şekilde birden çok satıra bölünür. Bu sütun, her satırdaki reklamın adını döndürür. segmentlere ayır String Evet
adId Raporu reklamlara göre segmentlere ayırma Her satır ve bu satıra ait toplam metrikler, her reklam için en fazla bir tane olacak şekilde birden çok satıra bölünür. Bu sütun, her bir satırdaki reklamın DS kimliğini döndürür. segmentlere ayır ID Evet
isUnattributedAd Raporu reklamlara göre segmentlere ayırma Her satır ve bu satıra ait toplam metrikler, her reklam için en fazla bir tane olacak şekilde birden çok satıra bölünür. Bu sütun, bu satırdaki metriklerin belirli bir reklamla ilişkilendirilemediğini gösterir. segmentlere ayır Boolean Evet
adHeadline Raporu reklamlara göre segmentlere ayırma Her satır ve bu satıra ait toplam metrikler, her reklam için en fazla bir tane olacak şekilde birden çok satıra bölünür. Bu sütun, her satırdaki reklamın başlığını döndürür. segmentlere ayır String Evet
adHeadline2 Raporu reklamlara göre segmentlere ayırma Her satır ve bu satıra ait toplam metrikler, her reklam için en fazla bir tane olacak şekilde birden çok satıra bölünür. Bu sütun, her satırda reklamın 2. başlığını döndürür. Bazı motorlarda kullanılamaz. segmentlere ayır String Evet
adHeadline3 Raporu reklamlara göre segmentlere ayırma Her satır ve bu satıra ait toplam metrikler, her reklam için en fazla bir tane olacak şekilde birden çok satıra bölünür. Bu sütun, her satırda reklamın 3. başlığını döndürür. Bazı motorlarda kullanılamaz. segmentlere ayır String Evet
adDescription1 Raporu reklamlara göre segmentlere ayırma Her satır ve bu satıra ait toplam metrikler, her reklam için en fazla bir tane olacak şekilde birden çok satıra bölünür. Bu sütun, her satırda reklamın 1. açıklama satırını döndürür. segmentlere ayır String Evet
adDescription2 Raporu reklamlara göre segmentlere ayırma Her satır ve bu satıra ait toplam metrikler, her reklam için en fazla bir tane olacak şekilde birden çok satıra bölünür. Bu sütun, her satırda reklamın 2. açıklama satırını döndürür. segmentlere ayır String Evet
adDisplayUrl Raporu reklamlara göre segmentlere ayırma Her satır ve bu satıra ait toplam metrikler, her reklam için en fazla bir tane olacak şekilde birden çok satıra bölünür. Bu sütun, her bir satırdaki reklamın görünen URL'sini döndürür. segmentlere ayır String Evet
adLandingPage Raporu reklamlara göre segmentlere ayırma Her satır ve bu satıra ait toplam metrikler, her reklam için en fazla bir tane olacak şekilde birden çok satıra bölünür. Bu sütun, her satırdaki reklamın açılış sayfasını döndürür. segmentlere ayır String Evet
adType Raporu reklamlara göre segmentlere ayırma Her satır ve bu satıra ait toplam metrikler, her reklam için en fazla bir tane olacak şekilde birden çok satıra bölünür. Bu sütun, her satırdaki reklamın türünü döndürür: Text veya Product. segmentlere ayır Ad type Evet
adPromotionLine Raporu reklamlara göre segmentlere ayırma Her satır ve bu satıra ait toplam metrikler, her reklam için en fazla bir tane olacak şekilde birden çok satıra bölünür. Bu sütun, her bir satırdaki ürün reklamının tanıtım satırını döndürür. segmentlere ayır String Evet