마케팅 API

릴스 광고

사용 가능한 릴스 노출 위치에 초점을 맞춰 Meta 광고를 만들고 광고 운영과 관련된 모범 사례를 알아보세요.

필수 조건

  • Facebook 앱을 만들어 두어야 합니다.
  • 마케팅 API에 익숙하고 Facebook 로그인을 활성화해야 합니다.

이 필수 조건을 충족하지 않는 경우 개발자 문서를 참조하세요.

샌드박스 테스트

Meta는 실제로 광고를 게재하지는 않지만 다음과 같은 작업이 가능한 테스트 환경을 제공합니다.

  • 비용 발생 없이 Meta API를 사용해서 광고를 만들고 편집할 수 있도록 도구 섹션의 Meta 앱 내에 마케팅 API를 제품으로 추가합니다.
  • 마케팅 API를 사용할 광고 계정을 만듭니다.

테스트 모범 사례를 참조하세요.

1단계: 자산 액세스

액세스 토큰은 사용자, 앱 또는 페이지를 식별하는 불명확한 문자열이며, 앱에서 그래프 API를 호출하는 데 사용할 수 있습니다. 회원님은 액세스 토큰의 만료 시점과 액세스 토큰을 생성한 앱을 확인할 수 있습니다. Meta 앱에서 마케팅 API를 호출할 때는 액세스 토큰을 포함해야 합니다.

다음과 같은 필수 권한을 포함한 액세스 토큰을 받으세요.

  • ads_management: 선택한 광고 계정에서 변경 사항을 적용합니다.

  • ads_read: 광고 데이터를 읽습니다.

  • read_insights: 성과 인사이트를 읽습니다.

만료 기간이 더 긴 시스템 액세스 토큰을 사용합니다.

추가적인 권한 부여 계층

마케팅 API 엔드포인트에 액세스하려면 비즈니스 앱을 만들어야 합니다. 여기에는 액세스 레벨이라고 하는 그래프 API 권한 부여 레이어가 추가적으로 적용됩니다. 앱 검수 중에 앱은 특정 권한과 기능도 요청해야 합니다. 앱 자체 또는 앱을 요청한 비즈니스에서 역할을 부여받지 않은 앱 사용자가 앱을 사용할 경우 비즈니스 인증을 완료해야 합니다.

앱이 다른 사람의 광고 계정을 관리하는 경우, 다음이 필요합니다.

  • 고급 액세스 ads_read

및/또는

  • 고급 액세스 ads_management

2단계: 광고 계정 가져오기

광고주의 광고 계정을 가져오고 광고주가 광고를 만들 계정을 선택하도록 허용합니다.

Business Management API를 통해 비즈니스가 액세스할 수 있는 모든 광고 계정을 확인할 수 있습니다. 그러면 비즈니스 소유의 모든 광고 계정이 반환됩니다. 앱과 사용자 수준에서 business_management 권한이 필요합니다. Business Asset Management API를 참조하세요.

호출 샘플

curl -G \
-d "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/v21.0/<BUSINESS_ID>/owned_ad_accounts"

3단계: 캠페인 만들기

캠페인은 광고 계정 내에서 가장 위에 있는 조직 구조이고 광고주의 단일 목표를 나타내야 합니다. 이러한 개체에는 광고 목표와 하나 이상의 광고 세트가 포함됩니다. 이는 각 광고 목표에 맞게 최적화하고 결과를 측정하는 데 도움이 됩니다. 캠페인을 만들고, 읽고, 업데이트하고, 삭제하는 자세한 방법은 여기를 참조하세요.

호출 샘플

curl -X POST \
  -F 'name="My campaign"' \
  -F 'objective="OUTCOME_TRAFFIC"' \
  -F 'status="PAUSED"' \
  -F 'special_ad_categories=[]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/campaigns

4단계: 타겟 정의

광고주가 특정 그룹에 도달할 수 있게 하려면 API 요청에서 다음 매개변수를 지정하세요.

  • 인구 통계학적 특성(연령, 성별, 위치)
  • 관심사
  • 행동

그러면 회원님의 제품이나 서비스에 관심을 보일 가능성이 가장 큰 잠재 고객에게 도달합니다.

