検索広告 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 | グローバル | ○ |