Assets verwalten

Du kannst Assets aus einer Business-Asset-Gruppe abrufen, ihr Assets hinzufügen und sie daraus löschen. Dazu gehören Werbekonten, Seiten, Facebook-Pixel, Offline-Event-Sets, Apps, Kataloge, Instagram-Konten und selbstdefinierte Conversions.

Verwalte die Asset-Gruppen deines Unternehmens und erfahre, wie du die Nutzer*innen deines Unternehmens mit Asset-Gruppen verbindest. Business-Asset-Gruppen helfen großen Werbetreibenden oder Agenturen, Nutzer*innen und Assets in ihrem Unternehmen effizient zu verwalten. Sie sollten Assets und Nutzer*innen so organisieren, dass sie den realen Operationen zugeordnet werden. Beispielsweise kann ein Unternehmen seine Assets und Nutzer*innen nach Marke, Region, Kund*innen oder einem Organisationsprinzip seiner Wahl strukturieren.

Seiten

So rufst du eine Liste aller Facebook-Seiten in einer Business-Asset-Gruppe ab:

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

Die Antwort sieht folgendermaßen aus:

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

Du kannst einer Business-Asset-Gruppe eine Seite hinzufügen. Du kannst eigene oder geteilte Seiten hinzufügen:

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

Bei Erfolg wird true zurückgegeben.

So entfernst du eine Seite aus einer Business-Asset-Gruppe:

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

Bei Erfolg wird true zurückgegeben.

Werbekonten

Business-Asset-Gruppen können entweder eigene oder geteilte Werbekonten enthalten. So zeigst du die Konten in einer Gruppe an:

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

Die Antwort sieht folgendermaßen aus:

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

So fügst du einer Business-Asset-Gruppe ein Werbekonto hinzu:

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

So entfernst du ein Werbekonto aus einer Business-Asset-Gruppe:

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

Produktkataloge

Du kannst einer Business-Asset-Gruppe sowohl eigene als auch geteilte Produktkataloge hinzufügen. So zeigst du alle Kataloge in einer Gruppe an:

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

Die Antwort sieht folgendermaßen aus:

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

So fügst du einer Business-Asset-Gruppe einen Katalog hinzu:

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

Bei Erfolg wird true zurückgegeben. So entfernst du einen Katalog aus einer Business-Asset-Gruppe:

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

Instagram-Konten

Du kannst einer Business-Asset-Gruppe geteilte oder eigene Instagram-Konten hinzufügen. So rufst du eine Liste der bestehenden Konten ab:

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

Die Antwort sieht folgendermaßen aus:

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

So fügst du einer Business-Asset-Gruppe ein Instagram-Konto hinzu:

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

Bei Erfolg wird true zurückgegeben.

So entfernst du ein Konto aus einer Business-Asset-Gruppe:

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

Facebook-Pixel

Du kannst eigene oder geteilte Pixel in Business-Asset-Gruppen hinzufügen oder entfernen. So zeigst du alle bestehenden Pixel in einer Business-Asset-Gruppe an:

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

Die Antwort sieht folgendermaßen aus:

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

So fügst du einer Business-Asset-Gruppe ein Pixel hinzu:

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

Bei Erfolg wird true zurückgegeben.

So entfernst du ein Pixel aus einer Business-Asset-Gruppe:

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

Datensätze zu Offline-Events

Business-Asset-Gruppen können sowohl geteilte als auch eigene Datensätze zu Offline-Events enthalten. So zeigst du alle Datensätze in einer Business-Asset-Gruppe an:

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

Die Antwort sieht folgendermaßen aus:

{
 "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 } ], 
 ....
 }

So fügst du einer Business-Asset-Gruppe Offline-Event-Sets hinzu:

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

Bei Erfolg wird true zurückgegeben.

So entfernst du ein Event-Set aus einer Business-Asset-Gruppe:

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

So rufst du alle geteilten und eigenen Apps in einer Business-Asset-Gruppe ab:

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

Die Antwort:

{
 "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>" } ], 
 ....
 }

So fügst du einer Business-Asset-Gruppe eine App hinzu:

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

So entfernst du eine App aus einer Business-Asset-Gruppe:

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

Wenn du entweder eine App erfolgreich hinzufügst oder entfernst, wird true zurückgegeben.

Custom Conversions

So zeigst du alle eigenen und geteilten Datensätze zu selbstdefinierten Conversions in einer Business-Asset-Gruppe an:

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

Die Antwort:

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

So fügst du einer Business-Asset-Gruppe selbstdefinierte Conversions hinzu:

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

So löschst du selbstdefinierte Conversions aus einer Business-Asset-Gruppe:

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

Wenn du eine selbstdefinierte Conversion erfolgreich hinzufügst oder entfernst, wird true zurückgegeben.