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

Conta de anúncios

Updated: 10 de mar de 2026

Representa uma empresa, pessoa ou outra entidade que cria e gerencia anúncios no Facebook. Várias pessoas podem gerenciar uma conta, e cada pessoa pode ter um ou mais níveis de acesso a uma conta, consulte API do Gerenciador de Negócios.

Em resposta à nova política da Apple, anunciamos alterações disruptivas que afetarão os pontos de extremidade da SDKAdNetwork, da API de Marketing e da API de Insights sobre Anúncios.

Para entender melhor como os requisitos do iOS 14.5 da Apple afetarão a publicidade no Facebook, acesse os artigos da Central de Ajuda para Empresas e o registro de alterações:

Atualizações do SDK do Facebook para iOS, da API de Eventos do App e dos Parceiros de Métricas para Aplicativos para os requisitos do iOS 14 da Apple⁠

Atualizações do pixel do Facebook para os requisitos do iOS 14 da Apple⁠

19 de janeiro de 2021 – Alterações disruptivas

O campo agency_client_declaration exige privilegios de administrador⁠ para todas as operações a partir da versão 10.0 e será obrigatório para todas as versões a partir de 25 de maio de 2021.

Volume de anúncios

Veja o volume de anúncios em veiculação ou em análise das suas contas de anúncios. Esses anúncios são contabilizados no limite de anúncios por página instituído no início de 2021. Consulte o número de anúncios em veiculação ou em análise de determinada conta de anúncios.

A aplicação do limite de anúncios por página começa quando uma página atinge a data de aplicação do limite de anúncios. A data de implementação pode ser consultada aqui.

Quando uma Página está no limite de anúncios:

Os novos anúncios (ou os anúncios programados para começar nesse momento) não são publicados com sucesso.

As ações em anúncios existentes serão limitadas a pausar e arquivar até que o número de anúncios em veiculação ou em análise fique abaixo do limite.

Para ver o volume de anúncios da sua conta:

curl -G
  -d "access_token=<access_token>"
  "https://graph.facebook.com/<API_VERSION>/act_<ad_account_ID>/ads_volume"

A resposta será semelhante a esta:

{"data":[{"ads_running_or_in_review_count":2}]}

Para obter informações sobre o gerenciamento do volume de anúncios, consulte Sobre o gerenciamento do volume de anúncios⁠.

Em veiculação ou em análise

Para ver se um anúncio está em veiculação ou em análise, verifique effective_status, configured_status e o status da conta de anúncios:

Se o effective_status de um anúncio for 1 - active, isso significa que o estado dele é em veiculação ou em análise.

Se o configured_status de um anúncio for active e o effective_status for 9 - pending review, ou 17 - pending processing, isso significa que o anúncio está em veiculação ou em análise.

O anúncio só poderá estar em veiculação ou em análise se o status da conta de anúncios for 1 - active, 8 - pending settlement, 9 - in grace period.

Também determinamos se um anúncio está em veiculação ou em análise com base na programação do conjunto de anúncios.

Se a hora de início for anterior à atual e a hora atual for anterior à hora de término, isso significa que o anúncio está em veiculação ou em análise.

Se a hora de início for anterior à atual e o conjunto de anúncios não tiver uma hora de término, isso também significa que o anúncio está em veiculação ou em análise.

Por exemplo, se a veiculação do conjunto de anúncios estiver programada para o futuro, isso significa que os anúncios não estão em veiculação ou em análise. No entanto, se a veiculação do conjunto de anúncios estiver programada entre agora e três meses no futuro, isso significa que os anúncios estão em veiculação ou em análise.

Se você estiver usando recursos especiais de programação de anúncios (como divisão do dia), consideraremos o anúncio como em veiculação ou em análise durante o dia todo, não só na parte do dia em que o anúncio começou a ser veiculado.

Detalhamento por atores

Adicionamos o parâmetro show_breakdown_by_actor ao ponto de extremidade act_123/ads_volume para que você possa consultar informações relacionadas ao volume e aos limites de anúncios de cada página. Para obter mais detalhes, consulte Detalhamento por atores.

Limites

Limite	Valor
Número máximo de contas de anúncios por pessoa	25
Número máximo de pessoas com acesso por conta de anúncios	25
Número máximo de anúncios por conta de anúncios comum	6.000 anúncios não arquivados e não excluídos
Número máximo de anúncios por conta de anúncios em massa	50.000 anúncios não arquivados e não excluídos
Número máximo de anúncios arquivados por conta de anúncios	100 mil anúncios arquivados
Número máximo de conjuntos de anúncios por conta de anúncios comum	6.000 conjuntos de anúncios não arquivados e não excluídos
Número máximo de conjuntos de anúncios por conta de anúncios em massa	10 mil conjuntos de anúncios não arquivados e não excluídos
Número máximo de conjuntos de anúncios arquivados por conta de anúncios	100.000 conjuntos de anúncios arquivados
Número máximo de campanhas de anúncios por conta de anúncios comum	6 mil campanhas de anúncios não arquivadas e não excluídas
Número máximo de campanhas de anúncios por conta de anúncios em massa	10 mil campanhas de anúncios não arquivadas e não excluídas
Número máximo de campanhas de anúncios arquivadas por conta de anúncios	100.000 campanhas de anúncios arquivadas
Número máximo de imagens por conta de anúncios	Ilimitado

Leitura

Uma conta de anúncios é uma conta usada para gerenciar anúncios no Facebook.

Informações sobre o beneficiário/pagador salvas conforme a Lei dos Serviços Digitais

Use os seguintes exemplos de código para baixar as informações de beneficiário e pagador.

