트위터 데이터 커넥터 설정

팔로우
Avatar
Vaibhav Gupta
Updated

싱귤러에서 어떠한 방식으로 트위터의 데이터를 취득하여 리포트에 표시되는지 알아보세요.

 

세부 사항

데이터 커넥터 기술 API (Twitter API v 7.0 - 참조 문서)
데이터 분석 (세분화)

캠페인 및 하위 캠페인과 같은 기본 디멘션 외 아래와 같은 데이터 또한 취득이 가능합니다.

  • 플랫폼 (default)
  • 국가

참고: 트위터는 퍼블리셔 (publisher) 데이터를 제공하지 않습니다.
취득 가능한 데이터 기간 취득 시점 부터 최대 30일
시간대 계정 별 사용자의 설정에 따름
크리에이티브 데이터 제공 여부 가능
싱귤러에서 크리에이티브 소재(asset) 제공 여부 가능 - 이미지, 비디오, 및 스트리밍 비디오. Polls는 보이지 않음
제약 사항 / 이슈
  • 트위터는 퍼블리셔(publisher) 분석을 제공하지 않습니다.
  • 싱귤러는 예정된 트윗에 대한 데이터를 가져오지 못하며 라이브된 트윗에 대한 취득만이 가능합니다.
  • 크리에이티브 레벨의 메트릭스(Metrics)는 하위 캠페인(sub-campaign) 의 메트릭스와 일치 하지 않을 수 있습니다. (트위터의 라인 아이템)
  • 각 크리에이티브별 인스톨 통계는 제공 되지 않습니다.
  • 트위터의 플랫폼 단위 리포트와 트위터의 국가 단위 리포트 사이에 불일치가 존재할 수 있습니다.

데이터 매핑

Terminology Notes:

  • 싱귤러의 하위 캠페인(Sub-Campaign)은 트위터의 Line Item에 해당합니다.
  • 싱귤러의 크리에이티브(Creative)는 트위터의 Tweet, Promoted Tweet, Card, 혹은 Media Creative에 해당 합니다
  • 메트릭스는 트위터의 Line Item, Promoted Tweet, 그리고 Media Creative 에서 취득

  싱귤러 UI 필드명 싱귤러 API 필드명 트위터 필드명
캠페인 디멘션 Account ID adn_account_id Account_object: id
캠페인 디멘션 Account Name adn_account_name Account_object: name
캠페인 디멘션 Agency agency 트위터에서 직접 취득하지 않으나 각 계정별 에이전시를 설정 가능합니다.
캠페인 디멘션 App Site ID app_site_id 크리에이티브와 관련된 오브젝트(Tweets,  Promoted Tweets, Cards, Media Creatives, Account Medias)를 통하여 추정 - 불가능한 경우 캠페인 URLs와 Line Item URLs를 활용하여 추정합니다.
캠페인 디멘션 Campaign URL adn_campaign_url
  • 캠페인의 Line Item과 관련된 트윗의 Card 오브젝트에서 취득합니다.
  • 트위터 API v. 6.0 내 필드는 "website_dest_url" 이지만 존재하지 않을 시 예전 필드명을 활용합니다: “website_url", "website_shortened_url", "media_url". 
  • Card가 존재하지 않는 경우 미디어 크리에이티브 내 "landing_url" 필드 활용합니다.
캠페인 디멘션 Country country_field 트위터 API 쿼리에 segment_by=”LOCATIONS”을 활용하여 각 Line Item과 Promoted Tweet의 세그먼트 명을 취득합니다.
캠페인 디멘션 Date date_field 싱귤러에서는 데이터 커넥터를 통하여 일일 리포트를 취득하기 때문에 자체적으로 날짜를 추가합니다.
캠페인 디멘션 Network Campaign ID adn_campaign_id 캠페인 내 "id"
캠페인 디멘션 Network Campaign Name adn_campaign_name 캠페인 내 "name"
캠페인 디멘션 Network Creative ID adn_creative_id 크리에이티브 유형에 따라 다릅니다.
  • 크리에이티브가 Promoted Tweet인 경우: Tweet 내 "tweet_id" 
  • 크리에이티브가 Media Creative인 경우:  Account Media 내 "id" 
캠페인 디멘션 Network Creative Name adn_creative_name Card 내 "media id" 활용, 트위터의  media "name" 취득합니다.
캠페인 디멘션 Network Sub Campaign ID adn_sub_campaign_id Line Item  내 "id" 
캠페인 디멘션 Network Sub Campaign Name adn_sub_campaign_name Line Item 내 "name"
캠페인 디멘션 Platform platform
  • 국가 정보 대신 활용 가능하며 싱귤러에 요청하여야 사용 가능합니다.
  • 트위터 API 쿼리에 segment_by=”PLATFORMS”을 활용하여 각 Line Item과 Promoted Tweet의 세그먼트 명을 취득합니다.
캠페인 디멘션 Public Id site_public_id 취득 가능한 상황 시 Card 내 "googleplay_app_id" 혹은 "iphone_app_id"
캠페인 디멘션 Sub Ad Network adn_subadnetwork
  • "ALL_ON_TWITTER"에서 취득 시 “twitterfeed”로 설정합니다. 
  • ""PUBLISHER_NETWORK"에서 취득 시 “twittertpn”로 설정합니다.
캠페인 디멘션 Target Countries target_countries_str
각 하위 캠페인(line item)에 대해 "countries" 데이터를 targeting_criteria 엔드 포인트에서 취득하여  결과를 이 필드에 연결합니다.
캠페인 디멘션 Text creative_text 크리에이티브 유형에 따라 Card의 “name”, Tweet의 “text”, 또는 Account Media의 “media_name”을 사용합니다.
캠페인 디멘션 Timezone adn_timezone Account의 "timezone" 
캠페인 디멘션 Creative Reported URL creative_reported_url 캠페인 URL과 동일합니다.
매트릭스 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 Campaign의 “currency”
매트릭스 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”