SmartNews Ads Marketing APIを活用した開発を始めるためのガイドです。APIを通じてキャンペーン管理や分析データの取得を効率的に行うための初期セットアップ手順をご案内します。
API開発者ではない方で、既存のAPIソリューションの利用をご希望の場合は、「広告主・代理店様向け」セクションをご覧ください。
Marketing APIドキュメントへ ＞
Marketing APIの概要
SmartNews Ads Marketing APIは、SmartNews Ads管理画面へのプログラマティックなアクセスを提供し、キャンペーン管理の自動化や詳細なパフォーマンス分析を可能にします。主な機能は以下の通りです：
- キャンペーン管理：キャンペーン、広告グループ、広告に対する作成、読み取り、更新、削除操作
- インサイトAPI：様々な指標と分類による詳細なレポート機能
- カスタムオーディエンス取得：オーディエンスデータとPixel情報へのアクセス
- 認証：OAuth 2.0による安全なアクセス
※ Marketing APIは広告マネージャー v2のオブジェクトのみをサポートしています。
API開発者向け
1. アプリケーションの申請
Marketing APIの利用を開始するには、まず開発者として登録が必要です：
1開発者申請フォームに必要事項を記入します。開発者アプリは当面、1法人につき1つまでの申請とさせていただきます。※アプリを開発しないアプリ利用企業様は申請不要です（申請を却下させていただくこともございます）。
2会社情報とAPIの利用目的を提供します。
3SmartNews側で審査を行い、承認後に通知をお送りします。
2. クライアントシークレットの生成
承認後、以下の手順でクライアントシークレット（API認証用のキー）を取得します：
1Business Managerにログインします。
2[開発者アプリ管理]セクションに移動し、[開発者アプリ情報を登録]を押下します。
3アプリ名には開発者申請フォームで使用した名称を入力し、[保存してAPI Client Secretを発行]を押下します。
4生成されたクライアントシークレットを安全な場所に保存します。
注意事項
- クライアントシークレットは生成時に一度だけ表示されます。
- クライアントシークレットは厳重に管理し、絶対に外部に公開しないでください。
承認後、下図のようにアプリがアプリタブに表示され、関連する開発アプリの詳細が表示されるようになります。
広告主・代理店様向け
APIを使用して既存の広告アカウントを開発者アプリに追加する方法
Business Admin権限が必要です。Business Admin権限はAPI利用の管理やアプリ権限の確認に必要です。Business Admin権限の申請方法については近日ご案内いたします。
開発者アプリに既存の広告アカウントを追加する手順は以下の通りです：
1Business Managerの[Developer app management]に移動します。
2[Assign ad account] を押下します。
3ドロップダウンメニューから広告アカウントを選択します（複数選択可能）。
4選択したすべてのアカウントに対して適切な権限を付与します。
5[Next] を押下します。
6確認ポップアップが表示されたら [Save] を押下して変更を適用します。
FAQ
Q：API開発者ではありませんが、SmartNews Ads APIを使用する既存のサービスを利用したいです。開発者として申請する必要はありますか？
A：従来のAPIとは異なり、APIキーを発行して開発者と共有するために開発者として申請する必要はありません。APIを使用して新しいアプリを開発する予定がある場合にのみ、開発者アクセスが必要です。
Q：各APIバージョンの提供期間はどのくらいですか？
A：最新バージョンと1つ前のバージョンを6ヶ月間同時に提供しています。これにより、新バージョンでのテストを行いながら、既存のバージョンで本番運用を継続することができます。
Q：新しいAPIバージョンがリリースされた際、既存のコードは動かなくなりますか？
A：同一バージョン内でレスポンスフィールドやパラメータが削除・更新されることはありません。ただし、新しいバージョンでは互換性のない変更が導入される可能性があります。
同一バージョン内で発生する可能性のある変更：
- レスポンスへの新規フィールドの追加
- 新しいオプションのリクエストパラメータ
- 新しいエンドポイントや機能
新バージョンと旧バージョンが6ヶ月間共存するため、この期間内に必要な更新を完了していただくようお願いいたします。
