Сопоставление идентификаторов для новой поисковой рекламы 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"
}
КРИТЕРИЙ Сопоставление идентификаторов для критериев уровня группы объявлений:
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"
}
ОБЪЯВЛЕНИЕ Сопоставление идентификаторов объявления . 
{
  "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"
}

Распространенные причины отсутствия сущностей

Хотя файл сопоставления рекламодателя будет содержать большую часть его объектов, в некоторых случаях объекты могут отсутствовать. Вот некоторые из наиболее распространенных причин:

  • Каждый файл сопоставления обновляется каждые 3 дня. Если файл сопоставления загружается сразу после создания нового объекта, этого объекта, вероятно, не будет в файле сопоставления. Скорее всего, он будет включен после ожидания до 3 дней.
  • Учетная запись, которой принадлежит сущность, удалена. В этом случае мы не поддерживаем сопоставление идентификаторов.

Скачать отчет

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 ) уникальна во всем мире.
Идентификатор фида Глобальный Да
Идентификатор элемента фида Глобальный Да
Идентификатор атрибута фида Кормить Нет
Идентификатор сопоставления фида Глобальный Да
Идентификатор этикетки Глобальный Да
Идентификатор списка пользователей Глобальный Да