検索広告 360 リニューアル版の ID マッピング

新しい Search Ads 360 Reporting API をご利用いただけるようになりました。新しい API では、柔軟性の向上により、カスタム レポートを作成し、レポート作成のアプリケーションやプロセスにデータを統合することができます。詳しくは、新しい Search Ads 360 Reporting API への移行と使用についての記事をご覧ください。

検索広告 360 リニューアル版のエンティティの ID 空間は、検索広告 360 従来版とは異なります。 検索広告 360 従来版とリニューアル版の間の ID マッピングを取得するには、 Reports.getIdMappingFile() リクエストを送信します。レスポンスには、指定した広告主のすべてのエンティティの ID マッピングが含まれます。

返されたファイルの例を次に示します（UTF-8 でエンコードされた CSV 形式）。

Entity Type,Legacy IDs,New IDs
CUSTOMER,"{""agencyId"":""20700000000000125"",""advertiserId"":""2170000012345"",""engineAccountId"":""700000000042205""}","{""customerId"":""200001235""}"

CSV ファイルには次の 3 つの列があります。

  • Entity Type: この行のエンティティ タイプ。

  • Legacy IDs: 検索広告 360 従来版でのエンティティの完全なパスの JSON 文字列

  • New IDs: 検索広告 360 リニューアル版でのエンティティの完全なパスの JSON 文字列

次の表に、サポートされているエンティティと ID マッピングの例を示します。

エンティティ タイプ 説明 以前の ID 新しい ID
お客様の ID マッピング: 
advertiser:
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345"
}

account:
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205"
}
          
{
"customerId": "200001235"
}
キャンペーン キャンペーンの ID マッピング。 
{
 "agencyId":"20700000000000125",
 "advertiserId":"2170000012345",
 "engineAccountId":"700000000042205",
 "campaignId":"71700000087192405"
}
          
{
  "customerId": "200001235",
  "campaignId": "14660344555"
}
AD_GROUP adGroup の ID マッピング。 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000084761225",
  "adGroupId": "58700007213529045"
}
          
{
  "customerId": "200001235",
  "campaignId": "13666840065",
  "adGroupId": "127701366165"
}
基準 ID マッピング: 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000068948065",
  "adGroupId": "58700006123995025",
  "AdGroupCriterionId": "46700015332504045"
}
          
{
  "customerId": "200001235",
  "campaignId": "14660344555",
  "adGroupId":"105138634255",
  "criterionId":"948710340465"
}
AD ad の ID マッピング。 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000065395945",
  "adGroupId": "58700005797210525",
  "adId": "44700029299414085"
}
          
{
  "customerId": "200001235",
  "campaignId": "15314179325",
  "adGroupId": "131599768485",
  "adId": "562719339005"
}
CAMPAIGN_CRITERION ID マッピング: 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000084403015",
  "campaignTargetId": "38700011011700285"
}
          
{
  "customerId": "200001235",
  "campaignId": "13467100745",
  "campaignCriterionId": "2125"
}
CAMPAIGN_GROUP キャンペーン グループの ID マッピング。 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "budgetGroupId": "87700002234256082"
}
          
{
  "customerId": "200001235",
  "campaignGroupId": "1000665659"
}
CAMPAIGN_GROUP_PERFORMANCE_TARGET キャンペーン グループの成果目標の ID マッピング。 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "budgetGroupId": "87700002234256082",
  "budgetPlanId": "88700007187391026"
}
          
{
  "customerId": "200001235",
  "campaignGroupId": "1000665659"
  "campaignGroupPerformanceTargetId": "7624175"
}
FEED_TABLE フィードテーブルの ID マッピング。 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "feedTableId": "32700008040329135"
}
          
{
  "customerId": "200001235",
  "feedId": "207040045"
}
FEED_ITEM feedItem の ID マッピング。 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "feedTableId": "32700014854183375",
  "feedItemRowId": "33700014854183415"
}
          
{
  "customerId": "200001235",
  "feedId": "377982485",
  "feedItemId": "235028589065"
}

レポートをダウンロード

JSON

GET https://www.googleapis.com/doubleclicksearch/v2/agency/agencyId/advertiser/advertiserId/idmapping?alt=media

Python

def download_mapping_file(service, file_name, agency_id, advertiser_id):
  """Generate and save mapping file to a csv.

  Args:
    service: An authorized Doubleclicksearch service.
    file_name: Filename to write the ID mapping file.
    agency_id: DS ID of the agency.
    advertiser_id: DS ID of the advertiser.
  """
  request = service.reports().getIdMappingFile_media(agencyId=agency_id,
      advertiserId=advertiser_id)

  f = open(file_name + '.csv', 'w')
  f.write(request.execute().decode('utf-8'))
  f.close()

オブジェクト ID の一意性

検索広告 360 リニューアル版では、オブジェクトはすべて固有の ID で識別されます。ID には、検索広告 360 リニューアル版のすべてのアカウントでグローバル レベルで一意になるものと、特定の範囲内でのみ一意であるものがあります。たとえば、広告 ID は広告グループごとに一意に割り当てられますが、広告グループ間では割り当てられないため、広告を一意に識別するには、広告グループ ID と広告 ID の両方を使用する必要があります。検索広告 360 リニューアル版内の各オブジェクト ID の一意性は下記のとおりです。これらの ID ルールは、検索広告 360 リニューアル版のオブジェクト用のローカル ストレージを設計する際に便利です。

オブジェクト ID 一意性の範囲 グローバル レベルでの一意性
Budget ID グローバル ○
キャンペーン ID グローバル ○
AdGroup ID グローバル ○
Ad ID 広告グループ いいえ。（AdGroupId、AdId）ペアはグローバルに一意です。
AdGroupCriterion ID 広告グループ いいえ。（AdGroupId、CriterionId）ペアはグローバルに一意です。
CampaignCriterion ID キャンペーン いいえ。（CampaignId、CriterionId）ペアはグローバルに一意です。
広告表示オプション キャンペーン いいえ。（CampaignId、AdExtensionId）ペアはグローバルに一意です。
フィード ID グローバル ○
Feed Item ID グローバル ○
Feed Attribute ID フィード ×
Feed Mapping ID グローバル ○
Label ID グローバル ○
ユーザーリスト ID グローバル ○