バージョン13.0

グラフAPI

リリース日 2022年2月8日 | 提供終了日 TBD | ブログ投稿

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マップの中に新しい類似(lookalike)プロパティが返されます。これは、類似拡張機能が有効であることを示すものであり、詳細なターゲット設定拡張の既存の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}