> ## 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. # X Adsコネクター ## はじめに X Adsとは、まだ自社をフォローしていない潜在的な顧客にメッセージをツイートし、リーチを広げる広告サービスです。DomoのX Adsコネクターを使用すると、アカウント、キャンペーン、資金調達、行項目、ツイートの統計情報データを取得することができます。X APIの詳細については、Xのドキュメント（ [https://developer.x.com/en/docs](https://developer.twitter.com/en/docs "https://developer.x.com/en/docs") ）を参照してください。 X Adsコネクターは「クラウドApp」コネクターであるため、クラウドに保管されたデータの取得が可能です。Data Centerでウィンドウ上部のツールバーで **［クラウドApp］** をクリックすると、これを含むほかのクラウドAppコネクターのページにアクセスできます。このトピックでは、X Adsコネクターのユーザーインターフェースに固有のフィールドとメニューについて説明します。DataSetの追加、更新スケジュールの設定およびDataSet情報の編集に関する一般的な情報は、「 [コネクターを使用してDataSetを追加する](/ja/s/article/360042926274 "コネクターを使用してDataSetを追加する") 」を参照してください。

主な使用事例	このコネクターを使用すると、X Adsを使用しているインプレッションや、自身のリーチの状況を確認できます。
主なメトリクス	エンゲージメントの合計数インプレッションの合計数リツイートの合計数返信の合計数「いいね」の合計数フォローの合計数お気に入りやその他のエンゲージメントなどのクリックの合計回数正当なインプレッションの合計数
社内における主な権限	すべてのマーケティング権限
平均導入時間	10分以下
使いやすさ（1～10段階。1が「最も使いやすい」）	2

## ベストプラクティス * **［Append］** の代わりに **［Replace］** を使用するDataSetを作成し、1回当たり過去3〜7日間のデータのみを取得します。 * 再帰的DataFlowを使用してデータの重複排除と追加を行います。詳細については、「 [再帰的/スナップショットのMagic ETL DataFlowを作成する](/ja/s/article/360043428113 "再帰的/スナップショットのMagic ETL DataFlowを作成する") 」を参照してください。 * 過去のプロモツイートの統計情報を収集し、最新のツイートデータで更新するには、以下のステップに従います。 1. 新しいX Ads DataSetを作成します。 **ヒント：** 必要に応じてここに記載されていない多数の設定を追加できます。2つの異なるレポート（Promoted Tweet Statistics v.1とRecent Promoted Tweets Statistics v.1）を選択することに注意してください。これらの両方の設定が一致していることを確認してください。 2. 最初に実行するコネクターを設定します。次のように設定してください。 1. **［Report］** で［Promoted Tweets Statistics v.1］を選択します。 2. レポートは過去90日間のデータを取得するようにします。コネクターによってデータの期間は90日間に制限されます。それ以上の期間のデータが必要な場合は、過去の日付を選択した後、この日付から90日間を選択し、［Append］を使用してレポートを実行します。次の90日間を選択し、再度［Append］を使用してDataSetを実行します。この操作を必要な過去データがすべて収集されるまで繰り返し行います。 3. 設定を保存します。 4. コネクターは［Replace］ではなく［Append］を使用してスケジュールします。 5. コネクターを実行します。 6. 実行が完了したら、2回目の実行時に次のようにコネクターを再設定します。 1. **［Report］** で［Recent Promoted Tweets Statistics v.2］を選択します。 2. **［Tweets Selection Window］** で **［Past 3 Months］** を選択します。 3. レポートの期間は、昨日のデータを取得するようにします。 **注記：** その他の設定は、最初に実行したときの設定と一致させる必要があります。唯一の違いは、選択するプロモツイートがないことです。このレポートでは、昨日アクティビティがあったすべてのプロモツイートに関するツイートアクティビティが取り込まれるためです。 7. 設定を保存します。 8. スケジュールが［Append］に設定されていることを確認します。 9. コネクターで次のスケジュールを実行します。明日実行することで、前日の最新のツイートアクティビティを収集できます。プロモツイートの履歴を選択し、昨日のプロモツイートのアクティビティを収集するようにDataSetを設定しました。これらのアクティビティは収集した履歴に追加されます。 ## 必要条件 X Adsアカウントに接続してX Ads DataSetを作成するには、以下が必要です。 * X Adsアカウントにログインするために使用するXアカウント。 * Xアカウントへのログインに使用するパスワード ## X Adsアカウントに接続するこのセクションでは、X Adsコネクターページの **［認証情報］** および **［詳細］** ペインのオプションについて説明します。このページ内のほかのペインに含まれるコンポーネントである **［スケジュール設定］** や **［DataSetに名前を付け、説明を入力］** に関しては、ほとんどのタイプのコネクターで共通しています。詳細については「 [コネクターを使用してDataSetを追加する](/ja/s/article/360042926274 "コネクターを使用してDataSetを追加する") 」を参照してください。 ## ［認証情報］ペイン Domo X AdsコネクターはX Adsへの接続にOAuthを使用しています。 **［接続］** をクリック（またはDomoにX Adsアカウントがある場合は **［アカウントを追加］** を選択）して、X AdsのOAuth画面を開き、Xアカウントに関連付けられている認証情報を入力します。有効なX認証情報を入力しておくと、Domoで随時同じアカウントを使用してX Ads DataSetを作成できます。コネクターのアカウントは **Data Center** の［アカウント］タブで管理できます。このタブの詳細については、「 [ユーザーグループの作成と管理](/ja/s/article/360042934294 "ユーザーグループの作成と管理") 」を参照してください。 ## ［詳細］ペインこのペインにはメインメニューの **［Report］** のほか、選択したレポートに応じて表示されるその他のメニューがあります。

