마케팅 API 버전

마케팅 API 참고 자료

Facebook 마케팅 API의 루트 노드의 전체 리스트와 각각에 대한 참고 문서 링크입니다. 이용 가능한 에지는 별도로 표시됩니다. API 아키텍처 백그라운드에서 루트 노드와 각 에지를 호출하는 방법은 그래프 API 사용하기를 참조하세요.

주요 루트 노드는 다음과 같습니다.

루트 노드	설명
`/{USER}`	광고를 만드는 Facebook 사용자입니다. 각 광고 사용자는 여러 광고 계정에서 역할을 가질 수 있습니다.
`/act_{AD_ACCOUNT_ID}`	광고를 관리하는 비즈니스 기업을 나타냅니다.
`/{CAMPAIGN_ID}`	광고 캠페인의 목표를 정의합니다. 하나 이상의 광고 세트가 포함됩니다.
`/{AD_SET_ID}`	같은 예산, 일정, 입찰, 타게팅을 공유하는 모든 광고를 포함합니다.
`/{AD_ID}`	광고에 대한 정보를 포함합니다(예: 크리에이티브 요소, 측정 정보).

사용자

에지

에지	설명
`/adaccountgroups`	이 사용자와 관련된 광고 계정 모음입니다.
`/adaccounts`	이 사용자와 관련된 모든 광고 계정입니다.
`/accounts`	사용자가 관리하는 모든 페이지 및 장소입니다.
`/promotable_events`	직접 만든 모든 홍보 이벤트 또는 관리자 역할을 맡은 페이지에 속한 홍보 이벤트입니다.
`/promotable_domains`	이 사용자가 홍보할 수 있는 모든 도메인입니다.

광고 계정

마케팅 API의 모든 광고 개체 컬렉션은 광고 계정에 속합니다.

에지

에지	설명
`/campaigns`	캠페인의 목표를 정의하고 하나 이상의 광고 세트를 포함합니다.
`/adsets`	같은 예산, 일정, 입찰, 타게팅을 공유하는 모든 광고를 포함합니다.
`/ads`	광고에 대한 데이터입니다(예: 크리에이티브 요소, 측정 정보).
`/adcreatives`	광고의 외형과 콘텐츠를 정의합니다.
`/adimages`	광고 크리에이티브에 사용할 이미지 라이브러리입니다. 독립적으로 업로드하고 관리할 수 있습니다.
`/advideos`	광고 크리에이티브에 사용할 동영상 라이브러리입니다. 독립적으로 업로드하고 관리할 수 있습니다.
`/activities`	광고 계정에 대한 작업 로그입니다.
`/adtags`	광고 계정 내의 태그 세트입니다. 유사한 캠페인, 광고 세트 또는 광고를 태그하는 데 사용합니다.
`/adcampaignconversions`	광고 계정에서 광고 세트로 집계한 전환 데이터입니다.
`/adgroupconversions`	광고 계정에서 광고로 집계한 전환 데이터입니다.
`/customaudiences`	광고 계정의 맞춤 타겟입니다. 이미 비즈니스와 관련이 있는 사용자에게 광고를 타게팅하는 데 도움이 됩니다.
`/generatepreviews`	광고 미리 보기를 생성합니다.
`/offsitepixels`	이 계정과 관련된 픽셀입니다.
`/reachestimate`	특정 타게팅 사양을 포함하여 광고의 예상 도달을 생성합니다.
`/reportstats`	광고 계정 데이터를 가져오고 보고서를 예약하기 위한 보고 API입니다.
`/adcampaignstats`	광고 계정에서 광고 세트로 집계한 통계 집합입니다.
`/adgroupstats`	광고 계정에서 광고로 집계한 통계 집합입니다.
`/targetingsentencelines`	사람이 읽을 수 있는 광고 세트의 타게팅에 대한 설명을 생성합니다.
`/users`	광고 계정과 관련된 사용자 리스트입니다.
`/insights`	인사이트에 대한 인터페이스입니다. 하위 개체에서 결과의 중복을 제거하고, 분류와 비동기식 보고서를 제공합니다.

광고 캠페인

에지

에지	설명
`/adsets`	같은 예산, 일정, 입찰, 타게팅을 공유하는 모든 광고를 포함합니다.
`/ads`	광고에 필요한 데이터입니다(예: 크리에이티브 요소, 측정 정보).
`/adtags`	캠페인의 태그입니다. 유사한 캠페인을 쉽게 찾는 데 사용합니다.
캠페인으로 집계한 단일 통계 집합을 반환합니다.
`/insights`	인사이트에 대한 인터페이스입니다. 하위 개체에서의 중복 제거, 분류, 비동기식 보고서 등의 기능이 있습니다.

광고 세트

에지

에지	설명
`/ads`	광고에 필요한 데이터입니다(예: 크리에이티브 요소, 측정 정보).
`/adcreatives`	광고의 콘텐츠와 외형을 정의합니다.
`/activities`	광고 세트에 대한 작업 로그입니다.
`/adtags`	광고 세트의 태그입니다. 유사한 광고 세트를 쉽게 찾는 데 사용합니다.
`/conversions`	광고 세트에 대한 전환 데이터입니다.
`/insights`	인사이트에 대한 인터페이스입니다. 하위 개체에서의 중복 제거, 분류, 비동기식 보고서 등의 기능이 있습니다.

에지	설명
`/adcreatives`	광고의 외형과 콘텐츠를 정의합니다.
`/adtags`	광고에 대한 태그입니다. 유사한 광고를 찾는 데 사용합니다.
`/conversions`	광고의 전환 데이터입니다.
`/keywordstats`	광고에 대해 타게팅된 키워드별 통계를 반환합니다.
`/previews`	기존 광고에서 광고 미리 보기를 생성합니다.
`/reachestimate`	광고에 대한 예상 도달을 가져옵니다.
광고에 대한 통계 집합입니다.
`/targetingsentencelines`	사람이 읽을 수 있는 광고 세트의 타게팅에 대한 설명을 가져옵니다.
`/trackingtag`	광고에 클릭 태그를 할당합니다. 클릭 추적 태그를 사용하여 사용자가 광고를 클릭했을 때 실행할 URL을 지정합니다.
`/insights`	인사이트에 대한 인터페이스입니다. 하위 개체에서의 중복 제거, 분류, 비동기식 보고서 등의 기능이 있습니다.

크리에이티브

에지

에지	설명
`/previews`	기존 광고 크리에이티브 개체에서 광고 미리 보기를 생성합니다.