버전 11.0

그래프 API

출시 2021년 6월 8일 | 이용 가능 시기 2023년 9월 14일 | 블로그 게시물

소비자 앱

액세스 레벨

모든 버전에 적용됩니다.

앞으로 몇 주 이내에 액세스 레벨이 모든 기존 소비자 앱에 적용됩니다. 이러한 앱의 경우 이미 앱 검수 절차를 거쳐 승인을 받은 권한과 기능은 Advanced Access에 대해 자동으로 승인됩니다. 그 외에 다른 권한과 기능은 Standard Access에 대해 자동으로 승인됩니다.

액세스 레벨은 앞으로 몇 주 이내에 새로 생성된 모든 앱에 적용됩니다. 새로 생성된 앱은 이메일 및 public_profile 권한에 대해 Advanced Access가 자동으로 승인됩니다. 그러나 두 권한은 기본적으로 Standard Access로 설정되며, Advanced Access를 수동으로 설정해야 앱에서 역할을 부여받지 않은 앱 사용자에게 요청할 수 있습니다.

개발자 지원

플랫폼과 비즈니스 제품(예: 광고 관리자, WhatsApp Business, Facebook 개발자 플랫폼)의 상태를 모니터링하기 위한 Facebook for Business Status 도구를 출시했습니다.

Facebook 분석

사용 중단

모든 버전에 적용됩니다.

Facebook 분석은 2021년 6월 30일까지만 사용할 수 있습니다. 또한 마케팅 API용 앱 대시보드 플러그인을 사용 중단합니다. 자세한 내용은 비즈니스 지원 센터에서 확인하실 수 있습니다.

다음의 앱 노드 필드는 더 이상 제공되지 않습니다.

• analytics_config
• analytics_platform_metrics_config
• permissible_ad_accounts

다음 엔드포인트는 더 이상 사용할 수 없습니다.

• GET Application/analytics_cohort_query
• GET Application/analytics_entity_user_config
• GET Application/analytics_event_types
• GET Application/analytics_funnel_query
• GET Application/analytics_query
• GET Application/analytics_segments

Instagram 기본 디스플레이 API

액세스 토큰 디버거

모든 버전에 적용됩니다.

이제 액세스 토큰 디버거 도구는 토큰을 디버깅할 때 앱 범위 ID만 반환합니다.

API 버전 관리

모든 버전에 적용됩니다.

이제 이 API는 버전이 지정된 호출을 지원합니다. 특정 API 버전을 쿼리하려면 기본 URL 뒤의 쿼리 경로에 버전 번호를 포함하세요. 예를 들면 다음과 같습니다.

https://graph.instagram.com/v11.0/{node-id}/{edge-name}

버전이 지정되지 않은 요청(버전 번호가 없음)은 호출하는 앱의 앱 대시보드 > 설정 > 고급 > API 버전 업그레이드 설정에 지정된 버전으로 지정합니다.

앱 범위 사용자 ID

11.0 이상 버전에 적용됩니다.

앱 범위 사용자 ID(ASID)가 도입되었습니다. ASID는 버전 10.0이 사용 중단되는 약 2년 후에 원시 사용자 ID를 대체할 예정입니다. 그러므로 앱 사용자의 원시 ID를 ASID에 매핑하기 시작하는 것이 좋습니다.

• 모든 버전이 원시 사용자 ID 기반 쿼리를 지원합니다.
• 11.0 이상 버전의 호출만 ASID 기반 쿼리를 지원합니다.
• 11.0 이상 버전의 호출은 원시 사용자 ID를 쿼리할 때도 응답에서 ASID를 수신합니다.

시간 기반 페이지 매김

v11.0+에 적용됩니다.

시간 기반 페이지 매김을 지원하기 위해 since 및 until 매개변수를 GET /{user-id}/media 엔드포인트에 추가했습니다.

Instagram 그래프 API

좋아요 개수

v11.0 이상에 적용됩니다. 2021년 9월 7일에 모든 버전에 적용됩니다.

