Добавить новые конверсии

Вызовите метод Conversion.insert() , чтобы добавить одну или несколько конверсий. Чтобы правильно атрибутировать конверсию, в запросе необходимо указать название действия Floodlight, которое рекламодатель использует для отчета об офлайн-конверсиях, а также идентификатор ключевого слова, объявления и, возможно, клика, приведшего к конверсии. Информацию о получении идентификаторов Поисковой рекламы 360 см. в разделе Идентификаторы Поисковой рекламы 360 и конверсии .

Информацию об ограничениях на загрузку исторических конверсий можно найти в справочном центре Поисковой рекламы 360 .

Если в вашем запросе Conversion.insert() указано несколько конверсий, Поисковая реклама 360 попытается загрузить каждую конверсию по мере возможности, а не загружать весь пакет как транзакцию по принципу «все или ничего». Если некоторые конверсии в пакете не загружаются, другие могут все же загружаться успешно. Загрузка конверсий может завершиться ошибкой из-за недопустимого запроса или временных сетевых или системных сбоев. Поэтому мы рекомендуем вам прочитать ответ для каждой вставленной конверсии, чтобы убедиться, что загрузка прошла успешно.

Как скоро я смогу использовать загруженные данные?

Если вы укажете для конверсии conversionTimestamp сегодня или вчера, показатели конверсии появятся в пользовательском интерфейсе Search Ads 360 в течение часа после загрузки. Если указать conversionTimestamp старше вчерашнего дня, метрики будут обновлены через несколько часов.

Преобразуйте все метки времени для преобразования во время эпохи (также известное как время Unix).

Можно ли создавать действия Floodlight с помощью API?

Если рекламодатель еще не создал действие Floodlight для отслеживания офлайн-конверсий, вы можете создать его с помощью API Менеджера кампаний . Вы не можете использовать API, чтобы указать, что действие Floodlight используется в основном для офлайн-конверсий, что рекомендуется, когда стратегии назначения ставок будут использовать данные конверсии.

Мы рекомендуем, чтобы после использования API для создания действия Floodlight пользователь Поисковой рекламы 360 вошел в Поисковую рекламу 360 и изменил настройку действия, указав, что основным источником конверсий являются офлайн-действия .

Рекомендации по добавлению конверсий

Мы рекомендуем следующие рекомендации по добавлению конверсий:

  1. Попросите пользователя Поисковой рекламы 360 войти в Поисковую рекламу 360 и изменить настройки для каждого действия Floodlight, которое вы используете для отчетов об офлайн-конверсиях. В настройках должно быть указано, что основным источником конверсий является офлайн-активность. Инструкции см. в Справочном центре Поисковой рекламы 360 .

  2. Загружайте конверсии, как только они станут доступны. Если вы связываете конверсии с конкретными посещениями , подождите не менее 30 минут после посещения, прежде чем загружать конверсию. Поисковая реклама 360 может не распознать clickID посещения, если вы загрузите его раньше, чем через 30 минут после посещения. В редких случаях может потребоваться подождать до 4 часов, прежде чем Поисковая реклама 360 сможет распознать clickId.

    Убедитесь, что каждая загрузка содержит самые последние конверсии . В одном запросе на загрузку допустимо, если записи расположены не в хронологическом порядке. Но стратегия назначения ставок может не учитывать более старые конверсии, которые вы загружаете позже в другом запросе.

  3. Если вы ждете более 24 часов перед загрузкой конверсий для действия Floodlight, отправьте метку времени доступности .

    Отметка времени доступности должна быть одной из следующих:

    • Если вы записали конверсии за последние 24 часа, но еще не загрузили их, отметка времени должна соответствовать времени последней загруженной конверсии . Это сообщает Поисковой рекламе 360, что за последние 24 часа могли произойти конверсии, но вы еще не предоставили данные. Стратегии назначения ставок и другие автоматические системы будут учитывать историю эффективности только до последней загруженной вами конверсии.
    • Если за последние 24 часа не было конверсий, отметка времени должна быть текущими временем и датой . Это сообщает Поисковой рекламе 360, что за последние 24 часа не было конверсий. Стратегии назначения ставок и другие автоматизированные системы будут включать последние 24 часа — целый день без конверсий — как часть истории эффективности.

