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

メディエーショングループ

AdMob API では、次のようなメディエーショングループを作成、一覧表示、更新できます。

メディエーショングループのターゲティングを指定する（地域、フォーマット、プラットフォーム、IDFA ターゲティングなど）
新しいメディエーショングループラインを追加する既存のメディエーショングループへの
メディエーションの A/B テストに含まれるメディエーショングループとその内容を確認するメディエーショングループの行は各パターン（A または B）に属します

例

OAuth 2.0 認証情報を作成したら、 AdMob API を使用する準備が整いました。OAuth 2.0 を使用してアクセスをリクエストするには、スコープ情報も必要です。

OAuth 2.0 のスコープ情報は次のとおりです。

範囲	意味
`https://www.googleapis.com/auth/admob.monetization`	AdMob の収益化設定の参照、作成、編集。
`https://www.googleapis.com/auth/admob.readonly`	AdMob の全データを表示これには次のアカウントが含まれます広告枠とメディエーションの設定、レポート、その他のデータが含まれます。お支払いやキャンペーンの詳細などのセンシティブデータは含まれません。

作成

メディエーショングループを作成するには、メディエーショングループのターゲット設定を指定する必要があります広告ユニットなどの情報が含まれます次の例では、新しい Pod を作成する 2 つの広告ユニットに対する Android インタースティシャル広告のメディエーショングループ。1 個のメディエーショングループ行は、InMobi 広告ソースの作成時に追加されます。名前を指定する必要は作成時に AdMob ネットワークが追加されます。

以下のコードスニペットの pub-XXXXXXXXXXXXXXXX を、ご利用の publisher に置き換えてください。 ID。

「YYYYYYYYYY」の部分を、ご利用の広告ユニットの末尾 10 桁に置き換えてください。 ID、準拠次の形式にします。

ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY

この例には 2 つの広告ユニットがあるため、YYYYY11111 は 1 つ目の広告を指します。 WWWWW11111 を最初の広告ユニットのマッピングに追加します。YYYYY22222、 WWWWW22222 は 2 つ目の広告ユニットと広告ユニットのマッピングを表します。

curl（コマンドライン）

