はい。可能です。
この設定を一度行うだけで、毎朝決まった時間に最新の視聴データがスプレッドシートへ自動追加されるようになります。
注意事項
API連携機能は、一部のプランのみご利用可能となります。
ご利用をご希望の方は、サポート担当者までお問い合わせください。
全自動反映:LOOVの視聴履歴データがスプレッドシートに自動で貯まります。
定時更新:毎日決まった時刻に自動更新(初期設定は朝 9:00。1日に複数回の更新も可能です)。
詳細なデータ項目:以下の項目が自動で取り込まれます。
項目 | 説明 |
時刻 | 視聴した日時 |
再視聴 | 2回目以降の視聴かどうか |
リード情報 | 組織名、氏名、メールアドレス |
アクション | URLパラメータ、CTAクリック、フォーム回答、シナリオ通知など |
LOOVの管理画面から、以下の2つの情報をコピーしてメモ帳などに貼り付けておいてください。
APIキー:
[管理画面] > [API連携] メニューから取得できます
動画シナリオID:
LOOV動画編集画面URL内の
https://service.loov-video.com/scenario?id= [xxx] の[xxx] 箇所がシナリオIDです。
Google スプレッドシートで新しいシートを作成します。
シート名を「LOOV視聴履歴連携」など分かりやすい名前に変更します。
上部メニューの [拡張機能] > [Apps Script] をクリックします。
開いた画面に最初からある文字をすべて削除して、空にします。
以下のコードをすべてコピーして、画面に貼り付けます。
コード上部の
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の間に実行)。これは正常な動作です。
画面上の [保存(フロッピーアイコン)] をクリックします。
実行ボタンの隣にあるドロップダウンから [シートを初期化] を選択します。
[実行(再生ボタン▶)] をクリックします。
「承認が必要です」という画面が出た場合画面の指示に従って「許可」してください。
※「このアプリは確認されていません」と出た場合は、[詳細] > [〇〇(安全ではないページ)に移動] をクリックすれば進めます。
設定した時刻(例:毎日 9:00 頃)に、新しい視聴履歴が自動で追記されます。
既存のデータ(視聴後にアクションが増えた場合など)も最新の状態に自動更新されます。
「API エラー(403)」が出る: お使いのプランでAPI連携が有効になっていない可能性があります。LOOV担当者へご確認ください。
データが表示されない: 指定したシナリオに過去30日以内の視聴データがあるか確認してください。ない場合は
INITIAL_FETCH_DAYSを大きくして再度「初期化」を試してください。時間を変更したい:
TRIGGER_HOURSの数字を書き換えて保存し、再度 「シートを初期化」 を実行してください。古いスケジュールが自動で削除され、新しい時間で再設定されます。