개발자 소식으로 돌아가기

Introducing Facebook Graph API v10.0 and Marketing API v10.0

2021년 2월 23일제작:Kirk Thaker

오늘 Facebook 그래프 API v10.0과 마케팅 API v10.0이이 릴리스됩니다.

이 릴리스에는 앱과 플랫폼의 통합에 영향을 미칠 수 있는 알림, 업데이트, 사용 중단 안내 및 '사용 재개'가 다수 포함되어 있습니다. 이 게시물에서는 이러한 업데이트와 운영 중단(해당할 경우)을 피하기 위해 개발자가 취해야 하는 필수 조치를 간략히 설명합니다.

모든 변경 사항에 대한 자세한 정보는 아래에 제공됩니다. 기술 사양은 v10.0 변경 사항을 참조하세요.

개발자 플랫폼에 대한 자세한 내용은 플랫폼 이니셔티브 허브를 참조하세요.

알림 및 업데이트

데이터 사용 확인 인증

Facebook 플랫폼 API 액세스 권한이 취소되지 않도록 등록 후 60일 이내에 데이터 사용 확인(DUC)을 완료하세요. 앱 대시보드의 '내 앱' 페이지에서 DUC를 완료할 수 있습니다.

지난 가을에 Facebook은 데이터 사용 확인(DUC)을 시작했습니다. 이 새로운 연례 요구 사항은 개발자에게 API 액세스 및 데이터 사용이 Facebook 플랫폼 약관개발자 정책을 준수하는지 인증하도록 요구합니다.

이 요구 사항은 모든 앱에 점진적으로 적용되므로 개발자 알림을 통해 기한과 자세한 지침을 받게 되고, 더불어 등록된 연락처로 전송되는 이메일과 앱 대시보드의 필요한 조치 리스트에 있는 알림을 받게 됩니다.

DUC를 완료하기 위한 자세한 지침은 개발자 문서를 참조하세요. 또한 DUC 전용 FAQ 섹션에서 자세한 내용을 확인하실 수 있습니다.

그룹 API 90일 데이터 액세스 레벨과 데이터 제한:

2021년 5월 24일부터 그룹 API를 사용할 때 앱의 사용 가능한 데이터 액세스 기간이 90일로 제한됩니다.

또한 앱이 개발 모드이거나 라이브 모드인지에 따른 차등화된 그룹 API 액세스 권한을 소비자 앱에 도입하고 있습니다. 그룹 API 권한은 비즈니스 앱의 표준 및 고급 액세스 권한과 유사하게 작용합니다.

현재 개발 모드인 앱은 개발자가 관리자인 공개 그룹과 비공개 그룹의 모든 콘텐츠에 액세스할 수 있습니다. 앱 검수를 완료한 앱은 해당 앱을 설치한 그룹의 모든 콘텐츠에 액세스할 수 있습니다.

2021년 5월 24일부터 개발 모드인 앱은 개발자가 관리자인 공개 그룹과 비공개 그룹 자체의 콘텐츠에만 액세스할 수 있습니다. 즉 (앱에서 역할을 부여받지 않은) 다른 그룹 사용자가 게시한 콘텐츠(예: 게시물, 댓글)에 액세스할 수 없습니다.

자세한 내용은 v10.0 변경 사항을 참조하세요.

비즈니스 앱의 public_profile과 email 권한에 대한 액세스 레벨

사용자 데이터를 안전하게 보호하기 위한 지속적인 이니셔티브의 일환으로 신규 및 기존 비즈니스 유형 앱의 public_profile(기본 공개 프로필 필드)과 email 권한을 그래프 v8.0과 함께 발표한 액세스 레벨 모델에 추가했습니다.

새로 생성된 비즈니스 유형 앱은 public_profile과 email 권한이 표준 액세스로 시작합니다. 앱의 public_profile 권한이 표준 액세스일 경우 앱이나 앱을 요청한 비즈니스에서 역할을 부여받은 사용자만 앱을 검색하거나 앱에 로그인할 수 있습니다. 외부 사용자가 앱에 로그인해야 할 경우 앱 관리자가 앱 대시보드에서 고급 액세스 권한을 요청할 수 있습니다. 이 액세스 권한은 자동 부여됩니다.

자세한 내용은 v10.0 변경 사항을 참조하세요.

데이터 삭제 요청 알림

2020년 11월 10일의 발표 내용에 따라 앱 검수를 위해 제출되거나 개발 모드에서 라이브 모드로 전환하는 소비자 및 게임 앱 유형은 사용자에게 데이터 삭제를 요청하는 방법을 명시적으로 안내하는 내용이 포함된 URL 또는 데이터 삭제 요청 콜백을 제공해야 합니다. 이 요구 사항은 2022년 11월 10일부터 적용될 예정이며 적용하기 60일 전에 앱 개발자에게 안내할 것입니다.

