Versão 3.0

API de Marketing

Lançado em 1º de maio de 2018 | Disponível até 1º de fevereiro de 2019 | Publicação de blog

• Novos recursos
• Alterações disruptivas
• Itens que se tornaram obsoletos
• Itens que já se tornaram obsoletos

Novos recursos

Estratégia de lance de menor custo, Campo 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.

Anúncios de coleção, criação

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.

Alterações disruptivas

Gerenciamento de anúncios

• 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.

Públicos e direcionamento de anúncios

• 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:

  • Públicos Personalizados do seu site, regras do público,

  • Públicos Personalizados de seu aplicativo móvel, regras do público,

  • Públicos personalizados de engajamento com a página,

  • Públicos de envolvimento para Anúncios de Cadastro,

  • Públicos de envolvimento para o canvas e

  • Públicos personalizados de conversões offline.

Anúncios Dinâmicos

• 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.

Informações e mensuração 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.

Itens que se tornaram obsoletos

Gerenciador de Negócios

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.

Gerenciamento de anúncios

• kpi_custom_conversion_id, kpi_type e kpi_results de /{ad_campaign_id} e /ad_account_ID/campaigns.

• O sinal `redownload` ficou obsoleto a partir dos seguintes pontos de extremidade para simplificar a API:

  • POST {ad-id}/,

  • POST {adset-id}/,

  • POST act_{ad-account-id},

  • POST act_{ad-account-id}/ads,

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

  Você ainda pode ler essas informações com o parâmetro `fields`.

• 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.

Compra e lances de anúncios

• Os campos 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

• Campos pixel_id e external_event_source obsoletos GET /customaudience.

Informações e mensuração de anúncios

• 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.