The content on this page has been translated from English into another language using AI. The AI translated content may contain errors, omissions, or unintended meanings. Since AI translated language may be inaccurate or unclear, you may refer to the original source content in English for this page to review the intended guidance.

Version

Conjunto de anúncios, objeto promovido

Updated: 9 de abr de 2025

O objeto promovido por um conjunto de anúncios, como uma Página ou um app. A objective da campanha e a promoted_object do conjunto de anúncios fornecem a intenção para seus anúncios. Quando você cria conjuntos de anúncios para campanhas com determinados objetivos, promoted_object é obrigatório. Consulte Conjunto de anúncios, Como criar.

Requisitos

Você precisa ter permissões para os objetos promovidos, incluindo page_id, application_id e pixel_id.

Se você usar page_id, o criativo deverá promover page_id.

Se você usar pixel_id, será necessário fornecer custom_event_type.

Se você usar object_store_url, será necessário incluir application_id. Esta opção está disponível apenas no Gerenciador de Anúncios⁠.

object_store_url deve estar associada ao app. Você pode definir isso nas configurações do app.

O direcionamento de dispositivos móveis para o conjunto de anúncios deve corresponder às plataformas compatíveis com o app especificado.

O criativo do anúncio precisa ser vinculado à object_store_url especificada.

Limitações

Se você usar promoted_object:

promoted_object é imutável em muitos casos. É definida na criação e não pode ser alterada. Para promover um objeto diferente, crie um novo conjunto de anúncios. As exceções são:

Adicionar application_id ou product_catalog_id, caso ainda não tenha sido fornecido

Alteração de pixel_id, pixel_rule ou custom_event_type para um novo valor quando os seguintes objetivos e metas de otimização são definidos:

CONVERSIONS, PRODUCT_CATALOG_SALES

OFFSITE_CONVERSIONS

Não é possível definir promoted_object para conjuntos de anúncios existentes. Você deve criar um novo conjunto de anúncios, exceto pelas exceções acima.

Se promoted_object for especificada, o Facebook deduz automaticamente conversion_specs para os objetivos definidos. Não é possível configurar manualmente conversion_specs; ignoramos qualquer valor que você transmitir.

É possível atualizar todos os campos de anúncios existentes em um conjunto de anúncios antigo sem um conjunto promoted_object.

Leitura

O objeto promovido descreve o objeto que um conjunto de anúncios está promovendo, como a Página em uma campanha de curtidas na Página. É uma forma generalizada de especificar uma ampla gama de objetos relacionados aos objetivos de publicidade.<br><br> Juntos, o objetivo da campanha e o promoted_object do conjunto de anúncios devem ser suficientes para responder à pergunta: “Sobre o que é este conjunto de anúncios/campanha?” Por exemplo, "Esta campanha tem como objetivo obter mais curtidas na minha Página X" ou "Este conjunto de anúncios está gerando instalações do meu app Y".

Parâmetros

Este ponto de extremidade não tem parâmetros.

Campos

