Вызовите метод Conversion.insert()
чтобы добавить одно или несколько преобразований. Чтобы правильно атрибутировать конверсию, в вашем запросе необходимо указать название действия Floodlight, которое рекламодатель использует для отчета об офлайн-конверсиях, а также идентификатор ключевого слова, объявления и, возможно, клика, который привел к конверсии. Информацию о получении идентификаторов Search Ads 360 см. в разделе «Идентификаторы Search Ads 360 и конверсии» .
Информацию об ограничениях на загрузку исторических конверсий можно найти в справочном центре Search Ads 360 .
Если в вашем запросе Conversion.insert()
указано несколько конверсий, Search Ads 360 попытается загрузить каждую конверсию с максимальной эффективностью, а не загружать весь пакет как транзакцию по принципу «все или ничего». Если некоторые конверсии в пакете не загружаются, другие все равно могут успешно загрузиться. Загрузка конверсий может завершиться неудачно из-за недопустимого запроса или временных сбоев сети или системы. Поэтому мы рекомендуем вам читать ответ для каждой вставленной конверсии, чтобы убедиться, что загрузка прошла успешно.
Как скоро я смогу использовать загруженные данные?
Если вы укажете для conversionTimestamp
сегодняшнюю или вчерашнюю метку конверсии, показатели конверсии появятся в пользовательском интерфейсе Search Ads 360 в течение часа после загрузки. Если вы укажете conversionTimestamp
старше вчерашнего, метрики будут обновлены через несколько часов.
Преобразуйте все временные метки для преобразования во время эпохи (также известное как время Unix).
Могу ли я создавать действия Floodlight с помощью API?
Если рекламодатель еще не создал действие Floodlight для отслеживания офлайн-конверсий, вы можете создать его с помощью API Менеджера кампаний . Вы не можете использовать API, чтобы указать, что действие Floodlight используется в основном для офлайн-конверсий. Это рекомендуется, когда стратегии назначения ставок будут использовать данные о конверсиях.
Мы рекомендуем, чтобы после использования API для создания действия Floodlight пользователь Search Ads 360 вошел в Search Ads 360 и изменил настройки действия, указав, что основным источником конверсий является офлайн-действие .
Рекомендации по добавлению конверсий
Мы рекомендуем следующие рекомендации по добавлению конверсий:
Попросите пользователя Search Ads 360 войти в Search Ads 360 и изменить настройки для каждого действия Floodlight, которое вы используете для регистрации офлайн-конверсий. В настройках должно быть указано, что основным источником конверсий является офлайн-активность. Инструкции можно найти в Справочном центре Search Ads 360 .
Загружайте конверсии, как только они станут доступны. Если вы связываете конверсии с конкретными посещениями , подождите не менее 6 часов после посещения, прежде чем загружать конверсию. Поисковая реклама 360 может не распознать идентификатор клика посещения, если вы загрузите его раньше, чем через 6 часов после посещения. В редких случаях вам может потребоваться подождать до 24 часов, прежде чем Search Ads 360 сможет распознать идентификатор clickId.
Убедитесь, что каждая загрузка содержит самые последние конверсии . В рамках одного запроса на загрузку ничего страшного, если записи расположены не в хронологическом порядке. Однако стратегия назначения ставок может не учитывать старые конверсии, которые вы загрузите позже в другом запросе.
Отправить запрос на вставку
Вы можете отправить запрос Conversion.insert()
чтобы выполнить любое из следующих действий:
- Привязка конверсии к конкретному посещению
- Связать конверсию только с ключевым словом
Поля, обязательные для запроса Conversion.insert()
зависят от события или элемента, которому вы приписываете конверсию. В следующих разделах перечислены обязательные и необязательные поля для каждого события или элемента, которому можно приписать конверсию.
Привязка конверсии к конкретному посещению
Когда клиент нажимает на одно или несколько объявлений и попадает на сайт рекламодателя, Search Ads 360 считает сеанс пользователя на сайте рекламодателя посещением . Чтобы связать конверсию с посещением, укажите в запросе Conversion.insert()
следующее:
Обязательные поля
-
clickId
: идентификатор клика посещения с учетом регистра . Найдите в веб-журналах рекламодателя идентификатор клика или список конверсий и используйте идентификатор клика из другой конверсии. Поисковая реклама 360 свяжет конверсию с ключевым словом, объявлением и другими объектами Поисковой рекламы 360, которые ответственны за посещение.
Подождите не менее 6 часов после того, как Search Ads 360 сгенерирует идентификатор клика для загрузки конверсий. Если вы получили сообщение об ошибке «Идентификатор клика не найден», подождите 24 часа, а затем снова загрузите конверсии. Все конверсии должны быть загружены в течение 90 дней с момента создания идентификатора клика. В противном случае API Search Ads 360 может не распознать это посещение. -
conversionId
: для офлайн-конверсий рекламодатели предоставляют этот идентификатор. Рекламодатели могут указать любой идентификатор, который им важен. Для каждой конверсии в запросе должен быть указан уникальный идентификатор, а комбинация идентификатора и отметки времени должна быть уникальной среди всех конверсий внутри рекламодателя. Для онлайн-конверсий Поисковая реклама 360 копируетdsConversionId
илиfloodlightOrderId
в это свойство в зависимости от инструкций Floodlight рекламодателя. -
conversionTimestamp
: указывает дату и время, когда произошло преобразование. Например, если преобразование происходит в пятницу, 5 августа 2016 г., 11:53:22 по восточному летнему времени (GMT -4:00), укажите временную метку в миллисекундах эпохи:1470412402000
. -
segmentationType
: указывает тип системы преобразования, в которую вы загружаете преобразование. В настоящее время поддерживаются только преобразования Floodlight, поэтому в этом поле всегда необходимо указыватьFLOODLIGHT
. -
segmentationName
: название действия Floodlight, которое рекламодатель использует для отчета о конверсии.Если у вашего рекламодателя есть действия с одинаковым названием (это может произойти, если действия принадлежат разным группам Floodlight), рекомендуется переименовать одно из действий .
Альтернативно, если вы знаете, что идентификатор Search Ads 360 присвоил действию Floodlight, вы можете указать идентификатор в
segmentationId
вместо указания имени в полеsegmentationName
. (Менеджер кампании также присваивает идентификатор действию Floodlight, но этот идентификатор отличается от идентификатора Search Ads 360, и его нельзя использовать для атрибуции конверсий.) Чтобы просмотреть идентификатор Search Ads 360 для действия Floodlight, скачайте файл конверсий. отчет (либо из пользовательского интерфейса Search Ads 360 , либо из API отчетов ). Если за период действия отчета хотя бы одна конверсия была связана с действием Floodlight, вы увидите в отчете идентификатор Search Ads 360. -
type
: тип преобразования, то естьACTION
илиTRANSACTION
. Конверсия ДЕЙСТВИЯ не имеет денежной стоимости, а конверсия ТРАНЗАКЦИИ — имеет. Примерами являются подписка на список адресов электронной почты (ДЕЙСТВИЕ) и покупки в электронной торговле (ТРАНЗАКЦИЯ).Если вы указываете
TRANSACTION
, вам также необходимо указать следующее поле:-
revenueMicros
: денежная стоимость конверсии.
-
Необязательные поля
-
quantityMillis
: количество элементов в этом преобразовании. Например, количество людей, подписавшихся на рассылку новостей по электронной почте, или общее количество проданных товаров. Если вы не укажете это поле для конверсий ACTION, Search Ads 360 автоматически вставит значение1000
. -
currencyCode
: валюта дохода от транзакции. По умолчанию предполагается, что доход выражен в валюте рекламодателя. Если вы укажете другую валюту, Search Ads 360 конвертирует указанную сумму дохода в валюту рекламодателя. Узнать больше
Для указания валюты используйте буквенный (3-значный) формат ISO 4217 .
Применимо только для преобразований ТРАНЗАКЦИЯ. -
customMetric
иcustomDimension
: загружают дополнительные данные о конверсии, например страну, в которую доставляется купленный товар, идентификаторы продуктов или даже продолжительность телефонного звонка. Подробнее о загрузке данных для пользовательских переменных Floodlight … -
deviceType
: указывает тип устройства, на котором произошло преобразование. См. список значений, принятых для этого поля.
JSON
POST https://www.googleapis.com/doubleclicksearch/v2/conversion Authorization: Bearer your OAuth 2.0 access token Content-type: application/json { "kind": "doubleclicksearch#conversionList", "conversion" : [{ "clickId" : "COiYmPDTv7kCFcP0KgodOzQAAA", // Replace with a click ID from your site "conversionId" : "test_20130906_04", "conversionTimestamp" : "1378710000000", "segmentationType" : "FLOODLIGHT", "segmentationName" : "Test", "type": "TRANSACTION", "revenueMicros": "10000000", // 10 million revenueMicros is equivalent to $10 of revenue "currencyCode": "USD" }] }
Ява
/** * Instantiate the Doubleclicksearch service, create conversions, and upload them. */ public static void main(String[] args) throws Exception { Doubleclicksearch service = getService(); // See Set Up Your Application. // Set up a List to keep track of each conversion you create. List<Conversion> conversions = new Vector<Conversion>(); // Add a conversion to the List. addTransactionConversionForVisit(conversions, "COiYmPDTv7kCFcP0KgodOzQAAA", // Replace with a click ID from your site "test_" + System.currentTimeMillis(), 10000000L, 1378710000000L); // Upload the List and handle the response. uploadConversions(conversions, service); } /** * Create a TRANSACTION conversion and add it to a List<Conversion>. This sample hard-codes * the segmentation name and currency. You probably wouldn't want your production code to be so brittle. */ private static List<Conversion> addTransactionConversionForVisit(List<Conversion> conversions, String clickId, String conversionId, Long revenue, Long timeStamp) { Conversion conversion = new Conversion().setClickId(clickId) .setConversionId(conversionId) .setSegmentationType("FLOODLIGHT") .setSegmentationName("Test") .setType("TRANSACTION") .setRevenueMicros(revenue) .setCurrencyCode("USD") .setConversionTimestamp(BigInteger.valueOf(timeStamp)); conversions.add(conversion); return conversions; } /** * Convert the List of conversions to a DS ConversionList, send an insert request to DS, * and output the response to a file. */ private static void uploadConversions(List<Conversion> conversions, Doubleclicksearch service) throws IOException { FileOutputStream outputStream = new FileOutputStream(new File("./", "InsertConversionsResponse.txt")); final PrintStream printStream = new PrintStream(outputStream); try { // Convert the List to a ConversionList. ConversionList conversionList = new ConversionList().setConversion(conversions); // Insert an upload request and download the response to a file. service.conversion().insert(conversionList).executeAndDownloadTo(printStream); printStream.close(); } catch (GoogleJsonResponseException e) { System.err.println("Get request was rejected."); for (ErrorInfo error : e.getDetails().getErrors()) { System.err.println(error.getMessage()); } System.exit(e.getStatusCode()); } }
Питон
def insert_conversion(service): """Create and upload a TRANSACTION conversion that is attributed to a visit. Args: service: An authorized Doubleclicksearch service. See Set Up Your Application. """ request = service.conversion().insert( body= { 'conversion': [{ 'clickId': 'COiYmPDTv7kCFcP0KgodOzQAAA', // Replace with a click ID from your site 'conversionId': 'test_20140206_00', 'conversionTimestamp': '1378710000000', 'segmentationType': 'FLOODLIGHT', 'segmentationName': 'Test', 'type': 'TRANSACTION', 'revenueMicros': '10000000', // 10 million revenueMicros is equivalent to $10 of revenue 'currencyCode': 'USD' }] } ) pprint.pprint(request.execute())
Связать конверсию только с ключевым словом
Если вашей основной задачей является привязка конверсий к ключевым словам (и вас не беспокоит атрибуция к рекламе), вы можете опустить большую часть идентификаторов Search Ads 360 и указать только идентификатор ключевого слова вместе с несколькими другими полями:
Обязательные поля
-
criterionId
: это идентификатор ключевого слова. Вы можете получитьcriterionId
, добавив макросTrackerId
в URL-адреса целевой страницы. Информацию о получении идентификаторов ключевых слов см. в разделе «Идентификаторы и конверсии Search Ads 360» . -
conversionId
: для офлайн-конверсий рекламодатели предоставляют этот идентификатор. Рекламодатели могут указать любой идентификатор, который им важен. Для каждой конверсии в запросе должен быть указан уникальный идентификатор, а комбинация идентификатора и отметки времени должна быть уникальной среди всех конверсий внутри рекламодателя. Для онлайн-конверсий Поисковая реклама 360 копируетdsConversionId
илиfloodlightOrderId
в это свойство в зависимости от инструкций Floodlight рекламодателя. -
conversionTimestamp
: указывает дату и время, когда произошло преобразование. Например, если преобразование происходит в пятницу, 5 августа 2016 г., 11:53:22 по восточному летнему времени (GMT -4:00), укажите временную метку в миллисекундах эпохи:1470412402000
. -
segmentationType
: указывает тип системы преобразования, в которую вы загружаете преобразование. В настоящее время поддерживаются только преобразования Floodlight, поэтому в этом поле всегда необходимо указыватьFLOODLIGHT
. -
segmentationName
: название действия Floodlight, которое рекламодатель использует для отчета о конверсии.Если у вашего рекламодателя есть действия с одинаковым названием (это может произойти, если действия принадлежат разным группам Floodlight), рекомендуется переименовать одно из действий .
Альтернативно, если вы знаете, что идентификатор Search Ads 360 присвоил действию Floodlight, вы можете указать идентификатор в
segmentationId
вместо указания имени в полеsegmentationName
. (Менеджер кампании также присваивает идентификатор действию Floodlight, но этот идентификатор отличается от идентификатора Search Ads 360, и его нельзя использовать для атрибуции конверсий.) Чтобы просмотреть идентификатор Search Ads 360 для действия Floodlight, скачайте файл конверсий. отчет (либо из пользовательского интерфейса Search Ads 360 , либо через API отчетов ). Если за период действия отчета хотя бы одна конверсия была связана с действием Floodlight, вы увидите в отчете идентификатор Search Ads 360. -
type
: тип преобразования, то естьACTION
илиTRANSACTION
. Конверсия ДЕЙСТВИЯ не имеет денежной стоимости, а конверсия ТРАНЗАКЦИИ — имеет. Примерами являются подписка на список адресов электронной почты (ДЕЙСТВИЕ) и покупки в электронной торговле (ТРАНЗАКЦИЯ).Если вы указываете
TRANSACTION
, вам также необходимо указать следующее поле:-
revenueMicros
: денежная стоимость конверсии.
-
Необязательные поля
-
quantityMillis
: количество элементов в этом преобразовании. Например, количество людей, подписавшихся на рассылку новостей по электронной почте, или общее количество проданных товаров. Если вы не укажете это поле для конверсий ACTION, Search Ads 360 автоматически вставит значение1000
. -
currencyCode
: валюта дохода от транзакции. По умолчанию предполагается, что доход выражен в валюте рекламодателя. Если вы укажете другую валюту, Search Ads 360 конвертирует указанную сумму дохода в валюту рекламодателя. Узнать больше
Для указания валюты используйте буквенный (3-значный) формат ISO 4217 .
Применимо только для преобразований ТРАНЗАКЦИЯ. -
customMetric
иcustomDimension
: загружают дополнительные данные о конверсии, например страну, в которую доставляется купленный товар, идентификаторы продуктов или даже продолжительность телефонного звонка. Подробнее о загрузке данных для пользовательских переменных Floodlight … -
deviceType
: указывает тип устройства, на котором произошло преобразование. См. список значений, принятых для этого поля.
JSON
POST https://www.googleapis.com/doubleclicksearch/v2/conversion Authorization: Bearer your OAuth 2.0 access token Content-type: application/json { "kind": "doubleclicksearch#conversionList", "conversion" : [{ "criterionId": "43700003491981017", // Replace with your ID "conversionId": "customerTransaction73126", "conversionTimestamp": "1351196386000", "segmentationType": "FLOODLIGHT", "segmentationName": "Offline Purchase", "type": "TRANSACTION", "revenueMicros": "20000000", // 20 million revenueMicros is equivalent to $20 of revenue "currencyCode": "USD" }] }
Ява
/** * Creates a TRANSACTION conversion, attributes it to a keyword only, and adds it to a List<Conversion>. * The example in the preceding section contains the uploadConversions method, * which can submit the list as an insert() request. */ private static List<Conversion> addTransactionConversionForKeyword(List<Conversion> conversions, Long criterionId, String conversionId, Long revenue, Long timeStamp) { Conversion conversion = new Conversion() .setCriterionId(criterionId) .setConversionId(conversionId) .setSegmentationType("FLOODLIGHT") .setSegmentationName("Test") .setType("TRANSACTION") .setRevenueMicros(revenue) .setCurrencyCode("USD") .setConversionTimestamp(BigInteger.valueOf(timeStamp)); conversions.add(conversion); return conversions; }
Питон
def insert_conversion(service): """Create and upload a TRANSACTION conversion that is attributed to a keyword only. Args: service: An authorized Doubleclicksearch service. See Set Up Your Application. """ request = service.conversion().insert( body= { 'conversion': [{ 'criterionId': '43700004289911004', // Replace with your ID 'conversionId': 'test_1378710000000', 'conversionTimestamp': '1378710000000', 'segmentationType': 'FLOODLIGHT', 'segmentationName': 'Test', 'type': 'TRANSACTION', 'revenueMicros': '20000000', // 20 million revenueMicros is equivalent to $20 of revenue 'currencyCode': 'USD' }] } ) pprint.pprint(request.execute())
Загрузите данные из сторонней модели атрибуции.
Модель атрибуции распределяет ценность конверсии по всем действиям на пути конверсии. Например, если потребитель нажимает на платное поисковое объявление, медийное объявление и еще одно платное поисковое объявление перед конверсией, модель линейной атрибуции будет давать каждому клику 33 % ценности конверсии.
Хотя Search Ads 360 предоставляет модели атрибуции , если вы используете стороннюю службу или разработанную вами службу для распределения ценности кликов, вы можете загрузить сторонние данные атрибуции в Search Ads 360 и использовать эти данные в отчетах и результатах поиска. Стратегии назначения ставок в Ads 360.
Прежде чем начать
В Менеджере кампаний создайте собственную модель атрибуции и импортируйте ее в Search Ads 360. Обязательно назовите модель «Внешняя модель атрибуции» . Это позволяет функциям Search Ads 360 распознавать, что к загружаемым вами данным о конверсиях применена модель атрибуции. Узнать больше
Обязательные поля
Чтобы применить к конверсии стороннюю модель атрибуции, укажите в запросе Conversion.insert()
все следующее:
-
clickId
: идентификатор клика посещения с учетом регистра. Найдите в веб-журналах рекламодателя идентификатор клика или список конверсий и используйте идентификатор клика из другой конверсии. Поисковая реклама 360 свяжет конверсию с ключевым словом, объявлением и другими объектами Поисковой рекламы 360, которые ответственны за посещение.
Прежде чем загружать конверсию с идентификатором, подождите не менее 30 минут после того, как Search Ads 360 сгенерирует идентификатор клика. В противном случае API Search Ads 360 может не распознать это посещение. -
attributionModel
: установлено значение «Внешняя модель атрибуции» . Узнать больше -
countMillis
: сумма ценности конверсии, распределяемая по этому клику. Применимо только в том случае, если запрос также включает полеattributionModel
.Не путайте это с
quantityMillis
— необязательным полем, указывающим количество товаров в конверсии (например, количество товаров в корзине покупок). -
conversionId
: для офлайн-конверсий рекламодатели предоставляют этот идентификатор. Рекламодатели могут указать любой идентификатор, который им важен. Для каждой конверсии в запросе должен быть указан уникальный идентификатор, а комбинация идентификатора и отметки времени должна быть уникальной среди всех конверсий внутри рекламодателя. Для онлайн-конверсий Поисковая реклама 360 копируетdsConversionId
илиfloodlightOrderId
в это свойство в зависимости от инструкций Floodlight рекламодателя. -
conversionTimestamp
: указывает дату и время, когда произошло преобразование. Например, если преобразование происходит в пятницу, 5 августа 2016 г., 11:53:22 по восточному летнему времени (GMT -4:00), укажите временную метку в миллисекундах эпохи:1470412402000
. -
segmentationType
: указывает тип системы преобразования, в которую вы загружаете преобразование. В настоящее время поддерживаются только преобразования Floodlight, поэтому в этом поле всегда необходимо указыватьFLOODLIGHT
. -
segmentationName
: название действия Floodlight, которое рекламодатель использует для отчета о конверсии.Если у вашего рекламодателя есть действия с одинаковым названием (это может произойти, если действия принадлежат разным группам Floodlight), рекомендуется переименовать одно из действий .
Альтернативно, если вы знаете, что идентификатор Search Ads 360 присвоил действию Floodlight, вы можете указать идентификатор в
segmentationId
вместо указания имени в полеsegmentationName
. (Менеджер кампании также присваивает идентификатор действию Floodlight, но этот идентификатор отличается от идентификатора Search Ads 360, и его нельзя использовать для атрибуции конверсий.) Чтобы просмотреть идентификатор Search Ads 360 для действия Floodlight, скачайте файл конверсий. отчет (либо из пользовательского интерфейса Search Ads 360 , либо через API отчетов ). Если за период действия отчета хотя бы одна конверсия была связана с действием Floodlight, вы увидите в отчете идентификатор Search Ads 360. -
type
: тип преобразования, то естьACTION
илиTRANSACTION
. Конверсия ДЕЙСТВИЯ не имеет денежной стоимости, а конверсия ТРАНЗАКЦИИ — имеет. Примерами являются подписка на список адресов электронной почты (ДЕЙСТВИЕ) и покупки в электронной торговле (ТРАНЗАКЦИЯ).Если вы указываете
TRANSACTION
, вам также необходимо указать следующее поле:-
revenueMicros
: денежная стоимость конверсии.
-
Если вы отслеживаете доход от конверсий, убедитесь, что ваша модель распределяет доход по каждой точке взаимодействия на пути конверсии. Например, если в вашей модели используется линейный подход (равномерное распределение дохода по каждой точке взаимодействия), то на пути конверсии, включающем 3 клика по объявлению, каждый клик будет приписан 33 % конверсии. Если конверсия принесла доход в размере 100 долларов США, убедитесь, что ваша модель распределяет доход в размере 33 долларов США на каждый клик, и убедитесь, что RevenueMicros указывает только 33 доллара дохода за каждый клик.
Необязательные поля
-
quantityMillis
: количество элементов в этом преобразовании. Например, количество людей, подписавшихся на рассылку новостей по электронной почте, или общее количество проданных товаров. Если вы не укажете это поле для конверсий ACTION, Search Ads 360 автоматически вставит значение1000
. -
currencyCode
: валюта дохода от транзакции. По умолчанию предполагается, что доход выражен в валюте рекламодателя. Если вы укажете другую валюту, Search Ads 360 конвертирует указанную сумму дохода в валюту рекламодателя. Узнать больше
Для указания валюты используйте буквенный (3-значный) формат ISO 4217 .
Применимо только для преобразований ТРАНЗАКЦИЯ. -
customMetric
иcustomDimension
: загружают дополнительные данные о конверсии, например страну, в которую доставляется купленный товар, идентификаторы продуктов или даже продолжительность телефонного звонка. Подробнее о загрузке данных для пользовательских переменных Floodlight … -
deviceType
: указывает тип устройства, на котором произошло преобразование. См. список значений, принятых для этого поля.
Пример
POST https://www.googleapis.com/doubleclicksearch/v2/conversion Authorization: Bearer your OAuth 2.0 access token Content-type: application/json { "kind": "doubleclicksearch#conversionList", "conversion" : [{ "clickId" : "PP5K8iI6ul7Vw09JZZDEp", // Replace with a click ID from your site "conversionId" : "test_20130906_04", "conversionTimestamp" : "1378710000000", "segmentationType" : "FLOODLIGHT", "segmentationName" : "Test", "type": "TRANSACTION", "attributionModel": "External Attribution Model", "countMillis": "330", "revenueMicros": "33000000", // 33 million revenueMicros is equivalent to $33 of revenue "currencyCode": "USD" }] }
Обработка ответов Поисковой рекламы 360
Ответ от Search Ads 360 указывает на успех только в том случае, если все конверсии в запросе были успешно проверены и загружены.
Если запрос успешен
Если запрос успешен, ответ включает полное внутреннее представление Search Ads 360 для каждой загруженной конверсии, например идентификатор кампании, идентификатор группы объявлений и идентификатор ключевого слова (критерия).
{ "kind": "doubleclicksearch#conversionList", "conversion": [ { "agencyId": "12300000000000456", "advertiserId": "45600000000010291", "engineAccountId": "700000000042441", "campaignId": "71700000002044839", "adGroupId": "58700000032026064", "criterionId": "43700004289911004", "adId": "0", "dsConversionId": "48719131694768384", "conversionId": "test_1383157331951", "state": "ACTIVE", "type": "TRANSACTION", "revenueMicros": "20000000", "currencyCode": "USD", "segmentationType": "FLOODLIGHT", "segmentationId": "25700000001464141", "segmentationName": "Test", "conversionTimestamp": "1378710000000", "conversionModifiedTimestamp": "1383157332368" }, ... ] }
Если запрос не удался
Если одну или несколько конверсий не удалось подтвердить или загрузить, в ответ будут включены сообщения для каждой неудачной загрузки конверсии. В ответе нет сообщений об успешно загруженных конверсиях.
Вот пример ответа на запрос, который не был полностью выполнен:
{ "error": { "errors": [ { "reason": "requestValidation", "message": "The request was not valid. Details: [0x0000011F: Advertiser conversion ID ..." }, { "reason": "requestValidation", "message": "The request was not valid. Details: [0x00000101: Click ID ..." } ] } }
Каждое сообщение об ошибке содержит два важных поля: причину и подробное сообщение об ошибке. Поле причины может содержать requestValidation , InternalError , TransactionFailed или LateStageRequestError .
Ошибки проверки запроса
Ошибки requestValidation указывают на проблемы с данными в запросе на загрузку конверсии (например, конверсия уже загружена или идентификатор clickId не найден). В этом типе ошибки сведения о сообщении содержат два элемента:
- Шестнадцатеричный код, определяющий тип ошибки. Вы можете использовать этот код в своих собственных скриптах для выявления ошибок.
- Описание ошибки валидации.
Дополнительную информацию можно найти в списке кодов и описаний , которые Поисковая реклама 360 может возвращать при ошибках загрузки конверсий.
Другие типы ошибок
Все остальные типы ошибок ( InternalError , TransactionFailed или LateStageRequestError ) указывают на внутреннюю проблему в Search Ads 360.
Ответ на ошибку
Если запрос не выполнен, попробуйте повторно отправить весь запрос позже. Поисковая реклама 360 сообщит об ошибках requestValidation для всех уже загруженных конверсий, но попытается загрузить оставшиеся конверсии.
Если после повторной отправки вы по-прежнему видите ошибки, просмотрите раздел устранения неполадок , чтобы узнать, как действовать дальше.