メインコンテンツへスキップ

Documentation Index

Fetch the complete documentation index at: https://domoinc-jkreitzman-patch-1.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

​
はじめに

大口広告主や広告代理店は、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にパブリックキーをアップロードすると、クライアントID、チームID、キーIDを取得できます。 認証情報の取得の詳細については、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を追加する」を参照してください。

​
［認証情報］ペイン

このペインには、Apple Search Ads OAuthアカウントに接続するための認証情報を入力するフィールドがあります。以下の表は、各フィールドに必要な内容を説明しています。
フィールド説明
Client IDApple Search Adsにパブリックキーをアップロードして取得する、Apple SearchクライアントIDを入力します。詳細については、Apple Search Ads OAuthドキュメントを参照してください。
Team IDApple Search Adsにパブリックキーをアップロードして取得する、Apple SearchチームIDを入力します。詳細については、Apple Search Ads OAuthドキュメントを参照してください。
Key IDApple Search Adsにパブリックキーをアップロードして取得する、Apple SearchキーIDを入力します。詳細については、Apple Search Ads OAuthドキュメントを参照してください。
Private Key秘密鍵を入力します。これにはEC秘密鍵の開始タグと終了タグも含まれます。詳細については、Apple Search Ads OAuthドキュメントを参照してください。
有効なApple Search Ads OAuth認証情報を一度入力しておくと、いつでも同じアカウントを使用して新しいApple Search Ads OAuth DataSetを作成することができます。コネクターアカウントは、Data Centerの**［アカウント］**タブで管理できます。このタブの詳細については、「コネクター/アダプターアカウントを管理する」を参照してください。

​
［詳細］ペイン

このペインには、メインの**［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を追加する」を参照してください。

​
よくある質問

このコネクターはApple Search Ads APIのバージョン5（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ドキュメントを参照してください。
必要に応じて何回でも更新できます。
ありません。

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

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