Сущности в новой Поисковой рекламе 360 имеют другое пространство идентификаторов, чем в предыдущей версии Поисковой рекламы 360. Чтобы получить сопоставление идентификаторов между предыдущей и новой Поисковой рекламой 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 дней.
- Учетная запись, которой принадлежит сущность, удалена. В этом случае мы не поддерживаем сопоставление идентификаторов.
- Обновление объекта (например, «Кампания») на стороне системы не поддерживается в новом Search Ads 360. Обновления обрабатывались путем создания нового объекта Search Ads 360 с обновлением и последующим удалением предыдущего объекта Search Ads 360.
- Возможно, предыдущие сопоставления были удалены в результате синхронизации между старой и новой Поисковой рекламой 360, в которой сохраняется только последнее сопоставление. Множественные сопоставления между одним устаревшим идентификатором и несколькими новыми идентификаторами Поисковой рекламы 360 разрешаются, сохраняя тот, который имеет самую последнюю временную метку.
- Учетная запись системы не синхронизируется из-за ошибок синхронизации между старой и новой версией Search Ads 360.
- Аккаунт удален или отключен.
Скачать отчет
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 ) уникальна во всем мире. |
| Идентификатор фида | Глобальный | Да |
| Идентификатор элемента фида | Глобальный | Да |
| Идентификатор атрибута фида | Кормить | Нет |
| Идентификатор сопоставления фида | Глобальный | Да |
| Идентификатор этикетки | Глобальный | Да |
| Идентификатор списка пользователей | Глобальный | Да |