二、快速上手:環境配置與授權

  1. 啟用 API

  2. 創建服務賬號

  3. 設置環境變量

    export GOOGLE_APPLICATION_CREDENTIALS="/path/to/credentials.json"
  4. 安裝 SDK

    pip install google-analytics-data google-api-python-client

三、核心 API:runReport 方法實戰

3.1 拉取基礎流量指標

from google.analytics.data_v1beta import BetaAnalyticsDataClient
from google.analytics.data_v1beta.types import RunReportRequest, DateRange, Dimension, Metric

client = BetaAnalyticsDataClient()
request = RunReportRequest(
    property="properties/123456789",
    date_ranges=[DateRange(start_date="2025-07-01", end_date="2025-07-31")],
    dimensions=[Dimension(name="sessionDefaultChannelGroup")],
    metrics=[Metric(name="sessions"), Metric(name="pageViews"), Metric(name="bounceRate")],
)
response = client.run_report(request)
for row in response.rows:
    print(f"{row.dimension_values[0].value}: Sessions={row.metric_values[0].value}, "
          f"PageViews={row.metric_values[1].value}, BounceRate={row.metric_values[2].value}%")

3.2 轉化率評估示例

from google.analytics.data_v1beta.types import FilterExpression, Filter

request.metrics.append(Metric(name="eventCount"))
request.dimension_filter = FilterExpression(
    filter=Filter(field_name="eventName", string_filter={"value": "purchase"})
)
response = client.run_report(request)
for row in response.rows:
    sessions = int(row.metric_values[0].value)
    purchases = int(row.metric_values[1].value)
    cr = purchases / sessions * 100 if sessions else 0
    print(f"{row.dimension_values[0].value}: CR={cr:.2f}%")

四、關鍵詞表現:Search?Console?API 使用

4.1 拉取查詢數據

from googleapiclient.discovery import build

sc = build('searchconsole', 'v1', credentials=creds)
response = sc.searchanalytics().query(
    siteUrl='https://www.example.com',
    body={
        "startDate": "2025-07-01",
        "endDate": "2025-07-31",
        "dimensions": ["query", "page"],
        "rowLimit": 200
    }
).execute()

for row in response.get('rows', []):
    query, page = row['keys']
    clicks = row['clicks']; imp = row['impressions']
    ctr = row['ctr']; pos = row['position']
    print(f"{query} → {page}: Clicks={clicks}, Impressions={imp}, CTR={ctr:.2%}, AvgPos={pos:.2f}")

4.2 流量—轉化全鏈路分析

將 GA4 Data API 獲取的 sessions 與 GSC API 獲取的 impressions/ctr 按 pagequery 聚合,實現 SEO 深度洞察。


五、批量報告與自動化管道

  1. 批量導出

  2. 數據存儲

  3. ETL 處理

  4. 可視化呈現

  5. 自動告警

> 長尾關鍵詞:batchRunReports?大規模導出、BigQuery?SEO?數據倉庫、Looker?Studio?SEO?儀表盤、自動告警 SEO


六、最佳實踐與優化策略


七、總結與下一步

本文系統化介紹了 Analytics?SEO?API 的入門與實戰使用:

  1. 環境配置:啟用 API、服務賬號權限、SDK 安裝。
  2. 核心接口runReport、batchRunReports 用于流量與轉化數據獲取。
  3. 關鍵詞分析:Search?Console?API 拉取查詢與排名數據。
  4. 自動化管道:BigQuery、Looker?Studio、自動告警的整合方案。
  5. 優化策略:內容、長尾詞、結構化數據與 A/B 測試落地。

下一步可拓展:

立即動手,用 Analytics?SEO?API 打造高效、可擴展的數據驅動 SEO 優化體系!

上一篇:

Web Analytics API 的入門教程與使用指南

下一篇:

如何使用 SerpAPI 獲取 Google 搜索結果
#你可能也喜歡這些API文章!

我們有何不同?

API服務商零注冊

多API并行試用

數據驅動選型,提升決策效率

查看全部API→
??

熱門場景實測,選對API

#AI文本生成大模型API

對比大模型API的內容創意新穎性、情感共鳴力、商業轉化潛力

25個渠道
一鍵對比試用API 限時免費

#AI深度推理大模型API

對比大模型API的邏輯推理準確性、分析深度、可視化建議合理性

10個渠道
一鍵對比試用API 限時免費