Ta strona została przetłumaczona przez Cloud Translation API.

Grupy zapośredniczenia

Interfejs AdMob API pozwala tworzyć, wyświetlać i aktualizować grupy zapośredniczenia, w tym:

określać kierowanie na grupę zapośredniczenia, w tym regiony, format, platforma i identyfikator IDFA
dodawać nowe wiersze grupy zapośredniczenia, do istniejącej grupy zapośredniczenia
sprawdzanie, które grupy zapośredniczenia uczestniczą w eksperymencie A/B zapośredniczenia i co wiersze grupy zapośredniczenia należą do każdego wariantu: A lub B

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 będzie też potrzebować informacji o zakresie.

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`	Zobacz wszystkie dane AdMob. Może to obejmować konto informacje, ustawienia zasobów reklamowych i zapośredniczenia, raporty oraz 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 określić kierowanie na tę grupę. informacje, w tym odpowiednie jednostki reklamowe. Ten przykład pozwala utworzyć nowy grupa zapośredniczenia dla reklam pełnoekranowych na Androida w dwóch jednostkach reklamowych. 1 grupa zapośredniczenia dla źródła reklam InMobi jest dodawany wiersz podczas tworzenia źródła reklam InMobi. Nie musisz dodawać z siecią AdMob, która zostanie dodana domyślnie podczas tworzenia.

We fragmencie kodu poniżej zastąp pub-XXXXXXXXXXXXXXXX nazwą wydawcy Identyfikator.

Następnie zastąp ciąg YYYYYYYYYY ostatnim 10 cyframi swojej jednostki reklamowej ID, zgodnie z zasadami na format:

ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY

Ponieważ w tym przykładzie są 2 jednostki reklamowe, YYYYY11111 odnosi się do pierwszej reklamy. i WWWWW11111 do mapowania pierwszej jednostki reklamowej. YYYYY22222 i WWWWW22222 odnoszą się do drugiej jednostki reklamowej i mapowania jednostek reklamowych.

curl (wiersz poleceń)

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

Zastąp pub-XXXXXXXXXXXXXXXX nazwą wydawcy ID, aby wyświetlić grupy zapośredniczenia.

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 pól maski aby zaktualizować grupę zapośredniczenia. Aktualizacje pól powtarzanych, takich jak elementy w , zastąp wszystkie istniejące wartości nowymi wartościami. Aktualizacje dotyczące osoby fizycznej wartości w mapie można przeprowadzać przez indeksowanie za pomocą klucza.

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

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

Aby dodać do grupy zapośredniczenia nowy wiersz, użyj innego parametru liczba ujemna w kolumnie mediationGroupLineId. Aby zaktualizować istniejące zapośredniczenie linie grupy, odwołaj się do identyfikatora tej grupy zapośredniczenia w update_mask i jak widać 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 dodajesz 3 nowe wiersze zapośredniczenia do dotychczasowej grupy zapośredniczenia. Element updateMask obejmuje 3 wiersze grupy zapośredniczenia z charakterystycznymi ujemnymi jako obiekt zastępczy:

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

Trzeba przetłumaczyć znaki specjalne, bo wszystkie adresy URL muszą spełniać wymagania składnia określona w specyfikacji identyfikatora URI, więc updateMask zmieni się w:

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, zamień pub-XXXXXXXXXXXXXXXX na wydawcy oraz ZZZZZZZZZZ z Twoim identyfikatorem grupy zapośredniczenia. Zapośredniczenie identyfikator grupy możesz znaleźć w interfejsie AdMob lub w narzędziu accounts.mediationGroups:list. .

Zamień YYYYYYYYYY na 10 ostatnich cyfr swojej jednostki reklamowej Identyfikator w formacie:

ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY`

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

Grupy zapośredniczenia Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Przykłady

Utwórz

curl (wiersz poleceń)

Lista

curl (wiersz poleceń)

Poprawka

curl (wiersz poleceń)

Grupy zapośredniczenia