새 Search Ads 360의 ID 매핑

이제 새 Search Ads 360 Reporting API를 사용할 수 있습니다. 새로운 API를 사용하면 더욱 유연하게 맞춤 보고서를 작성하고, 데이터를 보고 애플리케이션 및 프로세스에 통합할 수 있습니다. 새 Search Ads 360 Reporting API로 이전하고 이를 사용하는 방법에 대해 자세히 알아보세요.

새 Search Ads 360의 항목 ID는 이전 Search Ads 360과 다릅니다. 이전 Search Ads 360과 새 Search Ads 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: 이전 Search Ads 360에 있는 전체 항목 경로의 JSON 문자열

  • New IDs: 새 Search Ads 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 광고의 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 고유성

새 Search Ads 360의 모든 객체는 고유 ID로 식별됩니다. 이러한 ID 중 일부는 새 Search Ads 360의 모든 계정에서 전역 수준에서 고유하지만 다른 ID는 제한된 범위 내에서만 고유합니다. 예를 들어 광고를 고유하게 식별하려면 광고그룹과 광고 ID를 모두 사용해야 합니다. 광고 ID는 광고그룹별로 고유하게 할당되지만 광고그룹 전체는 할당되지 않기 때문입니다. 새 Search Ads 360 내 각 객체 ID의 고유성은 다음과 같습니다. 이러한 ID 규칙은 새 Search Ads 360 객체의 로컬 저장소를 설계할 때 유용할 수 있습니다.

객체 ID 고유성 식별 범위 글로벌 수준에서 식별 가능
예산 ID 전 세계 지원됨
캠페인 ID 전 세계 지원됨
AdGroup ID 전 세계 지원됨
광고 ID 광고그룹 아니요. (AdGroupId, AdId) 쌍은 전역적으로 고유합니다.
AdGroup기준 ID 광고그룹 아니요. (AdGroupId, CriterionId) 쌍은 전역적으로 고유합니다.
캠페인 기준 ID 실행 아니요. (CampaignId, CriterionId) 쌍은 전역적으로 고유합니다.
광고 확장 실행 아니요. (CampaignId, AdExtensionId) 쌍은 전역적으로 고유합니다.
피드 ID 글로벌 수준 지원됨
Feed Item ID 전 세계 지원됨
Feed Attribute ID 피드 No
Feed Mapping ID 전 세계 지원됨
라벨 ID 전 세계 지원됨
사용자 목록 ID 전 세계 지원됨