Özellikle de çözümünüzün esnek ve raporunuzda seçtiğiniz gerçek boyutlar ve metriklerden bağımsız olmasını istiyorsanız, rapor yanıtının hazırlanması kolay bir işlem değildir.
Neyse ki rapor yanıtı oldukça eksiksiz ve birçok faydalı bilgi içeriyor.
Üst bilgiler
Belirli bir metriğin nasıl biçimlendirileceğini seçmek için başlıklarda döndürülen bilgileri kullanabilirsiniz. Bu rapor, metriğin türü, örneğin para birimi, oran veya tutar olup olmadığı ve parasal bir değerse hangi para birimi olduğu gibi bilgiler içerir.
Örnek:
"headers": [ { "name": "MONTH", "type": "DIMENSION" }, { "name": "CLICKS", "type": "METRIC_TALLY" }, { "name": "EARNINGS", "type": "METRIC_CURRENCY", "currency": "USD" }, { "name": "AD_REQUESTS_COVERAGE", "type": "METRIC_RATIO" } ]
Satırlar
Asıl rapor sonuçlarını buradan alırsınız. Her yanıt satırı, seçtiğiniz boyutlara göre farklı anlamlara sahip olan bir rapor satırını temsil eder.
"rows": [ { "cells": [ {"value": "2021-01"}, {"value": "278"}, {"value": "63.12"}, {"value": "0.9998"} ], [ {"value": "2021-02"}, {"value": "39"}, {"value": "8.46"}, {"value": "0.9998"} ] } ]
Toplamlar ve ortalamalar
Bir rapor çalıştırdığınızda, uygun her metrik için bir değer içeren totals
ve averages
yardımcı program dizilerini de geri alırsınız.
"totals": { "cells": [ {}, {"value": "317"}, {"value": "71.58"}, {"value": "0.9998"} ] }, "averages": { "cells": [ {}, {"value": "158"}, {"value": "71.58"}, {"value": "0.9998"} ] }
Başlangıç ve bitiş tarihleri
Göreli tarihler kullanıyorsanız, bazen hesaplanan başlangıç ve bitiş tarihlerinin ne olduğunu bilmek yararlı olabilir.
"startDate": {"year": 2021, "month": 1, "day": 1}, "endDate": {"year": 2021, "month": 2, "day": 28}