Introducing Graph API v20.0 and Marketing API v20.0

2024년 5월 21일제작:Ayyad Farah

오늘 Facebook 그래프 API v20.0 및 마케팅 API v20.0을 릴리스합니다. 이번 릴리스에서는 개발자 커뮤니티에서 주목할 만한 변경 사항을 아래와 같이 소개합니다. 이러한 변경 사항에는 Meta 플랫폼과 앱의 통합에 영향을 미칠 수 있는 공지 사항, 제품 업데이트 및 사용 중단에 대한 알림 등이 포함됩니다.

모든 변경 사항의 전체 리스트와 자세한 내용은 변경 사항을 참조하세요.

일반 업데이트

마케팅 API 버전 자동 업그레이드

전반적인 API 경험을 더 원활하고 효율적인 방향으로 개선하고자 MAPI 버전 자동 업그레이드 기능이 출시될 예정임을 알려드립니다. 오늘부터 버전 간에 영향을 받지 않는 마케팅 API 엔드포인트에 대한 자동 버전 업그레이드 기능이 활성화됩니다. 즉, 사용 중단될 버전과 다음으로 사용 가능한 버전 간에 엔드포인트가 영향을 받지 않는 경우, Meta 플랫폼은 요청 처리를 바로 거부하기보다 다음으로 사용 가능한 버전으로 호출을 자동으로 업그레이드합니다.

이 동작에 대한 자세한 내용은 마케팅 API 버전 관리와 출시 블로그를 참조하세요.

각 버전에서 영향을 받는 엔드포인트를 확인하려면 변경 사항을 참조하세요.

보다 구체적인 v20.0 업데이트 정보는 아래를 참조하세요.

마케팅 API용 알림 광고

2024년 5월 13일 이전에는 개발자들이 Instagram 마케팅 API를 통한 Instagram 알림 광고 제작을 지원할 수 없었고, 그래서 이들의 고객은 Meta 광고 관리자에서만 알림 광고를 만들 수 있었습니다. 호환성 부족으로 인해 알림 광고를 실행하려는 파트너와 그 고객은 원치 않는 마찰을 빚기도 했습니다.

지속적으로 들려온 비호환성 관련 피드백에 대처하고자 2024년 5월 13일 기준으로 Instagram 마케팅 API를 통해 알림 광고 제작을 지원하고 있습니다.

개발자 커뮤니티와 고객이 보내주신 피드백에 감사드리며, 마케팅 API를 통해 제공되는 알림 광고 경험을 계속 개선할 수 있기를 바랍니다.

Instagram 알림 광고 정보

Instagram 알림 광고는 관심을 보이는 이들이 알림을 설정하도록 권하여 광고주가 프로모션과 출시 시점 사이의 격차를 해소하는 데 도움이 됩니다. 옵트 인하면 이벤트 전에 가장 중요한 사건이 있을 때 알림을 받습니다.

이벤트 제작 및 수정 정보

Instagram 알림 광고는 이벤트 시작 시간과 날짜를 바탕으로 알림이 전송되는 시기를 결정합니다. 이 변경 사항을 통해 개발자는 Instagram 그래프 API에서 이벤트를 만들고 수정할 수 있습니다. 광고 크리에이티브에 이벤트를 연결한 후 Instagram 마케팅 API를 통해 알림 광고를 만들 수 있습니다.

광고 계정 노드의 새로운 API

새 광고 계정 노드 업데이트는 핵심 변경 사항이 아닌 API 추가입니다. 이를 호출하면 해당 광고 계정의 지침 권장 사항이 있는 모든 캠페인과 지침은 물론 예상되는 행동당 비용(CPA) 개선 사항이 나열됩니다.

새로운 API를 통해 광고주는 캠페인에 대한 Meta의 지침을 볼 수 있습니다. 이 데이터는 모든 파트너의 파트너 센터에 이미 존재합니다. 단, 지침을 보려면 UI에서 단일 광고 계정을 수동으로 선택해야 합니다.

CPA_GUIDANCE API를 통해 이 데이터의 액세스를 자동화하여 광고 계정마다 수동으로 지침을 확인하는 수고를 덜어낼 수 있기를 바랍니다. 파트너의 경우 이 API에 액세스하면 내부적으로 맞춤형 보기를 구축하고 시간 경과에 따른 추세를 볼 수 있습니다.

수백 개 또는 수천 개의 계정을 관리하는 비즈니스의 경우, 특히 시급한 상황에서는 계정의 지표를 일일이 확인하기가 어렵습니다. RSS 권장 사항은 매일 업데이트되며, 지난 28일 동안의 활성 캠페인을 고려합니다. 이 API를 통해 대행사는 제공받은 권장 사항을 활용하여 최적화할 수 있는 가장 유망한 캠페인을 식별할 수 있으며, 이는 이후 시스템에 통합됩니다.

