注: この記事は英語から AI を使用して翻訳されており、若干の不正確な表現が含まれる場合があります。

開始する前に

一括アップロードは、Optmyzr からダウンロードしたサンプルファイルの正確な構造に従う必要があります。
列見出し、フォーマット、エンティティ固有のルールは厳密に検証されます。
読み取り専用または「NA」と表示されたセルは編集できません
フィールドを空欄のままにしても、変更は行われません。システムは既存の値を考慮します。
サンプルファイルには実際の最新の Optmyzr データが含まれており、ダミーデータではありません。最新の値を取得するには、いつでも再ダウンロードできます。

サンプルデータのダウンロード

一括アップロードのオプションでは、以下が可能です。

1. アカウント属性

2. 即時の予算変更

3. 将来の日付の予算変更

一括アップロードのオプションのサイドトレイの上部に「サンプルデータをダウンロード」オプションが表示されます。

サンプルファイルに含めるエンティティの選択

サンプルファイルをダウンロードする前に、アカウントおよび/または予算グループのどちらを使用するかを選択する必要があります。 （現在、ポートフォリオの一括更新には対応していません。）

この選択によって、以下が決まります。

どの列に値が入力されるか
どの検証やチェックが適用されるか

ダウンロードされるファイルには、選択したエンティティのみが含まれます。これにより、現在更新したい内容と、入力すべき列を把握しやすくなります。

ダウンロードされたファイルには、Optmyzr にすでに保存されているライブデータが含まれています。現在の目標予算、通貨、既存の属性、今後の予算変更が反映されます。データが変更された場合は、ファイルを再度ダウンロードする必要があります。

ファイル構造の要件

最初の行には列見出しが必要です
見出しの名前はサンプルファイルと完全に一致している必要があります
ファイルは CSV 形式である必要があります
最大ファイルサイズ：10 MB
各行は一意である必要があります

見出しが欠落または変更されたファイルをアップロードすると、エラーが発生します。

Google スプレッドシートを使用して変更をアップロードする場合は、Optmyzr がそのシートにアクセスできるようにしてください。以下のアドレスと共有（閲覧権限）する必要があります。

optmyzr-data-integrations@dataintegrations-398709.iam.gserviceaccount.com。

ファイル内の列について

サンプルファイルに表示される列について、以下で説明します。

1. タイプ：エンティティの種類（アカウントまたは予算グループ）を示します

2. 予算グループID：このフィールドは予算グループに必須です。アカウントの場合、通常このフィールドは空ですが、アカウントIDが入力されている場合はそのまま受け付けられます。無作為な値や無効な値を入力するとエラーが発生します

3. 名前：このフィールドには、アカウントまたは予算グループの名前が表示されます

4. アカウント/ポートフォリオID：これは、アカウントIDまたは予算グループの親アカウント/ポートフォリオのIDです

5. アカウントタイプ：アカウントのプラットフォームを指定します — Google Ads、Microsoft Ads、Amazon Ads、Yahoo Japan、Facebook Ads、およびポートフォリオ。プラットフォーム名は、スペースや大文字・小文字も含め、ここに記載されている通りに正確に入力する必要があります。

6. 通貨：エンティティに関連付けられた通貨を表示する読み取り専用フィールドです

7. 目標予算：予算の設定、更新、削除に使用します。システムは英語（標準）の数値形式のみを受け付けます。

有効な値：

123.34
123,345
12334.34 （区切り文字のない生の数値）

無効な値：

123.345 （あいまいな形式）
123,34 （誤った小数形式）

注意点：

桁区切り文字にはカンマ（ , ）を使用してください
小数点にはピリオド（ . ）を使用してください
スペースや地域固有の数値形式は使用しないでください

この形式が重要な理由：

一部の数値形式は、言語によって異なる解釈をされます。

例えば：

一部の地域では、1.345 は「千三百四十五」を意味します
英語形式では、1.345 は「1点345」を意味します

誤った予算の更新を避けるため、アップロードされたすべての値は英語の数値形式で解釈されます。

アップロード後、値は選択したページの言語に基づいて表示されますが、入力形式は常に英語の標準に従う必要があります。

8. 予算サイクル：予算サイクルの期間（月次）を表示します

9. サイクル日：予算サイクルの定期的な更新日を表します。アカウントの場合、サイクル日は1から30の間の数値で入力する必要があります。予算グループの場合、値は1以外にすることはできません。

