> ## Documentation Index > Fetch the complete documentation index at: https://domoinc-bradley-turek-pfilter-operators-reference.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 Search Ads OAuthコネクターを使用して、Apple Search Adsデータとほかのシステムからのデータを結合し、過去最大数のインサイトを安全に確保することができます。Apple Search Ads APIの詳細については、製品ドキュメント（[https://developer.apple.com/documentation/apple\_search\_ads](https://developer.apple.com/documentation/apple_search_ads)）を参照してください。 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を取得できます。 認証情報の取得の詳細については、[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アカウントに接続するための認証情報を入力するフィールドがあります。以下の表は、各フィールドに必要な内容を説明しています。 | フィールド | 説明 | | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Client ID | Apple Search Adsにパブリックキーをアップロードして取得する、Apple SearchクライアントIDを入力します。詳細については、[Apple Search Ads OAuthドキュメント](https://developer.apple.com/documentation/apple_search_ads/implementing_oauth_for_the_apple_search_ads_api)を参照してください。 | | Team ID | Apple Search Adsにパブリックキーをアップロードして取得する、Apple SearchチームIDを入力します。詳細については、[Apple Search Ads OAuthドキュメント](https://developer.apple.com/documentation/apple_search_ads/implementing_oauth_for_the_apple_search_ads_api)を参照してください。 | | Key ID | Apple Search Adsにパブリックキーをアップロードして取得する、Apple SearchキーIDを入力します。詳細については、[Apple Search Ads OAuthドキュメント](https://developer.apple.com/documentation/apple_search_ads/implementing_oauth_for_the_apple_search_ads_api)を参照してください。 | | Private Key | 秘密鍵を入力します。これにはEC秘密鍵の開始タグと終了タグも含まれます。詳細については、[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を作成することができます。コネクターアカウントは、Data Centerの\*\*［アカウント］\*\*タブで管理できます。このタブの詳細については、「[コネクター/アダプターアカウントを管理する](/ja/s/article/360042926054)」を参照してください。 ## ［詳細］ペイン このペインには、メインの\*\*［Report］\*\*メニューのほか、選択したレポートタイプに応じて表示/非表示になるその他様々なメニューがあります。 | メニュー | 説明 | | -------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Report | 実行するApple Search Ads OAuthレポートを選択します。以下のレポートが利用できます。
**レポート名****説明**
AdGroup Report（新規）選択したキャンペーンのすべての広告グループのメタデータとパフォーマンスのメトリクスを返します。
Campaign Report（新規）選択した組織のすべてのキャンペーンのメタデータとパフォーマンスのメトリクスを返します。
Keyword Reportキャンペーン内のターゲティングキーワードのすべてのレポートのメタデータとパフォーマンスのメトリクスを返します。
Keyword Within AdGroup Report広告グループ内のターゲティングキーワードのすべてのレポートのメタデータとパフォーマンスのメトリクスを返します。
Search Term-level Reportキャンペーン内の検索語のレポートを取得します。
| | Org ID | データを取得する組織を選択します。 | | Granularity | レポートの日付粒度を選択します。 | | Campaign ID | データを取得するキャンペーンのIDを選択します。 | | Duration | 特定の日付のデータを取得するのか、日付範囲のデータを取得するのかを選択します。 | | Report Date | 特定の日付のレポートデータを取得するのか、今日から指定した日数を遡った日までのレポートデータを取得するのかを選択します。 | | Select Specific Date | レポートの日付を選択します。 | | Days Back | レポートに表示する過去日数を入力します。 | | Start Date | 日付範囲の開始日を、特定とするか相対とするかを指定します。範囲の最後の日付は、\*\*\*\*［End Date］\*\*\*\*で選択します。 | | End Date | 日付範囲の2番目の日付が特定なのか、相対なのかを指定します。日付範囲の最初の日付は\*\*\*\*［Start Date］\*\*\*\*で選択します。 | | Select Specific Start Date | 日付範囲の最初の日付を選択します。 | | Select Specific End Date | 日付範囲の2番目の日付を選択します。 | | Days Back to Start From | レポートで表示する過去の日のうち、現在から最も遠い日までの日数を入力します。\*\*\*\*［Days Back to End At］****と組み合わせることによって、表示日数の範囲を指定できます。 例えば、****［Days Back to Start From］****に「10」、****［Days Back to End At］\*\*\*\*に「5」を入力した場合、レポートには、今日から数えて10日前から5日前のデータが含まれます。 | | Days Back to End At | レポートで表示する過去の日のうち、現在から最も近い日までの日数を入力します。\*\*\*\*［Days Back to Start From］****と組み合わせることによって、表示日数の範囲を指定できます。 例えば、****［Days Back to Start From］****に「10」、****［Days Back to End At］\*\*\*\*に「5」を入力した場合、レポートには、今日から数えて10日前から5日前のデータが含まれます。 | ## その他のペイン スケジュール設定、再試行、更新オプションなど、その他のコネクターインターフェースのセクションの詳細については、「[コネクターを使用してDataSetを追加する](/ja/s/article/360042926274)」を参照してください。 ## よくある質問 このコネクターはApple Search Ads APIのバージョン5（[https://api.searchads.apple.com/api/v5）を使用します。](https://api.searchads.apple.com/api/v5）を使用します。) | レポート名 | エンドポイントURL（1つまたは複数） | | ----------------------------- | ------------------------------------------ | | AdGroup Report（新規） | /reports/campaigns/adgroups | | Campaign Report（新規） | /reports/campaigns | | Keyword Report | /reports/campaigns/%s/keywords | | Keyword Within AdGroup Report | /reports/campaigns/%s/adgroups/%s/keywords | | Search Term-level Report | /reports/campaigns/%s/searchterms | Apple Search Adsアカウントに関連付けられたクライアントID、チームID、キーID、秘密鍵が必要です。Apple Search Adsにパブリックキーをアップロードすると、クライアントID、チームID、キーIDを取得できます。秘密鍵を入力する必要があります。これにはEC秘密鍵の開始タグと終了タグも含まれます。\ 認証情報の取得方法については、[Apple Search Ads OAuthドキュメント](https://developer.apple.com/documentation/apple_search_ads/implementing_oauth_for_the_apple_search_ads_api)を参照してください。 必要に応じて何回でも更新できます。 ありません。 ## トラブルシューティング * 認証が有効であることを確認してください。 * 設定を見直し、すべての必須項目が選択されていることを確認してください。 * コネクターの履歴にエラーメッセージが記録されていないかどうかを確認してください。 * まれに、多過ぎる情報をリクエストした結果、API制限またはタイムアウトに達する場合があります。記録されている場合は、コネクターの実行履歴でエラーメッセージと実行時間を確認することができます。また、取得するアカウント数やレポートのメトリクス数を減らしたり、取得するタイムフレームを短縮したりすることができます。