Mapeamentos de blocos de anúncios

Os mapeamentos de blocos de anúncios são configurações de terceiros que mapeiam um bloco de anúncios da AdMob e permitem que ele faça uma solicitação de anúncio para uma rede de publicidade 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 do grupo de mediação como configurações do bloco de anúncios especificado para fazer solicitações de rede de publicidade de terceiros. Ao contrário da interface da AdMob, os mapeamentos de blocos de anúncios precisam ser criados de forma independente fora dos grupos e das linhas de mediação. Depois da 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 grupo de mediação com novos mapeamentos.

Exemplos

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

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

Escopo Significado
https://www.googleapis.com/auth/admob.monetization Ver, criar e editar suas configurações de monetização da AdMob.
https://www.googleapis.com/auth/admob.readonly Confira 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. Dados confidenciais, como pagamentos ou detalhes da campanha, não serão incluídos.

Para começar a criar seu primeiro mapeamento de bloco de anúncios:

curl (linha de comando)

Solicitações usando curl

  1. 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 solicitação de autorização no navegador. Antes de aceitar, verifique se você fez login com uma Conta do Google que tem acesso à API AdMob. Seu aplicativo será autorizado a acessar dados em nome da conta conectada no momento.

    Para autenticação e autorização, recomendamos usar o oauth2l, uma ferramenta de linha de comando simples para trabalhar com o OAuth 2.0 do Google. Instale o oauth2l e execute o comando abaixo, substituindo path_to_credentials_json por um caminho para um arquivo credentials.json que você baixa ao registrar seu aplicativo na nuvem. Na primeira execução, o comando orienta você pelo fluxo de autorização do OAuth 2.0. As execuções subsequentes atualizam o token automaticamente.

    oauth2l header --json path_to_credentials_json --scope admob.readonly,admob.monetization

  2. Lista as origens de anúncios.

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

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

  3. Liste os adaptadores.

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

    Use o comando a seguir para acessar 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 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"
     }]
  }]
}

  4. Crie um mapeamento de bloco de anúncios.

    Substitua YYYYYYYYYY pelo fragmento do ID do bloco de anúncios. O fragmento do ID do bloco de anúncios são os últimos 10 dígitos do ID do bloco de anúncios, que seguem 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

  5. Listar 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 são os ú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",
     }
   }
}