Recurso de sandbox da API de Marketing habilitado novamente

Temos o prazer de anunciar que reabilitamos as contas de anúncios do sandbox da API de Marketing. Dessa forma, os desenvolvedores podem testar as suas APIs em relação à API de Marketing.

O que é uma conta de anúncios do sandbox da API de Marketing?

Ela é uma conta de anúncio de teste associada a um app e configurada no site developers.facebook.com para permitir que a API acesse um subconjunto de APIs de Marketing. A conta do sandbox da API permite que os desenvolvedores façam chamadas para as APIs de Marketing nos próprios ativos e páginas a fim de realizar testes sem que os anúncios sejam veiculados. Os desenvolvedores não precisam configurar uma forma de pagamento nas contas de anúncios, já que a Meta não veiculará os anúncios criados. Além disso, as impressões ou os gastos não serão acumulados.

Como faço para criar uma conta de anúncio do sandbox da API de Marketing?

Primeiro, o usuário precisa habilitar o produto API de Marketing no Painel de Apps. Depois, é necessário criar e fazer a vinculação de uma conta de anúncios do sandbox. Ainda, ele pode vincular essa conta ao Gerenciador de Negócios, aceitar os termos de serviço, entre outras ações. Depois de concluir a configuração, é possível gerar o token de acesso do usuário ou usar o token do usuário do sistema para consultar a Graph API com fins de teste.

Experiência do usuário final

1. Os desenvolvedores podem acessar o Painel de Apps e adicionar o produto API de Marketing no site https://developers.facebook.com/.
   • Clique no menu suspenso Meus apps.
   • Escolha um app ao qual você tem acesso de desenvolvedor ou de administrador.
2. Adicione a API de Marketing, se não tinha acesso a esse produto antes.
   • No Painel de Apps, acesse a seção "Adicionar produto" e configure a API de Marketing.
   
3. Ao clicar em "API de Marketing > Ferramentas", você poderá acessar o cartão de gerenciamento de conta de anúncios do sandbox.
4. Você verá a opção para criar uma conta de sandbox caso seja a sua primeira vez fazendo isso. É possível criar somente uma conta de sandbox por app.
5. Depois, você pode vincular essa conta às Páginas que você administra.
6. Para o caso de uso básico, é possível gerar o token de acesso do usuário que tem acesso à conta de anúncios e à Página, além de o usar para testar as chamadas da API de Marketing.
7. Caso esteja planejando usar recursos como a experiência instantânea e o gerenciamento de catálogos, recomendamos usar o token do usuário do sistema. Para obter esse tipo de token de acesso, clique no botão "Conectar à empresa" e use o Gerenciador de Negócios para recuperar o token.

Limitações

• As contas de anúncios do sandbox não podem ser operadas no Gerenciador de Anúncios. Elas só podem ser operadas por meio das chamadas da API de Anúncios.
• A API Insights não é compatível, pois alterações ao ambiente do sandbox não são publicadas nem exibidas. Por isso, não são gerados gastos, cliques nem impressões. Também não há insights a serem avaliados.
• Caso o seu app esteja na lista de permissão para acesso a determinadas APIs experimentais, você também poderá fazer chamadas a elas no modo sandbox.
• É possível criar somente uma conta de anúncios do sandbox por app, independentemente do respectivo nível de acesso.

Recursos:

• Documentação para desenvolvedores

• Documentação sobre testes da API de Marketing Geral

• Publicação no blog sobre o lançamento inicial (2017)