10. 予算開始日：この列では、Optmyzr が設定された目標を反映し始める日付を設定できます。予算開始日の形式は、1-January-2026、January、または January-2026 とすることができます。

注：当月を入力した場合、開始日はデフォルトで本日になります。将来の月を入力した場合、デフォルトでその月の1日になります。

11. オーナー：アカウントのオーナーのメールアドレスを表示します。

12. タグ：アカウントに関連付けられたタグは、この列に表示されます。ここから更新できますが、次の正確な形式に従う必要があります： ['tag1', 'tag2', 'tag3']

タグのリストを角括弧で囲んでください
シングルクォートを使用してください
タグはカンマで区切ってください

13. メモ：アカウントに関連付けられたメモを表示するテキストフィールドです

14. 備考：この列は情報提供のみを目的とし、特別な条件を示します。例えば、エンティティにすでに将来の日付の予算変更がある場合、この列でそれが示されます。「今すぐ予算を更新」オプションを使用してそのようなエンティティを更新しようとすると、エラーが発生します。代わりに、これらの場合は「将来の日付の予算を設定」オプションを使用する必要があります。

この列の内容を変更しても、シートのアップロード時には反映されません。

エンティティ固有の動作

一括アップロードファイルは、Optmyzr からダウンロードしたサンプルファイルの正確な構造に従う必要があります。

以下の表では、各列について、どのエンティティに適用されるか、編集可能かどうか、また予算やその他の属性の更新に適用されるか、将来の日付の予算設定に適用されるかを説明します。

列名	アカウント	予算グループ	編集可能	予算やその他の属性の更新、または将来の日付の予算設定への適用
タイプ	✅	✅	いいえ	両方
予算グループID	❌	✅	いいえ	両方
名前	✅	✅	はい。ただし今すぐ予算やその他の属性を更新する場合のみです。将来の日付の予算を設定する際は読み取り専用の列になります。	両方
アカウント/ポートフォリオID	✅	✅	いいえ	両方
アカウントタイプ	✅	✅	いいえ	両方
通貨	✅	✅	いいえ	両方
目標予算	✅	✅	はい	両方
予算サイクル	✅	✅	はい	両方
サイクル日	✅	✅	はい。ただし今すぐ予算やその他の属性を更新する場合のみです。将来の日付の予算を設定する際は読み取り専用の列になります。	両方
予算開始日	✅	✅	はい	将来の日付の予算を設定
オーナー	✅	❌	はい。ただし今すぐ予算やその他の属性を更新する場合のみです。将来の日付の予算を設定する際は適用されません。	今すぐ予算やその他の属性を更新
タグ	✅	❌	はい。ただし今すぐ予算やその他の属性を更新する場合のみです。将来の日付の予算を設定する際は適用されません。	今すぐ予算やその他の属性を更新
メモ	✅	❌	はい。ただし今すぐ予算やその他の属性を更新する場合のみです。将来の日付の予算を設定する際は適用されません。	今すぐ予算やその他の属性を更新
備考	✅	✅	いいえ	両方

削除できる列

目標予算やメモなど、特定の列データは削除でき、アカウントに反映されます。データを削除するには、該当する行と列に <DELETE> と入力してください。削除コマンドは、上記の形式に正確に従う必要があります。

どの属性や列を削除できるかについては、以下のリストを参照してください：

1. 今すぐ予算やその他の属性を更新

サイクル日 - 削除すると1に設定されます。既存のトラッカーがある場合、サイクル日の削除はできません。
目標予算 - 目標予算を削除すると、トラッカーも削除され、トリガーされたアラートもクローズされます。アカウントまたは予算グループにすでに将来のエントリが存在する場合、目標予算の編集または削除はできません。
タグ - エンティティタイプがアカウントの場合、タグを編集または削除できます。この列は予算グループではサポートされていません。
メモ - エンティティタイプがアカウントの場合、メモを編集または削除できます。この列は予算グループではサポートされていません。

2. 将来の日付の予算を設定

将来の日付の予算を設定する場合、編集可能なのは目標予算のみで、有効日が本日の場合は削除できません。

エラーの確認

変更を適用する前に、行を次のように分類したプレビュー画面が表示されます：

変更のある有効な行
変更のない有効な行
エラーのある行

変更のある有効な行のみが適用されます。エラーのある行は編集して、ファイルを再アップロードできます。

一括アップロードのオプションの完全なユーザーガイドはこちらからご覧いただけます。

一括アップロードのオプション - ガイドライン