새 Search Ads 360의 ID 매핑

이제 새 Search Ads 360 Reporting API를 사용할 수 있습니다. 새로운 API는 맞춤 보고서를 작성하고 보고 애플리케이션에 데이터를 통합할 수 있는 유연성 향상 프로세스입니다 새 Search Ads 360 보고서로 이전하고 이를 사용하는 방법 자세히 알아보기 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 매핑 대상: <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 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 고유성

새 Search Ads 360의 모든 개체는 자체 ID로 식별됩니다. 이러한 ID 중 일부는 새 Search Ads 360의 모든 계정에서 전역적으로 고유함 제한된 범위 내에서만 사용할 수 있습니다. 예를 들어 광고 그룹 및 광고 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 피드 아니요
Feed Mapping ID 글로벌 수준 예
라벨 ID 전역 예
사용자 목록 ID 전역 예