メニュー

説明

Report

X Adsレポートを選択します。以下のレポートが利用できます。

Account Media	指定アカウントに関連付けられているすべてのアカウントメディアの詳細を取得します。
Account Statistics	指定したアカウントで実行されたキャンペーンに関する分析のサマリーを取得します。
All Campaigns	指定したアカウントで実行されたすべてのキャンペーンを取得します。
All Funding Instruments	指定したアカウントのすべての資金調達を取得します。
All Line Items	指定したアカウントのすべての行項目を取得します。
All Promoted Tweets	指定したアカウントのすべてのプロモツイートを取得します。
Campaign Reach	指定したキャンペーンのリーチと平均頻度の分析を取得します。
Campaign Statistics	指定したアカウントで実行されたキャンペーンに関する分析のサマリーを取得します。
Funding Instruments Reach	指定した資金調達のリーチと平均頻度の分析を取得します。
Funding Instruments Statistics	指定したアカウントの特定の資金調達に関する分析のサマリーを取得します。
Line Item Statistics	現在のユーザーがアクセスできる行項目に関する分析のサマリーを取得します。
Media Creatives	指定したアカウントに関連付けられているメディアクリエイティブの詳細を取得します。
Media Creatives Statistics	指定したアカウントの特定のメディアクリエイティブに関する分析のサマリーを取得します。
Media Library	アカウントに関連付けられているメディアライブラリオブジェクトの詳細を取得します。
Organic Tweet Statistics	現在のユーザーがアクセスできるプロモツイートに関する分析のオーガニックサマリーを取得します。
Promoted Tweet Statistics	現在のユーザーがアクセスできるプロモツイートに関する分析のサマリーを取得します。
Reach Estimate（廃止）	指定したアカウントのキャンペーンの推定リーチを判別します。このレポートは、2020年9月1日以降は利用できなくなりました。
Recent Organic Tweet Statistics	現在のユーザーがアクセスできる最近のプロモツイートに関する分析のオーガニックサマリーを取得します。
Recent Promoted Tweet Statistics	現在のユーザーがアクセスできる最近のアクティブプロモツイートに関する分析のサマリーを取得します。
Tweets	アカウントのツイートの詳細を取得します。

Account

データをクエリするX Adsアカウントを選択します。

Duration

1日のデータを取得するか、日付範囲を指定してデータを取得するかを選択します。

Report Date

特定の日付のデータを取得するか、日数を遡ってデータを取得するかを指定します（オフセット）。

Specific Date

データを取得する日付を選択します。

Days Back

何日間遡った日をデータの取得日とするかを入力します。

Start Date

日付範囲の最初の日付に特定の日付を設定するか、遡る日数を設定するかを指定します（オフセット）。

Specific Start Date

日付範囲の開始日を選択します。

End Date

日付範囲の最後の日付に特定の日付を設定するか、遡る日数を設定するかを指定します（オフセット）。

Specific End Date

日付範囲の終了日を選択します。

Days Back to Start From

日付範囲の開始日まで遡る日数（オフセット）を入力します。例えば、 ［Days Back to Start From］ に「 10 」、 ［Days Back to End At］ に「 5 」と入力した場合、レポートを実行すると、10日前から5日前までのデータが取得されます。

Days Back to End At

日付範囲の終了日までの日数（オフセット）を入力します。例えば、 ［Days Back to Start From］ に「 10 」、 ［Days Back to End At］ に「 5 」と入力した場合、レポートを実行すると、10日前から5日前までのデータが取得されます。

Granularity

必要な粒度を選択します。例えば、粒度が ［Hour］ の場合、 ［Start Date］ から ［End Date］ の範囲内のデータが時間ごとに表示されます。

Segmentation Type

必要なセグメントのタイプを選択します。

Placement

利用可能なオプションから必要なプレースメントを選択します。