WWWWWWWWWW は、広告ユニットのマッピング ID に置き換えます。広告ユニットのマッピング ID [ accounts.adUnits.adUnitMappings.list メソッドを呼び出します。

 curl --http1.0 -X POST https://admob.googleapis.com/v1beta/accounts/pub-XXXXXXXXXXXXXXXX/mediationGroups
-H "Content-Type:application/json"
-H "$(oauth2l header --json path_to_credentials_json --scope admob.monetization)"
--data @- << EOF
{
  "displayName": "Test Mediation Group"
  "targeting": {
    "platform": "ANDROID",
    "format": "INTERSTITIAL"
    "adUnitIds":["ca-app-pub-XXXXXXXXXXXXXXXX/YYYYY11111", "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYY22222"}
  }
  "mediationGroupLines": {
    "-1": {
      "displayName": "test line",
      "adSourceId": "7681903010231960328",
      "cpmMode": "MANUAL",
      "cpmMicros": "150000",
      "state": "ENABLED",
      "adUnitMappings": {
        "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYY11111": "accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYY11111/adUnitMappings/WWWWW11111",
        "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYY22222": "accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYY22222/adUnitMappings/WWWWW22222"
      }
  }
}

curl（コマンドライン）

リクエストの例:

curl --http1.0 -X GET https://admob.googleapis.com/v1beta/accounts/pub-XXXXXXXXXXXXXXXX/mediationGroups \
-H "$(oauth2l header --json path_to_credentials_json --scope admob.monetization)"

レスポンスの例:

{
"mediationGroups": [
  {
    "name": "accounts/pub-XXXXXXXXXXXXXXXX/mediationGroups/ZZZZZZZZZZ",
    "mediationGroupId": "ZZZZZZZZZZ",
    "displayName": "Test Mediation Group",
    "state": "ENABLED",
    "state": "NOT_RUNNING",
    "targeting": {
      "platform": "iOS",
      "format": "BANNER",
      "targetedRegionCodes": "[CA]",
      "adUnits": ["YYYYY11111", "YYYYY22222"]
    },
    "mediationGroupLines": {
      "11111111111111111": {
        "id": "11111111111111111",
        "displayName": "AdMob Network",
        "adSourceId": "5450213213286189855",
        "cpmMode": "LIVE",
        "state": "ENABLED",
        "experimentVariant": "ORIGINAL"
      },
      "22222222222222222": {
        "id": "22222222222222222",
        "displayName": "test line",
        "adSourceId": "7681903010231960328",
        "cpmMode": "MANUAL",
        "cpmMicros": "150000",
        "adUnitMappings": {
          "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYY11111": "accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYY11111/adUnitMappings/WWWWW11111",
          "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYY22222": "accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYY22222/adUnitMappings/WWWWW22222"
        },
        "state": "ENABLED",
        "experimentVariant": "ORIGINAL"
      }
    },
  }]
}

パッチ

これがフィールドのリストです。マスクメディエーショングループを更新します繰り返しフィールドの更新既存の値を新しい値に完全に置換します。個別のユーザーに関する更新キーによるインデックス付けによってマップに格納できます。

メディエーショングループの更新では、次のフィールドマスクがサポートされています。

targeting.adUnitIds
mediationGroupLines[mediationGroupLineId]
mediationGroupLines[mediationGroupLineId].state
mediationGroupLines[mediationGroupLineId].adUnitMappings[adUnitId]

メディエーショングループを新しいメディエーショングループ行で更新するには、 mediationGroupLineId の負の数。既存のメディエーションを更新するためグループの行 ID については、update_mask とペイロードを定義します。

"updateMask" {
    paths: "mediation_group_lines["123"].ad_unit_mappings["456"]"
}

"mediationGroup" {
  "mediationGroupLines": {
   "123": {
     "id": "123"
     "adUnitMappings": {
      "456": "newAdUnitMappingId"
     }
    }
  }
}

curl（コマンドライン）

次の例では、既存のメディエーショングループに新しいメディエーション行を 3 つ追加しています。 updateMask に、メディエーショングループ 3 行（明確な除外キーワードを含む）が含まれている値をプレースホルダとして使用します。

updateMask=mediationGroupLines["-1"],mediationGroupLines["-2"],mediationGroupLines["-3"]

すべての URL が URI（Uniform Resource Identifier）仕様で指定された構文、 updateMask は次のようになります。

updateMask=mediationGroupLines%5B%22-1%22%5D,mediationGroupLines%5B%22-2%22%5D,mediationGroupLines%5B%22-3%22%5D

次の例を実行するには、pub-XXXXXXXXXXXXXXXX をパブリッシャー ID と ZZZZZZZZZZ をメディエーショングループ ID に置き換えます。調停グループ ID は、AdMob の管理画面または accounts.mediationGroups:list で確認できます。メソッドを呼び出します。

「YYYYYYYYYY」の部分を、実際の広告ユニットの末尾 10 桁に置き換えてください。 ID は、次の形式で指定します。

ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY`

curl --http1.0 -X PATCH https://admob.googleapis.com/v1beta/accounts/pub-XXXXXXXXXXXXXXXX/mediationGroups/ZZZZZZZZZZ?
updateMask=mediationGroupLines%5B%22-1%22%5D,mediationGroupLines%5B%22-2%22%5D,mediationGroupLines%5B%22-3%22%5D
-H "Content-Type:application/json"
-H "$(oauth2l header --json path_to_credentials_json --scope admob.monetization)"
--data @- << EOF
{
"mediationGroupLines": {
  "-1": {
    "displayName": "test line 2",
    "adSourceId": "7681903010231960458",
    "cpmMode": "MANUAL",
    "cpmMicros": "150000",
    "state": "ENABLED",
    "adUnitMappings": {
      "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY": "accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYYYYYYY/adUnitMappings/WWWWWWWWWW"
    }
},
"-2": {
    "displayName": "test line 3",
    "adSourceId": "7681903010231960328",
    "cpmMode": "MANUAL",
    "cpmMicros": "120000",
    "state": "ENABLED",
    "adUnitMappings": {
      "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY": "accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYYYYYYY/adUnitMappings/WWWWWWWWWW"
    }
},
"-3": {
    "displayName": "test line 4",
    "adSourceId": "7681903010231960328",
    "cpmMode": "MANUAL",
    "cpmMicros": "130000",
    "state": "ENABLED",
    "adUnitMappings": {
     "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY": "accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYYYYYYY/adUnitMappings/WWWWWWWWWW"
    }
  }
}
}
EOF

メディエーション グループ コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

例

作成

curl（コマンドライン）

リスト

curl（コマンドライン）

パッチ

curl（コマンドライン）

メディエーショングループ