동영상 및 슬라이드 광고

API를 사용하여 Facebook에서 쉽게 동영상과 슬라이드 광고를 만들고 측정하고 최적화할 수 있습니다. Facebook for Business, 슬라이드 광고를 참조하세요. 광고에 지원되는 동영상 형식은 광고주 지원 센터, 동영상을 참조하세요.

동영상 광고

VIDEO_VIEWS 목표에서 동영상 광고를 만들고 도달에 대한 입찰을 최적화하려면 다음 단계를 따르세요.

• 1단계: 광고 크리에이티브 제공
• 2단계: 광고 캠페인 만들기
• 3단계: 광고 세트 만들기
• 4단계: 광고 만들기

1단계: 광고 크리에이티브 제공

기존 동영상 ID와 Facebook에 업로드한 동영상을 사용하여 동영상 광고를 만듭니다.

다음과 같은 항목이 필요합니다.

• pages_read_engagement 및 ads_management 권한
• act_{ad-account-id}/advideos 엔드포인트에 업로드한 동영상

curl \
  -F 'name=Sample Creative' \
  -F 'object_story_spec={ 
  "page_id": "<PAGE_ID>", 
  "video_data": {"image_url":"<THUMBNAIL_URL>","video_id":"<VIDEO_ID>"} 
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives
  
Open In Graph API Explorer

슬라이드쇼

브랜드 캠페인을 신흥 시장의 기본 피처폰으로 확장 또는 출시하거나 간단한 동영상을 만들려면 이미지 슬라이드쇼를 사용해보세요(이미지 3개 이상 필요). 이미지를 동영상 자산으로 업로드하세요. 예를 들면 다음과 같습니다.

curl \
  -F 'slideshow_spec={ 
  "images_urls": [ 
  "<IMAGE_URL_1>", 
  "<IMAGE_URL_2>", 
  "<IMAGE_URL_3>" 
  ], 
  "duration_ms": 2000, 
  "transition_ms": 200 
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph-video.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/advideos
 
  Open In Graph API Explorer

동영상 크리에이티브 모범 사례와 참고 자료: 광고 동영상을 참조하세요.

2단계: 광고 캠페인 만들기

목표를 VIDEO_VIEWS로 설정합니다.

curl -X POST \
  -F 'name="Video Views campaign"' \
  -F 'objective="OUTCOME_ENGAGEMENT"' \
  -F 'status="PAUSED"' \
  -F 'special_ad_categories=[]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/campaigns
  
Open In Graph API Explorer

참고 자료: 캠페인, PHP의 AdObjectives 및 Python의 AdObjectives를 참조하세요.

3단계: 광고 세트 만들기

조회당 비용을 최소화하는 것이 목표라면 동영상 조회 캠페인 목표와 광고 세트의 optimization_goal=THRUPLAY를 결합해야 합니다. bidding_event를 IMPRESSIONS 또는 THRUPLAY로 설정하여 노출 또는 동영상 조회 기준으로 비용을 지불할 수 있습니다. CPV 입찰을 참조하세요.

curl \
  -F 'name=A CPV Ad Set' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'daily_budget=500' \
  -F 'start_time=2024-05-06T04:45:29+0000' \
  -F 'end_time=2024-06-06T04:45:29+0000' \
  -F 'billing_event=THRUPLAY' \
  -F 'optimization_goal=THRUPLAY' \
  -F 'bid_amount=100' \
  -F 'targeting={ 
  "device_platforms": ["mobile"], 
  "geo_locations": {"countries":["US"]}, 
  "publisher_platforms": ["facebook"] 
  }' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adsets


  Open In Graph API Explorer

optimization_goal=THRUPLAY인 광고 세트의 조회당 비용은 동영상 조회에 최적화된 도달 및 빈도 구매의 CPV보다 저렴합니다. 종료 날짜는 미래여야 합니다. 참고 자료: 광고 세트를 참조하세요.

4단계: 광고 만들기

