Gerenciar ativos

Você pode obter, adicionar e excluir ativos em um grupo de ativos de negócios. Isso inclui contas de anúncios, Páginas, pixels do Facebook, conjuntos de eventos offline, app, catálogos, contas do Instagram e conversões personalizadas.

Gerencie os grupos de ativos de negócios e saiba como conectar os usuários corporativos a grupos de ativos. Os grupos de ativos de negócios ajudam grandes anunciantes ou agências a gerenciar de forma eficiente os usuários e os ativos da empresa. Organize ativos e usuários de modo que representem as operações do mundo real. Por exemplo, uma empresa pode estruturar ativos e usuários de acordo com a marca, a região, o cliente ou com base em outro princípio de organização que preferir.

Páginas

Para obter uma lista de todas as Páginas do Facebook presentes em um grupo de ativos:

curl -i -X GET \
 "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ASSET_GROUP_ID>/contained_pages?access_token=<ACCESS_TOKEN>"

A resposta será semelhante a esta:

{
  "data": [
    {
      "name": "Sample Name",
      "id": "<ID>"
    },
    {
      "name": "Another Name",
      "id": "<ID>"
    },
    {
      "name": "Third Name",
      "id": "<ID>"
    }
  ],
  ....
}

É possível adicionar uma Página a um grupo de ativos de negócios. Você pode adicionar Páginas próprias ou compartilhadas:

curl -i -X POST \
 "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ASSET_GROUP_ID>/contained_pages?asset_id=<PAGE_ID>&access_token=<ACCESS_TOKEN>"

Se a solicitação for bem-sucedida, o valor true será retornado.

Para remover uma Página de um grupo de ativos de negócios:

curl -i -X DELETE \
 "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ASSET_GROUP_ID>/contained_pages?asset_id=<PAGE_ID>&access_token=<ACCESS_TOKEN>"

Se a solicitação for bem-sucedida, o valor true será retornado.

Contas de anúncios

Os grupos de ativos de negócios podem incluir contas de anúncios próprias e compartilhadas. Para ver todas as contas em um grupo:

curl -i -X GET \
 "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ASSET_GROUP_ID>/contained_adaccounts?access_token=<ACCESS_TOKEN>"

A resposta será semelhante a esta:

{
  "data": [
    {
      "account_id": "<ID>",
      "id": "act_<ID>"
    },
    {
      "account_id": "<ID>",
      "id": "act_<ID>"
    },
    {
      "account_id": "<ID>",
      "id": "act_<ID>"
    }
  ],
....
    }
  }
}

Para adicionar uma conta de anúncios a um grupo de ativos de negócios:

curl -i -X POST \
 "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ASSET_GROUP_ID>/contained_adaccounts?asset_id=<AD_ACCOUNT_ID>&access_token=<ACCESS_TOKEN>"

Para remover uma conta de anúncios de um grupo de ativos de negócios:

curl -i -X DELETE \
 "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ASSET_GROUP_ID>/contained_adaccounts?asset_id=<AD_ACCOUNT_ID>&access_token=<ACCESS_TOKEN>"

Catálogos de produtos

Você pode adicionar catálogos de produtos próprios ou compartilhados a um grupo de ativos de negócios. Para ver todos os catálogos em um grupo:

curl -i -X GET \
 "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ASSET_GROUP_ID>/contained_product_catalogs?access_token=<ACCESS_TOKEN>"

A resposta será semelhante a esta:

{
  "data": [
    {
      "id": "<ID>",
      "name": "1 product catalog"
    },
    {
      "id": "<ID>",
      "name": "First_Catalog_Products"
    }
  ],
....
}

Para adicionar um catálogo a um grupo de ativos de negócios:

curl -i -X POST \
 "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ASSET_GROUP_ID>/contained_product_catalogs?asset_id=<CATALOG_ID>&access_token=<ACCESS_TOKEN>"

Se a solicitação for bem-sucedida, o valor true será retornado. Para remover um catálogo de um grupo de ativos de negócios:

curl -i -X DELETE \
 "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ASSET_GROUP_ID>/contained_product_catalogs?asset_id=<CATALOG_ID>&access_token=<ACCESS_TOKEN>"

Contas do Instagram

Você pode adicionar contas do Instagram próprias e compartilhadas a um grupo de ativos de negócios. Para obter uma lista de contas existentes:

curl -i -X GET \
 "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ASSET_GROUP_ID>/contained_instagram_accounts?access_token=<ACCESS_TOKEN>"

A resposta será semelhante a esta:

{
  "data": [
    {
      "id": "<ID>"
    },
    {
      "id": "<ID>"
    }
  ],
  ....
}

Para adicionar uma conta do Instagram a um grupo de ativos de negócios:

curl -i -X POST \
 "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ASSET_GROUP_ID>/contained_instagram_accounts?asset_id=<INSTAGRAM_ACCOUNT_ID>&access_token=<ACCESS_TOKEN>"

Se a solicitação for bem-sucedida, o valor true será retornado.

