Versão 2.9

Novos recursos da API de Marketing v2.9

Criativo do anúncio

Crie campanhas de Canvas no Facebook por meio da API de Marketing. Por meio do uso de imagem, áudio e movimento, o formato de vídeo permite que os anunciantes atinjam com eficácia os objetivos da marca e de resposta direta. Consulte API de Marketing, anúncios do Canvas.

Anúncios dinâmicos

• Qualidade do catálogo de Anúncios dinâmicos - estamos introduzindo novas APIs para ajudá-lo a veicular anúncios dinâmicos com sucesso: APIs de Verificação e Qualidade. Com a API de Verificação é possível verificar se sua pontuação de sinais fornece informações suficientes para veicular os anúncios adequados com os anúncios dinâmicos. Com a API de Qualidade é possível verificar e confirmar se o seu catálogo e o seu feed têm informações suficientes e com qualidade suficiente para veicular anúncios dinâmicos. Para mais informações, consulte Anúncios dinâmicos, Catálogo e Sinais de qualidade.

• Imagens múltiplas para um único item - exibe diversas imagens do mesmo item em anúncios dinâmicos no formato carrossel. Agora oferecemos suporte a até 20 imagens de um catálogo, para representar um único item no formato carrossel para os anúncios dinâmicos. Isto permite que você exiba um único item, como um hotel ou um destino, com diversas imagens. Para suportar isso, oferecemos novas opções: force_single_link = true e show_multiple_images = true. Para ver mais detalhes, consulte Anúncios dinâmicos, Gerenciamento de anúncios, Modelo criativo.

Gerenciamento de anúncios

• Texto do anúncio - agora é possível duplicar as campanhas atuais, os conjuntos de dados atuais e os anúncios atuais, por meio de nossa API de Texto do anúncio. Dessa forma não é preciso recriar os anúncios desde o início todas as vezes. Em vez disso, você pode duplicar os que funcionam e criar estruturas de modelo de anúncios. Consulte Criativo do anúncio, Posicionamento e Prévia.

• Alcance diário estimado - temos um novo ponto de extremidade /delivery_estimate na conta de anúncios e nos níveis do conjunto de anúncios. Esse ponto de extremidade permite o recebimento das estimativas de lances e uma previsão de resultado, com alcance e conversões diárias para um determinado conjunto de anúncios. Consulte Direcionamento, Alcance diário estimado.

• API do sistema de regras - use as APIs do sistema de regras para gerenciar seus anúncios com mais facilidade, eficiência e inteligência, com base nas regras de negócio que você definir. O sistema de regras utiliza um modelo baseado em push. Então, em vez de ter que consultar constantemente nossas APIs para receber informações atualizadas para os anúncios, enviamos de forma proativa as notificações push e realizamos as ações que você definir quando as condições da regra forem atendidas. Consulte mais detalhes sobre a API do sistema de regras aqui.

• API de Lote - Agrupe as solicitações e envie de forma assíncrona. Agrupe diversas chamadas à Graph API em uma solicitação HTTP e execute-as de forma assíncrona, sem a necessidade de bloqueio. Você pode também especificar dependências entre operações relacionadas. O Facebook processa cada operação independente em processos paralelos e suas operações dependentes de forma sequencial. Consulte Solicitações assíncronas e em lote, API de Lote.

Posicionamento do anúncio

• Posicionamento eficaz de anúncios - você pode definir os posicionamentos dos anúncios na especificação do direcionamento. Entretanto, você poderá não saber se o Facebook realmente veiculou seu anúncio em todos os posicionamentos. Se você tiver selecionado posicionamentos inválidos para um determinado objetivo, o Facebook não veiculou nesse posicionamento. Anteriormente, era preciso veicular os anúncios e fazer experimentos para determinar o resultado real. Com as APIs de posicionamento effective_ é possível determinar os posicionamentos de anúncios realmente veiculados pelo Facebook, para o posicionamento selecionado e um determinado objetivo de publicidade. Por meio da API de recomendações, é possível saber também por que alguns posicionamentos são filtrados. Consulte Direcionamento, avançado, posicionamento eficaz.