Отправить запрос на вставку

Вы можете отправить запрос Conversion.insert() для выполнения любого из следующих действий:

  • Связать конверсию с конкретным посещением
  • Связать конверсию с ключевым словом и объявлением
  • Связать конверсию только с ключевым словом
  • Связать конверсию с товаром в торговой кампании

Поля, обязательные для заполнения в запросе Conversion.insert() зависят от события или элемента, которому вы приписываете конверсию. В следующих разделах перечислены обязательные и необязательные поля для каждого события или элемента, которым вы можете приписать конверсию.

Связать конверсию с конкретным посещением

Когда клиент нажимает на одно или несколько объявлений и попадает на сайт рекламодателя, Поисковая реклама 360 рассматривает сеанс пользователя на сайте рекламодателя как посещение . Чтобы связать конверсию с посещением, укажите в запросе Conversion.insert() следующее:

Обязательные поля

  • clickId : Идентификатор клика посещения с учетом регистра. Найдите в веб-журналах рекламодателя идентификатор клика или составьте список конверсий и используйте идентификатор клика из другой конверсии. Поисковая реклама 360 будет связывать конверсию с ключевым словом, объявлением и другими объектами Поисковой рекламы 360, которые были ответственны за посещение.
    Подождите не менее 30 минут после того, как Поисковая реклама 360 сгенерирует идентификатор клика, чтобы загрузить конверсии. Если вы получили сообщение об ошибке «Идентификатор клика не найден», подождите 4 часа, а затем снова загрузите данные о конверсиях. Все конверсии должны быть загружены в течение 90 дней с момента создания идентификатора клика. В противном случае API Search Ads 360 может не распознать посещение.
  • conversionId : для офлайн-конверсий рекламодатели предоставляют этот идентификатор. Рекламодатели могут указать любой значимый для них идентификатор. Для каждой конверсии в запросе должен быть указан уникальный идентификатор, а комбинация идентификатора и метки времени должна быть уникальной среди всех конверсий рекламодателя. Для онлайн-конверсий Поисковая реклама 360 копирует dsConversionId или floodlightOrderId в это свойство в зависимости от инструкций рекламодателя Floodlight.
  • conversionTimestamp : указывает дату и время, когда произошло преобразование. Например, если преобразование происходит в пятницу, 05 августа 2016 г., в 11:53:22 по восточному летнему времени (GMT -4:00), укажите отметку времени в миллисекундах эпохи: 1470412402000 .
  • segmentationType : указывает тип системы конверсии, в которую вы загружаете конверсию. В настоящее время поддерживаются только конверсии Floodlight, поэтому в этом поле всегда необходимо указывать FLOODLIGHT .
  • segmentationName : название действия Floodlight, которое рекламодатель использует для отчета о конверсии.

    Если у вашего рекламодателя есть действия с одинаковыми названиями (это может произойти, если действия относятся к разным группам Floodlight), рекомендуется переименовать одно из действий .

    В качестве альтернативы, если вы знаете идентификатор, присвоенный Search Ads 360 действию Floodlight, вы можете указать идентификатор в segmentationId вместо указания имени в поле segmentationName . (Менеджер кампаний также присваивает идентификатор действию Floodlight, но идентификатор Менеджера кампаний отличается от идентификатора Поисковой рекламы 360, и его нельзя использовать для атрибуции конверсий.) Чтобы просмотреть идентификатор Поисковой рекламы 360 для действия Floodlight, загрузите конверсии. отчет (либо из пользовательского интерфейса Search Ads 360 , либо через API отчетов ). Если хотя бы одна конверсия была связана с действием Floodlight в течение отчетного периода, вы увидите в отчете идентификатор Search Ads 360.

  • type : тип преобразования, то есть ACTION или TRANSACTION . Конверсия ДЕЙСТВИЯ не имеет денежной стоимости, в отличие от конверсии ТРАНЗАКЦИЯ. Примерами являются подписки на список рассылки (ДЕЙСТВИЕ) и покупки в электронной торговле (ТРАНЗАКЦИЯ).

    Если вы укажете TRANSACTION , вам также необходимо указать следующее поле:

    • revenueMicros : Денежная стоимость конверсии.