호출 샘플

curl -X POST \
  -F 'access_token=YOUR_ACCESS_TOKEN' \
  -F 'name=My Custom Audience' \
  -F 'subtype=CUSTOM' \
  -F 'description=People who live in New York, aged 25-40, interested in technology' \
  -F 'customer_file_source=USER_PROVIDED_ONLY' \
  -F 'targeting_spec={
        "geo_locations": {
          "countries": ["US"],
          "regions": [{"key": "4081"}]  # New York region key
        },
        "age_min": 25,
        "age_max": 40,
        "interests": [{"id": "6003139266461", "name": "Technology"}]
      }' \
  https://graph.facebook.com/v21.0/act_YOUR_AD_ACCOUNT_ID/customaudiences

5단계: 광고 세트 만들기

광고 세트는 하나 이상의 광고를 포함할 수 있습니다. 광고 세트에 포함된 광고는 동일한 타게팅, 예산, 청구, 최적화 목표 및 기간으로 설정해야 합니다.

예산, 일정, 타게팅, 입찰 전략, 노출 위치 옵션을 설정할 수 있습니다. 광고 세트를 사용하면 특정 타겟 세그먼트에 광고를 게재하는 방법과 위치를 세밀하게 조정하고, 성과를 최적화하고, 마케팅 목표를 달성할 수 있습니다.

주요 매개변수:

  • 타겟 타겟팅 기준
  • 일일 또는 총 예산
  • 광고 게재 시점을 관리하는 일정 옵션

자세한 내용은 여기를 참조하세요.

Instagram 및 Facebook 릴스 광고를 포함하는 수동 노출 위치를 선택하거나 자동 노출 위치를 기본값으로 설정할 수 있습니다. 특정 노출 위치 필드에 아무것도 지정하지 않은 경우, Meta는 해당 필드에 모든 사용 가능한 기본 위치를 고려합니다.

호출 샘플

curl -X POST \
  -F 'access_token=YOUR_ACCESS_TOKEN' \
  -F 'name=Reels Ad Set' \
  -F 'campaign_id=YOUR_CAMPAIGN_ID' \
  -F 'daily_budget=5000' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'optimization_goal=REACH' \
  -F 'start_time=2024-07-10T10:00:00-0700' \
  -F 'end_time=2024-07-20T10:00:00-0700' \
  -F 'targeting={"geo_locations":{"countries":["US"]},"age_min":18,"age_max":65}' \
  -F 'promoted_object={"page_id":"YOUR_PAGE_ID"}' \
  -F 'status=PAUSED' \
  -F 'instagram_actor_id=YOUR_INSTAGRAM_ACTOR_ID' \
  -F 'publisher_platforms=["instagram"]' \
  -F 'instagram_positions=["reels"]' \
  https://graph.facebook.com/v21.0/act_YOUR_AD_ACCOUNT_ID/adsets

노출 위치 타게팅: 릴스를 사용 가능한 위치, 사용 가능한 목표, 최적화 목표

publisher_platformsfacebook_position 또는 instagram position사용 가능한 목표optimization_goal
instagram

reels, profile_reels

OUTCOME_APP_PROMOTION

LINK_CLICKS

OFFSITE_CONVERSIONS

APP_INSTALLS

instagram

reels, profile_reels

 OUTCOME_AWARENESS

REACH

IMPRESSIONS

AD_RECALL_LIFT

THRUPLAY

instagram

reels, profile_reels

 OUTCOME_LEADS

OFFSITE_CONVERSIONS

LANDING_PAGE_VIEWS

LINK_CLICKS

REACH

IMPRESSIONS

LEAD_GENERATION

QUALITY_LEAD

instagram

reels, profile_reels

OUTCOME_TRAFFIC

LINK_CLICKS

LANDING_PAGE_VIEWS

REACH

CONVERSATIONS

IMPRESSIONS

VISIT_INSTAGRAM_PROFILE

instagram

reels, profile_reels

OUTCOME_ENGAGEMENT

CONVERSATIONS

LINK_CLICKS

THRUPLAY

POST_ENGAGEMENT

REACH

IMPRESSIONS

