Grupy zapośredniczenia

Interfejs AdMob API umożliwia tworzenie, wyświetlanie i aktualizowanie grup zapośredniczenia, w tym:

  • Określanie kierowania na grupy zapośredniczenia, w tym kierowania na regiony, format, platformę i identyfikator IDFA.
  • Dodawanie nowych wierszy grupy zapośredniczenia do istniejącej grupy zapośredniczenia
  • Wyświetlanie grup zapośredniczenia, które są częścią eksperymentu A/B zapośredniczenia, oraz linii grup zapośredniczenia należących do poszczególnych wariantów: A lub B.

menedżerem konta.

Przykłady

Po utworzeniu danych logowania OAuth 2.0 możesz zacząć korzystać z interfejsu AdMob API. Aby poprosić o dostęp przy użyciu protokołu OAuth 2.0, aplikacja potrzebuje też danych z zakresu.

Oto informacje o zakresie protokołu OAuth 2.0:

Zakres Znaczenie
https://www.googleapis.com/auth/admob.monetization Wyświetlanie, tworzenie i edytowanie ustawień zarabiania w AdMob.
https://www.googleapis.com/auth/admob.readonly wyświetlać wszystkie dane AdMob; Mogą to być informacje o koncie, ustawienia dotyczące zasobów reklamowych i mediacji, raporty i inne dane. Nie obejmuje to danych wrażliwych, takich jak informacje o płatnościach czy szczegóły kampanii.

Utwórz

Aby utworzyć grupę zapośredniczenia, musisz podać informacje o kierowaniu grupy zapośredniczenia, w tym odpowiednie jednostki reklamowe. W tym przykładzie tworzymy nową grupę zapośredniczenia dla reklam pełnoekranowych na Androida w 2 jednostkach reklamowych. Podczas tworzenia grupy zapośredniczenia dodawana jest jedna linia dla źródła reklam InMobi. Nie musisz uwzględniać sieci AdMob, ponieważ zostanie ona dodana domyślnie podczas tworzenia grupy.

We fragmencie kodu poniżej zastąp symbol pub-XXXXXXXXXXXXXXXX swoim identyfikatorem wydawcy.

Następnie zastąp symbol YYYYYYYYYY ostatnimi 10 cyframi identyfikatora jednostki reklamowej, zachowując format:

ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY

W tym przykładzie są 2 jednostki reklamowe, więc YYYYY11111 odnosi się do pierwszej jednostki reklamowej, a WWWWW11111 do mapowania pierwszej jednostki reklamowej. YYYYY22222 i WWWWW22222 odnoszą się do drugiej jednostki reklamowej i drugiego mapowania jednostki reklamowej.

curl (wiersz poleceń)

Zastąp symbol WWWWWWWWWW identyfikatorem mapowania jednostki reklamowej. Identyfikator mapowania jednostki reklamowej można znaleźć za pomocą metody 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"
      }
  }
}

Lista

Aby wyświetlić grupy zapośredniczenia, zastąp pub-XXXXXXXXXXXXXXXX swoim identyfikatorem wydawcy.

curl (wiersz poleceń)

Przykładowe żądanie:

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

Przykładowa odpowiedź:

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

Poprawka

Oto lista masek pól do aktualizowania grupy zapośredniczenia. Aktualizacje pól powtarzanych, takich jak elementy listy, całkowicie zastępują dotychczasowe wartości nowymi. Aktualizacje poszczególnych wartości w mapie można przeprowadzać za pomocą indeksowania według klucza.

W przypadku aktualizacji grup zapośredniczenia obsługiwane są te maski pól:

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

Aby zaktualizować grupę zapośredniczenia o nowy wiersz grupy zapośredniczenia, użyj odrębnej liczby ujemnej w przypadku parametru mediationGroupLineId. Aby zaktualizować istniejące wiersze grupy zapośredniczenia, odwołaj się do identyfikatora wiersza grupy zapośredniczenia zarówno w parametrze update_mask, jak i w ładunku, jak pokazano poniżej.

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

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

curl (wiersz poleceń)

W przykładzie poniżej do dotychczasowej grupy zapośredniczenia dodano 3 nowe linie zapośredniczenia. updateMask obejmuje 3 wiersze grupy zapośredniczenia z różnymi wartościami ujemnymi jako symbolami zastępczymi:

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

Znaki specjalne należy przetłumaczyć, ponieważ wszystkie adresy URL muszą być zgodne ze składnią określoną w specyfikacji identyfikatora URI, więc znak updateMask staje się:

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

Aby uruchomić poniższy przykład, zastąp pub-XXXXXXXXXXXXXXXX identyfikatorem wydawcy, a ZZZZZZZZZZ identyfikatorem grupy zapośredniczenia. Identyfikator grupy zapośredniczenia znajdziesz w interfejsie AdMob lub za pomocą metody accounts.mediationGroups:list.

Zastąp YYYYYYYYYY 10 ostatnimi cyframi identyfikatora jednostki reklamowej w tym formacie:

ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY`

Zastąp symbol WWWWWWWWWW identyfikatorem mapowania jednostki reklamowej. Identyfikator mapowania jednostki reklamowej można znaleźć za pomocą metody 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