Esta página foi traduzida pela API Cloud Translation.

Mapeamentos de blocos de anúncios

Os mapeamentos de blocos de anúncios são configurações de terceiros que são associadas a um bloco de anúncios da AdMob e permitem que ele faça uma solicitação de anúncio a uma rede de anúncios de terceiros.

Ao criar um grupo de mediação, os mapeamentos de blocos de anúncios são usados como um parâmetro para cada linha de grupo de mediação e como configurações para o bloco de anúncios especificado para fazer solicitações de rede de publicidade de terceiros. Diferentemente da interface da AdMob, os mapeamentos de blocos de anúncios precisam ser criados de forma independente, fora dos grupos de mediação e das linhas de grupos de mediação. Após a criação, é possível listar todos os mapeamentos de blocos de anúncios e usá-los como um parâmetro ao criar ou atualizar linhas de grupos de mediação com novos mapeamentos de blocos de anúncios.

Exemplos

Depois de criar as credenciais do OAuth 2.0, você já pode começar a usar a API AdMob. Para solicitar acesso usando o OAuth 2.0, seu aplicativo também precisa das informações de escopo.

Confira as informações de escopo do OAuth 2.0:

Escopo	Significado
`https://www.googleapis.com/auth/admob.monetization`	Acesse, crie e edite as configurações de monetização da AdMob.
`https://www.googleapis.com/auth/admob.readonly`	Veja todos os dados da AdMob. Isso pode incluir informações da conta, configurações de inventário e mediação, relatórios e outros. Dados confidenciais, como pagamentos ou detalhes da campanha, não serão incluídos.

Comece a criar seu primeiro mapeamento de bloco de anúncios:

curl (linha de comando)

Solicitações usando curl

Carregue o arquivo de chaves secretas do cliente e gere credenciais de autorização.

Na primeira vez que você realizar essa etapa, será necessário aceitar uma mensagem de autorização no navegador. Antes de aceitar, verifique se você fez login usando uma Conta do Google com acesso à API AdMob. Seu aplicativo será autorizado a acessar dados em nome de qualquer conta que estiver conectada no momento.

Para autenticação e autorização, recomendamos o uso de oauth2l, uma ferramenta simples de linha de comando para trabalhar com o Google OAuth 2.0. Instale o oauth2l e execute o comando abaixo, substituindo path_to_credentials_json por um caminho para um arquivo credentials.json que você faz o download ao registrar seu aplicativo em nuvem. Na primeira execução, o comando orienta você pelo fluxo de autorização do OAuth 2.0. As execuções seguintes atualizam o token automaticamente.
```
oauth2l header --json path_to_credentials_json --scope admob.readonly,admob.monetization
```

Liste as origens de anúncios.

Para conferir informações sobre a origem de anúncios da AdMob, substitua pub-XXXXXXXXXXXXXXXX pelo ID do editor. Consulte as instruções sobre como encontrar seu ID de editor.

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

Exemplo de resposta:

{
 "adSources": [
   {
     "name": "accounts/pub-XXXXXXXXXXXXXXXX/adSources/5450213213286189855",
     "adSourceId": "5450213213286189855",
     "title": "AdMob Network",
   }
 ]
}

Liste os adaptadores.

Substitua SSSSSSSSSSSSSSSSSSSS pelo ID da origem de anúncios dos adaptadores de interesse.

Use o comando a seguir para conferir uma lista de adaptadores:

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

Exemplo de resposta para a origem de anúncios da rede da AdMob com o ID 5450213213286189855:

{
 "adapters": [
  {
     "name": "accounts/pub-XXXXXXXXXXXXXXXX/adSources/5450213213286189855/adapters/1",
     "adapterId": "1",
     "title": "AdMob Network Android SDK",
     "platform": "ANDROID",
     "formats": ["BANNER", "INTERSTITIAL",
       "REWARDED", "NATIVE", "REWARDED_INTERSTITIAL", "APP_OPEN"],
     "adapterConfigMetadata": [{
       "adapterConfigMetadataId": "118",
       "adapterConfigMetadataLabel": "Ad unit ID"
     }]
  },
  {
     "name": "accounts/pub-XXXXXXXXXXXXXXXX/adSources/5450213213286189855/adapters/2",
     "adapterId": "2",
     "title": "AdMob Network iOS SDK",
     "platform": "ANDROID",
     "formats": ["BANNER", "INTERSTITIAL",
       "REWARDED", "NATIVE", "REWARDED_INTERSTITIAL", "APP_OPEN"],
     "adapterConfigMetadata": [{
       "adapterConfigMetadataId": "119",
       "adapterConfigMetadataLabel": "Ad unit ID"
     }]
  }]
}

Crie um mapeamento de bloco de anúncios.

Substitua YYYYYYYYYY pelo fragmento de ID do bloco de anúncios. O fragmento do ID do bloco de anúncios é composto pelos últimos 10 dígitos do ID do bloco de anúncios, que segue o formato "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY". Consulte as instruções para encontrar o ID do bloco de anúncios.

curl --http1.0 -X POST \
 https://admob.googleapis.com/v1beta/accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYYYYYYY/adUnitMappings \
 -H "$(oauth2l header --json path_to_credentials_json --scope admob.monetization)" \
 -H "Content-Type: application/json" --data @- << EOF
{
   "name": "InMobi ad unit mapping",
   "adapterId": "8",
   "adUnitConfigurations": {
     "174": "inMobiAccountId",
     "176": "inMobiPlacementId"
   }
}
EOF

Lista todos os mapeamentos de blocos de anúncios.

Substitua YYYYYYYYYY pelo fragmento do ID do bloco de anúncios. O fragmento do ID do bloco de anúncios é composto pelos últimos 10 dígitos do ID do bloco de anúncios no formato "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY". Consulte as instruções para encontrar o ID do bloco de anúncios.

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

{
 "adUnitMappingName":
 "accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYYYYYYY/adUnitMappings/ZZZZZZZZZZ"
   {
     "adapterId": "1",
     "state": "ENABLED",
     "adUnitConfigurations": {
       "adUnitMappingConfigurationKey": "adUnitId",
       "adUnitMappingConfigurationValue": "118",
     }
   }
}