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