広告インサイトを入手する

Instagram広告の統計情報を取得するには、広告アカウントから広告に対してインサイトAPIを使用します。

use FacebookAds\Object\Campaign;

$campaign = new Campaign(<CAMPAIGN_ID>);
$insights = $campaign->getInsights();

from facebookads.adobjects.campaign import Campaign

campaign = Campaign(<CAMPAIGN_ID>)
insights = campaign.get_insights()

curl -G \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v2.11/<CAMPAIGN_ID>/insights

InstagramとFacebookで同じキャンペーンを実施している場合、FacebookとInstagramの配置の統計情報を個別に確認するには、breakdowns=publisher_platform, platform_positionを追加します。

curl -X GET \
-d 'access_token=<ACCESS_TOKEN>' \
-d 'fields=impressions' \
-d 'breakdown=publisher_platform, platform_position' \
"https://graph.facebook.com/<API_VERSION>/<AD_SET_ID>/insights"

結果は次のようになります。

{
"data": [
    {
      "impressions": "322",
      "date_start": "2024-03-26",
      "date_stop": "2024-04-24",
      "publisher_platform": "instagram",
      "platform_position": "feed"
    },
    {
      "impressions": "13",
      "date_start": "2024-03-26",
      "date_stop": "2024-04-24",
      "publisher_platform": "instagram",
      "platform_position": "instagram_explore"
    },
    {
      "impressions": "168",
      "date_start": "2024-03-26",
      "date_stop": "2024-04-24",
      "publisher_platform": "instagram",
      "platform_position": "instagram_reels"
    },
    {
      "impressions": "617",
      "date_start": "2024-03-26",
      "date_stop": "2024-04-24",
      "publisher_platform": "instagram",
      "platform_position": "instagram_stories"
    }
  ],
  "paging": {
    ...
  }
}

特定の広告キャンペーンに関するインサイトについて、publisher_platform, platform_position別の内訳をリクエストする場合、Instagramプラットフォームでの4つの配置場所は、feed、instagram_explore、instagram_reels、およびinstagram_storiesです。

publisher_platform, platform_positionを含めたほかの内訳の組み合わせも使用できます。FacebookとInstagramの両方に配置がある広告のパフォーマンスを外部ツールでトラッキングするには、url_tagsのマクロSITE_SOURCE_NAMEを使用することによって、複数の異なる配置を区別します。

トラッキングタグ

表示タグは一般公開されていません。Facebookモバイルキャンペーンで承認済みのベンダーによる表示タグが許可されているなら、Instagram広告でも許可されています。Instagram広告で広告クリエイティブのurl_tagフィールドを使用できます。

サードパーティのトラッキングタグをInstagram広告で使用することは可能ですが、サードパーティのトラッキングツールに合わせた広告配信の最適化はしないでください。サードパーティのトラッキングツールでInstagram広告を確実に正しくトラッキングできるようにするには、広告クリエイティブのurl_tagフィールドをutm_source=instagramと共に使用してください。