検索広告 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 マッピング: マネージャーと代理店のマッピングは使用できません。 
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"
}
広告 広告の 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 のマッピングはサポートされていません。
  • 検索広告 360 リニューアル版では、エンジン側のエンティティ（キャンペーンなど）の更新はサポートされていません。更新は、新しい検索広告 360 エンティティを作成して、更新を行った後、以前の検索広告 360 エンティティを削除することで処理されました。
  • 検索広告 360 の従来版とリニューアル版の同期により、以前のマッピングが削除され、最新のマッピングのみが保持されている可能性があります。1 つの従来 ID と複数の検索広告 360 リニューアル版 ID 間の複数のマッピングが解決され、最新のタイムスタンプを持つマッピングが保持されます。
  • 検索広告 360 の従来版とリニューアル版の間で同期エラーが発生したため、エンジン アカウントが同期されていません。
  • アカウントが削除または無効になっている。

レポートをダウンロード

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 グローバル ○