Необязательные поля

  • quantityMillis : количество элементов в этом преобразовании. Например, количество людей, подписавшихся на рассылку новостей по электронной почте, или общее количество проданных товаров. Если вы не укажете это поле для конверсий ACTION, Поисковая реклама 360 автоматически вставит значение 1000 .
  • currencyCode : Валюта дохода от транзакции. По умолчанию предполагается, что доход указан в валюте рекламодателя. Если вы укажете другую валюту, Поисковая реклама 360 преобразует указанную сумму дохода в валюту рекламодателя. Узнать больше
    Используйте буквенный (3-символьный) формат ISO 4217 для указания валюты.
    Применимо только к конверсиям TRANSACTION.
  • 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())

Связать конверсию с ключевым словом и объявлением

Вместо привязки конверсии к конкретному посещению вы можете привязать ее к объявлению и ключевому слову, указав в своем запросе Conversion.insert() следующее:

Обязательные поля

  • Идентификаторы Search Ads 360 для агентства, рекламодателя, системного аккаунта, кампании, группы объявлений, ключевого слова (критерия) и объявления. Информацию о том, как получить эти идентификаторы, см. в разделе Идентификаторы и конверсии Поисковой рекламы 360 .
  • conversionId : для офлайн-конверсий рекламодатели предоставляют этот идентификатор. Рекламодатели могут указать любой значимый для них идентификатор. Для каждой конверсии в запросе должен быть указан уникальный идентификатор, а комбинация идентификатора и метки времени должна быть уникальной среди всех конверсий рекламодателя. Для онлайн-конверсий Поисковая реклама 360 копирует dsConversionId или floodlightOrderId в это свойство в зависимости от инструкций рекламодателя Floodlight.
  • conversionTimestamp : указывает дату и время, когда произошло преобразование. Например, если преобразование происходит в пятницу, 05 августа 2016 г., в 11:53:22 по восточному летнему времени (GMT -4:00), укажите отметку времени в миллисекундах эпохи: 1470412402000 .
  • segmentationType : указывает тип системы конверсии, в которую вы загружаете конверсию. В настоящее время поддерживаются только конверсии Floodlight, поэтому в этом поле всегда необходимо указывать FLOODLIGHT .
  • segmentationName : название действия Floodlight, которое рекламодатель использует для отчета о конверсии.

    Если у вашего рекламодателя есть действия с одинаковыми названиями (это может произойти, если действия относятся к разным группам Floodlight), рекомендуется переименовать одно из действий .

    В качестве альтернативы, если вы знаете идентификатор, присвоенный Search Ads 360 действию Floodlight, вы можете указать идентификатор в segmentationId вместо указания имени в поле segmentationName . (Менеджер кампаний также присваивает идентификатор действию Floodlight, но идентификатор Менеджера кампаний отличается от идентификатора Поисковой рекламы 360, и его нельзя использовать для атрибуции конверсий.) Чтобы просмотреть идентификатор Поисковой рекламы 360 для действия Floodlight, загрузите конверсии. отчет (либо из пользовательского интерфейса Search Ads 360 , либо через API отчетов ). Если хотя бы одна конверсия была связана с действием Floodlight в течение отчетного периода, вы увидите в отчете идентификатор Search Ads 360.

  • type : тип преобразования, то есть ACTION или TRANSACTION . Конверсия ДЕЙСТВИЯ не имеет денежной стоимости, в отличие от конверсии ТРАНЗАКЦИЯ. Примерами являются подписки на список рассылки (ДЕЙСТВИЕ) и покупки в электронной торговле (ТРАНЗАКЦИЯ).

    Если вы укажете TRANSACTION , вам также необходимо указать следующее поле:

    • revenueMicros : Денежная стоимость конверсии.