REMINDERS_SET

OFFSITE_CONVERSIONS

LANDING_PAGE_VIEWS

instagram

reels, profile_reels

OUTCOME_SALES

OFFSITE_CONVERSIONS

LANDING_PAGE_VIEWS

LINK_CLICKS

REACH

IMPRESSIONS

CONVERSATIONS

facebookfacebook_reels

OUTCOME_APP_PROMOTION

LINK_CLICKS

OFFSITE_CONVERSIONS

APP_INSTALLS

facebookfacebook_reels

OUTCOME_AWARENESS

REACH

IMPRESSIONS

AD_RECALL_LIFT

THRUPLAY

TWO_SECOND_CONTINUOUS_VIDEO_VIEWS

facebookfacebook_reels

OUTCOME_LEADS

OFFSITE_CONVERSIONS

LANDING_PAGE_VIEWS

LINK_CLICKS

REACH

IMPRESSIONS

LEAD_GENERATION

QUALITY_LEAD

facebookfacebook_reels

OUTCOME_TRAFFIC

LINK_CLICKS

LANDING_PAGE_VIEWS

REACH

CONVERSATIONS

IMPRESSIONS

QUALITY_CALL

facebookfacebook_reels

OUTCOME_ENGAGEMENT

CONVERSATIONS

LINK_CLICKS

THRUPLAY

TWO_SECOND_CONTINUOUS_VIDEO_VIEWS

POST_ENGAGEMENT

REACH

IMPRESSIONS

EVENT_RESPONSES

QUALITY_CALL

OFFSITE_CONVERSIONS

LANDING_PAGE_VIEWS

PAGE_LIKES

facebookfacebook_reels

OUTCOME_SALES

OFFSITE_CONVERSIONS

LANDING_PAGE_VIEWS

LINK_CLICKS

REACH

IMPRESSIONS

CONVERSATIONS

QUALITY_CALL

제한 사항

사용 가능한 목표 + optimization_goal 조합 FB 릴스를 사용할 수 있나요? IG 릴스를 사용할 수 있나요?

OUTCOME_AWARENESS + TWO_SECOND_CONTINUOUS_VIDEO_VIEWS

✅

❌

OUTCOME_TRAFFIC + VISIT_INSTAGRAM_PROFILE

❌

✅

OUTCOME_TRAFFIC + QUALITY_CALL

✅

❌

OUTCOME_ENGAGEMENT + TWO_SECOND_CONTINUOUS_VIDEO_VIEWS

✅

❌

OUTCOME_ENGAGEMENT + EVENT_RESPONSES

✅

❌

OUTCOME_ENGAGEMENT + REMINDERS_SET

❌

✅

OUTCOME_ENGAGEMENT + QUALITY_CALL

✅

❌

OUTCOME_ENGAGEMENT + PAGE_LIKES

✅

❌

OUTCOME_SALES + QUALITY_CALL

✅

❌

6단계: 크리에이티브 선택

광고 크리에이티브는 광고의 시각적 및 텍스트적 구성 요소이며, 다음 광고 형식을 지원합니다.

  • 이미지
  • 동영상
  • 슬라이드
  • 맞춤화된 광고 디자인 활성화

Meta의 크리에이티브 프로세스를 사용하여 디자인 요소를 자동화하고 성과를 최적화하세요.

기존 릴스를 광고 크리에이티브로 활용

사용자는 새로운 자산을 제공하거나 Instagram 계정의 기존 릴스를 광고 크리에이티브로 활용할 수 있습니다.

홍보 가능한 대상인 기존의 유기적 Instagram 또는 Facebook 릴스에서 광고를 만들 수 있습니다. 단, 다음과 같은 조건을 충족해야 합니다.

  • 90초 미만
  • 전체 화면(9:16) 세로 화면 비율 사용
  • 타사의 저작권이 있는 음악, GIF, 인터랙티브 스티커, 카메라 필터가 없어야 함
  • Facebook에 공유되지 않았어야 함

