마케팅 API

상세 타게팅

타게팅 검색을 사용하면 단일 API 호출에서 하나의 타게팅 유형으로 타게팅을 검색할 수 있습니다. 상세 타게팅 API를 사용하면 단일 요청으로 동시에 여러 타게팅 유형을 검색할 수 있습니다. 쿼리에 기반하여 추천을 받을 수도 있습니다.

이 API에는 검색, 추천, 둘러보기, 확인, 이렇게 4개의 엔드포인트가 있습니다.

이러한 엔드포인트에 대한 응답에는 다음 항목이 포함됩니다.

이름 설명

id

유형: 문자열

타겟 대상 ID

name

유형: 문자열

타겟 대상의 이름

audience_size_lower_bound

정수

예상 하한 타겟 대상 규모

audience_size_upper_bound

정수

예상 상한 타겟 대상 규모

path

유형: 문자열 배열

타게팅이 속한 카테고리와 모든 상위 카테고리 포함

description

유형: 문자열

타겟 대상에 대한 간단한 설명

limit_type을 제공하지 않는 경우 2,000명 미만의 결과를 4개의 카테고리(work_employers, work_positions, education_majors, education_schools)로 필터링합니다. 그렇지 않으면 별로 의미가 없는 결과를 얻게 됩니다. limit_type을 사용하면 4개 카테고리 중 1개에 대해 필터링하고 모든 카테고리를 반환하지는 않습니다.

검색 쿼리에 매칭되는 광고에 대해 타겟 대상을 검색합니다. 이 엔드포인트에서 다음과 같은 매개변수를 제공할 수 있습니다.

curl -G \
-d "q=harvard" \
-d "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/targetingsearch
이름 설명

q

유형: 문자열

필수 항목.

쿼리 문자열

limit

유형: 정수

선택 사항.

결과 수

limit_type

유형: 문자열

선택 사항.

검색할 타겟 유형을 제한합니다. 모든 유형을 기본값으로 지정합니다.

유효 값은 다음과 같습니다.

  • interests
  • education_schools
  • education_majors
  • work_positions
  • work_employers
  • relationship_statuses
  • college_years
  • education_statuses
  • family_statuses
  • industries
  • life_events
  • behaviors
  • income

locale

유형: 문자열

선택 사항.

타겟 이름과 설명을 표시할 로캘(가능한 경우). 광고 계정의 로캘이 기본값으로 지정됩니다.

추천

제공하는 몇 가지 선택된 타겟을 기준으로 타게팅할 수 있는 추가 타겟을 반환합니다.

curl -G \
-d "targeting_list=[{'type':'interests','id':6003263791114}]" \
-d "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/targetingsuggestions

다음과 같은 매개변수를 제공합니다.

이름 설명

targeting_list

유형: {'type':'{TYPE}', 'id':{ID}}의 배열

필수 항목.

추천을 위해 {'type':'{TYPE}', 'id':{ID}}의 배열을 입력 타겟으로 페어링합니다.

limit

유형: 정수

선택 사항.

결과 수. 기본값은 30입니다. 최댓값은 45입니다.

limit_type

유형: 문자열

선택 사항.

검색할 타겟 유형을 제한합니다. 모든 유형을 기본값으로 지정합니다.

유효 값은 다음과 같습니다.

  • interests
  • education_schools
  • education_majors
  • work_positions
  • work_employers
  • relationship_statuses
  • college_years
  • education_statuses
  • family_statuses
  • industries
  • life_events
  • behaviors
  • income

locale

유형: 문자열

선택 사항.

타겟 이름과 설명을 표시할 로캘. 광고 계정의 로캘이 기본값으로 지정됩니다.

둘러보기

Facebook 카테고리, 타사 데이터 제공업체 및 일부 관심사에 대한 구조화된 분류로 타게팅을 가져옵니다. 이 엔드포인트에서 얻은 결과는 광고 관리자의 상세 타게팅 UI 구성 요소의 둘러보기 기능에 표시됩니다.

curl -G \
-d "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/targetingbrowse

다음과 같은 선택적 매개변수를 제공합니다.

이름 설명

limit_type

유형: 문자열

검색할 타겟 유형을 제한합니다. 모든 유형을 기본값으로 지정합니다.

locale

유형: 문자열

타겟 이름과 설명을 표시할 로캘. 광고 계정의 로캘이 기본값으로 지정됩니다.

검증

타겟이 타게팅에 유효한지 여부를 확인합니다. 이는 광고 세트를 이미 만들었고 타게팅 사양이 여전히 유효한지 확인하고자 할 때 유용합니다. 타게팅이 유효하지 않은 경우, 타게팅 사양에서 삭제해야 합니다.

curl -G \
-d "targeting_list=[{'type':'interests','id':6003283735711}, {'type':'relationship_statuses','id':100}]" \
-d "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/targetingvalidation

이 엔드포인트는 표준 상세 타게팅 응답 필드 외에도 다음 내용을 반환합니다.

이름 설명

valid

유형: 부울

타게팅하는 타겟이 유효한지 여부

입력 매개변수의 리스트는 다음과 같습니다.

이름 설명

targeting_list

유형: {'type':'{TYPE}', 'id':{ID}}의 배열

확인을 위해 {'type':'{TYPE}', 'id':{ID}}의 배열을 페어링합니다. 선호됩니다.

id_list

유형: 문자열 배열

확인을 위한 ID 배열. ID가 타겟 데이터베이스에서 고유하게 식별 가능할 경우에만 성공합니다.

name_list

유형: 문자열 배열

확인을 위한 문자열 배열. 관심사만 해당하며, 대소문자를 구분합니다.

locale

유형: 문자열

타겟 이름과 설명을 표시할 로캘. 광고 계정의 로캘이 기본값으로 지정됩니다.

targeting_list, id_list, name_list 중 하나 이상을 제공합니다.