기본
Ads API 계층 구조 및 용어
Ads API를 성공적으로 활용하려면 X Ads의 엔터티가 서로 어떻게 연관되는지 이해하는 것이 중요합니다. 이 튜토리얼은 X Ads 객체 계층 구조의 기본을 설명합니다.
Ads API에서 라인 아이템으로 불리는 광고 그룹은 캠페인 하위에 있으며, 특정 X 사용자 집합을 대상으로 타기팅 및 입찰을 수행하는 데 사용됩니다. 광고주는 게시물 또는 미디어(예: In-stream 광고로 프로모션되는 동영상)를 라인 아이템에 연결하여 프로모션합니다. ‘광고 그룹’ 항목도 참조하세요.
계정 미디어로서 광고 계정에 업로드된 크리에이티브 모음으로, 프로모션용 동영상의 프리롤 에셋(인스트림 광고라고도 함)과 X Audience Platform에서 프로모션할 수 있는 이미지가 포함될 수 있습니다.
X Ads 계층 구조의 최상위에는 광고 계정이 있습니다. 하나의 광고 계정은 여러 X 사용자가 관리할 수 있습니다. 데모 가구 매장 @Furni는 광고 계정을 관리하는 사용자 예시입니다. 광고 계정은 base36 영숫자 문자열인 account_id로 식별합니다.
각 계정에는 캠페인 전반에서 재사용할 수 있는 여러 엔터티 유형이 저장됩니다. 예를 들어 타기팅에 사용할 수 있는 맞춤형 오디언스, 동영상이나 이미지로 구성된 계정 미디어, 게시물에 추가할 수 있는 확장형 크리에이티브인 카드 등이 있습니다.
비디오 에셋을 업로드할 때 업로더는 해당 비디오의 카테고리(예: Tweet Video, Tweet Gif, Tweet Image, Amplify Video)를 지정할 수 있습니다. 인스트림 광고로 게재될 비디오를 업로드하려면 Amplify Video 카테고리가 필수입니다. 이러한 비디오는 정상적인 제공을 보장하기 위한 특수 처리 과정이 필요하므로 미디어 카테고리로 Amplify Video를 지정해야 합니다.
분석 지표는 파트너와 광고주가 X에서 프로모션하는 콘텐츠의 성과를 파악하는 데 도움을 줍니다. 여기에는 노출 수, 클릭 수, 동영상 조회 수, 지출액 등의 정보가 포함됩니다. 또한 파트너와 광고주는 도달한 잠재고객의 다양한 세그먼트에 대한 상세 지표도 확인할 수 있습니다.
Ads API는 캠페인 성과 지표를 상세히 조회하는 두 가지 방식을 지원합니다: 동기식과 비동기식.
동기식 분석 요청의 경우 요청한 지표가 응답으로 반환됩니다. 동기식 엔드포인트는 짧은 기간을 지원하며 실시간 캠페인 성과를 조회하는 데 적합합니다.
비동기식 분석 엔드포인트의 경우 요청한 지표는 관련 “job” 처리 완료 후 다운로드 가능한 결과 파일에서 확인할 수 있습니다. 비동기식 엔드포인트는 훨씬 더 긴 기간의 지표 요청을 지원하고, 세분화된 데이터 반환을 제공하며, 대용량 데이터 페치에 적합합니다 — 리포트 생성이나 과거 데이터 백필에 이상적입니다.
광고주가 집행하는 각 캠페인은 기존의 자금 조달 수단 아래에서 생성되어야 합니다. 캠페인을 통해 광고 캠페인의 이름, 일정, 예산 등을 정의할 수 있습니다. Furni 예시를 이어, “Furni home decor”라는 캠페인을 만들 수 있습니다.
참고로 광고 계정은 활성 캠페드를 최대 200개까지 보유할 수 있으며, 이 한도는 광고주의 계정 매니저가 상향할 수 있습니다. 캠페인은 종료 시간이 도달하거나 예산이 소진될 때까지 활성 상태로 간주됩니다. 일시 중지된 캠페인도 캠페인 한도 산정을 위한 활성 캠페인으로 간주됩니다.
카드는 트윗에 이미지, 동영상 또는 UI 요소를 추가해 시각적으로 확장하는 기능입니다. Ads API는 트윗에서 사용할 수 있는 여러 카드 유형을 지원하며, 이를 캠페인에서 홍보할 수 있습니다.
광고주는 이미지, GIF, 동영상 등의 크리에이티브가 포함된 캠페인에서 게시물을 프로모션할 수 있습니다. 이러한 크리에이티브는 게시물에 풍부한 사진, 동영상 및 미디어 경험을 첨부할 수 있게 하는 X 카드와 연결할 수 있습니다. 크리에이티브는 게시물에 직접 첨부할 수도 있습니다. 예를 들어, 텍스트와 동영상(또는 최대 3장의 이미지)을 포함해 프로모션 게시물을 만들 수 있습니다.
각 라인 아이템은 게재를 위해 최소 한 개의 크리에이티브가 연결되어 있어야 합니다. 크리에이티브 유형에는 새로운 팔로워 확보를 위한 프로모션 계정, TX Audience Platform 전반의 라인 아이템에 사용할 수 있는 이미지나 동영상 등의 미디어 크리에이티브, 또는 프로모션 게시물 등이 있습니다.
광고 계정에는 광고주가 X Ads에서 사용하도록 설정한 다양한 자금 출처, 즉 자금 수단도 포함됩니다. 여기에는 X와 체결한 인서션 오더부터 계정에 연결된 신용카드까지가 포함됩니다.
캠페인 내에는 하나 이상의 광고 그룹이 있을 수 있으며, Ads API에서는 이를 라인 아이템이라고도 합니다. 라인 아이템은 캠페인의 서로 다른 세그먼트로 볼 수 있으며, 각 라인 아이템은 고유한 타깃팅 설정과 크리에이티브를 가집니다. 여러 라인 아이템을 포함하는 캠페인은 종종 “광고 그룹 캠페인”이라고 불립니다.
단일 캠페인에 여러 라인 아이템을 두는 이점 중 하나는 타깃팅과 크리에이티브를 더 다양하게 조합할 수 있다는 점입니다.
“Furni home decor” 캠페인에서는 두 개의 라인 아이템을 만들 수 있습니다. 하나는 “샌프란시스코 내 주택 구매자”, 다른 하나는 “런던 내 주택 구매자”가 될 수 있습니다.
캠페인당 최대 100개의 라인 아이템을 생성할 수 있으며, 광고 계정은 모든 캠페인을 합쳐 활성 라인 아이템 총 4,000개로 제한됩니다.
Mobile App Promotion(이하 MAP)은 광고주가 X를 통해 모바일 앱을 홍보할 수 있도록 지원하는 제품군입니다. 여기에는 앱 설치, 전환, 재참여가 포함됩니다.
X 모바일 앱 프로모션 측정은 광고주가 X에서 설치 유도 또는 기타 인앱 전환을 목표로 설계된 광고 캠페인의 성과를 추적할 수 있도록 합니다. X 모바일 측정 파트너는 광고주가 X에서 프로모션 중인 앱에서 추적할 전환 항목을 관리할 수 있도록 지원합니다. MACT 개요
미디어 라이브러리 엔드포인트는 X Ads 계정에서 이미지, GIF, 동영상을 관리할 수 있도록 합니다. 라이브러리의 미디어 에셋은 게시물 작성 및 카드 생성에 사용할 수 있습니다. 또한 여러 크리에이티브에서 재사용할 수 있어 동일한 에셋을 반복 업로드할 필요가 없습니다.
프로모션 계정(팔로워 캠페인)은 사람들이 현재 팔로우하지 않지만 관심을 가질 만한 계정을 추천하는 Who to Follow의 일부입니다. 프로모션 계정은 사용자가 더 다양한 계정을 발견할 수 있도록 도와줍니다.
프로모션 계정을 통해 광고주는 자신의 계정을 홍보하고 X에서의 오디언스를 확대할 수 있습니다. 팔로워 캠페인은 X 플랫폼 전반의 여러 위치—홈 타임라인, Who to Follow, 검색 결과 등—에 표시되며, 다른 추천 계정과 구분할 수 있도록 해당 추천에는 ‘프로모션’ 라벨이 표시됩니다.
각 X Ads 계정에는 하나 이상의 프로모션 가능 사용자를 지정할 수 있으며, 이는 해당 광고 계정을 통해 프로모션할 수 있는 사용자를 의미합니다. Furni의 @Furni 핸들은 Furni의 광고 계정에서 FULL 프로모션 가능 사용자의 예로, @Furni 및 해당 사용자의 트윗에 대해 모든 유형의 캠페인을 집행할 수 있음을 뜻합니다. 하나의 광고 계정에는 FULL 프로모션 가능 사용자가 한 명만 있을 수 있습니다.
또한 광고 계정에는 다른 유형의 프로모션 가능 사용자도 있을 수 있습니다. 예를 들어, Furni 제품에 관한 @Jack의 트윗을 프로모션하려는 경우, 그는 해당 계정에서 RETWEETS_ONLY로 표시되는 리트윗 전용 프로모션 가능 사용자가 됩니다. 광고주는 리트윗 사용자 추가와 관련한 정보는 X 담당 어카운트 매니저에게 문의하시기 바랍니다.
프로모션 동영상은 광고주가 비용을 지불한 프로모션 트윗 내 동영상을 말합니다. 홈 타임라인, X의 검색 결과 상단, 플랫폼 전반에 표시되며 “Promoted”로 명확히 표시됩니다.
X Audience Platform을 참고하세요.
예약된 트윗을 사용하면 광고주나 사용자가 트윗을 작성해 나중에 게시되도록 예약할 수 있습니다. 트윗을 생성하고 관리하는 것뿐만 아니라, API를 통해 해당 트윗을 라인 아이템과 연결해 게시 시점에 프로모션할 수 있습니다. 이를 통해 광고주는 네이티브 트윗을 미리 준비하고 핵심 캠페인 이전에 크리에이티브를 사전에 계획할 수 있습니다. 예를 들어, 신제품 발표와 동시에 즉시 게시되도록 트윗 크리에이티브를 미리 설정할 수 있습니다.
세그멘테이션은 파트너와 광고주가 연령, 기기, 언어 등 특정 타기팅 값별로 분리된 지표를 조회할 수 있도록 하며, 비동기식 분석 엔드포인트를 통해서만 제공됩니다. 세그먼트화된 지표를 요청하려면 segmentation_type 요청 매개변수를 사용하세요. 세그멘테이션 옵션에 대한 자세한 내용은 Metrics and Segmentation을 참조하세요.
리스트 기반 Tailored Audience는 Tailored Audience의 세 가지 유형 중 하나로, 자체 사용자 및 고객 데이터가 담긴 파일을 업로드하여 생성됩니다. 업로드한 리스트는 X의 사용자와 매칭되어 캠페인에서 직접 타기팅할 수 있습니다. 다음 제한 사항을 확인하세요.
웹 기반 맞춤 타깃은 맞춤 타깃의 세 가지 유형 중 하나로, 귀하의 웹사이트를 방문한 X 사용자들의 모음입니다. 웹 기반 맞춤 타깃을 사용하려면 귀하의 웹사이트에 X 픽셀이 설치되어 있거나 당사가 승인한 태그 관리자 파트너 중 하나를 사용해야 합니다. 다음 제한 사항을 확인해 주십시오.
앞서 언급했듯이 타기팅 기준은 라인 아이템에 연결됩니다. 위치, 키워드, 성별부터 사용자 행동과 관심사 같은 더 세분화된 속성까지 다양한 타기팅을 활용할 수 있습니다. “San Francisco 주택 구매자(Home Buyers in San Francisco)” 라인 아이템의 경우 “주택 구매(home buying)” 행동과 “San Francisco” 위치를 함께 타기팅할 수 있습니다.
사용 가능한 타기팅 유형에 대한 자세한 내용은 개발자 사이트의 Targeting Overview 페이지를 참조하세요.
Twitter Object Nest (TON)은 Media Upload 엔드포인트를 통해 업로드된 미디어 및 다양한 에셋을 저장하며, 크리에이티브로 활용됩니다.
각 라인 아이템이 실행되려면 최소 한 개의 크리에이티브가 연결되어 있어야 합니다. 크리에이티브 옵션으로는 신규 팔로워 확보를 위한 Promoted Accounts, X Audience Platform 전반의 라인 아이템에 사용할 수 있는 이미지나 동영상 등의 Media Creatives, 또는 Promoted Posts가 있습니다. 아래는 @Furni가 프로모션하여 크리에이티브로 사용할 수 있는 게시물의 예시입니다.