X (트위터) 데이터 커넥터

문서

Singular가 X(이전 트위터)에서 광고 비용 데이터를 가져와 보고서에 표시하는 방법을 알아보세요. Singular의 대시보드에는 여전히 트위터가 X의 출처로 표시되어 있습니다.

빠른 세부 정보

데이터 커넥터 기술 API(X 광고 API 버전 9 - 문서 참조)
데이터 분석(세분화)

X(트위터)의 데이터는 항상 다음과 같은 기준으로 분류됩니다:

  • 캠페인
  • 하위 캠페인(라인 항목)

또한 다음 분류 중 하나를 선택할 수 있습니다:

  • 플랫폼 (기본값)
  • 국가 + 도시
  • 국가 + 지역
  • 국가 + DMA 이름
  • 나이
  • 성별

플랫폼별 분석 대신 지리적 위치를 얻고 싶다면 고객 성공 매니저 또는 Singular 지원팀에 문의하여 사용자의 도시, 지역 또는 DMA 중 원하는 것을 지정하세요.

참고: 트위터에서는 퍼블리셔 세부 정보를 제공하지 않습니다.

데이터를 가져오는 기간 30일
시간대 계정별로 고객이 정의
크리에이티브 수준에서 데이터를 사용할 수 있나요?
Singular는 크리에이티브 에셋을 표시하나요? 예 - 이미지, 동영상 및 스트리밍 동영상을 포함합니다.
Singular는 설문조사를 표시하지 않습니다.
알려진 제한 사항/문제
  • 트위터는 퍼블리셔 내역을 제공하지 않습니다.
  • Singular은 트윗이 생방송되기 전에는 예약 트윗을 표시할 수 없습니다. 예약 트윗은 생방송이 시작되면 표시됩니다.
  • 크리에이티브별 설치 통계가 없습니다.
  • 크리에이티브 레벨의 지표가 하위 캠페인 레벨(트위터의 라인 항목)에서 가져온 지표와 항상 일치하는 것은 아닙니다.
  • 트위터의 플랫폼별 분석 보고서와 트위터의 국가별 분석 보고서 간에 차이가 있을 수 있습니다.

트위터 데이터의 내부 불일치에 대해 자세히 알아보려면 해당 주제에 대한 트위터의 도움말 문서를 참조하세요.

데이터 매핑

용어 노트:

  • Singular의하위 캠페인은 트위터의 라인 항목에 해당합니다.
  • Singular의광고 소재는 트위터의 트윗, 프로모션 트윗, 카드 또는 미디어 광고 소재에 해당할 수 있습니다.
  • 측정지표는 트위터의 라인 아이템, 프로모션 트윗미디어 크리에이티브 오브젝트에서 가져옵니다.
  • 지리적 위치 기준(국가, 지역, 도시, DMA 이름)은 플랫폼 분석 대신 위치를 가져오도록 요청한 경우에만 사용할 수 있습니다(위의 '데이터 분석' 참조).

Singular형의 각 필드에 대한 설명은 지표 및 기준을 참조하세요.

Singular UI의 필드 Singular API의 필드 트위터의 필드
기준
계정 ID adn_account_id 계정_객체: id
계정 이름 adn_account_name 계정_객체: 이름
대행사 에이전시 트위터에서 직접 가져온 것은 아니지만, 각 계정별로 에이전시를 설정할 수 있습니다.
앱 사이트 ID app_site_id 광고 소재 관련 개체(트윗, 프로모션 트윗, 카드, 미디어 광고 소재, 계정 미디어)에서 사용 가능한 모든 URL을 기준으로 추정합니다. 가능하지 않은 경우 캠페인 URL 및 광고 문구 URL을 기준으로 추정합니다.
캠페인 URL adn_campaign_url
  • 캠페인의 라인 아이템과 관련된 트윗과 관련된 카드 오브젝트에서 가져옵니다.
  • 이 필드는 트위터 API 6.0 버전에서 "website_dest_url"이지만, 입력되지 않은 경우 이전 필드 이름을 찾습니다: "웹사이트_URL", "웹사이트_단축_URL", "미디어_URL".
  • 카드가 없는 경우 미디어 크리에이티브 개체에서 "landing_url" 필드를 찾습니다.