다른 엔드포인트 또는 필드 확장을 통해 IG 미디어를 간접적으로 쿼리할 경우 미디어 소유자가 미디어의 좋아요 개수를 숨겼다면 like_count 필드는 API 응답에서 생략됩니다. IG 미디어를 직접 쿼리하면(IG 미디어 소유자만 가능) 좋아요 개수가 숨겨져 있더라도 실제 좋아요 개수가 반환됩니다.

시간 기반 페이지 매김

v11.0+에 적용됩니다.

시간 기반 페이지 매김을 지원하기 위해 since 및 until 매개변수를 GET /{ig-user-id}/media 엔드포인트에 추가했습니다.

인스턴트 경험

템플릿

v11.0+에 적용됩니다.

인스턴트 경험 템플릿은 베타를 종료하고 이제 모든 개발자에게 제공됩니다.

Messenger 플랫폼

메시지 Postback Webhook

v11.0+에 적용됩니다.

앱이 메시지 ID를 가져올 수 있도록 mid 필드를 messaging_postbacks webhook에 추가했습니다.

항공사 템플릿 사용 중단

v11.0+에 적용됩니다. 2021년 12월 6일에 모든 버전에 적용됩니다.

모든 항공사 템플릿(airline_boardingpass, airline_checkin, airline_itinerary, airline_update 유형의 template_type)이 포함된 POST /{page-id}/messages 호출은 실패합니다.

oEmbed

새로운 oEmbed 읽기 기능

모든 버전에 적용됩니다.

oEmbed 제품은 새로운 oEmbed 읽기 기능으로 교체되었습니다. 2021년 6월 8일에 oEmbed 제품을 구현했을 경우 2021년 9월 7일까지 oEmbed 읽기 기능에 대한 앱 검수를 완료해야 합니다. 2021년 9월 7일까지 oEmbed 읽기 기능에 대한 승인을 받지 않았을 경우 oEmbed 구현을 읽어들이지 못합니다.

페이지 API

댓글 ID

v11.0+에 적용됩니다. 2021년 9월 7일에 모든 버전에 적용됩니다.

페이지 엔드포인트를 쿼리할 때 페이지 전체 공개 콘텐츠 액세스 기능만 사용하는 앱은 댓글의 id 필드가 반환되지 않습니다. 여기에는 id 필드(/PAGEPOST-ID/comments 또는 /COMMENT-ID/comments)가 포함됩니다. 페이지 게시물의 댓글에 대한 댓글 id 필드를 가져오려면 앱 사용자가 쿼리 대상 페이지에서 MODERATE 작업을 실행할 수 있어야 합니다.

새로운 페이지 환경

앞으로 몇 개월 동안 모든 기존 페이지는 새로운 페이지 환경으로 마이그레이션됩니다. has_transitioned_to_new_page_experience 페이지 필드를 사용하여 페이지가 마이그레이션되었는지 확인하세요. 모든 페이지가 마이그레이션되고 나면 더 이상 기존 페이지 환경을 사용할 수 없습니다.

대부분 페이지 API 엔드포인트는 기존 페이지와 NPE 페이지를 모두 지원합니다. NPE 페이지를 지원하는 엔드포인트는 참고 자료의 "새 페이지 환경" 섹션을 표시합니다.

다음의 엔드포인트는 NPE 페이지를 지원하지 않습니다.

• /PAGE-ID/likes
• /PAGE-ID/global_brand_children
• /PAGE-ID/locations
• /PAGE-ID/tabs
• /PAGE-ID/visitor_posts

NPE에서는 여러 가지 페이지 필드를 사용할 수 없고 이러한 필드를 호출하면 null, 다른 데이터 세트 또는 오류를 반환합니다. 해당 페이지 필드의 리스트는 새 페이지 환경 개요를 참조하세요.

권한

user_likes

모든 버전에 적용됩니다.

