Search Ads 360 API yalnızca daha ayrıntılı, segmentlere ayrılmış şekilde istekte bulunmadıkça birleştirilmiş verileri döndürür. dışı verilerdir. Örneğin, bir anahtar kelimedeki tıklamalar sütunu rapor, belirttiğiniz zaman aralığında bir anahtar kelimenin toplam tıklama sayısını listeler.
keywordText | keywordLandingPage | tıklama sayısı |
---|---|---|
widget'lar | http://www.example.com | 6.000 |
Ancak üç aylık dönemlere göre segmentlere ayıran bir anahtar kelime raporu isterseniz, her bir anahtar kelime için Her çeyrek için bir satır görürsünüz ve tıklamalar sütununda üç aylık toplamlar listelenir.
keywordText | keywordLandingPage | quarterStart | quarterEnd | tıklama sayısı |
---|---|---|---|---|
widget'lar | http://www.example.com | 2012-01-01 | 2012-03-31 | 1000 |
widget'lar | http://www.example.com | 2012-04-01 | 2012-06-30 | 1000 |
widget'lar | http://www.example.com | 2012-07-01 | 2012-09-30 | 1000 |
widget'lar | http://www.example.com | 2012-10-01 | 2012-12-31 | 3000 |
Segmentlere ayrılmış bir raporun, yalnızca bir segment için veri varsa bir satır döndürdüğünü unutmayın.
Örneğin, floodlightActivity
sütununu içeren bir anahtar kelime raporunda anahtar kelime ve
İlişkilendirilen herhangi bir metrik yoksa Floodlight etkinlik çifti raporda görünmez
dönüşüm değerini ekleyebilirsiniz.
Bazı segmentler belirli sütunlarla uyumsuz
Bazı segmentler, belirli sütunların geçersiz veriler döndürmesine neden olabilir. Örneğin,
floodlightActivity
, yalnızca Floodlight'ı raporlayan sütunlar eklerseniz anlamlı olur
dfaActions
, dfaRevenue
, dfaTransactions
,
ve dfaWeightedActions
. Diğer dönüşüm sütunu türleri (örneğin,
adWordsConversions
) veya motor metriklerini (tıklamalar ve
gösterim sayısı), Floodlight tarafından raporlanan verileri içermez. Bu nedenle,
bir raporu floodlightActivity
metriğine göre segmentlere ayırın.
Segmentlere ayrılmış bir rapor nasıl istenir?
Segmentlere ayrılmış rapor istemek için Rapor Türleri referansına segment
davranışını gösteren bir sütun ekleyin.
Aşağıdaki eşzamansız istek, üç aylık döneme göre segmentlere ayrılmış bir anahtar kelime raporu içindir. İlgili içeriği oluşturmak için kullanılan her bir satırdaki tıklamalar sütununda, o üç aylık döneme ait toplam tıklama sayısı yer alır:
{ "reportScope": { "agencyId": "20700000000000123", // Replace with your IDs "advertiserId": "2170000012345" // Replace with your IDs }, "reportType": "keyword", "columns": [ { "columnName": "campaignId" }, { "columnName": "keywordText" }, { "columnName": "keywordLandingPage" }, { "columnName": "quarterStart" }, { "columnName": "quarterEnd" }, { "columnName": "clicks" }, ] "timeRange" : { "startDate" : "2012-01-01", "endDate" : "2012-12-31" }, "downloadFormat": "csv", "maxRowsPerFile": 5000000, "statisticsCurrency": "agency", "verifySingleTimeZone": false, "includeRemovedEntities": false }
Birden çok segment isteme
Bir isteğe birden fazla segment sütunu ekleyebilirsiniz. Aşağıdakileri göz önünde bulundurun:
-
Haftaya, aya veya çeyreğe göre segmentlere ayırma işlemi yaparsanız hem başlangıç ve bitiş sütunlarını seçin. Örneğin, üç aylık bir raporda her iki
quarterStart
vequarterEnd
sütunları. Bunların her ikisini de eklemek sütunları, dönemin başlangıç ve bitiş tarihlerini gösterir. Bu da dahil edilir. -
Aynı isteğe farklı türde zamana bağlı segmentler ekleyemezsiniz. Örneğin, aynı istekte üç aylık döneme ve aya göre segmentlere ayırma işlemi yapamazsınız.
-
Satır sayısı, eklenen her segmentle birlikte katlanarak artabilir.