Необязательные поля

  • quantityMillis : количество элементов в этом преобразовании. Например, количество людей, подписавшихся на рассылку новостей по электронной почте, или общее количество проданных товаров. Если вы не укажете это поле для конверсий ACTION, Поисковая реклама 360 автоматически вставит значение 1000 .
  • currencyCode : Валюта дохода от транзакции. По умолчанию предполагается, что доход указан в валюте рекламодателя. Если вы укажете другую валюту, Поисковая реклама 360 преобразует указанную сумму дохода в валюту рекламодателя. Узнать больше
    Используйте буквенный (3-символьный) формат ISO 4217 для указания валюты.
    Применимо только к конверсиям TRANSACTION.
  • 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" : [{
   "agencyId": "12300000000000456", // Replace with your ID
   "advertiserId": "45600000000010291", // Replace with your ID
   "engineAccountId": "700000000042441", // Replace with your ID
   "campaignId": "71700000002044839", // Replace with your ID
   "adGroupId": "58700000032026064", // Replace with your ID
   "criterionId": "43700004289911004", // Replace with your ID
   "adId": "44700000155906860", // Replace with your ID
   "conversionId": "test_1383157519886",
   "conversionTimestamp": "1378710000000",
   "type": "ACTION",
   "quantityMillis": "3000",
   "segmentationType": "FLOODLIGHT",
   "segmentationName": "Test"
  }]
}

