> ## Documentation Index
> Fetch the complete documentation index at: https://domoinc-openapi-sync-dataflows.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Pinterest Adsコネクター

## はじめに

Pinterest Adsは、Pinterestで検索、閲覧、発見される際に、より多くの人々にユーザーの製品やコンテンツを表示するのに役立ちます。DomoのPinterest Adsコネクターを使用すると、Pinterest Adsアカウントの配信メトリクスとオブジェクト情報を取得できます。Pinterest APIの詳細については、Pinterestのウェブサイト（
[https://developers.pinterest.com/docs/getting-started/introduction/](https://developers.pinterest.com/docs/getting-started/introduction/)?
）を参照してください。

Data CenterでPinterestアカウントに接続します。このトピックでは、Pinterest Adsコネクターユーザーインターフェースに固有のフィールドとメニューについて説明します。DataSetの追加や更新スケジュールの設定、DataSet情報の編集に関する一般的な情報については、「 [コネクターを使用してDataSetを追加する](/ja/s/article/360042926274 "コネクターを使用してDataSetを追加する") 」を参照してください。

## 必要条件

Pinterest アカウントに接続してDataSetを作成するには、アカウントの認証情報（Pinterestへのログインに使用するメールアドレスとPinterestのパスワード）、Facebook、Google認証情報のいずれかが必要です。

## Pinterestアカウントに接続する

このセクションでは、Pinterest Adsコネクターページの **［認証情報］** および **［詳細］** ペインのオプションについて説明します。このページのほかのペインの項目である **［スケジュール設定］** と **［DataSetに名前を付け、説明を入力］** は、ほとんどのコネクターで共通しています。詳細については、「 [コネクターを使用してDataSetを追加する](/ja/s/article/360042926274 "コネクターを使用してDataSetを追加する") 」を参照してください。

### ［認証情報］ペイン

DomoのPinterest Adsコネクターは接続にOAuthを使用します。そのため、Domo内での認証情報の入力は必要ありません。 **［接続］** をクリック（または、Domoに既存のPinterest Adsアカウントがある場合は **［アカウントを追加］** を選択）すると、Pinterest OAuth画面が開き、Pinterestの認証情報を入力できます。有効なPinterest認証情報を一度入力しておくと、いつでも同じアカウントを使用して新しいPinterest AdsDataSetを作成することができます。コネクターのアカウントは **Data Center** の ［アカウント］ タブで管理できます。このタブについて詳しくは、「 [コネクターのユーザーアカウントを管理する](/ja/s/article/360042926054 "コネクターのユーザーアカウントを管理する") 」を参照してください。

<Note>
  **注記：** Domoで接続する際、既にPinterestにログインしている場合は、 **［アカウントを追加］** をクリックすると自動的に認証されます。ログインしているアカウントとは異なるアカウントに接続したい場合は、まずPinterestからログアウトする必要があります。
</Note>

### ［詳細］ペイン

このペインには、メインとなる **［Reports］** メニューのほか、選択したレポートタイプに応じて表示/非表示になる様々なメニューが含まれています。

<table border="1" cellpadding="1" cellspacing="1" data-aura-rendered-by="33:200;a"><thead><tr><th colspan="1" rowspan="1"><p> メニュー </p></th><th colspan="1" rowspan="1"><p> 説明 </p></th></tr></thead><tbody><tr><td colspan="1" rowspan="1"><p> Report </p></td><td colspan="1" rowspan="1"><p> 実行するPinterestレポートを選択します。以下のレポートが利用できます。 </p><table border="1" cellpadding="1" cellspacing="1"><tbody><tr><td colspan="1" rowspan="1"> Board Details </td><td colspan="1" rowspan="1"> このレポートはボードオブジェクトを返します。 </td></tr><tr><td colspan="1" rowspan="1"> Board Pins </td><td colspan="1" rowspan="1"> このレポートはボードのピンオブジェクトを返します。 </td></tr><tr><td colspan="1" rowspan="1"> Conversion Quality Health Metrics </td><td colspan="1" rowspan="1"> このレポートは、コンバージョン品質ヘルスメトリクスのリストを返します。 </td></tr><tr><td colspan="1" rowspan="1"> Delivery Metrics </td><td colspan="1" rowspan="1"> このレポートは選択したオブジェクトの配信メトリクスを返します。メトリクスに値がない場合、メトリクス辞書に返されない場合があります。 </td></tr><tr><td colspan="1" rowspan="1"> Delivery Metrics' Definitions </td><td colspan="1" rowspan="1"> このレポートはPinterestの配信メトリクスのすべての名前と定義のリストを返します。 </td></tr><tr><td colspan="1" rowspan="1"> Most Clicked Pins </td><td colspan="1" rowspan="1"> このレポートは、指定されたドメインのピンのリストを返します。 </td></tr><tr><td colspan="1" rowspan="1"> Most Repinned Pins </td><td colspan="1" rowspan="1"> このレポートは、指定されたドメインで最もリピンされたピンを返します。 </td></tr><tr><td colspan="1" rowspan="1"> Object Information </td><td colspan="1" rowspan="1"> このレポートは選択したオブジェクトタイプのオブジェクト情報を含むリストを返します。 </td></tr><tr><td colspan="1" rowspan="1"> Pins </td><td colspan="1" rowspan="1"> このレポートは、認証されたユーザーのピンに関する情報を含むリストを返します。 </td></tr><tr><td colspan="1" rowspan="1"> Users </td><td colspan="1" rowspan="1"> このレポートは、認証されたユーザーに関する情報を返します。 </td></tr><tr><td colspan="1" rowspan="1"> User Metrics </td><td colspan="1" rowspan="1"> このレポートは、認証されたユーザーのメトリクスを返します。 </td></tr><tr><td colspan="1" rowspan="1"> User's Boards </td><td colspan="1" rowspan="1"> このレポートは、認証されたユーザーに関するボードサマリーを返します。 </td></tr><tr><td colspan="1" rowspan="1"> Users Top Pin Metrics Client </td><td colspan="1" rowspan="1"> このレポートは、認証されたユーザーのトップピン（上位100件に制限）に関する分析データを返します。 </td></tr><tr><td colspan="1" rowspan="1"> Users Top Video Pin Metrics </td><td colspan="1" rowspan="1"> このレポートは、認証されたユーザーのトップ動画ピン（上位100件に制限）に関する分析データを返します。 </td></tr></tbody></table></td></tr><tr><td colspan="1" rowspan="1"> Board </td><td colspan="1" rowspan="1"> レポートするボードを選択します。 </td></tr><tr><td colspan="1" rowspan="1"><p> Advertiser </p></td><td colspan="1" rowspan="1"><p> 取得するデータの広告主を選択します。 </p></td></tr><tr><td colspan="1" rowspan="1"> Select Health Type </td><td colspan="1" rowspan="1"> データを返すヘルスタイプを選択します。 </td></tr><tr><td colspan="1" rowspan="1"><p> Object Type </p></td><td colspan="1" rowspan="1"><p> 取得するデータのオブジェクトタイプを選択します。 </p></td></tr><tr><td colspan="1" rowspan="1"><p> Select All or Some </p></td><td colspan="1" rowspan="1"><p> 選択したオブジェクトタイプのすべてのオブジェクトを取得するか、指定した数だけ取得するかを選択します。 </p></td></tr><tr><td colspan="1" rowspan="1"><p> Granularity </p></td><td colspan="1" rowspan="1"><p> レポートの粒度を選択します。使用可能なオプションは次のとおりです。 </p><ul><li><p><b> Day </b> 。メトリクスは毎日分割されます。 </p></li><li><p><b> Hour </b> 。メトリクスは毎時分割されます。このデータはリアルタイムなので不正確かもしれません。 </p></li><li><p><b> Total </b> 。メトリクスは指定した日付範囲で集計しされます。 </p></li></ul></td></tr><tr><td colspan="1" rowspan="1"><p> Conversion Report Time </p></td><td colspan="1" rowspan="1"><p> このレポートから返されるコンバージョンメトリクスがレポートされる日付を選択します。コンバージョンイベントには、ユーザーが広告を操作した日付と、ユーザーがコンバージョンイベントを完了した日付の2つの日付が関連付けられています。 </p></td></tr><tr><td colspan="1" rowspan="1"><p> View Window Days </p></td><td colspan="1" rowspan="1"><p> 「表示」アクションのコンバージョンアトリビューションウィンドウとして使用する日数を選択します。 </p></td></tr><tr><td colspan="1" rowspan="1"><p> Engagement Window Days </p></td><td colspan="1" rowspan="1"><p> 「エンゲージメント」（クローズアップまたは保存など）アクションのコンバージョンアトリビューションウィンドウとして使用する日数を選択します。 </p></td></tr><tr><td colspan="1" rowspan="1"><p> Click Window Days </p></td><td colspan="1" rowspan="1"><p> 「クリック」アクションのコンバージョンアトリビューションウィンドウとして使用する日数を選択します。 </p></td></tr><tr><td colspan="1" rowspan="1"> Select Display Names As Column Names </td><td colspan="1" rowspan="1"> 内部名ではなく列名として表示名を使用する場合に選択します。 </td></tr><tr><td colspan="1" rowspan="1"> Domain </td><td colspan="1" rowspan="1"> クエリを実行するドメイン名を入力します。 </td></tr><tr><td colspan="1" rowspan="1"> Aggregation </td><td colspan="1" rowspan="1"> データを集計する期間を選択します。 </td></tr><tr><td colspan="1" rowspan="1"> Entity Status </td><td colspan="1" rowspan="1"> 報告するエンティティのステータスを選択します。 </td></tr><tr><td colspan="1" rowspan="1"><p> Campaign </p></td><td colspan="1" rowspan="1"><p> 取得するデータのキャンペーンを選択します。 </p></td></tr><tr><td colspan="1" rowspan="1"><p> Ad Group </p></td><td colspan="1" rowspan="1"><p> 取得するデータの広告グループを選択します。 </p></td></tr><tr><td colspan="1" rowspan="1"><p> Pin Promotion </p></td><td colspan="1" rowspan="1"><p> 取得するデータのピンプロモーションを選択します。 </p></td></tr><tr><td colspan="1" rowspan="1"> Product Group Ids </td><td colspan="1" rowspan="1"> 製品グループを選択します。 </td></tr><tr><td colspan="1" rowspan="1"><p> Include All Advertisers Your User Has Access To? </p></td><td colspan="1" rowspan="1"><p> 認証済みユーザーがアクセスできるすべての広告主をレポートに含めるかどうかを選択します。 </p></td></tr><tr><td colspan="1" rowspan="1"><p> Duration </p></td><td colspan="1" rowspan="1"><p> 特定の日付か、日付範囲に対してデータを取得するかどうか選択します。 </p></td></tr><tr><td colspan="1" rowspan="1"><p> Report Date </p></td><td colspan="1" rowspan="1"><p> レポートのデータが特定の日付か、今日から何日前までのものかを選択します。 </p></td></tr><tr><td colspan="1" rowspan="1"><p> Select Specific Date </p></td><td colspan="1" rowspan="1"><p> レポートの日付を選択します。 </p></td></tr><tr><td colspan="1" rowspan="1"><p> Days Back </p></td><td colspan="1" rowspan="1"><p> レポートに表示する過去日数を入力します。 </p></td></tr><tr><td colspan="1" rowspan="1"><p> Start Date </p></td><td colspan="1" rowspan="1"><p> 日付範囲の最初の日付が特定の日付なのか、相対的な日付なのかを指定します。範囲の最後の日付は、 <b> ［End Date］ </b> で選択します。 </p></td></tr><tr><td colspan="1" rowspan="1"><p> End Date </p></td><td colspan="1" rowspan="1"><p> 日付範囲の2番目の日付が特定の日付なのか、相対的な日付なのかを指定します。日付範囲の最初の日付は <b> ［Start Date］ </b> で選択します。 </p></td></tr><tr><td colspan="1" rowspan="1"><p> Select Specific Start Date </p></td><td colspan="1" rowspan="1"><p> 日付範囲の最初の日付を選択します。 </p></td></tr><tr><td colspan="1" rowspan="1"><p> Select Specific End Date </p></td><td colspan="1" rowspan="1"><p> 日付範囲の2番目の日付を選択します。 </p></td></tr><tr><td colspan="1" rowspan="1"><p> Days Back to Start From </p></td><td colspan="1" rowspan="1"><p> レポートで表示する、最も過去の日までの日数を入力します。 <b> ［Days Back to End At］ </b> と組み合わせることによって、表示日数の範囲を指定できます。 </p><p> 例えば、 <span class="mt-font-courier-new"> ［Days Back to Start From］ </span> に <b> 10 </b> 、 <span class="mt-font-courier-new"> ［Days Back to End At］ </span> に <b> 5 </b> を入力した場合、レポートには、今日から数えて10日前から5日前のデータが含まれます。 </p></td></tr><tr><td colspan="1" rowspan="1"><p> Days Back to End At </p></td><td colspan="1" rowspan="1"><p> レポートで表示する、直近の日までの日数を入力します。 <b> ［Days Back to Start From］ </b> と組み合わせることによって、表示日数の範囲を指定できます。 </p><p> 例えば、 <b> ［Days Back to Start From］ </b> に <span class="mt-font-courier-new"> 10 </span> 、 <b> ［Days Back to End At］ </b> に <span class="mt-font-courier-new"> 5 </span> を入力した場合、レポートには、今日から数えて10日前から5日前のデータが含まれます。 </p></td></tr></tbody></table>

### その他のペイン

スケジュール設定、再試行、更新に関するオプションなど、コネクターインターフェースのその他のペインに表示されるオプションについては、「 [コネクターを使用してDataSetを追加する](/ja/s/article/360042926274 "コネクターを使用してDataSetを追加する") 」を参照してください。

## よくある質問

<AccordionGroup>
  <Accordion title="このコネクターではどのバージョンのPinterest Ads APIを使用していますか？">
    このコネクターでは、Pinterest Ads APIバージョン3を使用しています。
  </Accordion>

  <Accordion title="各レポートコールによってこのコネクターで呼び出されるのはどのエンドポイントですか？">
    <table class="mt-responsive-table" data-aura-rendered-by="33:200;a"><thead><tr><th colspan="1" rowspan="1"> レポート名 </th><th colspan="1" rowspan="1"> エンドポイントURL </th></tr></thead><tbody><tr><td colspan="1" rowspan="1"> Board Details </td><td colspan="1" rowspan="1"> /boards/\{boardId} </td></tr><tr><td colspan="1" rowspan="1"> Board Pins </td><td colspan="1" rowspan="1"> /boards/\{boardId}/pins </td></tr><tr><td colspan="1" rowspan="1"> Conversion Quality Health Metrics </td><td colspan="1" rowspan="1"> /measurement/conversion\_quality/health </td></tr><tr><td colspan="1" rowspan="1"> Delivery Metrics </td><td colspan="1" rowspan="1"> /\{objectType}/\{objectId}/delivery\_metrics </td></tr><tr><td colspan="1" rowspan="1"> Delivery Metrics' Definitions </td><td colspan="1" rowspan="1"> /resources/delivery\_metrics/ </td></tr><tr><td colspan="1" rowspan="1"> Most Clicked Pins </td><td colspan="1" rowspan="1"> /domains/\{domain}/pins/top/clicks/ </td></tr><tr><td colspan="1" rowspan="1"> Most Repinned Pins </td><td colspan="1" rowspan="1"> /domains/\{domain}/pins/top/repins </td></tr><tr><td colspan="1" rowspan="1"> Object Information </td><td colspan="1" rowspan="1"> /\{objectParent}/\{objectId}/\{ObjectType} </td></tr><tr><td colspan="1" rowspan="1"> Pins </td><td colspan="1" rowspan="1"> /users/\{user}/pins </td></tr><tr><td colspan="1" rowspan="1"> Users </td><td colspan="1" rowspan="1"> /v3/users/me </td></tr><tr><td colspan="1" rowspan="1"> User Metrics </td><td colspan="1" rowspan="1"> /partners/analytics/users/\{me}/metrics </td></tr><tr><td colspan="1" rowspan="1"> User's Boards </td><td colspan="1" rowspan="1"> /users/\{user}/boards/feed/ </td></tr><tr><td colspan="1" rowspan="1"> Users Top Pin Metrics Client </td><td colspan="1" rowspan="1"> /partners/analytics/users/\{me}/pins/top/ </td></tr><tr><td colspan="1" rowspan="1"> Users Top Video Pin Metrics </td><td colspan="1" rowspan="1"> /partners/analytics/users/\{me}/pins/top/video </td></tr></tbody></table>
  </Accordion>

  <Accordion title="ログイン認証情報が保護されていることをどのようにして確認できますか？">
    DomoではPinterestに接続するためにOAuthプロセスが使用されるため、DomoによりDropboxの認証情報が表示または保存されることはありません。DomoのPinterestアカウントへのアクセスはいつでも取り消すことができます。
  </Accordion>

  <Accordion title="データはどれくらいの頻度で更新できますか？">
    DataSetは、1日に1回の更新がかかる設定にする必要があります。
  </Accordion>

  <Accordion title="注意すべきAPI制限はありますか？">
    Pinterestでは、1人のユーザーにつき1時間あたり最大1000件のAPIリクエストが許可されます。複数のリクエストを行う場合に必要になるDataSetの実行は1回です。
  </Accordion>
</AccordionGroup>
