LOOVサポートサイト

【Google スプレッドシート連携】LOOVの視聴履歴をGoogleスプレッドシートに毎日自動で書き出すことはできますか?

はい。可能です。

この設定を一度行うだけで、毎朝決まった時間に最新の視聴データがスプレッドシートへ自動追加されるようになります。

注意事項

API連携機能は、一部のプランのみご利用可能となります。

ご利用をご希望の方は、サポート担当者までお問い合わせください。

  • 全自動反映:LOOVの視聴履歴データがスプレッドシートに自動で貯まります。

  • 定時更新:毎日決まった時刻に自動更新(初期設定は朝 9:00。1日に複数回の更新も可能です)。

  • 詳細なデータ項目:以下の項目が自動で取り込まれます。

項目

説明

時刻

視聴した日時

再視聴

2回目以降の視聴かどうか

リード情報

組織名、氏名、メールアドレス

アクション

URLパラメータ、CTAクリック、フォーム回答、シナリオ通知など

LOOVの管理画面から、以下の2つの情報をコピーしてメモ帳などに貼り付けておいてください。

  1. APIキー:

    [管理画面] > [API連携] メニューから取得できます

  1. 動画シナリオID:

    LOOV動画編集画面URL内の

    https://service.loov-video.com/scenario?id= [xxx] の[xxx] 箇所がシナリオIDです。

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

  2. シート名を「LOOV視聴履歴連携」など分かりやすい名前に変更します。

  1. 上部メニューの [拡張機能] > [Apps Script] をクリックします。

  2. 開いた画面に最初からある文字をすべて削除して、空にします。

  1. 以下のコードをすべてコピーして、画面に貼り付けます。

JavaScript

  1. コード上部の const CONFIG = { ... } 内を書き換えます。

⚠️【必須設定】ここを変えないと動きません

項目名

書き換え内容

API_KEY

"" の間に自分のAPIキーを貼り付け

SCENARIO_ID

"" の間に動画のシナリオIDを貼り付け

💡【お好み設定】運用に合わせて自由に変更OK

項目名

内容

初期設定

変更例・メリット

TRIGGER_HOURS

更新時刻・回数

[9]

[9, 18] にすれば朝晩の1日2回更新されます。

INITIAL_FETCH

初回の取得日数

30

90 にすれば過去3ヶ月分を一気に取得できます。

SHEET_NAME

シートのタブ名

"LOOV視聴履歴"

"動画データ一覧" など好きな名前に変えられます。

自動更新の時間について

Googleの仕様により、設定時刻から前後15分程度のズレが生じる場合があります(例:9:00設定なら8:45〜9:15の間に実行)。これは正常な動作です。

  1. 画面上の [保存(フロッピーアイコン)] をクリックします。

  1. 実行ボタンの隣にあるドロップダウンから [シートを初期化] を選択します。

  1. [実行(再生ボタン)] をクリックします。

「承認が必要です」という画面が出た場合画面の指示に従って「許可」してください。

※「このアプリは確認されていません」と出た場合は、[詳細] > [〇〇(安全ではないページ)に移動] をクリックすれば進めます。

  • 設定した時刻(例:毎日 9:00 頃)に、新しい視聴履歴が自動で追記されます。

  • 既存のデータ(視聴後にアクションが増えた場合など)も最新の状態に自動更新されます。

  1. 「API エラー(403)」が出る: お使いのプランでAPI連携が有効になっていない可能性があります。LOOV担当者へご確認ください。

  2. データが表示されない: 指定したシナリオに過去30日以内の視聴データがあるか確認してください。ない場合は INITIAL_FETCH_DAYS を大きくして再度「初期化」を試してください。

  3. 時間を変更したいTRIGGER_HOURS の数字を書き換えて保存し、再度 「シートを初期化」 を実行してください。古いスケジュールが自動で削除され、新しい時間で再設定されます。