メインコンテンツまでスキップ

UTM アトリビューション

API レスポンスのコンテンツ URL には、リファラルトラフィックを追跡するための UTM パラメーターが含まれています。

2つの URL フィールド​

各コンテンツアイテムには2つの URL フィールドが提供されます:

フィールド用途UTM パラメーター
urlクリックスルートラッキング付与あり（utm_source, utm_medium, utm_campaign）
canonical_url表示・共有用なし（元の記事 URL）

使い分け​

  • url — ユーザーが記事を読むためにクリックスルーする際に使用します。UTM パラメーターにより、コンテンツパブリッシャーがアプリケーションからのトラフィックを追跡できます。
  • canonical_url — 表示目的（例: ドメイン名の表示）や、記事リンクの共有時に使用します。

UTM パラメーター​

パラメーター値説明
utm_sourceサイトドメイン（テナント設定から取得）トラフィックソースとしてアプリケーションを識別します
utm_mediumreferralトラフィックメディア
utm_campaignstoryhubキャンペーン識別子

例​

{
  "url": "https://example.com/article?utm_source=yoursite.com&utm_medium=referral&utm_campaign=storyhub",
  "canonical_url": "https://example.com/article"
}

utm_source は、テナント設定に登録された site_domain から自動的に設定されます。これにより、コンテンツパブリッシャーは自身のアナリティクスで、あなたのサービスからのリファラルトラフィックを識別できます。