유기적 Instagram 릴스를 새로운 광고 캠페인의 광고 크리에이티브로 활용하는 방법은 다음과 같습니다.

  1. Instagram 비즈니스 계정 ID를 얻고 Facebook 페이지에 연결합니다.

    • GET/{ad_account_id}/connected_instagram_accounts또는
    • GET/{business_id}/instagram_business_accounts

  2. 홍보하려는 릴스를 찾습니다.

    • GET/{ig-business-account-user-id}/media

  3. 광고 크리에이티브를 제공합니다.

    • 크리에이티브 사양에서 instagram_actor_id를 지정하는 대신 instagram_user_id를 Instagram 사용자 ID로 설정합니다.
    • source_instagram_media_id를 미디어 ID로 지정합니다.
    • 원하는 경우 홍보를 위해 call_to_action을 업데이트합니다.

미디어를 광고로 홍보할 수 있는지를 편리하게 확인하려면 boost_eligibility_info를 사용하고, 과거의 Instagram 홍보 광고 관련 정보를 추적하려면 boost_ads_list를 사용합니다.

호출 샘플

curl -i -X POST \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT>/adcreatives?object_id=<PAGE_ID>
&instagram_user_id=<IG_USER_ID>
&source_instagram_media_id=<IG_ORGANIC_MEDIA_ID>
&call_to_action="{'type':'LEARN_MORE','value':{'link': '<YOUR_LINK>'}}"
&access_token=<API_ACCESS_TOKEN>

생성형 AI 크리에이티브 도구 상자

다양하고 흥미로운 광고 요소(예: 이미지, 동영상, 텍스트)를 자동으로 생성할 수 있습니다. 이러한 AI 기반 도구는 타겟의 선호도에 따라 콘텐츠를 맞춤화하고 크리에이티브의 다양성을 높여서 광고 성과를 최적화하는 데 도움을 줍니다. 광고를 만들었을 때 참여도가 더 높아지고 캠페인이 개선될 수 있습니다.

7단계: 광고 미리 보기

다음을 사용하여 아래 표에 정리된 Facebook 및 Instagram 릴스 형식으로 광고를 미리 보기하세요.

  • 광고 ID
  • 광고 크리에이티브 ID
  • 광고 크리에이티브 사양
게시 플랫폼 광고 형식

Facebook

DESKTOP_FEED_STANDARD, FACEBOOK_STORY_MOBILE, INSTANT_ARTICLE_STANDARD, INSTREAM_VIDEO_DESKTOP, INSTREAM_VIDEO_MOBILE, MARKETPLACE_DESKTOP, MARKETPLACE_MOBILE, MOBILE_FEED_BASIC, MOBILE_FEED_STANDARD, RIGHT_COLUMN_STANDARD, SUGGESTED_VIDEO_DESKTOP, SUGGESTED_VIDEO_MOBILE, WATCH_FEED_MOBILE, FACEBOOK_REELS_BANNER, FACEBOOK_REELS_BANNER_DESKTOP, FACEBOOK_REELS_MOBILE, FACEBOOK_REELS_POSTLOOP, FACEBOOK_REELS_STICKER, FACEBOOK_STORY_STICKER_MOBILE, WATCH_FEED_HOME

Instagram

INSTAGRAM_STANDARD, INSTAGRAM_STORY, INSTAGRAM_EXPLORE_CONTEXTUAL, INSTAGRAM_EXPLORE_IMMERSIVE, INSTAGRAM_EXPLORE_GRID_HOME, INSTAGRAM_FEED_WEB, INSTAGRAM_FEED_WEB_M_SITE, INSTAGRAM_PROFILE_FEED, INSTAGRAM_REELS, INSTAGRAM_REELS_OVERLAY, INSTAGRAM_SEARCH_CHAIN, INSTAGRAM_SEARCH_GRID, INSTAGRAM_STORY_CAMERA_TRAY, INSTAGRAM_STORY_WEB, INSTAGRAM_STORY_WEB_M_SITE

호출 샘플

curl -X POST \
  'https://graph.facebook.com/v21.0/act_{ad_account_id}/adpreviews' \
  -F 'access_token={your_access_token}' \
  -F 'creative={
        "object_story_spec": {
            "instagram_actor_id": "{instagram_actor_id}",
            "video_data": {
                "video_id": "{video_id}",
                "title": "Check out our new product!",
                "description": "Exciting new features and benefits.",
                "call_to_action": {
                    "type": "LEARN_MORE",
                    "value": {
                        "link": "https://www.example.com/product"
                    }
                }
            }
        }
    }' \
  -F 'ad_format=INSTAGRAM_REELS'