도시
city_field
국가 country_field 세그먼트_by="LOCATIONS"로 트위터 API를 쿼리하고 각 라인 아이템 및 프로모션 트윗에 대한 세그먼트 이름을 가져옵니다.
크리에이티브 신고 URL 크리에이티브_보고된_URL
날짜 date_field Singular 데이터 커넥터는 일별 보고서를 가져오므로 날짜를 직접 추가합니다.
DMA 이름
dma_name_field
캠페인 URL과 동일
네트워크 캠페인 ID adn_campaign_id 캠페인 개체의 "ID"
네트워크 캠페인 이름 adn_campaign_name 캠페인 개체의 "이름"
네트워크 크리에이티브 ID adn_creative_id 광고 소재의 유형에 따라 다릅니다.
  • 광고 소재가 프로모션 트윗인 경우 프로모션 트윗 개체의 "트윗_id"
  • 크리에이티브가 미디어 크리에이티브인 경우: 계정 미디어 개체의 "아이디"입니다.
네트워크 크리에이티브 이름 adn_creative_name 카드 오브젝트에서 '미디어 아이디'를 가져와 트위터에 미디어 '이름'을 쿼리합니다.
네트워크 하위 캠페인 ID adn_sub_campaign_id 라인 아이템 개체의 "id"
네트워크 하위 캠페인 이름 adn_sub_campaign_name 라인 아이템 객체의 "이름"
게재 위치
게재 위치
게재 위치(가능한 값 모두_온_트위터, 퍼블리셔_네트워크, 트위터_프로필, 트위터_검색, 트위터_타임라인, 탭_배너, 탭_풀, 탭_풀_랜드스케이프, 탭_네이티브, 탭_m렉트)
플랫폼 플랫폼
  • 국가별 분석 대신 플랫폼별 분석을 받도록 요청한 경우에만 사용할 수 있습니다.
  • 트위터 API에 segment_by="PLATFORMS"로 쿼리하고 각 라인 아이템 및 프로모션 트윗에 대한 세그먼트 이름을 가져옵니다.
공개 아이디 사이트_공개_ID 사용 가능한 경우 카드 개체의 "googleplay_app_id" 또는 "iphone_app_id"를 사용합니다.
지역
region_field
하위 광고 네트워크 adn_subadnetwork
  • 데이터가 "ALL_ON_TWITTER"에서 쿼리된 경우 "twitterfeed"로 설정합니다.
  • 데이터가 "PUBLISHER_NETWORK"에서 쿼리된 경우 "twittertpn"으로 설정합니다.
타겟 국가 target_countries_str 각 하위 캠페인(라인 항목)에 대해 /targeting_criteria 엔드포인트에서 "국가"를 가져옵니다. 결과를 이 필드에 연결합니다.
텍스트 크리에이티브_텍스트 크리에이티브 유형에 따라 카드 오브젝트의 "이름", 트윗 오브젝트의 "텍스트" 또는 계정 미디어의 "미디어_이름"을 가져옵니다.
시간대 adn_timezone 계정 개체의 "시간대"
나이 나이 AGE
성별 gender GENDER
메트릭
평균 빈도
빈도 평균_빈도
댓글
댓글 답글
좋아요
좋아요 좋아요
네트워크 클릭 수 adn_clicks "클릭 수"
네트워크 노출 수 adn_impressions "노출 수"
네트워크 설치 adn_installs "모바일_전환_인스톨"
오리지널 비용 adn_original_cost "청구_충전_로컬_마이크로"
원래 통화 adn_original_currency 캠페인 개체의 "통화"
페이지 팔로우
페이지_팔로우 팔로우
도달
도달 총_오디언스_ 도달 범위
공유
공유 리트윗
동영상 조회수 video_views "VIDEO_총_조회수"
완료된 동영상 조회수 completed_video_views "VIDEO_VIEWS_100"
동영상 조회수 - 25% VIDEO_VIEWS_25PCT "VIDEO_VIEWS_25"
동영상 조회수 - 50% VIDEO_VIEWS_50PCT "VIDEO_VIEWS_50"
동영상 조회수 - 75% VIDEO_VIEWS_75PCT "VIDEO_VIEWS_75"

Singular는 이 파트너에 대한 캠페인 속성 가져오기도 지원합니다. 자세한 내용은 여기를 참조하세요.