Ads API 계층 구조 및 용어

Ads API를 성공적으로 활용하려면 X Ads의 엔티티들이 서로 어떻게 관련되어 있는지 이해하는 것이 중요합니다. 이 튜토리얼에서는 X Ads 객체 계층 구조의 기본 개념을 설명합니다.

​

광고 그룹(라인 아이템)

Ads API에서 라인 아이템이라고 불리는 광고 그룹은 캠페인의 하위에 속하며, 특정 X 사용자 집합을 대상으로 타기팅 및 입찰을 수행하는 데 사용됩니다. 광고주는 게시물 또는 미디어(예: 인스트림 광고로 프로모션되는 동영상)를 라인 아이템과 연결해 프로모션합니다. 또한 광고 그룹 항목도 참고하세요.

​

계정 미디어

계정 미디어는 광고 계정에 업로드된 크리에이티브 모음으로, 인스트림 광고라고도 하는 프로모션 동영상 프리롤 자산과 X Audience Platform에서 프로모션할 수 있는 이미지 등을 포함할 수 있습니다.

​

광고 계정

X Ads 계층 구조의 맨 위에는 광고 계정이 있습니다. 하나의 광고 계정은 여러 X 사용자가 관리할 수 있습니다. 데모 가구 매장인 @Furni는 광고 계정을 관리하는 사용자의 예시입니다. 광고 계정은 account_id로 식별되며, account_id는 base36 영숫자 문자열입니다.

각 계정 아래에는 캠페인 전반에 걸쳐 재사용할 수 있는 다양한 엔티티 type을 저장합니다. 예를 들어 타게팅에 사용할 수 있는 맞춤 오디언스, 동영상이나 이미지 자산인 계정 미디어, 그리고 게시물에 추가할 수 있는 확장형 크리에이티브인 카드가 여기에 포함됩니다.

​

Amplify Video

비디오 에셋을 업로드할 때 업로드하는 측은 비디오 카테고리를 정의할 수 있습니다(예: Tweet Video, Tweet Gif, Tweet Image, Amplify Video). 인스트림 광고로 제공될 비디오를 업로드하려면 Amplify Video 카테고리를 반드시 지정해야 합니다. 이러한 비디오는 제공 가능성을 보장하기 위한 특수 처리가 필요하므로, 미디어 카테고리로 Amplify Video를 지정하는 것이 필수입니다.

​

Analytics

Analytics 지표는 파트너와 광고주가 X에서 프로모션하는 콘텐츠의 성과를 파악하는 데 도움을 줍니다. 여기에는 노출 수, 클릭 수, 동영상 조회 수, 지출액 등의 정보가 포함됩니다. 또한 파트너와 광고주는 도달한 오디언스를 다양한 세그먼트로 나누어 세분화된 지표를 확인할 수 있습니다.

Ads API는 캠페인 성과 지표를 상세하게 조회하는 두 가지 방식을 지원합니다: 동기식과 비동기식입니다.

동기식 analytics 요청의 경우, 요청한 지표가 응답에 바로 반환됩니다. 동기식 엔드포인트는 짧은 기간의 조회를 지원하며, 실시간 캠페인 성과를 조회하기에 적합합니다.

비동기식 analytics 엔드포인트의 경우, 요청한 지표는 관련 “job” 처리가 완료된 후 다운로드 가능한 결과 파일 형태로 제공됩니다. 비동기식 엔드포인트는 훨씬 더 긴 기간에 대한 지표 요청을 지원하고, 세그먼트별 데이터 반환이 가능하며, 훨씬 더 많은 데이터를 가져올 수 있도록 설계되어 있습니다. 이 방식은 보고서 생성이나 과거 데이터 보강(historical backfill)에 적합합니다.

​

캠페인

광고주가 진행하는 각 캠페인은 반드시 기존에 설정된 자금 수단(funding instrument) 하에서 생성되어야 합니다. 캠페인을 통해 광고 캠페인의 이름, 일정, 예산 등의 항목을 정의할 수 있습니다. Furni 사례를 계속 사용하면 “Furni home decor”라는 캠페인을 생성할 수 있습니다.

광고 계정에는 동시에 활성 상태인 캠페인이 최대 200개까지로 제한된다는 점에 유의해야 합니다. 이 한도는 광고주의 계정 담당자를 통해 상향될 수 있습니다. 캠페인은 종료 시간이 도래하거나 예산이 소진될 때까지 활성 상태로 간주됩니다. 일시 중지된 캠페인도 캠페인 한도를 계산할 때는 여전히 활성 캠페인으로 간주됩니다.

​

Cards

Cards는 Tweet에 이미지, 동영상 또는 UI 요소를 시각적으로 추가하는 방법을 제공합니다. Ads API는 Tweet에 사용할 수 있는 여러 카드 유형을 지원하며, 이렇게 생성된 Tweet은 캠페인에서 프로모션용으로 집행할 수 있습니다.