Джава

  /**
   * Creates an ACTION conversion that is attributed to a keyword and add. Adds the conversion
   * 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> addActionConversionForAdKeyword(List<Conversion> conversions,
      Long agencyId, Long advertiserId, Long engineAccountId, Long campaignId, Long adGroupId,
      Long criterionId, Long adId, String conversionId, Long quantity, Long timeStamp) {

    Conversion conversion = new Conversion()
        .setAgencyId(agencyId)
        .setAdvertiserId(advertiserId)
        .setEngineAccountId(engineAccountId)
        .setCampaignId(campaignId)
        .setAdGroupId(adGroupId)
        .setCriterionId(criterionId)
        .setAdId(adId)
        .setConversionId(conversionId)
        .setConversionTimestamp(BigInteger.valueOf(timeStamp))
        .setSegmentationType("FLOODLIGHT")
        .setSegmentationName("Test")
        .setType("ACTION")
        .setQuantityMillis(quantity);

    conversions.add(conversion);
    return conversions;
  }

питон

def insert_conversion(service):
  """Create and upload a TRANSACTION conversion that is attributed to a keyword
  and ad.

  Args:
    service: An authorized Doubleclicksearch service. See Set Up Your Application.
  """
  request = service.conversion().insert(
      body=
      {
          'conversion': [{
              'agencyId': '12300000000000456', // Replace with your ID
              'advertiserId': '45600000000010291', // Replace with your ID
              'engineAccountId': '700000000042441', // Replace with your ID
              'campaignId': '71700000002044839', // Replace with your ID
              'adGroupId': '58700000032026064', // Replace with your ID
              'criterionId': '43700004289911004', // Replace with your ID
              'adId': '44700000155906860', // Replace with your ID
              'conversionId': 'test_1383157519886',
              'conversionTimestamp': '1378710000000',
              'type': 'ACTION',
              'quantityMillis': '3000',
              'segmentationType': 'FLOODLIGHT',
              'segmentationName': 'Test'
              }]
      }
  )

  pprint.pprint(request.execute())

Связать конверсию только с ключевым словом

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

Обязательные поля

  • criterionId : это идентификатор ключевого слова. Вы можете получить criterionId , добавив макрос TrackerId в URL вашей целевой страницы. Информацию о получении идентификаторов ключевых слов см. в разделе Идентификаторы и конверсии Поисковой рекламы 360 .
  • conversionId : для офлайн-конверсий рекламодатели предоставляют этот идентификатор. Рекламодатели могут указать любой значимый для них идентификатор. Для каждой конверсии в запросе должен быть указан уникальный идентификатор, а комбинация идентификатора и метки времени должна быть уникальной среди всех конверсий рекламодателя. Для онлайн-конверсий Поисковая реклама 360 копирует dsConversionId или floodlightOrderId в это свойство в зависимости от инструкций рекламодателя Floodlight.
  • conversionTimestamp : указывает дату и время, когда произошло преобразование. Например, если преобразование происходит в пятницу, 05 августа 2016 г., в 11:53:22 по восточному летнему времени (GMT -4:00), укажите отметку времени в миллисекундах эпохи: 1470412402000 .
  • segmentationType : указывает тип системы конверсии, в которую вы загружаете конверсию. В настоящее время поддерживаются только конверсии Floodlight, поэтому в этом поле всегда необходимо указывать FLOODLIGHT .
  • segmentationName : название действия Floodlight, которое рекламодатель использует для отчета о конверсии.

    Если у вашего рекламодателя есть действия с одинаковыми названиями (это может произойти, если действия относятся к разным группам Floodlight), рекомендуется переименовать одно из действий .

    В качестве альтернативы, если вы знаете идентификатор, присвоенный Search Ads 360 действию Floodlight, вы можете указать идентификатор в segmentationId вместо указания имени в поле segmentationName . (Менеджер кампаний также присваивает идентификатор действию Floodlight, но идентификатор Менеджера кампаний отличается от идентификатора Поисковой рекламы 360, и его нельзя использовать для атрибуции конверсий.) Чтобы просмотреть идентификатор Поисковой рекламы 360 для действия Floodlight, загрузите конверсии. отчет (либо из пользовательского интерфейса Search Ads 360 , либо через API отчетов ). Если хотя бы одна конверсия была связана с действием Floodlight в течение отчетного периода, вы увидите в отчете идентификатор Search Ads 360.

  • type : тип преобразования, то есть ACTION или TRANSACTION . Конверсия ДЕЙСТВИЯ не имеет денежной стоимости, в отличие от конверсии ТРАНЗАКЦИЯ. Примерами являются подписки на список рассылки (ДЕЙСТВИЕ) и покупки в электронной торговле (ТРАНЗАКЦИЯ).

    Если вы укажете TRANSACTION , вам также необходимо указать следующее поле:

    • revenueMicros : Денежная стоимость конверсии.

Необязательные поля

  • quantityMillis : количество элементов в этом преобразовании. Например, количество людей, подписавшихся на рассылку новостей по электронной почте, или общее количество проданных товаров. Если вы не укажете это поле для конверсий ACTION, Поисковая реклама 360 автоматически вставит значение 1000 .
  • currencyCode : Валюта дохода от транзакции. По умолчанию предполагается, что доход указан в валюте рекламодателя. Если вы укажете другую валюту, Поисковая реклама 360 преобразует указанную сумму дохода в валюту рекламодателя. Узнать больше
    Используйте буквенный (3-символьный) формат ISO 4217 для указания валюты.
    Применимо только к конверсиям TRANSACTION.
  • 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())

Связать конверсию с товарами в торговой кампании

Торговые кампании создают товарные объявления на основе данных о товарах в фиде товаров Merchant Center. Чтобы связать конверсию с товаром, рекламируемым в торговой кампании, укажите в запросе Conversion.insert() все перечисленное ниже:

Обязательные поля

  • productId : идентификатор продукта . Рекламодатель указывает этот идентификатор в фиде инвентаря.
  • productGroupId : идентификатор группы товаров, которую вы хотите атрибутировать для конверсии. Поисковая реклама 360 присваивает этот идентификатор группе товаров при ее создании.
  • inventoryAccountId : идентификатор канала инвентаризации, к которому относится продукт. Поисковая реклама 360 присваивает этот идентификатор, когда рекламодатель связывает фид продуктов с Поисковой рекламой 360.

    Если аккаунт рекламодателя в Merchant Center является мультиаккаунтом , укажите идентификатор дочернего аккаунта, содержащего товар. Чтобы найти этот идентификатор, войдите в Search Ads 360, нажмите «Управление запасами» на левой панели навигации и просмотрите столбец «Идентификатор» на вкладке «Учетные записи запасов ».

  • productCountry : страна, указанная для фида Merchant Center, содержащего данные о товаре. Укажите код страны по ISO 3166 .
  • productLanguage : язык, заданный для фида Merchant Center, содержащего данные о товаре. Укажите код языка ISO 639 .
  • channel : укажите онлайн для онлайн-объявлений о товарах и местный для рекламы местного ассортимента.
  • storeId : для Local Inventory Ads укажите магазин, для которого рекламировался продукт. Это должно совпадать с идентификаторами магазинов, используемыми в вашем фиде товаров.
  • conversionId : для офлайн-конверсий рекламодатели предоставляют этот идентификатор. Рекламодатели могут указать любой значимый для них идентификатор. Для каждой конверсии в запросе должен быть указан уникальный идентификатор, а комбинация идентификатора и метки времени должна быть уникальной среди всех конверсий рекламодателя. Для онлайн-конверсий Поисковая реклама 360 копирует dsConversionId или floodlightOrderId в это свойство в зависимости от инструкций рекламодателя Floodlight.
  • conversionTimestamp : указывает дату и время, когда произошло преобразование. Например, если преобразование происходит в пятницу, 05 августа 2016 г., в 11:53:22 по восточному летнему времени (GMT -4:00), укажите отметку времени в миллисекундах эпохи: 1470412402000 .
  • segmentationType : указывает тип системы конверсии, в которую вы загружаете конверсию. В настоящее время поддерживаются только конверсии Floodlight, поэтому в этом поле всегда необходимо указывать FLOODLIGHT .
  • segmentationName : название действия Floodlight, которое рекламодатель использует для отчета о конверсии.

    Если у вашего рекламодателя есть действия с одинаковыми названиями (это может произойти, если действия относятся к разным группам Floodlight), рекомендуется переименовать одно из действий .

    В качестве альтернативы, если вы знаете идентификатор, присвоенный Search Ads 360 действию Floodlight, вы можете указать идентификатор в segmentationId вместо указания имени в поле segmentationName . (Менеджер кампаний также присваивает идентификатор действию Floodlight, но идентификатор Менеджера кампаний отличается от идентификатора Поисковой рекламы 360, и его нельзя использовать для атрибуции конверсий.) Чтобы просмотреть идентификатор Поисковой рекламы 360 для действия Floodlight, загрузите конверсии. отчет (либо из пользовательского интерфейса Search Ads 360 , либо через API отчетов ). Если хотя бы одна конверсия была связана с действием Floodlight в течение отчетного периода, вы увидите в отчете идентификатор Search Ads 360.

  • type : тип преобразования, то есть ACTION или TRANSACTION . Конверсия ДЕЙСТВИЯ не имеет денежной стоимости, в отличие от конверсии ТРАНЗАКЦИЯ. Примерами являются подписки на список рассылки (ДЕЙСТВИЕ) и покупки в электронной торговле (ТРАНЗАКЦИЯ).

    Если вы укажете TRANSACTION , вам также необходимо указать следующее поле:

    • revenueMicros : Денежная стоимость конверсии.

Необязательные поля

  • quantityMillis : количество элементов в этом преобразовании. Например, количество людей, подписавшихся на рассылку новостей по электронной почте, или общее количество проданных товаров. Если вы не укажете это поле для конверсий ACTION, Поисковая реклама 360 автоматически вставит значение 1000 .
  • currencyCode : Валюта дохода от транзакции. По умолчанию предполагается, что доход указан в валюте рекламодателя. Если вы укажете другую валюту, Поисковая реклама 360 преобразует указанную сумму дохода в валюту рекламодателя. Узнать больше
    Используйте буквенный (3-символьный) формат ISO 4217 для указания валюты.
    Применимо только к конверсиям TRANSACTION.
  • 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": [
  { // Conversion from a Local Inventory Ad
    "productGroupId": "92700000000000001", // Replace with your ID
    "productId": "123-abc", // Replace with your ID
    "inventoryAccountId": "97700000000000001", // Replace with your ID
    "productCountry": "US",
    "productLanguage": "en",
    "channel": "local",
    "storeId": "123456",
    "conversionId": "customerTransaction73126",
    "conversionTimestamp": "1376452740000",
    "segmentationType": "FLOODLIGHT",
    "segmentationName": "Offline Purchase",
    "type": "TRANSACTION",
    "state": "ACTIVE",
    "revenueMicros": "20000000", // 20 million revenueMicros is equivalent to $20 of revenue
    "currencyCode": "USD"
  },
  { // Conversion from an online product listing ad
    "productGroupId": "92700000000000001", // Replace with your ID
    "productId": "123-abc", // Replace with your ID
    "inventoryAccountId": "97700000000000001", // Replace with your ID
    "productCountry": "CA",
    "productLanguage": "en",
    "channel": "online",
    "conversionId": "customerTransaction73126", // Replace with your ID
    "conversionTimestamp": "1429229922000",
    "segmentationType": "FLOODLIGHT",
    "segmentationName": "shopact",
    "type": "ACTION",
    "state": "ACTIVE",
    "revenueMicros": "20000000",
    "currencyCode": "CAD"
  }]
}

Загружать данные из сторонней модели атрибуции

Модель атрибуции распределяет ценность конверсии по всем действиям на пути конверсии. Например, если потребитель нажимает на платное поисковое объявление, медийное объявление и другое платное поисковое объявление перед конверсией, линейная модель атрибуции дает каждому клику 33% ценности конверсии.

Хотя Поисковая реклама 360 предоставляет модели атрибуции , но если вы используете стороннюю службу или службу, которую вы разработали для распределения ценности кликов, вы можете загрузить сторонние данные атрибуции в Поисковую рекламу 360 и использовать эти данные в отчетах и ​​Поиске. Стратегии назначения ставок Ads 360.

Прежде чем ты начнешь

В Менеджере кампаний создайте пользовательскую модель атрибуции и импортируйте ее в Поисковую рекламу 360. Убедитесь, что вы назвали модель «Внешняя модель атрибуции» . Это позволяет функциям Поисковой рекламы 360 распознавать, что к загружаемым вами данным о конверсиях была применена модель атрибуции. Узнать больше

Обязательные поля

Чтобы применить к конверсии стороннюю модель атрибуции, укажите в запросе Conversion.insert() все перечисленное ниже:

  • clickId : Идентификатор клика посещения с учетом регистра. Найдите в веб-журналах рекламодателя идентификатор клика или составьте список конверсий и используйте идентификатор клика из другой конверсии. Поисковая реклама 360 будет связывать конверсию с ключевым словом, объявлением и другими объектами Поисковой рекламы 360, которые были ответственны за посещение.
    Подождите не менее 30 минут после того, как Поисковая реклама 360 сгенерирует идентификатор клика, прежде чем загружать конверсию с этим идентификатором. В противном случае API Search Ads 360 может не распознать посещение.
  • attributionModel : установите внешнюю модель атрибуции . Узнать больше
  • countMillis : сумма ценности конверсии, которую можно распределить по этому клику. Применимо, только если запрос также включает поле attributionModel .

    Не путайте это с quantityMillis , необязательным полем, которое указывает количество товаров в конверсии (например, количество товаров в корзине покупок).

  • conversionId : для офлайн-конверсий рекламодатели предоставляют этот идентификатор. Рекламодатели могут указать любой значимый для них идентификатор. Для каждой конверсии в запросе должен быть указан уникальный идентификатор, а комбинация идентификатора и метки времени должна быть уникальной среди всех конверсий рекламодателя. Для онлайн-конверсий Поисковая реклама 360 копирует dsConversionId или floodlightOrderId в это свойство в зависимости от инструкций рекламодателя Floodlight.
  • conversionTimestamp : указывает дату и время, когда произошло преобразование. Например, если преобразование происходит в пятницу, 05 августа 2016 г., в 11:53:22 по восточному летнему времени (GMT -4:00), укажите отметку времени в миллисекундах эпохи: 1470412402000 .
  • segmentationType : указывает тип системы конверсии, в которую вы загружаете конверсию. В настоящее время поддерживаются только конверсии Floodlight, поэтому в этом поле всегда необходимо указывать FLOODLIGHT .
  • segmentationName : название действия Floodlight, которое рекламодатель использует для отчета о конверсии.

    Если у вашего рекламодателя есть действия с одинаковыми названиями (это может произойти, если действия относятся к разным группам Floodlight), рекомендуется переименовать одно из действий .

    В качестве альтернативы, если вы знаете идентификатор, присвоенный Search Ads 360 действию Floodlight, вы можете указать идентификатор в segmentationId вместо указания имени в поле segmentationName . (Менеджер кампаний также присваивает идентификатор действию Floodlight, но идентификатор Менеджера кампаний отличается от идентификатора Поисковой рекламы 360, и его нельзя использовать для атрибуции конверсий.) Чтобы просмотреть идентификатор Поисковой рекламы 360 для действия Floodlight, загрузите конверсии. отчет (либо из пользовательского интерфейса Search Ads 360 , либо через API отчетов ). Если хотя бы одна конверсия была связана с действием Floodlight в течение отчетного периода, вы увидите в отчете идентификатор Search Ads 360.

  • type : тип преобразования, то есть ACTION или TRANSACTION . Конверсия ДЕЙСТВИЯ не имеет денежной стоимости, в отличие от конверсии ТРАНЗАКЦИЯ. Примерами являются подписки на список рассылки (ДЕЙСТВИЕ) и покупки в электронной торговле (ТРАНЗАКЦИЯ).

    Если вы укажете TRANSACTION , вам также необходимо указать следующее поле:

    • revenueMicros : Денежная стоимость конверсии.

Если вы отслеживаете доход от конверсии, убедитесь, что ваша модель распределяет доход по каждой точке взаимодействия на пути конверсии. Например, если в вашей модели используется линейный подход (равномерное распределение дохода по каждой точке взаимодействия), на пути конверсии, который включает 3 клика по объявлению, каждому клику будет приписано 33 % конверсии. Если конверсия принесла доход в размере 100 долларов США, убедитесь, что ваша модель распределяет доход в размере 33 долларов США на каждый клик, и убедитесь, что в доходе Micros указано только 33 доллара США дохода за каждый клик.

Необязательные поля

  • quantityMillis : количество элементов в этом преобразовании. Например, количество людей, подписавшихся на рассылку новостей по электронной почте, или общее количество проданных товаров. Если вы не укажете это поле для конверсий ACTION, Поисковая реклама 360 автоматически вставит значение 1000 .
  • currencyCode : Валюта дохода от транзакции. По умолчанию предполагается, что доход указан в валюте рекламодателя. Если вы укажете другую валюту, Поисковая реклама 360 преобразует указанную сумму дохода в валюту рекламодателя. Узнать больше
    Используйте буквенный (3-символьный) формат ISO 4217 для указания валюты.
    Применимо только к конверсиям TRANSACTION.
  • 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"
  }]
}

Обработка ответов Search Ads 360

Ответ от Search Ads 360 указывает на успех только в том случае, если все конверсии в запросе были успешно проверены и загружены.

Если запрос удался

Если запрос выполнен успешно, ответ включает полное внутреннее представление Поисковой рекламы 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 ) указывают на внутреннюю проблему в Поисковой рекламе 360.

Ответ на ошибку

Если запрос не выполнен, попробуйте повторно отправить весь вызов запроса позже. Поисковая реклама 360 сообщит об ошибках requestValidation для любых уже загруженных конверсий, но попытается загрузить оставшиеся конверсии.

Если вы по-прежнему видите ошибки после повторной отправки, просмотрите раздел устранения неполадок , чтобы узнать, как действовать дальше.