마케팅 API

광고 크리에이티브

Facebook 광고를 사용하여 기존 고객과 소통하고 새로운 고객에게 도달하세요. 각 가이드에서 광고 목표를 달성하는 데 도움이 되는 Facebook 광고 제품을 설명합니다. 다양한 모양, 노출 위치 및 크리에이티브 옵션을 제공하는 여러 유형의 광고 유닛이 있습니다. 크리에이티브 콘텐츠로서의 광고 유닛에 대한 가이드라인은 Facebook 광고 가이드를 참조하세요.

크리에이티브

광고 크리에이티브는 광고를 시각적으로 렌더링하기 위한 모든 데이터를 포함하는 개체입니다. API에서는 여러 유형의 Facebook 광고를 만들 수 있으며, 전체 리스트는 여기에서 확인할 수 있습니다.

이제 페이지 게시물 참여 목표의 캠페인이 있는 경우 페이지에서 만든 게시물을 홍보하는 광고, 즉 페이지 게시물 광고를 만들 수 있습니다. 페이지 게시물 광고는 object_story_id라는 필드가 필요한데, 이는 페이지 게시물의 id 속성입니다. 자세한 내용은 광고 크리에이티브, 참고 자료를 참조하세요.

광고 크리에이티브는 세 부분으로 구성됩니다.

광고 크리에이티브 개체를 만들려면 다음과 같이 호출하세요.

curl -X POST \
  -F 'name="Sample Promoted Post"' \
  -F 'object_story_id="<PAGE_ID>_<POST_ID>"' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives
  
Open In Graph API Explorer

API 호출에 대한 응답은 크리에이티브 개체의 id입니다. 이는 광고 개체에 필요하므로 저장하세요.


curl -X POST \
  -F 'name="My Ad"' \
  -F 'adset_id="<AD_SET_ID>"' \
  -F 'creative={
       "creative_id": "<CREATIVE_ID>"
     }' \
  -F 'status="PAUSED"' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/ads
  
Open In Graph API Explorer

제한 사항

크리에이티브의 문구, 이미지 크기, 이미지 비율 및 기타 요소에는 제한이 있습니다. 광고 가이드를 참조하세요.

읽기

광고 API에서는 id를 제외하고 검색하고자 하는 각 필드를 명시적으로 요청해야 합니다. 각 개체의 참고 자료에서 개체를 다시 읽어오고 읽기 가능한 필드를 표시하는 섹션을 참조하세요. 크리에이티브의 경우 개체와 id를 만들 때 지정한 것과 동일한 필드입니다.


curl -G \
  -d 'fields=name,object_story_id' \
  -d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/<CREATIVE_ID>Open In Graph API Explorer

노출 위치

노출 위치란 데스크톱 피드, 모바일 기기 피드, 오른쪽 칼럼과 같이 Facebook에서 광고가 표시되는 위치입니다. 광고 제품 가이드를 참조하세요.

이용 가능한 노출 위치의 전체 범위에 광고를 게재하는 것이 좋습니다. Facebook의 광고 경매는 가장 낮은 비용으로 캠페인 성과를 유도할 가능성이 가장 높은 노출 위치에 광고 콘텐츠를 노출하도록 제작되었습니다.

이러한 최적화를 활용하는 가장 간편한 방법은 이 필드를 비워두는 것입니다. 광고 세트의 target_spec에서 특정 노출 위치를 선택할 수도 있습니다.

이러한 예로는 페이지 게시물 광고가 있습니다. 사용 가능한 노출 위치는 모바일 피드, 데스크톱 피드, Facebook 오른쪽 칼럼입니다. API에서 노출 위치 옵션을 참조하세요. desktopfeed와 rightcolumn을 page_type으로 선택하면 데스크톱 피드 및 오른쪽 칼럼 노출 위치에 광고가 실행됩니다. 이 광고 세트 아래에 생성된 모든 광고에는 데스크톱 노출 위치만 있습니다.

curl -X POST \
  -F 'name=Desktop Ad Set' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'daily_budget=10000' \
  -F 'targeting={ 
    "geo_locations": {"countries":["US"]}, 
    "publisher_platforms": ["facebook","audience_network"] 
  }' \
  -F 'optimization_goal=LINK_CLICKS' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'bid_amount=1000' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adsets
  

Open In Graph API Explorer

광고 미리 보기

광고 미리 보기 API 또는 광고 미리 보기 플러그인을 사용하여 광고를 미리 볼 수 있습니다.

API로 미리 보기를 생성하는 데는 다음과 같은 세 가지 방법이 있습니다.

  1. 광고 ID 사용
  2. 광고 크리에이티브 ID 사용
  3. 크리에이티브 사양 제공

미리 보기 API에 대한 참고 자료에 따르면 최소 요구 API 호출은 다음과 같습니다.


curl -G \
  --data-urlencode 'creative="<CREATIVE_SPEC>"' \
  -d 'ad_format="<AD_FORMAT>"' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/generatepreviews
  
Open In Graph API Explorer

크리에이티브 사양은 광고 크리에이티브를 만드는 데 필요한 각 필드 및 값의 배열입니다.

현재 광고 크리에이티브 호출은 다음과 같습니다.


curl -X POST \
  -F 'name="Sample Promoted Post"' \
  -F 'object_story_id="<PAGE_ID>_<POST_ID>"' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Open In Graph API Explorer

object_story_id를 가져와 미리 보기 API 호출에 사용합니다.


curl -G \
  -d 'creative={"object_story_id":"<PAGE_ID>_<POST_ID>"}' \
  -d 'ad_format=<AD_FORMAT>' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/generatepreviews


Open In Graph API Explorer

ad_format의 이용 가능한 값은 page_types와 약간 다릅니다. 하지만 이 시나리오에서는 데스크톱 피드와 Facebook의 오른쪽 칼럼이 선택됩니다. 이렇게 하려면 API를 두 번 호출하여 각 노출 위치에 대한 미리 보기를 생성해야 합니다.



curl -G \
  -d 'creative={"object_story_id":"<PAGE_ID>_<POST_ID>"}' \
  -d 'ad_format=DESKTOP_FEED_STANDARD' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/generatepreviews
  
Open In Graph API Explorer

curl -G \
  -d 'creative={"object_story_id":"<PAGE_ID>_<POST_ID>"}' \
  -d 'ad_format=RIGHT_COLUMN_STANDARD' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/generatepreviews

Open In Graph API Explorer

응답은 24시간 동안 유효한 iFrame입니다.

더 보기