버전 13.0

그래프 API

출시일 2022년 2월 8일 | 사용 가능 기한 미정 | 블로그 게시물

Instagram 그래프 API

IG 미디어

버전 13은 오류를 반환하지 않고 IG 미디어에 대한 video_title 필드 요청을 허용하는 마지막 버전입니다. 참고로 2021년 10월 5일 블로그 게시물에서 설명한 기존 API 동작은 다음과 같습니다.

media_product_type 필드는 모든 버전에서 FEED를 반환합니다.
video_title 필드는 모든 버전의 응답에서 생략됩니다.
Instagram Webhooks comments 및 mentions 필드는 모든 버전에서 지원됩니다.

위의 동작은 생성 날짜와 관계없이 Instagram TV 앱에서 생성된 IG 미디어를 비롯한 모든 IG 미디어에 적용됩니다.

사용자 인사이트

v13.0+에 적용됩니다.

다음의 IG 사용자 인사이트 지표는 더 이상 since 및 until 매개변수를 지원하지 않으며, 응답에는 end_time JSON 속성이 포함되지 않습니다.

마케팅 API

출시일 2022년 2월 8일 | 사용 가능 기한 2023년 1월 25일 | 블로그 게시물

광고 크리에이티브

노출 위치 소재 맞춤화 광고

v13.0+에 적용됩니다.

이제 POST /{ad-account-id}/adcreatives 엔드포인트의 asset_feed_spec 노드는 노출 위치 소재 맞춤화 광고로 슬라이드 광고를 만들 수 있습니다.

광고 라이브러리 API

광고 라이브러리

v13.0+에 적용됩니다.

GET /ads_archive 엔드포인트에 대한 다음의 쿼리 에지와 필드는 사용 중단되어 교체되었습니다.

이전 에지/필드	새로운 에지/필드
`funding_entity`	`bylines`
`region_distribution`	`delivery_by_region`
`potential_reach_min`	`estimated_audience_size_min`
`potential_reach_max`	`estimated_audience_size_max`
`potential_reach`	`estimated_audience_size`

GET /ads_archive 엔드포인트에 대한 다음의 반환 매개변수는 사용 중단되어 교체되었습니다.

이전 에지/필드	새로운 에지/필드
`ad_creative_body`	`ad_creative_bodies`
`ad_creative_link_caption`	`ad_creative_link_captions`
`ad_creative_link_description`	`ad_creative_link_descriptions`
`ad_creative_link_title`	`ad_creative_link_titles`
`funding_entity`	`bylines`
`region_distribution`	`delivery_by_region`

광고 세트

유사 타겟 확장

v13.0+에 적용됩니다. 2022년 5월 9일부터 모든 버전에 적용됩니다.

가치, 전환 또는 앱 이벤트를 최적화하는 새 광고 세트의 경우 기본적으로 유사 타겟 확장이 활성화되어 있으며, 이는 비활성화할 수 없습니다. 가치, 전환 또는 앱 이벤트를 최적화하는 광고 세트를 가져오면 targeting_optimization_types 지도에 새로운 유사 타겟 속성을 반환합니다. 이는 유사 타겟 확장이 활성화 상태임을 나타내며, 상세 타게팅 확장을 위해 detailed_targeting 속성을 보완합니다.

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

전환 API

고객 정보 매개변수

v13.0+에 적용됩니다.

이벤트에 유효한 것으로 간주되는 고객 정보 매개변수의 조합에 새로운 요구 사항이 적용됩니다. 이벤트에 다음의 조합 중 하나 또는 그 하위 집합으로 구성된 매개변수만 포함하는 경우 해당 이벤트는 유효하지 않은 것으로 간주합니다.

ct + country + st + zp + ge + client_user_agent
db + client_user_agent
fn + ge
ln + ge

이벤트에서 오류가 발생하지 않도록 전환 API 모범 사례를 검토하는 것이 좋습니다.

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

커머스 플랫폼

배송 프로필 API

v13.0+에 적용됩니다.

GET /{cms-id}/shipping_profiles 엔드포인트의 handling_time 필드가 shipping_profile 개체에서 address_category 개체로 이동되었습니다.

카탈로그

피드 API

v13.0+에 적용됩니다.

제품 피드 업로드 오류 코드의 이름이 XML_JUNK_AFTER_DOCUMENT에서 DATA_OUTSIDE_XML_TAGS로 변경되었습니다. 이름만 변경된 것입니다.

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

GET /{feed_upload_session_id}