Android SDK

GraphRequest request = GraphRequest.newGraphPathRequest(
accessToken,
"/act_<AD_ACCOUNT_ID>",
new GraphRequest.Callback() {
@Override
public void onCompleted(GraphResponse response) {
// Insert your code here
}
});

Bundle parameters = new Bundle();
parameters.putString("fields", "default_dsa_payor,default_dsa_beneficiary");
request.setParameters(parameters);
request.executeAsync();
iOS SDK
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
initWithGraphPath:@"/act_<AD_ACCOUNT_ID>"
parameters:@{ @"fields": @"default_dsa_payor,default_dsa_beneficiary",}
HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection, id result, NSError *error) {
// Insert your code here
}];
Javascript SDK:
FB.api(
'/act_<AD_ACCOUNT_ID>',
'GET',
{"fields":"default_dsa_payor,default_dsa_beneficiary"},
function(response) {
// Insert your code here
}
);

cURL

curl -X GET \
"https://graph.facebook.com/v25.0/act_<AD_ACCOUNT_ID>?fields=default_dsa_payor%2Cdefault_dsa_beneficiary&access_token=<ACCESS_TOKEN>"

O valor de retorno está no formato JSON. Por exemplo:

{"default_dsa_payor":"payor2","default_dsa_beneficiary":"bene2","id":"act_426197654150180"}

Parâmetros

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

Campos