Para remover uma conta de um grupo de ativos de negócios:

curl -i -X DELETE \
 "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ASSET_GROUP_ID>/contained_instagram_accounts?asset_id=<ID>&access_token=<ACCESS_TOKEN>"

Pixels do Facebook

Você pode adicionar ou remover pixels próprios e compartilhados em grupos de ativos de negócios. Para ver todos os pixels existentes em um grupo de ativos de negócios:

curl -i -X GET \
 "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ASSET_GROUP_ID>/contained_pixels?access_token=<ACCESS_TOKEN>"

A resposta será semelhante a esta:

{
  "data": [
    {
      "id": "<ID>"
    },
    {
      "id": "<ID>"
    }
  ],
 ....
    }
  }
}

Para adicionar um pixel a um grupo de ativos de negócios:

curl -i -X POST \
 "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ASSET_GROUP_ID>/contained_pixels?asset_id=<PIXEL_ID>&access_token=<ACCESS_TOKEN>"

Se a solicitação for bem-sucedida, o valor true será retornado.

Para remover um pixel de um grupo de ativos de negócios:

curl -i -X DELETE \
 "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ASSET_GROUP_ID>/contained_pixels?asset_id=<PIXEL_ID>&access_token=<ACCESS_TOKEN>"

Conjuntos de dados de eventos offline

Os grupos de ativos de negócios podem incluir conjuntos de dados de eventos offline próprios e compartilhados. Para ver todos os conjuntos de dados em um grupo de ativos de negócios:

curl -i -X GET \
 "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ASSET_GROUP_ID>/contained_offline_conversion_data_sets?access_token=<ACCESS_TOKEN>"

A resposta será semelhante a esta:

{
 "data": [
 {
 "id": "<ID>", "name": "Transfer", "business": {
 "id": "<ID>", "name": "Acme Industries Inc." }, "enable_auto_assign_to_accounts": false, 
 "is_restricted_use": false 
 },
 {
 "id": "<ID>", "name": "Default Offline Event Set For Biz1", "business": {
 "id": "<ID>", "name": "Biz1" }, "enable_auto_assign_to_accounts": true, "is_restricted_use": false } ], 
 ....
 }

Para adicionar conjuntos de eventos offline a um grupo de ativos de negócios:

curl -i -X POST \
 "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ASSET_GROUP_ID>/contained_offline_conversion_data_sets?asset_id=<EVENT_SET_ID>&access_token=<ACCESS_TOKEN>"

Se a solicitação for bem-sucedida, o valor true será retornado.

Para remover um conjunto de eventos de um grupo de ativos de negócios:

curl -i -X DELETE \
 "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ASSET_GROUP_ID>/contained_offline_conversion_data_sets?asset_id=<EVENT_SET_ID>&access_token=<ACCESS_TOKEN>"

Apps

Para obter todos os apps próprios e compartilhados em um grupo de ativos de negócios:

curl -i -X GET \
 "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ASSET_GROUP_ID>/contained_applications?access_token=<ACCESS_TOKEN>"

A resposta:

{
 "data": [
 {
 "category": "Games", "link": "/instantgames/<ID>/", "name": "testing again", "id": "<ID>" }, {
 "category": "Lifestyle", "link": "https://www.facebook.com/games/?app_id=<ID>", "name": "AccountKitTest", "id": "<ID>" } ], 
 ....
 }

Para adicionar um app a um grupo de ativos de negócios:

curl -i -X POST \
 "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ASSET_GROUP_ID>/contained_applications?asset_id=<APP_ID>&access_token=<ACCESS_TOKEN>"

Para remover um app de um grupo de ativos de negócios:

curl -i -X DELETE \
 "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ASSET_GROUP_ID>/contained_applications?asset_id=<APP_ID>&access_token=<ACCESS_TOKEN>"

Quando a adição ou a remoção de um app for bem-sucedida, o valor true será retornado.

Conversões personalizadas

Para ver todos os conjuntos de dados de conversões personalizadas próprios e compartilhados em um grupo de ativos de negócios:

curl -i -X GET \
 "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ASSET_GROUP_ID>/contained_custom_conversions?access_token=<ACCESS_TOKEN>"

A resposta:

{
 "data": [{
  "data": [
    {
      "id": "<ID>"
    },
    {
      "id": "<ID>"
    }
  ],
  ....
}

Para adicionar conversões personalizadas a um grupo de ativos de negócios:

curl -i -X POST \
 "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ASSET_GROUP_ID>/contained_custom_conversions?asset_id=<CUSTOM_CONVERSIONS_DATA_SET_ID>&access_token=<ACCESS_TOKEN>"

Para remover conversões personalizadas de um grupo de ativos de negócios:

curl -i -X DELETE \
 "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ASSET_GROUP_ID>/contained_custom_conversions?asset_id=<CUSTOM_CONVERSIONS_DATA_SET_ID>&access_token=<ACCESS_TOKEN>"

Quando a adição ou a remoção de uma conversão personalizada for bem-sucedida, o valor true será retornado.