Segmentlere ayrılmış raporlar

Yeni Search Ads 360 Reporting API kullanıma sunuldu. Yeni API, Özel raporlar oluşturmak ve verileri raporlama uygulamalarınıza entegre etmek için daha fazla esneklik ve süreçler. Yeni Search Ads 360 Reporting'e geçme ve bu hizmeti kullanma hakkında daha fazla bilgi edinin. API.

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
}
Not: Tarihler konusunda dikkatli olun. Üç aylık rapor almak istiyorsanız raporun timeRange tüm çeyreği kapsar. Aksi takdirde yalnızca kısmi sonuçlar alırsınız. Bu durum, kullanıcılar tıklama ve gelir gibi değerlerde büyük bir düşüş olduğunu düşünebilir.

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 ve quarterEnd 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.