はじめに
大口広告主や広告代理店は、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）を参照してください。 Apple Search Ads OAuthアカウントには、Data Centerから接続します。このトピックでは、Apple Search Ads OAuthコネクターのユーザーインターフェースに固有のフィールドとメニューについて説明します。DataSetの追加や更新スケジュールの設定、DataSet情報の編集に関する一般的な情報は、「コネクターを使用してDataSetを追加する」を参照してください。必要条件
Apple Search Ads OAuthアカウントに接続してDataSetを作成するには、以下が必要です。- Apple AdsのクライアントID
- Apple AdsのチームID
- Apple AdsのキーID
- 秘密鍵。これにはEC秘密鍵の開始タグと終了タグも含まれます。
Apple Search Ads OAuthアカウントに接続する
このセクションでは、Apple Search Ads OAuthコネクターページの**［認証情報］および［詳細］ペインのオプションについて説明します。このページのほかのペインの項目である［スケジュール設定］や［DataSetに名前を付け、説明を入力］**に関しては、ほとんどのタイプのコネクターで共通しています。詳細については、「コネクターを使用してDataSetを追加する」を参照してください。［認証情報］ペイン
このペインには、Apple Search Ads OAuthアカウントに接続するための認証情報を入力するフィールドがあります。以下の表は、各フィールドに必要な内容を説明しています。
有効なApple Search Ads OAuth認証情報を一度入力しておくと、いつでも同じアカウントを使用して新しいApple Search Ads OAuth DataSetを作成することができます。コネクターアカウントは、Data Centerの**［アカウント］**タブで管理できます。このタブの詳細については、「コネクター/アダプターアカウントを管理する」を参照してください。
［詳細］ペイン
このペインには、メインの**［Report］**メニューのほか、選択したレポートタイプに応じて表示/非表示になるその他様々なメニューがあります。その他のペイン
スケジュール設定、再試行、更新オプションなど、その他のコネクターインターフェースのセクションの詳細については、「コネクターを使用してDataSetを追加する」を参照してください。よくある質問
このコネクターではどのバージョンのApple Search Ads APIを使用しますか？
このコネクターではどのバージョンのApple Search Ads APIを使用しますか？
このコネクターはApple Search Ads APIのバージョン5（https://api.searchads.apple.com/api/v5）を使用します。
各レポートコールによってこのコネクターで呼び出されるのはどのエンドポイントですか？
各レポートコールによってこのコネクターで呼び出されるのはどのエンドポイントですか？
このコネクターを作成するにはどのような認証情報が必要ですか？
このコネクターを作成するにはどのような認証情報が必要ですか？
Apple Search Adsアカウントに関連付けられたクライアントID、チームID、キーID、秘密鍵が必要です。Apple Search Adsにパブリックキーをアップロードすると、クライアントID、チームID、キーIDを取得できます。秘密鍵を入力する必要があります。これにはEC秘密鍵の開始タグと終了タグも含まれます。
認証情報の取得方法については、Apple Search Ads OAuthドキュメントを参照してください。
認証情報の取得方法については、Apple Search Ads OAuthドキュメントを参照してください。
データはどれくらいの頻度で更新可能ですか？
データはどれくらいの頻度で更新可能ですか？
必要に応じて何回でも更新できます。
注意すべきAPI制限はありますか？
注意すべきAPI制限はありますか？
ありません。
トラブルシューティング
- 認証が有効であることを確認してください。
- 設定を見直し、すべての必須項目が選択されていることを確認してください。
- コネクターの履歴にエラーメッセージが記録されていないかどうかを確認してください。
- まれに、多過ぎる情報をリクエストした結果、API制限またはタイムアウトに達する場合があります。記録されている場合は、コネクターの実行履歴でエラーメッセージと実行時間を確認することができます。また、取得するアカウント数やレポートのメトリクス数を減らしたり、取得するタイムフレームを短縮したりすることができます。