Сопоставление идентификаторов для новой поисковой рекламы 360

Новый API отчетов Search Ads 360 теперь доступен. Новый API обеспечивает повышенную гибкость для создания пользовательских отчетов и интеграции данных в ваши приложения и процессы отчетности. Узнайте больше о переходе и использовании нового API отчетов Search Ads 360 .

Сущности в новой Search Ads 360 имеют другое пространство идентификаторов, чем в предыдущей версии Search Ads 360. Чтобы получить сопоставление идентификаторов между предыдущей и новой Search Ads 360, отправьте запрос Reports.getIdMappingFile() . Ответ включает сопоставления идентификаторов для всех объектов указанного рекламодателя.

Вот пример возвращаемого файла (формат CSV в кодировке UTF-8):

Entity Type,Legacy IDs,New IDs
CUSTOMER,"{""agencyId"":""20700000000000125"",""advertiserId"":""2170000012345"",""engineAccountId"":""700000000042205""}","{""customerId"":""200001235""}"

CSV-файл имеет 3 столбца:

  • Entity Type : тип объекта этой строки.

  • Legacy IDs : строка JSON с полным путем к объекту в предыдущей версии Поисковой рекламы 360.

  • New IDs : строка JSON с полным путем к объекту в новой версии Search Ads 360.

В таблице ниже показан список поддерживаемых сущностей и примеры сопоставлений идентификаторов:

Тип объекта Описание Устаревшие идентификаторы Новые идентификаторы
КЛИЕНТ Сопоставление идентификаторов для: 
advertiser:
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345"
}

account:
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205"
}
          
{
"customerId": "200001235"
}
КАМПАНИЯ Сопоставление идентификаторов для кампании . 
{
 "agencyId":"20700000000000125",
 "advertiserId":"2170000012345",
 "engineAccountId":"700000000042205",
 "campaignId":"71700000087192405"
}
          
{
  "customerId": "200001235",
  "campaignId": "14660344555"
}
AD_GROUP Сопоставление идентификаторов для adGroup . 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000084761225",
  "adGroupId": "58700007213529045"
}
          
{
  "customerId": "200001235",
  "campaignId": "13666840065",
  "adGroupId": "127701366165"
}
КРИТЕРИЙ Сопоставление идентификаторов для: 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000068948065",
  "adGroupId": "58700006123995025",
  "AdGroupCriterionId": "46700015332504045"
}
          
{
  "customerId": "200001235",
  "campaignId": "14660344555",
  "adGroupId":"105138634255",
  "criterionId":"948710340465"
}
ОБЪЯВЛЕНИЕ Сопоставление идентификаторов объявления . 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000065395945",
  "adGroupId": "58700005797210525",
  "adId": "44700029299414085"
}
          
{
  "customerId": "200001235",
  "campaignId": "15314179325",
  "adGroupId": "131599768485",
  "adId": "562719339005"
}
CAMPAIGN_CRITERION Сопоставление идентификаторов для: 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000084403015",
  "campaignTargetId": "38700011011700285"
}
          
{
  "customerId": "200001235",
  "campaignId": "13467100745",
  "campaignCriterionId": "2125"
}
CAMPAIGN_GROUP Сопоставление идентификаторов для группы кампаний. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "budgetGroupId": "87700002234256082"
}
          
{
  "customerId": "200001235",
  "campaignGroupId": "1000665659"
}
CAMPAIGN_GROUP_PERFORMANCE_TARGET Сопоставление идентификаторов для цели эффективности группы кампаний. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "budgetGroupId": "87700002234256082",
  "budgetPlanId": "88700007187391026"
}
          
{
  "customerId": "200001235",
  "campaignGroupId": "1000665659"
  "campaignGroupPerformanceTargetId": "7624175"
}
FEED_TABLE Сопоставление идентификаторов для таблицы каналов. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "feedTableId": "32700008040329135"
}
          
{
  "customerId": "200001235",
  "feedId": "207040045"
}
FEED_ITEM Сопоставление идентификаторов для фидаItem . 
{
  "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

Питон

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()

Уникальность идентификатора объекта

Каждый объект в новой Search Ads 360 идентифицируется своим собственным идентификатором. Некоторые из этих идентификаторов уникальны на глобальном уровне для всех аккаунтов в новой Поисковой рекламе 360, тогда как другие уникальны только в ограниченной области. Например, для уникальной идентификации объявлений необходимо использовать и группу объявлений, и идентификаторы объявлений, поскольку идентификаторы объявлений уникально присваиваются каждой группе объявлений, а не между группами объявлений. Уникальность каждого идентификатора объекта в новой Search Ads 360 указана ниже. Эти правила идентификаторов могут быть полезны при проектировании локального хранилища для новых объектов Поисковой рекламы 360.

Идентификатор объекта Сфера уникальности Глобально уникальный?
Идентификатор бюджета Глобальный Да
Идентификатор кампании Глобальный Да
Идентификатор группы объявлений Глобальный Да
Идентификатор объявления Группа объявлений Нет. Пара ( AdGroupId , AdId ) уникальна во всем мире.
Идентификатор AdGroupCriterion Группа объявлений Нет. Пара ( AdGroupId , CriterionId ) уникальна во всем мире.
Идентификатор критерия кампании Кампания Нет. Пара ( CampaignId , CriterionId ) уникальна во всем мире.
Расширения объявлений Кампания Нет. Пара ( CampaignId , AdExtensionId ) уникальна во всем мире.
Идентификатор фида Глобальный Да
Идентификатор элемента фида Глобальный Да
Идентификатор атрибута фида Кормить Нет
Идентификатор сопоставления фида Глобальный Да
Идентификатор этикетки Глобальный Да
Идентификатор списка пользователей Глобальный Да