このページは Cloud Translation API によって翻訳されました。

広告アクティビティレポート（アルファ版 API）

をご覧ください。

広告アクティビティレポートは、広告のパフォーマンスを一元的に把握できます。データ、指標、他のディメンションと指標も参照できます 1 つの統合レポートにまとめることができます。

Ads Activity Report API でメディエーションのさらなる改善が可能に下の表のとおりに、Report API と Network Report API を使用します。

	Network Report API	Mediation Report API	Ads Activity Report API
ネットワークパフォーマンス	✅	✅	✅
ウォーターフォールのパフォーマンス		✅	✅
入札のパフォーマンス			✅
メディエーションの A/B テストのパフォーマンス			✅
時間別レポート			✅
レポートサイズ	10 万	10 万	50 万

指標、ディメンション、ディメンションフィルタ

Ads Activity Report API に以下の指標が追加されました Network Report API で使用できる多くの指標とメディエーションレポート API。

指標	説明
BID_REQUEST	入札広告ソースに対するリクエスト数です。
BIDS_IN_AUCTION	広告ソースによって送信された、入札オークションに参加した入札の数です。
WINNING_BIDS	オークションで落札した入札の数。

Ads Activity Report API に、次の新しいディメンションが追加されました。

ディメンション	説明
週	週の初日の日付（コード）を YYYYMMDD 形式（例: 「20210701」）。リクエストには DATE、WEEK、MONTH のいずれか 1 つのみを指定できますあるとします
時間	PST 時間の HH 形式の時間。例: 「05」午前 5 時（PST）、「13」午後 1 時（PST）までメールでお問い合わせください。リクエストでは DATE ディメンションも指定する必要があります。 HOUR ディメンションが指定されている場合、最大 28 日分のデータが返されます。期間の開始日が現在の日付から 28 日以上前ですエラーが返されます。
MEDIATION_AB_TEST（テスト名）	メディエーションの A/B テストごとにパフォーマンスを確認できます。この引数は必須です。 VARIANT ディメンションが指定されている場合。
MEDIATION_AB_TEST_VARIANT（パターン A、パターン B）	メディエーションの A/B テストパターン別にパフォーマンスを確認できます。

Mediation Report API のディメンション名	Ads Activity Report API のディメンション名	説明
広告ユニット¹	AD_UNIT_ID	広告ユニットの一意の ID（例: 123456789）。
広告ユニット¹	AD_UNIT_NAME	広告ユニットの名前。
アプリ¹	APP_ID	モバイルアプリの一意の ID（例: 1234567890）。
アプリ¹	APP_NAME	アプリの名前。
AD_SOURCE¹	AD_SOURCE_ID	広告ソースの一意の ID（例: 「1234567890123456789」）。
AD_SOURCE¹	AD_SOURCE_NAME	広告ソースの名前（「AdMob ネットワーク」など）。
AD_SOURCE_INSTANCE¹	AD_SOURCE_INSTANCE_ID	広告ソースインスタンスの一意の ID（例: 123456789012）。
AD_SOURCE_INSTANCE¹	AD_SOURCE_INSTANCE_NAME	広告ソースのインスタンスの名前（「AdMob（デフォルト）」など）。
MEDIATION_GROUP¹	MEDIATION_GROUP_ID	メディエーショングループの一意の ID（「1234567890」など）。
MEDIATION_GROUP¹	MEDIATION_GROUP_NAME	メディエーショングループの一意の ID（「AdMob（デフォルト）」など）。

¹: 詳細については、Scalarsをご覧ください。

次のディメンションの形式が更新されました。

Mediation Report API のディメンション名	Mediation Report API の説明	Ads Activity Report API の説明
ESTIMATED_EARNINGS	AdMob パブリッシャーの推定収益額。通貨単位（USD、（ユーロなど）はローカライズによって決まる設定します。金額はマイクロ秒単位です。たとえば 6.50 ドルの場合は 6500000 で表されます。メディエーショングループごと、および広告ソースのインスタンスレベルごとの推定収益額: 2019 年 10 月 20 日までさかのぼります第三者の推定収益額の変動額は次のとおりです。 2019 年 10 月 20 日より前の日付の場合は、0 と表示されます。	AdMob パブリッシャーの推定収益額。通貨単位（USD、（ユーロなど）はローカライズによって決まる指定します。
OBSERVED_ECPM	第三者広告ネットワークの推定平均 eCPM。通貨単位収益指標の（米ドル、ユーロ、その他）はローカライズによって決定指定します。金額はマイクロ秒単位です。たとえば 2.30 ドルの場合は 2,300,000 で表されます。メディエーショングループおよび広告ソースのインスタンスレベルごとの推定平均 eCPM 2019 年 10 月 20 日までさかのぼりますサードパーティの推定平均 2019 年 10 月 20 日より前の日付では、eCPM は 0 と表示されます。	すべての広告の平均 eCPM。通貨単位（USD、EUR など）収益の指標は通貨のローカライズ設定によって決まります。メディエーショングループと広告ソースのインスタンスレベルごとの平均 eCPM は次のとおりです。 2019 年 10 月 20 日までさかのぼりますOBSERVED_ECPM の日付は 0 と表示されます。 2019 年 10 月 20 日より前

スカラー

Ads Activity Report API で、以下のディメンションが更新され、スカラー値を使用します。そうすれば対応がシンプルになり、複雑になります。