Campo	Descrição
`id` string	A string `act_{ad_account_id}`. padrão
`account_id` string numérica	A identificação da conta de anúncios. padrão
`account_status` unsigned int32	Status da conta: `1 = ACTIVE` `2 = DISABLED` `3 = UNSETTLED` `7 = PENDING_RISK_REVIEW` `8 = PENDING_SETTLEMENT` `9 = IN_GRACE_PERIOD` `100 = PENDING_CLOSURE` `101 = CLOSED` `201 = ANY_ACTIVE` `202 = ANY_CLOSED`
`ad_account_promotable_objects` AdAccountPromotableObjects	Campos de ordem de compra da solicitação de criação de conta de anúncios associados a esta conta.
`age` float	O tempo decorrido desde a criação da conta de anúncios, em dias.
`agency_client_declaration` AgencyClientDeclaration	Os detalhes da agência que anuncia em nome dessa conta de cliente, se aplicável. Exige privilégios de administrador⁠ do Gerenciador de Negócios.
`amount_spent` string numérica	Valor atual usado pela conta com relação a `spend_cap`. Ou o valor total na ausência de `spend_cap`. Consulte por que o valor usado é diferente no limite de gastos da conta de anúncios⁠ para obter mais informações.
`attribution_spec` lista<AttributionSpec>	Consulte o registro de alterações para saber mais.
`balance` string numérica	Valor devido da fatura para esta conta de anúncios.
`brand_safety_content_filter_levels` lista<string>	Níveis de filtro de conteúdo de segurança para marcas definidos para anúncios no conteúdo (vídeos in-stream do Facebook e anúncios no Facebook Reels) e Audience Network juntamente com anúncios de feed (Facebook Feed, feed do Instagram, feed do Facebook Reels e feed do Instagram Reels), se aplicável. Consulte Direcionamento de posicionamento para ver uma lista de valores compatíveis.
`business` Empresa	O Gerenciador de Negócios, caso a conta de anúncios seja de propriedade de um.
`business_city` string	Cidade do endereço comercial
`business_country_code` string	Código do país do endereço comercial
`business_name` string	O nome comercial da conta.
`business_state` string	Abreviação do estado para o endereço comercial
`business_street` string	Primeira linha do endereço comercial da conta.
`business_street2` string	Segunda linha do endereço comercial da conta.
`business_zip` string	Código postal do endereço comercial
`can_create_brand_lift_study` booliano	Se for possível criar um novo estudo de brand lift automatizado na conta de anúncios.
`capabilities` lista<string>	Lista dos recursos possíveis de uma conta de anúncios. Veja os recursos.
`created_time` datetime	O horário em que a conta foi criada, no formato ISO 8601.
`currency` string	A moeda usada na conta, com base no valor correspondente nas configurações. Consulte as moedas aceitas
`default_dsa_beneficiary` string	Este é o valor padrão para criar um objeto L2 de dsa_beneficiary.
`default_dsa_payor` string	Este é o valor padrão para criar um objeto L2 de dsa_payor.
`direct_deals_tos_accepted` booliano	Indica se os Termos de Serviço de DirectDeals foram aceitos.
`disable_reason` unsigned int32	O motivo pelo qual a conta foi desabilitada. Os motivos possíveis são: `0 = NONE` `1 = ADS_INTEGRITY_POLICY` `2 = ADS_IP_REVIEW` `3 = RISK_PAYMENT` `4 = GRAY_ACCOUNT_SHUT_DOWN` `5 = ADS_AFC_REVIEW` `6 = BUSINESS_INTEGRITY_RAR` `7 = PERMANENT_CLOSE` `8 = UNUSED_RESELLER_ACCOUNT` `9 = UNUSED_ACCOUNT` `10 = UMBRELLA_AD_ACCOUNT` `11 = BUSINESS_MANAGER_INTEGRITY_POLICY` `12 = MISREPRESENTED_AD_ACCOUNT` `13 = AOAB_DESHARE_LEGAL_ENTITY` `14 = CTX_THREAD_REVIEW` `15 = COMPROMISED_AD_ACCOUNT`
`end_advertiser` string numérica	A entidade para a qual os anúncios serão direcionados. Deve ser um alias de Página do Facebook, uma identificação de Página do Facebook ou um ID de app do Facebook.
`end_advertiser_name` string	O nome da entidade para a qual os anúncios serão direcionados.
`existing_customers` lista<string>	Identificações de público personalizado usadas pelos anunciantes para definir os clientes atuais. Essa definição é usada principalmente por anúncios de compras automatizados.
`expired_funding_source_details` FundingSourceDetails	`ID` = identificação da forma de pagamento `COUPON` = Detalhes do cupom de anúncios do Facebook da forma de pagamento `COUPONS` = lista de cupons de anúncios ativos do Facebook na conta de anúncios `COUPON_ID` = ID do cupom de anúncios do Facebook `AMOUNT` = valor do cupom de anúncios do Facebook `CURRENCY` = Moeda do cupom de anúncios do Facebook `DISPLAY_AMOUNT` = como o valor do cupom de anúncios do Facebook é exibido `EXPIRATION` = quando o cupom expirou `START_DATE` = quando o cupom foi iniciado `DISPLAY_STRING` = como a forma de pagamento é exibida `CAMPAIGN_IDS` = lista de campanhas às quais o cupom pode ser aplicado, ficará vazio se o cupom for aplicado no nível da conta de anúncios. `ORIGINAL_AMOUNT` = Valor do cupom de anúncios do Facebook quando emitido `ORIGINAL_DISPLAY_AMOUNT` = como o cupom de anúncios do Facebook é exibido quando emitido `TYPE` = tipo de forma de pagamento `0 = UNSET` `1 = CREDIT_CARD` `2 = FACEBOOK_WALLET` `3 = FACEBOOK_PAID_CREDIT` `4 = FACEBOOK_EXTENDED_CREDIT` `5 = ORDER` `6 = INVOICE` `7 = FACEBOOK_TOKEN` `8 = EXTERNAL_FUNDING` `9 = FEE` `10 = FX` `11 = DISCOUNT` `12 = PAYPAL_TOKEN` `13 = PAYPAL_BILLING_AGREEMENT` `14 = FS_NULL` `15 = EXTERNAL_DEPOSIT` `16 = TAX` `17 = DIRECT_DEBIT` `18 = DUMMY` `19 = ALTPAY` `20 = STORED_BALANCE` Para acessar esse campo, o usuário responsável pela chamada de API precisa ter uma permissão de tarefa `MANAGE` para a conta de anúncios em questão. Consulte Ad Account, Assigned Users para saber mais.
`extended_credit_invoice_group` ExtendedCreditInvoiceGroup	O grupo de fatura de crédito estendido ao qual a conta de anúncios pertence.
`failed_delivery_checks` lista<DeliveryCheck>	Falha nas verificações de veiculação
`fb_entity` unsigned int32	fb_entity
`funding_source` string numérica	Identificação da forma de pagamento. Se a conta não tiver uma forma de pagamento, ainda será possível criar anúncios, mas eles não serão veiculados. Não é disponibilizado se a conta estiver desabilitada.
`funding_source_details` FundingSourceDetails	`ID` = identificação da forma de pagamento `COUPON` = Detalhes do cupom de anúncios do Facebook da forma de pagamento `COUPONS` = lista de cupons de anúncios ativos do Facebook na conta de anúncios `COUPON_ID` = ID do cupom de anúncios do Facebook `AMOUNT` = valor do cupom de anúncios do Facebook `CURRENCY` = Moeda do cupom de anúncios do Facebook `DISPLAY_AMOUNT` = como o valor do cupom de anúncios do Facebook é exibido `EXPIRATION` = quando o cupom expirará `START_DATE` = quando o cupom inicia `DISPLAY_STRING` = como a forma de pagamento é exibida `CAMPAIGN_IDS` = lista de campanhas às quais o cupom pode ser aplicado, ficará vazio se o cupom for aplicado no nível da conta de anúncios. `ORIGINAL_AMOUNT` = Valor do cupom de anúncios do Facebook quando emitido `ORIGINAL_DISPLAY_AMOUNT` = como o cupom de anúncios do Facebook é exibido quando emitido `TYPE` = tipo de forma de pagamento `0 = UNSET` `1 = CREDIT_CARD` `2 = FACEBOOK_WALLET` `3 = FACEBOOK_PAID_CREDIT` `4 = FACEBOOK_EXTENDED_CREDIT` `5 = ORDER` `6 = INVOICE` `7 = FACEBOOK_TOKEN` `8 = EXTERNAL_FUNDING` `9 = FEE` `10 = FX` `11 = DISCOUNT` `12 = PAYPAL_TOKEN` `13 = PAYPAL_BILLING_AGREEMENT` `14 = FS_NULL` `15 = EXTERNAL_DEPOSIT` `16 = TAX` `17 = DIRECT_DEBIT` `18 = DUMMY` `19 = ALTPAY` `20 = STORED_BALANCE` Para acessar esse campo, o usuário responsável pela chamada de API precisa ter uma permissão de tarefa `MANAGE` para a conta de anúncios em questão. Consulte Ad Account, Assigned Users para saber mais.
`has_migrated_permissions` booliano	Indica se a conta tem permissões migradas.
`has_page_authorized_adaccount` booliano	Indica se a Página do Facebook autorizou a conta de anúncios para veicular anúncios com conteúdo político. Caso você tente publicar um anúncio com conteúdo político usando a conta de anúncios para esta página, e a página não tenha autorizado a conta para anúncios com conteúdo político, o anúncio será reprovado. Consulte Alterações disruptivas, API de Marketing, Anúncios com conteúdo político e Políticas de Publicidade do Facebook⁠.
`io_number` string numérica	O número do pedido de inserção (IO, pelas iniciais em inglês).
`is_attribution_spec_system_default` booliano	Se a especificação de atribuição da conta de anúncios for gerada a partir dos valores padrão do sistema
`is_direct_deals_enabled` booliano	Indica se a conta está habilitada para executar negociações diretas.
`is_in_3ds_authorization_enabled_market` booliano	Se a conta estiver em um mercado que exige autorização 3DS para realizar o processo de pagamento
`is_notifications_enabled` booliano	Obter o status de notificações do usuário para esta conta de anúncios. Isso retornará verdadeiro ou falso dependendo de as notificações estarem habilitadas ou não.
`is_personal` unsigned int32	Indica se essa conta de anúncios está sendo usada para fins privados e não comerciais. Isso afeta a forma como o imposto sobre valor agregado (IVA) é calculado. Observação: isso não tem relação com o vínculo entre uma conta de anúncios e uma empresa.
`is_prepay_account` booliano	Indica se a conta de anúncios é pré-paga. A outra opção seria uma conta pós-paga. Para acessar esse campo, o usuário responsável pela chamada de API precisa ter uma permissão de tarefa `ADVERTISE` ou `MANAGE` para a conta de anúncios em questão. Consulte Ad Account, Assigned Users para saber mais.
`is_tax_id_required` booliano	Indica se a identificação fiscal da conta de anúncios é necessária ou não. Para acessar esse campo, o usuário responsável pela chamada de API precisa ter uma permissão de tarefa `ADVERTISE` ou `MANAGE` para a conta de anúncios em questão. Consulte Ad Account, Assigned Users para saber mais.
`line_numbers` lista<integer>	Os números de linha
`media_agency` string numérica	A agência, que pode ser a própria empresa. Deve ser um alias de Página do Facebook, uma identificação de Página do Facebook ou um ID de app do Facebook. Caso não haja uma, é possível usar `NONE` ou `UNFOUND`.
`min_campaign_group_spend_cap` string numérica	O limite mínimo de gastos exigido para a campanha de anúncios.
`min_daily_budget` unsigned int32	O orçamento diário mínimo para esta conta de anúncios.
`name` string	Nome da conta. Caso não seja definido, o nome do primeiro administrador visível ao usuário será retornado.
`offsite_clo_signal_status` int32	offsite_clo_signal_status
`offsite_pixels_tos_accepted` booliano	Indica se o contrato de Termos de Serviço do pixel externo foi assinado. Este recurso pode ser acessado antes da versão 2.9.
`opportunity_score` float	Em uma escala de 0 a 100, essa pontuação representa o nível de otimização das campanhas, conjuntos de anúncios e anúncios da conta de anúncios no geral. Consulte Pontuação de oportunidade⁠ para saber mais.
`owner` string numérica	A identificação do proprietário da conta.
`partner` string numérica	Pode ser o Parceiro de Marketing do Facebook, se houver. Deve ser um alias de Página do Facebook, uma identificação de Página do Facebook ou um ID de app do Facebook. Caso não haja uma, é possível usar `NONE` ou `UNFOUND`.
`rf_spec` ReachFrequencySpec	Configuração de limites de alcance e frequência. Consulte alcance e frequência
`show_checkout_experience` booliano	Se a experiência de finalização da compra pré-paga será exibida para um anunciante. Se `true`, o anunciante está qualificado para finalização da compra ou já está inscrito na finalização da compra e não foi promovido para o pós-pagamento.
`spend_cap` string numérica	O valor máximo que pode ser gasto por essa conta de anúncios. Quando o valor for atingido, toda a veiculação será interrompida. Um valor de `0` significa que não há limite de gastos. Ao definir um novo limite de gastos, você irá gastar o tempo no momento em que o limite for definido. Valor especificado na unidade básica da moeda, por exemplo "centavos" para `USD`.
`tax_id` string	Número de identificação fiscal
`tax_id_status` unsigned int32	Código de status de IVA da conta. `0`: desconhecido `1`: IVA não necessário – EUA/Canadá `2`: informações de IVA necessárias `3`: informações sobre o IVA enviadas `4`: falha na validação do IVA offline `5`: a conta é pessoal.
`tax_id_type` string	Tipo de identificação fiscal
`timezone_id` unsigned int32	A identificação do fuso horário da conta de anúncios.
`timezone_name` string	Nome do fuso horário.
`timezone_offset_hours_utc` float	Diferença de fuso horário em relação ao UTC (Horário Coordenado Universal).
`tos_accepted` map<string, int32>	Verifica se a conta de anúncios específica assinou os contratos dos Termos de Serviço. Retorna `1` se os termos forem aceitos.
`user_tasks` lista<string>	user_tasks
`user_tos_accepted` map<string, int32>	Verifica se um usuário assinou os contratos de Termos de Serviço relacionados à empresa que contém uma conta de anúncios específica. É necessário incluir o token de acesso do usuário para obter informações. Essa verificação não é válida para usuários do sistema.