기존 광고 세트와 광고 크리에이티브를 사용합니다.

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

캠페인 목표가 VIDEO_VIEWS이면 기본적으로 광고에 적절한 추적 사양(광고에 대해 추적되는 행동 정의)이 설정됩니다. 예를 들어 동영상 조회는 다음과 같습니다.

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

광고 관리자: 내 캠페인과 참고 자료: 광고를 참조하세요.

브랜드 인지도 예시

브랜드 인지도에 대한 동영상 광고를 만들려면 브랜드 인지도 블로그를 참조하세요.

도달 및 빈도 예시

동영상의 도달 범위를 더 많은 사람에게 확대하려면 도달 및 빈도와 함께 동영상 조회 캠페인 목표를 사용하세요. 예측을 만들고 예약하고 광고 세트에 할당해야 합니다.

동영상 조회 만들기를 따르고 도달 및 빈도를 광고 세트에 적용하세요. 다음 매개변수를 추가로 지정하세요.

-F "rf_prediction_id=<RESERVATION_ID>" \

DR(직접 반응)을 위한 동영상

사용자를 인지도에서 행동으로 이동하도록 유도하려면 슬라이드 형식의 동영상 크리에이티브를 참조하세요.

• 동영상을 조회한 사용자에게 도달하세요. 인지도에서 친밀도 및 고려로 이동하세요. 리마케팅을 참조하세요.
• 브랜드 및 제품에 참여를 유도하세요. 웹사이트의 특정 페이지를 방문하기 위한 행동 유도를 추가하세요. 행동 유도를 참조하세요.

리마케팅

동영상 광고 리마케팅은 광고주가 Facebook과 Instagram의 일반 또는 유료 동영상에서 특정 맞춤 타겟을 타게팅하도록 지원합니다. 이 기능을 사용하여 사용자를 인지도에서 더 심층적인 퍼널 목표(예: 친밀도, 고려)로 이동시킬 수 있습니다. 연구: 효과적인 크리에이티브 조합을 참조하세요.

동영상에 대한 타겟을 만들려면 해당 동영상이 포함된 페이지에 대한 광고주 권한이 필요합니다.

타겟은 subtype=ENGAGEMENT로 설정합니다. 그런 다음 만들려는 타겟에 대한 규칙을 작성합니다. 각 규칙에는 object_id(예: 동영상 ID)와 event_name이 있습니다. event_name은 다음 중 하나입니다.

• video_watched: 동영상을 총 3초 이상 조회했거나 전체 동영상을 거의 모두 조회한 횟수(먼저 발생한 시점 기준).
• video_completed: 동영상에서 전체 길이의 95% 지점까지 조회한 횟수(해당 지점까지 건너뛴 조회 횟수 포함).
• video_view_10s: 동영상을 총 10초 이상 조회했거나 전체 동영상을 거의 모두 조회한 횟수(먼저 발생한 시점 기준).
• video_view_15s: 동영상을 총 15초 이상 조회했거나 전체 동영상을 거의 모두 조회한 횟수(먼저 발생한 시점 기준).
• video_view_25_percent: 동영상에서 전체 길이의 25% 지점까지 조회한 횟수(해당 지점까지 건너뛴 조회 횟수 포함).
• video_view_50_percent: 동영상에서 전체 길이의 50% 지점까지 조회한 횟수(해당 지점까지 건너뛴 조회 횟수 포함).
• video_view_75_percent: 동영상에서 전체 길이의 75% 지점까지 조회한 횟수(해당 지점까지 건너뛴 조회 횟수 포함).

동영상을 결합하여 다양한 동영상 및 행동을 기반으로 타겟을 만들 수 있습니다. 예를 들어 한 타겟에 동영상 A를 3초 이상 조회한 횟수 및 동영상 B와 C를 조회 완료한 횟수가 포함될 수 있습니다.

이렇게 하면 지난 14일 동안 동영상 1을 3초 이상 조회한 사용자와 동영상 2의 조회를 완료한 사용자의 타겟이 생성됩니다. prefill=true이면 타겟을 만들기 전에 조회한 사용자도 자동으로 입력됩니다.