Alterações disruptivas da API de Marketing v2.9

Gerenciamento de anúncios

• Posicionamento Vídeo sugerido - este recurso fazia parte do posicionamento no Feed do Facebook. Você optou por esse posicionamento automaticamente se tiver usado o posicionamento no Feed. Na versão 2.9, separamos o posicionamento de vídeo sugerido do posicionamento de Feed, para que você possa optar por não usar o posicionamento de vídeo sugerido, mesmo se optar pelo posicionamento de Feed. Nas versões 2.8 e anteriores, se você tiver usado o posicionamento de Feed do Facebook, não mais veicularemos automaticamente seus anúncios para o vídeo sugerido se você optar pelo posicionamento do Feed.

• Objetivo Divulgação nas imediações - tornamos obsoleto o objetivo de campanha LOCAL_AWARENESS. Na versão 2.9 não aceitaremos LOCAL_AWARENESS como objetivo para criar novas campanhas. Gere divulgação nas imediações para conjuntos de anúncios de local único com campanhas REACH. LOCAL_AWARENESS para locais múltiplos não é mais aceito. Se você tiver campanhas existentes com esse objetivo, poderá lê-las ou editá-las e poderá criar novos conjuntos de anúncios e anúncios nas mesmas. Se você copiar campanhas de campanhas existentes, o tipo de campanha determinará se você poderá copiá-las. Com localização única LOCAL_AWARENESS copiamos com REACH especificado. Para LOCAL_AWARENESS e localizações múltiplas não é possível copiar a campanha.

• Objetivos de Anúncios móveis - para simplificar nossos objetivos de anúncios móveis, estamos tornando obsoletos CanvasAppEngagement, CanvasAppInstalls, MobileAppInstalls e MobileAppEngagement. São os conhecidos como CAE, MAE, CAI e MAI, respectivamente. A partir da versão 2.9, não é possível criar uma nova campanha com esses quatro objetivos. Em vez disso, há suporte para:

  • Conjuntos de anúncios CAE por campanhas LINK_CLICKS, é preciso usar LINK_CLICKS para criar campanhas para anúncios CAE.

  • No caso de conjuntos de anúncios MAE com campanhas de objetivos LINK_CLICKS ou CONVERSIONS, você deve alterar para LINK_CLICKS ou CONVERSIONS a fim de criar campanhas para anúncios MAE.

  • Conjuntos de anúncios CAI com APP_INSTALLS, você deve usar APP_INSTALLS para criar campanhas para anúncios CAI.

  • MAI com APP_INSTALLS, você deve usar APP_INSTALLS para criar campanhas para anúncios MAI.

• Objetivos de anúncios móveis, compatibilidade – se você duplicar campanhas CAE, MAE, CAI e MAI com a API de Marketing ou com as ferramentas do Facebook, traduziremos automaticamente esses objetivos obsoletos para seus equivalentes da 2.9:

  • Campanhas MAI ou CAI convertem para o objetivo APP_INSTALLS.

  • Campanhas CAE convertem para campanhas LINK_CLICKS.

  • Campanhas MAE convertem para campanhas LINK_LICKS ou CONVERSIONS com base nas otimizações que você fornecer para conjuntos de anúncios da campanha. Se houver quaisquer conjuntos de anúncios filhos otimizados para OFFSITE_CONVERSION, converteremos sua campanha MAE para uma campanha CONVERSIONS, do contrário, traduziremos sua campanha MAE para uma campanha LINK_CLICKS.

• Categorias bloqueadas - estamos tornando obsoletas algumas categorias de Audience Network, Vídeo In-stream e Instant Article, dando vez a categorias mais unificadas nesses posicionamentos. Essas categorias permitem que você impeça que os anúncios sejam exibidos com certos conteúdos questionáveis, tais como jogos de azar, álcool e outros. As categorias politics e religion estão obsoletas. As seguintes categorias estão disponíveis:

  • Para Instant Articles e Audience Network: debated_social_issues, mature_audiences, tragedy_and_conflict, dating, gambling.

  • Para Vídeos In-stream: debated_social_issues, mature_audiences, tragedy_and_conflict.