Bordas

Borda	Descrição
`account_controls` Borda<AdAccountBusinessConstraints>	Os controles de conta são para campanhas de compras Advantage+ em que os anunciantes podem definir controles de público para idade mínima e localização geográfica excluída.
`activities` Borda<AdActivity>	As atividades da conta de anúncios.
`adcreatives` Borda<AdCreative>	Os criativos do anúncio dessa conta de anúncios.
`ads_reporting_mmm_reports` Borda<AdsReportBuilderMMMReport>	Relatórios de marketing mix modeling (MMM) gerados para esta conta de anúncios.
`ads_reporting_mmm_schedulers` Borda<AdsReportBuilderMMMReportScheduler>	Obter todos os programadores de relatórios de MMM por conta de anúncios
`advertisable_applications` Borda<Application>	Todos os apps anunciáveis associados à conta.
`advideos` Borda<Video>	Os vídeos associados à conta.
`applications` Borda<Application>	Apps conectados às contas de anúncios
`asyncadcreatives` Borda<AdAsyncRequestSet>	As solicitações assíncronas de criação de criativos do anúncio associadas à conta de anúncios.
`broadtargetingcategories` Borda<BroadTargetingCategories>	É possível usar categorias de direcionamento amplo (BCTs, pelas iniciais em inglês) para direcionamento.
`connected_instagram_accounts` Borda<ShadowIGUser>	Contas do Instagram conectadas à conta de anúncios
`customaudiences` Borda<CustomAudience>	Os Públicos Personalizados que pertencem ou são compartilhados com essa conta de anúncios.
`customaudiencestos` Borda<CustomAudiencesTOS>	São os Termos de Serviço para públicos personalizados disponíveis para a conta de anúncios.
`customconversions` Borda<CustomConversion>	As conversões personalizadas que pertencem ou são compartilhadas com essa conta de anúncios.
`delivery_estimate` Borda<AdAccountDeliveryEstimate>	A estimativa de veiculação de uma determinada configuração de conjunto de anúncios para essa conta de anúncios.
`deprecatedtargetingadsets` Borda<AdCampaign>	Conjuntos de anúncios com opções de direcionamento que se tornaram obsoletas para esta conta de anúncios
`dsa_recommendations` Borda<AdAccountDsaRecommendations>	dsa_recommendations
`generatepreviews` Borda<AdPreview>	Gerar prévias para uma especificação de criativo
`impacting_ad_studies` Borda<AdStudy>	Os estudos de anúncio que contêm essa conta de anúncios ou qualquer um dos objetos de anúncio descendentes.
`instagram_accounts` Borda<ShadowIGUser>	Contas do Instagram conectadas às contas de anúncios
`mcmeconversions` Borda<AdsMcmeConversion>	mcmeconversions
`minimum_budgets` Borda<MinimumBudget>	Retorna valores mínimos do orçamento diário por moeda.
`promote_pages` Borda<Page>	Todas as Páginas que foram promovidas na conta de anúncios.
`reachestimate` Borda<AdAccountReachEstimate>	A estimativa de alcance de uma determinada especificação de direcionamento para esta conta de anúncios.
`saved_audiences` Borda<SavedAudience>	Os públicos salvos na conta.
`targetingbrowse` Borda<AdAccountTargetingUnified>	Navegação unificada
`targetingsearch` Borda<AdAccountTargetingUnified>	Pesquisa unificada
`targetingsuggestions` Borda<AdAccountTargetingUnified>	Sugestões unificadas
`targetingvalidation` Borda<AdAccountTargetingUnified>	Validação unificada

