마케팅 API

추적 및 전환 사양

추적 사양을 사용하면 광고에서 사람들이 취한 행동을 로깅할 수 있습니다. 이 기능은 특정 행동에 광고 게재를 최적화하지 않으며 발생한 해당 행동을 기반으로 광고 계정에 비용을 청구하지 않습니다.

마케팅 API v2.3 이전 버전에서 전환 사양은 최적화된 CPM의 광고 설정입니다. 전환 사양은 특정 행동에 광고 게재를 최적화하고 전환 보고서에 해당 행동을 표시합니다. v2.4 이후 버전에서 conversion_specs는 읽기 전용입니다.광고 세트에서 optimization_goal을 사용하여 광고 게재 최적화를 선택하세요.

추적 사양 설정

원하는 입찰 유형 및 크리에이티브에 사용하세요. 추적 사양을 지정하려면 광고에 tracking_specs라는 추가 필드가 필요합니다. tracking_specs 필드는 행동 사양과 동일한 인수를 취합니다. 광고를 만들려면 광고 만들기를 참조하세요.

기본 추정 사양

다음 광고 목표에는 기본 추적 사양이 적용됩니다. 기본 사양으로 변경하면 기존 사양을 덮어쓰는 대신 기존 사양에 추가됩니다.

목표가 NONE 또는 App Install/Engagement Ads이면 기본 추적 사양을 덮어씁니다. 기본 사양을 가지려면 맞춤 사양에 추가해야 합니다.

사양에 'APPLICATION_ID' 또는 ['APPLICATION_ID']와 같은 문자열 또는 배열 표기법을 모두 사용할 수 있습니다.

  • CPM은 billing_event=IMPRESSIONS, optimization_goal=IMPRESSIONS를 가리킵니다.
  • CPC는 billing_event=CLICKS, optimization_goal=CLICKS를 가리킵니다.
  • oCPM은 행동에 설정된 billing_event=IMPRESSIONS, optimization_goal을 가리킵니다.
  • CPA는 행동에 설정된 billing_event와 optimization_goal을 모두 가리킵니다.
목표 크리에이티브, 입찰 유형 추적 사양 설명

CANVAS_APP_
ENGAGEMENT

optimization_goal= APP_INSTALLS인 캔버스 앱 참여 광고

[{'action.type':
'app_engagement',
'application':
'APPLICATION_ID'}, {'action.type':
'post_engagement',
'post':'POST_ID', 'page':'PAGE_ID'}]

app_engagement 및 post_engagement 메타 사양을 참조하세요.

CANVAS_APP_
INSTALLS

최적화가 optimization_goal= APP_INSTALLS로 설정되지 않은 캔버스 앱 설치 광고

[{'action.type':
'app_engagement',
'application':
'APPLICATION_ID'}, {'action.type':
'post_engagement',
'post':'POST_ID', 'page':'PAGE_ID'}]

app_engagement 및 post_engagement 메타 사양을 참조하세요.

전환

promoted_object가 픽셀 ID로 설정되고 optimization_goal= OFFSITE_CONVERSIONS인 페이지 게시물 링크 및 사진 광고

{'action.type':
'post_engagement',
'post':'POST_ID', 'page':'PAGE_ID'},
{'action.type':'like',
'page':PAGE_ID}

게시물 참여, 페이지 좋아요 사양. 링크가 하나만 있는 경우 특정 페이지 게시물의 링크 클릭수, 게시물 참여 횟수, 사용자가 스토리를 생성하거나 페이지에 참여한 횟수

전환

최적화가 optimization_goal= OFFSITE_CONVERSIONS로 설정되지 않은 페이지 게시물 링크 및 사진 광고

