Pinterest広告の連携

← メディアアカウント連携にもどる

Pinterest API v5 を使うOAuthリダイレクト方式です。認可は www.pinterest.com 経由で行われます。

項目内容
認可方式Pinterest API v5 OAuth リダイレクト
スコープads:read / ads:write
用意するものPinterestアプリの App ID / App secret
コールバックURLhttps://app.ad-submission.com/api/oauth/pinterest/callback

事前準備(媒体側)

  1. Pinterest developers でアプリを登録し、App ID(Client ID)App secret(Client Secret) を取得します。
  2. アプリの コールバックURL(Redirect URI) に次を完全一致で登録します(末尾スラッシュなし)。
    • https://app.ad-submission.com/api/oauth/pinterest/callback
  3. アプリに広告関連のスコープ(ads:read / ads:write)の利用権限があることを確認します。

連携の手順【アプリ】

  1. 「Pinterest広告」セクションの 「+ Pinterest広告アカウントを連携」 を押します。
  2. 取得した App ID / App secret を入力します。
  3. 「Pinterestで連携する」を押し、Pinterestの同意画面で広告の閲覧・管理権限を許可します。
  4. 認可したアカウントが操作できる広告アカウントがまとめて登録されます。アカウント名はPinterest APIから自動取得されます。

うまくいかないときは

  • 「アクセスできる広告アカウントが見つからない」: Pinterest側でログインしたアカウントに広告アカウントの権限があるか確認してください。
  • Redirect URIエラー: developersに登録したRedirect URIと、実際のアプリURLが完全一致しているか確認します(http/https・末尾スラッシュ)。

ヒント

App secret はサーバーでAES-256-GCM暗号化して保存され、画面やAPIレスポンスに平文で出ることはありません。