개발자 소식으로 돌아가기

Facebook 그래프 API v15.0 및 마케팅 API v15.0 소개

2022년 9월 15일제작:Achyuth Venkatesh

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

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

일반 공지사항 및 업데이트

맞춤 전환 생성 기준 단순화

광고주의 캠페인 생성 절차를 단순화하기 위해 그래프 API v15.0 릴리스부터는 새로 생성된 맞춤 전환에 하나 이상의 연결된 규칙이 필요합니다. 규칙이 필요하지 않은 맞춤 전환은 광고 캠페인을 맞춤 이벤트에서 직접 최적화할 수 있는 맞춤 이벤트 최적화를 사용해야 합니다. Facebook에서는 광고주의 요구 사항과 사용 사례에 더욱 잘 맞출 수 있도록 기존 맞춤 전환을 하나의 올인원 제품에서 여러 개의 금액별 제품으로 전환하기 위해 적극적인 노력을 기울이고 있습니다. 이 변경 사항 이후로 광고주는 맞춤 이벤트 기반 맞춤 전환에서 맞춤 이벤트 최적화로 이동하게 됩니다.

플랫폼 약관 업데이트

Facebook에서는 앱이 특정 기간 이내에 사용하거나 액세스하지 않은 모든 플랫폼 API, 권한 또는 기능에 대해 앱의 액세스 권한을 삭제하는 것과 관련하여 플랫폼 약관을 업데이트하고 있습니다. 2022년 12월 15일부터 플랫폼 약관에서는 28일 이내에 활동한 적이 있어야 활성 상태로 간주합니다.

앱이 비활성 상태가 되었다는 알림을 받은 후 앱 복구를 원할 경우 앱 관리자 역할로 가서 복구할 수 있습니다.

이 변경 사항에 대한 전체적인 미리 보기는 여기에서 플랫폼 약관을 확인하세요.

사용 중단 및 핵심 변경 사항

어드밴티지 맞춤 타겟 소개

2022년 9월 19일부터 어드밴티지 맞춤 타겟을 단계별로 적용합니다. 어드밴티지 맞춤 타겟은 광고주의 맞춤 타겟을 사용하여 게재를 안내하며, 명시된 최적화 목표를 달성할 가능성이 높은 사람들을 더 많이 찾는 데 도움을 줍니다. 즉, 성과가 개선될 가능성이 크다면 맞춤 타겟의 범주를 넘어서 광고가 게재됩니다. 어드밴티지 맞춤 타겟은 어드밴티지 상세 타게팅, 어드밴티지 유사 타겟을 포함한 어드밴티지 타게팅 제품군에 속합니다. 어드밴티지 타게팅 제품은 수작업을 줄이면서도 광고주 캠페인 성과를 개선하는 데 도움을 주는 고급 자동화와 머신 러닝 기술을 활용합니다.

맞춤 타겟을 활용하는 광고주의 경우 어드밴티지 맞춤 타겟을 선택할 수 있습니다. 어드밴티지 맞춤 타겟을 사용하는 광고주는 계속 맞춤 타겟(웹사이트, 앱 활동, 고객 리스트 또는 참여)을 만들고 관련이 있는 포함/제외를 적용하면서 고급 자동화 및 머신 러닝 기술을 활용할 수 있습니다. 이들 기술은 맞춤 타겟을 소스로 활용하여 게재를 안내하고 명시된 최적화 목표를 달성할 가능성이 높은 사용자에게 더 많이 도달하도록 합니다.

웹사이트, 모바일 또는 참여 맞춤 타겟을 포함하는 새 캠페인을 만들면 어드밴티지 맞춤 타겟이 자동으로 활성화됩니다. 광고 생성 도구의 맞춤 타겟 섹션 내에서 '어드밴티지 맞춤 타겟' 확인란을 선택 해제하여 이 제품을 옵트아웃할 수 있습니다.

특별 광고 타겟 사용 중단