• SUPPLEMENTAL_MEDIA_ID está obsoleto nos criativos de anúncios, na conta de anúncios e nos níveis de anúncio. Não é mais possível ler esse campo.

• ACTION_SPEC está obsoleto nos criativos de anúncios. Era usado em histórias patrocinadas que não são mais suportadas.

• Os campos actor_image_hash, actor_image_url e actor_name do criativo de anúncio estão obsoletos nas versões 2.9 e 2.8. Eram usados com action_spec, que também está obsoleto.

• link_title e link_description em call_to_action dos criativos de anúncios estão obsoletos. Para definir títulos e descrições de um criativo de anúncio, use name e description em link_data, ou title e link_description em video_data.

• run_status=3 - era possível excluir o criativo de anúncio com esse campo e valor. Isso causava confusão, por isso renomeamos run_status como status, e mudamos o valor de Int para a cadeia de caracteres DELETED. Para excluir o criativo de anúncio, use status=DELETED.

• COVER_PHOTO_ID de GET nos pontos de extremidade {creative_id} e {ad_account_id}/adcreatives do criativo estão obsoletos. Era raramente usado e estava disponível somente para uso interno e limitado.

• image_url ou image_hash - agora você pode fornecer somente um desses em video_data para object_story_spec dos criativos do anúncio. Consulte Criativo de anúncio, referência.

• OBJECT_INSTAGRAM_ID de GET para pontos de extremidade do criativo está obsoleto, inclusive {creative_id} e AD_ACCOUNT_ID/adcreatives. O objetivo deste campo não é o uso externo.

• instagram_story_id foi usado para buscar os números de identificação de publicações no Instagram e no criativo de anúncio na versão 2.8 e nas anteriores. Se você usou esse campo quando forneceu o criativo de anúncio, geramos uma exceção, mas ignoramos esse parâmetro e retornamos os resultados com instagram_story_id. Se você usasse a resposta, receberia um erro. Para resolver este problema, renomeamos instagram_story_id como effective_instagram_story_id, e você não deve usar esse campo para fornecer criativo de anúncio.

• O tipo do retorno de spent, today_spent e yesterday_spent de todos os objetos de anúncio é agora String, não Integer. Isso afeta campanhas, conjuntos de anúncios e anúncios.

Anúncios dinâmicos

• Sem Conjuntos de produtos idênticos - não permitirmos mais conjuntos de produtos que sejam idênticos a outro conjunto de produtos do mesmo catálogo. Se você tentar criar um conjunto de produtos idêntico do mesmo catálogo, nossa API retornará um FacebookApiException com o código 10803 contendo o número de identificação do conjunto de produtos idêntico.

• quoted_fields em POST /{product_feed_id} obsoleto. Na versão v2.6 removemos quoted_fields em POST /{product_feed_id/product_feeds}. Como parte de uma limpeza adicional, estamos agora também tornando isso obsoleto.

• O ponto de extremidade POST {catalog-id}/batch agora retorna STRING como parte do constante aprimoramento dos catálogos de produtos dos anúncios dinâmicos.

• Falha nas atualizações de público - se você estiver usando anúncios dinâmicos e tentar atualizar um público para esses anúncios, sua solicitação falhará com um erro. Para fazer alterações, será preciso excluir o público associado aos seus anúncios dinâmicos e criar um novo. Consulte anúncios dinâmicos, públicos e Públicos Personalizados

• template_url_spec substitui template_url. Isso permite que você faça o acompanhamento dos cliques e coloque URLs de contexto específico, além das URLs do catálogo de produtos nos seus anúncios. Por exemplo, incluir as datas de check-in e check-out de alguém no seu anúncio. Consulte Anúncios dinâmicos, gerenciamento de anúncios.

Sinais e direcionamento

