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는 이 파트너의 캠페인 속성 가져오기도 지원합니다. 자세한 내용은 여기를 참조하세요.