CPA_GUIDANCE API를 사용하면 대행사가 브랜드 파트너에 어떤 제품 또는 카테고리의 신규 고객 확보당 비용(CPA)이 가장 높은지를 알려줄 수 있습니다. 대행사는 이러한 정보를 공유하여 브랜드 파트너가 광고 지출을 최적화하고 협업 캠페인의 전반적인 성과를 개선하도록 도울 수 있습니다.

나아가 CPA의 개선 추세를 관찰하여 지침 권장 사항을 바탕으로 조치가 이루어졌는지를 추적할 수 있습니다.

여러 광고주의 광고

오늘은 마케팅 API를 통해 광고주가 여러 광고주의 광고를 옵트 인할 수 있는 기능을 소개합니다. 이 업데이트 이전에는 개발자들이 API를 통한 여러 광고주의 광고 제작을 지원할 수 없었고, 그래서 이들의 고객은 Meta 광고 관리자에서만 여러 광고주의 광고를 옵트 인할 수 있었습니다.

여러 광고주의 광고 정보

여러 광고주의 광고는 사람들이 여러 비즈니스의 제품과 서비스를 발견하는 데 도움이 될 수 있습니다. 광고가 동일한 광고 유닛에서 다른 광고와 함께 Facebook과 Instagram의 일부 노출 위치에 표시되어 사람들이 맞춤화된 비즈니스의 제품과 서비스를 발견할 수 있습니다. 광고 유닛은 주로 동일한 페이지에 여러 광고를 표시하는 컨테이너입니다. 비즈니스 지원 센터에서 자세히 알아보세요.

개발자에게 미치는 영향

출시 시점에는 마케팅 API를 통해 생성된 여러 광고주의 광고 게재가 기본적으로 비활성화됩니다. 즉, 개발자는 고객이 해당 경험으로 광고를 게재할 수 있도록 광고에 대해 코드 변경을 구현해야 합니다. 여러 광고주의 광고 제작은 마케팅 API의 모든 버전에서 지원되지만, 광고 제작을 요청하려면 광고에서 여러 광고주의 광고를 사용하도록 옵트 인할지를 지정해야 합니다. 2024년 8월 19일에 여러 광고주의 광고가 기본적으로 활성화되도록 변경되며, 아직 코드 변경을 시행하지 않은 개발자는 코드 변경을 구현하여 고객에게 경험을 옵트 아웃할 수 있는 기능을 제공해야 합니다.

마케팅 API에 도입되는 생성형 AI 크리에이티브 기능: 텍스트 생성, 이미지 확장 및 배경 생성

2023년 10월, 광고 관리자의 비즈니스를 대상으로 첫 번째 생성형 AI 기반 크리에이티브 광고 기능인 텍스트 생성, 이미지 확장 및 배경 생성 출시를 발표했습니다. 오늘은 마케팅 API(MAPI)를 통해 생성형 AI 크리에이티브 기능을 광고주에게 제공하고 있음을 알려드리고자 합니다. 이에 따라 파트너, 대행사 및 광고주 역시 MAPI를 통해 Meta의 GenAI 제품을 활용할 수 있습니다.

이러한 기능으로 여러 크리에이티브 버전을 빠르게 자동 생성하여 모든 광고주의 생산성, 맞춤화 및 성과를 극대화하는 새로운 크리에이티브 시대를 열 수 있습니다.

배경 생성: 제품 이미지를 보완하는 배경을 최대 4개 생성하여 타겟을 위한 크리에이티브 다양화를 가능하게 합니다. 생성된 배경은 원래 제품 이미지를 기반으로 하며, 색상과 패턴이 있는 단순한 배경인 경우가 많습니다.
이미지 확장: 이미지 크리에이티브 자산을 피드부터 릴스에 이르는 여러 노출 위치의 다양한 화면 비율에 맞춰 매끄럽게 조정하여 크리에이티브 자산을 재사용하는 데 필요한 시간과 리소스를 줄일 수 있습니다.
텍스트 생성: 원본을 기반으로 여러 버전의 광고 텍스트를 생성하여 제품/서비스의 셀링 포인트를 강조하고 여러 텍스트 옵션을 만들어 다양한 광고를 타겟에 선보입니다.

현재 관련 기능을 더 많은 광고주를 대상으로 제공하고 있으며, 더 많은 타겟에 생성형 AI의 힘을 선보일 수 있어 무척 기쁩니다.

