diff --git a/changelog.mdx b/changelog.mdx index 8ef5fb3e7..b96c491a9 100644 --- a/changelog.mdx +++ b/changelog.mdx @@ -7,6 +7,18 @@ keywords: ["changelog", "API updates", "release notes", "what's new", "API chang To subscribe to updates, please [**“Turn on notifications”**](https://help.x.com/en/managing-your-account/notifications-on-mobile-devices#:~:text=In%20the%20top%20menu,%20you,you%20would%20like%20to%20receive) for [**@API**](https://x.com/api). + + ### Ads API Analytics: removal of unsupported placements, metric groups, and entity types + + Today, we updated the [Ads API Analytics](/x-ads-api/analytics) endpoint to reflect what is currently supported in production. If your integration references any of the values below, update your requests accordingly: + + - **Placements:** `PUBLISHER_NETWORK` is no longer a valid placement for analytics requests (it remains visible only in Active Entities responses). + - **Metric groups:** the `MEDIA` metric group has been removed, along with the Media View Rate derived metrics under `ENGAGEMENT` and `FOLLOWERS`. + - **Entity types:** `MEDIA_CREATIVE` and `ORGANIC_TWEET` are no longer supported entity types for analytics or sync analytics. + - **Objectives:** the `APP_ENGAGEMENTS` and `LEAD_GENERATION` objective sections (both Metrics by Objective and Derived Metrics) have been removed. + - **Segmentation:** segmentation is supported only for `AGE`, `GENDER`, `METROS`, and `PLATFORMS`. + + ### Articles draft and publish endpoints diff --git a/es/changelog.mdx b/es/changelog.mdx index 96daa5bb1..2334c2ccb 100644 --- a/es/changelog.mdx +++ b/es/changelog.mdx @@ -7,6 +7,18 @@ keywords: ["registro de cambios", "actualizaciones de la API", "notas de la vers Para suscribirte a las actualizaciones, [**"Activa las notificaciones"**](https://help.x.com/en/managing-your-account/notifications-on-mobile-devices#:~:text=In%20the%20top%20menu,%20you,you%20would%20like%20to%20receive) para [**@API**](https://x.com/api). + + ### Ads API Analytics: eliminación de placements, grupos de métricas y tipos de entidad no admitidos + + Hoy actualizamos el endpoint de [Ads API Analytics](/x-ads-api/analytics) para reflejar lo que actualmente se admite en producción. Si tu integración hace referencia a alguno de los valores a continuación, actualiza tus solicitudes en consecuencia: + + - **Placements:** `PUBLISHER_NETWORK` ya no es un placement válido para solicitudes de analítica (solo permanece visible en las respuestas de Active Entities). + - **Grupos de métricas:** se eliminó el grupo de métricas `MEDIA`, junto con las métricas derivadas de Media View Rate en `ENGAGEMENT` y `FOLLOWERS`. + - **Tipos de entidad:** `MEDIA_CREATIVE` y `ORGANIC_TWEET` ya no son tipos de entidad admitidos para analytics ni sync analytics. + - **Objetivos:** se eliminaron las secciones de los objetivos `APP_ENGAGEMENTS` y `LEAD_GENERATION` (tanto Metrics by Objective como Derived Metrics). + - **Segmentación:** la segmentación solo está admitida para `AGE`, `GENDER`, `METROS` y `PLATFORMS`. + + ### Endpoints de borrador y publicación de Articles diff --git a/ja/changelog.mdx b/ja/changelog.mdx index 2accc0329..cd9d0241c 100644 --- a/ja/changelog.mdx +++ b/ja/changelog.mdx @@ -7,6 +7,18 @@ keywords: ["変更履歴", "API 更新", "リリースノート", "新着情報" 更新情報の通知を受け取るには、[**@API**](https://x.com/api) の [**「通知をオンにする」**](https://help.x.com/en/managing-your-account/notifications-on-mobile-devices#:~:text=In%20the%20top%20menu,%20you,you%20would%20like%20to%20receive) を有効にしてください。 + + ### Ads API Analytics: 未対応のプレースメント、メトリックグループ、エンティティタイプを削除 + + 本日、現在本番環境でサポートされている内容を反映するため、[Ads API Analytics](/x-ads-api/analytics) エンドポイントを更新しました。お客様の連携で以下の値を参照している場合は、リクエストを適宜更新してください。 + + - **プレースメント:** `PUBLISHER_NETWORK` はアナリティクスリクエストで有効なプレースメントではなくなりました(Active Entities のレスポンス内でのみ引き続き表示されます)。 + - **メトリックグループ:** `MEDIA` メトリックグループが削除され、`ENGAGEMENT` および `FOLLOWERS` の Media View Rate 派生メトリックも併せて削除されました。 + - **エンティティタイプ:** `MEDIA_CREATIVE` および `ORGANIC_TWEET` は、アナリティクスおよび同期アナリティクスでサポートされるエンティティタイプではなくなりました。 + - **目的:** `APP_ENGAGEMENTS` および `LEAD_GENERATION` の目的セクション(Metrics by Objective と Derived Metrics の両方)が削除されました。 + - **セグメンテーション:** セグメンテーションは `AGE`、`GENDER`、`METROS`、`PLATFORMS` のみサポートされます。 + + ### Articles のドラフトおよび公開エンドポイント diff --git a/ko/changelog.mdx b/ko/changelog.mdx index 8a2e3c0b9..459f135dd 100644 --- a/ko/changelog.mdx +++ b/ko/changelog.mdx @@ -7,6 +7,18 @@ keywords: ["변경 로그", "API 업데이트", "릴리스 노트", "새로운 업데이트를 구독하려면 [**@API**](https://x.com/api)의 [**"알림 켜기"**](https://help.x.com/en/managing-your-account/notifications-on-mobile-devices#:~:text=In%20the%20top%20menu,%20you,you%20would%20like%20to%20receive)를 활성화하세요. + + ### Ads API Analytics: 지원되지 않는 placement, 메트릭 그룹 및 엔터티 유형 제거 + + 오늘, 현재 프로덕션에서 지원되는 내용을 반영하도록 [Ads API Analytics](/x-ads-api/analytics) 엔드포인트를 업데이트했습니다. 통합에서 아래 값을 참조하는 경우, 그에 맞게 요청을 업데이트하세요. + + - **Placements:** `PUBLISHER_NETWORK`는 더 이상 analytics 요청에 유효한 placement가 아닙니다(Active Entities 응답에서만 계속 표시됩니다). + - **메트릭 그룹:** `MEDIA` 메트릭 그룹이 제거되었으며, `ENGAGEMENT` 및 `FOLLOWERS`의 Media View Rate 파생 메트릭도 함께 제거되었습니다. + - **엔터티 유형:** `MEDIA_CREATIVE` 및 `ORGANIC_TWEET`는 더 이상 analytics 또는 sync analytics에서 지원되는 엔터티 유형이 아닙니다. + - **목표:** `APP_ENGAGEMENTS` 및 `LEAD_GENERATION` 목표 섹션(Metrics by Objective 및 Derived Metrics 모두)이 제거되었습니다. + - **세그멘테이션:** 세그멘테이션은 `AGE`, `GENDER`, `METROS`, `PLATFORMS`에 대해서만 지원됩니다. + + ### Articles 초안 작성 및 게시 엔드포인트 diff --git a/pt/changelog.mdx b/pt/changelog.mdx index 278c54b65..99bfbfc09 100644 --- a/pt/changelog.mdx +++ b/pt/changelog.mdx @@ -7,6 +7,18 @@ keywords: ["registro de alterações", "atualizações da API", "notas de versã Para se inscrever para receber atualizações, [**"Ative as notificações"**](https://help.x.com/en/managing-your-account/notifications-on-mobile-devices#:~:text=In%20the%20top%20menu,%20you,you%20would%20like%20to%20receive) para [**@API**](https://x.com/api). + + ### Ads API Analytics: remoção de placements, grupos de métricas e tipos de entidade não suportados + + Hoje, atualizamos o endpoint da [Ads API Analytics](/x-ads-api/analytics) para refletir o que é atualmente suportado em produção. Se sua integração faz referência a algum dos valores abaixo, atualize suas requisições conforme necessário: + + - **Placements:** `PUBLISHER_NETWORK` não é mais um placement válido para requisições de analytics (permanece visível apenas nas respostas de Active Entities). + - **Grupos de métricas:** o grupo de métricas `MEDIA` foi removido, juntamente com as métricas derivadas de Media View Rate em `ENGAGEMENT` e `FOLLOWERS`. + - **Tipos de entidade:** `MEDIA_CREATIVE` e `ORGANIC_TWEET` não são mais tipos de entidade suportados para analytics ou sync analytics. + - **Objetivos:** as seções dos objetivos `APP_ENGAGEMENTS` e `LEAD_GENERATION` foram removidas (tanto Metrics by Objective quanto Derived Metrics). + - **Segmentação:** a segmentação é suportada apenas para `AGE`, `GENDER`, `METROS` e `PLATFORMS`. + + ### Endpoints de rascunho e publicação de Articles