Códigos de erro

Código de erro	Descrição
200	Erro de permissões
613	As chamadas para esta API ultrapassaram o limite de volume.
100	Parâmetro inválido
190	Token de acesso OAuth 2.0 inválido
80004	Houve muitas chamadas para esta conta de anúncios. Espere um pouco e tente de novo. Para obter mais informações, consulte /docs/graph-api/overview/rate-limiting#ads-management.
3018	A data de início do período não pode ultrapassar 37 meses a partir da data atual.
2.500	Erro ao analisar a consulta da Graph API.
1150	Ocorreu um erro desconhecido.
2635	Você está chamando uma versão obsoleta da API de Anúncios. Atualize para a versão mais recente.
368	A ação tentada foi considerada abusiva ou não é permitida.

Criação

Para criar uma nova conta de anúncios para sua empresa, especifique name, currency, timezone_id, end_advertiser, media_agency e partner. Forneça end_advertiser, media_agency e partner:

Eles devem ser aliases de Páginas do Facebook ou identificações de Páginas ou apps do Facebook. Por exemplo, para fornecer sua empresa como anunciante final, especifique "minha empresa" ou 20531316728.

A identificação do anunciante final é a identificação da Página principal ou a identificação do app do Facebook. Para obter mais referências sobre este campo (para formatação e valores aceitáveis), acesse aqui.

Caso sua conta de anúncios não tenha um anunciante final, uma agência de mídia nem um parceiro, especifique NONE.

Se a conta de anúncios tiver um anunciante final, uma agência de mídia ou um parceiro que não estejam representados no Facebook por uma Página ou um app, especifique UNFOUND.

Depois de definir end_advertiser como um valor diferente de NONE ou UNFOUND, não é possível alterá-lo.

Criar uma conta de anúncios:

curl \
-F "name=MyAdAccount" \
-F "currency=USD" \
-F "timezone_id=1" \
-F "end_advertiser=<END_ADVERTISER_ID>" \
-F "media_agency=<MEDIA_AGENCY_ID>" \
-F "partner=NONE" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/adaccount"

Se você tiver uma linha de crédito estendido com o Facebook, será possível definir invoice como true, e associaremos sua nova conta de anúncios a essa linha de crédito.

A resposta:

{
"id": "act_<ADACCOUNT_ID>",
"account_id": "<ADACCOUNT_ID>",
"business_id": "<BUSINESS_ID>",
"end_advertiser_id": "<END_ADVERTISER_ID>",
"media_agency_id": "<MEDIA_AGENCY_ID>",
"partner_id": "NONE"
}

/act_{ad_account_id}/product_audiences

É possível fazer uma solicitação POST à borda product_audiences a partir dos seguintes caminhos:

