API-raportointi: kattavuus, kiintiöt ja tiedon ikä

Tiivistelmä

Vastaus ja päättynyt ohjelma eivät todista kaikkien rivien noutoa. Rajat ja viiveet riippuvat rajapinnasta.

Kuvitteellinen esimerkki: havainto 08:00, saatavuus 08:10, poiminta 08:15 ja näyttö 08:20; tiedon ikä 20 minuuttia, poiminnan ikä 5 Menetelmäkaavio · vaiheet selitetään tekstissä
Tässä artikkelissa

Vastaus ja päättynyt ohjelma eivät todista kaikkien rivien noutoa. Rajat ja viiveet riippuvat rajapinnasta.

Tarkista poiminnan tulos

Tarkista aika, aikavyöhyke, suodattimet, kentät, sivutus ja metatiedot. GA4 Data API:n rowCount kuvaa kyselytuloksen kaikkia rivejä, ei vain yhtä sivua. Se ei todista kaiken todellisen toiminnan kattavuutta; noudata kiintiöitä ja kerro osapoiminnoista.

Erota neljä ajankohtaa

Kuvitteellinen esimerkki, sama päivä ja aikavyöhyke: havainto 08:00, saatavuus 08:10, poiminta 08:15, näyttö 08:20. Tieto on havainnosta 20 minuuttia vanhaa, poiminnasta vain 5. Lähdeviiveet ja välimuistit koskevat myös Data Studiota ja muita työkaluja.

Kuvitteellinen esimerkki: neljä eri ajankohtaa
KohtaAika
Havainto08:00
Saatavuus08:10
Poiminta08:15
Näyttö08:20

Lähteet ja tarkistus

Automatisoi poiminta täydellisyyden osoittavalla tavalla

Ilman teknisiä virheitä luodusta raportista voi silti puuttua tulossivuja tai käyttää eri suodatinta. Säilytä aikaikkuna, kaava ja sivutussäännöt ja tarkista sitten kokonaissummat ja kaksoiskappaleet. Valmistele ajanjakson toisto menettämättä muutoshistoriaa hiljaisesti.

  • Versiosuodattimet, ulottuvuudet, yksiköt, aikavyöhyke ja sivutus.
  • Vertaa poimittua näytettä lähteeseen samalla ajanjaksolla.
  • Toista keskeytetty poiminta ja tarkista häviöt ja kaksoiskappaleet.

Ensisijainen lähde: Google SRE — Data Processing Pipelines. Aiheeseen liittyvä menetelmä: lue käytännön opas.

Aikavyöhykkeet ja myöhäiset tapahtumat

Raportin ajanjakso riippuu tapahtuma-ajasta ja sulkemissäännöstä.

  • Kirjaa tapahtuma-aika, vastaanottoaika ja liiketoiminnan aikavyöhyke erikseen. Kuvitteellisessa esimerkissä 23:30 UTC on seuraavan päivän 01:30 kiinteällä UTC+02:00-siirtymällä. PostgreSQLin aikavyöhykkeen sisältävä aikaleima ei säilytä alkuperäistä vyöhykkeen nimeä.
  • Käytä mukaan kuuluvaa alkua ja pois jätettävää loppua. Muodosta rajat liiketoiminnan vyöhykkeessä ennen UTC-muunnosta. Testaa kesäaikaan siirtyminen, kuukauden vaihde ja päivämäärä ilman kellonaikaa; paikallista päivää ei voi aina korvata 24 tunnilla.
  • Määritä hyväksyttävä viive ja raportin sulkemisaika. Toista sama tunniste erottaaksesi uuden tapahtuman kaksoiskappaleesta. Säilytä julkaistu versio ja kirjaa korjauksen vaikutus; vesileima on arvio saapumisesta eikä lupaus kaikkien tietojen saapumisesta.

Toistettava hyväksyntätapaus

Kuvitteellinen esimerkki: tiedot eivät kuvaa asiakasta tai havaittua tulosta.

Näytä tapauksen tiedot
{
    "event_time": "2026-10-08T23:30:00Z",
    "report_zone": "UTC+02:00",
    "local_time": "2026-10-09T01:30:00+02:00"
}

Odotettu päätös

Tapahtuma kuuluu annetussa vyöhykkeessä 9. lokakuuta. Säilytä myös UTC-hetki.

Tarkistusmenettely

  1. Määritä raportin vyöhyke ja viitehetki.
  2. Toista tapahtuma lähellä keskiyötä.
  3. Säilytä UTC, paikallispäivä ja katkaisusääntö. Sisällytä kellonsiirron monitulkintainen paikallisaika; säilytä UTC-siirtymä ja aikavyöhyke sen sijaan, että päättelisit hetken.

PostgreSQL — Date/time types

Voiko vastaanottopäivää käyttää tapahtumapäivänä?

Vain jos raportin määritelmä sitä edellyttää. Säilytä molemmat ajat ja selitä myöhäisten tapahtumien käsittely.

Ensisijainen lähde: PostgreSQL — Date/time types. Aiheeseen liittyvä menetelmä: lue käytännön opas.