> ## Documentation Index
> Fetch the complete documentation index at: https://docs.notifly.tech/llms.txt
> Use this file to discover all available pages before exploring further.

# Share Linkガイド

> Share Linkでキャンペーンとユーザージャーニーの統計をGoogleスプレッドシートに取り込めます。

Share LinkはGoogleスプレッドシートなどの外部ツールで使えるCSV形式で統計を取得できます。キャンペーンとユーザージャーニーの指標を、イベントが発生した日ごとに確認できます。

## Googleスプレッドシートに連携する

数式を入力する前に、[日付形式と集計対象に関する注意事項](#注意事項)を確認します。

連携するプロダクトを開き、サイドバーの**設定**から**製品とプロジェクト情報**を選びます。**プロジェクト情報**の**プロジェクトID**をコピーします。

1. Googleスプレッドシートを作成します。

2. データを取り込むセルに次の数式を貼り付け、`<project_id>` をコピーしたプロジェクトIDに置き換えます。

   ```
   =IMPORTDATA("https://api.notifly.tech/v1/projects/<project_id>/statistics.csv")
   ```

3. 確認が表示されたら、**アクセスを許可**をクリックして外部URLからデータを取得できるようにします。

4. [期間とタグのパラメーター](#期間とタグのパラメーター)で、取得するデータを絞り込めます。

## CSVの項目

| 項目名 | 例 | 説明 | 補足 |
| - | - | - | - |
| date | "22/10/2025" | イベントの発生日（韓国標準時、KST） | CSVでは `DD/MM/YYYY` 形式で出力します。Googleスプレッドシートで文字列として読み込まれた場合は、日付形式に変更する前にシートの地域設定を確認してください。 |
| resource\_type | "campaign" | リソースの種類（`campaign` または `user_journey`） | |
| resource\_id | "cmp123" | リソースID | |
| resource\_name | "新規登録のお礼" | リソース名 | |
| node\_id | "node12" | ユーザージャーニーのメッセージノードID | キャンペーンでは空欄です。 |
| node\_name | "登録2日後の初回メッセージ" | ユーザージャーニーのメッセージノード名 | キャンペーンでは空欄です。 |
| variant\_id | "var123" | A/BテストのバリアントID | A/Bテストを行わないキャンペーンでは空欄です。 |
| variant\_name | "グループA" | A/Bテストのバリアント名 | A/Bテストを行わないキャンペーンでは空欄です。 |
| channel | "push-notification" | 配信チャネル | |
| channel\_subtype | "image" | 配信チャネルのサブタイプ | |
| brand\_message\_target | "M" | カカオブランドメッセージの配信対象タイプ | ブランドメッセージ以外のチャネルでは空欄です。 |
| tags | "프로모션" | キャンペーンのタグ一覧 | タグが複数ある場合はカンマで区切ります。タグを設定していない場合は空欄です。 |
| message\_sent | 1200 | 配信成功数 | メッセージの配信成功数です。アプリ内ポップアップとWebポップアップでは、表示回数を集計します。 |
| message\_failed | 10 | 配信失敗数 | 配信に失敗したメッセージを数えます。未対応の場合は `0` です。 |
| delivered | 1150 | 到達確認数 | アプリプッシュとメールで確認された到達数です。送信処理に成功しても、端末や受信箱に届かないことがあります。集計できないチャネルでは、CSVに `0` が出力されます。 |
| click | 200 | クリック数 | アプリプッシュ、メール、ポップアップのメインボタン、対応するカカオトークチャネルのトラッキングリンクで発生したクリックを集計します。テキストメッセージなど、このCSVでクリックを集計しないチャネルは `0` になります。 |
| conversion\_1\_name | "구매" | コンバージョンイベント名 | コンバージョンイベントが発生しなかった場合は空欄です。 |
| conversion\_1\_type | "직접 전환" | コンバージョンの種類です。CSVには `전체 전환`（全体コンバージョン）、`직접 전환`（直接コンバージョン）、`전환 매출`（コンバージョン売上）のいずれかが入ります。 | 該当するコンバージョンがない場合は空欄です。直接コンバージョンは、クリック後の計測期間内に発生した対象イベントを集計します。全体コンバージョンには、クリックを伴わない対象イベントも含まれます。 |
| conversion\_1\_count | 20 | コンバージョンイベント数。コンバージョン売上の場合は売上の合計額です。 | コンバージョンイベントが発生しなかった場合は空欄です。 |

コンバージョンは最大10件を `conversion_1` から `conversion_10` に出力します。

### 期間とタグのパラメーター

| パラメーター | 説明 | 入力例 | 取得結果の例（2025-07-01 12:00 KST時点） |
| - | - | - | - |
| `start` & `end` | 日付の範囲を指定します。 | `=IMPORTDATA("https://api.notifly.tech/v1/projects/<project_id>/statistics.csv?start=2022-01-01&end=2022-03-01")` | 2022-01-01～2022-03-01 |
| `since` | 指定日以降のデータを取得します。 | `=IMPORTDATA("https://api.notifly.tech/v1/projects/<project_id>/statistics.csv?since=2025-05-01")` | 2025-05-01～2025-06-30 |
| `last` | 指定した日数、週数、または月数分の直近のデータを取得します。`timeUnit` の初期値は `day` です。 | `=IMPORTDATA("https://api.notifly.tech/v1/projects/<project_id>/statistics.csv?last=7")` | 2025-06-24～2025-06-30 |
| `timeUnit` | 期間の単位を `day`（初期値）、`week`、`month` から指定します。`last` または `offset` と組み合わせます。 | `=IMPORTDATA("https://api.notifly.tech/v1/projects/<project_id>/statistics.csv?last=4&timeUnit=week")` | 2025-06-03～2025-06-30 |
| `offset` | 指定した単位と数だけ、期間の基準日を前にずらします。`since` または `last` と併用します。`start` と `end` の指定には適用されません。 | `=IMPORTDATA("https://api.notifly.tech/v1/projects/<project_id>/statistics.csv?last=4&timeUnit=week&offset=4")` | 2025-05-06～2025-06-02 |
| `tag` | タグで絞り込みます。指定したタグのいずれかを含むキャンペーンが対象です（OR）。タグ指定時はユーザージャーニーを除外します。 | `=IMPORTDATA("https://api.notifly.tech/v1/projects/<project_id>/statistics.csv?tag=프로모션&tag=공지")` | `프로모션` または `공지` のいずれか、もしくは両方を含むキャンペーン |

デフォルトの取得期間は7日間です。期間を指定するには、`start` と `end` を組み合わせるか、`since` または `last` を使用します。1日分のデータを取得するには、`start` と `end` に同じ日付を指定します。

### 注意事項

> [!WARNING]
>
> 期間パラメーターの日付には `YYYY-MM-DD` 形式を使用します。形式が異なる日付はShare Linkで受け付けません。

> [!NOTE]
>
> 日別の統計は韓国標準時（KST、UTC+9）で集計します。

> [!NOTE]
>
> 前日分のデータは、午前7時（KST）以降に確認してください。

> [!NOTE]
>
> Share Linkに当日分のデータは含まれません。

> [!NOTE]
>
> イベントは発生した日に集計します。たとえば、7月23日に配信したメッセージを受信者が24日にクリックすると、配信は23日、クリックは24日に計上します。

### エラー

CSVが2 MBを超えると、Share Linkは次のメッセージを返します。取得期間を短くするか、タグで対象を絞ってから再度読み込んでください。

> [!NOTE]
>
> File size exceeds 2MB limit. Please try a shorter date range or filter by specific campaigns/tags.

### CSVダウンロードAPI

CSVをダウンロードするには、Googleスプレッドシートの数式に指定したShare LinkのURLを開きます。同じ期間とタグの条件が適用されます。詳しくは[メッセージ統計をCSVでエクスポートする](https://docs.notifly.tech/ja/api-reference/get-campaign-statistics-csv.md)をご覧ください。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.