Vermittlungsgruppen

Mit der AdMob API können Sie Vermittlungsgruppen erstellen, auflisten und aktualisieren. Dazu gehören:

  • Targeting von Vermittlungsgruppen angeben, einschließlich Targeting nach Regionen, Format, Plattform und IDFA
  • Einer bestehenden Vermittlungsgruppe neue Vermittlungsgruppenzeilen hinzufügen
  • Anzeigen, welche Vermittlungsgruppen Teil eines A/B-Tests für die Vermittlung sind und welche Vermittlungsgruppenzeilen zu den einzelnen Varianten (A oder B) gehören

Beispiele

Nachdem Sie OAuth 2.0-Anmeldedaten erstellt haben, können Sie die AdMob API verwenden. Zur Anforderung eines Zugriffs mit OAuth 2.0 benötigt Ihre Anwendung auch die Informationen zum Umfang.

Hier sind die OAuth 2.0-Bereichsinformationen:

Bereich Bedeutung
https://www.googleapis.com/auth/admob.monetization AdMob-Monetarisierungseinstellungen abrufen, erstellen und bearbeiten
https://www.googleapis.com/auth/admob.readonly Alle AdMob-Daten ansehen Dazu können Kontoinformationen, Inventar- und Vermittlungseinstellungen, Berichte und andere Daten gehören. Nicht enthalten sind sensible Daten wie Zahlungs- und Kampagnendetails.

Erstellen

Wenn Sie eine Vermittlungsgruppe erstellen möchten, müssen Sie die Informationen zum Targeting der Vermittlungsgruppe angeben, einschließlich der relevanten Anzeigenblöcke. Im folgenden Beispiel wird eine neue Vermittlungsgruppe für Android-Interstitial-Anzeigen für zwei Anzeigenblöcke erstellt. Beim Erstellen wird eine Zeile für die InMobi-Anzeigenquelle hinzugefügt. Sie müssen das AdMob-Werbenetzwerk nicht einfügen, da es standardmäßig bei der Erstellung hinzugefügt wird.

Ersetzen Sie im folgenden Code-Snippet pub-XXXXXXXXXXXXXXXX durch Ihre Publisher-ID.

Ersetzen Sie dann YYYYYYYYYY durch die letzten 10 Ziffern Ihrer Anzeigenblock-ID. Das Format muss dabei so aussehen:

ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY

Da es in diesem Beispiel zwei Anzeigenblöcke gibt, bezieht sich YYYYY11111 auf den ersten Anzeigenblock und WWWWW11111 auf die Zuordnung des ersten Anzeigenblocks. YYYYY22222 und WWWWW22222 beziehen sich auf den zweiten Anzeigenblock und die zweite Anzeigenblockzuordnung.

curl (Befehlszeile)

Ersetzen Sie WWWWWWWWWW durch die ID der Anzeigenblockzuordnung. Die ID der Anzeigenblockzuordnung lässt sich mit der Methode accounts.adUnits.adUnitMappings.list ermitteln.

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

Liste

Ersetzen Sie pub-XXXXXXXXXXXXXXXX durch Ihre Publisher-ID, um Ihre Vermittlungsgruppen aufzurufen.

curl (Befehlszeile)

Beispielanfrage:

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

Beispielantwort:

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

Patch

Hier finden Sie die Liste der Feldmasken zum Aktualisieren einer Vermittlungsgruppe. Bei Aktualisierungen von wiederholten Feldern, z. B. Elementen in einer Liste, werden vorhandene Werte vollständig durch neue Werte ersetzt. Einzelne Werte in einer Map können durch Indexierung nach dem Schlüssel aktualisiert werden.

Die folgenden Feldmasken werden für Aktualisierungen von Vermittlungsgruppen unterstützt:

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

Wenn Sie eine Vermittlungsgruppe mit einer neuen Vermittlungsgruppenzeile aktualisieren möchten, verwenden Sie eine eindeutige negative Zahl für die mediationGroupLineId. Wenn Sie vorhandene Vermittlungsgruppenzeilen aktualisieren möchten, verweisen Sie sowohl in update_mask als auch in der Nutzlast auf die ID der Vermittlungsgruppenzeile, wie unten dargestellt.

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

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

curl (Befehlszeile)

Im Beispiel unten werden einer bestehenden Vermittlungsgruppe drei neue Vermittlungszeilen hinzugefügt. updateMask enthält die drei Vermittlungsgruppenzeilen mit unterschiedlichen negativen Werten als Platzhalter:

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

Sonderzeichen müssen umgewandelt werden, da alle URLs der Syntax entsprechen müssen, die in der Spezifikation Uniform Resource Identifier (URI) angegeben ist. updateMask wird also zu:

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

Ersetzen Sie im folgenden Beispiel pub-XXXXXXXXXXXXXXXX durch Ihre Publisher-ID und ZZZZZZZZZZ durch Ihre Vermittlungsgruppen-ID. Die Vermittlungsgruppen-ID finden Sie in der AdMob-Benutzeroberfläche oder mit der Methode accounts.mediationGroups:list.

Ersetzen Sie YYYYYYYYYY durch die letzten 10 Ziffern Ihrer Anzeigenblock-ID. Das Format ist:

ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY`

Ersetzen Sie WWWWWWWWWW durch die ID der Anzeigenblockzuordnung. Die Zuordnungs-ID des Anzeigenblocks lässt sich mit der Methode accounts.adUnits.adUnitMappings.list ermitteln.

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