user_likes 권한에 허용되는 사용 방법이 업데이트되었습니다. 2021년 9월 7일부터 이 권한에 대해 승인을 받았지만 새로운 사용 방법 설명과 용도가 다른 앱은 승인이 취소됩니다.

• 기존의 허용되는 사용 방법: 앱에서 사용자의 환경을 의미 있게 개선하세요. 사용자가 자신의 데이터가 해당 환경을 제공하기 위해 어떻게 사용되는지 명확히 알아야 합니다.
• 새롭게 허용되는 사용 방법: 사용자의 좋아요와 관련된 콘텐츠를 연결하거나 표시하여 개인화된 경험을 제공합니다. 다량의 콘텐츠가 있는 앱을 맞춤화하기 위해 대규모로 콘텐츠를 선별하고 데이팅 앱이나 음악 앱의 경우 사용자가 좋아요를 다른 사람과 공유할 수도 있습니다.

user_posts

모든 버전에 적용됩니다.

user_posts 권한에 허용되는 사용 방법이 업데이트되었습니다. 2021년 9월 7일부터 이 권한에 대해 승인을 받았지만 새로운 사용 방법 설명과 용도가 다른 앱은 승인이 취소됩니다.

• 기존의 허용되는 사용 방법: 앱에서 사용자의 환경을 의미 있게 개선하세요. 사용자가 자신의 데이터가 해당 환경을 제공하기 위해 어떻게 사용되는지 명확히 알아야 합니다.
• 새롭게 허용되는 사용 방법: 사용자가 타임라인을 실제 또는 디지털 서적이나 사진첩으로 제작하고 Facebook이나 다른 소셜 앱 타임라인에서 추억을 공유할 수 있습니다.

SDK

이런 SDK에 예정된 중요한 변경 사항은 iOS SDK 변경 사항, Android SDK 변경 사항, Unity SDK 변경 사항을 참조하세요.

마케팅 API

출시 2021년 6월 8일 | 이용 가능 시기 2022년 2월 23일 | 블로그 게시물

타겟

맞춤 타겟, 유사 타겟, 저장된 타겟 삭제

모든 버전에 적용됩니다.

2021년 6월 8일부터는 2년 이상 활성 광고 세트에서 사용되지 않은 맞춤 타겟, 유사 타겟 또는 저장된 타겟은 "만료되는 타겟"으로 플래그를 지정합니다. 이 타겟은 "만료되는 타겟"으로 표시되고 나서 90일 후에 삭제될 예정입니다.

개발자는 operation_status 필드를 사용하여 "만료되는 타겟" 상태에 대해 필터링하고 delete_time 필드를 사용하여 시스템에서 타겟의 예상 삭제 시간을 확인할 수 있습니다. 개발자는 타겟을 미리 삭제하거나 활성 광고 세트의 타겟을 사용하여 삭제를 방지하세요. 타겟이 삭제되고 나면 광고주가 해당 타겟을 다시 활성화할 수 없습니다.

맞춤 타겟(고객 리스트 맞춤 타겟 제외), 유사 타겟 또는 저장된 타겟:

• 광고주가 플래그가 지정된 타겟을 2021년 9월 6일 전에 자동 삭제하기를 원할 경우 별도의 조치를 취할 필요가 없습니다. 그러나 광고주가 원할 경우 자동 삭제 날짜 이전에 미리 타겟을 삭제할 수도 있습니다.
• 광고주가 유지하고 싶은 플래그가 지정된 타겟의 경우 2021년 9월 6일 이전에 활성 광고 세트에서 사용할 계획을 세워 타겟이 삭제되지 않도록 해야 합니다.

고객 리스트 맞춤 타겟:

• Facebook이 광고주의 지침에 따라 대신 타겟을 저장합니다. 광고주가 2021년 9월 6일 이전에 활성 광고 세트에서 플래그가 지정된 타겟을 사용하기 위한 조치를 취하지 않을 경우, Facebook에서는 이를 플래그가 지정된 타겟을 삭제하라는 지침으로 간주합니다.