미국 주택도시개발부(HUD)와 맺은 협약의 일환으로 광고주가 주택, 고용 및 신용과 관련된 광고 세트에 대해 타겟을 확장할 수 있는 도구인 특별 광고 타겟의 사용을 중단합니다. 2022년 9월 15일부터 마케팅 API를 통해 특별 광고 타겟을 만드는 기능이 삭제됩니다.

이번 버전이 지정되지 않은 변경 사항 이후로 이전의 값은 사용 중단되므로 2022년 9월 15일부터 새로운 특별 광고 타겟 생성이 차단되는 변경 사항은 광고주와 파트너에게 핵심 변경 사항으로 적용됩니다. 2019년에 Facebook에서는 주택, 고용 및 신용 광고에 대한 특정 타게팅 옵션을 삭제했을 뿐만 아니라 유사 타겟의 대안으로 특별 광고 타겟을 도입했습니다. 하지만 머신 러닝에서 공정성 분야는 동적이고 시간이 지남에 따라 발전하고 있으며 특별 광고 타겟은 이런 우려 사항을 해결하기 위해 초기에 도입된 수단이었습니다. 이제 Facebook에서는 앞서 공지한 방법을 포함하여 공정성을 개선하는 새로운 방법들로 옮겨가고자 합니다.

이번 사용 중단과 관련하여 영향을 받는 엔드포인트의 리스트는 아래를 참조하세요.

타겟 읽기의 경우:

  • endpoint gr:get:AdAccount/customaudiences
  • field operation_status

광고 세트 생성의 경우:

  • endpoint gr:post:AdAccount/adsets
  • field subtype

광고 세트 수정의 경우:

  • endpoint gr:post:AdCampaign
  • field subtype

맞춤 타겟 생성의 경우:

  • endpoint gr:post:AdAccount/customaudiences
  • field subtype

맞춤 타겟 수정의 경우:

  • endpoint gr:post:CustomAudience

코드 구현 지원에 대한 자세한 내용은 초기 블로그 게시물개발자 문서를 참조하세요.

어드밴티지 상세 타게팅/어드밴티지 유사 타겟 패리티

이 프로젝트는 메시지/앱 설치를 목표로 설정한 광고 세트를 사용하는 API 사용자를 위한 시그널(어드밴티지 상세 타게팅)로서의 상세 타게팅에 패리티를 제공합니다(광고 관리자 릴리스 이후). 앞서 Facebook에서는 전환을 목표로 설정하고 전환/가치를 최적화 목표(VO/OC 광고 세트)로 설정한 광고 세트에 대해 API용 어드밴티지 상세 타게팅을 출시했습니다.

현재는 광고주가 메시지 또는 앱 설치를 목표로 설정하고 API를 통해 광고 세트를 생성할 경우 타게팅 기준(L2)으로 두 가지를 전달합니다. 상세 타게팅 입력값(예: 크리켓, 축구, 개)의 리스트와 이러한 입력값 이상으로 확장을 원하는지 여부(어드밴티지 상세 타게팅으로 지칭)를 나타내는 플래그를 전달합니다. 이 플래그가 활성화되면 성과가 개선될 가능성이 큰 경우에 Facebook 시스템에서 상세 타게팅 선택 항목 외부로까지 게재를 확장합니다. 이 플래그가 비활성화되면 Facebook 시스템에서 광고주가 제공한 선택 항목 리스트로만 게재를 제한합니다.

향후 (광고 관리자 릴리스 이후) 광고주가 메시지 또는 모바일 앱 설치를 목표로 설정하여 새 캠페인을 생성할 경우, 상세 타게팅 포함 항목이 광고 게재를 안내하는 입력값(상수 아님)으로 사용됩니다. 따라서 Facebook은 이러한 목표에 대한 DTE 플래그를 사용 중단하고 타게팅 확장을 상세 타게팅 선택 항목의 기본 동작으로 설정합니다. 그 과정에서 성과를 개선할 가능성이 큰 경우 상세 타게팅 포함 항목 범주를 넘어 타게팅이 확장될 수 있습니다. 그 외의 다른 타게팅 선택 항목과 제외 항목은 영향을 받지 않습니다. 이 변경 사항은 특별 카테고리에는 적용되지 않습니다.

