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

新しい Search Ads 360 Reporting API をご利用いただけるようになりました。この新しい API は 柔軟性の向上により、カスタム レポートを作成し、データをレポート アプリケーションに統合できます。 プロセスです。詳しくは、検索広告 360 リニューアル版レポートへの移行と利用に関する記事をご覧ください。 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 マッピング: <ph type="x-smartling-placeholder">で確認できます。 マネージャーと代理店のマッピングは利用できません。 
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 マッピング: <ph type="x-smartling-placeholder"> 
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 マッピング: <ph type="x-smartling-placeholder"> 
{
  "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 の両方を使用する必要があります。 。 検索広告 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 グローバル ○