GoogleアナリティクスAPIからの生涯値の取得

Question

GoogleアナリティクスAPIのドキュメントには、生涯値を取得するために日付範囲を指定しないことが示されています。しかし、私がそのような要求を（日付範囲なしで）行うと、空のディメンションとメトリックの結果が返されます。しかし、期間を使用すると、その期間のディメンションと指標の値が返されます。

次はAPI documentationからの抜粋です：

日付範囲は、コホートや生涯値 要求に対して指定することはできません。例えば

次のように私は、日付範囲ずに要求を行った場合、：私は日付の範囲を含める場合は、しかし、

{ 
"reports": [ 
    { 
    "columnHeader": { 
    "dimensions": [ 
    "ga:date", 
    "ga:eventLabel" 
    ], 
    "metricHeader": { 
    "metricHeaderEntries": [ 
     { 
     "name": "ga:totalEvents", 
     "type": "INTEGER" 
     } 
    ] 
    } 
    }, 
    "data": { 
    "totals": [ 
    { 
     "values": [ 
     "0" 
     ] 
    } 
    ] 
    } 
    } 
] 
} 

：

{ 
"reportRequests": [ 
    { 
    "viewId": "XXXXXXXXX", 
    "dimensions": [ 
    { 
    "name": "ga:date" 
    }, 
    { 
    "name": "ga:eventLabel" 
    } 
    ], 
    "metrics": [ 
    { 
    "expression": "ga:totalEvents" 
    } 
    ] 
    } 
] 
} 

私は、次の応答を取得、

{ 
"reportRequests": [ 
    { 
    "viewId": "XXXXXXXX", 
    "dimensions": [ 
    { 
    "name": "ga:date" 
    }, 
    { 
    "name": "ga:eventLabel" 
    } 
    ], 
    "metrics": [ 
    { 
    "expression": "ga:totalEvents" 
    } 
    ], 
    "dateRanges": [ 
    { 
    "startDate": "2016-01-01", 
    "endDate": "2016-04-30" 
    } 
    ] 
    } 
] 
} 

応答以下の彼：

{ 
"reports": [ 
    { 
    "columnHeader": { 
    "dimensions": [ 
    "ga:date", 
    "ga:eventLabel" 
    ], 
    "metricHeader": { 
    "metricHeaderEntries": [ 
     { 
     "name": "ga:totalEvents", 
     "type": "INTEGER" 
     } 
    ] 
    } 
    }, 
    "data": { 
    "rows": [ 
    { 
     "dimensions": [ 
     "20160412", 
     "http://mytestblog.com/" 
     ], 
     "metrics": [ 
     { 
     "values": [ 
     "1" 
     ] 
     } 
     ] 
    }, 
    { 
     "dimensions": [ 
     "20160412", 
     "http://mytestblog.com/2016/04/first-post.html" 
     ], 
     "metrics": [ 
     { 
     "values": [ 
     "3" 
     ] 
     } 
     ] 
    }, 
    { 
     "dimensions": [ 
     "20160419", 
     "http://mytestblog.com/" 
     ], 
     "metrics": [ 
     { 
     "values": [ 
     "4" 
     ] 
     } 
     ] 
    }, 
    { 
     "dimensions": [ 
     "20160419", 
     "http://mytestblog.com/2016/04/fourth.html" 
     ], 
     "metrics": [ 
     { 
     "values": [ 
     "13" 
     ] 
     } 
     ] 
    } 
    ], 
    "totals": [ 
    { 
     "values": [ 
     "21" 
     ] 
    } 
    ], 
    "rowCount": 4, 
    "minimums": [ 
    { 
     "values": [ 
     "1" 
     ] 
    } 
    ], 
    "maximums": [ 
    { 
     "values": [ 
     "13" 
     ] 
    } 
    ] 
    } 
    } 
] 
} 

なぜそれがマニュアルで指定されていても、私は値を取得するReportRequestで日付の範囲を指定する必要があり、ということでしょうか？ここで生涯価値の意味を誤解していますか？

Answer 1

オブジェクトは、dateRangesの値またはcohortGroupの値のいずれかを持つ必要があります。両方の要求を省略すると、startDateのデフォルト値は7daysAgoで、endDateはyesterdayとなります。

ドキュメントの正しい解釈は、reportRequestがコホートとLTV要求に対してdateRangeを定義してはならないということです。しかし、コホートや生涯価値の要求を行うには、コホートの定義を追加する必要があります。コメント@Mattため

POST https://analyticsreporting.googleapis.com/v4/reports:batchGet 
{ 
    "reportRequests": [ 
    { 
     "viewId": "XXXX", 
     "dimensions": [ 
      {"name": "ga:cohort" }, 
      {"name": "ga:cohortNthWeek" }], 
     "metrics": [ 
      {"expression": "ga:cohortTotalUsersWithLifetimeCriteria"}, 
      {"expression": "ga:cohortRevenuePerUser"} 
     ], 
     "cohortGroup": { 
      "cohorts": [{ 
       "name": "cohort 1", 
       "type": "FIRST_VISIT_DATE", 
       "dateRange": { 
        "startDate": "2015-08-01", 
        "endDate": "2015-09-01" 
       } 
      }, 
      { 
       "name": "cohort 2", 
       "type": "FIRST_VISIT_DATE", 
       "dateRange": { 
        "startDate": "2015-07-01", 
        "end_date": "2015-08-01" 
       } 
      }], 
      "lifetimeValue": True 
     } 
    }] 
    }