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

Bir veya daha fazla mevcut dönüşümde aşağıdaki değişiklik türlerini yapmak için Conversion.update() yöntemini çağırın:

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, mevcut bir dönüşümü her zaman KALDIRILDI olarak işaretleyebilir ve güncellenmiş tarih, tür, ilişkilendirme kimlikleri veya Floodlight etkinliğiyle yeni bir dönüşüm yükleyebilirsiniz (yeni bir conversionId de belirttiğinizden emin olun).

Search Ads 360 API aracılığıyla yüklenen dönüşümleri (çevrimdışı dönüşümler) ve Search Ads 360'ın Floodlight etiketleri aracılığıyla kaydettiği dönüşümleri (online dönüşümler) aşağıdaki zaman sınırlarına tabi olarak düzenleyebilirsiniz:

  • Dönüşümü clickId ile tanımlıyorsanız tıklama kimliği son 60 gün içinde oluşturulmuş olmalıdır (aksi takdirde 0x0000012F hata kodu gösterilir).
  • Floodlight etiketleri aracılığıyla kaydedilen dönüşümler yalnızca 28 gün içinde düzenlenebilir conversionTimestamp (aksi takdirde 0x00000125 hata kodu gösterilir).

Conversion.insert() yönteminde olduğu gibi, güncelleme isteğiniz birden fazla dönüşüm belirtiyorsa Search Ads 360, tüm grubu bir kerede güncellemek yerine her dönüşümü ayrı ayrı güncellemeye çalışır. Bir gruptaki bazı güncellemeler başarısız olsa bile diğerleri başarılı olabilir. Güncellemenin başarılı olduğundan emin olmak için güncellenen her dönüşümün yanıtını okumanızı öneririz.

dsConversionId desteğinin sonlandırılması

