アセットの管理

ビジネスアセットグループのアセットを取得、追加、削除することができます。アセットには、広告アカウント、ページ、Facebookピクセル、オフラインイベントセット、アプリ、カタログ、Instagramアカウント、カスタムコンバージョンなどが含まれます。

ビジネスのアセットグループを管理して、ビジネスユーザーをアセットグループにリンクする方法を確認します。ビジネスアセットグループを使用すると、大規模な広告主や広告代理店は、そのビジネスのユーザーやアセットを効率よく管理できるようになります。アセットやユーザーの編成は、実際の運用方法に則したやり方で行ってください。例えば事業者は、ブランド、地域、クライアント、または選択した組織編成の原則に従って、アセットやユーザーを構成することができます。

ページ

ビジネスアセットグループに含まれているすべてのFacebookページのリストを取得するには、次のようにします。

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

応答は次のようになります。

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

ビジネスアセットグループにページを追加することができます。所有するページまたは共有されたページを追加できます。

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

成功すると、trueが返されます。

ビジネスアセットグループからページを削除するには、次のようにします。

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

成功すると、trueが返されます。

広告アカウント

ビジネスアセットグループに、所有する広告アカウントまたは共有された広告アカウントを含めることができます。グループ内のすべてのアカウントを表示するには、次のようにします。

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

応答は次のようになります。

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

ビジネスアセットグループに広告アカウントを追加するには、次のようにします。

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

ビジネスアセットグループから広告アカウントを削除するには、次のようにします。

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

商品カタログ

ビジネスアセットグループに、所有する商品カタログまたは共有された商品カタログのいずれかを追加することができます。グループ内のすべてのカタログを表示するには、次のようにします。

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

応答は次のようになります。

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

ビジネスアセットグループにカタログを追加するには、次のようにします。

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

成功すると、trueが返されます。ビジネスアセットグループからカタログを削除するには、次のようにします。

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アカウント

ビジネスアセットグループに、共有されたInstagramアカウントまたは所有するInstagramアカウントを追加することができます。既存のアカウントのリストを取得するには、次のようにします。

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

応答は次のようになります。

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

ビジネスアセットグループにInstagramアカウントを追加するには、次のようにします。

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

成功すると、trueが返されます。

ビジネスアセットグループからアカウントを削除するには、次のようにします。

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ピクセル

ビジネスアセットグループで、所有するピクセルと共有されたピクセルを追加したり削除したりすることができます。ビジネスアセットグループ内のすべての既存のピクセルを表示するには、次のようにします。

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

応答は次のようになります。

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

ビジネスアセットグループにピクセルを追加するには、次のようにします。

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

成功すると、trueが返されます。

ビジネスアセットグループからピクセルを削除するには、次のようにします。

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

オフラインイベントデータセット

ビジネスアセットグループには、共有されたオフラインイベントデータセットと、所有しているオフラインイベントデータセットのどちらも含めることができます。ビジネスアセットグループ内のすべてのデータセットを表示するには、次のようにします。

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

応答は次のようになります。

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

ビジネスアセットグループにオフラインイベントセットを追加するには、次のようにします。

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

成功すると、trueが返されます。

ビジネスアセットグループからイベントセットを削除するには、次のようにします。

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

アプリ

ビジネスアセットグループに含まれる共有されたアプリと所有するアプリをすべて取得するには、次のようにします。

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

応答

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

ビジネスアセットグループにアプリを追加するには、次のようにします。

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

ビジネスアセットグループからアプリを削除するには、次のようにします。

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

アプリの追加または削除が成功すると、trueが返されます。

カスタムコンバージョン

ビジネスアセットグループ内の、所有するカスタムコンバージョンデータセットと共有されたカスタムコンバージョンデータセットをすべて表示するには、次のようにします。

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

応答

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

ビジネスアセットグループにカスタムコンバージョンを追加するには、次のようにします。

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

ビジネスアセットグループからカスタムコンバージョンを削除するには、次のようにします。

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

カスタムコンバージョンの追加または削除が成功すると、trueが返されます。