새 Search Ads 360의 ID 매핑

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

새 Search Ads 360의 항목은 이전 Search Ads 360과 ID 공간이 다릅니다. 이전 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 파일에는 다음 세 열이 표시됩니다.

  • 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"
}
CRITERION 광고그룹 수준 기준에 대한 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 고유성

새 Search Ads 360의 모든 객체는 자체 ID로 식별됩니다. 이러한 ID 중 일부는 새 Search Ads 360의 모든 계정 전반에서 전 세계적으로 고유한 ID이지만, 일부는 제한된 범위 내에서만 고유한 ID입니다. 예를 들어 광고 ID는 광고 그룹별로 고유하게 할당되지만 광고 그룹 전체에 고유하게 할당되지 않으므로 광고를 고유하게 식별하려면 광고 그룹 ID와 광고 ID를 모두 사용해야 합니다. 새 Search Ads 360 내에서 각 객체 ID의 고유성은 다음과 같습니다. 이러한 ID 규칙은 새 Search Ads 360 객체를 위한 로컬 스토리지를 설계할 때 유용합니다.

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