작동 원리:

예전에는 광고주가 expansion_all 또는 none 값으로 설정한 targeting_optimization 플래그를 전달하여 상세 타게팅 확장을 활성화하거나 비활성화했습니다. 이러한 광고 세트에 대해 상세 타게팅이 작동하는 방식의 시맨틱이 변경된 것을 고려하면, 메시지 또는 앱 설치를 목표로 설정한 광고 세트를 생성할 때 새로 생성된 광고 세트는 영향을 받지 않으므로 광고주가 이 플래그를 전달할 필요가 없습니다. 이렇게 새로 생성된 모든 광고 세트는 항상 상세 타게팅 포함 항목을 Facebook 백엔드 시스템에 대한 시그널로 사용하며, 해당 시스템은 광고주의 성과가 개선된다면 이들 선택 항목 범주 외부로 광고 게재를 확장하기로 결정할 수 있습니다.

targeting_optimization 플래그가 새로 생성된 광고 세트에 영향을 미치지 않는다는 점을 고려하여, Facebook은 향후 메시지 및/또는 앱 설치를 목표로 설정하는 새로운 캠페인에는 이 필드를 사용 중단할 계획입니다.

  • 이와 같은 이유에서 광고주가 새로운 MAI/메시지 광고 세트를 만들거나 이러한 새로 생성된 광고 세트의 게재 추산치를 조사할 때 targeting_optimization 플래그를 전달할 경우 Facebook에서는 이 매개변수를 더 이상 전송하지 말 것을 요청하는 오류 메시지를 보냅니다.
  • targeting_as_signal이라는 새로운 필드는 새로운 앱 설치/메시지 광고 세트를 만드는 동안 백엔드에서 설정됩니다. 이 필드는 광고주가 상세 타게팅 포함 항목 외부로 광고 세트가 확장되는지 확인하는 경우에만 GET 명령에서 사용할 수 있습니다.

참고: 시그널로서의 상세 타게팅 변경 사항은 메시지 및/또는 앱 설치를 목표로 설정하여 새로 생성한 광고 세트에만 적용됩니다.

해당 API 엔드포인트:

  • gr:post:/act_XXXX/ adsets
  • gr:get:/<adset_id>/delivery_estimate

페이지 탭 사용 중단

페이지 맞춤 설정 탭 API 기능이 더 이상 그래프 API를 통해 제공되지 않음을 알려드립니다. 새로운 페이지 경험을 출시하는 과정에서 향후 일부 페이지 API 기능이 사용 중단됩니다. 페이지 맞춤 설정 탭 기능은 새로운 페이지 경험에서 제공되지 않으므로 해당 기능에 대한 API 지원을 사용 중단합니다. 지금 이러한 소식을 공유하는 이유는 개발자와 고객이 자신의 페이지에서 이러한 기능의 사용 중단 소식을 전달하고 페이지에 필요한 변경 사항을 적용하기에 충분한 시간을 드리기 위해서입니다. 이 기능은 2022년 12월 14일에 완전히 사용 중단됩니다.

API 버전 사용 중단:

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

그래프 API

  • 2022년 11월 1일: 그래프 API v8.0이 사용 중단되고 플랫폼에서 삭제될 예정
  • 2023년 2월 23일: 그래프 API v9.0이 사용 중단되고 플랫폼에서 삭제될 예정
  • 2023년 6월 8일: 그래프 API v10.0이 사용 중단되고 플랫폼에서 삭제될 예정

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

Facebook 플랫폼 SDK

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

  • 2023년 1월: Facebook 플랫폼 SDK v8.0 이하 사용 중단 예정
  • 2023년 6월: Facebook 플랫폼 SDK v9.0 이하 사용 중단 예정
  • 2023년 10월: Facebook 플랫폼 SDK v11.0 이하 사용 중단 예정