잔류 기간 감소 프로젝트에 대한 그래프 AdsInsight API 변경 옵션

광고 관리자 UI는 37개월이 넘은 광고 인사이트 지표 데이터의 보고를 더 이상 지원하지 않습니다. 요청에 잔류 기간이 37개월 넘는 날짜 범위가 포함되면 API에서 오류를 반환합니다. 'date_preset = lifetime'을 비활성화하고 이를 'date_preset = maximum'으로 교체합니다.

그래프 API v10.0의 AdsInsight 변경 사항은 90일 후에 'date_preset = lifetime'을 제외한 다른 모든 그래프 API 버전에 적용됩니다. 호출된 각 필드는 변경할 필요가 없습니다. 기본 설정 기능이 제공되며 모든 'Lifetime' 호출은 잔류 기간 최댓값을 37개월로 기본 설정합니다.

이 변경 사항은 광고 크리에이티브, 타겟, 게재 설정 또는 광고 개체 이름과 관련된 데이터에 영향을 미치지 않고 기존 지표의 계산도 변경되지 않습니다. 이 변경 사항은 광고 관리자, 광고 보고, 가벼운 광고 경험을 포함한 모든 광고 보고 화면에 적용됩니다.

  • 릴리스 날짜 2021/2/23:
    • 버전 10.0
      • 'date_preset = maximum' 활성화
      • 'date_preset = lifetime' 비활성화
      • 요청에 잔류 기간이 37개월 넘는 명시적 날짜 범위가 포함될 경우 오류 반환
    • 버전 9.0 이하
      • 기존 기능 변경 없음
  • 90일 후 릴리스 - 2021/05/24:
    • 버전 9.0 이하
      • 'date_preset = maximum' 활성화(새 버전과 동일)
      • 요청에 잔류 기간이 37개월 넘는 명시적 날짜 범위가 포함될 경우 오류 반환(새 버전과 동일)
      • 'date_preset = lifetime'은 여전히 작동하지만 37개월 이내의 데이터만 반환(최댓값처럼 작동)

자세한 내용은 v10.0 변경 사항을 참조하세요.

ThreatExchange의 외부 소유 데이터에 대한 새로운 삭제 정책

2021년 5월 24일부터 파트너가 ThreatExchange에 업로드하는 데이터에 expire_time을 설정하면 지정된 만료 시점에 데이터를 '영구 삭제'합니다. 데이터가 더 이상 유효하지 않다고 표시하고 싶다면 데이터가 자동 삭제되도록 'expired_on' 필드를 설정하세요.

이전에는 만료된 콘텐츠를 만료된 것으로 레이블을 표시하는 '일시' 삭제가 있었습니다. 일시 삭제 기능은 더 이상 지원하지 않으며, 콘텐츠가 만료된 후에는 영구 삭제되고 ThreatExchange에 표시되지 않습니다.

또한 Facebook에서 생성하지 않은 ThreatExchange의 모든 ThreatDescriptors는 만료되면 영구 삭제됩니다. 앞으로도 만료 시점은 ThreatDescriptor를 생성하는 사람이 설정합니다. 그러면 Facebook에서 생성하지 않은 모든 만료된 ThreatDescriptors에서 삭제가 시작됩니다. 이 정책이 적용되었을 때 만료되었지만 삭제하고 싶지 않은 ThreatDescriptors가 앱에 있다면 만료 날짜를 연장하거나 '0'으로 설정하여 데이터가 만료되지 않도록 해야 합니다.

변경 사항에 대한 자세한 내용은 여기를 클릭하여 확인하세요.

새로운 API의 타게팅 변경 사항

2021년 5월 24일부터 모든 API 버전에서 유사 맞춤 타겟을 생성할 때 location_spec과 country 매개변수를 요청하지 않습니다.

유사 타겟을 만들 때 사용자는 유사 타겟 소스와 원하는 비율을 선택합니다. 유사 타겟의 위치는 캠페인의 타게팅 사양에 지정된 국가 위치로 정의됩니다. 이 변경 사항 이후에도 기존 캠페인에 대한 영향은 없습니다. 이 변경 사항은 새 캠페인과 수정된 캠페인에만 적용됩니다.

새로운 플랫폼 라이브 상태 페이지 공개

새로운 Facebook 비즈니스 상태 페이지는 Facebook 플랫폼 제품을 사용하는 외부 개발자에 대한 투명성과 선제적 커뮤니케이션을 개선할 것입니다. 이 페이지는 Facebook의 비즈니스 제품(광고, WhatsApp Business API, Facebook 개발자 플랫폼 등)의 플랫폼 상태를 한 곳에서 확인할 수 있습니다. 현재 이 페이지는 광고 관리자와 Whatsapp Business API에 대해 활성화되어 있으며 2021년 5월에 다른 비즈니스 제품이 추가될 것입니다.

사용 중단

방송하기 대화 상자 사용 중단