curl \
  -F 'name=Video Ads Engagement Audience' \
  -F 'subtype=ENGAGEMENT' \
  -F 'description=Users who watched my video' \
  -F 'prefill=1' \
  -F 'rule=[ 
  {"object_id":"%video_id_1","event_name":"video_watched"}, 
  {"object_id":"%video_id_2","event_name":"video_completed"} 
  ]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/customaudiences
  
Open In Graph API Explorer

백업 광고는 2015년 10월 16일 이후의 동영상 조회에 지원됩니다.

행동 유도

행동 유도가 포함된 동영상은 사용자가 자세히 알아보고 웹사이트의 특정 페이지를 방문하도록 유도합니다. 기본 목표가 동영상 조회 또는 브랜드 인지도를 향상하는 것이고 2차 목표가 오프사이트 클릭을 유도하는 것일 때 성과를 개선해보세요. 오프사이트 클릭의 경우 동영상 링크 광고를 사용해야 합니다. CTA 렌더링 방식:

• 모바일과 데스크톱의 경우 게시물의 일부로 표시됩니다. 동영상이 일시 중단되면 '다시 시작' 옵션 옆에 표시됩니다.
• 모바일의 경우 누군가 전체 화면에서 동영상을 클릭하여 조회할 때 움직이는 CTA가 동영상 오버레이로 표시됩니다.
• 외부 동영상 링크 게시물에는 CTA가 표시되지 않습니다.

CTA가 포함된 동영상은 다음 캠페인 목표와 함께만 사용할 수 있습니다.

• PAGE_LIKES
• LEAD_GENERATION
• LOCAL_AWARENESS
• LINK_CLICKS
• CONVERSIONS
• APP_INSTALLS
• VIDEO_VIEWS
• BRAND_AWARENESS
• 모바일 앱 참여

추가 목표로 동영상 확장을 참조하세요. 이렇게 하면 GET_DIRECTIONS 행동 유도가 포함된 동영상 광고가 생성됩니다.

curl \
  -F 'object_story_spec={ 
  "page_id": "<PAGE_ID>", 
  "video_data": { 
  "call_to_action": { 
  "type": "GET_DIRECTIONS", 
  "value": { 
  "link": "fbgeo:\/\/37.48327, -122.15033, \"1601 Willow Rd Menlo Park CA\"" 
  } 
  }, 
  "image_url": "<THUMBNAIL_URL>", 
  "link_description": "Come check out our new store in Menlo Park!", 
  "video_id": "<VIDEO_ID>" 
  } 
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
   https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Open In Graph API Explorer

동영상 지표

동영상 게시물 인사이트, 일반

Facebook에서 동영상의 성과에 대해 자세히 알아보고 동영상 콘텐츠 관련 정보를 바탕으로 현명한 결정을 내리세요. 현재는 동영상을 조회한 사람이 있을 때만 지표를 제공합니다. 여기에는 동영상 조회수, 고유한 동영상 조회수, 평균 동영상 조회 시간, 타겟 잔류율이 포함됩니다. 사용자가 동영상에서 시청을 중단한 시점과 가장 흥미롭게 시청한 부분을 확인하세요.

동영상 광고 인사이트, 유료

광고 인사이트 API를 사용하세요. 응답에는 다양한 동영상 지표가 포함되어 있습니다.

동영상 유형

자동 재생, 클릭 재생 등 동영상 유형별로 분류된 동영상 광고 통계를 검색하세요. action_breakdowns에 action_video_type을 포함하세요. action_video_type에 대해 예상되는 값은 total, click_to_play 및 auto_play입니다.

현재 action_video_type 옵션을 제한적으로 테스트하고 있습니다. 분석 데이터로 클라이언트를 식별하려면 광고 계정의 CAN_USE_VIDEO_METRICS_BREAKDOWN을 확인하세요.