Campo	Descrição
`application_id` string numérica	O ID de um app do Facebook. Normalmente, estão relacionados com jogos para dispositivos móveis ou canvas que são promovidos no Facebook para instalações ou engajamento. padrão
`boosted_product_set_id` string numérica	Combinado com "product_set_id" para promover um conjunto de produtos específico, incluindo outros produtos do catálogo de produtos em anúncios. Use a identificação do conjunto de produtos "Todos os produtos" no campo "product_set_id" e a identificação do conjunto de produtos específico no campo "boosted_product_set_id". Isso garantirá que os produtos do conjunto sejam exibidos com mais frequência em comparação a outros produtos do catálogo. padrão
`conversion_goal_id` string numérica	O ID da meta de conversão usado para gerar especificações de conversão e de rastreamento. padrão
`custom_conversion_id` string numérica	A identificação de uma conversão personalizada. padrão
`custom_event_str` string	O evento de um app para celular que não está na lista de eventos padrão. padrão
`custom_event_type` enum {AD_IMPRESSION, RATE, TUTORIAL_COMPLETION, CONTACT, CUSTOMIZE_PRODUCT, DONATE, FIND_LOCATION, SCHEDULE, START_TRIAL, SUBMIT_APPLICATION, SUBSCRIBE, ADD_TO_CART, ADD_TO_WISHLIST, INITIATED_CHECKOUT, ADD_PAYMENT_INFO, PURCHASE, LEAD, COMPLETE_REGISTRATION, CONTENT_VIEW, SEARCH, SERVICE_BOOKING_REQUEST, MESSAGING_CONVERSATION_STARTED_7D, LEVEL_ACHIEVED, ACHIEVEMENT_UNLOCKED, SPENT_CREDITS, LISTING_INTERACTION, D2_RETENTION, D7_RETENTION, OTHER}	O evento de um app para celular (Purchase, Lead ou CompleteRegistration) com origem nos dados de conversão offline ou `tag` de um pixel de conversão . padrão
`event_id` string numérica	O ID de um evento do Facebook. padrão
`lead_ads_custom_event_str` string	lead_ads_custom_event_str padrão
`lead_ads_custom_event_type` enum {AD_IMPRESSION, RATE, TUTORIAL_COMPLETION, CONTACT, CUSTOMIZE_PRODUCT, DONATE, FIND_LOCATION, SCHEDULE, START_TRIAL, SUBMIT_APPLICATION, SUBSCRIBE, ADD_TO_CART, ADD_TO_WISHLIST, INITIATED_CHECKOUT, ADD_PAYMENT_INFO, PURCHASE, LEAD, COMPLETE_REGISTRATION, CONTENT_VIEW, SEARCH, SERVICE_BOOKING_REQUEST, MESSAGING_CONVERSATION_STARTED_7D, LEVEL_ACHIEVED, ACHIEVEMENT_UNLOCKED, SPENT_CREDITS, LISTING_INTERACTION, D2_RETENTION, D7_RETENTION, OTHER}	lead_ads_custom_event_type padrão
`lead_ads_form_event_source_type` enumeração	lead_ads_form_event_source_type padrão
`lead_ads_offsite_conversion_type` enumeração	lead_ads_offsite_conversion_type padrão
`mcme_conversion_id` string numérica	mcme_conversion_id padrão
`object_store_url` string	O URI da loja móvel/digital onde um app pode ser comprado/baixado. Isso é específico da plataforma. Quando combinado com o "application_id", especifica de modo exclusivo um objeto que pode ser o assunto de uma campanha de publicidade do Facebook. padrão
`offer_id` string numérica	A identificação de uma oferta em uma Página do Facebook. padrão
`offline_conversion_data_set_id` string numérica	A identificação do conjunto de dados offline. padrão
`offsite_conversion_event_id` numeric string	offsite_conversion_event_id padrão
`page_id` string numérica	A identificação de uma Página do Facebook. padrão
`pixel_aggregation_rule` string	Uma regra JSON que decidirá se uma ação de um pixel corresponde à especificação desse objeto promovido com base nos resultados agregados de disparos de pixel anteriores. padrão
`pixel_id` string numérica	A identificação de um pixel de conversão do Facebook. Usado com campanhas de conversão fora do site. padrão
`pixel_rule` string	Uma regra JSON que decidirá se uma ação de um pixel corresponderá a essa especificação de objeto promovido. padrão
`place_page_set_id` string numérica	A identificação de um conjunto de Páginas de local para anúncios locais dinâmicos. padrão
`product_catalog_id` string numérica	A identificação de um catálogo de produtos. Usado com anúncios de produtos dinâmicos. padrão
`product_set_id` string numérica	A identificação de um conjunto de produtos dentro de um catálogo de produtos no nível do conjunto de anúncios. Usado com anúncios de produtos dinâmicos. padrão
`product_set_optimization` enumeração	product_set_optimization padrão
`retention_days` string	Valor do período de retenção para a regra baseada em agregação do objeto promovido. padrão
`value_semantic_type` enumeração	A semântica do valor do evento a ser usado para otimização. padrão
`variation` enumeração	variation padrão
`whats_app_business_phone_number_id` string numérica	O ID do número de telefone comercial do WhatsApp associado ao anúncio promovido. O tipo é WhatsAppBusinessAccountToNumberCurrentStatus. padrão
`whatsapp_phone_number` string numérica	O número de telefone do WhatsApp para o anúncio promovido. padrão

Criação

Ao criar conjuntos de anúncios em campanhas com determinados objetivos, você precisa fornecer promoted_object. Consulte Conjunto de anúncios, Como criar.

Não é possível executar essa operação no ponto de extremidade.

Atualização

Não é possível executar essa operação no ponto de extremidade.

Exclusão

Não é possível executar essa operação no ponto de extremidade.

Você achou esta página útil?