다음의 엔드포인트와 필드가 영향을 받습니다.

• GET /{custom-audience-id}
• GET /act_{ad-account-id}/customaudiences?filtering
• GET /act_{ad-account-id}/saved_audiences?filtering
• GET /{saved-audience-id}

이 업데이트에 대한 자세한 내용은 타겟 개요: 맞춤 타겟 삭제 변경 사항을 참조하세요.

비즈니스 API

모든 버전에 적용됩니다.

현재 일시적으로 다음의 엔드포인트에 대한 액세스를 제한합니다. 최근 30일 이내에 이러한 엔드포인트를 성공적으로 호출한 앱만 계속 액세스할 수 있습니다.

• POST /BUSINESS-ID/client_ad_accounts
• POST /ADACCOUNT-ID/agencies

그 외에 다른 모든 앱은 해당 엔드포인트에 호출을 보내면 오류를 수신합니다.

카탈로그 API

제품 인벤토리 필드의 사용 중단

11.0+에 적용됩니다.

inventory 필드는 사용 중단되고 새 quantity_to_sell_on_facebook 필드로 교체됩니다. 잠시 동안은 inventory 필드를 계속 지원하겠지만 대신 quantity_to_sell_on_facebook 필드를 사용하는 것이 좋습니다.

다음의 엔드포인트가 영향을 받습니다.

• GET /{product-item-id}
• GET /{catalog-id}/products
• POST /{product-item-id}
• POST /{catalog-id}/items_batch

이 업데이트에 대한 자세한 내용은 판매 수량 및 제품에 지원되는 필드 - 다이내믹 광고 및 상거래를 참조하세요.

비어 있지 않은 제품 그룹 삭제

11.0+에 적용됩니다. 2021년 9월 7일에 모든 버전에 적용됩니다.

기본적으로 더 이상 비어 있지 않은 제품 그룹 삭제가 허용되지 않습니다. 비어 있지 않은 제품 그룹은 deletion_method=delete_items를 삭제 요청에 적용하여 삭제할 수 있습니다. 제품 그룹과 항목이 모두 삭제됩니다.

다음의 엔드포인트가 영향을 받습니다.

• DELETE /<product_group_id>

라이브 제품 세트의 삭제

11.0+에 적용됩니다. 2021년 9월 7일에 모든 버전에 적용됩니다.

기본적으로 더 이상 라이브 제품 세트가 포함된 카탈로그 삭제가 허용되지 않습니다. 라이브 제품 세트를 포함하는 카탈로그 삭제를 지원하려면 카탈로그의 allow_delete_catalog_with_live_product_set 매개변수를 true로 설정하세요.

이 변경 사항은 다음의 엔드포인트에 영향을 미칩니다.

• DELETE /<product_catalog_id>

새로운 진단 엔드포인트

11.0+에 적용됩니다.

새로운 엔드포인트 GET /{product_catalog_id}/diagnostics를 추가했습니다. 이 엔드포인트는 특정 카탈로그에 대한 진단 데이터(예: 제품이 채널에 표시되지 못하도록 하는 문제, 제품 발견 가능성을 개선할 수 있는 기회)를 가져오는 데 사용할 수 있습니다.

상거래 API

주문 총액으로 추산한 결제 상세 정보

11.0+에 적용됩니다. 2021년 9월 7일에 모든 버전에 적용됩니다.

{commerce-order-id}/?fields=estimated_payment_details 엔드포인트 호출에서 주문 총액에 추산된 결제 상세 정보를 보고하는 방식을 변경하고 있습니다. 이전에는 처리되지 않은 주문에 대해 추산된 세금을 사용하였고 처리된 주문에 대해서는 처리된 세금을 사용했습니다. 11.0 버전부터 이 엔드포인트는 항상 추산된 세금을 사용합니다. 처리된 세금에 대한 상세 정보는 {commerce-order-id}/items?fields=tax_details를 사용하여 액세스할 수 있습니다.