추가적인 규제가 적용될 수 있는 신제품 테스트에 대한 저희의 접근 방식에 따라 금융 서비스, 제약/건강과 같은 특정 업종과 주택, 고용, 금융 서비스/신용(HEC), 사회 문제, 선거 또는 정치(SIEP) 관련 광고에서는 일부 생성형 AI 기능을 바로 이용하지 못할 수 있습니다.

작동 방식

현재 이러한 기능에 대한 지원을 마케팅 API, 특히 광고 크리에이티브 API의 일부로 배포하고 있습니다. 광고주는 API에서 이러한 기능을 사용하도록 옵트 인할 수 있으며, API에서 생성형 AI 크리에이티브를 미리 볼 수 있는 옵션이 제공됩니다.

마케팅 API에서 생성형 AI 기능에 광고 크리에이티브를 옵트 인하는 방법은 다음 예제를 참고하세요.

          curl -X POST \
          -F 'name=Generative AI Creative' \
          -F 'object_story_spec={
          ...
          }' \
          -F 'degrees_of_freedom_spec={
          "creative_features_spec": {
          "image_background_gen": {
          "enroll_status": "OPT_IN"
          }
          }
          }' \
          -F 'access_token=<ACCESS_TOKEN>'\
          https://graph.facebook.com/<GRAPH_API_VERSION>/act_<AD_ACCOUNT_ID>/adcreatives

참고: 위의 예제는 배경 생성 기능의 옵트 인을 보여줍니다. 마찬가지로 이미지 확장의 경우 image_uncrop 키를 사용하고, 택스트 생성의 경우 creative_features_spec에서 text_generation 키를 사용하면 됩니다.

광고주는 또한 API를 통해 생성형 AI 변환 크리에이티브를 미리 볼 수 있습니다. GenAI 기능별로 콘텐츠를 만들고, 광고 크리에이티브를 제공하고, 생성된 콘텐츠를 미리 보는 방법을 자세히 알아보려면 개발자 설명서 링크를 참조하세요.

Instagram 동영상 API: Instagram 동영상 API의 재개 가능 업로드

2024년 5월 15일에 시작된 새로운 '재개 가능 업로드 프로토콜'은 로컬 동영상과 퍼블릭 호스팅 URL 동영상 모두에서 Instagram 동영상(릴스, 동영상 스토리, 동영상 슬라이드)을 게시할 수 있도록 지원합니다. 이 새 프로토콜을 사용하면 로컬 파일 업로드와 릴스에 한해 더 긴 길이의 동영상 업로드(최대 15분)가 가능해지며, 네트워크 중단 또는 기타 사유로 인한 전송 실패 후에도 업로드 작업을 재개할 수 있습니다.

이전에 Instagram 동영상을 만들려면 동영상 파일을 공개적으로 액세스할 수 있는 호스팅 서비스에 업로드해야 했으며, 여기에서 공유 가능한 URL을 얻어 Meta에 제공해야 동영상을 게시할 수 있었습니다.

개선된 콘텐츠 게시 흐름 세부 정보는 콘텐츠 게시 개발자 설명서에서 확인할 수 있으며, 여기에서 Instagram 미디어 관련 추가 세부 정보도 찾아볼 수 있습니다.

Instagram 그래프 API: 신규 지표 온보딩

이제 슬라이드 컨테이너 미디어에 대한 추가 지표 6개를 그래프 API에 사용할 수 있습니다. 이러한 지표로는 좋아요, 댓글, 공유, 팔로우, 프로필 활동(사용자가 프로필을 방문할 때 수행한 작업 수), 프로필 방문수(사용자가 프로필에 방문한 횟수)가 있습니다. 해당 지표는 이미 Instagram의 인사이트 페이지에서 지원되지만, 그래프 API를 통해서도 확인할 수 있게 됩니다.

슬라이드 게시물의 그래프 API 엔드포인트에 좋아요, 댓글, 공유, 팔로우, 프로필 활동, 프로필 방문수를 추가하면 API 호출에서 바로 지표를 읽을 수 있습니다.

지금 바로 슬라이드 컨테이너 게시물의 GET API 호출에 관련 지표를 추가하려면 여기에서 지표의 전체 목록을 참조하세요.

사용 중단 일정 업데이트: Meta의 오프라인 전환 API(OCAPI)

작년에 오프라인 전환 API 버전 17이 더 이상 오프라인 이벤트를 지원하지 않을 것이며, 2024년 3분기에 오프라인 전환 API가 사용 중단될 예정이라고 발표했습니다. 이 예상 사용 중단 일정이 이후 변경되어, 2025년 5월에 오프라인 전환 API(OCAPI)가 사용 중단될 계획입니다. 2024년 3분기부터 2025년 5월까지 오프라인 변환 API(OCAPI) 사용 중단 일정이 연장되었지만, 현재 오프라인 이벤트를 OCAPI를 통해 전송 중인 광고주는 계속해서 기존 설정을 마이그레이션하여 변환 API(오프라인용 CAPI)를 통해 오프라인 이벤트를 보내기 시작할 계획을 세우기를 권장합니다.

