Visão geral

Para ter usuários do sistema, seu Gerenciador de Negócios precisa cumprir estes requisitos:

  • Ter uma pessoa real como um usuário administrador.
  • Ter um app do Facebook. Você deve obter o app e associá-lo a uma empresa por meio da API ou no Gerenciador de Negócios. O app precisa pertencer à mesma empresa.
    Observação: um usuário do sistema só poderá receber uma função em um app se o usuário do sistema e o app pertencerem à mesma empresa. Caso seu app precise acessar dados usando um usuário do sistema e um token de acesso pertencente a outra empresa, use a API de Empresa em Nome De.
  • O app da Meta precisará passar pelo processo de análise (e pela verificação da empresa) para obter as permissões necessárias aos usuário do sistema.

A Meta limita o número de usuários do sistema por Gerenciador de Negócios com base no nível de acesso do app.

Este exemplo de bashscript exibe as chamadas de API que criam um token de usuário do sistema e, depois, usam esse token para fazer chamadas da API de Marketing.

Tipos de usuários do sistema

Existem dois tipos de usuários do sistema: usuário do sistema administrador e usuário do sistema.

  • O usuário do sistema administrador pode criar usuários do sistema, contas de anúncios, atribuir permissões e muito mais.
  • O usuário do sistema só pode acessar os ativos para os quais tem permissão.

Você deve criar um usuário do sistema para cada tipo de acesso necessário. Utilize o usuário do sistema administrador para manter programaticamente as funções certas. Dessa forma, se um token de usuário do sistema for comprometido, ele terá um escopo limitado e não poderá comprometer outras permissões.

Forneça aos usuários do sistema acesso aos ativos e os utilize para a maioria das chamadas de API. Limite a utilização do usuário do sistema administrador para ações administrativas, como atribuir permissões. Por ter a maioria das permissões, você deve proteger o token do usuário do sistema administrador.

Veja como funciona:

Acesso aos ativos de negócios

Ações e requisitos necessários para obter acesso aos ativos de negócios:

Sua empresa

Representamos sua empresa como uma instância de um Gerenciador de Negócios na API de Marketing. Seu Gerenciador de Negócios deve obter, criar ou compartilhar um app do Facebook desenvolvido na API de Marketing. Para criar um token de acesso do usuário do sistema, esse app precisa ter acesso padrão. Você também pode entrar em contato com um representante do Facebook para que sua empresa seja adicionada a uma lista de permissão para criação do token.

Ativos

Ativos que pertencem ao seu Gerenciador de Negócios. Por exemplo: páginas, contas de anúncios, entre outros.

Usuário administrador

Todas as instâncias do Gerenciador de Negócios têm um usuário administrador. Normalmente, essa é a mesma pessoa que criou o objeto do Gerenciador de Negócios e o gerencia ao longo do tempo.

Usuário do sistema administrador

Um usuário administrador pode criar esse tipo especial de usuário. Um usuário do sistema administrador pode criar novos usuários e acessar todos os ativos que pertencem à empresa. Não recomendamos gerenciar ativos de negócios por meio de um usuário do sistema administrador, já que esse tipo de usuário tem acesso mais amplo do que um usuário normal do sistema. Limite a utilização do usuário do sistema administrador para criar outro usuário do sistema e não o use para acessar os ativos.

Usuário do sistema

Um usuário administrador ou um usuário do sistema administrador pode criar um usuário do sistema. Essa pessoa pode acessar os ativos. Escolha esse tipo de usuário para gerenciar os ativos da empresa.

Observação: um usuário do sistema só poderá receber uma função em um app se o usuário do sistema e o app pertencerem à mesma empresa. Caso seu app precise acessar dados usando um usuário do sistema e um token de acesso pertencente a outra empresa, use a API de Empresa em Nome De.

Permissões de acesso

Um usuário do sistema deve conceder ao respectivo usuário a permissão para acessar ativos de uma empresa.

Token de acesso de usuário do sistema

É preciso ter um app na API Marketing com acesso padrão, ou o app deve ser adicionado à lista de permissão por um representante do Facebook. Verifique se o app passou pelo processo de análise (e pela verificação da empresa, se aplicável) para obter as permissões necessárias. Com um usuário do sistema e esse app, você pode gerar um token de acesso de usuário do sistema. Com o token em mãos, e depois que um usuário do sistema conceder as permissões necessárias, você poderá acessar os ativos de forma programática.

Usuários do sistema e públicos personalizados

Para que um usuário do sistema opere com um público personalizado a partir de um arquivo de cliente em uma empresa, um usuário que não seja do sistema precisará aceitar os Termos de Serviço do respectivo público personalizado da empresa. A aceitação deve ser feita usando uma conta de anúncios que pertence a essa empresa.

Saiba mais sobre os Termos de Serviço para públicos personalizados e as opções disponíveis para usuários do sistema.

Limites

Seu app na API de Marketing possui certo nível de acesso. Isso determina quantos usuário do sistema podem ser criados para o Gerenciador de Negócios ao qual seu app pertence:

Nível Usuários do sistema Usuários do sistema administradores

Padrão

1

1

Avançado

10

1

É possível agrupar contas de anúncios por usuário do sistema em respostas com base nos clientes ou na relação leitura/gravação. Caso você gerencie muitas contas de anúncios, talvez demore um pouco para carregar todas elas na interface do usuário.