基本
Ads API の階層構造と用語
Ads API で成果を上げるには、X Ads のエンティティ同士の関係を理解することが重要です。本チュートリアルでは、X Ads のオブジェクト階層の基本を解説します。
Ads API では line items と呼ばれる広告グループは、キャンペーン配下に存在し、特定の X ユーザーの集合に対するターゲティングと入札に使用されます。広告主は、ラインアイテムに関連付けることで、投稿やメディア（例：In-stream 広告として配信される動画）をプロモーションします。「広告グループ」も参照してください。
アカウントメディアとして広告アカウントにアップロードされたクリエイティブの集合。プロモーション可能な動画のプリロールアセット（インストリーム広告とも呼ばれる）や、X Audience Platformで配信可能な画像などを含む場合があります。
X Ads の階層の最上位には広告アカウントがあります。広告アカウントは複数の X ユーザーが管理できます。デモ用の家具店アカウント @Furni は、広告アカウントを管理するユーザーの例です。広告アカウントは、base36 の英数字文字列である account_id で識別します。
各アカウントには、キャンペーン間で再利用できる複数のエンティティタイプを保存します。たとえば、ターゲティングに利用できるカスタムオーディエンス、動画や画像といったアカウントメディア、そして Post に追加できる拡張クリエイティブであるカードなどです。
動画アセットをアップロードする際、アップロード主体は動画のカテゴリ（例: Tweet Video、Tweet Gif、Tweet Image、Amplify Video）を指定できます。インストリーム広告として配信する動画をアップロードする場合は、Amplify Video カテゴリの指定が必須です。これらの動画は配信可能であることを確保するため特別な処理が必要となるため、メディアカテゴリとして Amplify Video を指定する必要があります。
アナリティクスの指標は、パートナーや広告主がX上でプロモーションしたコンテンツの成果を把握するのに役立ちます。これには、インプレッション、クリック、動画再生数、支出額などの情報が含まれます。さらに、パートナーや広告主は、リーチしたオーディエンスの各種セグメントごとの詳細な指標を取得できます。
Ads APIは、詳細なキャンペーン成果指標の取得方法として、同期と非同期の2通りをサポートしています。
同期アナリティクスのリクエストでは、要求した指標がレスポンスで返されます。同期エンドポイントは短い期間の集計に対応しており、リアルタイムのキャンペーン成果の照会に最適です。
非同期アナリティクスのエンドポイントでは、関連する「ジョブ」の処理が完了した後、要求した指標がダウンロード可能な結果ファイルとして提供されます。非同期エンドポイントは、より長期間にわたる指標のリクエストに対応し、セグメント化データの返却を可能にし、より大容量のデータ取得を想定しています。レポート作成や過去データの補完に最適です。
広告主が実施する各キャンペーンは、既存の資金手段の下で作成する必要があります。キャンペーンでは、広告キャンペーンの名称、スケジュール、予算などを定義できます。Furni の例でいえば、「Furni home decor」というキャンペーンを作成することが考えられます。
なお、広告アカウントで同時に有効にできるキャンペーンは最大 200 件に制限されています。この上限は広告主のアカウントマネージャーにより引き上げられる場合があります。キャンペーンは、終了時刻に達するか予算を使い切るまでアクティブと見なされます。一時停止中のキャンペーンも、キャンペーン数の上限を算定する目的ではアクティブなキャンペーンとして扱われます。
Cards は、Tweet を視覚的に拡張し、画像・動画・UI 要素を含められる仕組みです。Ads API は、Tweet で使用でき、その後キャンペーンで配信（プロモーション）可能な複数のカードタイプをサポートしています。
広告主は、画像、GIF、動画などのクリエイティブを含むキャンペーンでTweetをプロモーションできます。これらのクリエイティブは、Tweetにリッチな写真、動画、メディア体験を添付できるXカードに関連付けることができます。クリエイティブはTweetに直接添付することも可能です。たとえば、テキストと動画（または最大3枚の画像）を組み合わせて、プロモーション対象のTweetを作成できます。
各ラインアイテムは、配信するために少なくとも1つのクリエイティブを関連付ける必要があります。利用可能なクリエイティブのオプションとしては、新しいフォロワー獲得を目的としたPromoted Accounts、TX Audience Platform全体のラインアイテムで使用できる画像や動画といったMedia Creatives、またはPromoted Postsなどがあります。
広告アカウントには「資金手段」も含まれます。これは、広告主がX Adsでの支払いに使用するために設定した各種の支払い元を指します。たとえば、Xと締結したインサーションオーダー（IO）から、アカウントに紐づけられたクレジットカードまでが該当します。
キャンペーン内には、広告グループ（Ads API では「ラインアイテム」とも呼びます）を1つ以上含めることができます。ラインアイテムはキャンペーン内の別々のセグメントと捉えることができ、それぞれに固有のターゲティング設定とクリエイティブがあります。複数のラインアイテムを含むキャンペーンは、「広告グループキャンペーン」と呼ばれることがあります。
単一のキャンペーン内に複数のラインアイテムを設定する利点の1つは、ターゲティングとクリエイティブの組み合わせをより多様に作成できる点です。
「Furni home decor」キャンペーンでは、たとえば2つのラインアイテムを作成できます。1つは「サンフランシスコの住宅購入者」、もう1つは「ロンドンの住宅購入者」のように設定します。
1つのキャンペーンにつき最大100件のラインアイテムが許可されており、広告アカウント全体でアクティブなラインアイテムは合計4,000件までに制限されています。
モバイルアプリプロモーション（MAP）は、広告主がX上でモバイルアプリを宣伝できる製品スイートです。これには、アプリのインストール、コンバージョン、リエンゲージメントが含まれます。
Xのモバイルアプリプロモーション計測により、広告主は、インストールやその他のアプリ内コンバージョンの促進を目的としたX上の広告キャンペーンの成果を測定できます。Xのモバイル計測パートナーは、広告主がXでプロモーションしているアプリについて、どのコンバージョンを追跡するかを管理できる機能を提供します。MACTの概要
Media Library エンドポイントは、X Ads アカウント向けに画像、GIF、動画の管理機能を提供します。ライブラリ内のメディアアセットは、Post で使用したり、カードの作成に利用できます。さらに、同一のアセットを複数のクリエイティブで再利用できるため、同じアセットを繰り返しアップロードする必要がありません。
プロモートアカウント（フォロワー獲得キャンペーン）は「おすすめユーザー（Who to Follow）」の一部で、現在フォローしていないが興味を持つ可能性のあるアカウントを提案します。プロモートアカウントは、ユーザーが楽しめる多様なアカウントとの出会いを促進します。
プロモートアカウントは、広告主が自分のアカウントを宣伝し、X 上でオーディエンスを拡大するための手段です。フォロワー獲得キャンペーンは、ホームタイムライン、Who to Follow、検索結果など、X プラットフォーム内の複数の場所に表示され、他のおすすめアカウントと区別するために「プロモーション」としてラベル付けされます。
各 X 広告アカウントには、広告アカウントを通じてプロモーションできる「プロモート可能なユーザー」を1名以上設定できます。Furni の @Furni ハンドルは、Furni の広告アカウントにおける FULL プロモート可能ユーザーの例であり、@Furni とそのツイートに対してあらゆる種類のキャンペーンを実施できることを意味します。1つの広告アカウントで設定できる FULL プロモート可能ユーザーは1名のみです。
なお、広告アカウントには他のプロモート可能なユーザーを設定することもできます。たとえば、Furni 製品に関する @Jack の Tweet をプロモーションしたい場合、彼はアカウント上で RETWEETS_ONLY として示される「リツイートのみ」のプロモート可能ユーザーになります。広告主は、広告アカウントにリツイートユーザーを追加する方法について、担当の X アカウントマネージャーにお問い合わせください。
プロモ動画は、広告主が費用を支払って配信されるPromoted Tweet内の動画です。ホームタイムライン、Xの検索結果の最上部、その他の表示面に掲載され、明確に「Promoted」と表示されます。
X Audience Platform をご参照ください。
予約投稿（Scheduled Tweets）を使用すると、広告主やユーザーは、後日の指定日時に公開されるように Tweet を作成してスケジュールできます。これらの Tweet を作成・管理できるだけでなく、API により、Tweet が公開されたタイミングでプロモーションできるように、それらの Tweet を line item に関連付けることも可能です。これにより、広告主はネイティブな Tweet を事前に用意し、重要な施策に先立ってキャンペーンクリエイティブを計画できます。たとえば、新製品発表の直後に公開されるように Tweet クリエイティブを事前に設定するといった使い方が可能です。
セグメンテーションを使用すると、パートナーや広告主は、年齢、デバイス、言語などの特定のターゲティング値ごとに分割された指標を取得できます。これは当社の非同期分析エンドポイントでのみ利用可能です。セグメント別の指標をリクエストするには、segmentation_type リクエストパラメータを使用してください。セグメンテーションのオプションの詳細は、「Metrics and Segmentation」を参照してください。
リスト由来のテーラードオーディエンスは、独自のユーザーや顧客データを含むファイルをアップロードして作成する、テーラードオーディエンスの3種のうちの1つです。アップロードしたリストはX上のユーザーと照合され、キャンペーンで直接ターゲティングできるようになります。これらの制限事項をご確認ください。
Web 由来のテーラードオーディエンスは、3 種類あるテーラードオーディエンスのうちの 1 つで、サイトを訪れた X ユーザーの集合です。Web 由来のテーラードオーディエンスを利用するには、ウェブサイトに X ピクセルを実装するか、X が承認するタグマネージャーパートナーのいずれかを利用する必要があります。これらの制限事項をご確認ください。
前述のとおり、ターゲティング条件はラインアイテムに関連付けられます。ロケーション、キーワード、性別から、ユーザーの行動や興味・関心といったより細かな属性まで、さまざまなターゲティングを利用できます。「Home Buyers in San Francisco」というラインアイテムでは、「home buying」という行動と「San Francisco」というロケーションを組み合わせてターゲティングすることが想定されます。
利用可能なターゲティングの種類については、開発者サイトの Targeting Overview ページをご覧ください。
Twitter Object Nest（TON）は、Media Upload エンドポイント経由でアップロードされたメディアや各種アセットを格納し、クリエイティブとして使用できるようにするリポジトリです。
各ラインアイテムは、配信するために少なくとも1つのクリエイティブを関連付ける必要があります。利用できるクリエイティブには、新しいフォロワー獲得のためのPromoted Accounts、X Audience Platform全体のラインアイテムで利用できる画像や動画といったMedia Creatives、Promoted Postsなど、複数の選択肢があります。以下は、@Furni がプロモーションし、クリエイティブとして使用できるPostの例です。