X (Twitter) Ads データコネクタ

フォローする
Avatar
Vaibhav Gupta
Updated
X Ads の設定
コスト集計
データコネクタの設定
アドモネタイゼーション集計
非対応
データの不一致
詳細は近日公開予定

 

Singular が X Ads（旧 Twitter）から広告コストデータを取得し、レポートに表示する方法をご説明します。Singular のダッシュボードでは、X Ads のキャンペーンデータのソースは引き続き Twitter と表示されます。

 

概要情報

データコネクタテクノロジー API (X Ads API version 11 - ドキュメントを参照)
データの内訳（セグメンテーション）

X Ads（Twitter）のデータは、常に次のディメンションで分類されます:

  • キャンペーン
  • サブキャンペーン（ラインアイテム）

さらに、 次のいずれかの内訳を取得できます:

  • プラットフォーム （デフォルト）
  • DMA Name
  • 年齢
  • 性別

プラットフォームの内訳ではなく地理的な位置情報を取得したい場合は、担当の Customer Success Manager または Singular サポートに連絡し、ユーザーの DMAを希望するかどうかをお知らせください。

注: X Ads はパブリッシャーの内訳を提供していません。

X Ads は市区町村または地域の内訳をサポートしなくなりました。
データの取得期間 30日間
タイムゾーン アカウントごとに顧客が設定
データはクリエイティブレベルで利用できますか？ はい
Singularはクリエイティブアセットを表示しますか？ はい - 画像、動画、ストリーミング動画を含みます。
Singular は Polls を表示しません。
既知の制限/問題
 
  • X Ads は Publisher の内訳を提供していません。
  • Singular は、ツイートが公開されるまで Scheduled Tweets を表示できません。公開された時点で取得します。
  • クリエイティブごとのインストール統計はありません。
  • クリエイティブレベルの指標は、サブキャンペーンレベル（X Ads の Line Item）で取得した指標と常に一致するとは限りません。
  • X の platform 内訳レポートと X の country 内訳レポートの間に差異が生じる場合があります。

X Ads データの内部的な差異について詳しくは、 このテーマに関する X Ads の記事を参照してください。

データマッピング

用語に関する注記:

  • Sub-Campaign は Singular における X Ads の Line Itemに相当します。
  • Creative は Singular において X Ads の Tweet、 Promoted Tweet、 Card、または Media Creativeに相当する場合があります。 
  • 指標は X Ads の Line Item、 Promoted Tweet、および Media Creative オブジェクトから取得されます。
  • 地理的な位置のディメンション（Country, DMA Name）は、プラットフォームの内訳ではなく位置情報を取得するようリクエストした場合にのみ利用できます（上記の「データの内訳（セグメンテーション）」を参照）。

Singular の各フィールドの説明については、 指標とディメンションを参照してください。

Field in Singular UI Field in Singular API Field in X Ads API
Dimensions
Account ID adn_account_id Account_object: id
Account Name adn_account_name Account_object: name
Agency agency Not pulled directly from X Ads, but Singular can set the agency per each account.
App Site ID app_site_id Estimated based on any URLs available in creative-related objects (Tweets,  Promoted Tweets, Cards, Media Creatives, Account Medias). If not possible, we try to estimate based on campaign URLs and Line Item URLs.
Campaign URL adn_campaign_url
  • Pulled from a Card object related to a Tweet related to a Line Item in the campaign.
  • The field is "website_dest_url" in X Ads API v. 6.0 but if that is not populated we look under old field names: “website_url", "website_shortened_url", "media_url". 
  • If there was no Card, we look for the "landing_url" field in a Media Creative object.
Country country_field We query the X Ads API with segment_by=”LOCATIONS”, and take the segment name for each Line Item and Promoted Tweet.
Creative Reported URL creative_reported_url  
Date date_field Since the Singular data connector pulls daily reports, we add the date ourselves.
DMA Name
 		 dma_name_field
 		 Same as Campaign URL
Network Campaign ID adn_campaign_id "id" in the Campaign object
Network Campaign Name adn_campaign_name "name" in the Campaign object
Network Creative ID adn_creative_id

Depends on the type of the creative.

  • If the creative is a Promoted Tweet: "tweet_id" in the Promoted Tweet object
  • If the creative is a Media Creative: "id" in the Account Media object.
Network Creative Name adn_creative_name Take the "media id" from the Card object and query X Ads for the media "name".
Network Sub Campaign ID adn_sub_campaign_id "id" in the Line Item object
Network Sub Campaign Name adn_sub_campaign_name "name" in the Line item object
Placement
 		 placement
 		 placements (possible values: ALL_ON_TWITTER, PUBLISHER_NETWORK, TWITTER_PROFILE, TWITTER_SEARCH, TWITTER_TIMELINE, TAP_BANNER, TAP_FULL, TAP_FULL_LANDSCAPE, TAP_NATIVE, TAP_MRECT)
Platform platform
  • This is only available if you have asked Singular to receive the Platform breakdown instead of the Country breakdown.
  • We query the Twitter API with segment_by=”PLATFORMS”, and take the segment name for each Line Item and Promoted Tweet.
Public Id site_public_id "googleplay_app_id" or "iphone_app_id" in the Card object, if available.
Sub Ad Network adn_subadnetwork
  • Set to "twitterfeed" if the data was queried from "ALL_ON_TWITTER"
  • Set to "twittertpn" if the data was queried from "PUBLISHER_NETWORK"
Target Countries target_countries_str For each sub-campaign (line item), we pull "countries" from the /targeting_criteria endpoint. We concatenate the results into this field.
Text creative_text Depending on the type of the creative, either "name" from the Card object, "text" from the Tweet object, or "media_name" from the Account Media.
Timezone adn_timezone "timezone" in the Account object
Age age AGE
Gender gender GENDER
Metrics
Comments
 		 comments replies
Likes
 		 likes likes
Network Clicks adn_clicks “clicks”
Network Impressions adn_impressions "impressions"
Network Installs adn_installs "mobile_conversion_installs"
Original Cost adn_original_cost "billed_charge_local_micro"
Original Currency adn_original_currency “currency” in the Campaign object
Page Follows
 		 page_follows follows
Shares
 		 shares retweets
Video Views video_views “video_total_views”
Completed Video Views completed_video_views “video_views_100”
Video Views - 25% video_views_25pct “video_views_25”
Video Views - 50% video_views_50pct “video_views_50”
Video Views - 75% video_views_75pct “video_views_75”

Singular はこのパートナーのキャンペーンプロパティの取得にも対応しています。詳細は こちらをご覧ください。