광고 단위 매핑

광고 단위 매핑은 AdMob 광고 단위에 매핑되어 서드 파티 광고 네트워크에 광고를 요청할 수 있게 하는 서드 파티 구성 설정입니다.

미디에이션 그룹을 만들 때 광고 단위 매핑은 각 미디에이션 그룹 라인의 매개변수로, 지정된 광고 단위가 서드 파티 광고 네트워크 요청을 할 때의 설정으로 사용됩니다. AdMob UI와 달리 광고 단위 매핑은 미디에이션 그룹 및 미디에이션 그룹 행 밖에서 독립적으로 만들어야 합니다. 생성 후 모든 광고 단위 매핑을 나열하고 새 광고 단위 매핑으로 미디에이션 그룹 라인을 만들거나 업데이트할 때 매핑을 매개변수로 사용할 수 있습니다.

OAuth 2.0 사용자 인증 정보가 생성되면 AdMob API를 사용할 수 있습니다. OAuth 2.0을 사용하여 액세스를 요청하려면 애플리케이션에 범위 정보도 필요합니다.

다음은 OAuth 2.0 범위 정보입니다.

범위 의미
https://www.googleapis.com/auth/admob.monetization AdMob 수익 창출 설정을 확인, 생성, 수정합니다.
https://www.googleapis.com/auth/admob.readonly 모든 AdMob 데이터를 확인합니다. 여기에는 계정 정보, 인벤토리 및 미디에이션 설정, 보고서 및 기타 데이터가 포함될 수 있습니다. 결제나 캠페인 세부정보와 같은 민감한 정보는 포함되지 않습니다.

첫 번째 광고 단위 매핑을 만들어 보세요.

curl (명령줄)

curl을 사용하는 요청

  1. 클라이언트 보안 비밀번호 파일을 로드하고 승인 사용자 인증 정보를 생성합니다.

    이 단계를 처음 수행하면 브라우저에서 승인 메시지를 수락하라는 메시지가 표시됩니다. 동의하기 전에 AdMob API에 액세스할 수 있는 Google 계정으로 로그인했는지 확인하세요. 애플리케이션은 현재 로그인되어 있는 계정을 대신하여 데이터에 액세스하도록 승인됩니다.

    인증 및 승인에는 Google OAuth 2.0을 사용하는 간단한 명령줄 도구인 oauth2l을 사용하는 것이 좋습니다. oauth2l을 설치하고 아래 명령어를 실행합니다. 이때 path_to_credentials_json를 클라우드 애플리케이션을 등록할 때 다운로드하는 credentials.json 파일의 경로로 바꿉니다. 처음 실행 시 명령어를 통해 OAuth 2.0 승인 절차가 진행됩니다. 후속 실행에서는 토큰이 자동으로 새로고침됩니다.

    oauth2l header --json path_to_credentials_json --scope admob.readonly,admob.monetization
    
  2. 광고 소스를 나열합니다.

    pub-XXXXXXXXXXXXXXXX를 게시자 ID로 대체하여 AdMob 광고 소스 정보를 가져옵니다. 게시자 ID를 찾는 방법은 안내를 참고하세요.

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

    샘플 응답:

    {
     "adSources": [
       {
         "name": "accounts/pub-XXXXXXXXXXXXXXXX/adSources/5450213213286189855",
         "adSourceId": "5450213213286189855",
         "title": "AdMob Network",
       }
     ]
    }
  3. 어댑터를 나열합니다.

    SSSSSSSSSSSSSSSSSSSS를 관심 있는 어댑터의 광고 소스 ID로 바꿉니다.

    다음 명령어를 사용하여 어댑터 목록을 가져옵니다.

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

    ID가 5450213213286189855인 AdMob 네트워크 광고 소스의 샘플 응답은 다음과 같습니다.

    {
     "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. 광고 단위 매핑을 만듭니다.

    YYYYYYYYYY를 광고 단위 ID 프래그먼트로 바꿉니다. 광고 단위 ID 프래그먼트는 'ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY' 형식의 광고 단위 ID의 마지막 10자리입니다. 광고 단위 ID를 찾는 방법에 관한 안내를 참고하세요.

    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. 모든 광고 단위 매핑을 나열합니다.

    YYYYYYYYYY를 광고 단위 ID 프래그먼트로 바꿉니다. 광고 단위 ID 프래그먼트는 'ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY' 형식의 광고 단위 ID에서 마지막 10자리입니다. 광고 단위 ID를 찾는 방법을 참고하세요.

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