사용 중단 및 핵심 변경 사항

Messenger API의 예약 버튼 사용 중단

즉시 적용되며, 예약 버튼은 Messenger API 호출에서 더 이상 지원되지 않습니다. 이 변경 사항은 다른 템플릿과 버튼에 영향을 미치지 않으며, 비즈니스는 계속해서 Meta Business Suite로 예약을 관리할 수 있습니다.

마케팅 API에서 홍보 메시지 광고 유형 제작 지원 중단

오늘부로 홍보 메시지 광고 유형은 마케팅 API v20.0으로 더 이상 제작할 수 없으며, 이전 버전의 API에서 해당 광고 유형에 대한 광고 제작 지원은 90일 후에 종료됩니다. 이 변경 사항은 다른 메시지 광고 유형에 영향을 미치지 않습니다.

사용자의 매끄러운 전환을 보장하려면 지금 통합을 검토하고 필요에 따라 애플리케이션을 조정하기를 권장합니다.

인사이트 인구 통계학적 특성 지표에 중요하지 않은 기간 제거(외부 Instagram 그래프 API를 통해)

2024년 5월 21일, Instagram 그래프 API 버전 20이 출시되었습니다.

출시 후 90일이 지난 2024년 8월 19일부터, 그래프 API는 Instagram 그래프 API에 대한 중요하지 않은 기간에 참여하고 도달한 타켓의 인구 통계학적 특성 지표를 더 이상 공유하지 않습니다(예: 지난 14일 및 90일 동안의 국가, 도시, 연령, 성별 분포 정보).

Instagram 그래프 API는 플랫폼 간 일관성을 보장하기 위해 Instagram 앱과 유사한 지난 한 달('this_month') 및 지난 한 주('this_week')의 인구 통계학적 특성 정보를 여전히 반환합니다.

새로운 이번 업그레이드로 인해 혼란이 줄어들고 보고 안정성 및 품질이 증가합니다.

자세한 내용은 개발자 설명서를 확인하세요.

API 버전 사용 중단:

그래프 API 및 마케팅 API에 대한 Facebook 버전 관리 일정에 따라 예정된 사용 중단은 다음과 같습니다.

그래프 API

2024년 5월 28일: 그래프 API v13.0이 사용 중단되고 플랫폼에서 삭제됩니다.
2024년 9월 17일: 그래프 API v14.0이 사용 중단되고 플랫폼에서 삭제됩니다.
2024년 11월 20일: 그래프 API v15.0이 사용 중단되고 플랫폼에서 삭제됩니다.

마케팅 API

2024년 8월 13일: 마케팅 API v18.0이 사용 중단되고 플랫폼에서 삭제됩니다.
2025년 2월 4일: 마케팅 API v19.0이 사용 중단되고 플랫폼에서 삭제됩니다.

비즈니스 운영에 지장이 없도록 오늘 출시된 최신 API 버전으로 모든 호출을 마이그레이션하시기 바랍니다.

Meta 비즈니스 SDK

Meta 비즈니스 SDK v20 릴리스

그래프 API v20 출시 직후 Meta 비즈니스 SDK v20이 출시될 예정입니다. 이번 릴리스는 버그 수정 사항, 종속성 업그레이드, 새로운 기능을 비롯하여 그래프 API v20에 맞춰 업데이트된 API 인터페이스를 포함합니다.

이번 릴리스에서는 Instagram API에 대한 추가 지원도 소개합니다. IGMediaForIGOnlyAPI, IGUserForIGOnlyAPI, IGRefreshAccessTokenForIGOnlyAPI, IGAccessTokenForIGOnlyAPI가 있으며, 기존 Instagram API에 더해 미디어를 직접 가져올 수 있는 더 많은 방법을 지원합니다. 비즈니스 SDK의 에코시스템을 풍성하게 하고자 다른 Meta 제품을 아우르는 더 많은 API를 온보딩하는 것을 목표로 삼고 있습니다.

플랫폼 SDK의 2년 사용 중단 일정에 따른 향후 사용 중단 및 버전 중단 소식을 참조하세요.

2024년 5월: Facebook 플랫폼 SDK v13.0 이하 버전이 중단될 예정입니다.

태그:

비즈니스 도구 개발자 도구 그래프 API 마케팅 API

소식 더 보기