Search Ads 360 API, daha ayrıntılı ve segmentlere ayrılmış veriler istemediğiniz sürece yalnızca birleştirilmiş verileri döndürür. Örneğin, bir anahtar kelime raporundaki tıklamalar sütunu, belirttiğiniz zaman aralığında bir anahtar kelimenin toplam tıklama sayısını listeler.
| keywordText | keywordLandingPage | tıklama sayısı |
|---|---|---|
| widgets | http://www.example.com | 6000 |
Ancak, üç aylık dönemlere göre segmentlere ayrılmış bir anahtar kelime raporu isterseniz her bir anahtar kelime için her üç aylık dönem için bir satır görürsünüz. Tıklamalar sütununda ise üç aylık toplam tutarlar listelenir.
| keywordText | keywordLandingPage | quarterStart | quarterEnd | tıklama sayısı |
|---|---|---|---|---|
| widgets | http://www.example.com | 2012-01-01 | 2012-03-31 | 1000 |
| widgets | http://www.example.com | 2012-04-01 | 2012-06-30 | 1000 |
| widgets | http://www.example.com | 2012-07-01 | 2012-09-30 | 1000 |
| widgets | http://www.example.com | 2012-10-01 | 2012-12-31 | 3.000 |
Segmentlere ayrılmış bir raporun yalnızca bir segment için veri varsa satır döndürdüğünü unutmayın.
Örneğin, floodlightActivity sütunlu bir anahtar kelime raporunda, rapor tarih aralığı için kendisiyle ilişkilendirilmiş herhangi bir metrik yoksa anahtar kelime ve Floodlight etkinlik çifti raporda görünmez.
Bazı segmentler belirli sütunlarla uyumsuz
Bazı segmentler belirli sütunların geçersiz veriler döndürmesine neden olabilir. Örneğin, floodlightActivity ölçütüne göre segmentlere ayırma, yalnızca dfaActions, dfaRevenue, dfaTransactions ve dfaWeightedActions gibi Floodlight verilerini raporlayan sütunlar eklerseniz anlamlı olur. Diğer dönüşüm sütunu türleri (adWordsConversions gibi) veya motor metriklerini raporlayan sütunlar (tıklamalar ve gösterimler gibi) Floodlight tarafından rapor edilen verileri içermez. Bu nedenle, bir raporu floodlightActivity ölçütüne göre segmentlere ayırırsanız geçersiz değerler döndürürler.
Segmentlere ayrılmış rapor isteğinde bulunma
Segmentlere ayrılmış bir rapor istemek için Rapor Türleri referansına segment davranışının listelendiği bir sütun ekleyin.
Aşağıdaki eşzamansız istek, üç aylık dönemlere göre segmentlere ayrılmış bir anahtar kelime raporu içindir. Her bir satırdaki tıklamalar sütunu, üç aylık döneme ait toplam tıklama sayısını içerir:
{
"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 üç aylık döneme göre segmentlere ayırırsanız isteğinize hem başlangıç hem de bitiş sütunlarını eklemenizi öneririz. Örneğin, üç aylık bir rapora hem
quarterStarthem dequarterEndsütunlarını ekleyin. Bu sütunların her ikisinin de dahil edilmesi, dönemin başlangıç ve bitiş tarihlerini oluşturur. Bu, her tam dönem için verileri dahil ettiğinizi onaylamanıza yardımcı olur. -
Aynı isteğe, zamanla ilgili farklı segment türlerini dahil edemezsiniz. Örneğin, aynı istekte üç aya ve aya göre segmentlere ayıramazsınız.
-
Satır sayısı, her ek segmentle katlanarak artabilir.