Mevcut Dönüşümleri Değiştir

Conversion.update() numaralı telefonu arayın yöntemini kullanmanızı öneririz:

Search Ads 360 aşağıdakilerin değiştirilmesini desteklemez:

  • Dönüşüm tarihi.
  • Dönüşüm türü.
  • Dönüşümle ilişkilendirilen anahtar kelime veya ziyaret.
  • Floodlight etkinliği veya etkinlik adı.

Ancak dilediğiniz zaman mevcut bir dönüşümü KALDIRILDI olarak işaretleyebilir ve yeni bir dönüşüm yükleyebilirsiniz. tarih, tür, ilişkilendirme kimlikleri veya Floodlight etkinliğiyle ( yeni conversionId için de ekleyebilirsiniz).

Conversion.insert() ürününde olduğu gibi, güncelleme isteğiniz birden fazla Search Ads 360, her bir dönüşümü en iyi çaba esasına göre güncellemeyi dener. "ya hep ya hiç" işlemi olarak güncellemek yerine. başarısız olursa diğerleri başarılı olabilir. Şunları okumanızı öneririz: "yanıtla" seçeneğini belirleyin.

Güncelleme isteği gönder

Conversion.update() içinde belirttiğiniz alanların çoğu şu amaçlarla kullanılır: ve güncellemek istediğiniz dönüşümleri belirleyin. Aşağıdakilerden birini kullanabilirsiniz: mevcut bir dönüşümü belirlemek için aşağıdaki tekniklerden birini kullanabilirsiniz:

  • Dönüşümün clickId değerini belirtin
    • Düzenlenen tüm dönüşümler, tıklama kimliğinin oluşturulduğu tarihten itibaren 60 gün içinde olmalıdır.
  • Dönüşümün criterionId (anahtar kelime kimliği) değerini belirtin

Her iki teknik de dönüşümün conversionId, conversionTimestamp, ve type işlemi.

Ayrıca, orijinal dönüşümde revenueMicros ve currencyCode belirtilmişse veya quantityMillis kullanıyorsanız güncelleme isteğinde, değiştirmiyor.

Dönüşümü tıklama kimliğine göre tanımlama

Dönüşümün başlangıçta tıklama kimliği belirtilmişse Conversion.update() gönderebilirsiniz şu alanları belirten bir istek oluşturun:

  • clickId
  • conversionId
  • conversionTimestamp
  • type
  • state (yalnızca durumu KALDIRILDI olarak değiştirmek istiyorsanız gereklidir veya ETKİN)
  • quantityMillis (yalnızca orijinal dönüşümde belirtilmişse)
  • revenueMicros (yalnızca orijinal dönüşümde belirtilmişse)
  • currencyCode (yalnızca orijinal dönüşümde belirtilmişse)

Örnek

Aşağıda, mevcut iki dönüşüm örneği verilmiştir: 

{
 "kind": "doubleclicksearch#conversionList",
  "conversion" : [{
    "clickId" : "COiYmPDTv7kCFcP0KgodOzQAAA",
    "conversionId" : "test_20130906_10",
    "conversionTimestamp" : "1378710000000",
    "segmentationType" : "FLOODLIGHT",
    "segmentationName" : "Test",
    "type": "TRANSACTION",
    "revenueMicros": "100000000", // 100 million revenueMicros is equivalent to $100 of revenue
    "currencyCode": "USD"
  },
  {
   "clickId": "COiYmPDTv7kCFcP0KgodOzQAAA",
   "conversionId": "test_1383337059137",
   "conversionTimestamp": "1378710000000",
   "segmentationType" : "FLOODLIGHT",
   "segmentationName" : "Test",
   "type": "ACTION",
   "quantityMillis": "1000"
  }]
}

Aşağıdaki istek, önceki örnekteki dönüşümlerden birini günceller ve diğeri:

JSON

Bir Conversion.update() isteğinin PUT yöntemini kullandığını unutmayın HTTP yöntemidir. 

PUT 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 data from your site
   "conversionId": "test_20130906_10",
   "conversionTimestamp": "1378710000000",
   "type": "TRANSACTION",
   "revenueMicros": "90000000", // 90 million revenueMicros is equivalent to $90 of revenue
   "currencyCode": "USD"
  },
  {
   "clickId": "COiYmPDTv7kCFcP0KgodOzQAAA", // Replace with data from your site
   "conversionId": "test_1383337059137",
   "conversionTimestamp": "1378710000000",
   "type": "ACTION",
   "quantityMillis": "1000",
   "state": "REMOVED"
  }
 ]
}

Java