​

크리에이티브

광고주는 이미지, GIF, 동영상과 같은 크리에이티브를 포함하는 캠페인에서 Tweet을 프로모션할 수 있습니다. 이러한 크리에이티브는 Tweet에 풍부한 사진, 동영상 및 미디어 경험을 첨부할 수 있게 해주는 X 카드와 연동할 수 있습니다. 크리에이티브는 Tweet에 직접 첨부할 수도 있습니다. 예를 들어, 텍스트와 동영상(또는 최대 3개의 이미지)을 포함해 프로모션 Tweet을 만들 수 있습니다.

각 라인 아이템이 집행되려면 최소 하나 이상의 크리에이티브가 연결되어 있어야 합니다. 크리에이티브에는 신규 팔로워 확보를 위한 Promoted Accounts, TX Audience Platform 전반의 라인 아이템에 사용할 수 있는 이미지 또는 동영상과 같은 Media Creatives, Promoted Posts 등 여러 옵션이 있습니다.

​

자금 수단

광고 계정에는 광고주가 X Ads에서 사용하도록 설정한 다양한 자금 출처인 자금 수단도 포함됩니다. 이러한 자금 수단에는 X와 체결한 인서션 오더부터 계정에 연결된 신용카드까지 모두 포함됩니다.

​

라인 아이템

하나의 캠페인에는 하나 이상의 광고 그룹을 둘 수 있으며, Ads API에서는 이를 라인 아이템이라고도 부릅니다. 라인 아이템은 각각 고유한 타기팅 세트와 크리에이티브를 가진, 캠페인의 서로 다른 세그먼트로 볼 수 있습니다. 여러 라인 아이템을 포함하는 캠페인은 종종 “광고 그룹 캠페인”이라고도 합니다.

하나의 캠페인 안에 여러 라인 아이템을 두는 이점 중 하나는 더 다양한 타기팅과 크리에이티브 조합을 만들 수 있다는 점입니다.

“Furni home decor” 캠페인에서는 두 개의 라인 아이템을 만들 수 있습니다. 하나는 “샌프란시스코의 주택 구매자”, 다른 하나는 “런던의 주택 구매자”로 설정할 수 있습니다.

캠페인당 최대 100개의 라인 아이템을 설정할 수 있으며, 하나의 광고 계정 기준으로는 모든 캠페인을 통틀어 활성 라인 아이템이 총 4,000개까지로 제한됩니다.

​

Mobile App Promotion (MAP)

Mobile App Promotion, 또는 MAP은 광고주가 X에서 모바일 앱을 홍보할 수 있도록 지원하는 제품군으로, 앱 설치, 전환, 재참여 유도 등을 포함합니다.

​

모바일 App 전환 추적 (MACT)

X 모바일 App 프로모션 측정 기능을 사용하면 광고주가 X에서 진행하는, 설치 또는 기타 인앱 전환을 유도하기 위한 광고 캠페인의 성과를 추적할 수 있습니다. X 모바일 측정 파트너는 광고주가 X에서 프로모션하는 App에서 어떤 전환을 추적할지 관리할 수 있는 기능을 제공합니다. MACT 개요

​

미디어 라이브러리

미디어 라이브러리 엔드포인트를 사용하면 X Ads 계정에서 이미지, GIF, 동영상을 관리할 수 있습니다. 라이브러리에 있는 미디어 애셋은 포스트와 카드 생성에 사용할 수 있습니다. 또한 동일한 애셋을 여러 크리에이티브에서 재사용할 수 있어, 같은 애셋을 여러 번 업로드할 필요가 없습니다.

​

프로모션 계정

프로모션 계정(팔로워 캠페인)은 사람들이 현재 팔로우하지 않지만 흥미를 느낄 수 있는 계정을 추천하는 Who to Follow 기능의 일부입니다. 프로모션 계정은 사람들이 좋아할 만한 더 다양한 계정을 소개하는 데 도움이 됩니다.

프로모션 계정을 통해 광고주는 자신의 계정을 홍보하고 X에서 오디언스를 확대할 수 있습니다. 팔로워 캠페인은 X 플랫폼 전반의 여러 위치(홈 타임라인, Who to Follow, 검색 결과 등)에 표시되며, 이 추천 항목에는 다른 추천 계정과 구분할 수 있도록 ‘프로모션’으로 라벨이 표시됩니다.

​

프로모션 가능 사용자

각 X Ads 계정에는 하나 이상의 프로모션 가능 사용자가 있을 수 있으며, 이들은 해당 광고 계정을 통해 프로모션할 수 있는 사용자입니다. Furni의 @Furni 핸들은 Furni의 광고 계정에서 FULL 프로모션 가능 사용자의 예로, 이는 @Furni와 해당 사용자의 Tweet에 대해 모든 유형의 캠페인을 진행할 수 있음을 의미합니다. 하나의 광고 계정에는 오직 하나의 FULL 프로모션 가능 사용자만 있을 수 있습니다.