2021년 5월 24일부터 방송하기 대화 상자(GLD) SDK가 사용 중단됩니다. 기존 라이브 방송 도구는 모든 API 버전에서 사용 중단됩니다. 이 변경 사항은 Facebook의 라이브 방송에만 적용됩니다. 개발자 여러분께서는 위의 모든 라이브 방송 솔루션에 Live ProducerLive API를 사용하시기 바랍니다.

GLD SDK 사용 중단 시 방송 방법:

  • facebook.com/live/producer(또는 Facebook의 다른 진입점(예: 페이지 또는 프로필의 '라이브 방송' 버튼)에서 Live Producer에 직접 액세스
  • Live API와 모든 맞춤 솔루션 통합

자세한 내용은 v10.0 변경 사항을 참조하세요.

연결 관계 타게팅 사용 중단

2021년 5월 24일부터 광고 세트를 생성/편집할 때 연결 관계 타게팅이 더 이상 지원되지 않습니다. 이 요구 사항은 새 캠페인과 수정된 캠페인에만 적용되며 기존 캠페인에는 영향을 미치지 않습니다.

자세한 내용은 v10.0 변경 사항을 참조하세요.

사용 재개

gr:delete:Page/tabs 엔드포인트 사용 재개

그래프 API v8.0을 출시했을 때 페이지 탭의 gr:delete:Page/tabs 엔드포인트가 사용 중단되었습니다. 그래프 API v10.0은 출시 이후에 즉시 이 엔드포인트의 사용이 재개되고 그 외 모든 그래프 API 버전은 2021년 5월 24일부터 복원됩니다.

자세한 내용은 v10.0 변경 사항을 참조하세요.

gr:post:Business/business_users, gr:post:Business/system_users 및 gr:post:User/access_tokens 엔드포인트 사용 재개

그래프 API v9.0을 출시했을 때 다음의 비즈니스 엔드포인트에 대한 액세스를 제한했습니다.

  • gr:post:Business/business_users
  • gr:post:Business/system_users
  • gr:post:User/access_tokens

그래프 v10.0이 출시된 이후 앱이 다음의 두 가지 조건 중 하나를 충족하면 API 호출에 해당 엔드포인트를 사용할 수 있게 됩니다.

  • 타겟 비즈니스가 호출을 보내는 앱을 소유하는 비즈니스인 경우
  • 타겟 비즈니스가 호출을 보내는 앱을 소유하는 비즈니스의 하위 비즈니스(비즈니스 2T 모델 내)인 경우

자세한 내용은 v10.0 변경 사항을 참조하세요.

행동 항목 캘린더

마케팅 API 버전 사용 중단:

마케팅 API 버전 관리 일정에 따라 다음과 같이 마케팅 API 버전이 사용 중단될 예정입니다.

  • 2021년 3월 3일: 마케팅 API v7.0이 사용 중단되고 플랫폼에서 제거됨
  • 2021년 5월 4일: 마케팅 API v8.0이 사용 중단되고 플랫폼에서 제거됨
  • 2021년 8월 25일: 마케팅 API v9.0이 사용 중단되고 플랫폼에서 제거됨

비즈니스 운영에 지장이 없도록 오늘 출시된 최신 마케팅 API 버전으로 모든 호출을 마이그레이션하시기 바랍니다. (자세한 내용은 변경 사항을 참조하세요.)

그래프 API 버전 사용 중단:

그래프 API 버전 관리 일정의 일환으로 다음과 같이 그래프 API 버전이 사용 중단됩니다.

  • 2021년 5월 4일: 그래프 API v3.2가 사용 중단되고 플랫폼에서 제거됨
  • 2021년 8월 3일: 그래프 API v3.3이 사용 중단되고 플랫폼에서 제거됨

일반적인 사용 중단

  • 2021년 5월 24일:
    • 방송하기 대화 상자가 사용 중단되고 플랫폼에서 제거됨
    • 연결 관계 타게팅이 사용 중단되고 플랫폼에서 제거됨

개발자 조치 필요

  • 출시 등록: 데이터 사용 확인 인증
    • 앱을 등록하고 60일 이내에 완료해야 함
    • DUC 전용 FAQ 섹션을 참조하세요.
  • 2021년 2월 23일: 그래프 v10.0에만 적용되는 그래프 AdsInsight API 변경 사항 공개
  • 2021년 5월 24일:
    • 그래프 v9.0 이하에 적용되는 그래프 AdsInsight API 변경 사항 공개
    • 앱 검수에 기반한 액세스 레벨 변경 사항 적용
      • 그래프 API 데이터 액세스가 90일로 제한
      • 그룹 API 차등적 데이터 레벨 적용
      • 비즈니스 앱의 public_profile 및 Email 권한 변경 사항 적용
    • ThreatExchange에 대한 새로운 '영구 삭제' 데이터 정책 적용
  • 2022년 11월 10일: 데이터 삭제 요청 기한