/**
 * Instantiate the Doubleclicksearch service, create a conversion that updates an existing conversion,
 * and upload the conversions.
 */
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>();

  // Create a conversion and add it to the conversion list.
  // Just to get a little fancy, the updateConversionFromVisit() method can be used for all
  // visit conversions, including conversions that don't specify quantity, revenue, or currency.
  // If quantityMillis wasn't specified in the original conversion, specify -1L for the
  // quantityMillis parameter. Likewise, if revenueMicros wasn't specified originally,
  // specify -1L for the revenueMicros parameter and an empty string for currency.
  conversionList = updateConversionFromVisit(
      conversionList,
      "COiYmPDTv7kCFcP0KgodOzQAAA", // clickId. Replace with data from your site
      "test_20130906_10",           // conversionId
      1378710000000L,               // timeStamp
      "TRANSACTION",                // type
      "",                           // state
      -1L,                          // quantityMillis
      90000000L,                    // revenueMicros. Equivalent to $90 of revenue
      "USD");                       // currencyCode

   // Here's a conversion that needs to be removed. Just set the state parameter to "REMOVED".
   conversionList = updateConversionFromVisit(
      conversionList,
      "COiYmPDTv7kCFcP0KgodOzQAAA", // clickId. Replace with data from your site
      "test_1383337059137",         // conversionId
      1378710000000L,               // timeStamp
      "ACTION",                     // type
      "REMOVED",                    // state
      1000L,                        // quantityMillis
      -1L,                          // revenueMicros
      "");                          // currencyCode

    // Upload the List and handle the response.
    uploadConversions(conversions, service); // See an example in Add New Conversions. 
  }

/**
 * Create a conversion and add it to a List<Conversion>.
 */
  private static List<Conversion> updateConversionFromVisit(List<Conversion> conversions,
      String clickId,
      String conversionId,
      Long timeStamp,
      String type,
      String state,
      Long quantity,
      Long revenue,
      String currency) {

    // Identifies the existing conversion.
    Conversion conversion = new Conversion()
        .setClickId(clickId)
        .setConversionId(conversionId)
        .setConversionTimestamp(BigInteger.valueOf(timeStamp))
        .setType(type);

    // Only add these fields if the value is not empty greater than -1.
    if(!state.isEmpty()) conversion.setState(state);
    if (quantity > -1L) {
      conversion.setQuantityMillis(quantity);
    }
    if (revenue > -1L) {
      conversion.setRevenueMicros(revenue);
      if (!currency.isEmpty()) {
        conversion.setCurrencyCode(currency);
      } else {
        System.err.println(String.format(
            "Can't add conversion %s. It specifies revenue but no currency.",
            conversion.getConversionId()));
        return conversions;
      }
    }

    conversions.add(conversion);
    return conversions;
  }

Python

def update_conversion(service):
  """Change the revenue for one existing conversion and remove another.

  Args:
    service: An authorized Doubleclicksearch service. See Set Up Your Application.
  """
  request = service.conversion().update(
      body=
      {
          'conversion' : [{
              'clickId' : 'COiYmPDTv7kCFcP0KgodOzQAAA', // Replace with data from your site
              'conversionId' : 'test_20130906_13',
              'conversionTimestamp' : '1378710000000',
              'segmentationType' : 'FLOODLIGHT',
              'segmentationName' : 'Test',
              'type': 'TRANSACTION',
              'revenueMicros': '90000000', // 90 million revenueMicros is equivalent to $90 of revenue
              'currencyCode': 'USD'
            },
            {
             'clickId': 'COiYmPDTv7kCFcP0KgodOzQAAA', // Replace with data from your site
             'conversionId': 'test_1383337059137_01',
             'conversionTimestamp': '1378710000000',
             'segmentationType' : 'FLOODLIGHT',
             'segmentationName' : 'Test',
             'type': 'ACTION',
             'quantityMillis': '1000',
             'state': 'REMOVED'
            }]
      }
  )

  pprint.pprint(request.execute())

Dönüşümü anahtar kelime kimliğine göre belirle

Tıklama kimliğine erişiminiz yoksa veya bir dönüşümün orijinal olarak bir Conversion.update() isteği gönderebilirsiniz. aşağıdaki alanları belirtir:

  • criterionId (anahtar kelime kimliği)
  • conversionId
  • conversionTimestamp
  • type
  • state (yalnızca durumu KALDIRILDI olarak değiştirmek istiyorsanız gereklidir veya ETKİN)
  • quantityMillis (yalnızca orijinal dönüşümde belirtilmişse)
  • revenueMicros (yalnızca orijinal dönüşümde belirtilmişse)
  • currencyCode (yalnızca orijinal dönüşümde belirtilmişse)

