CSV アップロードを使用してジオフェンシングをインポートする方法

このページで学べること

CSV ファイルをアップロードして、複数のジオフェンス ロケーションを Klaviyo にインポートする方法をご確認ください。

目次

CSV アップロードでジオフェンシングをインポートするには：

1. CSV ファイルを作成。
2. CSV ファイルをアップロード。
3. インポート履歴を確認。

CSV ファイルを作成

アップロードする前に、正しい形式の CSV ファイルを用意する必要があります。ファイル内の各行は、1 つのジオフェンスの場所を表します。すべての場所には、次の列が必要です：

• 名前
• 住所 OR 緯度 と 経度

次のオプション列も含めることができます：

• 半径 — ジオフェンス エリアのサイズ（メートル）
• 説明
• ステータス — アクティブ または 非アクティブ；ジオフェンスがイベントのトリガーに対して有効になっているかどうか
• 入力 — true または false；プロファイルがジオフェンスに入ったときにイベントをトリガーするかどうか
• Exit — true or false；プロファイルがジオフェンスを退出したときにイベントをトリガーするかどうか

インポートフローから、事前にフォーマットされたテンプレートを直接ダウンロードできます。オーディエンス > ジオフェンシング > 場所をインポート に移動し、独自のテンプレートを作成 を選択します。表示されるモーダルで含めたい列を選択し、ダウンロード を選択します。ダウンロードしたファイルを Excel や Google Sheets などの任意のスプレッドシートツールで開き、位置情報データを入力します。その後、ファイルを .csv として保存します。.text/csv、または.applications/csv。

CSV ファイルをアップロード

ファイルの準備ができたら：

1. [オーディエンス] > [ジオフェンシング] に移動します。
2. [ロケーションをインポート] を選択します。
3. ジオフェンシングを作成するための場所をアップロード 画面で、ファイルをアップロード エリアにドラッグ＆ドロップするか、[ファイルを選択] をクリックして参照してください。
4. ファイルが更新されたら、[次へ] を選択します。
5. CSV 列を Klaviyo のジオフェンスフィールドにマッピングします。

6. すべてのマッピングが正しく見える場合は、[次へ] を選択します。
7. CSV に含まれていない、または特定の行で空白になっているジオフェンス プロパティのデフォルト値を選択します。
   1. 画面右側の地図では、ジオフェンス半径の視覚的なプレビューを確認できます。地図の上にある検索バーにサンプル住所を入力して、実際の場所ではジオフェンスがどの程度の大きさで表示されるかをおおよそ確認できます。

8. デフォルトを設定したら、インポート を選択します。

インポート履歴を表示

インポートを開始すると、インポート履歴でステータスを追跡できます。各エントリには、インポートの日付と時刻、インポートされたロケーション数、および結果が表示されます：

• 完了 — すべてのロケーションが正常にインポートされました
• 部分的に完了 — 一部のロケーションはインポートされましたが、他は失敗しました。インポートされなかった行の CSV を取得するには、失敗した行をダウンロードを選択し、修正して再アップロードできます。
• 失敗 — インポートされたロケーションはありません

インポートにかかる時間は、ファイルのサイズに応じて数秒から数分の範囲になります。ページから移動しても、インポートはバックグラウンドで継続されます。

ベストプラクティス

• 場所名は、説明的で一貫性のあるものにしてください。Klaviyo は Name フィールドを主要な識別子として使用するため、明確な名前を付けると、後でジオフェンシングを管理しやすくなります。
• 建物の特定の入口や大規模な複合施設内の場所など、正確な位置が必要な場合は、Address, ではなく Latitude/Longitude 列を使用します。
• 大規模な一括インポートの前に、2～3 件のロケーションの小さなテストファイルから始めます。この方法により、完全なアップロードを実行する前に、列のマッピングとデフォルトが正しいことを確認できます。
• 部分的なインポートが発生した場合は、失敗した行レポートを確認してください。一般的な問題には、形式が正しくない住所、[ステータス] 列または [開始/終了] 列でサポートされていない値、または必須フィールドの欠落が含まれます。

達成できること

インポートが正常に完了すると、設定したステータスと設定とともに、ロケーションが Klaviyo の ロケーション セクションに表示されます。これらのジオフェンシングは、プロファイルのロケーションに基づいてメッセージをトリガーするために、フローとセグメントで使用できます。

その他のリソース