Zum Hauptinhalt springen
GET
/
marketing
/
v3
/
emails
/
statistics
/
histogram
集計された統計の間隔を取得します。
curl --request GET \
  --url https://api.hubapi.com/marketing/v3/emails/statistics/histogram \
  --header 'Authorization: Bearer <token>'
{
  "results": [
    {
      "aggregateStatistic": {
        "counters": {
          "bounce": 0,
          "click": 8,
          "contactslost": 0,
          "delivered": 704,
          "dropped": 1,
          "hardbounced": 0,
          "notsent": 1,
          "open": 443,
          "pending": 0,
          "selected": 705,
          "sent": 704,
          "softbounced": 0,
          "spamreport": 0,
          "suppressed": 0,
          "unsubscribed": 0
        },
        "deviceBreakdown": {
          "click_device_type": {
            "computer": 6,
            "mobile": 2,
            "unknown": 0
          },
          "open_device_type": {
            "computer": 44,
            "mobile": 8,
            "unknown": 391
          }
        },
        "qualifierStats": {},
        "ratios": {
          "bounceratio": 0,
          "clickratio": 1.136,
          "clickthroughratio": 1.806,
          "contactslostratio": 0,
          "deliveredratio": 100,
          "hardbounceratio": 0,
          "notsentratio": 0.142,
          "openratio": 62.926,
          "pendingratio": 0,
          "softbounceratio": 0,
          "spamreportratio": 0,
          "unsubscribedratio": 0
        }
      },
      "interval": {
        "end": "2020-06-01T04:00:00Z",
        "start": "2020-05-01T04:00:00Z"
      }
    },
    {
      "aggregations": {
        "counters": {
          "bounce": 1,
          "click": 0,
          "contactslost": 1,
          "delivered": 4,
          "dropped": 1,
          "hardbounced": 1,
          "notsent": 1,
          "open": 4,
          "pending": 0,
          "selected": 6,
          "sent": 5,
          "softbounced": 0,
          "spamreport": 0,
          "suppressed": 0,
          "unsubscribed": 0
        },
        "deviceBreakdown": {
          "click_device_type": {
            "computer": 0,
            "mobile": 0,
            "unknown": 0
          },
          "open_device_type": {
            "computer": 0,
            "mobile": 0,
            "unknown": 4
          }
        },
        "qualifierStats": {},
        "ratios": {
          "bounceratio": 20,
          "clickratio": 0,
          "clickthroughratio": 0,
          "contactslostratio": 20,
          "deliveredratio": 80,
          "hardbounceratio": 20,
          "notsentratio": 16.667,
          "openratio": 100,
          "pendingratio": 0,
          "softbounceratio": 0,
          "spamreportratio": 0,
          "unsubscribedratio": 0
        }
      },
      "interval": {
        "end": "2020-07-01T04:00:00Z",
        "start": "2020-06-01T04:00:00Z"
      }
    },
    {
      "aggregations": {
        "counters": {},
        "deviceBreakdown": {},
        "qualifierStats": {},
        "ratios": {}
      },
      "interval": {
        "end": "2020-07-02T00:00:00Z",
        "start": "2020-07-01T04:00:00Z"
      }
    }
  ],
  "total": 3
}
次のいずれかの製品またはそれ以上が必要です。
Marketing HubMarketing Hub -無料ツール
Sales HubSales Hub -無料ツール
Service HubService Hub -無料ツール
Content HubContent Hub -無料ツール
この API には、次のいずれかのスコープが必要です。
content

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Query Parameters

​
interval
enum<string>

統計を集計する間隔。

Available options:
YEAR,
QUARTER,
MONTH,
WEEK,
DAY,
HOUR,
QUARTER_HOUR,
MINUTE,
SECOND
​
startTimestamp
string

期間の開始タイムスタンプ (ISO8601形式）。

​
endTimestamp
string

期間の終了タイムスタンプ (ISO8601形式）。

​
emailIds
integer[]

EメールのIDで絞り込みます。これらのIDを持つメールの統計のみが含まれます。

Response

successful operation

Response object for collections of EmailStatisticIntervals.

​
total
integer
required

オブジェクトの合計数

​
results
object[]
required

オブジェクトのコレクション。

⌘I