/act_{ad_account_id}/product_audiences

Ao publicar nessa borda, uma AdAccount será criada.

Exemplo

Selecionar idioma

POST /v25.0/act_<AD_ACCOUNT_ID>/product_audiences HTTP/1.1
Host: graph.facebook.com

name=Test+Iphone+Product+Audience&product_set_id=%3CPRODUCT_SET_ID%3E&inclusions=%5B%7B%22retention_seconds%22%3A86400%2C%22rule%22%3A%7B%22and%22%3A%5B%7B%22event%22%3A%7B%22eq%22%3A%22AddToCart%22%7D%7D%2C%7B%22userAgent%22%3A%7B%22i_contains%22%3A%22iPhone%22%7D%7D%5D%7D%7D%5D&exclusions=%5B%7B%22retention_seconds%22%3A172800%2C%22rule%22%3A%7B%22event%22%3A%7B%22eq%22%3A%22Purchase%22%7D%7D%7D%5D

Teste no Explorador da Graph API

Para saber como usar a Graph API, leia nosso guia Como usar a Graph API

Parâmetros

Parâmetro	Descrição
`associated_audience_id` int64	SELF_EXPLANATORY
`creation_params` dicionário { string : <string> }	SELF_EXPLANATORY
`description` string	SELF_EXPLANATORY
`enable_fetch_or_create` booleano	enable_fetch_or_create
`event_sources` matriz<JSON object>	event_sources `id`int64 id obrigatório `type`enum {APP, OFFLINE_EVENTS, PAGE, PIXEL} type obrigatório Show child parameters
`exclusions` lista<Object>	SELF_EXPLANATORY `booking_window`Objeto `min_seconds`int64 `max_seconds`int64 Show child parameters `count`Objeto `event`string `type`enum {CUSTOM, PRIMARY, WEBSITE, APP, OFFLINE_CONVERSION, CLAIM, MANAGED, PARTNER, VIDEO, LOOKALIKE, ENGAGEMENT, BAG_OF_ACCOUNTS, STUDY_RULE_AUDIENCE, FOX, MEASUREMENT, REGULATED_CATEGORIES_AUDIENCE, BIDDING, EXCLUSION, MESSENGER_SUBSCRIBER_LIST} `retention`Objeto `min_seconds`inteiro obrigatório `max_seconds`inteiro obrigatório Show child parameters `retention_days`int64 `retention_seconds`inteiro `rule`Objeto `pixel_id`int64 Show child parameters
`inclusions` lista<Object>	SELF_EXPLANATORY `booking_window`Objeto `min_seconds`int64 `max_seconds`int64 Show child parameters `count`Objeto `event`string `type`enum {CUSTOM, PRIMARY, WEBSITE, APP, OFFLINE_CONVERSION, CLAIM, MANAGED, PARTNER, VIDEO, LOOKALIKE, ENGAGEMENT, BAG_OF_ACCOUNTS, STUDY_RULE_AUDIENCE, FOX, MEASUREMENT, REGULATED_CATEGORIES_AUDIENCE, BIDDING, EXCLUSION, MESSENGER_SUBSCRIBER_LIST} `retention`Objeto `min_seconds`inteiro obrigatório `max_seconds`inteiro obrigatório Show child parameters `retention_days`int64 `retention_seconds`inteiro `rule`Objeto `pixel_id`int64 Show child parameters
`name` string	SELF_EXPLANATORY obrigatório
`opt_out_link` string	SELF_EXPLANATORY
`parent_audience_id` int64	SELF_EXPLANATORY
`product_set_id` string numérica ou número inteiro	SELF_EXPLANATORY obrigatório
`subtype` enum {CUSTOM, PRIMARY, WEBSITE, APP, OFFLINE_CONVERSION, CLAIM, MANAGED, PARTNER, VIDEO, LOOKALIKE, ENGAGEMENT, BAG_OF_ACCOUNTS, STUDY_RULE_AUDIENCE, FOX, MEASUREMENT, REGULATED_CATEGORIES_AUDIENCE, BIDDING, EXCLUSION, MESSENGER_SUBSCRIBER_LIST}	SELF_EXPLANATORY

Tipo de retorno

Este ponto de extremidade é compatível com read-after-write e lê o nó representado pelo id no tipo de retorno.

Struct  {
id: numeric string,
message: string,
}

Códigos de erro

Código de erro	Descrição
100	Parâmetro inválido
2654	Falha ao criar o público personalizado.

/{custom_audience_id}/ad_accounts

É possível fazer uma solicitação POST à borda ad_accounts a partir dos seguintes caminhos:

/{custom_audience_id}/ad_accounts

Ao publicar nessa borda, uma AdAccount será criada.

Parâmetros

Parâmetro	Descrição
`adaccounts` list<numeric string>	Matriz de identificações de novas contas de anúncios que receberão acesso ao público personalizado.
`permissions` string	`targeting` ou `targeting_and_insights`. Se `targeting`, a conta de anúncios do destinatário poderá direcionar o público nos anúncios. `targeting_and_insights` também permite que a conta do destinatário veja o público na ferramenta de insights sobre o público.
`relationship_type` matriz<string>	relationship_type
`replace` booleano	`true` ou `false`. Se `true`, a lista de `adaccounts` fornecida na chamada substituirá o conjunto existente de contas de anúncios com as quais esse público é compartilhado.

Tipo de retorno

Esse ponto de extremidade é compatível com read-after-write e lê o nó em que você fez um POST.

Struct  {
success: bool,
sharing_data:  List  [ Struct  {
ad_acct_id: string,
business_id: numeric string,
audience_share_status: string,
errors:  List  [string],
}],
}

