Vermittlungsgruppen

Mit der AdMob API können Sie folgende Vermittlungsgruppen erstellen, auflisten und aktualisieren:

  • Targeting für Vermittlungsgruppen festlegen einschließlich der Ausrichtung auf Regionen, Format, Plattform und IDFA
  • Neue Zeilen für Vermittlungsgruppen hinzugefügt mit einer bestehenden Vermittlungsgruppe
  • Ansehen, welche Vermittlungsgruppen Teil eines A/B-Tests mit Vermittlungsgruppen sind und was Zeilen in Vermittlungsgruppen gehören zu jeder Variante: A oder B.

Beispiele

Nachdem Sie OAuth 2.0-Anmeldedaten erstellt haben, gehen Sie so vor: können Sie die AdMob API verwenden. So fordern Sie den Zugriff mit OAuth 2.0 an: benötigt Ihre Anwendung auch die Informationen zum Umfang.

Im Folgenden finden Sie die Informationen zum Umfang von OAuth 2.0:

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

Erstellen

Wenn Sie eine Vermittlungsgruppe erstellen möchten, müssen Sie die Ausrichtung 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. Eine Vermittlungsgruppe wird bei der Erstellung für die InMobi-Anzeigenquelle hinzugefügt. Sie müssen keine AdMob-Werbenetzwerk, da es standardmäßig bei der Erstellung hinzugefügt wird.

Ersetzen Sie im Code-Snippet unten pub-XXXXXXXXXXXXXXXX durch Ihren Publisher. ID fest.

Ersetzen Sie dann YYYYYYYYYY durch die letzten 10 Ziffern Ihres Anzeigenblocks. ID, entspricht in folgendes Format ein:

ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY

Da es in diesem Beispiel zwei Anzeigenblöcke gibt, bezieht sich YYYYY11111 auf die erste Anzeige. und WWWWW11111 mit der Zuordnung des ersten Anzeigenblocks. YYYYY22222 und WWWWW22222 beziehen sich auf die zweite Zuordnung von Anzeigenblock und Anzeigenblock.

curl (Befehlszeile)

Ersetzen Sie WWWWWWWWWW durch Ihre Anzeigenblockzuordnungs-ID. Die Zuordnungs-ID des Anzeigenblocks können über die 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"
      }
  }
}

Liste

Ersetzen Sie pub-XXXXXXXXXXXXXXXX durch Ihren 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 ist die Liste der Felder Masken um eine Vermittlungsgruppe zu aktualisieren. Aktualisierungen wiederholter Felder, z. B. von Elementen in einem ersetzen Sie vorhandene Werte vollständig durch neue Werte. Aktualisierungen für einzelne Werte in einer Zuordnung können durch Indexierung des Schlüssels erfolgen.

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 Zeile aktualisieren möchten, verwenden Sie eine andere negative Zahl für mediationGroupLineId. So aktualisieren Sie die Vermittlung „group“, auf die Zeilen-ID der Vermittlungsgruppe in update_mask und die Nutzlast, wie unten zu sehen.

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

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

curl (Befehlszeile)

Im folgenden Beispiel werden einer bestehenden Vermittlungsgruppe drei neue Vermittlungszeilen hinzugefügt. updateMask enthält die drei Zeilen für die Vermittlungsgruppe mit unterschiedlichen negativen -Werte als Platzhalter verwenden:

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

Sonderzeichen müssen übersetzt werden, da alle URLs den die in der URI-Spezifikation (Uniform Resource Identifier) angegeben ist, Dadurch wird updateMask zu:

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

Um das folgende Beispiel auszuführen, ersetzen Sie pub-XXXXXXXXXXXXXXXX durch Ihren Publisher-ID und ZZZZZZZZZZ durch Ihre Vermittlungsgruppen-ID. Die Vermittlung Die Gruppen-ID finden Sie in der AdMob-Benutzeroberfläche oder über die accounts.mediationGroups:list .

Ersetzen Sie YYYYYYYYYY durch die letzten 10 Ziffern Ihres Anzeigenblocks. ID im folgenden Format:

ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY`

Ersetzen Sie WWWWWWWWWW durch Ihre Anzeigenblockzuordnungs-ID. Die Zuordnungs-ID des Anzeigenblocks können über die accounts.adUnits.adUnitMappings.list .

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