As entradas do Log de alterações são categorizadas da seguinte maneira:
Os Novos recursos, as Alterações e os Itens que se tornaram obsoletos afetam apenas esta versão. As Alterações disruptivas em 90 dias afetam todas as versões.
As Alterações disruptivas não estão incluídas aqui, uma vez que não estão vinculadas a lançamentos específicos.
Lançado em 1º de maio de 2018 | Disponível até 28 de julho de 2020 | Publicação de blog
subscribed_domains_phishing
da API de transparência de certificado para inscrever domínios para alertas de phising..groups_access_member_info
e publish_to_groups
./comments
retorna dados vazios para os seguintes nós:
Expiração de token de acesso: um token de acesso é inválido se o usuário não interagiu com o aplicativo nos últimos 90 dias.
id
first_name
last_name
middle_name
name
name_format
picture
short_name
age_range
context
cover
currency
devices
gender
link
locale
timezone
updated_time
verified
As permissões rsvp_event
e user_managed_groups
foram descontinuadas. A permissão user_managed_groups
ainda pode ser usada para fins de teste, mas não pode ser enviada para Análise de Login.
groups_access_member_info
– para receber dados relacionados a membros em conteúdo de grupo.
publish_to_groups
– para publicar conteúdo em um grupo em nome de um usuário.
user_age_range
– para acessar a faixa etária de uma pessoa.
user_gender
– para acessar o gênero de uma pessoa.
user_link
– para acessar o URL de perfil do Facebook por outro usuário do aplicativo.
Não há itens obsoletos para esta versão.
Somente valores diferentes de zero serão retornados para métricas de detalhamento das Informações da Página.
Métricas de Envolvimento de história de Publicação e Página, incluindo metric
usado com o campo de métrica renomeado de stories
para activity
.
Métricas de envolvimento de Consumos de publicação da Página, incluindo metric
usado com o campo métricas e renomeado de post_consumption*
para post_clicks*
.
GET /{page-id}/insights/{metric}
– as seguintes métricas serão removidas em 90 dias:
page_story_adds
page_story_adds_by_age_gender_unique
page_story_adds_by_city_unique
page_story_adds_by_country_unique
page_views
page_views_unique
page_views_login
page_views_login_unique
GET /{post-id}/insights/{metric}
– as seguintes métricas serão removidas em 90 dias:
post_story_adds_by_action_type
post_story_adds_by_action_type_unique
post_story_adds_unique
post_story_adds
post_fan_reach
post_interests_impressions
post_interests_impressions_unique
post_interests_consumptions
post_interests_consumptions_unique
post_interests_consumptions_by_type
post_interests_consumptions_by_type_unique
post_interests_action_by_type
post_interests_action_by_type_unique
/photos
— o parâmetro type
para a borda /photos
(que está disponível em vários nós), não dá mais suporte para uploaded
como um valor para operações GET
(GET /object/photos?type=uploaded
).GET /user
— o campo third_party_id
está obsoleto. Os aplicativos que usam versões mais antigas da API podem obter esse campo até o dia 30 de julho de 2018. Os aplicativos instalados pelo usuário em 1º de maio de 2018 ou após esse dia não podem obter esse campo, independentemente da versão da API que usarem.Lançado em 1º de maio de 2018 | Disponível até 1º de fevereiro de 2019 | Publicação de blog
bid_strategy
Introduzimos o novo campo bid_strategy
para {account-id}/adsets
, que permite que você selecione uma estratégia de lances para anúncios com base em suas metas comerciais. Cada estratégia tem suas vantagens e desvantagens. Entre as opções estão:
LOWEST_COST
- obtenha o máximo de resultados com base no seu orçamento e entrega definidos para os anúncios optimization_goal
. O Facebook fará automaticamente mais lances conforme o necessário para gastar seu orçamento. Você pode fornecer um valor máximo para o seu lance ou deixar o valor ilimitado com essa opção.
TARGET_COST
- fornece custos médios estáveis para os seus anúncios conforme você aumenta seu orçamento para o conjunto de anúncios.
Para obter mais informações, consulte Otimização e compra de anúncios, estratégia de lances.
Nova API para criar anúncios de coleção - no passado, o Facebook criava um canvas no plano de fundo toda vez que você criava um anúncio de coleção. Isso limitava seu acesso ao anúncio do canvas subjacente, já que você não poderia usá-lo para fazer o redirecionamento de públicos com os públicos de engajamento do canvas. Agora, quando você cria um anúncio de coleção a partir de conjuntos de produtos, você também deve criar explicitamente um canvas com os elementos corretos. Quando você usa esse canvas em um anúncio de coleção, o Facebook gera automaticamente o anúncio de coleção. Para obter mais detalhes, consulte Anúncios de coleção em conjuntos de produtos.
Invalidação da coluna da direita - nós invalidamos anúncios que se destinam somente ao posicionamento do Facebook, right_hand_column
com objetivos inválidos para right_hand_column
em {ad_account_id}/adsets
. Agora somos compatíveis com posicionamento à direita somente para formatos de anúncios aceitos com estes objetivos: Tráfego, Conversões e Vendas do catálogo de produtos.
is_autobid
e is_average_price_pacing
estão obsoletos em GET
e POST
na v3.0 e posteriores.
Alteração nas regras de sintaxe para Públicos Personalizados - atualizamos a estrutura para regras com base nas regras usadas para a criação de públicos personalizados de sites, públicos personalizados para dispositivos móveis, públicos personalizados para engajamento com a página, públicos personalizados para anúncios de cadastro, públicos personalizados para canvas e públicos personalizados offline. Isso permite que você crie regras com base em comportamento agregado, regras de diferentes fontes de eventos e que exclua regras. Consulte:
Acesso ao catálogo de produtos - para acessar os itens do catálogo, você precisa especificar o vertical do catálogo. Se a sua solicitação não corresponder ao setor correto para o seu catálogo, você obterá um erro. Por exemplo, se você tiver um catálogo de comércio eletrônico, deverá acessá-lo com o ponto de extremidade /products
correspondente, como GET {catalog_id}/products
, GET {product_feed_id}/products
ou GET {product_set_id}/products
. Você não pode acessar o catálogo com pontos de extremidade para outros verticais, como GET {catalog_id}/autos
, GET {product_feed_id}/hotels
ou GET {product_set_id}/flights
.
Cadeia de caracteres vazia em tags de modelo - não permitimos mais cadeias de caracteres vazias para Anúncios dinâmicos, opções de tag de modelo. Por exemplo, se você transmitir uma cadeia de caracteres vazia para {{trip.checkin_date date_format:}}
, obterá um erro. Para informações de histórico, consulte Anúncios dinâmicos, gerenciamento de anúncios.
Tempos limite de informações - se esperamos os resultados de uma API de Informações e o tempo limite é atingido antes da conclusão, é retornado um erro com o código 100
e o subcódigo 1504033
. Nós estimamos isso com base no tamanho da solicitação e no progresso do processamento feito com relação aos limites de tempo. Se você obtiver esse erro, deverá fazer uma solicitação da API de Informações assíncronas para esses dados. Confira Trabalhos assíncronos da API de Informações.
Valores negativos em dados de eventos - se você publicar dados de eventos em {data_set_id}/events
com um valor negativo, ocorrerá falha. Isso afeta o campo data
para POST /{data_set_id-id}/events
.
Informações sobre otimização de orçamento da campanha - adset_budget_value
agora retornam using campaign budget
quando a sua campanha de anúncios usa otimização de orçamento da campanha. Isso afeta:
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
.
Classificação padrão do pixel - se você chama a borda GET {account_id}/adspixel
em uma conta comercial ou conta de anúncios, retornamos resultados, classificados por padrão, por nome do pixel em vez do horário de ativação do último pixel.
Novo nome do campo de estatísticas do pixel - nós renomeamos o campo timestamp
na borda de estatísticas do pixel para start_time
. Isso representa a hora de início quando começamos a agregar dados por hora nos acionamentos do pixel. Nós agora retornamos isso em formato ISO 8601 e incluímos o deslocamento de fuso horário. Isso corrige um problema em que retornamos carimbos de data e hora inválidos do Unix. Os pontos de extremidade a seguir serão afetados: GET {ads-pixel-id}/stats
.
Ponto de extremidade POST {pixel-id}/shared_agencies
obsoleto. Use a interface do usuário do Gerenciador de Negócios para compartilhar o pixel de anúncios com as agências.
POST {ad-id}/
,
POST {adset-id}/
,
POST act_{ad-account-id}
,
POST act_{ad-account-id}/ads
,
POST act_{ad-account-id}/adsets
O campo zipbytes
de POST act_{ad-account-id}/adimages
ficou obsoleto e a capacidade de carregar arquivos ZIP na borda foi removida. Use uma imagem com as extensões: jpg
, jpeg
, gif
, bmp
, png
, tiff
ou tif
.
O método atual para criar anúncios de coleção que usava uma chamada de API com todos os ativos obrigatórios como parâmetros ficou obsoleto. Em vez disso, você agora precisa criar um canvas primeiro e depois usar o link do canvas para criar o anúncio da coleção. Isso permite que você acesse o objeto do canvas subjacente para que você possa, por exemplo, redirecionar os públicos. Confira Anúncios de coleção.
O uso do formato do anúncio em carrossel ficou obsoleto para anúncios com o objetivo de Engajamento com a publicação da Página. Essa combinação não é mais válida. Confira Validação, objetivos e criativos.
is_autobid
e is_average_price_pacing
dos pontos de extremidade: POST {ad-account-id}/adsets
e POST {adset-id}
. Em vez disso, use o novo campo bid_strategy
para especificar uma estratégia de lance para o conjunto de anúncios. Para saber mais informações, consulte Lances e otimização.Campos obsoletos em delivery_estimate
para anúncios e contas de anúncios. Os resultados não atenderam às necessidades dos anunciantes. Além disso, muitos anunciantes têm metas comerciais que podem não ser completamente cumpridas pelo valor de lance sugerido pelo Facebook. Os campos e parâmetros obsoletos incluem:
Campo bid_estimate
,
Parâmetro currency
,
Parâmetro daily_budget
,
Parâmetro optimize_for
Recomendamos que você use o valor comercial verdadeiro e intrínseco que você obtém de anúncios do Facebook e faça um lance com base nisso. Se você ainda não sabe esse valor, sugerimos que você use o lance automático. Para obter informações de histórico, consulte a Central de Ajuda de anúncios, Leilão de anúncios e Compra de anúncios e otimização.
Resultado retornado obsoleto do campo curve_budget_reach
em GET /{rf-prediction-id}
. Nós agora retornamos mapas, e o valor de retorno de cadeia de caracteres serializada JSON ficou obsoleto. Isso afeta: GET /{rf-prediction-id}
.
A borda GET /{ad-account-id}/ratecard
ficou obsoleta.
Vários campos obsoletos relacionados a cobrança em /ad_accounts
. Isso inclui:
next_bill_date
active_billing_date_preference
pending_billing_date_preference
active_asl_schedule
salesforce_invoice_group_id
transactions
adspaymentcycle
show_checkout_experience
pixel_id
e external_event_source
obsoletos GET /customaudience
.matched_unique_users
obsoleto em OFFLINE_EVENT_SET_ID
retornado por GET /{data-set-id}
e GET /{data-set-upload-id}
. Confira API de conversões offline.
A borda attributed_events
e o campo attribute_stats
na GET /{data_set_id} API
ficaram obsoletos. Use a API GET /{data_set_id}/stats
para obter estatísticas de eventos com atributos.
O campo matched_unique_users
ficou obsoleto no OFFLINE_EVENT_SET_ID
retornado por GET /{data-set-id}
e GET /{data-set-upload-id}
.
Valores de retorno padrão obsoletos em GET {data_set_upload_id}
. Isso não retorna mais estes campos por padrão: first_upload_time
, last_upload_time
, api_calls
, valid_entries
, matched_entries
, duplicate_entries
, event_time_min
, event_time_max
, event_stats
e matched_unique_users
.
Valores de retorno padrão obsoletos em GET {data_set_id}/stats
. Isso agora só retorna estatísticas de contagem por padrão. Para especificar quais estatísticas devem ser retornadas, use o parâmetro fields
ou o summary
para estatísticas cumulativas como average_upload_delay
.
Valores de retorno padrão obsoletos para GET {data_set_id}
. Isso não retorna mais estes campos por padrão: attribute_stats
, duplicate_entries
, event_stats
, event_time_max
, event_time_min
, matched_entries
, matched_unique_users
, usage
e valid_entries
.
A borda GET {data-set-upload-id}/stats
ficou obsoleta. Use os campos valid_entries
ou matched_entries
de GET {data-set-upload-id}
em vez disso.
A API de Informações canvas_component_avg_pct_view
ficou obsoleta.