例えば、プレースメントが ［ALL ON X］ の場合、データはXで利用可能なすべてのプレースメントタイプで表示されます。プレースメントが ［Publisher Network］ の場合、データはXオーディエンスプラットフォームで表示されます。 ［Total］ は、［Publisher Network］と［All On X］の両方の結果を合計します。

Country

データを返す国を選択します。

Platform

データを返すプラットフォームを選択します。

### その他のペインスケジュール設定、再試行、更新に関するオプションなど、コネクターインターフェースのその他のペインに表示されるオプションについては、「 [コネクターを使用してDataSetを追加する](/ja/s/article/360042926274 "コネクターを使用してDataSetを追加する") 」を参照してください。 ## よくある質問まだプロモートされていないツイートのエンゲージメントメトリクスを取得するには、X Engagement APIを使用するX Engagementコネクターを使用する必要があります。 X Engagement APIは、XのエンタープライズレベルのAPIの1つです。このAPIを使用する場合、企業はXとの契約に署名する必要があります。Xとの契約を締結してこのAPIにアクセスする方法および詳細については、 [X Enterpriseデータ](https://developer.twitter.com/en/products/twitter-api/enterprise "X Enterpriseデータ") を参照してください。お客様がX Engagement APIにアクセスできるようになったら、アカウントエグゼクティブまたはカスタマーサクセスマネージャーにご連絡ください。Domoインスタンスのコネクターにアクセスできるようにします。 X AdsコネクターのベースURLは、 [https://ads-api.X.com/で](https://ads-api.X.com/で) す。

レポート名	エンドポイント（1つまたは複数）
Account Media	/10/accounts/\{account\_id}/account\_media
Account Statistics	/10/stats/accounts/\{account\_id}?entity=ACCOUNT
All Campaigns	/10/accounts/\{account\_id}/campaigns
All Funding Instruments	/10/accounts/\{account\_id}/funding\_instruments
All Line Items	/10/accounts/\{account\_id}/line\_items
All Promoted Tweets	/10/accounts/\{account\_id}/promoted\_tweets?with\_deleted=true
Campaign Reach	/10/stats/accounts/\{account\_id}/reach/campaigns
Campaign Statistics	/10/stats/accounts/\{account\_id}?entity=CAMPAIGN
Funding Instruments Reach	/10/stats/accounts/\{account\_id}/reach/funding\_instruments
Funding Instruments Statistics	/10/stats/accounts/\{account\_id}?entity=funding\_instruments
Line Item Statistics	/10/stats/accounts/\{account\_id}?entity=LINE\_ITEM
Media Creatives	/10/accounts/\{account\_id}/media\_creatives
Media Creatives Statistics	/10/stats/accounts/\{account\_id}?entity=MEDIA\_CREATIVES
Media Library	/10/accounts/\{account\_id}/media\_library
Organic Tweet Statistics	/10/stats/accounts/\{account\_id}?entity=ORGANIC\_TWEET
Promoted Tweet Statistics	/10/stats/accounts/\{account\_id}?entity=PROMOTED\_TWEET
Reach Estimate（廃止）	/6/accounts/\{account\_id}/reach\_estimate
Recent Organic Tweet Statistics	/10/stats/accounts/\{account\_id}?entity=ORGANIC\_TWEET
Recent Promoted Tweet Statistics	/10/accounts/\{account\_id}?entity=PROMOTED\_TWEET
Tweets	/10/accounts/\{account\_id}/tweets

あなたのXアカウントに関連するメールアドレスまたはXハンドルとパスワードが必要です。ログインプロセスではOAuthプロセスが使用されるため、Domoによって認証情報が表示または保存されることはありません。これにより、ログインの安全性が保たれます。Domoのアカウントへのアクセスはいつでも取り消すことができます。広告アカウントが必要です。広告アカウントは「 [ads.X.com](http://ads.X.com) 」で登録できます。1つの広告アカウントに複数のXユーザーアカウントを関連付けることができます。ほとんどの情報はすぐに利用できます。DataSet設定は、24時間ごとに実行することを推奨します。はい。このような状況は通常、コネクターが返すデータがない場合に発生します。開始日以降にアカウントでアクティビティ（新しいツイート、リツイートなど）がない場合に、最も頻繁に発生します。一部のレポートは、実行に非常に時間がかかることがあります。一部のレポートでは、複数のレベルのデータを読み取り、各ステップでXに対して複数の呼び出しを行う必要があります。全期間のすべてのツイートを選択して実行すると、さらに時間がかかります。 ## トラブルシューティングトラブルシューティングは通常、認証情報に問題がないことを確認することから始まります。問題がない場合は、リクエストがタイムアウトしていないことを確認してください。全期間のすべてのツイートを選択して実行している場合、実行時間が長くなります。これらの問題が発生している場合は、取得するツイートの数や期間を調整してください。