Códigos de erro

Código de erro	Descrição
200	Erro de permissões

/{business_id}/adaccount

É possível fazer uma solicitação POST à borda adaccount a partir dos seguintes caminhos:

/{business_id}/adaccount

Ao publicar nessa borda, uma AdAccount será criada.

Parâmetros

Parâmetro	Descrição
`ad_account_created_from_bm_flag` booleano	ad_account_created_from_bm_flag
`currency` Código de moeda ISO 4217	A moeda usada na conta. obrigatório
`end_advertiser`	A entidade para a qual os anúncios serão direcionados. Deve ser um alias de Página do Facebook, uma identificação de Página do Facebook ou um ID de app do Facebook. Caso não haja uma, é possível usar `NONE` ou `UNFOUND`. Depois que um valor diferente de `NONE` ou `UNFOUND` for definido, não será mais possível modificá-lo. obrigatório
`funding_id` string numérica ou número inteiro	ID da forma de pagamento. Se a conta não tiver uma forma de pagamento, ainda será possível criar anúncios, mas eles não serão veiculados.
`invoice` booleano	Se o Gerenciador de Negócios tiver uma linha de crédito normal própria registrada no CRM do Facebook, ele vinculará a conta de anúncios a essa linha de crédito.
`invoice_group_id` string numérica	O ID do grupo de fatura no qual a conta de anúncios deve ser inscrita.
`invoicing_emails` matriz<string>	Emails para os quais as faturas serão enviadas.
`io` booleano	Se o canal corporativo for de vendas diretas.
`media_agency` string	A agência, que pode ser a própria empresa. Deve ser um alias de Página do Facebook, uma identificação de Página do Facebook ou um ID de app do Facebook. Caso não haja uma, é possível usar `NONE` ou `UNFOUND`. obrigatório
`name` string	O nome da conta de anúncios. obrigatório
`partner` string	O parceiro de publicidade da conta, se houver. Deve ser um alias de Página do Facebook, uma identificação de Página do Facebook ou um ID de app do Facebook. Caso não haja uma, é possível usar `NONE` ou `UNFOUND`. obrigatório
`po_number` string	Número da ordem de compra
`timezone_id` unsigned int32	ID do fuso horário. Veja aqui. obrigatório

Tipo de retorno

Este ponto de extremidade é compatível com read-after-write e lê o nó representado pelo id no tipo de retorno.

Struct  {
id: token with structure: AdAccount ID,
account_id: numeric string,
business_id: numeric string,
end_advertiser_id: string,
media_agency_id: string,
partner_id: string,
seer_ad_account_restricted_by_soft_desc_challenge: bool,
soft_desc_challenge_credential_id: string,
soft_desc_challenge_localized_auth_amount: int32,
}

Códigos de erro

Código de erro	Descrição
100	Parâmetro inválido
3979	No momento, você excedeu o número de contas de anúncios permitidas para seu Gerenciador de Negócios.
3980	No momento, uma ou mais das contas de anúncios no seu Gerenciador de Negócios estão com problemas ou em análise. Todas as suas contas devem ter a reputação em dia para que você possa criar novas contas de anúncios.
415	Autenticação de dois fatores necessária. O usuário precisa inserir um código de um gerador de códigos TOTP ou SMS para passar na autenticação de dois fatores. Isso poderia acontecer ao acessar um ativo protegido pela autenticação de dois fatores, como uma página que pertence a um Gerenciador de Negócios protegido por esse recurso.
3902	Ocorreu um problema técnico e sua nova conta de anúncios não foi criada. Tente novamente.
457	A sessão tem uma origem inválida.
190	Token de acesso OAuth 2.0 inválido
23007	Este cartão de crédito não pode ser definido como a forma de pagamento principal da conta, porque ela está configurada para ser cobrada após os anúncios terem sido veiculados. Essa configuração não pode ser alterada. Tente usar outro cartão ou forma de pagamento.

/{business_id}/owned_ad_accounts

É possível fazer uma solicitação POST à borda owned_ad_accounts a partir dos seguintes caminhos:

/{business_id}/owned_ad_accounts

Ao publicar nessa borda, uma AdAccount será criada.

Parâmetros

Parâmetro	Descrição
`adaccount_id` string	Identificação da conta de anúncios. obrigatório

Tipo de retorno

Esse ponto de extremidade é compatível com read-after-write e lê o nó em que você fez um POST.

Struct  {
access_status: string,
}

Códigos de erro

Código de erro	Descrição
3979	No momento, você excedeu o número de contas de anúncios permitidas para seu Gerenciador de Negócios.
3994	Contas pessoais que não têm histórico de atividade não são qualificadas para migração para um Gerenciador de Negócios. Em vez disso, crie uma conta de anúncios dentro do seu Gerenciador de Negócios.
100	Parâmetro inválido
3980	No momento, uma ou mais das contas de anúncios no seu Gerenciador de Negócios estão com problemas ou em análise. Todas as suas contas devem ter a reputação em dia para que você possa criar novas contas de anúncios.
415	Autenticação de dois fatores necessária. O usuário precisa inserir um código de um gerador de códigos TOTP ou SMS para passar na autenticação de dois fatores. Isso poderia acontecer ao acessar um ativo protegido pela autenticação de dois fatores, como uma página que pertence a um Gerenciador de Negócios protegido por esse recurso.
3936	Você já tentou reivindicar esta conta de anúncios. Você verá uma notificação se sua solicitação for aceita.
368	A ação tentada foi considerada abusiva ou não é permitida.
3944	Seu Gerenciador de Negócios já tem acesso a este objeto.

