> ## 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.

# Apple Search Ads OAuthコネクター

## はじめに

大口広告主や広告代理店ではApple Search Adsを使用して、多数のキャンペーンをプログラムによって作成して管理するとともに、顧客インサイトとトレンドを得るためにレポートを実行することができます。Apple Search Ads OAuthコネクターを使うと、キャンペーンおよび広告グループのパフォーマンスメトリクスに関するデータを、Apple Search AdsシステムからDomoに取得できます。DomoのApple Seach Ads OAuthコネクターを使用して、Apple Searchデータと他のシステムからのデータを結合し、過去最大数のインサイトを安全に確保することができます。Apple Search Ads APIについて詳しくは、製品ページ（ [https://searchads.apple.com/advanced...gn-management/](https://searchads.apple.com/advanced/help/campaign-management/ "https://searchads.apple.com/advanced/help/campaign-management/") ）を参照してください。

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

## 必要条件

Apple Search Ads OAuthアカウントに接続してDataSetを作成するには、以下が必要です。

* Apple AdsのクライアントID
* Apple AdsのチームID
* Apple AdsのキーID
* シークレットキー。これにはECシークレットキータグの開始と終了も含まれます。

Apple Search Adsに公開キーをアップロードすると、クライアントID、チームID、キーIDを取得できます。

認証情報の取得方法については、[Apple Search Ads OAuthドキュメント](https://developer.apple.com/documentation/apple_search_ads/implementing_oauth_for_the_apple_search_ads_api "https://developer.apple.com/documentation/apple_search_ads/implementing_oauth_for_the_apple_search_ads_api")

を参照してください。

## Apple Search Ads OAuth アカウントに接続する

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

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

このペインには、 Apple Search Ads OAuth アカウントにアクセスするための認証情報を入力するフィールドがあります。以下の表は、各フィールドに必要な内容を説明しています。

<table border="1" cellpadding="1" cellspacing="1" data-aura-rendered-by="33:195;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"> Client ID </td><td colspan="1" rowspan="1"> Apple Search Adsに公開キーをアップロードして取得する、Apple SearchクライアントIDを入力します。認証情報の取得方法については、 <span /><a class="link-https" href="https://developer.apple.com/documentation/apple_search_ads/implementing_oauth_for_the_apple_search_ads_api" target="_blank" title="https://developer.apple.com/documentation/apple_search_ads/implementing_oauth_for_the_apple_search_ads_api"> Apple Search Ads OAuthドキュメント </a><span /> を参照してください。 </td></tr><tr><td colspan="1" rowspan="1"> Team ID </td><td colspan="1" rowspan="1"> Apple Search Adsに公開キーをアップロードして取得する、Apple SearchチームIDを入力します。認証情報の取得方法については、 <span /><a class="link-https" href="https://developer.apple.com/documentation/apple_search_ads/implementing_oauth_for_the_apple_search_ads_api" target="_blank" title="https://developer.apple.com/documentation/apple_search_ads/implementing_oauth_for_the_apple_search_ads_api"> Apple Search Ads OAuthドキュメント </a><span /> を参照してください。 </td></tr><tr><td colspan="1" rowspan="1"> Key ID </td><td colspan="1" rowspan="1"> Apple Search Adsに公開キーをアップロードして取得する、Apple SearchキーIDを入力します。認証情報の取得方法については、 <span /><a class="link-https" href="https://developer.apple.com/documentation/apple_search_ads/implementing_oauth_for_the_apple_search_ads_api" target="_blank" title="https://developer.apple.com/documentation/apple_search_ads/implementing_oauth_for_the_apple_search_ads_api"> Apple Search Ads OAuthドキュメント </a><span /> を参照してください。 </td></tr><tr><td colspan="1" rowspan="1"> Private Key </td><td colspan="1" rowspan="1"> シークレットキー。これにはECシークレットキータグの開始と終了も含まれます。認証情報の取得方法については、 <span /><a class="link-https" href="https://developer.apple.com/documentation/apple_search_ads/implementing_oauth_for_the_apple_search_ads_api" target="_blank" title="https://developer.apple.com/documentation/apple_search_ads/implementing_oauth_for_the_apple_search_ads_api"> Apple Search Ads OAuthドキュメント </a><span /> を参照してください。 </td></tr></tbody></table>

有効な Apple Search Ads OAuth 認証情報を一度入力しておくと、いつでも同じアカウントを使用して新しい Apple Search Ads OAuth DataSetを作成することができます。コネクターアカウントは、Data Centerの **［アカウント］** タブで管理できます。このタブについて詳しくは、「 [コネクターのユーザーアカウントを管理する](/ja/s/article/360042926054) 」を参照してください。

### ［詳細］ペイン

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

<table border="1" cellpadding="1" cellspacing="1" data-aura-rendered-by="33:195;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> レポート </p></td><td colspan="1" rowspan="1"><p> 実行する <span> Apple Search Ads OAuth </span><span class="s1"><span /></span> レポートを選択します。以下のレポートが利用できます。 </p><table border="1" cellpadding="1" cellspacing="1"><tbody><tr><td colspan="1" rowspan="1"> Campaign Report（新規） </td><td colspan="1" rowspan="1"> 選択した組織のすべてのキャンペーンのメタデータとパフォーマンスを返します。 </td></tr><tr><td colspan="1" rowspan="1"> AdGroup Report（新規） </td><td colspan="1" rowspan="1"> 選択したキャンペーンのすべての広告グループのメタデータとパフォーマンスを返します。 </td></tr></tbody></table></td></tr><tr><td colspan="1" rowspan="1"><p> Org ID </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></td></tr><tr><td colspan="1" rowspan="1"><p> Campaign ID </p></td><td colspan="1" rowspan="1"><p> データを取得するキャンペーンのIDを選択します。 </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> レポートの日付 </p></td><td colspan="1" rowspan="1"><p> レポートのデータが特定の日付か、今日から何日前までのものかを選択します。 </p></td></tr><tr><td colspan="1" rowspan="1"><p> 特定の日付を選択 </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><b> ［終了日］ </b></b> で選択します。 </p></td></tr><tr><td colspan="1" rowspan="1"><p> ［End Date］ </p></td><td colspan="1" rowspan="1"><p> 日付範囲の2番目の日付が特定の日付なのか、相対的な日付なのかを指定します。日付範囲の最初の日付は <b><b> ［開始日］ </b></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><b> ［終了日までの日数］ </b></b> と組み合わせることによって、範囲を作成できます。 </p><p> 例えば、 <b><b> ［開始日まで遡る日数］ </b></b> に10、 <b><b> ［終了日まで遡る日数］ </b></b> に5を入力した場合、レポートには、今日から数えて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><b> ［開始日まで遡る日数］ </b></b> と組み合わせることによって、範囲を作成できます。 </p><p> 例えば、 <b><b> ［開始日まで遡る日数］ </b></b> に10、 <b><b> ［終了日まで遡る日数］ </b></b> に5を入力した場合、レポートには、今日から数えて10日前から5日前のデータが含まれます。 </p></td></tr></tbody></table>

### その他のペイン

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

## よくある質問

<AccordionGroup>
  <Accordion title="このコネクターではどのバージョンのApple Search Ads APIを使用しますか？">
    このコネクターはApple Search Ads APIのバージョン3（[https://api-searchads.apple.com/api/v3](https://api-searchads.apple.com/api/v3) ）を使用します。
  </Accordion>

  <Accordion title="各レポートコールによってこのコネクターで呼び出されるのはどのエンドポイントですか？">
    <table data-aura-rendered-by="33:195;a"><tbody><tr><th colspan="1" rowspan="1" width="30%"> レポート名 </th><th colspan="1" rowspan="1" width="70%"> Endpoint URL（1つまたは複数） </th></tr><tr><td colspan="1" rowspan="1"> AdGroup Report </td><td colspan="1" rowspan="1"> /reports/campaigns/\{CAMPAIGN\_ID}/adgroups </td></tr><tr><td colspan="1" rowspan="1"> Campaign Report </td><td colspan="1" rowspan="1"> /reports/campaigns </td></tr></tbody></table>
  </Accordion>

  <Accordion title="このコネクターを作成するにはどのような認証情報が必要ですか？">
    Apple Search Adsアカウントに関連付けられたクライアントID、チームID、キーID、シークレットキーが必要です。Apple Search Adsに公開キーをアップロードすると、クライアントID、チームID、キーIDを取得できます。シークレットキー。これにはECシークレットキータグの開始と終了も含まれます。認証情報の取得方法については、Apple Search Ads OAuthドキュメント
    を参照してください。
  </Accordion>

  <Accordion title="データはどれくらいの頻度で更新可能ですか？">
    必要に応じて何回でも更新できます。
  </Accordion>

  <Accordion title="注意すべきAPI制限はありますか？">
    ありません。

    ## トラブルシューティング

    * 認証が有効であることを確認してください。
    * 設定を見直し、すべての必須項目が選択されていることを確認してください。
    * コネクターの履歴にエラーメッセージが記録されていないかどうかを確認してください。
    * まれに、多過ぎる情報をリクエストした結果、API制限またはタイムアウトに達する場合があります。記録されている場合は、コネクターの実行履歴でエラーメッセージと実行時間を確認することができます。また、取得するアカウント数やレポートのメトリクス数を減らしたり、取得するタイムフレームを短縮したりすることができます。
  </Accordion>
</AccordionGroup>