ディメンションと指標のメタデータ

AdSense Management API でメタデータを呼び出すと、使用可能なディメンション指標のリストを作成したり、各ディメンションと各指標の互換性やサポートされているサービスを確認したりできます。呼び出しの結果の例を次に示します。

{
  "kind": "adsense#reportingMetadataEntry",
  "id": "EXAMPLE_DIMENSION",
  "compatibleDimensions": [
    "1",
    "2",
    "4",
    ...
  ],
  "compatibleMetrics": [
    "AD_REQUESTS",
    "AD_REQUESTS_COVERAGE",
    "AD_REQUESTS_CTR",
    ...
  ],
  "supportedProducts": [
    "AFMC",
    "AFC",
    "AFV"
  ]
}

compatibleMetrics フィールドでは、ディメンションと互換性のある指標のリストが表示されます。ある指標をレポートで使用する場合は、その指標がリクエストしたすべてのディメンションと互換性があることを確認する必要があります。

ディメンション間の互換性については、もう少し問題が複雑になります。

ディメンションの互換性について

compatibleDimensions フィールドでは、互換性のあるディメンションのグループを示す整数が表示されます。ディメンション間の互換性は 1 対 1 対応ではないため、下記のグループ別に表示されます。

グループ #1グループ #2グループ #3グループ #4
AD_CLIENT_IDAD_CLIENT_IDAD_CLIENT_IDAD_CLIENT_ID
AD_FORMAT_CODEAD_FORMAT_CODEAD_FORMAT_CODEAD_FORMAT_CODE
AD_FORMAT_NAMEAD_FORMAT_NAMEAD_FORMAT_NAMEAD_FORMAT_NAME
AD_UNIT_CODE
AD_UNIT_ID
AD_UNIT_NAME
AD_UNIT_SIZE_CODE
AD_UNIT_SIZE_NAME
BID_TYPE_CODEBID_TYPE_CODEBID_TYPE_CODEBID_TYPE_CODE
BID_TYPE_NAMEBID_TYPE_NAMEBID_TYPE_NAMEBID_TYPE_NAME
COUNTRY_CODECOUNTRY_CODE
COUNTRY_NAMECOUNTRY_NAME
CUSTOM_CHANNEL_CODE
CUSTOM_CHANNEL_ID
CUSTOM_CHANNEL_NAME
BUYER_NETWORK_ID
BUYER_NETWORK_NAME
DATEDATEDATEDATE
DOMAIN_NAME
MONTHMONTHMONTHMONTH
PLATFORM_TYPE_CODEPLATFORM_TYPE_CODEPLATFORM_TYPE_CODEPLATFORM_TYPE_CODE
PLATFORM_TYPE_NAMEPLATFORM_TYPE_NAMEPLATFORM_TYPE_NAMEPLATFORM_TYPE_NAME
PRODUCT_CODEPRODUCT_CODEPRODUCT_CODEPRODUCT_CODE
PRODUCT_NAMEPRODUCT_NAMEPRODUCT_NAMEPRODUCT_NAME
TARGETING_TYPE_CODETARGETING_TYPE_CODETARGETING_TYPE_CODETARGETING_TYPE_CODE
TARGETING_TYPE_NAMETARGETING_TYPE_NAMETARGETING_TYPE_NAMETARGETING_TYPE_NAME
WEEKWEEKWEEKWEEK

上の表について、次の点に注意が必要です。

  • DATEMONTHWEEK の各ディメンションはすべてのグループと互換性があります。
  • DOMAIN_NAME(グループ #1)は CUSTOM_CHANNEL_*(グループ #4)と互換性がありません。
  • カスタム チャネルは 1 つまたは複数の広告ユニットに適用される可能性があるため、広告ユニット関連のディメンション(グループ #3)を使用する場合はカスタム チャネル関連のディメンション(グループ #4)は使用できません。
  • 国名関連のディメンション(グループ #3 と #4)は広告ユニット関連のディメンション(グループ #3)またはカスタム チャネル関連のディメンション(グループ #4)のいずれか一方と併用できますが、両方と併用することはできません。

次のステップ