pp-amazon-ads について
pp-amazon-ads は、Amazon Ads の広告主や販売者向けの Printing Press CLI スキルです。広告レポートの分析や利益計算を行い、データが一致する場合は販売データも組み合わせます。
主な機能
- 01損益分岐 ACOS と実利益の計算
- 02キャンペーンと商品レポートの分析
- 03広告費と販売データの結合
- 04CSV、TSV、API レポートファイルへの対応
活用シーン
- 01広告費控除後の商品利益の評価
- 02キャンペーン指標の比較
- 03販売データ一致時の ASIN 別 ACOS と TACOS の確認
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ mvanhorn/ printing-press-library --skill pp-amazon-adsインストール後、Claude Code で/pp-amazon-adsを入力して読み込まれたか確認します。
詳細
Amazon Ads — Printing Press CLI
前提条件:CLI をインストールする
このスキルは amazon-ads-pp-cli バイナリを使用します。**このスキルのコマンドを実行する前に、CLI がインストールされていることを必ず確認してください。**インストールされていない場合は、先にインストールしてください。
- Printing Press インストーラーを使用してインストールします。バイナリの既定のインストール先は、macOS/Linux では
$HOME/.local/bin、Windows では%LOCALAPPDATA%\Programs\PrintingPress\binです。npx -y @mvanhorn/printing-press-library install amazon-ads --cli-only - 確認します:
amazon-ads-pp-cli --version - 表示されたインストール先が、このスキルを実行するエージェント/ランタイムの
$PATHに含まれていることを確認します。
npx によるインストールに失敗した場合(Node がない、オフラインなど)は、Go を直接インストールする方法に切り替えてください(Go 1.26.6 以降が必要です)。
go install github.com/mvanhorn/printing-press-library/library/commerce/amazon-ads/cmd/amazon-ads-pp-cli@latest
インストール後に --version で「command not found」と表示される場合、ランタイムからバイナリのディレクトリを $PATH 経由で参照できません。確認に成功するまで、スキルのコマンドを実行しないでください。
まずはここから:収益性
オーガニックと広告の収益性を重視するセラーは、API 全体を確認する前に、次のコマンドを実行してください。
amazon-ads-pp-cli break-even-acos— 商品が赤字になる前に許容できる最大 ACOS を計算します。amazon-ads-pp-cli true-profit— COGS、Amazon 手数料の推定額、広告費を差し引いた後の商品利益を計算します。amazon-ads-pp-cli acos-vs-tacos --report product-performance.csv --seller-store ~/.config/amazon-seller-pp-cli/store.db— セラーストアに一致するデータがある場合、広告費とセラーストアの売上を結合し、ASIN ごとの ACOS と TACOS を計算します。amazon-ads-pp-cli portfolio-dashboard --report campaign-performance.csv— 広告費、売上、注文数、ACOS、CPC、CTR、CVR をまとめます。amazon-ads-pp-cli product-ad-profitability --report product-performance.csv --cogs-file products.toml— 広告の実績と COGS から ASIN ごとの利益を推定します。amazon-ads-pp-cli campaign-comparison --report campaign-performance.csv— 広告費、売上、ACOS、CPC、CTR、CVR に基づいてキャンペーンを比較します。
コマンドで --report を指定するよう求められた場合は、amazon-ads-pp-cli reports recipe <command> を使用してください。必要なレポートの種類、必須列、エクスポート先、ヘッダーのサンプルが表示されます。スキーマを考慮したワークフローでは、コンソールからエクスポートした CSV/TSV と Ads API の JSON/GZIP レポート成果物に対応しています。
acos-vs-tacos は、セラーストアのデータと広告レポートが重複する場合に、広告費とセラーストアの売上を結合し、ASIN ごとの TACOS を計算します。オーガニックセッション、コンバージョン率、親/子 ASIN の集計、返金、利益関連のコマンドに --cogs-file を指定しない場合の COGS、ポートフォリオごとの TACOS には、まだ対応していません。セラー側のダッシュボードワークフローについては、amazon-seller-pp-cli sales-intel dashboard で照合してください。
コマンドリファレンス
amazon-ads-dsp-dsp — amazon ads dsp dsp を管理します
amazon-ads-pp-cli amazon-ads-dsp-dsp get— 指定された広告主 ID に基づいて広告主情報を返します。amazon-ads-pp-cli amazon-ads-dsp-dsp list— フィルタリング条件に一致する広告主の一覧と情報を返します。
amazon-ads-profiles-profiles — amazon ads profiles profiles を管理します
amazon-ads-pp-cli amazon-ads-profiles-profiles get-by-id— 現在のアカウントで少なくとも 1 つのキャンペーンが作成されていない限り、この操作はレスポンスを返しません。amazon-ads-pp-cli amazon-ads-profiles-profiles list— 現在のアカウントで少なくとも 1 つのキャンペーンが作成されていない限り、この操作はレスポンスを返さないことに注意してください。amazon-ads-pp-cli amazon-ads-profiles-profiles update— この操作は Sponsored Products を利用するセラーのみを対象としていることに注意してください。
amazon-ads-sponsored-reports — amazon ads のスポンサー広告レポートを管理します
amazon-ads-pp-cli amazon-ads-sponsored-reports <reportId>— 以前POSTメソッドでリクエストしたレポートのレスポンスからreportIdの値を使用します。
assets — アセットを管理します
amazon-ads-pp-cli assets get— メタデータとともにアセットを取得しますamazon-ads-pp-cli assets get-upload-location— Creative Assets ツールにアセットをアップロードするための一時的なリソース(アップロード先)を作成します。amazon-ads-pp-cli assets register—/asset/uploadAPI エンドポイントから提供された場所にアセットをアップロードした後、この API を呼び出します。amazon-ads-pp-cli assets search— アセットを検索します
attribution — アトリビューションを管理します
amazon-ads-pp-cli attribution get-advertisers-by-profile— セラーの場合、アトリビューションプロファイルには関連付けられた広告主が 1 つあります。amazon-ads-pp-cli attribution get-publisher-macro-tag— 一部のサードパーティパブリッシャーは、マクロパラメーターを含むタグをサポートしていません。amazon-ads-pp-cli attribution get-publisher-tag-template— Google Ads、Facebook、Microsoft Ads などのサードパーティパブリッシャーamazon-ads-pp-cli attribution get-publishers— このレスポンスを使って、タグを取得する際に macroTags と nonMacroTemplateTags のどちらのリソースを使うか判断しますamazon-ads-pp-cli attribution get-tags-by-campaign— 指定した広告主のリストのアトリビューションレポートを取得します。
audiences — オーディエンスを管理します
amazon-ads-pp-cli audiences fetch-taxonomy— 指定したカテゴリパスのオーディエンスカテゴリのリストを返します 次の権限のいずれかが必要ですamazon-ads-pp-cli audiences list— 広告主のオーディエンスセグメントのリストを返します。
benchmarks — ベンチマークを管理します
amazon-ads-pp-cli benchmarks get-brands— 広告アカウントが SB キャンペーンでプロモーションしたブランドのリストを取得します **次のいずれかが必要ですamazon-ads-pp-cli benchmarks get-report-data— エンティティがアクセスできるすべてのブランドとカテゴリの指標の概要を提供します。amazon-ads-pp-cli benchmarks get-time-series— オプションのパラメーターでフィルタリングした、指定したブランドとカテゴリの時系列データを提供します **次のいずれかが必要です
billing — 請求を管理します
amazon-ads-pp-cli billing bulk-get-notifications— 各広告アカウントに関連付けられた、現在有効なすべての請求通知の配列を取得します。amazon-ads-pp-cli billing bulk-get-status— 各広告アカウントに関連付けられた現在の請求ステータスを取得します。
brands — ブランドを管理します
amazon-ads-pp-cli brands— ヘッダーで渡されたプロファイル ID に関連付けられたブランドの Brand データオブジェクトの配列を取得します。
currencies — 通貨を管理します
amazon-ads-pp-cli currencies— ヘッダーの広告主識別子を使用して、対象マーケットプレイスで使用されるローカライズされた通貨の配列を取得します
dp — dp を管理します
amazon-ads-pp-cli dp create— 新しいデータプロバイダーオーディエンスを作成します。API 呼び出しのレートは 1 秒あたり 1 トランザクション(TPS)に制限されていることに注意してください。amazon-ads-pp-cli dp get— 識別子で指定したオーディエンスのメタデータを取得します。amazon-ads-pp-cli dp update— レコードをオーディエンスに関連付ける、または関連付けを解除します。amazon-ads-pp-cli dp update-audiencemetadata— 識別子で指定した既存のオーディエンスのメタデータを更新します。amazon-ads-pp-cli dp update-users— クライアントを元に取得されたユーザーデータを削除します。API 呼び出しのレートは 1 秒あたり 1 トランザクション(TPS)に制限されています。
dsp — dsp を管理します
-
amazon-ads-pp-cli dsp associate-line-items-to-creatives— ラインアイテムとクリエイティブの関連付けを作成または削除します。注意:startDate、endDate、weight は渡さないでください。 -
amazon-ads-pp-cli dsp create-file-uploads-policy— AWS S3 へのファイルアップロードに使用するファイルアップロードポリシーを作成します。ファイルアップロードポリシーの有効期限は15分です。 -
amazon-ads-pp-cli dsp create-image-creative— 画像クリエイティブを作成します。注意:今後のアップデートで、複数の画像クリエイティブを一度に作成する機能が追加されます。 -
amazon-ads-pp-cli dsp create-line-items— ラインアイテムを作成します。注意:今後のアップデートで、複数のラインアイテムを一度に作成する機能が追加されます。 -
amazon-ads-pp-cli dsp create-orders— オーダーを作成します。注意:今後のアップデートで、複数のオーダーを一度に作成する機能が追加されます。 -
amazon-ads-pp-cli dsp create-rec-creatives— 新しい Responsive eCommerce Creatives(REC)を作成します。 -
amazon-ads-pp-cli dsp create-third-party-creative— サードパーティークリエイティブを作成します。 -
amazon-ads-pp-cli dsp create-video-creatives— 動画クリエイティブを作成します。注意:今後のアップデートで、複数の動画クリエイティブを一度に作成する機能が追加されます。 -
amazon-ads-pp-cli dsp export-products-by-order-id— 識別子を指定してコンバージョントラッキング商品をファイルにエクスポートします。ファイルのURLの有効期限は15分です。 -
amazon-ads-pp-cli dsp get-apps— アプリIDまたはテキストクエリに基づいてアプリを取得します。アプリIDとテキストクエリのいずれか一方を指定できますが、両方は指定できません。 -
amazon-ads-pp-cli dsp get-conversion-trackings— 指定したオーダーのコンバージョントラッキング情報を取得します。 -
amazon-ads-pp-cli dsp get-creative-moderation— creativeId を指定してクリエイティブのモデレーション概要を取得します。 -
amazon-ads-pp-cli dsp get-creatives— 1つ以上のクリエイティブを取得します。 -
amazon-ads-pp-cli dsp get-domain-targeting— 1つ以上のラインアイテムのドメインターゲティング情報を取得します。 -
amazon-ads-pp-cli dsp get-domains— エンティティに基づいて、包含または除外するドメインリストを取得します。リストは作成日時順に並べ替えられます。 -
amazon-ads-pp-cli dsp get-dv-custom-contextual-segments— Double Verify とすでに連携しているアカウントの、カスタムコンテキストセグメントの入札前ターゲティングデータを取得します。 -
amazon-ads-pp-cli dsp get-geo-locations— locationTargetingId または都市名、郵便番号などのテキストクエリに基づいて、locationTargeting オブジェクトを取得します。 -
amazon-ads-pp-cli dsp get-goal-configurations— 希望するキャンペーン目標に合わせて最適化するため、オーダーに適用できる設定の一覧を取得します。 -
amazon-ads-pp-cli dsp get-iab-content-categories— IAB コンテンツカテゴリの階層を取得します。リストはIDの昇順に並べ替えられます。 -
amazon-ads-pp-cli dsp get-image-creatives— リクエストで指定された条件に一致する画像クリエイティブを取得します。 -
amazon-ads-pp-cli dsp get-line-item— 識別子で指定したラインアイテムの完全な情報を取得します。 -
amazon-ads-pp-cli dsp get-line-items— 1つ以上のラインアイテムの基本情報を取得します。 -
amazon-ads-pp-cli dsp get-odc-custom-predicts— Oracle Data Cloud とすでに連携しているアカウントの、カスタム予測による入札前ターゲティングデータを取得します。 -
amazon-ads-pp-cli dsp get-odc-standard-predicts— Oracle Data Cloud が提供する、入札前ターゲティング用の標準予測を取得します。 -
amazon-ads-pp-cli dsp get-order— 識別子で指定したオーダーの完全な情報を取得します。 -
amazon-ads-pp-cli dsp get-orders— 1つ以上のオーダーの基本情報を取得します。 -
amazon-ads-pp-cli dsp get-pixels— フィルターに基づいてピクセルの一覧を取得します。AdvertiserIdFilter の指定が必要です。 -
amazon-ads-pp-cli dsp get-pixels-by-order-id— 識別子を指定してコンバージョントラッキングピクセルを取得します。 -
amazon-ads-pp-cli dsp get-product-categories— 商品カテゴリオブジェクトの階層を取得します。リストはIDの昇順に並べ替えられます。 -
amazon-ads-pp-cli dsp get-products-by-order-id— 識別子を指定してコンバージョントラッキング商品を取得します。 -
amazon-ads-pp-cli dsp get-rec-creatives— リクエストで指定された条件に一致する Responsive eCommerce Creative(REC)を取得します。 -
amazon-ads-pp-cli dsp get-supply-sources— ラインアイテムのタイプ、広告主、供給元のタイプに基づいて供給元を取得します。 -
amazon-ads-pp-cli dsp get-third-party-creatives— リクエストで指定された条件に一致するサードパーティークリエイティブを取得します。 -
amazon-ads-pp-cli dsp get-video-creatives— リクエストで指定された条件に一致する動画クリエイティブを取得します。 -
amazon-ads-pp-cli dsp list-line-item-creative-associations— 指定された条件で絞り込んだクリエイティブの関連付けの配列を取得します。 -
amazon-ads-pp-cli dsp preview-image-creative— 画像クリエイティブをプレビューします。 -
amazon-ads-pp-cli dsp preview-rec-creative— Responsive eCommerce Creative(REC)をプレビューします。 -
amazon-ads-pp-cli dsp preview-third-party-creative— サードパーティークリエイティブをプレビューします。 -
amazon-ads-pp-cli dsp preview-video-creative— 動画クリエイティブをプレビューします。 -
amazon-ads-pp-cli dsp set-line-item-status— 指定したラインアイテムIDの配信有効化ステータスを設定します。バージョン2.xのラインアイテムは `application/vnd. -
amazon-ads-pp-cli dsp set-order-status— 指定したオーダーIDの配信有効化ステータスを設定します。 -
amazon-ads-pp-cli dsp update— オーダーのコンバージョントラッキング商品を追加または削除します。 -
amazon-ads-pp-cli dsp update-conversion-tracking— オーダーのコンバージョントラッキング情報を追加または削除します。 -
amazon-ads-pp-cli dsp update-domain-targeting— 指定したラインアイテムの DomainTargeting を、リクエスト本文で指定された内容に置き換えます。 -
amazon-ads-pp-cli dsp update-image-creative— 画像クリエイティブを更新します。注意:今後のアップデートで、複数の画像クリエイティブを一度に更新する機能が追加されます。 -
amazon-ads-pp-cli dsp update-line-item-creative-associations— 関連付けの詳細を更新します。このAPIは startDate、endDate、weight パラメーターの更新に使用します。 -
amazon-ads-pp-cli dsp update-line-items— 部分的なパッチではなく、全体を更新します。 -
amazon-ads-pp-cli dsp update-orders— 部分的なパッチではなく、全体を更新します。 -
amazon-ads-pp-cli dsp update-pixels-by-order-id— オーダーのコンバージョントラッキングピクセルを追加または削除します。ピクセルリストの最大サイズは100です。 -
amazon-ads-pp-cli dsp update-rec-creatives— 既存の Responsive eCommerce Creatives(REC)を更新します。注意:今後のアップデートで、複数を一度に更新する機能が追加されます。 -
amazon-ads-pp-cli dsp update-third-party-creative— サードパーティークリエイティブを更新します。 -
amazon-ads-pp-cli dsp update-video-creatives— 動画クリエイティブを更新します。注意:今後のアップデートで、複数の動画クリエイティブを一度に更新する機能が追加されます。 dsp-reports-dsp — dsp レポートを管理 -
amazon-ads-pp-cli dsp-reports-dsp create-report-v3— Amazon DSP キャンペーンの指標を含むレポートの作成をリクエストします。 -
amazon-ads-pp-cli dsp-reports-dsp get-campaign-report-v3— 以前にリクエストしたレポートの識別子をreportIdフィールドに渡すと、レポートの現在のステータスを取得できます。
eligibility — 適格性を管理
amazon-ads-pp-cli eligibility product— 一連の商品に対する広告適格性オブジェクトの一覧を取得します。amazon-ads-pp-cli eligibility program— 広告主が広告プログラムの利用資格を有しているか確認します。
history — 履歴を管理
amazon-ads-pp-cli history— 指定されたイベントソースのうち、指定したフィルターと期間に一致する変更履歴を返します。
hsa — hsa を管理
insights — インサイトを管理
amazon-ads-pp-cli insights generate-brand-metrics-report— Brand Metrics レポートを CSV または JSON 形式で生成します。amazon-ads-pp-cli insights get-brand-metrics-report— 指標を利用できるブランドのレポートの場所とステータスを取得します。
invoices — 請求書を管理
amazon-ads-pp-cli invoices get— 次の権限のいずれかが必要です:['nemo_transactions_view','nemo_transactions_edit']amazon-ads-pp-cli invoices get-advertiser— 次の権限のいずれかが必要です:['nemo_transactions_view','nemo_transactions_edit']
keywords — キーワードを管理
amazon-ads-pp-cli keywords— 指定したマーケットプレイスまたはロケールのローカライズされたキーワードを返します。
manager-accounts — マネージャーアカウントを管理
amazon-ads-pp-cli manager-accounts create— 新しい Amazon Advertising [マネージャーアカウント](https://advertising.amazon.com/help? を作成します。amazon-ads-pp-cli manager-accounts get-for-user— すべての[マネージャーアカウント](https://advertising.amazon.com/help? を返します。
measurement — 測定を管理
amazon-ads-pp-cli measurement cancel-studies— 既存の調査をキャンセルします。調査をキャンセルすると、再開できません。amazon-ads-pp-cli measurement check-planning-eligibility— すべてのベンダー製品について利用資格を確認します。次の権限のいずれかが必要です:[]amazon-ads-pp-cli measurement create-surveys— 新しい調査アンケートを作成します。次の権限のいずれかが必要です:[]amazon-ads-pp-cli measurement get-dspbrand-lift-study-result— DSP BRAND_LIFT 調査の結果を取得します。Accept ヘッダーで JSON リソースがリクエストされた場合、成功時に 200 のレスポンスを返します。amazon-ads-pp-cli measurement get-studies— studyIds または advertiserIds のリストを指定して、基本調査オブジェクトを取得します。次の権限のいずれかが必要です:[]amazon-ads-pp-cli measurement get-surveys— 指定したアンケート識別子または調査識別子を使って、1 件以上の調査アンケートを取得します。amazon-ads-pp-cli measurement omnichannel-metrics-brand-search— OMNICHANNEL_METRICS ベンダー製品で使用するブランドを検索します。次の権限のいずれかが必要です:[]amazon-ads-pp-cli measurement update-surveys— 測定アンケートを更新します。全体が更新されます。次の権限のいずれかが必要です:[]amazon-ads-pp-cli measurement vendor-product— サポート対象の測定ベンダー製品を一覧表示します。次の権限のいずれかが必要です:[]amazon-ads-pp-cli measurement vendor-product-policy— 指定したベンダー製品のポリシーを取得します。次の権限のいずれかが必要です:[]amazon-ads-pp-cli measurement vendor-product-survey-question-templates— 指定したベンダー製品のアンケート質問テンプレートを取得します。次の権限のいずれかが必要です:[]
measurement-dsp — DSP 測定を管理
amazon-ads-pp-cli measurement-dsp check-dspaudience-research-eligibility— ベンダー製品に対する DSP AUDIENCE_RESEARCH 調査タイプの適格性ステータスを確認します。amazon-ads-pp-cli measurement-dsp check-dspbrand-lift-eligibility— ベンダー製品に対する DSP BRAND_LIFT 調査タイプの適格性ステータスを確認します。amazon-ads-pp-cli measurement-dsp check-dspcreative-testing-eligibility— ベンダー製品に対する DSP CREATIVE_TESTING 調査タイプの適格性ステータスを確認します。amazon-ads-pp-cli measurement-dsp check-dspomnichannel-metrics-eligibility— ベンダー製品に対する DSP OMNICHANNEL_METRICS 調査タイプの適格性ステータスを確認します。amazon-ads-pp-cli measurement-dsp create-dspaudience-research-study— 新しい DSP AUDIENCE_RESEARCH 調査を作成します。次の権限のいずれかが必要です:[]amazon-ads-pp-cli measurement-dsp create-dspbrand-lift-studies— 新しい DSP BRAND_LIFT 調査を作成します。次の権限のいずれかが必要です:[]amazon-ads-pp-cli measurement-dsp create-dspcreative-testing-study— 新しい DSP CREATIVE_TESTING 調査を作成します。次の権限のいずれかが必要です:[]amazon-ads-pp-cli measurement-dsp create-dspomnichannel-metrics-studies— 新しい DSP OMNICHANNEL_METRICS 調査を作成します。次の権限のいずれかが必要です:[]amazon-ads-pp-cli measurement-dsp get-dspaudience-research-studies— 指定された調査 ID または広告主 ID を使用して、1 件以上の DSP AUDIENCE_RESEARCH 調査を取得します。amazon-ads-pp-cli measurement-dsp get-dspaudience-research-study-result— DSP AUDIENCE_RESEARCH 調査の結果を取得します。amazon-ads-pp-cli measurement-dsp get-dspbrand-lift-studies— 指定された調査 ID または広告主 ID を使用して、1 件以上の DSP BRAND_LIFT 調査を取得します。amazon-ads-pp-cli measurement-dsp get-dspcreative-testing-studies— 指定された調査 ID または広告主 ID を使用して、1 件以上の DSP CREATIVE_TESTING 調査を取得します。amazon-ads-pp-cli measurement-dsp get-dspcreative-testing-study-result— DSP CREATIVE_TESTING 調査の結果を取得します。amazon-ads-pp-cli measurement-dsp get-dspomnichannel-metrics-studies— 指定された調査 ID または広告主 ID を使用して、1 件以上の DSP OMNICHANNEL_METRICS 調査を取得します。amazon-ads-pp-cli measurement-dsp get-dspomnichannel-metrics-study-result— DSP OMNICHANNEL_METRICS 調査の結果を取得します。amazon-ads-pp-cli measurement-dsp update-dspaudience-research-study— DSP AUDIENCE_RESEARCH 調査を更新します。全項目が更新されます。次の権限のいずれかが必要です:[]amazon-ads-pp-cli measurement-dsp update-dspbrand-lift-studies— DSP BRAND_LIFT 調査を更新します。全項目が更新されます。次の権限のいずれかが必要です:[]amazon-ads-pp-cli measurement-dsp update-dspcreative-testing-study— DSP CREATIVE_TESTING 調査を更新します。全項目が更新されます。次の権限のいずれかが必要です:[]amazon-ads-pp-cli measurement-dsp update-dspomnichannel-metrics-studies— DSP OMNICHANNEL_METRICS 調査を更新します。全項目が更新されます。次の権限のいずれかが必要です:[]
media — メディアを管理
amazon-ads-pp-cli media complete-upload— メディアが /media/upload API エンドポイントで指定された場所にアップロードされた後、この API を呼び出してください。amazon-ads-pp-cli media create-upload-resource— 広告プログラムのメディアをアップロードするための一時的なリソース(アップロード先)を作成します。amazon-ads-pp-cli media describe— メディアのステータスをポーリングする API です。
overlapping-audiences — 重複するオーディエンスを管理
amazon-ads-pp-cli overlapping-audiences <audienceId>— 次の権限のいずれかが必要です:['advertiser_campaign_edit','advertiser_campaign_view']
page-asins — ページ ASIN を管理
amazon-ads-pp-cli page-asins— 出品者の場合、アドレスはストアページである必要があります。ベンダーはカスタムランディングページのアドレスも指定できます。
pre-moderation — 事前モデレーションを管理
amazon-ads-pp-cli pre-moderation— この API は、広告/ページのさまざまなコンポーネントを受け取り、それらを自動的に検証します。
商品 — 商品を管理します
amazon-ads-pp-cli product— 次のいずれかの権限が必要です:['advertiser_campaign_edit','advertiser_campaign_view']
商品一覧 — 商品を管理します
amazon-ads-pp-cli products— ソースマーケットプレイスの商品を、1 つ以上のターゲットマーケットプレイスにローカライズ(マッピング)します。
プロフィール — 認証済みアプリケーションで利用できる Amazon Ads プロフィールの一覧を表示します。
amazon-ads-pp-cli profiles— 現在の Login with Amazon 認証情報に関連付けられた広告プロフィールの一覧を表示します。
レポート — レポートを管理します
amazon-ads-pp-cli reports <reportId>— 非同期レポートの呼び出しフローを理解するための説明です。
sb — sb を管理します
-
amazon-ads-pp-cli sb archive-campaign— この操作は、status フィールドを 'archived' に設定する更新操作と同等です。 -
amazon-ads-pp-cli sb archive-keyword— この操作は、status フィールドを 'archived' に設定する更新操作と同等です。 -
amazon-ads-pp-cli sb archive-negative-keyword— この操作は、status フィールドを 'archived' に設定する更新操作と同等です。 -
amazon-ads-pp-cli sb archive-negative-target— 識別子で指定した除外ターゲットをアーカイブします。 -
amazon-ads-pp-cli sb archive-target— 識別子で指定したターゲットをアーカイブします。 -
amazon-ads-pp-cli sb create-campaigns— 注: 複数の広告グループを含むキャンペーンを作成するには、[version 4 POST campaigns](https://advertising.amazon. -
amazon-ads-pp-cli sb create-draft-campaigns— スポンサーブランドの下書きキャンペーンを作成します。**動画キャンペーンを作成するには、adFormat に 'video' を指定してください。 -
amazon-ads-pp-cli sb create-keywords— キーワードの作成時にstateは設定できません。 -
amazon-ads-pp-cli sb create-negative-keywords— 除外キーワードの作成時にbidとstateは設定できません。 -
amazon-ads-pp-cli sb create-negative-targets— 1 つ以上の除外ターゲットを作成します。 -
amazon-ads-pp-cli sb create-targets— 1 つ以上のターゲットを作成します。 -
amazon-ads-pp-cli sb delete-draft-campaign— この操作は、status フィールドを 'archived' に設定する更新操作と同等です。 -
amazon-ads-pp-cli sb get— このリソースは、US マーケットプレイスのキャンペーンでのみ利用できます。 -
amazon-ads-pp-cli sb get-ad-group— 識別子で指定した広告グループを取得します。 -
amazon-ads-pp-cli sb get-bids-recommendations— 指定したキーワードまたは商品リストの入札額推奨オブジェクトを取得します。 -
amazon-ads-pp-cli sb get-brand-recommendations— ブランドの提案は、リクエストで渡されたカテゴリ識別子またはキーワードのリストに基づいています。 -
amazon-ads-pp-cli sb get-campaign— 識別子で指定したキャンペーンを取得します。 -
amazon-ads-pp-cli sb get-draft-campaign— 識別子で指定した下書きキャンペーンを取得します。 -
amazon-ads-pp-cli sb get-keyword— 識別子で指定したキーワードを取得します。 -
amazon-ads-pp-cli sb get-negative-keyword— 識別子で指定した除外キーワードを取得します。 -
amazon-ads-pp-cli sb get-negative-target— 識別子で指定した除外ターゲットを取得します。 -
amazon-ads-pp-cli sb get-product-recommendations— 推奨内容は、リクエストで渡された ASIN に基づいています。 -
amazon-ads-pp-cli sb get-target— 識別子で指定したターゲットを取得します。 -
amazon-ads-pp-cli sb get-targeting-categories— 推奨内容は、リクエストで渡された ASIN に基づいています。 -
amazon-ads-pp-cli sb list-ad-groups— 認可ヘッダーで渡されたクライアント識別子に関連付けられた広告グループの配列を取得します -
amazon-ads-pp-cli sb list-campaigns— 注: すべてのキャンペーンデータを取得するには、[version 4 list campaigns endpoint](https://advertising. -
amazon-ads-pp-cli sb list-draft-campaigns— 認可ヘッダーで渡されたクライアント識別子に関連付けられたすべての下書きキャンペーンの配列を取得します -
amazon-ads-pp-cli sb list-keywords— オプションの条件で絞り込んだキーワードの配列を取得します。 -
amazon-ads-pp-cli sb list-negative-keywords— オプションの条件で絞り込んだ除外キーワードの配列を取得します。 -
amazon-ads-pp-cli sb list-negative-targets— 認可ヘッダーで渡されたクライアント識別子に関連付けられた商品除外ターゲットのリストを取得します -
amazon-ads-pp-cli sb list-targets— 認可ヘッダーで渡されたクライアント識別子に関連付けられた商品ターゲットのリストを取得します -
amazon-ads-pp-cli sb submit-draft-campaign— 送信が成功すると -
amazon-ads-pp-cli sb update-campaigns— 変更可能なフィールド -
amazon-ads-pp-cli sb update-draft-campaigns— 1 つ以上の下書きキャンペーンを更新します。 -
amazon-ads-pp-cli sb update-keywords— 更新対象として送信されたキーワードは、モデレーション審査のために state がpendingに設定される場合があります。モデレーションには最大 72 時間かかることがあります。 -
amazon-ads-pp-cli sb update-negative-keywords— 更新対象として送信された除外キーワードは、モデレーション審査のために state がpendingに設定される場合があります。 -
amazon-ads-pp-cli sb update-negative-targets— 1 つ以上の除外ターゲットを更新します。 -
amazon-ads-pp-cli sb update-targets— 1 つ以上のターゲットを更新します。 sd — Manage sd -
amazon-ads-pp-cli sd archive-ad-group— status フィールドを「archived」に設定する更新操作と同等です。 -
amazon-ads-pp-cli sd archive-campaign— status フィールドを「archived」に設定する更新操作と同等です。 -
amazon-ads-pp-cli sd archive-negative-targeting-clause— ターゲティング句のstateプロパティを設定するために、updateNegativeTargetingClauses 操作を使用するのと同等です。 -
amazon-ads-pp-cli sd archive-product-ad— status フィールドを「archived」に設定する更新操作と同等です。 -
amazon-ads-pp-cli sd archive-targeting-clause— ターゲティング句のstateプロパティを設定するために、updateTargetingClauses操作を使用するのと同等です。 -
amazon-ads-pp-cli sd associate-optimization-rules-with-ad-group— 識別子で指定した広告グループに、1 つ以上の最適化ルールを関連付けます。 -
amazon-ads-pp-cli sd create-ad-groups— 1 つ以上の広告グループを作成します。 -
amazon-ads-pp-cli sd create-brand-safety-deny-list-domains— Brand Safety Deny List に追加するドメインを 1 つ以上作成します。Brand Safety Deny List は広告主レベルに設定されます。 -
amazon-ads-pp-cli sd create-campaigns— 1 つ以上のキャンペーンを作成します。 -
amazon-ads-pp-cli sd create-creatives— 1 つ以上のクリエイティブを POST リクエストで作成します。 -
amazon-ads-pp-cli sd create-negative-targeting-clauses— 正常に作成された広告グループに関連付けられた除外ターゲティング句には、一意のターゲット識別子が割り当てられます。 -
amazon-ads-pp-cli sd create-optimization-rules— この操作はプレビュー専用です。この機能が利用可能になった時点で、この注記は削除されます。 -
amazon-ads-pp-cli sd create-product-ads— 1 つ以上の商品広告を作成します。 -
amazon-ads-pp-cli sd create-sdforecast— SD 予測リクエストで指定された広告グループの予測を返します。 -
amazon-ads-pp-cli sd create-targeting-clauses— 正常に作成されたターゲティング句には、一意のtargetId値が割り当てられます。 -
amazon-ads-pp-cli sd delete-brand-safety-deny-list— Brand Safety Deny List 内のすべてのドメインをアーカイブします。 -
amazon-ads-pp-cli sd disassociate-optimization-rule— この操作はプレビュー専用です。この機能が利用可能になった時点で、この注記は削除されます。 -
amazon-ads-pp-cli sd download-snapshot— **非同期スナップショットの呼び出しフローについて理解するには -
amazon-ads-pp-cli sd get— この操作はプレビュー専用です。この機能が利用可能になった時点で、この注記は削除されます。 -
amazon-ads-pp-cli sd get-ad-group— 指定したキャンペーンの AdGroup オブジェクトを返します。 -
amazon-ads-pp-cli sd get-ad-group-response-ex— 指定した広告グループの拡張情報を取得します。 -
amazon-ads-pp-cli sd get-adgroups— この操作はプレビュー専用です。この機能が利用可能になった時点で、この注記は削除されます。 -
amazon-ads-pp-cli sd get-campaign— 指定したキャンペーンの Campaign オブジェクトを返します。 -
amazon-ads-pp-cli sd get-campaign-response-ex— 指定したキャンペーンの CampaignResponseEx オブジェクトを返します。 -
amazon-ads-pp-cli sd get-negative-targets— この呼び出しは、除外ターゲティング句の最小限のフィールドセットを返しますが、getNegativeTargetsEx より効率的です。 -
amazon-ads-pp-cli sd get-negative-targets-ex— 拡張フィールドを含む除外ターゲティング句を取得します。 -
amazon-ads-pp-cli sd get-product-ad— ProductAd オブジェクトはパフォーマンス向けに設計されていることに注意してください -
amazon-ads-pp-cli sd get-product-ad-response-ex— 商品広告の拡張情報を取得します。 -
amazon-ads-pp-cli sd get-request-results— ユーザーが Brand Safety Deny List にドメインを追加すると、リクエストは非同期で処理されます -
amazon-ads-pp-cli sd get-request-status— ユーザーが Brand Safety Deny List を変更すると、リクエストは非同期で処理されます -
amazon-ads-pp-cli sd get-snapshot— **非同期スナップショットの呼び出しフローについて理解するには -
amazon-ads-pp-cli sd get-target-bid-recommendations— 入力された広告対象 ASIN と同じターゲティング句のリストに基づいて、入札額の推奨リストを提供します -
amazon-ads-pp-cli sd get-target-recommendations— この API は、入力された ASIN のリストに基づいて、ターゲットにする商品とカテゴリーの推奨を提供します。 -
amazon-ads-pp-cli sd get-targets— この呼び出しは、ターゲティング句の最小限のフィールドセットを返します。 -
amazon-ads-pp-cli sd get-targets-ex— 拡張フィールドを含むターゲティング句オブジェクトを取得します。 -
amazon-ads-pp-cli sd list-ad-groups— 指定した Sponsored Display 広告グループの AdGroup オブジェクトの配列を取得します。 -
amazon-ads-pp-cli sd list-ad-groups-ex— 指定した広告グループの AdGroupResponseEx オブジェクトの配列を取得します。 -
amazon-ads-pp-cli sd list-campaigns— 指定した Sponsored Display キャンペーンの Campaign オブジェクトの配列を取得します。 -
amazon-ads-pp-cli sd list-campaigns-ex— 指定したキャンペーンの CampaignResponseEx オブジェクトの配列を取得します。 -
amazon-ads-pp-cli sd list-creative-moderations— クリエイティブの審査のリストを取得します -
amazon-ads-pp-cli sd list-creatives— クリエイティブのリストを取得します -
amazon-ads-pp-cli sd list-domains— 広告主の Brand Safety Deny List に登録されているウェブサイト/アプリの配列を取得します。 -
amazon-ads-pp-cli sd list-negative-targeting-clauses— 指定した Sponsored Display の除外ターゲットについて、除外ターゲティング句オブジェクトのリストを取得します。 -
amazon-ads-pp-cli sd list-negative-targeting-clauses-ex— 指定した除外ターゲットの NegativeTargetingClauseEx オブジェクトの配列を取得します。 -
amazon-ads-pp-cli sd list-optimization-rules— この操作はプレビュー専用です。この機能が利用可能になった時点で、この注記は削除されます。 -
amazon-ads-pp-cli sd list-product-ads— 指定した Sponsored Display 商品広告の ProductAd オブジェクトの配列を取得します。 -
amazon-ads-pp-cli sd list-product-ads-ex— 指定した広告グループの ProductAdResponseEx オブジェクトの配列を取得します。 -
amazon-ads-pp-cli sd list-request-status— すべての Brand Safety List リクエストのステータスを一覧表示します。過去 90 日間に送信されたリクエストが一覧に含まれます。 -
amazon-ads-pp-cli sd list-targeting-clauses— 指定した Sponsored Display ターゲットのターゲティング句オブジェクトのリストを取得します。 -
amazon-ads-pp-cli sd list-targeting-clauses-ex— 指定したターゲットの TargetingClauseEx オブジェクトの配列を取得します。 -
amazon-ads-pp-cli sd post-creative-preview— クリエイティブのプレビュー HTML を取得します。 -
amazon-ads-pp-cli sd update-ad-groups— 1 つ以上の広告グループを更新します。 -
amazon-ads-pp-cli sd update-campaigns— 1 つ以上のキャンペーンを更新します。 -
amazon-ads-pp-cli sd update-creatives— 1 つ以上のクリエイティブを更新します。 -
amazon-ads-pp-cli sd update-negative-targeting-clauses— 1 つ以上の除外ターゲティング句を更新します。除外ターゲティング句は targetId を使用して識別されます。 -
amazon-ads-pp-cli sd update-optimization-rules— この操作はプレビュー専用です。この機能が利用可能になった時点で、この注記は削除されます。 -
amazon-ads-pp-cli sd update-product-ads— 1 つ以上の商品広告を更新します。 -
amazon-ads-pp-cli sd update-targeting-clauses— 1 つ以上のターゲティング句を更新します。ターゲティング句は targetId を使用して識別されます。 sp — Manage sp -
amazon-ads-pp-cli sp archive-ad-group— 広告グループのステータスをarchivedに設定します。アーカイブされたエンティティを再び有効にすることはできません。 -
amazon-ads-pp-cli sp archive-campaign— キャンペーンのステータスをarchivedに設定します。アーカイブされたエンティティを再び有効にすることはできません。 -
amazon-ads-pp-cli sp archive-campaign-negative-keyword— 指定したキャンペーンのネガティブキーワードのステータスをarchivedに設定します。 -
amazon-ads-pp-cli sp archive-keyword— 指定したキーワードのステータスをarchivedに設定します。 -
amazon-ads-pp-cli sp archive-negative-keyword— 指定したネガティブキーワードのステータスをarchivedに設定します。 -
amazon-ads-pp-cli sp archive-negative-targeting-clause— ネガティブターゲティング句のstatusをarchivedに設定します。 -
amazon-ads-pp-cli sp archive-product-ad— 指定した商品広告の状態をarchivedに設定します。 -
amazon-ads-pp-cli sp archive-targeting-clause— ターゲティング句のstatusをarchivedに設定します。 -
amazon-ads-pp-cli sp bulk-get-asin-suggested-keywords— 推奨キーワードは、効果の高い順に並んだ配列で返されます。 -
amazon-ads-pp-cli sp create-ad-groups— 1つ以上の広告グループを作成します。 [PLANNED DEPRECATION 6/30/2023] -
amazon-ads-pp-cli sp create-campaign-negative-keywords— 1つ以上のキャンペーンのネガティブキーワードを作成します。 [PLANNED DEPRECATION 6/30/2023] -
amazon-ads-pp-cli sp create-campaigns— 1つ以上のキャンペーンを作成します。 [PLANNED DEPRECATION 6/30/2023] -
amazon-ads-pp-cli sp create-keyword-bid-recommendations— **非推奨に関するお知らせ:このエンドポイントは2022年12月31日に非推奨になります。 -
amazon-ads-pp-cli sp create-keywords— 1つ以上のキーワードを作成します。 [PLANNED DEPRECATION 6/30/2023] -
amazon-ads-pp-cli sp create-negative-keywords— 1つ以上のネガティブキーワードを作成します。 [PLANNED DEPRECATION 6/30/2023] -
amazon-ads-pp-cli sp create-negative-targeting-clauses— 1つ以上のネガティブターゲティング表現を作成します。 [PLANNED DEPRECATION 6/30/2023] -
amazon-ads-pp-cli sp create-product-ads— 1つ以上の商品広告を作成します。 [PLANNED DEPRECATION 6/30/2023] -
amazon-ads-pp-cli sp create-target-recommendations— **非推奨に関するお知らせ:このエンドポイントは2023年2月28日に非推奨になります。 -
amazon-ads-pp-cli sp create-targeting-clauses— 1つ以上のターゲティング表現を作成します。 [PLANNED DEPRECATION 6/30/2023] -
amazon-ads-pp-cli sp download-snapshot— **非同期スナップショットの呼び出しフローについて -
amazon-ads-pp-cli sp get-ad-group— 識別子で指定した広告グループを取得します。 [PLANNED DEPRECATION 6/30/2023] -
amazon-ads-pp-cli sp get-ad-group-bid-recommendations— **非推奨に関するお知らせ:このエンドポイントは2022年12月31日に非推奨になります。 -
amazon-ads-pp-cli sp get-ad-group-ex— 拡張データフィールドを持つ広告グループを取得します。 [PLANNED DEPRECATION 6/30/2023] -
amazon-ads-pp-cli sp get-ad-group-suggested-keywords— 指定した広告グループの推奨キーワードを取得します。 -
amazon-ads-pp-cli sp get-ad-group-suggested-keywords-ex— 指定した広告グループの拡張データ付き推奨キーワードを取得します。 -
amazon-ads-pp-cli sp get-ad-groups— 1つ以上の広告グループを取得します。 [PLANNED DEPRECATION 6/30/2023] -
amazon-ads-pp-cli sp get-ad-groups-ex— 拡張データフィールドを持つ広告グループを取得します。 [PLANNED DEPRECATION 6/30/2023] -
amazon-ads-pp-cli sp get-asin-suggested-keywords— 推奨キーワードは、効果の高い順に並んだ配列で返されます。 -
amazon-ads-pp-cli sp get-bid-recommendations— キーワード、商品、または自動ターゲティング表現の入札額の推奨リストを取得します。 -
amazon-ads-pp-cli sp get-campaign— 識別子で指定したキャンペーンを取得します。 [PLANNED DEPRECATION 6/30/2023] -
amazon-ads-pp-cli sp get-campaign-ex— 拡張データフィールドを持つキャンペーンを取得します。 [PLANNED DEPRECATION 6/30/2023] -
amazon-ads-pp-cli sp get-campaign-negative-keyword— 識別子で指定したキャンペーンのネガティブキーワードを取得します。 [PLANNED DEPRECATION 6/30/2023] -
amazon-ads-pp-cli sp get-campaign-negative-keyword-ex— 拡張データフィールドを持つキャンペーンのネガティブキーワードを取得します。 [PLANNED DEPRECATION 6/30/2023] -
amazon-ads-pp-cli sp get-keyword— 識別子で指定したキーワードを取得します。 [PLANNED DEPRECATION 6/30/2023] -
amazon-ads-pp-cli sp get-keyword-bid-recommendations— **非推奨に関するお知らせ:このエンドポイントは2022年12月31日に非推奨になります。 -
amazon-ads-pp-cli sp get-keyword-ex— 拡張データフィールドを持つキーワードを取得します。 [PLANNED DEPRECATION 6/30/2023] -
amazon-ads-pp-cli sp get-negative-keyword— 識別子で指定したネガティブキーワードを取得します。 [PLANNED DEPRECATION 6/30/2023] -
amazon-ads-pp-cli sp get-negative-keyword-ex— 拡張データフィールドを持つネガティブキーワードを取得します。 [PLANNED DEPRECATION 6/30/2023] -
amazon-ads-pp-cli sp get-negative-targeting-clause— 識別子で指定したネガティブターゲティング句を取得します。 [PLANNED DEPRECATION 6/30/2023] -
amazon-ads-pp-cli sp get-negative-targeting-clause-ex— 識別子で指定したネガティブターゲティング句を取得します。 [PLANNED DEPRECATION 6/30/2023] -
amazon-ads-pp-cli sp get-product-ad— 識別子で指定した商品広告を取得します。 [PLANNED DEPRECATION 6/30/2023] -
amazon-ads-pp-cli sp get-product-ad-ex— 識別子で指定した商品広告の拡張データを取得します。 [PLANNED DEPRECATION 6/30/2023] -
amazon-ads-pp-cli sp get-snapshot-status— **非同期スナップショットの呼び出しフローについて -
amazon-ads-pp-cli sp get-targeting-clause— 識別子で指定したターゲティング句を取得します。 [PLANNED DEPRECATION 6/30/2023] -
amazon-ads-pp-cli sp get-targeting-clause-ex— 識別子で指定したターゲティング句を取得します。 [PLANNED DEPRECATION 6/30/2023] -
amazon-ads-pp-cli sp list-campaign-negative-keywords— キャンペーンのネガティブキーワードのリストを取得します。 [PLANNED DEPRECATION 6/30/2023] -
amazon-ads-pp-cli sp list-campaign-negative-keywords-ex— 拡張データフィールドを持つキャンペーンのネガティブキーワードのリストを取得します。 [PLANNED DEPRECATION 6/30/2023] -
amazon-ads-pp-cli sp list-campaigns— キャンペーンの配列を取得します。 [PLANNED DEPRECATION 6/30/2023] -
amazon-ads-pp-cli sp list-campaigns-ex— 拡張データフィールドを持つキャンペーンの配列を取得します。 [PLANNED DEPRECATION 6/30/2023] -
amazon-ads-pp-cli sp list-keywords— 1つ以上のキーワードを取得します。 [PLANNED DEPRECATION 6/30/2023] -
amazon-ads-pp-cli sp list-keywords-ex— 拡張データフィールドを持つキーワードのリストを取得します。 [PLANNED DEPRECATION 6/30/2023] -
amazon-ads-pp-cli sp list-negative-keywords— ネガティブキーワードオブジェクトのリストを取得します。 [PLANNED DEPRECATION 6/30/2023] -
amazon-ads-pp-cli sp list-negative-keywords-ex— 拡張データフィールドを持つネガティブキーワードのリストを取得します。 [PLANNED DEPRECATION 6/30/2023] -
amazon-ads-pp-cli sp list-negative-targeting-clauses— 指定した条件で絞り込んだネガティブターゲティング句のリストを取得します。 [PLANNED DEPRECATION 6/30/2023] -
amazon-ads-pp-cli sp list-negative-targeting-clauses-ex— 指定した条件で絞り込んだネガティブターゲティング句のリストを取得します。 [PLANNED DEPRECATION 6/30/2023] -
amazon-ads-pp-cli sp list-product-ads— 指定した条件で絞り込んだ商品広告のリストを取得します。 [PLANNED DEPRECATION 6/30/2023] -
amazon-ads-pp-cli sp list-product-ads-ex— 指定した条件で絞り込んだ商品広告のリストの拡張データを取得します。 [PLANNED DEPRECATION 6/30/2023] -
amazon-ads-pp-cli sp list-targeting-clauses— 指定した条件で絞り込んだターゲティング句のリストを取得します。 [PLANNED DEPRECATION 6/30/2023] -
amazon-ads-pp-cli sp list-targeting-clauses-ex— 指定した条件で絞り込んだターゲティング句のリストを取得します。 [PLANNED DEPRECATION 6/30/2023] -
amazon-ads-pp-cli sp update-ad-groups— 1つ以上の広告グループを更新します。 [PLANNED DEPRECATION 6/30/2023] -
amazon-ads-pp-cli sp update-campaign-negative-keywords— 1つ以上のキャンペーンのネガティブキーワードを更新します。 [PLANNED DEPRECATION 6/30/2023] -
amazon-ads-pp-cli sp update-campaigns— 1つ以上のキャンペーンを更新します。 [PLANNED DEPRECATION 6/30/2023] -
amazon-ads-pp-cli sp update-keywords— 1つ以上のキーワードを更新します。 [PLANNED DEPRECATION 6/30/2023] -
amazon-ads-pp-cli sp update-negative-keywords— 1つ以上のネガティブキーワードを更新します。 [PLANNED DEPRECATION 6/30/2023] -
amazon-ads-pp-cli sp update-negative-targeting-clause— 1つ以上のネガティブターゲティング句を更新します。 [PLANNED DEPRECATION 6/30/2023] -
amazon-ads-pp-cli sp update-product-ads— 識別子で指定した1つ以上の商品広告を更新します。 [PLANNED DEPRECATION 6/30/2023] -
amazon-ads-pp-cli sp update-targeting-clause— 1つ以上のターゲティング句を更新します。 [PLANNED DEPRECATION 6/30/2023] sponsored-brands-sb — スポンサーブランド sb を管理します -
amazon-ads-pp-cli sponsored-brands-sb campaigns-budget-usage— 次のいずれかの権限が必要です: ['advertiser_campaign_edit','advertiser_campaign_view'] -
amazon-ads-pp-cli sponsored-brands-sb create-associated-budget-rules-for-sbcampaigns— 1つのキャンペーンに関連付けられるルールは最大250件です。 -
amazon-ads-pp-cli sponsored-brands-sb create-brand-video-creative— このAPIは、指定された[Sponsored Brands Brand Video Ad](httpsに対する既存のクリエイティブの新しいバージョンを作成します -
amazon-ads-pp-cli sponsored-brands-sb create-budget-rules-for-sbcampaigns— 次のいずれかの権限が必要です: ['advertiser_campaign_edit'] -
amazon-ads-pp-cli sponsored-brands-sb create-product-collection-creative— このAPIは、商品コレクションのクリエイティブを指定して、指定されたSponsored Brands広告のクリエイティブの新しいバージョンを作成します -
amazon-ads-pp-cli sponsored-brands-sb create-sponsored-brand-store-spotlight-ads— Sponsored Brandsのストアスポットライト広告を作成します。次のいずれかの権限が必要です: ['advertiser_campaign_edit'] -
amazon-ads-pp-cli sponsored-brands-sb create-sponsored-brands-ad-groups— Sponsored Brandsの広告グループを作成します。次のいずれかの権限が必要です: ['advertiser_campaign_edit'] -
amazon-ads-pp-cli sponsored-brands-sb create-sponsored-brands-brand-video-ads— Sponsored Brandsのブランド動画広告を作成します。次のいずれかの権限が必要です: ['advertiser_campaign_edit'] -
amazon-ads-pp-cli sponsored-brands-sb create-sponsored-brands-campaigns— Sponsored Brandsキャンペーンを作成します。次のいずれかの権限が必要です: ['advertiser_campaign_edit'] -
amazon-ads-pp-cli sponsored-brands-sb create-sponsored-brands-product-collection-ads— Sponsored Brandsの商品コレクション広告を作成します。次のいずれかの権限が必要です: ['advertiser_campaign_edit'] -
amazon-ads-pp-cli sponsored-brands-sb create-sponsored-brands-video-ads— Sponsored Brandsの動画広告を作成します。次のいずれかの権限が必要です: ['advertiser_campaign_edit'] -
amazon-ads-pp-cli sponsored-brands-sb create-store-spotlight-creative— このAPIは、ストアスポットライトのクリエイティブコンテンツを指定して、指定されたSponsored Brands広告のクリエイティブの新しいバージョンを作成します -
amazon-ads-pp-cli sponsored-brands-sb create-video-creative— このAPIは、動画クリエイティブを指定して、指定されたSponsored Brands広告の既存のクリエイティブの新しいバージョンを作成します -
amazon-ads-pp-cli sponsored-brands-sb delete-sponsored-brands-ad-groups— Sponsored Brandsの広告グループを削除します。次のいずれかの権限が必要です: ['advertiser_campaign_edit'] -
amazon-ads-pp-cli sponsored-brands-sb delete-sponsored-brands-ads— Sponsored Brands広告を削除します。次のいずれかの権限が必要です: ['advertiser_campaign_edit'] -
amazon-ads-pp-cli sponsored-brands-sb disassociate-associated-budget-rule-for-sbcampaigns— 識別子で指定された予算ルールと、識別子で指定されたキャンペーンとの関連付けを解除します。 -
amazon-ads-pp-cli sponsored-brands-sb get-budget-recommendations— リクエストされたSponsored Brandsキャンペーンのリストについて、1日の予算の推奨値を提示します -
amazon-ads-pp-cli sponsored-brands-sb get-budget-rule-by-rule-id-for-sbcampaigns— 次のいずれかの権限が必要です: ['advertiser_campaign_edit','advertiser_campaign_view'] -
amazon-ads-pp-cli sponsored-brands-sb get-campaign-shopper-segment-forecast— ショッパーセグメント入札キャンペーンのパフォーマンス予測を取得します。 -
amazon-ads-pp-cli sponsored-brands-sb get-campaigns-associated-with-sbbudget-rule— 予算ルールに関連付けられたすべてのキャンペーンを取得します -
amazon-ads-pp-cli sponsored-brands-sb get-headline-recommendations— クリエイティブの見出し候補を受け取るためのAPIです。 -
amazon-ads-pp-cli sponsored-brands-sb get-keyword-recommendations— ランディングページまたはストアページに含まれるASINのセットについて、キーワード推奨オブジェクトの配列を取得します。 -
amazon-ads-pp-cli sponsored-brands-sb get-rule-based-budget-history-for-sbcampaigns— 必須パラメーターのstartDateとendDateで指定された期間の予算履歴を返します。 -
amazon-ads-pp-cli sponsored-brands-sb get-sbbudget-rules-for-advertiser— 広告主が作成したすべての予算ルールを取得します -
amazon-ads-pp-cli sponsored-brands-sb list-associated-budget-rules-for-sbcampaigns— 次のいずれかの権限が必要です: ['advertiser_campaign_edit','advertiser_campaign_view'] -
amazon-ads-pp-cli sponsored-brands-sb list-creatives— このAPIは、指定されたリソース識別子とフィルターに該当するすべてのSponsored Brandsクリエイティブの配列を取得します -
amazon-ads-pp-cli sponsored-brands-sb list-sponsored-brands-ad-groups— Sponsored Brandsの広告グループを一覧表示します。 -
amazon-ads-pp-cli sponsored-brands-sb list-sponsored-brands-ads— Sponsored Brands広告を一覧表示します。 -
amazon-ads-pp-cli sponsored-brands-sb list-sponsored-brands-campaigns— Sponsored Brandsキャンペーンを一覧表示します。 -
amazon-ads-pp-cli sponsored-brands-sb sbget-budget-rules-recommendation— ルールを使うと、指定した日付範囲または特別なイベントに対して予算を自動的に増額できます。 -
amazon-ads-pp-cli sponsored-brands-sb sbtargeting-get-negative-brands— 除外ターゲティングに推奨されるブランドを返します。出品者とベンダーのみ利用できます。 -
amazon-ads-pp-cli sponsored-brands-sb sbtargeting-get-refinements-for-category— カテゴリー入力に基づいて絞り込み条件を返します。 -
amazon-ads-pp-cli sponsored-brands-sb sbtargeting-get-targetable-asincounts— ユーザーが指定した絞り込み条件に基づいて、ターゲティング可能なASINの数を取得します。 -
amazon-ads-pp-cli sponsored-brands-sb sbtargeting-get-targetable-categories— デフォルトですべてのターゲティング可能なカテゴリーを一覧で返します。 -
amazon-ads-pp-cli sponsored-brands-sb update-budget-rules-for-sbcampaigns— 次のいずれかの権限が必要です: ['advertiser_campaign_edit'] -
amazon-ads-pp-cli sponsored-brands-sb update-sponsored-brands-ad-groups— Sponsored Brandsの広告グループを更新します。次のいずれかの権限が必要です: ['advertiser_campaign_edit'] -
amazon-ads-pp-cli sponsored-brands-sb update-sponsored-brands-ads— Sponsored Brands広告を更新します。次のいずれかの権限が必要です: ['advertiser_campaign_edit'] sponsored-display-sd — スポンサーディスプレイ広告 SD を管理します -
amazon-ads-pp-cli sponsored-display-sd campaigns-budget-usage— 次のいずれかの権限が必要です:['advertiser_campaign_edit','advertiser_campaign_view'] -
amazon-ads-pp-cli sponsored-display-sd create-associated-budget-rules-for-sdcampaigns— 1 つのキャンペーンに関連付けられるルールは最大 250 件です。 -
amazon-ads-pp-cli sponsored-display-sd create-brand-safety-deny-list-domains— ブランドセーフティ拒否リストに追加するドメインを 1 つ以上作成します。ブランドセーフティ拒否リストは広告主レベルで設定されます。 -
amazon-ads-pp-cli sponsored-display-sd create-budget-rules-for-sdcampaigns— 予算ルールを 1 つ以上作成します。 -
amazon-ads-pp-cli sponsored-display-sd delete-brand-safety-deny-list— ブランドセーフティ拒否リスト内のすべてのドメインをアーカイブします。 -
amazon-ads-pp-cli sponsored-display-sd disassociate-associated-budget-rule-for-sdcampaigns— 識別子で指定した予算ルールと、識別子で指定したキャンペーンとの関連付けを解除します。 -
amazon-ads-pp-cli sponsored-display-sd download-snapshot-by-id— 次のいずれかの権限が必要です:['advertiser_campaign_edit','advertiser_campaign_view'] -
amazon-ads-pp-cli sponsored-display-sd get-budget-rule-by-rule-id-for-sdcampaigns— 識別子で指定した予算ルールを取得します。 -
amazon-ads-pp-cli sponsored-display-sd get-campaigns-associated-with-sdbudget-rule— 予算ルールに関連付けられているすべてのキャンペーンを取得します。 -
amazon-ads-pp-cli sponsored-display-sd get-headline-recommendations-for— このスポンサーディスプレイ広告 API を使用して、ASIN の配列に基づくクリエイティブの見出しの推奨案を取得できます。 -
amazon-ads-pp-cli sponsored-display-sd get-request-results— ユーザーがブランドセーフティ拒否リストにドメインを追加すると、リクエストは非同期で処理されます。 -
amazon-ads-pp-cli sponsored-display-sd get-request-status— ユーザーがブランドセーフティ拒否リストを変更すると、リクエストは非同期で処理されます。 -
amazon-ads-pp-cli sponsored-display-sd get-rule-based-budget-history-for-sdcampaigns— 必須パラメーターの startDate と endDate で指定した期間の予算履歴が返されます。 -
amazon-ads-pp-cli sponsored-display-sd get-sdbudget-rules-for-advertiser— 広告主が作成したすべての予算ルールを取得します。 -
amazon-ads-pp-cli sponsored-display-sd get-snapshot-by-id— 次のいずれかの権限が必要です:['advertiser_campaign_edit','advertiser_campaign_view'] -
amazon-ads-pp-cli sponsored-display-sd get-target-bid-recommendations— 入力した広告対象 ASIN と同じターゲティング条件のリストに基づいて、入札額の推奨案を一覧表示します。 -
amazon-ads-pp-cli sponsored-display-sd get-target-recommendations— 入力した ASIN のリストに基づいて、ターゲットにする商品を一覧表示します。 -
amazon-ads-pp-cli sponsored-display-sd list-associated-budget-rules-for-sdcampaigns— 識別子で指定したキャンペーンに関連付けられた予算ルールを一覧表示します。 -
amazon-ads-pp-cli sponsored-display-sd list-domains— 広告主のブランドセーフティ拒否リストに含まれるウェブサイトやアプリの配列を取得します。 -
amazon-ads-pp-cli sponsored-display-sd list-request-status— すべてのブランドセーフティリストリクエストのステータスを一覧表示します。過去 90 日間に送信されたリクエストが一覧に含まれます。 -
amazon-ads-pp-cli sponsored-display-sd update-budget-rules-for-sdcampaigns— 予算ルールを 1 つ以上更新します。
sponsored-products-sp — スポンサープロダクト広告 SP を管理します
-
amazon-ads-pp-cli sponsored-products-sp campaigns-budget-usage— 次のいずれかの権限が必要です:['advertiser_campaign_edit','advertiser_campaign_view'] -
amazon-ads-pp-cli sponsored-products-sp create-associated-budget-rules-for-spcampaigns— キャンペーンに関連付けられるルールは最大250件です。 -
amazon-ads-pp-cli sponsored-products-sp create-budget-rules-for-spcampaigns— 次のいずれかの権限が必要です:['advertiser_campaign_edit'] -
amazon-ads-pp-cli sponsored-products-sp create-optimization-rule— 次のいずれかの権限が必要です:['advertiser_campaign_edit'] -
amazon-ads-pp-cli sponsored-products-sp create-sponsored-products-ad-groups— 次のいずれかの権限が必要です:['advertiser_campaign_edit'] -
amazon-ads-pp-cli sponsored-products-sp create-sponsored-products-campaign-negative-keywords— 次のいずれかの権限が必要です:['advertiser_campaign_edit'] -
amazon-ads-pp-cli sponsored-products-sp create-sponsored-products-campaign-negative-targeting-clauses— 次のいずれかの権限が必要です:['advertiser_campaign_edit'] -
amazon-ads-pp-cli sponsored-products-sp create-sponsored-products-campaigns— 次のいずれかの権限が必要です:['advertiser_campaign_edit'] -
amazon-ads-pp-cli sponsored-products-sp create-sponsored-products-keywords— 次のいずれかの権限が必要です:['advertiser_campaign_edit'] -
amazon-ads-pp-cli sponsored-products-sp create-sponsored-products-negative-keywords— 次のいずれかの権限が必要です:['advertiser_campaign_edit'] -
amazon-ads-pp-cli sponsored-products-sp create-sponsored-products-negative-targeting-clauses— 次のいずれかの権限が必要です:['advertiser_campaign_edit'] -
amazon-ads-pp-cli sponsored-products-sp create-sponsored-products-product-ads— 次のいずれかの権限が必要です:['advertiser_campaign_edit'] -
amazon-ads-pp-cli sponsored-products-sp create-sponsored-products-targeting-clauses— 次のいずれかの権限が必要です:['advertiser_campaign_edit'] -
amazon-ads-pp-cli sponsored-products-sp delete-campaign-optimization-rule— 次のいずれかの権限が必要です:['advertiser_campaign_edit'] -
amazon-ads-pp-cli sponsored-products-sp delete-sponsored-products-ad-groups— 次のいずれかの権限が必要です:['advertiser_campaign_edit'] -
amazon-ads-pp-cli sponsored-products-sp delete-sponsored-products-campaign-negative-keywords— 次のいずれかの権限が必要です:['advertiser_campaign_edit'] -
amazon-ads-pp-cli sponsored-products-sp delete-sponsored-products-campaign-negative-targeting-clauses— 次のいずれかの権限が必要です:['advertiser_campaign_edit'] -
amazon-ads-pp-cli sponsored-products-sp delete-sponsored-products-campaigns— 次のいずれかの権限が必要です:['advertiser_campaign_edit'] -
amazon-ads-pp-cli sponsored-products-sp delete-sponsored-products-keywords— 次のいずれかの権限が必要です:['advertiser_campaign_edit'] -
amazon-ads-pp-cli sponsored-products-sp delete-sponsored-products-negative-keywords— 次のいずれかの権限が必要です:['advertiser_campaign_edit'] -
amazon-ads-pp-cli sponsored-products-sp delete-sponsored-products-negative-targeting-clauses— 次のいずれかの権限が必要です:['advertiser_campaign_edit'] -
amazon-ads-pp-cli sponsored-products-sp delete-sponsored-products-product-ads— 次のいずれかの権限が必要です:['advertiser_campaign_edit'] -
amazon-ads-pp-cli sponsored-products-sp delete-sponsored-products-targeting-clauses— 次のいずれかの権限が必要です:['advertiser_campaign_edit'] -
amazon-ads-pp-cli sponsored-products-sp disassociate-associated-budget-rule-for-spcampaigns— 識別子で指定されたルールと、識別子で指定されたキャンペーンとの関連付けを解除します。 -
amazon-ads-pp-cli sponsored-products-sp get-budget-recommendation— 新しいキャンペーンの作成時に、ベンチマーク指標とともに1日の予算を提案します。 -
amazon-ads-pp-cli sponsored-products-sp get-budget-recommendations— キャンペーンのリストを入力として指定すると、このAPIは次の指標を提供します - 1. -
amazon-ads-pp-cli sponsored-products-sp get-budget-rule-by-rule-id-for-spcampaigns— 次のいずれかの権限が必要です:['advertiser_campaign_edit','advertiser_campaign_view'] -
amazon-ads-pp-cli sponsored-products-sp get-campaign-optimization-rule— 次のいずれかの権限が必要です:['advertiser_campaign_edit','advertiser_campaign_view'] -
amazon-ads-pp-cli sponsored-products-sp get-campaign-recommendations— 広告主プロフィールIDを指定すると、SPキャンペーンの入札額、予算、ターゲティングに関する上位の統合された推奨事項を取得します。 -
amazon-ads-pp-cli sponsored-products-sp get-campaigns-associated-with-spbudget-rule— 予算ルールに関連付けられたすべてのキャンペーンを取得します。 -
amazon-ads-pp-cli sponsored-products-sp get-category-recommendations-for-asins— 入力されたASINのリストに対するカテゴリの推奨事項を返します。 -
amazon-ads-pp-cli sponsored-products-sp get-negative-brands— 除外ターゲティングに推奨されるブランドを返します。出品者とベンダーのみが利用できます。 -
amazon-ads-pp-cli sponsored-products-sp get-optimization-rule-eligibility— 次のいずれかの権限が必要です:['advertiser_campaign_edit','advertiser_campaign_view'] -
amazon-ads-pp-cli sponsored-products-sp get-product-recommendations— 広告対象のASINを入力として指定すると、このAPIは商品ターゲティングキャンペーンでターゲットにするASINの候補を返します。 -
amazon-ads-pp-cli sponsored-products-sp get-ranked-keyword-recommendation— POST /sp/targets/keywords/recommendations エンドポイントは、A)のいずれかが指定された場合に、推奨キーワードターゲットを返します。 -
amazon-ads-pp-cli sponsored-products-sp get-refinements-for-category— 入力されたカテゴリに応じた絞り込み項目を返します。 -
amazon-ads-pp-cli sponsored-products-sp get-rule-based-budget-history-for-spcampaigns— 必須パラメーターのstartDateとendDateで指定された期間の予算履歴を返します。 -
amazon-ads-pp-cli sponsored-products-sp get-rule-notification— 次のいずれかの権限が必要です:['advertiser_campaign_edit','advertiser_campaign_view'] -
amazon-ads-pp-cli sponsored-products-sp get-spbudget-rules-for-advertiser— 広告主が作成したすべての予算ルールを取得します。 -
amazon-ads-pp-cli sponsored-products-sp get-targetable-asincounts— ユーザーが指定した絞り込み条件に基づいて、ターゲティング可能なASINの数を取得します。 -
amazon-ads-pp-cli sponsored-products-sp get-targetable-categories— ターゲティング可能なカテゴリをすべて返します。このAPIは、カテゴリノードのツリーを含む大きなJSON文字列を返します。 -
amazon-ads-pp-cli sponsored-products-sp get-theme-based-bid-recommendation-for-ad-group-v1— 現在のテーマベースの入札額推奨サービスのバージョンは、自動ターゲティングとキーワードターゲティングに対応しています。 -
amazon-ads-pp-cli sponsored-products-sp list-associated-budget-rules-for-spcampaigns— 次のいずれかの権限が必要です:['advertiser_campaign_edit','advertiser_campaign_view'] -
amazon-ads-pp-cli sponsored-products-sp list-sponsored-products-ad-groups— 次のいずれかの権限が必要です:['advertiser_campaign_edit','advertiser_campaign_view'] -
amazon-ads-pp-cli sponsored-products-sp list-sponsored-products-campaign-negative-keywords— 次のいずれかの権限が必要です:['advertiser_campaign_edit','advertiser_campaign_view'] -
amazon-ads-pp-cli sponsored-products-sp list-sponsored-products-campaign-negative-targeting-clauses— 次のいずれかの権限が必要です:['advertiser_campaign_edit','advertiser_campaign_view'] -
amazon-ads-pp-cli sponsored-products-sp list-sponsored-products-campaigns— 次のいずれかの権限が必要です:['advertiser_campaign_edit','advertiser_campaign_view'] -
amazon-ads-pp-cli sponsored-products-sp list-sponsored-products-keywords— 次のいずれかの権限が必要です:['advertiser_campaign_edit'] -
amazon-ads-pp-cli sponsored-products-sp list-sponsored-products-negative-keywords— 次のいずれかの権限が必要です:['advertiser_campaign_edit','advertiser_campaign_view'] -
amazon-ads-pp-cli sponsored-products-sp list-sponsored-products-negative-targeting-clauses— 次のいずれかの権限が必要です:['advertiser_campaign_edit','advertiser_campaign_view'] -
amazon-ads-pp-cli sponsored-products-sp list-sponsored-products-product-ads— 次のいずれかの権限が必要です:['advertiser_campaign_edit','advertiser_campaign_view'] -
amazon-ads-pp-cli sponsored-products-sp list-sponsored-products-targeting-clauses— 次のいずれかの権限が必要です:['advertiser_campaign_edit'] -
amazon-ads-pp-cli sponsored-products-sp search-brands— 除外ターゲティング向けに、入力キーワードに関連する最大100件のブランドを返します。 -
amazon-ads-pp-cli sponsored-products-sp spget-budget-rules-recommendation— ルールを使用すると、指定した日付範囲または特別なイベント期間に予算を自動的に増額できます。 -
amazon-ads-pp-cli sponsored-products-sp update-budget-rules-for-spcampaigns— 次のいずれかの権限が必要です:['advertiser_campaign_edit'] -
amazon-ads-pp-cli sponsored-products-sp update-optimization-rule— 次のいずれかの権限が必要です:['advertiser_campaign_edit'] -
amazon-ads-pp-cli sponsored-products-sp update-sponsored-products-ad-groups— 次のいずれかの権限が必要です:['advertiser_campaign_edit'] -
amazon-ads-pp-cli sponsored-products-sp update-sponsored-products-campaign-negative-keywords— 次のいずれかの権限が必要です:['advertiser_campaign_edit'] -
amazon-ads-pp-cli sponsored-products-sp update-sponsored-products-campaign-negative-targeting-clauses— 次のいずれかの権限が必要です:['advertiser_campaign_edit'] -
amazon-ads-pp-cli sponsored-products-sp update-sponsored-products-campaigns— 次のいずれかの権限が必要です:['advertiser_campaign_edit'] -
amazon-ads-pp-cli sponsored-products-sp update-sponsored-products-keywords— 次のいずれかの権限が必要です:['advertiser_campaign_edit'] -
amazon-ads-pp-cli sponsored-products-sp update-sponsored-products-negative-keywords— 次のいずれかの権限が必要です:['advertiser_campaign_edit'] -
amazon-ads-pp-cli sponsored-products-sp update-sponsored-products-negative-targeting-clauses— 次のいずれかの権限が必要です:['advertiser_campaign_edit'] -
amazon-ads-pp-cli sponsored-products-sp update-sponsored-products-product-ads— 次のいずれかの権限が必要です:['advertiser_campaign_edit'] -
amazon-ads-pp-cli sponsored-products-sp update-sponsored-products-targeting-clauses— 次のいずれかの権限が必要です:['advertiser_campaign_edit'] stores —(動画キャンペーンでは利用できません) -
amazon-ads-pp-cli stores create-asset— 画像アセットは Store Assets Library に保存されます。 -
amazon-ads-pp-cli stores list-assets— セラーまたはベンダーの場合、指定されたブランドエンティティ識別子に関連付けられたアセットの配列を取得します。
targeting-expression — ターゲティング式を管理します
amazon-ads-pp-cli targeting-expression— ターゲティング式をソースマーケットプレイスから1つ以上のターゲットマーケットプレイスにローカライズ(マッピング)します。
適切なコマンドを見つける
実行したいことは分かっていても、どのコマンドを使うか分からない場合は、CLI に直接問い合わせてください。
amazon-ads-pp-cli which "<capability in your own words>"
which は、自然言語による機能の問い合わせを、この CLI の厳選された機能インデックス内で最も一致するコマンドに対応付けます。終了コード 0 は少なくとも1件の一致があることを示し、終了コード 2 は確実な一致がないことを示します。その場合は --help に切り替えるか、より具体的な問い合わせを使用してください。
認証の設定
この CLI は、リフレッシュトークンのローテーションを伴う Login with Amazon OAuth2 を使用します。Amazon 開発者アプリに、次の許可されたリターン URL/リダイレクト URI をそのまま登録してください。
http://localhost:8085/callback
ローカルの認証情報を ~/.config/amazon-ads-pp-cli/.env に設定します。
mkdir -p ~/.config/amazon-ads-pp-cli
chmod 700 ~/.config/amazon-ads-pp-cli
"$EDITOR" ~/.config/amazon-ads-pp-cli/.env
以下を使用します。
AMAZON_ADS_CLIENT_ID=your-client-id
AMAZON_ADS_CLIENT_SECRET=your-client-secret
AMAZON_ADS_REFRESH_TOKEN=
AMAZON_ADS_PROFILE_ID=
次に amazon-ads-pp-cli auth login --port 8085 を実行して、advertising::campaign_management を認可し、リフレッシュトークンを保存します。ログインフローでは広告プロフィールも取得し、プロフィールが1つだけの場合は自動的に選択します。複数のプロフィールがある場合は選択を求めます。すでにリフレッシュトークンをお持ちの場合は、代わりに .env に貼り付けてください。API 呼び出しの前に、アクセストークンは自動的に更新されます。
amazon-ads-pp-cli doctor を実行して、設定を確認します。
スコープ付きエンドポイントを実行する前に、保存済みの Amazon Ads プロファイルスコープを一覧表示または変更します。
amazon-ads-pp-cli profiles list --json
amazon-ads-pp-cli profiles select <profile-id>
amazon-ads-pp-cli profiles current --json
新しいセラー分析コマンドは、エクスポート済みの Amazon Ads レポートと、任意の COGS TOML を使用します。
dayparting-analysis と budget-pacing には、hour、hourOfDay、またはタイムスタンプ付きの行を含むレポートエクスポートが必要です。固定された DSP レポートスキーマが公開する時間単位は SUMMARY/DAILY ですが、Amazon Ads Insights のタイミングデータには hourOfDay が含まれます。
amazon-ads-pp-cli break-even-acos --price 32.99 --cogs 8.50 --fees 30 --json
amazon-ads-pp-cli true-profit --price 32.99 --cogs 8.50 --fees 30 --ad-spend 4.20 --json
amazon-ads-pp-cli acos-vs-tacos --report product-performance.csv --seller-store ~/.config/amazon-seller-pp-cli/store.db --asin B0XXXX --json
amazon-ads-pp-cli portfolio-dashboard --report campaign-performance.csv --json
amazon-ads-pp-cli campaign-comparison --report campaign-performance.csv --json
amazon-ads-pp-cli product-ad-profitability --report product-performance.csv --cogs-file ~/.config/amazon-ads-pp-cli/cogs.toml --json
amazon-ads-pp-cli reports wait <report-id> --wait-timeout 20m --json
amazon-ads-pp-cli normalize-report --input downloaded-report.csv.gz --kind performance --output normalized.jsonl --format jsonl --store --json
amazon-ads-pp-cli placement-analysis --report placement-performance.csv --json
amazon-ads-pp-cli competitor-asin-mining --report product-targeting-performance.csv --asin B0XXXX --json
amazon-ads-pp-cli seasonal-planner --report historical-performance.csv --budget-multiplier 1.25 --json
amazon-ads-pp-cli dayparting-analysis --report hourly-performance.csv --json
amazon-ads-pp-cli budget-pacing --report hourly-campaign-performance.csv --threshold 0.90 --early-hour 18 --json
amazon-ads-pp-cli share-of-voice --report share-of-voice.csv --asin B0XXXX --keywords "self journal,daily planner" --json
amazon-ads-pp-cli search-term-mining --report search-terms.csv --target-acos 25 --json
amazon-ads-pp-cli wasted-spend --report search-terms.csv --threshold 10 --json
amazon-ads-pp-cli keyword-cannibalization --report search-terms.csv --json
amazon-ads-pp-cli negative-keyword-generator --report search-terms.csv --threshold 10 --json
amazon-ads-pp-cli new-keyword-opportunities --report search-terms.csv --target-acos 25 --json
amazon-ads-pp-cli bid-optimizer --report keyword-performance.csv --target-acos 25 --json
amazon-ads-pp-cli keyword-decay --baseline keyword-performance-previous.csv --current keyword-performance-current.csv --degradation-threshold 30 --min-spend 25 --json
amazon-ads-pp-cli keyword-lifecycle --report keyword-performance.csv --target-acos 25 --json
amazon-ads-pp-cli keyword-snapshots import --report keyword-performance.csv --snapshot-at 2026-02-01 --json
amazon-ads-pp-cli keyword-snapshots list --json
amazon-ads-pp-cli bid-history --keyword "self journal" --json
amazon-ads-pp-cli auto-negate --report search-terms.csv --threshold 15 --min-clicks 20 --json
amazon-ads-pp-cli auto-promote --report search-terms.csv --min-conversions 3 --max-acos 30 --json
amazon-ads-pp-cli budget-rebalance --report campaign-performance.csv --total-budget 500 --json
amazon-ads-pp-cli bid-rules apply --report keyword-performance.csv --file rules.json --json
amazon-ads-pp-cli automation-audit --limit 20 --json
自動化コマンドは、デフォルトではプランを出力します。変更に必要な Amazon ID(検索語句の自動化では campaign_id と ad_group_id、予算更新では campaign_id、入札ルールの更新では keyword_id)がレポートに含まれている場合に限り、--apply を使用してください。適用モードでは、送信前に重複するリモート変更キーを排除します。変更数は --max-changes で上限を設定でき、入札変更は --max-bid で上限を設定できます。また、設定されている場合、予算の再配分は --max-daily-budget で上限が設定されます。--apply --dry-run は、変更リクエストを送信せずにプレビューします。auto-promote --apply では、--bid も必要です。
エージェントモード
任意のコマンドに --agent を追加します。次のオプションに展開されます:--json --compact --no-input --no-color --yes。
-
パイプ可能 — stdout に JSON、stderr にエラーを出力します
-
フィルタ可能 —
--selectでフィールドの一部を保持します。ドット区切りのパスはネストされた構造をたどり、配列では各要素をたどります。冗長な API でコンテキストを小さく保つうえで重要です。amazon-ads-pp-cli amazon-ads-dsp-dsp list --agent --select id,name,status -
プレビュー可能 —
--dry-runでリクエストを送信せずに表示します -
オフライン対応 — 同期/検索コマンドは、利用可能な場合にローカル SQLite ストアを使用できます
-
非対話型 — プロンプトは表示されず、すべての入力はフラグで指定します
-
明示的なリトライ — すでに存在するものの作成を成功として扱う場合に限り
--idempotentを使用し、削除対象が存在しない場合の削除を成功として扱う場合に限り--ignore-missingを使用します
レスポンスエンベロープ
ローカルストアまたは API から読み取るコマンドは、出力を出所情報のエンベロープでラップします。
{
"meta": {"source": "live" | "local", "synced_at": "...", "reason": "..."},
"results": <data>
}
データには .results を解析し、ライブデータかローカルデータかを確認するには .meta.source を解析してください。人間が読める N results (live) の概要は、stdout がターミナルであり、かつ機械形式のフラグ(--json、--csv、--compact、--quiet、--plain、--select)が設定されていない場合に限り stderr に出力されます。パイプ経由/エージェントの利用者や、形式を明示した実行では、stdout に純粋な JSON が出力されます。
エージェントからのフィードバック
あなた(またはエージェント)がこの CLI について気になる点に気づいたら、記録してください。
amazon-ads-pp-cli feedback "the --since flag is inclusive but docs say exclusive"
amazon-ads-pp-cli feedback --stdin < notes.txt
amazon-ads-pp-cli feedback list --json --limit 10
エントリーはローカルの ~/.local/share/amazon-ads-pp-cli/feedback.jsonl に保存されます。AMAZON_ADS_FEEDBACK_ENDPOINT が設定され、かつ --send が渡されるか、AMAZON_ADS_FEEDBACK_AUTO_SEND=true が設定されていない限り、POST されることはありません。デフォルトの動作はローカルのみです。
バグ報告ではなく、意外だったことを書いてください。短く、具体的に、1 行で書きます。それが積み重なっていきます。
出力の配信
すべてのコマンドで --deliver <sink> を指定できます。出力は標準出力に加えて(または標準出力の代わりに)指定したシンクに送られるため、エージェントはコマンド結果を手作業でパイプ処理せずに振り分けられます。利用できるシンクは 3 つです。
| シンク | 動作 |
|---|---|
stdout | デフォルト。標準出力のみに書き込みます |
file:<path> | 出力を <path> にアトミックに書き込みます(一時ファイルを作成してから名前を変更) |
webhook:<url> | 出力本文を URL に POST します(--compact の場合は application/json または application/x-ndjson) |
未知のスキームは、サポート対象の一覧を示す構造化エラーとともに拒否されます。Webhook の失敗時はゼロ以外のコードを返し、URL と HTTP ステータスを標準エラーに記録します。
名前付きプロファイル
プロファイルは保存済みのフラグ値のセットで、呼び出しごとに再利用できます。同じ設定で同じコマンドを毎回実行するスケジュール済みエージェントで使用します。HeyGen の「Beacon」パターンがその例です。
amazon-ads-pp-cli profile save briefing --json
amazon-ads-pp-cli --profile briefing amazon-ads-dsp-dsp list
amazon-ads-pp-cli profile list --json
amazon-ads-pp-cli profile show briefing
amazon-ads-pp-cli profile delete briefing --yes
明示的なフラグは常にプロファイルの値より優先され、プロファイルの値はデフォルトより優先されます。agent-context は、実行時にエージェントが情報を調べて利用できるよう、available_profiles の下にすべてのプロファイルを一覧表示します。
非同期ジョブ
長時間実行される処理を送信するエンドポイントについて、ジェネレーターは送信してからポーリングするパターン(レスポンスに job_id/task_id/operation_id フィールドがあり、対応するステータスエンドポイントがある場合)を検出し、送信コマンドに次の 3 つのフラグを追加します。
| フラグ | 目的 |
|---|---|
--wait | ジョブ ID をすぐに返す代わりに、ジョブが終了状態に達するまで待機します |
--wait-timeout | 最大待機時間(デフォルトは 10m、0 はタイムアウトなし) |
--wait-interval | 初回のポーリング間隔(デフォルトは 2s。指数バックオフで最大 30s まで延長されます) |
非同期で送信して結果を待たない場合は --wait を指定せず、1 つのコマンドで完成した成果物を返したい場合は --wait を指定します。
上流スキーマの Amazon スポンサーレポート送信エンドポイントには、ジェネレーターの --wait フラグを公開していないものがあります。レポートの作成後に amazon-ads-pp-cli reports wait <report-id> を使用して、Amazon が終了状態を返すまで /v2/reports/{reportId} をポーリングしてください。
終了コード
| コード | 意味 |
|---|---|
| 0 | 成功 |
| 2 | 使用エラー(引数が誤っています) |
| 3 | リソースが見つかりません |
| 4 | 認証が必要です |
| 5 | API エラー(上流の問題) |
| 7 | レート制限中(待機して再試行してください) |
| 10 | 設定エラー |
引数の解析
$ARGUMENTS を解析します。
- 空、
help、または--help→amazon-ads-pp-cli --helpの出力を表示します installで始まる場合 →mcpで終わる場合は MCP のインストール、それ以外の場合は上記の前提条件を参照してください- それ以外 → 直接使用(
--agentを付けて CLI コマンドとして実行します)
MCP サーバーのインストール
- MCP サーバーをインストールします。
go install github.com/mvanhorn/printing-press-library/library/commerce/amazon-ads/cmd/amazon-ads-pp-mcp@latest - Claude Code に登録します。
claude mcp add amazon-ads-pp-mcp -- amazon-ads-pp-mcp - 確認します:
claude mcp list
直接使用
- インストール済みか確認します:
which amazon-ads-pp-cli見つからない場合は、インストールを提案します(このスキルの冒頭にある前提条件を参照してください)。 - ユーザーのクエリに最適なコマンドを、上記の「独自の機能」と「コマンドリファレンス」から選びます。
--agentフラグを付けて実行します。amazon-ads-pp-cli <command> [subcommand] [args] --agent- 曖昧な場合は、サブコマンドのヘルプを確認します:
amazon-ads-pp-cli <command> --help