curl -G \
  -d 'action_breakdowns=action_video_type' \
  -d 'date_preset=last_30_days' \
  -d 'fields=actions,video_avg_pct_watched_actions,video_complete_watched_actions' \
  -d 'access_token= <ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/insights
   
Open In Graph API Explorer

응답에는 action_type이 video_view인 개체와 action_video_type 키가 포함되어 있습니다.

{
  "data": [
    {
      "actions": [
        ...
        {
          "action_type": "video_play", 
          "value": 9898
        }, 
        {
          "action_type": "video_view", 
          "action_video_type": "total", 
          "value": 921129
        }, 
        {
          "action_type": "video_view", 
          "action_video_type": "auto_play", 
          "value": 915971
        }, 
        {
          "action_type": "video_view", 
          "action_video_type": "click_to_play", 
          "value": 5158
        }
      ], 
      "video_avg_pct_watched_actions": [
        {
          "action_type": "video_view", 
          "action_video_type": "total", 
          "value": 60.59
        }, 
        {
          "action_type": "video_view", 
          "action_video_type": "auto_play", 
          "value": 60.47
        }, 
        {
          "action_type": "video_view", 
          "action_video_type": "click_to_play", 
          "value": 80.63
        }
      ], 
      "video_complete_watched_actions": [
        {
          "action_type": "video_view", 
          "action_video_type": "total", 
          "value": 156372
        }, 
        {
          "action_type": "video_view", 
          "action_video_type": "auto_play", 
          "value": 154015
        }, 
        {
          "action_type": "video_view", 
          "action_video_type": "click_to_play", 
          "value": 2357
        }
      ], 
      "date_start": "2014-12-26", 
      "date_stop": "2015-03-25"
    }
  ], 
  "paging": {
    "cursors": {
      "before": "MA==", 
      "after": "MA=="
    }
  }
}

광고 인사이트 API 참조

슬라이드 광고

피드에서 더 많은 광고 공간을 확보하고 사용자를 웹사이트 또는 모바일 앱으로 전환하도록 유도하세요. 슬라이드 광고는 두 가지 방법으로 만들 수 있습니다.

• 광고 크리에이티브 API를 한 번 호출하여 광고와 비공개 페이지 게시물을 만듭니다.
• 비공개 페이지 게시물을 만든 다음, 게시물을 사용하여 광고 크리에이티브를 만듭니다(동영상 슬라이드에서는 사용할 수 없음).

Facebook 스토리에서는 슬라이드 광고가 지원되지 않습니다.

인라인 만들기

광고 크리에이티브를 만드는 동안 슬라이드 광고 페이지 게시물을 만듭니다. object_story_spec에 페이지 게시물 콘텐츠를 지정하면 adcreatives에서 비공개 페이지 게시물이 생성됩니다. 광고 크리에이티브를 참조하세요. 예를 들면 다음과 같습니다.

curl \
  -F 'name=Sample Creative' \
  -F 'object_story_spec={ 
    "link_data": { 
      "child_attachments": [ 
        { 
          "description": "$8.99", 
          "image_hash": "<IMAGE_HASH>", 
          "link": "https:\/\/www.link.com\/product1", 
          "name": "Product 1", 
          "video_id": "<VIDEO_ID>" 
        }, 
        { 
          "description": "$9.99", 
          "image_hash": "<IMAGE_HASH>", 
          "link": "https:\/\/www.link.com\/product2", 
          "name": "Product 2", 
          "video_id": "<VIDEO_ID>" 
        }, 
        { 
          "description": "$10.99", 
          "image_hash": "<IMAGE_HASH>", 
          "link": "https:\/\/www.link.com\/product3", 
          "name": "Product 3" 
        } 
      ], 
      "link": "<URL>" 
    }, 
    "page_id": "<PAGE_ID>" 
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives
  
Open In Graph API Explorer

응답은 크리에이티브 ID입니다.

{"id":"<CREATIVE_ID>"}