Atualização

Aviso:

Os valores default_dsa_payor e default_dsa_beneficiary podem ser definidos como ambos ou nenhum deles. A API não permite que apenas um deles exista no armazenamento de dados.

Para cancelar a definição dos valores, transmita duas strings vazias ao mesmo tempo. Assim, os valores serão cancelados no armazenamento de dados. Não é possível desfazer a definição de apenas um deles.

/act_{ad_account_id}

É possível atualizar uma AdAccount fazendo uma solicitação POST a /act_{ad_account_id}.

Parâmetros

Parâmetro	Descrição
`agency_client_declaration` dicionário { string : <string> }	Os detalhes da agência que anuncia em nome dessa conta de cliente, se aplicável. Exige privilégios de administrador⁠ do Gerenciador de Negócios.
`attribution_spec` lista<Object>	Consulte o registro de alterações para saber mais. `event_type`enum {CLICK_THROUGH, VIEW_THROUGH, ENGAGED_VIDEO_VIEW} obrigatório `window_days`int64 obrigatório Show child parameters
`business_info` dicionário { string : <string> }	Informações da empresa
`custom_audience_info` Objeto JSON	Informações sobre o público personalizado para anúncios de compras automatizados. `new_customer_tag`string Valor de rótulo para novos clientes no parâmetro de URL do tipo de público personalizado dos Anúncios Automatizados de Compras. `existing_customer_tag`string Valor de rótulo para cliente existente no parâmetro de URL do tipo de público personalizado dos Anúncios Automatizados de Compras. `audience_type_param_name`string nome do campo referente ao tipo de público no parâmetro de UTM do tipo de público personalizado de anúncios de compras automatizados. Show child parameters
`default_dsa_beneficiary` string	Este é o valor padrão para criar o direcionamento L2 do beneficiário da UE.
`default_dsa_payor` string	Este é o valor padrão para criar o direcionamento L2 do pagador na UE.
`end_advertiser` string	A entidade para a qual os anúncios serão direcionados. Deve ser um alias de Página do Facebook, uma identificação de Página do Facebook ou um ID de app do Facebook.
`is_notifications_enabled` booleano	Indica se as notificações estão habilitadas para a conta.
`media_agency` string	O ID de uma página ou app do Facebook. Depois de definido para qualquer valor que não seja `NONE` ou `UNFOUND`, ele não poderá mais ser modificado.
`name` string	O nome da conta de anúncios.
`partner` string	O ID de uma página ou app do Facebook. Depois de definido para qualquer valor que não seja `NONE` ou `UNFOUND`, ele não poderá mais ser modificado.
`spend_cap` float	O valor total que a conta pode gastar. Depois disso, todas as campanhas serão pausadas, com base em `amount_spent`. Um valor de 0 significa que não há limite de gastos, e a configuração de um novo limite de gastos só será aplicada aos gastos feitos DEPOIS da configuração. Valor especificado na denominação padrão da moeda. Por exemplo, 23.50 para US$ 23,50.
`spend_cap_action` string	Ao definir este parâmetro como `reset`, a `amount_spent` será definida de volta para 0. Ao definir como `delete`, a `spend_cap` será removida da conta.

Tipo de retorno

Esse ponto de extremidade é compatível com read-after-write e lê o nó em que você fez um POST.

Struct  {
success: bool,
}

Códigos de erro

Código de erro	Descrição
100	Parâmetro inválido
200	Erro de permissões
368	A ação tentada foi considerada abusiva ou não é permitida.
190	Token de acesso OAuth 2.0 inválido
80004	Houve muitas chamadas para esta conta de anúncios. Espere um pouco e tente de novo. Para obter mais informações, consulte /docs/graph-api/overview/rate-limiting#ads-management.

/act_{ad_account_id}/assigned_users

É possível atualizar uma AdAccount fazendo uma solicitação POST a /act_{ad_account_id}/assigned_users.

Parâmetros

Parâmetro	Descrição
`tasks` array<enum {MANAGE, ADVERTISE, ANALYZE, DRAFT, AA_ANALYZE}>	Tarefas de permissão da conta de anúncios a serem atribuídas ao usuário.
`user` UID	Número de identificação do usuário comercial ou número de identificação do usuário do sistema obrigatório

Tipo de retorno

Esse ponto de extremidade é compatível com read-after-write e lê o nó em que você fez um POST.

Struct  {
success: bool,
}

Códigos de erro

Código de erro	Descrição
100	Parâmetro inválido
200	Erro de permissões
2620	Chamada inválida para atualizar as permissões da conta.

Exclusão

/{ads_pixel_id}/shared_accounts

É possível desassociar uma AdAccount de um AdsPixel fazendo uma solicitação DELETE para /{ads_pixel_id}/shared_accounts.

Parâmetros

Parâmetro	Descrição
`account_id` string numérica	SELF_EXPLANATORY obrigatório
`business` string numérica ou número inteiro	SELF_EXPLANATORY obrigatório

Tipo de retorno

Struct  {
success: bool,
}

Códigos de erro

Código de erro	Descrição
100	Parâmetro inválido

/{custom_audience_id}/ad_accounts

É possível desassociar uma AdAccount de um CustomAudience fazendo uma solicitação DELETE para /{custom_audience_id}/ad_accounts.

Parâmetros

Parâmetro	Descrição
`adaccounts` list<numeric string>	Matriz de identificações de contas de anúncios para revogar o acesso ao público personalizado.

Tipo de retorno

Struct  {
success: bool,
}

Códigos de erro

Código de erro	Descrição
100	Parâmetro inválido

Você achou esta página útil?