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:
- Geliri, para birimi kodunu veya miktarı değiştirin.
- Reklamveren tarafından sağlanan sipariş kimliğini ve özel Floodlight değişkenlerini değiştirin.
conversion.statedeğeriniACTIVEyerineREMOVEDolarak değiştirerek dönüşümü kaldı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ü
clickIdile tanımlıyorsanız tıklama kimliği son 60 gün içinde oluşturulmuş olmalıdır (aksi takdirde0x0000012Fhata kodu gösterilir). -
Floodlight etiketleri aracılığıyla kaydedilen dönüşümler yalnızca 28 gün içinde düzenlenebilir
conversionTimestamp(aksi takdirde0x00000125hata 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:
dsConversionIdalanını belirtir veyaconversionIdalanı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:
-
dsConversionIdDesteğin sonlandırılması:dsConversionIDartık Search Ads 360 Conversion API'de, Search Ads 360 Reporting API'de (conversion.idolarak adlandırılır) veya raporlama kullanıcı arayüzünde ("Dönüşüm Kimliği" olarak adlandırılır) desteklenmiyor. -
conversionIdŞart:conversionIdSearch 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
conversionIddeğ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 (
orddeğ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_idalabilirsiniz. Bu değer, düzenleme için gerekenconversionIddeğ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.
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
clickIddeğ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,adGroupIdvecriterionId)
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:
clickIdconversionIdconversionTimestamptypesegmentationTypevesegmentationName(veyasegmentationId) (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,adGroupIdvecriterionId(anahtar kelimeyi tanımlayan yeni Search Ads 360 kimlikleri)conversionIdconversionTimestamptypestate(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.