게시물을 만든 후 광고 만들기

비공개 페이지 게시물을 만듭니다. child_attachments는 링크 개체의 배열입니다. 각 링크 개체에서 picture, name 및 description은 선택 사항입니다. 이 게시물은 페이지 액세스 토큰을 사용해서만 페이지로 게시할 수 있습니다.

curl -X GET \
  -d 'message="Browse our latest products"' \
  -d 'published=0' \
  -d 'child_attachments=[
       {
         "link": "<APP_STORE_URL>",
         "name": "Product 1",
         "description": "$4.99",
         "image_hash": "<IMAGE_HASH>"
       },
       {
         "link": "<APP_STORE_URL>",
         "name": "Product 2",
         "description": "$4.99",
         "image_hash": "<IMAGE_HASH>"
       },
       {
         "link": "<APP_STORE_URL>",
         "name": "Product 3",
         "description": "$4.99",
         "image_hash": "<IMAGE_HASH>"
       },
       {
         "link": "<APP_STORE_URL>",
         "name": "Product 4",
         "description": "$4.99",
         "image_hash": "<IMAGE_HASH>"
       }
     ]' \
  -d 'caption="WWW.EXAMPLE.COM"' \
  -d 'link="http://www.example.com/products"' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/<PAGE_ID>/posts
  
Open In Graph API Explorer

그런 다음 비공개 페이지 게시물을 포함한 광고 크리에이티브를 제공합니다. 광고 크리에이티브에서 object_story_id에 id를 사용합니다.

curl -X 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

동영상 슬라이드 광고 만들기

동영상 슬라이드 광고는 하위 첨부 파일에 '캡션'이 있으므로 마지막 화면의 표시 URL을 맞춤 설정할 수 있습니다.

"child_attachments": [
 {
   "link": "https://www.facebookmarketingdevelopers.com/",
   "name": "Facebook Marketing Developers",
   "description": "Facebook Marketing Developers",
   "call_to_action": {
     "type": "APPLY_NOW",
     "value": {
      "link_title": "Facebook Marketing Developers"
     }
   },
   "video_id": "123",
   "caption": "mycustomlinkcaption.com"
  },
]

하위 첨부 파일 상세 정보를 가져오려면 ID를 사용하고 그래프 API, 동영상, 참고 자료를 호출하세요.

모바일 앱 광고 만들기

제한 사항:

• 슬라이드 모바일 앱 광고는 하나의 앱만 지원함
• 최소 이미지 수 3개(앱 광고가 아닌 슬라이드 광고의 경우 최소 이미지 수 2개)
• 슬라이드 모바일 앱 광고에는 행동 유도가 있어야 함
• 일반적으로 페이지의 프로필 사진을 표시하는 마지막 슬라이드는 슬라이드 모바일 앱 광고에 표시되지 않음. 각 child_attachment에 동일한 앱 스토어 링크를 지정해야 합니다. call_to_action:{'value':{'link':... }}}에 링크를 다시 지정할 필요는 없습니다.

예를 들어 모바일 앱 설치를 위한 슬라이드 광고를 생성하려면 다음과 같이 합니다.

\

curl -X POST \
  -F 'name="Carousel app ad"' \
  -F 'object_story_spec={
       "page_id": "<PAGE_ID>",
       "link_data": {
         "message": "My message",
         "link": "http://www.example.com/appstoreurl",
         "caption": "WWW.ITUNES.COM",
         "name": "The link name",
         "description": "The link description",
         "child_attachments": [
           {
             "link": "http://www.example.com/appstoreurl",
             "image_hash": "<IMAGE_HASH>",
             "call_to_action": {
               "type": "USE_MOBILE_APP",
               "value": {
                 "app_link": "<DEEP_LINK>"
               }
             }
           },
           {
             "link": "http://www.example.com/appstoreurl",
             "image_hash": "<IMAGE_HASH>",
             "call_to_action": {
               "type": "USE_MOBILE_APP",
               "value": {
                 "app_link": "<DEEP_LINK>"
               }
             }
           },
           {
             "link": "http://www.example.com/appstoreurl",
             "image_hash": "<IMAGE_HASH>",
             "call_to_action": {
               "type": "USE_MOBILE_APP",
               "value": {
                 "app_link": "<DEEP_LINK>"
               }
             }
           },
           {
             "link": "http://www.example.com/appstoreurl",
             "image_hash": "<IMAGE_HASH>",
             "call_to_action": {
               "type": "USE_MOBILE_APP",
               "value": {
                 "app_link": "<DEEP_LINK>"
               }
             }
           }
         ],
         "multi_share_optimized": true
       }
     }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