전환 성과 증대

지표 변경 사항

v11.0+에 적용됩니다. 2021년 9월 7일에 모든 버전에 적용됩니다.

GET /{objective-id}/?fields=result 필드에서 반환되는 지표가 변경되었습니다.

다음의 지표가 추가되었습니다.

• conversions_incremental_share
• conversions_CPiC
• conversions_multicell_confidence
• conversions_multicell_rank
• sales_incremental_share
• sales_multicell_confidence
• sales_multicell_rank
• buyers_incremental_share
• buyers_CPiB
• buyers_multicell_confidence
• buyers_multicell_rank

다음의 지표는 제거되었습니다.

• advancedBuyers.control
• ancedBuyers.informativeMultiCellBayesianConfidence
• advancedBuyers.lift
• advancedBuyers.test
• advancedConversions.control
• advancedConversions.informativeMultiCellBayesianConfidence
• advancedConversions.lift
• advancedConversions.test
• advancedSales.control
• advancedSales.informativeMultiCellBayesianConfidence
• advancedSales.lift
• advancedSales.test
• buyers.baseline
• buyers.bayesianCILower
• buyers.bayesianCIUpper
• buyers.control
• buyers.delta
• buyers.incremental
• buyers.isStatSig
• buyers.lift
• buyers.multiCellBayesianConfidence
• buyers.reachedPercent
• buyers.singleCellBayesianConfidence
• conversions.baseline
• conversions.bayesianCILower
• conversions.bayesianCIUpper
• conversions.control
• conversions.delta
• conversions.incremental
• conversions.isStatSig
• conversions.lift
• conversions.multiCellBayesianConfidence
• conversions.reachedPercent
• conversions.singleCellBayesianConfidence
• frequency
• incrementalROAS
• sales.baseline
• sales.bayesianCILower
• sales.bayesianCIUpper
• sales.control
• sales.delta
• sales.incremental
• sales.isStatSig
• sales.lift
• sales.multiCellBayesianConfidence
• sales.singleCellBayesianConfidence

다음의 지표 이름이 변경되었습니다.

사용 가능한 지표의 전체 리스트는 Facebook 성과 증대 지표 용어 사전에서 확인할 수 있습니다.

인사이트 API

매장 방문 지표의 사용 중단

11.0+에 적용됩니다. 2021년 9월 6일에 모든 버전에 적용됩니다.

store_visits_actions와 cost_per_store_visit_actions 지표가 사용 중단되었습니다.

다음의 엔드포인트가 영향을 받습니다.

• GET /{adaccount-id}/insights
• GET /{campaign-id}/insights
• GET /{adset-id}/insights
• GET /{ad-id}/insights
• POST /{adaccount-id}/insights
• POST /{campaign-id}/insights
• POST /{adset-id}/insights
• POST /{ad-id}/insights

쿠폰 광고 API

쿠폰 광고 API 엔드포인트의 사용 중단

v11.0+에 적용됩니다. 2021년 9월 7일에 모든 버전에 적용됩니다.

Facebook은 제품 안정성을 개선하기 위한 지속적인 노력의 일환으로 2021년 6월 8일에 쿠폰 광고 제품에 대한 지원을 중단합니다. 매장 및/또는 온라인 할인을 배포하려면 대신 표준 Facebook 광고를 사용하는 것이 좋습니다. 할인 정보, 사용 위치, 만료 날짜, 홍보 코드는 광고 수준 크리에이티브에 직접 입력하세요.

다음의 엔드포인트가 사용 중단되었습니다.

• GET /{page-id}/nativeoffers
• POST /[page-id}/nativeoffers
• GET /pagename/nativeoffers
• GET /{native-offer-id}
• GET /{native-offer-id}/views
• POST /{native-offer-id}/codes
• POST /{native-offer-id}/nativeofferviews
• GET /{offer-id}/comments
• GET /{offer-id}/sharedposts
• GET /{offer-id}/likes