İsteğe bağlı olarak dönüşümün reklam kimliği, kampanya kimliği, kullanabilirsiniz, ancak buna gerek yoktur. Search Ads 360'ın aşağıdakileri yapması için yalnızca yukarıdaki listede bulunan kimliklere ihtiyacı vardır: Mevcut bir dönüşümü tanımlama.

Örnek

Aşağıda, mevcut bir dönüşüm örneği verilmiştir: 

{
 "kind": "doubleclicksearch#conversionList",
  "conversion" : [{
   "agencyId": "12300000000000456",
   "advertiserId": "45600000000010291",
   "engineAccountId": "700000000042441",
   "campaignId": "71700000002044839",
   "adGroupId": "58700000032026064",
   "criterionId": "43700004289911004",
   "adId": "44700000155906860",
   "conversionId": "test_1383157519886",
   "conversionTimestamp": "1378710000000",
   "type": "ACTION",
   "quantityMillis": "1000",
   "segmentationType": "FLOODLIGHT",
   "segmentationName": "Test"
  }]
}

Aşağıdaki istek, dönüşümün zaman damgasını günceller:

JSON

Bir Conversion.update() isteğinin PUT yöntemini kullandığını unutmayın HTTP yöntemidir. 

PUT https://www.googleapis.com/doubleclicksearch/v2/conversion
Authorization: Bearer your OAuth 2.0 access token
Content-type: application/json
{
 "kind": "doubleclicksearch#conversionList",
 "conversion": [
  {
   "criterionId": "43700004289911004", // Replace with your ID
   "conversionId": "test_1383157519886",
   "conversionTimestamp": "1378710000000",
   "type": "ACTION",
   "quantityMillis": "3000"
  }
 ]
}

Java

    // Send conversion data to updateConversion, which creates a conversion and adds it
    // to the conversion list.
    conversionList =  updateConversionFromKeyword(conversionList,
        43700004289911004L,   // criterionId. Replace with your ID
        "test_1383157519886", // conversionId
        1378710000000L,       // timeStamp
        "ACTION",             // type
        "",                   // state
        3000L,                // quantityMillis
        -1L,                  // revenueMicros
        "");                  // currencyCode

  private static List<Conversion> updateConversionFromKeyword(List<Conversion> conversions,
       Long criterionId,
       String conversionId,
       Long timeStamp,
       String type,
       String state,
       Long quantity,
       Long revenue,
       String currency
    ) {

   Conversion conversion = new Conversion()
   .setCriterionId(criterionId)
   .setConversionId(conversionId)
   .setConversionTimestamp(BigInteger.valueOf(timeStamp))
   .setType(type);

   // Only add these fields if the value is not empty greater than -1.
   if(!state.isEmpty()) conversion.setState(state);
   if (quantity > -1L) {
     conversion.setQuantityMillis(quantity);
   }
   if (revenue > -1L) {
     conversion.setRevenueMicros(revenue);
     if (!currency.isEmpty()) {
       conversion.setCurrencyCode(currency);
     } else {
       System.err.println(String.format(
           "Can't add conversion %s. It specifies revenue but no currency.",
           conversion.getConversionId()));
       return conversions;
     }
   }

   conversions.add(conversion);
   return conversions;
   }

Python

def update_conversion(service):
  """Change the timestamp of a conversion. Use only the keyword id (criterionId)
  to identify the conversion.

  Args:
    service: An authorized Doubleclicksearch service. See Set Up Your Application.
  """
  request = service.conversion().update(
      body=
      {
          'conversion': [{
              'criterionId': '43700004289911004', // Replace with your ID
              'conversionId': 'test_1383157519886',
              'conversionTimestamp': '1378760000000',
              'type': 'ACTION',
              'quantityMillis': '1000'
            }]
      }
  )

  pprint.pprint(request.execute())

Search Ads 360 yanıtlarını işleme

Güncelleme isteğinin yanıtı, ekleme işleminin yanıtıyla aynıdır. istek: Search Ads 360, yalnızca istekteki tüm dönüşümler başarıyla başarıyla güncellendi.

İstek başarılı olursa yanıt, Search Ads 360 dahili sürümünün tamamını içerir her güncellenmiş dönüşümün temsili (ör. kampanya kimliği, reklam grubu kimliği ve anahtar kelime) (ölçüt) kimliği.

Bir veya daha fazla güncelleme doğrulanamazsa veya yüklenemezse yanıtta hata mesajı gösterilir. mesajı gösterilir. Yanıt, dönüşümlerle ilgili mesajlar içermiyor başarılı bir şekilde güncellendi. Bu hata mesajları hakkında daha fazla bilgi edinmek için İşleme yönelik Ekleme istekleri için Search Ads 360 yanıtları.