모바일 앱과 연결된 Facebook 페이지로만 게시물을 게시할 수 있습니다. 그리고, 페이지 액세스 토큰을 사용해야 합니다.

curl \
  -F 'message=My description' \
  -F 'link=<APP_STORE_URL>' \
  -F 'caption=WWW.ITUNES.COM' \
  -F 'child_attachments=[ 
    { 
      "link": "<APP_STORE_URL>", 
      "image_hash": "<IMAGE_HASH_I>", 
      "call_to_action": { 
        "type": "USE_MOBILE_APP", 
        "value": {"app_link":"<DEEP_LINK_I>","link_title":"<LINK_TITLE_I>"} 
      } 
    }, 
    { 
      "link": "<APP_STORE_URL>", 
      "image_hash": "<IMAGE_HASH_I>", 
      "call_to_action": { 
        "type": "USE_MOBILE_APP", 
        "value": {"app_link":"<DEEP_LINK_I>","link_title":"<LINK_TITLE_I>"} 
      } 
    }, 
    { 
      "link": "<APP_STORE_URL>", 
      "image_hash": "<IMAGE_HASH_I>", 
      "call_to_action": { 
        "type": "USE_MOBILE_APP", 
        "value": {"app_link":"<DEEP_LINK_I>","link_title":"<LINK_TITLE_I>"} 
      } 
    }, 
    { 
      "link": "<APP_STORE_URL>", 
      "image_hash": "<IMAGE_HASH_I>", 
      "call_to_action": { 
        "type": "USE_MOBILE_APP", 
        "value": {"app_link":"<DEEP_LINK_I>","link_title":"<LINK_TITLE_I>"} 
      } 
    } 
  ]' \
  -F 'multi_share_optimized=1' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/<PAGE_ID>/feed

응답에서 반환된 id를 사용하여 AdCreative를 만듭니다.

curl -X 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

필드 사양

다음은 설명된 필드가 어떻게 사용되는지 보여주는 iOS의 슬라이드 광고입니다.

제품별 광고 통계

actions_breakdown=['action_carousel_card_id', 'action_carousel_card_name']인 제품별 슬라이드 광고에 대한 그룹 행동. 각 child_attachment의 슬라이드 ID는 서로 다릅니다. action_carousel_card_id 및 action_carousel_card_name은 슬라이드 광고에만 해당됩니다.

각 슬라이드에 대해 다음과 같은 통계를 가져옵니다.

• website_ctr: fields=['website_ctr']을 지정할 경우 제공됩니다.
• app_install, app_use, apps.uses, credit_spent, mobile_app_install, tab_view, link_click, mobile_app_install, app_custom_event.*, offsite_conversion.*: fields=['actions']를 지정할 경우 제공됩니다. 다른 행동은 슬라이드 분석 데이터에 제공되지 않습니다.

curl -G \
  -d 'action_breakdowns=["action_type","action_carousel_card_id"]' \
  -d 'level=ad' \
  -d 'date_preset=last_30_days' \
  -d 'time_increment=all_days' \
  -d 'breakdowns=placement' \
  --data-urlencode 'filtering=[ 
    { 
      "field": "action_type", 
      "operator": "IN", 
      "value": ["link_click"] 
    } 
  ]' \
  -d 'fields=impressions,inline_link_clicks,actions,website_ctr' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/insights
  
