Administrar activos

Puedes obtener, añadir y eliminar activos de un grupo de activos comerciales. Entre ellos se incluyen cuentas publicitarias, páginas, píxeles de Facebook, conjuntos de eventos offline, aplicaciones, catálogos, cuentas de Instagram y conversiones personalizadas.

Administra tus grupos de activos comerciales y aprende a conectar a los usuarios de tu empresa con grupos de activos. Los grupos de activos comerciales ayudan a los grandes anunciantes o agencias a administrar de forma eficaz los usuarios y los activos de su empresa. Debes organizar los activos y los usuarios de una forma que se corresponda con las operaciones del mundo real. Por ejemplo, una empresa puede estructurar sus activos y usuarios según la marca, la región, el cliente o un principio de organización de su elección.

Páginas

Para obtener una lista de todas las páginas de Facebook de un grupo de activos comerciales:

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

La respuesta tiene un aspecto similar al siguiente:

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

Puedes añadir una página a un grupo de activos comerciales. Puedes añadir páginas en propiedad o compartidas:

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

Si la operación se lleva a cabo correctamente, devolvemos true.

Para quitar una página de un grupo de activos comerciales:

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

Si la operación se lleva a cabo correctamente, devolvemos true.

Cuentas publicitarias

Los grupos de activos comerciales pueden incluir cuentas publicitarias en propiedad o compartidas. Para ver todas las cuentas de un grupo:

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

La respuesta tiene un aspecto similar al siguiente:

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

Para añadir una cuenta publicitaria a un grupo de activos comerciales:

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 quitar una cuenta publicitaria de un grupo de activos comerciales:

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 productos

Puedes añadir catálogos de productos en propiedad o compartidos a un grupo de activos comerciales. Para ver todos los catálogos de un grupo:

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

La respuesta tiene un aspecto similar al siguiente:

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

Para añadir un catálogo a un grupo de activos comerciales:

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>"

Si la operación se lleva a cabo correctamente, devolvemos true. Para quitar un catálogo de un grupo de activos comerciales:

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>"

Cuentas de Instagram

Puedes añadir cuentas de Instagram compartidas o en propiedad a un grupo de activos comerciales. Para obtener una lista de las cuentas existentes:

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

La respuesta tiene un aspecto similar al siguiente:

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

Para añadir una cuenta de Instagram a un grupo de activos comerciales:

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>"

Si la operación se lleva a cabo correctamente, devolvemos true.

Para quitar una cuenta de un grupo de activos comerciales:

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

Píxeles de Facebook

Puedes añadir o eliminar píxeles en propiedad y compartidos de grupos de activos comerciales. Para ver todos los píxeles existentes de un grupo de activos comerciales:

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

La respuesta tiene un aspecto similar al siguiente:

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

Para añadir un píxel a un grupo de activos comerciales:

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

Si la operación se lleva a cabo correctamente, devolvemos true.

Para quitar un píxel de un grupo de activos comerciales:

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 datos de eventos offline

Los grupos de activos comerciales pueden incluir conjuntos de datos de eventos offline compartidos y en propiedad. Para ver todos los conjuntos de datos de un grupo de activos comerciales:

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

La respuesta tiene un aspecto similar al siguiente:

{
 "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 añadir conjuntos de eventos offline a un grupo de activos comerciales:

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>"

Si la operación se lleva a cabo correctamente, devolvemos true.

Para quitar un conjunto de eventos de un grupo de activos comerciales:

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>"

Aplicaciones

Para obtener todas las aplicaciones compartidas y en propiedad de un grupo de activos comerciales:

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

La respuesta:

{
 "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 añadir una aplicación a un grupo de activos comerciales:

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 quitar una aplicación de un grupo de activos comerciales:

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

Al añadir o eliminar una aplicación correctamente, devolvemos true.

Conversiones personalizadas

Para ver todos los conjuntos de datos de conversiones personalizadas en propiedad y compartidos de un grupo de activos comerciales:

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

La respuesta:

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

Para añadir conversiones personalizadas a un grupo de activos comerciales:

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 eliminar conversiones personalizadas de un grupo de activos comerciales:

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>"

Al añadir o eliminar correctamente una conversión personalizada, devolvemos true.