8단계: 광고 게재 예약

마케팅 API를 사용하여 광고를 예약하려면 광고 그룹 개체를 만들고 광고 세트 개체를 광고 크리에이티브에 연결합니다. /act_{ad_account_id}/ads를 사용하여 광고 개체를 제출하고 응답을 통해 예약이 되었는지 확인합니다. 이 단계를 마치면 광고 설정이 끝나고 제공된 구성에 따라 게재가 가능하게 됩니다.

호출 샘플

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

9단계: 성과 검토

인사이트 API를 사용하여 광고 계정에서 광고로 지표를 가져옵니다.

  • act_<AD_ACCOUNT_ID>/insights
  • <CAMPAIGN_ID>/insights
  • <ADSET_ID>/insights
  • <AD_ID>/insights

Instagram과 Facebook에서 캠페인을 실행할 때 breakdowns=publisher_platform을 추가하여 Facebook 및 Instagram 노출 위치의 통계를 따로 확인할 수 있습니다. 아래의 샘플 호출을 참조하세요. 노출 위치 수준으로 인사이트를 분석하면 광고가 Instagram 및 Facebook 릴스 노출 위치를 통해 얼마나 성과를 냈는지 확인할 수 있습니다.

호출 샘플

curl -X GET \
  'https://graph.facebook.com/v21.0/{ad_account_id}/insights' \
  -F 'access_token={your_access_token}' \
  -F 'level=campaign' \
  -F 'fields=campaign_name,impressions,clicks,spend' \
  -F 'breakdowns=publisher_platform,platform_position' \
  -F 'filtering=[{"field":"platform_position","operator":"IN","value":["instagram_reels"]}]' \
  -F 'time_range={"since":"2024-06-01","until":"2024-06-30"}'

중요한 고려 사항

ODAX(결과 기반 광고 경험 목표 검증)에서 지원하는 새로운 목표

  • OUTCOME_APP_PROMOTION
  • OUTCOME_AWARENESS
  • OUTCOME_ENGAGEMENT
  • OUTCOME_LEADS
  • OUTCOME_SALES
  • OUTCOME_TRAFFIC

사용 제한

마케팅 API는 자체사용 제한 로직이 있으며 모든 그래프 API 사용 제한에서 제외됩니다. 마케팅 API 사용 제한 할당량에 영향을 미치는 기능은 광고 관리 표준 액세스입니다. 기본적으로 마케팅 API 제품을 앱 대시보드에 추가하면 기본적으로 표준 액세스 권한을 얻게 되며, 이는 마케팅 API에 대한 개발 접근 권한을 얻게 해 줍니다. 사용 제한 할당량을 높이려면 고급 액세스로 업그레이드하세요.

크리에이티브 기본 사항

릴스 광고는 관심을 행동으로 전환하여 비즈니스 성과를 극대화합니다. 릴스를 적절하게 빌드하면 더욱 효과를 높일 수 있습니다.

1. 9:16 동영상으로 빌드하여 시선을 사로잡는 동영상 만들기: 릴스는 몰입감이 있는 전체 화면 동영상 형식입니다. 크리에이티브가 이 형식에 잘 맞도록 동영상으로 시작하고 이를 9:16 크기로 조정해 보세요.

2. 안전 공간에서 빌드하여 명확한 메시지 전달: 안전 공간 내에서 작업하여 텍스트 스티커 오버레이, 행동 유도나 주요 메시지가 릴스 사용자 인터페이스에 가려지지 않도록 하세요. 9:16 비율이 적용된 크리에이티브의 하단 35%에는 텍스트, 로고 및 기타 주요 요소를 배치하지 마세요.

3. 오디오를 포함하여 귀가 즐거운 동영상 만들기: 오디오(음악, 보이스 오버, 사운드 효과)는 릴스에서 참여를 유도하고 엔터테인먼트를 제공하는 핵심 요소입니다.