Versão 13.0

Graph API

Lançada em 8 de fevereiro de 2022 | Disponível até a definir | Publicação de blog

Graph API do Instagram

Mídia do Instagram

A versão 13 será a última a permitir solicitações de campo video_title em mídias do Instagram sem retornar um erro. É importante lembrar que o comportamento atual da API descrito em nossa publicação de blog em 5 de outubro de 2021 é o seguinte:

• O campo media_product_type retorna FEED em todas as versões.
• O campo video_title é omitido das respostas em todas as versões.
• Os campos comments e mentions dos Webhooks do Instagram são compatíveis com todas as versões.

O comportamento acima se aplica a todas as mídias do Instagram, incluindo as criadas com o aplicativo Instagram TV, independentemente da data de criação.

Insights de usuário

Aplicável a partir da versão 13.0.

As métricas de insights de usuário do Instagram a seguir não são mais compatíveis com os parâmetros since e until. Além disso, as respostas não incluirão a propriedade JSON end_time.

• audience_city
• audience_country
• audience_gender_age
• audience_locale

API de Marketing

Lançada em 8 de fevereiro de 2022 | Disponível até 25 de janeiro de 2023 | Publicação de blog

Criativo do anúncio

Anúncios de personalização de ativo de posicionamento

Aplicável a partir da versão 13.0.

Agora, o nó asset_feed_spec do ponto de extremidade POST /{ad-account-id}/adcreatives permitirá a criação de anúncios em carrossel com os anúncios de personalização de ativo de posicionamento.

API da Biblioteca de Anúncios

Biblioteca de Anúncios

Aplicável a partir da versão 13.0.

Descontinuamos e substituímos as seguintes bordas e campos de consulta no ponto de extremidade GET /ads_archive:

Descontinuamos e substituímos os seguintes parâmetros de retorno no ponto de extremidade GET /ads_archive:

Conjuntos de anúncios

Expansão de semelhantes

Aplicável a partir da versão 13.0. As alterações serão aplicadas a todas as versões em 9 de maio de 2022.

Para conjuntos de anúncios recém-criados com otimização de valor, de conversões ou de eventos do aplicativo, a expansão de semelhantes ficará ativa por padrão e não poderá ser desativada. Ao obter um conjunto de anúncios com otimização de valor, de conversões ou de eventos do aplicativo, retornaremos uma nova propriedade de semelhantes no mapa targeting_optimization_types, indicando que a expansão de semelhantes está ativada e complementa a propriedade detailed_targeting existente para a expansão do direcionamento detalhado.

Essa alteração afeta os pontos de extremidade a seguir:

• POST /{ad-account-id}/adsets
• GET /{ad-account-id}/adsets

API de Conversões

Parâmetros de informações do cliente

Aplicável a partir da versão 13.0.

Há novos requisitos para as combinações de parâmetros de informações do cliente consideradas válidas para um evento. Um evento será considerado inválido se somente incluir parâmetros que consistem em uma combinação ou um subconjunto das combinações a seguir:

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

Para garantir que os seus eventos não resultem em erro, consulte as melhores práticas da API de Conversões.

Essa alteração afeta os pontos de extremidade a seguir:

• POST /{pixel-id}/events
• POST /{offline_dataset_id}/events

Plataforma de comércio

API de Perfis de Envio

Aplicável a partir da versão 13.0.

O campo handling_time do ponto de extremidade GET /{cms-id}/shipping_profiles foi movido de um objeto shipping_profile para um objeto address_category.

Catálogo

API de Feed

Aplicável a partir da versão 13.0.

Alteramos o nome do código de erro de carregamento do feed de produto XML_JUNK_AFTER_DOCUMENT. Agora, ele passa a se chamar DATA_OUTSIDE_XML_TAGS. Essa mudança atinge apenas o nome.

O seguinte ponto de extremidade será afetado:

• GET /{feed_upload_session_id}