検索広告 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 マッピング: 
adGroupTarget and negativeAdGroupTarget:
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000068948065",
  "adGroupId": "58700006123995025",
  "adGroupTargetId": "46700015332504045"
}

keyword:
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000068948065",
  "adGroupId": "58700006123995025",
  "criterionId": "46700015332504045"
}

negativeAdGroupKeyword:
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000068948065",
  "adGroupId": "58700006123995025",
  "negativeAdGroupCriterionId": "46700015332504045"
}

productGroup:
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000068948065",
  "adGroupId": "58700006123995025",
  "productGroupId": "92700000508010025"
}
          
{
  "customerId": "200001235",
  "campaignId": "14660344555",
  "adGroupId":"105138634255",
  "criterionId":"948710340465"
}
広告 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"
}

エンティティが見つからない一般的な理由

広告主様のマッピング ファイルにはほとんどのエンティティが含まれますが、エンティティが欠落している場合もあります。よくある原因は次のとおりです。

  • 各マッピング ファイルは 3 日ごとに更新されます。新しいエンティティの作成直後にマッピング ファイルがダウンロードされた場合、そのエンティティはマッピング ファイルに含まれていない可能性があります。最大 3 日間待つと、表示されるようになります。
  • エンティティが属するアカウントが削除された。この場合、ID マッピングはサポートされていません。

レポートをダウンロード

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 グローバル あり
Campaign 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 グローバル はい