Figma 用の Klaviyo プラグインの使用
このページで学べること
Figma 用の Klaviyo プラグインのインストール方法、Klaviyo アカウントの接続方法、Figma からデザインを Klaviyo の画像ライブラリに直接エクスポートする方法（キャンペーン、フロー、テンプレートですぐに使用可能）をご確認ください。
開始するための主な手順は以下の通りです：
- Figma に Klaviyo プラグインをインストールします。
- Klaviyo アカウントを接続します。
- フレームまたはレイヤーのバッチを Klaviyo 画像ライブラリにエクスポートします。
始める前に
必要なもの：
- 画像の管理と外部連携の承認を行えるKlaviyoアカウントです。オーナー、管理者、マネージャーのロールには、次の権限があります。
- Figma のデスクトップ アプリまたはブラウザ エディタを使用できる Figma アカウント。
プラグインをインストール
- Figma で任意のデザイン ファイルを開きます。
- プラグインメニューを開き、Figmaコミュニティで「Klaviyo」を検索してください。
- プラグインを実行します。初めて開くと、[アカウントを接続] ボタンがあるウェルカム画面が表示されます。
Klaviyo アカウントを接続する
- プラグインで、[アカウントを接続] をクリックします。ブラウザで Klaviyo の認証ページが開きます。
- Klaviyoにログインし（まだログインしていない場合）、接続するアカウントを選択して、要求されたアクセスを承認するために許可をクリックします。
- Figma に戻ります。プラグインは接続を自動的に検出し、[設定] タブにアカウントを表示します。
ブラウザウィンドウが開かない場合（または誤って閉じてしまった場合）は、ボタンをもう一度クリックして認証ページを再度開いてください。2 分以内に認証を完了しない場合、プラグインは待機を停止し、再試行するよう求めます。
デザインを Klaviyo にエクスポートする
- Figma キャンバス上でフレームまたはレイヤーを選択します。プラグインの [エクスポート] タブには、プレビューとデザインのサイズが表示されます。
- 必要に応じて、ファイル名を設定してください。空欄のままにすると、レイヤー名が使用されます。その名前がKlaviyoの画像ライブラリにすでに存在する場合、Klaviyoは既存の画像を置き換える代わりに、数値のサフィックスを追加します。
- サイズ（例：1x、2x、または固定幅）と形式（PNGまたはJPG）を選択します。各画像は10 MB以下で、5,000万ピクセル（幅×高さ）を超えないようにしてください。
- 複数のアカウントが接続されている場合は、エクスポート先のアカウントを選択してください。
- Klaviyoにエクスポートをクリックしてください。エクスポートが完了すると、画像はKlaviyoの画像ライブラリで利用できるようになります。Klaviyoで見つけるには、コンテンツ > メディア & ブランド > 画像に進みます。
複数のレイヤーを一度にエクスポート
一括エクスポートに切り替えるには、2 つ以上のレイヤーを選択してください。選択したレイヤーの一覧が寸法とともに表示され、共通のサイズと形式を設定するか、各レイヤー独自の設定を維持できます。詳細設定では、すべてのファイル名に接頭辞または接尾辞を追加したり、すべての名前を共通のベース名に置き換えたりすることもできます。進行状況バーで、アップロード中の一括処理を追跡します。
詳細なエクスポート設定
Figma でのエクスポートのレンダリング方法を調整するには、サイズと形式のセレクターの横にあるギア ボタンをクリックしてください：
- カラープロファイル — ドキュメントのカラープロファイル、sRGB、または Display P3 を使用してエクスポートします。
- [重なっているレイヤーを無視] — 重なっているものは除外して、選択したコンテンツのみをエクスポートします。
- 境界ボックスを含める — エクスポートにレイヤーの境界ボックス全体を含めます。
エクスポート履歴を表示
[履歴] タブには、アップロードごとにグループ化された過去のエクスポートが表示され、各アップロード済み画像にリンクするサムネイルが表示されます。タブの下部にある Klaviyo メディア ライブラリのリンクを使用して、ブラウザで画像ライブラリを開くか、[履歴をクリア] を選択してプラグインからリストを削除します（これにより Klaviyo から画像が削除されるわけではありません）。
接続したアカウントを管理
[設定] タブでアカウントを追加するか、横にあるごみ箱アイコンで削除できます。セキュリティ上の理由から、このプラグインは使用間で Klaviyo セッションを保存しません。プラグインを閉じて再度開くと、次回のエクスポートの前に再接続を求められる場合があります。
トラブルシューティング
- 「接続がタイムアウトしました。もう一度お試しください。」— 認証が時間内に完了しませんでした。[アカウントを接続]（または [アカウントを追加]）をクリックしてやり直してください。認証ページは毎回新しく開きます。
- 「Klaviyo セッションの有効期限が切れました。」— [設定] タブに移動してアカウントを再接続し、その後もう一度エクスポートしてください。
- バッチ内の一部のレイヤーをエクスポートできません — 成功したレイヤーは引き続きアップロードされ、履歴に記録されます。失敗したレイヤーがファイル内に残っていることを確認してから、それらを選択して再度エクスポートしてください。