{'action.type':
'offsite_conversion',
'fb_pixel':
'FACEBOOK_PIXEL_ID'}, {'action.type':{'action.type':
'post_engagement',
'post':'POST_ID', 'page':'PAGE_ID'},
{'action.type':'like',
'page':PAGE_ID}

전환, 게시물 참여, 페이지 좋아요 사양. 링크가 하나만 있는 경우 특정 페이지 게시물의 링크 클릭수, 게시물 참여 횟수, 사용자가 스토리를 생성하거나 페이지에 참여한 횟수

전환

promoted_object가 픽셀 ID로 설정되고 optimization_goal= OFFSITE_CONVERSIONS인 도메인 광고

{'action.type':
'link_click',
'object':'URL'}, {'action.type':'like',
'page':PAGE_ID}

페이지 좋아요, 링크 클릭 사양. 링크가 하나만 있는 경우 특정 페이지 게시물의 링크 클릭수, 게시물 참여 횟수, 사용자가 스토리를 생성하거나 페이지에 참여한 횟수.

전환

최적화가 optimization_goal= OFFSITE_CONVERSIONS로 설정되지 않은 도메인 광고

{'action.type':
'offsite_conversion',
'fb_pixel':
'FACEBOOK_PIXEL_ID'}, {'action.type':
'link_click',
'object':'URL'}, {'action.type':'like',
'page':PAGE_ID}

전환, 페이지 좋아요, 링크 클릭 사양. 링크가 하나만 있는 경우 특정 페이지 게시물의 링크 클릭수, 게시물 참여 횟수, 사용자가 스토리를 생성하거나 페이지에 참여한 횟수.

EVENT_RESPONSES

최적화가 optimization_goal= EVENT_RESPONSES로 설정되지 않은 이벤트 광고

[{'action.type':'rsvp' ,
'response':'yes', 'event':'EVENT_ID'},
{'action.type':'rsvp' ,
'response':'maybe', 'event':'EVENT_ID'},
[{'action.type':'rsvp' ,
'response':'no', 'event':'EVENT_ID'}]

이벤트 참석 여부 알림(예, 불확실, 아니요) 수.

EVENT_RESPONSES

optimization_goal= EVENT_RESPONSES인 이벤트 광고

비어 있음(전환 사양에는 추적된 행동이 포함됨)

이벤트 참석 여부 알림(예, 불확실, 아니요) 수.

LINK_CLICKS

입찰 옵션에 제한이 없는 페이지 게시물 링크 및 사진 광고

{'action.type':
'post_engagement',
'post':'POST_ID', 'page':'PAGE_ID'}

게시물 참여.
오프사이트 URL 링크, 특정 URL 도메인의 링크, 페이지의 오프사이트 링크, 게시물의 오프사이트 링크가 클릭된 횟수.

LINK_CLICKS

optimization_goal= LINK_CLICKS인 도메인 광고

{'action.type':'like',
'page':PAGE_ID}]

페이지 좋아요.
오프사이트 URL 링크, 특정 URL 도메인의 링크, 페이지의 오프사이트 링크, 게시물의 오프사이트 링크가 클릭된 횟수.

LINK_CLICKS

최적화가 optimization_goal= LINK_CLICKS로 설정되지 않은 도메인 광고

{'action.type':
'link_click',
'object':'URL'}, {'action.type':'like',
'page':PAGE_ID}

웹사이트 클릭, 페이지 좋아요.
오프사이트 URL 링크, 특정 URL 도메인의 링크, 페이지의 오프사이트 링크, 게시물의 오프사이트 링크가 클릭된 횟수.

MOBILE_APP_
ENGAGEMENT

입찰 옵션에 제한이 없는 모바일 앱 참여 광고

{'action.type':
'post_engagement',
'post':'POST_ID', 'page':'PAGE_ID'}
앱 참여 광고의 경우 Facebook 앱 ID를 사용하여 명시적으로 추적 사양을 지정해야 합니다.
[{'action.type': 'mobile_app_install', 'application': 'APP_ID'}, {'action.type':
'app_custom_event',
'application':APP_ID}]

post_engagement 메타 사양을 참조하세요. 또한 앱 이벤트가 발생한 횟수.

MOBILE_APP_
INSTALLS

입찰 옵션에 제한이 없는 모바일 앱 설치 광고

{'action.type':
'post_engagement',
'post':'POST_ID', 'page':'PAGE_ID'}
앱 설치 광고의 경우 Facebook 앱 ID를 사용하여 명시적으로 추적 사양을 지정해야 합니다.
[{'action.type':
'app_custom_event',
'application':APP_ID}, {'action.type': 'mobile_app_install', 'application': 'APP_ID'}]

post_engagement 메타 사양을 참조하세요. 또한 iOS/Android 버전이 있는 경우 사용자가 모바일 앱 설치 광고를 통해 앱을 설치한 횟수 및 앱 이벤트가 발생한 횟수.

없음

모든 광고 유형

광고 유형별 기본
추적 사양을 참조하세요.

PAGE_LIKES

입찰 옵션에 제한이 없는 페이지 좋아요 광고 또는 페이지 게시물 광고

{'action.type':
'page_engagement', 'page':'PAGE_ID'}

페이지 참여 메타 사양을 참조하세요.

POST_ENGAGEMENT

최적화가 optimization_goal= POST_ENGAGEMENT로 설정되지 않은 페이지 게시물 광고

{'action.type':
'post_engagement',
'post':'POST_ID', 'page':'PAGE_ID'}

페이지 게시물 참여 메타 사양을 참조하세요.

POST_ENGAGEMENT

optimization_goal= POST_ENGAGEMENT인 페이지 게시물 광고

비어 있음

페이지 게시물 참여 메타 사양을 참조하세요.

POST_ENGAGEMENT(테스팅)

전체

{'action.type':
'dwell',
'post':'POST_ID', 'page':'PAGE_ID'}

이 종류의 광고 중 일부만 dwell 추적 유형으로, 광고에 1분 이상의 시간을 지출한 사용자에 초점을 맞춥니다.

PRODUCT_ CATALOG_SALES

다이내믹 제품 광고

{'action.type': 'post_engagement', 'page': PAGE_ID, 'post': POST_ID}

링크가 하나만 있는 경우 특정 페이지 게시물의 링크 클릭수, 게시물 참여 횟수, 사용자가 스토리를 생성하거나 페이지에 참여한 횟수. 홍보된 개체의 제품 세트와 다른 제품 세트를 지정할 수 있지만 기본값은 홍보된 개체에 지정된 제품 세트입니다.

메타 사양

단일 사양을 사용하여 단일 개체에 여러 유형의 행동을 지정할 수 있습니다.

개체 전환 사양 설명

앱

{"action.type":["app_engagement"], "application":["APPLICATION_ID"]}

사용자가 app_story 스토리를 생성하거나 app_use, app_install, credit_spent를 통해 콘텐츠에 참여한 횟수.

페이지

{"action.type":["page_engagement"], "page":["PAGE_ID"]}

지정된 페이지의 컨텍스트에서 사용자가 다음과 같은 행동을 수행한 횟수: 체크인, 댓글, 팔로우, 좋아요, 페이지 게시물 좋아요, 언급, 페이지에 게시, 게시물 공유, 질문에 답변. 그 외에 지정된 페이지의 컨텍스트에서 사용자가 다음과 같은 행동을 수행한 횟수: 링크 클릭, 사진 조회, 네이티브 Facebook 동영상 재생.

페이지 게시물

{"action.type":["post_engagement"], "post":["POST_ID"], "page":["PAGE_ID"]}

지정된 게시물의 컨텍스트에서 사용자가 다음과 같은 행동을 수행한 횟수: 댓글, 질문 팔로우, 좋아요, 공유, 질문에 답변. 그 외에 사용자가 다음과 같은 행동을 수행한 횟수: 링크 클릭, 페이지 좋아요, 사진 조회, Facebook에서 호스팅되는 동영상 재생 또는 인라인 YouTube 동영상 재생. 포함(embed)되지 않은 동영상의 경우 link_click을 사용하세요.

맞춤 추적 사양

자신만의 추적 사양을 정의하려면 행동 사양 프레임워크를 사용하세요. 행동 사양, 참고 자료를 참조하세요.

행동(개체 유형) 설명, 추적 사양 상세 정보 추적 또는 전환 사양

app_custom_event(앱)

앱의 맞춤 이벤트.
모바일 앱의 맞춤 이벤트 수.

{'action.type':
'app_custom_event',
'application':APP_ID}

app_install(앱)

앱 설치.
캔버스 또는 모바일 앱의
설치 횟수.

[{'action.type':'app_install',
'application':APP_ID},
{'action.type':
'mobile_app_install',
'application':APP_ID}]

app_use(앱)

앱이 사용된 횟수.

{'action.type':'app_use',
'application':APP_ID}

checkin(장소)

장소 체크인.
장소 또는 이 페이지의 하위 장소로 체크인한 횟수.

{'action.type':'checkin',
'page': PAGE_ID},
{'action.type':'checkin',
'page.parent:PAGE_ID}

comment(게시물)

게시물에 댓글 남기기.
모든 또는 특정 페이지 게시물의 댓글 수.

{'action.type':'comment',
'post.wall':PAGE_ID},
{'action.type':'comment',
'post':POST_ID,
'post.wall':PAGE_ID}

credit_spend(앱)

앱에서 크레딧 지출 인스턴스.

'action.type':'credit_spent',
'application':APP_ID}

follow(질문)

개체 받아보기.
질문에 대한 답변 또는 팔로우 수.

{'action.type':'vote', 'question':QUESTION_ID, 'question.creator':PAGE_ID}, {'action.type':'follow', 'question':QUESTION_ID, 'question.creator':PAGE_ID}

leadgen_quality_conversion(픽셀)

하위 퍼널 잠재 고객 전환(CRM) 이벤트.

{'action.type': 'leadgen_quality_conversion', 'fb_pixel': 'FACEBOOK_PIXEL_ID'}, {'action.type': 'leadgen_quality_conversion', 'dataset': 'OFFLINE_EVENT_SET_ID'}

like
(페이지, 게시물)

개체 좋아요.
페이지 또는 게시물의 좋아요 수.

{'action.type':'like',
'page':PAGE_ID}
, {'action.type':'like',
'post.wall':PAGE_ID}
, {'action.type':'like',
'post':POST_ID,
'post.wall':PAGE_ID}

link_click(페이지, 게시물, URL, URL 도메인)

링크 클릭.
오프사이트 URL 링크, 특정 URL 도메인의 링크, 페이지의 오프사이트 링크, 게시물의 오프사이트 링크가 클릭된 횟수.

{'action.type':['link_click'],
'object':['URL']},
{'action.type':['link_click'],
'object.domain':
['URL_DOMAIN']},
{'action.type':['link_click'],
'post.wall':['PAGE_ID']},
{'action.type':['link_click'],
'post':['POST_ID'],
'post.wall':['PAGE_ID']}

mention(페이지)

페이지 언급.
페이지의 언급 수.

{'action.type':'mention',
'object':PAGE_ID'}

offsite_conversion(픽셀)

오프사이트 전환 수, 누적 수익.

{'action.type':
'offsite_conversion',
'fb_pixel':
'FACEBOOK_PIXEL_ID'}

photo_view(페이지)

사진 조회.
사진 조회수,
페이지의 모든 또는 특정 게시물의 photos/videos/link-shares의 video_plays 또는 link_clicks.

{'action.type':'photo_view', 'post.wall':PAGE_ID}
{'action.type':'photo_view', 'post':POST_ID,
'post.wall':PAGE_ID}

post(게시물)

스토리 공유.
페이지의 사용자 게시물 수.

{'action.type':'post',
'post.wall':PAGE_ID}

receive_offer(쿠폰)

쿠폰 받기.
특정 쿠폰을 받은 사람 수.

{'action.type':'receive_offer',
'offer':OFFER_ID}

rsvp(이벤트)

이벤트 참석 여부 알림.
이벤트 참석 여부 알림(예, 불확실) 수. 유효한 값은 yes, maybe 및 no입니다.

{'action.type':'rsvp',
'event': EVENT_ID},

{'action.type':'rsvp',
'response':'yes',
'event': EVENT_ID},

{'action.type':'rsvp',
'response':'no',
'event': EVENT_ID},
{'action.type':'rsvp',
'response':'maybe',
'event': EVENT_ID}

tab_view(페이지)

페이지 탭 조회.
특정 페이지 탭의 조회수. 모든 탭을 조회하려면 페이지만 지정하세요.

{'action.type':'tab_view',
'page.tab.name':
'PAGE_TAB_NAME', 'page':PAGE_ID},
{'action.type':'tab_view',
'page':PAGE_ID}

video_play(게시물)

동영상 조회.
페이지의 모든 또는 특정 동영상 게시물의 동영상 조회수.

{'action.type':'video_play', 'post.wall':PAGE_ID},{'action.type':'video_play', 'post':POST_ID,
'post.wall':PAGE_ID}

예시

픽셀 추적

광고의 tracking_specs 필드에 추적 픽셀을 지정하여 광고에서 여러 픽셀의 성과를 추적하세요. 예를 들면 다음과 같습니다.

tracking_specs="[
  {'action.type':'offsite_conversion','fb_pixel':1},
  {'action.type':'offsite_conversion','fb_pixel':2},
  {'action.type':'offsite_conversion','fb_pixel':3}
]"

픽셀 ‘1’, ‘2’, ‘3’의 성과를 추적합니다. 픽셀 '1'에만 최적화하려면 상위 광고 세트의 promoted_object를 정의하세요. CHECKOUT에 최적화할 때뿐만 아니라 REGISTRATION과 ADD_TO_CART 개수를 추적하고자 할 때도 유용합니다.

promoted_object에 픽셀 ID를 지정하여 최적화된 픽셀은 자동으로 추적되므로 tracking_specs에 같은 픽셀을 지정하지 않아도 됩니다.

전환 사양 사용

conversion_specs는 광고에 대한 필드입니다. 각 행동이 개체에 적용되는 경우 {'action.type':'{ACTION}', ... } 형식을 따릅니다. 다양한 광고 유형에 대한 전환 사양의 예시는 다음과 같습니다.

광고 유형 전환 사양

소셜 컨텍스트가 표시된 도메인 광고

{'action.type':'link_click', 'object':'URL'}

페이지 좋아요 광고

{'action.type':'like', 'page':PAGE_ID}

페이지 게시물 링크 광고

{'action.type':['link_click'], 'post': [POST_ID], 'post.wall':[PAGE_ID]}

기타 모든 페이지 게시물 광고

{'action.type':'post_engagement', 'post':'POST_ID', 'page':'PAGE_ID'}

이벤트 광고

{'action.type':'rsvp' , 'response':'yes', 'event':'EVENT_ID'}

쿠폰 광고

{'action.type':'receive_offer', 'offer':OFFER_ID, 'offer.creator':PAGE_ID}

모바일 앱 설치 광고

해당 사항 없음 - NONE 목표로 이런 광고를 만들 수 없음

모바일 앱 참여 광고

해당 사항 없음 - CPC 및 CPM 입찰 유형만 지원됨

캔버스 앱 설치 광고

해당 사항 없음 - NONE 목표로 이런 광고를 만들 수 없음

캔버스 앱 참여 광고

해당 사항 없음 - NONE 목표로 이런 광고를 만들 수 없음

일부 전환 사양에는 단일 개체에 적용되는 여러 행동이 포함됩니다. 이를 메타 사양이라고 합니다. 아래의 예를 참조하세요.

개체 전환 사양 설명

페이지

{"action.type":["page_engagement"], "page":["PAGE_ID"]}

특정 페이지에서 다음과 행동을 취한 횟수: 체크인, 댓글, 팔로우, 좋아요, 페이지 게시물 좋아요, 언급, 페이지에 게시, 게시물 공유, 질문에 답변. 특정 페이지에서 다음 행동을 수행한 횟수 포함: 사진 조회, 네이티브 Facebook 동영상 재생.

페이지 게시물

{"action.type":["post_engagement"], "post":["POST_ID"], "page":["PAGE_ID"]}

특정 게시물에서 다음 행동을 취한 횟수: 댓글, 질문 팔로우, 좋아요, 공유, 쿠폰 받기, 질문에 답변. 다음 행동을 수행한 횟수 포함: 링크 클릭, 페이지 좋아요, 사진 조회, Facebook에서 호스팅되는 동영상 재생 또는 인라인 YouTube 동영상 재생. 포함(embed)되지 않은 동영상의 경우 link_click을 사용하세요.

앱

{"action.type":["app_engagement"], "application":["APPLICATION_ID"]}

누군가 app_story를 생성하거나 app_use, app_install 또는 credit_spent로 콘텐츠에 참여한 횟수.