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.
columnName | Açıklama | Davranış | Tür | Filtrelenebilir |
|---|---|---|---|---|
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 |