Mediation Report API と Network Report API で影響を受けるディメンション:

AD_UNIT
APP
AD_SOURCE
AD_SOURCE_INSTANCE
MEDIATION_GROUP

レポートレスポンスデータのサンプル
メディエーション / Network API ディメンションの形式	"AD_UNIT": { "value":"ca-app-pub-XXXXXXXXXXXXXXXXX/YYYYYYYYYY", "displayLabel": "Test ad unit name" }
AAR API のディメンションの形式	"AD_UNIT_NAME": "Test ad unit name", "AD_UNIT_ID": "ca-app-pub-XXXXXXXXXXXXXXXXX/YYYYYYYYYY"

時間別レポート

AdMob API で時間別にパフォーマンスを確認できるようになりました。時間別レポートは最大 28 日間利用できます

1 時間ごとのデータを取得するには、リクエストで DATE ディメンションも指定する必要があります。分析できますHOUR ディメンションが次の場合、最大 28 日間のデータが返されます。あります。期間の開始日が 28 日以上前現在の日付ではエラーが返されます。

レポートサイズの拡大

Ads Activity Report API を使用すると、合計 500,000 行を取得できます。対象詳細については、割り当てガイドをご覧ください。

リクエストを作成する

リクエストを行う手順は次のとおりです。

curl（コマンドライン）

curl を使用したリクエスト

クライアントシークレットファイルを読み込み、認証情報を生成します。

この手順を初めて実行するときは、承認プロンプトが表示されます。承認する前に、次の要件を満たしていることを確認してください。 AdMob API にアクセスできる Google アカウントでログインしている。お客様のアプリケーションには、あらゆる Google Cloud アプリケーション、確認されます。

認証と認可には、Cloud KMS の使用を oauth2l。シンプルなコマンドラインツールであり、 Google OAuth 2.0 との連携について学びました。oauth2l をインストールし、 path_to_credentials_json の部分をパスで置き換えます。登録時にダウンロードした credentials.json ファイルにクラウドアプリケーションです。初回実行では、コマンドによって OAuth 2.0 認可フロー。その後の実行でトークンが更新される自動的に適用されます。
```
~/go/bin/oauth2l header --json path_to_credentials_json \
        https://www.googleapis.com/auth/admob.readonly
```

広告アクティビティレポートを生成します。

curl -X POST https://admob.googleapis.com/v1alpha/accounts/pub-XXXXXXXXXXXXXXXX/adsActivityReport:generate \
     -H "Content-Type: application/json" \
     -H "$(~/go/bin/oauth2l header --json path_to_credentials_json https://www.googleapis.com/auth/admob.readonly)"  --data @- << EOF
      {
        "report_spec": {
        "date_range": {
          "start_date": {"year": 2023, "month": 1, "day": 1},
          "end_date": {"year": 2023, "month": 1, "day": 2}
        },
        "dimensions": ["DATE", "HOUR", "MEDIATION_AB_TEST", "VARIANT", "AD_SOURCE_ID", "AD_SOURCE_NAME"],
        "metrics": ["CLICKS", "BID_REQUEST","WINNING_BIDS", "IMPRESSIONS", "ESTIMATED_EARNINGS" ],
        "dimension_filters": [{"dimension": "COUNTRY", "matches_any": {"values": ["US"]}}],
        "sort_conditions": [{"metric":"CLICKS", "order": "DESCENDING"}],
        "localization_settings": {"currency_code": "USD", "language_code": "en-US"}
        }
      }
EOF

レスポンスの例:

{
"rows": [
  {
    "dimensionValues": {
      "DATE": {
        "value": "20221102"
      },
      "HOUR": {
        "value": "23"
      },
      "MEDIATION_AB_TEST": {
        "value": "Mediation AB Test"
      },
      "VARIANT": {
        "value": "Variant A"
      },
      "AD_SOURCE_ID": {
        "value": "5450213213286189855"
      },
      "AD_SOURCE_NAME": {
        "value": "AdMob Network"
      }
    },
    "metricValues": {
      "CLICKS": {
        "doubleValue": 0
      },
      "BID_REQUEST": {
        "integerValue": "27"
      },
      "WINNING_BIDS": {
        "doubleValue": 0.1111111111111111
      },
      "IMPRESSIONS": {
        "integerValue": "2"
      },
      "ESTIMATED_EARNINGS": {
        "doubleValue": 0
      }
    }
  },
{
    "dimensionValues": {
      "DATE": {
        "value": "20221102"
      },
      "HOUR": {
        "value": "23"
      },
      "MEDIATION_AB_TEST": {
        "value": "Mediation AB Test"
      },
      "VARIANT": {
        "value": "Variant B"
      },
      "AD_SOURCE_ID": {
        "value": "5450213213286189855"
      },
      "AD_SOURCE_NAME": {
        "value": "AdMob Network"
      }
    },
    "metricValues": {
      "CLICKS": {
        "doubleValue": 1
      },
      "BID_REQUEST": {
        "integerValue": "6"
      },
      "WINNING_BIDS": {
        "doubleValue": 1
      },
      "IMPRESSIONS": {
        "integerValue": "3"
      },
      "ESTIMATED_EARNINGS": {
        "doubleValue": 0.000427519
      }
    }
  }
]}