dsConversionId alanı kullanımdan kaldırıldı ve artık dönüşümleri tanımlamak için kullanılamaz. Search Ads 360 Conversion API'de dönüşümleri düzenlemek için conversionId (reklamveren dönüşüm kimliği) kullanmanız gerekir. Conversion.update(), aşağıdaki durumlarda dönüşümü 0x0000013C (Conversion editing using integer DS conversion ID is deprecated) hata koduyla reddeder:

  • dsConversionId alanını belirtir veya
  • conversionId alanında bir Search Ads 360 dönüşüm kimliği (Search Ads 360'ın her dönüşüm için oluşturduğu 17 haneli sayısal kimlik) iletir.

Önemli Değişiklikler:

  • dsConversionId Desteğin sonlandırılması: dsConversionID artık Search Ads 360 Conversion API'de, Search Ads 360 Reporting API'de (conversion.id olarak adlandırılır) veya raporlama kullanıcı arayüzünde ("Dönüşüm Kimliği" olarak adlandırılır) desteklenmiyor.
  • conversionId Şart: conversionId Search Ads 360 Conversion API aracılığıyla dönüşümleri düzenlemek için zorunlu bir alandır.

conversionId nasıl alınır?

  • Search Ads 360 API aracılığıyla yüklenen dönüşümler: Dönüşümü eklerken belirttiğiniz conversionId değerini kullanın.
  • Floodlight etiketleri aracılığıyla kaydedilen dönüşümler: Floodlight etiketinin dönüşüm için bildirdiği Floodlight sipariş kimliğini (ord değeri) kullanın (ör. bir Floodlight satış etkinliğinin sipariş veya işlem kimliği).
  • Search Ads 360 Reporting API: Search Ads 360 Reporting API'yi kullanarak advertiser_conversion_id alabilirsiniz. Bu değer, düzenleme için gereken conversionId değerine karşılık gelir.
  • Search Ads 360 kullanıcı arayüzü: "Reklamveren dönüşüm kimliği"ni Search Ads 360 kullanıcı arayüzündeki dönüşüm raporlama sayfasında bulabilirsiniz. SA360 raporlarındaki dönüşüm kimliği

Güncelleme isteği gönderme

Conversion.update() içinde belirttiğiniz alanların çoğu, güncellemek istediğiniz dönüşümleri tanımlamak için kullanılır. Mevcut bir dönüşümü tanımlamak 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 anahtar kelimesini belirtin (customerId, campaignId, adGroupId ve criterionId)

Her iki teknikte de dönüşümün conversionId, conversionTimestamp ve işlem type değerlerini belirtmeniz gerekir. conversionTimestamp, mevcut dönüşümün zaman damgası olmalıdır (UTC sıfır zaman milisaniyesi biçiminde). Zaman damgası mevcut dönüşümle eşleşmiyorsa (örneğin, yerel bir saat diliminden dönüştürüldüğü için) Search Ads 360 dönüşümü bulamaz ve 0x0000011B hata kodunu döndürür.

Search Ads 360'ın Floodlight etiketleri aracılığıyla kaydettiği dönüşümler için dönüşümün Floodlight etkinliğini de belirtmeniz gerekir (segmentationType ve segmentationName ya da segmentationId). Aksi takdirde istek, 0x0000010C hata koduyla başarısız olur. Her güncelleme isteğinde Floodlight etkinliğini belirtmenizi öneririz.

Ayrıca, orijinal dönüşümde revenueMicros ve currencyCode veya quantityMillis belirtilmişse güncelleme isteğinde bu verilerin belirtilmesi gerekir (değiştirmiyor olsanız bile).

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

Bir dönüşüm başlangıçta bir tıklama kimliği belirtiyorsa aşağıdaki alanları belirten bir Conversion.update() isteği gönderebilirsiniz:

  • clickId
  • conversionId
  • conversionTimestamp
  • type
  • segmentationType ve segmentationName (veya segmentationId) (Floodlight etiketleri aracılığıyla kaydedilen dönüşümler için gereklidir, tüm dönüşümler için önerilir)
  • state (Yalnızca durumu KALDIRILDI veya ETKİN olarak değiştirmek istiyorsanız gereklidir.)
  • 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

Mevcut iki dönüşüme örnek olarak şunlar verilebilir:

{
 "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ğerini kaldırır:

JSON

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

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",
   "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",
   "conversionTimestamp": "1378710000000",
   "segmentationType" : "FLOODLIGHT",
   "segmentationName" : "Test",
   "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. This sample hard-codes the segmentation name.
    Conversion conversion = new Conversion()
        .setClickId(clickId)
        .setConversionId(conversionId)
        .setConversionTimestamp(BigInteger.valueOf(timeStamp))
        .setSegmentationType("FLOODLIGHT")
        .setSegmentationName("Test")
        .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 tanımlama

Tıklama kimliğine erişiminiz yoksa veya bir dönüşüm başlangıçta bir anahtar kelime ya da anahtar kelime/reklam ile ilişkilendirildiyse aşağıdaki alanları belirten bir Conversion.update() isteği gönderebilirsiniz:

  • customerId, campaignId, adGroupId ve criterionId (anahtar kelimeyi tanımlayan yeni Search Ads 360 kimlikleri)
  • conversionId
  • conversionTimestamp
  • type
  • state (Yalnızca durumu KALDIRILDI veya ETKİN olarak değiştirmek istiyorsanız gereklidir.)
  • 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)

Anahtar kelime kimlikleri yalnızca bir reklam grubu içinde benzersizdir. Bu nedenle, dört kimliğin tümünü belirtmeniz gerekir. Bir dönüşümde customerId, campaignId veya adGroupId olmadan criterionId belirtilirse güncelleme 0x0000012E hata koduyla başarısız olur. Dönüşümün reklam kimliği gibi diğer kimlikleri belirtmeniz gerekmez.

Örnek

Mevcut bir dönüşüm örneği:

{
 "kind": "doubleclicksearch#conversionList",
  "conversion" : [{
   "customerId": "123-456-7890",
   "campaignId": "14660344555",
   "adGroupId": "105138634255",
   "criterionId": "948710340465",
   "conversionId": "test_1383157519886",
   "conversionTimestamp": "1378710000000",
   "type": "ACTION",
   "quantityMillis": "1000",
   "segmentationType": "FLOODLIGHT",
   "segmentationName": "Test"
  }]
}     

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

JSON

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

PUT https://www.googleapis.com/doubleclicksearch/v2/conversion
Authorization: Bearer your OAuth 2.0 access token
Content-type: application/json
{
 "kind": "doubleclicksearch#conversionList",
 "conversion": [
  {
   "customerId": "123-456-7890", // Replace with your ID
   "campaignId": "14660344555", // Replace with your ID
   "adGroupId": "105138634255", // Replace with your ID
   "criterionId": "948710340465", // 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,
        "123-456-7890",       // customerId. Replace with your ID
        14660344555L,         // campaignId. Replace with your ID
        105138634255L,        // adGroupId. Replace with your ID
        948710340465L,        // 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,
       String customerId,
       Long campaignId,
       Long adGroupId,
       Long criterionId,
       String conversionId,
       Long timeStamp,
       String type,
       String state,
       Long quantity,
       Long revenue,
       String currency
    ) {

   Conversion conversion = new Conversion()
   .setCustomerId(customerId)
   .setCampaignId(campaignId)
   .setAdGroupId(adGroupId)
   .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 quantity of a conversion. Use the keyword's IDs (customerId,
  campaignId, adGroupId, and criterionId) to identify the conversion.

  Args:
    service: An authorized Doubleclicksearch service. See Set Up Your Application.
  """
  request = service.conversion().update(
      body=
      {
          'conversion': [{
              'customerId': '123-456-7890', // Replace with your ID
              'campaignId': '14660344555', // Replace with your ID
              'adGroupId': '105138634255', // Replace with your ID
              'criterionId': '948710340465', // Replace with your ID
              'conversionId': 'test_1383157519886',
              'conversionTimestamp': '1378710000000',
              'type': 'ACTION',
              'quantityMillis': '3000'
            }]
      }
  )

  pprint.pprint(request.execute())

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

Güncelleme isteğine verilen yanıt, ekleme isteğine verilen yanıtla aynıdır: Search Ads 360, yalnızca istekteki tüm dönüşümler başarıyla güncellendiyse başarılı olduğunu belirtir.

İstek başarılı olursa yanıt, güncellenen her dönüşüm için yeni Search Ads 360 müşteri kimliği, kampanya kimliği, reklam grubu kimliği ve anahtar kelime (ölçüt) kimliği gibi tam Search Ads 360 dahili temsilini içerir.

Bir veya daha fazla güncelleme doğrulanamaz ya da yüklenemezse yanıtta, başarısız olan her güncelleme için hata mesajları yer alır. Yanıt, başarıyla güncellenen dönüşümlerle ilgili mesajlar içermez. Bu hata mesajları hakkında daha fazla bilgi için ekleme istekleriyle ilgili Search Ads 360 yanıtlarını işleme bölümüne bakın.