• Renomear para origens de eventos - anteriormente, quando você criava ou consultava conversões personalizadas, você usava campos identificados como pixel_id, pixel_rule e pixel_aggregation_rule. Como estamos adicionando compatibilidade com dados de conversa offline e dados de conversão personalizada de aplicativos, estamos trocando os rótulos dos campos para refletir o escopo mais abrangente. Agora esses campos são event_source_id, rule e aggregation_rule.

• Pixel de acompanhamento de conversões - este foi tornado obsoleto em 15 de fevereiro de 2017. Como parte disso, removemos todas as bordas e nós da criação, da atualização, da leitura ou da referência do pixel de rastreamento de conversão, de todas as versões do API.

• friends_of_connection associado aos números de identificação do evento está obsoleto como opção de direcionamento de anúncios. Isso significa que você não poderá direcionar os amigos das pessoas que aceitaram o seu convide de evento do Facebook.

• Suporte delivery_estimate - fizemos alterações de estimativa de alcance para suportar o delivery_estimate recém lançado:

  • Campo bid_estimations removido do ponto de extremidade /reach_estimates e movida toda a funcionalidade documentada para /delivery_estimate

  • /AD_ID/reachestimate se tornou obsoleto. Para acessar essas informações, use /ADSET_ID/delivery_estimate.

  • Foi removido o campo data.

Informações

• Obsolescências de date_preset – estamos tornando obsoletos diversos valores de date_preset, que estamos substituindo por novos valores. Os novos valores foram projetados para serem mais fáceis de usar e mais alinhados com as expectativas do anunciante, e não conterão mais dados do dia atual. Por exemplo, uma solicitação feita em 8 de fevereiro, usando o intervalo de datas predefinido "últimos 7 dias" resultará em um relatório abrangendo de 1 de fevereiro até às 23:59 de 7 de fevereiro, inclusive, e excluindo 8 de fevereiro. Estes valores estão obsoletos:

  • last_3_days, substituído por last_3d

  • last_7_days substituído por last_7d

  • last_14_days substituído por last_14d

  • last_28_days substituído por last_28d

  • last_30_days substituído por last_30d

  • last_90_days substituído por last_90d

  • last_week substituído por last_week_sun_sat e last_week_mon_sun

  • this_week substituído por this_week_sun_today e this_week_mon_today

  • last_3_months se tornou obsoleto.

  • Nas versões 2.8 e anteriores, aceitamos tanto esses novos valores como os antigos valores de datas predefinidos.

• Padrãodate_preset - se você fez uma consulta de Informações sem date_preset, usamos o valor padrão last_30_days que incluía a atividade de hoje a partir das 12 horas no fuso horário da conta de anúncios. Na versão 2.9 o valor padrão é last_30d. Isto inclui os 30 dias anteriores completos, terminando às 23:59 da noite anterior, no fuso horário da sua conta, e não incluindo hoje.

• video_complete_watched_actions está obsoleto. Fornecia as mesmas informações que video_30_sec_watched_actions.

• unique_impression e unique_social_impressions estão obsoletos. Use reach e social_reach como substitutos.

• newsfeed_clicks, newsfeed_impressions, newsfeed_avg_position, video_avg_sec_watched_actions, video_avg_pct_watched_actions são métricas desatualizadas que estão sendo tornadas obsoletas.

• As seguintes métricas estão se tornando obsoletas em action_type:: follow, gift_sale, video_play e vote.

• Agora click_to_play_video está acessível por meio do detalhamento action_video_type.

• O campo de detalhamento placement para dados de veiculação está obsoleto na API de Informações. Somente ["publisher_platform", "platform_position"] são aceitos na versão 2.9. Na versão 2.8 ainda oferecemos suporte para ["placement"] ou ["publisher_platform", "platform_position"] como detalhamentos.

• attribution_spec - no passado, eram utilizados dois campos separados para taxa de cliques e de visualização na janela de atribuição da API de Informações. Agora você deve usar attribution_spec para definir ambas. Ao definir attribution_spec, você substitui todas as configurações atuais. Se você tivesse definido a taxa de cliques e visualização, ao definir attribution_spec como event_type = CLICK_THROUGH, você remove somente a atribuição da taxa de visualizações.