Open In Graph API Explorer

응답:

{
...
   "website_ctr": [
      {
         "action_carousel_card_id": "1",
         "action_type": "link_click",
         "value": 51.401869158878
      },
      {
         "action_carousel_card_id": "2",
         "action_type": "link_click",
         "value": 50.980392156863
      }
   ],
   "placement": "mobile_feed",
   "date_start": "2015-05-25",
   "date_stop": "2015-05-28"
}

행동 유형별 비용의 분석 데이터를 보려는 경우 cost_per_action_type을 요청할 수도 있습니다.

curl -G \
  -d 'action_breakdowns=["action_type","action_carousel_card_name"]' \
  -d 'level=ad' \
  -d 'breakdowns=placement' \
  -d 'fields=impressions,campaign_name,cost_per_action_type' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/insights
  
Open In Graph API Explorer

응답 샘플:

{
   "data": [
      {
         "impressions": "1862555",
         "campaign_name": "My Campaign",
         "cost_per_action_type": [
            {
               "action_carousel_card_name": "My Carousel Card 1",
               "action_type": "app_custom_event.fb_mobile_activate_app",
               "value": 0.093347346315861
            },
            {
               "action_carousel_card_name": "My Carousel Card 2",
               "action_type": "app_custom_event.fb_mobile_activate_app",
               "value": 0.38324089579301
            },
            ...
         ],
      }
   ]
}

노출 위치

right_hand_column만 노출 위치로 선택할 경우 단일 동영상 또는 슬라이드 형식만 광고 그룹에 사용할 수 있습니다. right_hand_column 노출 위치만 선택한 경우 동영상 형식은 지원되지 않습니다. 고급 타게팅 및 노출 위치를 참조하세요.

예를 들어 다음과 같이 right_hand_column을 유일한 노출 위치로 하여 광고 세트를 만드세요.

curl \
  -F 'name=RHS only Ad Set' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'daily_budget=500' \
  -F 'start_time=2017-11-21T15:41:36+0000' \
  -F 'end_time=2017-11-28T15:41:36+0000' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'optimization_goal=LINK_CLICKS' \
  -F 'bid_amount=100' \
  -F 'targeting={ 
    "device_platforms": ["mobile"], 
    "geo_locations": {"countries":["US"]}, 
    "publisher_platforms": ["facebook"] ,
    "facebook_positions": ["right_hand_column"] ,  
  }' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adsets
  
Open In Graph API Explorer

다음과 같이 동영상을 포함한 광고 크리에이티브를 제공하세요.

curl \
  -F 'name=Sample Creative' \
  -F 'object_story_spec={ 
    "page_id": "<PAGE_ID>", 
    "video_data": {"image_url":"<THUMBNAIL_URL>","video_id":"<VIDEO_ID>"} 
  }' \
  -F 'access_token=ACCESS_TOKEN' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives
  
Open In Graph API Explorer

또는 다음과 같이 광고 크리에이티브에 캔버스 광고 형식을 제공하세요.

curl \
  -F 'image_hash=<IMAGE_HASH>' \
  -F 'object_story_spec={ 
    "link_data": { 
      "call_to_action": {"type":"LEARN_MORE"}, 
      "image_hash": "<IMAGE_HASH>", 
      "link": "CANVAS_LINK", 
      "name": "Creative message" 
    }, 
    "page_id": "<PAGE_ID>" 
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives
  
Open In Graph API Explorer

광고 세트와 광고 크리에이티브를 사용하여 광고를 만들려는 경우 다음과 같이 하세요.

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

오류 코드가 표시되는 경우 지원되는 크리에이티브를 제공하거나 타게팅을 변경해야 합니다.

기타 참고 자료

• Facebook에 동영상 업로드 가이드
• 모바일 앱 광고용 슬라이드
• 페이지 피드 그래프 API 참고 자료
• 비공개 페이지 게시물
• 광고 크리에이티브
• Instagram 슬라이드 광고