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 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 para o bloco de anúncios especificado 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 de mediação e linhas de grupo de mediação. Depois da criação, você pode 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ê poderá começar a usar a API AdMob. Para solicitar acesso usando o OAuth 2.0, seu aplicativo também precisará das informações de escopo.

Confira as informações de 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 Ver 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. Isso não inclui dados sensíveis, como pagamentos ou detalhes da campanha.

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

curl (linha de comando)

Solicitações usando curl

  1. Carregue o arquivo de segredos do cliente e gere credenciais de autorização.

    Na primeira vez que fizer isso, será solicitado que você aceite uma mensagem de autorização no navegador. Antes de aceitar, verifique se você fez login com uma Conta do Google que tenha acesso à API AdMob. Seu aplicativo será autorizado a acessar dados em nome da conta que estiver conectada no momento.

    Para autenticação e autorização, recomendamos o uso do 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. Liste as origens de anúncios.

    Para receber informações sobre a origem de anúncios da AdMob, substitua pub-XXXXXXXXXXXXXXXX pelo ID do publisher. Confira as instruções sobre como encontrar o 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 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"
     }]
  }]
}

  4. Crie um mapeamento 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, que segue o formato "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY". Confira 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. Liste 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". Confira 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",
     }
   }
}