또한 광고 계정에는 다른 프로모션 가능 사용자가 있을 수도 있다는 점에 유의하세요. 예를 들어, Furni 제품에 대한 @Jack의 Tweet을 프로모션하고자 한다면, 그는 해당 계정에서 RETWEETS_ONLY로 표시되는 리트윗 전용 프로모션 가능 사용자가 됩니다. 광고주는 리트윗 사용자를 자신의 광고 계정에 추가하는 방법에 대한 정보를 얻기 위해 X 계정 담당자에게 문의해야 합니다.

​

프로모티드 비디오

프로모티드 비디오는 광고주가 비용을 지불해 Promoted Tweet 내에 게재되는 동영상입니다. 홈 타임라인, X의 검색 결과 상단 및 플랫폼 내 다른 영역에 노출되며, “Promoted”라는 표시가 명확히 붙습니다.

​

퍼블리셔 네트워크

X Audience Platform을 참조하세요.

​

예약 Tweet

예약 Tweet을 사용하면 광고주나 사용자가 나중 시점에 게시되도록 예약한 Tweet을 생성할 수 있습니다. 이러한 Tweet을 생성하고 관리할 수 있을 뿐만 아니라, API를 사용해 이 Tweet을 라인 아이템과 연결하여 Tweet이 게시된 이후 곧바로 프로모션할 수 있습니다. 이를 통해 광고주는 네이티브 Tweet을 미리 작성해 두고, 주요 이니셔티브에 앞서 캠페인 크리에이티브를 사전에 계획할 수 있습니다. 예를 들어, 새로운 제품 발표와 동시에 바로 게시되도록 Tweet 크리에이티브를 미리 준비해 두는 방식입니다.

​

세그멘테이션

세그멘테이션을 사용하면 파트너와 광고주는 연령, 기기, 언어와 같은 특정 타기팅 값별로 세분화된 메트릭을 조회할 수 있으며, 이는 비동기 분석 엔드포인트를 통해서만 제공됩니다. 세분화된 메트릭을 요청하려면 segmentation_type 요청 파라미터를 사용하십시오. 세그멘테이션 옵션에 대한 자세한 내용은 Metrics and Segmentation을 참조하십시오.

​

맞춤 잠재고객 - 리스트

리스트 기반 맞춤 잠재고객은 세 가지 맞춤 잠재고객 유형 중 하나로, 보유하고 있는 자체 사용자 및 고객 데이터를 담은 파일을 업로드해 생성합니다. 업로드한 리스트는 X의 사용자와 매칭되어 캠페인에서 이들을 직접 타게팅할 수 있습니다. 아래 제한 사항을 반드시 검토하세요.

​

맞춤 잠재고객 - 웹

웹 기반 맞춤 잠재고객은 세 가지 맞춤 잠재고객 유형 중 하나로, 귀하의 웹사이트를 방문한 X 사용자의 집합입니다. 웹 기반 맞춤 잠재고객을 사용하려면 웹사이트에 X 픽셀을 설치했거나, 당사에서 승인한 태그 관리자 파트너 중 하나를 사용해야 합니다. 해당 제한 사항을 검토해 주세요.

​

타기팅 기준

앞서 언급했듯이, 타기팅 기준은 라인 아이템에 연결되어 있습니다. 위치, 키워드, 성별부터 사용자 행동과 관심사 같은 더 세분화된 속성까지 사용할 수 있는 다양한 타기팅 옵션이 있습니다. “Home Buyers in San Francisco” 라인 아이템의 경우, “home buying” 행동과 “San Francisco” 위치를 함께 타기팅할 수 있습니다.

사용 가능한 다양한 타기팅 유형에 대한 자세한 내용은 개발자 사이트의 Targeting Overview 페이지를 참조하세요.

​

Twitter Object Nest (TON)

Twitter Object Nest (TON)은 Creatives로 사용하기 위해 Media Upload 엔드포인트를 통해 업로드된 미디어와 다양한 에셋을 저장하는 공간입니다.

​

크리에이티브

각 라인 아이템은 집행되기 위해 최소 한 개의 크리에이티브와 연결되어야 합니다. 새 팔로워 확보를 위한 Promoted Accounts, X Audience Platform 전반에서 라인 아이템에 사용할 수 있는 이미지나 동영상 등의 Media Creatives, 또는 Promoted Posts 등 여러 가지 크리에이티브 옵션을 사용할 수 있습니다. 다음은 @Furni가 프로모션하고 크리에이티브로 사용할 수 있는 게시물 예시입니다.