Yeni Dönüşüm Ekle

Bir veya daha fazla dönüşüm eklemek için Conversion.insert() yöntemini çağırın. Dönüşümün doğru şekilde ilişkilendirilmesi için isteğinizde, reklamverenin çevrimdışı dönüşümleri raporlamak üzere kullandığı bir Floodlight etkinliğinin adı ile anahtar kelimenin, reklamın ve muhtemelen dönüşüme yol açan tıklamanın kimliği belirtilmelidir. Search Ads 360 kimliklerini edinme hakkında bilgi için Search Ads 360 kimlikleri ve dönüşümleri başlıklı makaleyi inceleyin.

Geçmiş dönüşümleri yüklemeyle ilgili kısıtlamalar hakkında bilgiyi Search Ads 360 Yardım Merkezi'nde bulabilirsiniz.

Conversion.insert() isteğinizde birden fazla dönüşüm belirtiliyorsa Search Ads 360, tüm grubu her şey dahil işlem olarak yüklemek yerine her dönüşümü en iyi çaba temelinde yüklemeye çalışır. Bir toplu işlemdeki bazı dönüşümler yüklenemezse diğerleri yine de başarıyla yüklenebilir. Dönüşüm yüklemeleri, geçersiz istek veya geçici ağ ya da sistem arızaları nedeniyle başarısız olabilir. Bu nedenle, yüklemenin başarılı olduğundan emin olmak için eklenen her dönüşümle ilgili yanıtı okumanızı öneririz.

Yüklenen verileri ne kadar kısa sürede kullanabilirim?

Bir dönüşüm için bugünün veya dünün conversionTimestamp değerini belirtirseniz dönüşüme ilişkin metrikler, yüklemeden sonraki bir saat içinde Search Ads 360 kullanıcı arayüzünde görünür. Dünden daha eski bir conversionTimestamp belirtirseniz metrikler birkaç saat içinde güncellenir.

Dönüşümlerin tüm zaman damgalarını Epoch zamanına (Unix zamanı olarak da bilinir) dönüştürün.

API'den Floodlight etkinlikleri oluşturabilir miyim?

Reklamveren henüz çevrimdışı dönüşümleri izlemek için bir Floodlight etkinliği oluşturmadıysa Campaign Manager API'yi kullanarak bir etkinlik oluşturabilirsiniz. API'yi kullanarak bir Floodlight etkinliğinin öncelikli olarak çevrimdışı dönüşümler için kullanıldığını belirtemezsiniz. Bu, teklif stratejileri dönüşümden gelen verileri kullanırken en iyi uygulamadır.

API'yi kullanarak bir Floodlight etkinliği oluşturduktan sonra bir Search Ads 360 kullanıcısının Search Ads 360'ta oturum açmasını ve etkinliğin ayarını dönüşümlerin birincil kaynağının çevrimdışı etkinlik olduğunu belirtecek şekilde değiştirmesini öneririz.

Dönüşüm eklemeyle ilgili en iyi uygulamalar

Dönüşüm eklemeyle ilgili olarak aşağıdaki en iyi uygulamaları öneririz:

  1. Bir Search Ads 360 kullanıcısından Search Ads 360'ta oturum açmasını ve çevrimdışı dönüşümleri bildirmek için kullandığınız her Floodlight etkinliğinin ayarlarını değiştirmesini isteyin. Ayarlar, dönüşümlerin birincil kaynağının çevrimdışı etkinlik olduğunu belirtmelidir. Talimatlar için Search Ads 360 Yardım Merkezi'ne bakın.

  2. Dönüşümleri müsait olur olmaz yükleyin. Dönüşümleri belirli ziyaretlerle ilişkilendiriyorsanız dönüşümü yüklemeden önce ziyaretin üzerinden en az 6 saat geçmesini bekleyin. Search Ads 360, ziyaretin üzerinden 6 saat geçmeden yükleme yaparsanız ziyaretin tıklama kimliğini tanımayabilir. Nadiren karşılaşılan durumlarda, Search Ads 360'ın tıklama kimliğini tanıması için 24 saate kadar beklemeniz gerekebilir.

    Her yüklemenin en yeni dönüşümleri içerdiğinden emin olun. Tek bir yükleme isteğinde girişlerin kronolojik sırayla olmaması sorun teşkil etmez. Ancak teklif stratejisi, farklı bir istekte daha sonra yükleyeceğiniz daha eski dönüşümleri dikkate almayabilir.

Ekleme isteği gönderme

Aşağıdakilerden herhangi birini yapmak için Conversion.insert() isteği gönderebilirsiniz:

  • Dönüşümü belirli bir ziyaretle ilişkilendirme
  • Dönüşümü yalnızca bir anahtar kelimeyle ilişkilendirme

Bir Conversion.insert() isteğinde zorunlu olan alanlar, dönüşümü ilişkilendirdiğiniz etkinliğe veya öğeye bağlıdır. Aşağıdaki bölümlerde, dönüşüm ilişkilendirebileceğiniz her etkinlik veya öğe için zorunlu ve isteğe bağlı alanlar listelenmektedir.

Dönüşümü belirli bir ziyaretle ilişkilendirme

Bir müşteri bir veya daha fazla reklamı tıklayıp bir reklamverenin sitesine ulaştığında, Search Ads 360, reklamverenin sitesindeki kullanıcı oturumunu ziyaret olarak kabul eder. Bir dönüşümü ziyarete atfetmek için Conversion.insert() isteğinizde aşağıdakileri belirtin:

Zorunlu alanlar

  • clickId: Ziyaretin büyük/küçük harfe duyarlı tıklama kimliği. Tıklama kimliği veya liste dönüşümleri için reklamverenin web günlüklerine bakın ve başka bir dönüşümden tıklama kimliği kullanın. Search Ads 360, dönüşümü ziyareti oluşturmaktan sorumlu olan anahtar kelime, reklam ve diğer Search Ads 360 nesneleriyle ilişkilendirir.
    Search Ads 360, dönüşümleri yüklemek için bir tıklama kimliği oluşturduktan sonra en az 6 saat bekleyin. "Tıklama kimliği bulunamadı" hatası alırsanız 24 saat bekleyip dönüşümleri tekrar yükleyin. Tüm dönüşümler, tıklama kimliğinin oluşturulmasından sonraki 90 gün içinde yüklenmelidir. Aksi takdirde, Search Ads 360 API ziyareti tanımayabilir.
  • conversionId: Çevrimdışı dönüşümlerde bu kimlik reklamverenler tarafından sağlanır. Reklamverenler, kendileri için anlamlı olan herhangi bir kimliği belirtebilir. Bir istekteki her dönüşüm benzersiz bir kimlik belirtmelidir ve kimlik ile zaman damgası kombinasyonu, reklamverendeki tüm dönüşümler arasında benzersiz olmalıdır. Search Ads 360, online dönüşümler için reklamverenin Floodlight talimatlarına bağlı olarak dsConversionId veya floodlightOrderId değerini bu mülke kopyalar.
  • conversionTimestamp: Dönüşümün gerçekleştiği tarih ve saati gösterir. Örneğin, dönüşüm 05 Ağustos 2016 Cuma günü 11:53:22 Doğu Yaz Saati'nde (GMT -4:00) gerçekleşirse zaman damgasını Epoch milisaniye cinsinden belirtin: 1470412402000.
  • segmentationType: Dönüşümü yüklediğiniz dönüşüm sisteminin türünü belirtir. Şu anda yalnızca Floodlight dönüşümleri desteklenmektedir. Bu nedenle, bu alanda her zaman FLOODLIGHT belirtilmesi gerekir.
  • segmentationName: Reklamverenin dönüşümü bildirmek için kullandığı Floodlight etkinliğinin adıdır.

    Reklamvereninizde aynı ada sahip etkinlikler varsa (bu durum, etkinlikler farklı Floodlight gruplarına aitse oluşabilir) etkinliklerden birini yeniden adlandırmanız önerilir.

    Alternatif olarak, Search Ads 360'ın bir Floodlight etkinliğine atadığı kimliği biliyorsanız, segmentationName alanında adı belirtmek yerine segmentationId alanında kimliği belirtebilirsiniz. (Campaign Manager, Floodlight etkinliğine de bir kimlik atar ancak Campaign Manager kimliği Search Ads 360 kimliğinden farklıdır ve dönüşümleri ilişkilendirmek için kullanılamaz.) Bir Floodlight etkinliğinin Search Ads 360 kimliğini görüntülemek için bir dönüşüm raporu indirin (Search Ads 360 kullanıcı arayüzünden veya raporlama API'sinden). Raporun zaman aralığı içinde Floodlight etkinliğiyle ilişkilendirilmiş en az bir dönüşüm varsa raporda Search Ads 360 kimliğini görürsünüz.

  • type: Dönüşüm türü, yani ACTION veya TRANSACTION. Bir İŞLEM dönüşümünün parasal değeri yoktur ancak bir İŞLEM dönüşümünün parasal değeri vardır. Örneğin, e-posta listesine kaydolma (İŞLEM) ile e-ticaret satın alma işlemleri (İŞLEM) karşılaştırılabilir.

    TRANSACTION öğesini belirtirseniz aşağıdaki alanı da belirtmeniz gerekir:

    • revenueMicros: Dönüşümün parasal değeri.

İsteğe bağlı alanlar

  • quantityMillis: Bu dönüşümdeki öğe sayısıdır. Örneğin, e-posta bültenine kaydolan kişi sayısı veya satılan öğelerin toplam miktarı. İŞLEM dönüşümleri için bu alanı belirtmezseniz Search Ads 360 otomatik olarak 1000 değerini ekler.
  • currencyCode: İşlem gelirinin para birimi. Varsayılan olarak, gelirin reklamverenin para biriminde olduğu varsayılır. Farklı bir para birimi belirtirseniz Search Ads 360, belirtilen gelir tutarını reklamverenin para birimine dönüştürür. Daha fazla bilgi
    Para birimini belirtmek için ISO 4217 alfabetik (3 karakterli) biçimini kullanın.
    Yalnızca İŞLEM dönüşümleri için geçerlidir.
  • customMetric ve customDimension: Satın alınan bir öğenin gönderildiği ülke, ürün kimlikleri veya telefon görüşmesinin süresi gibi bir dönüşümle ilgili ek veriler yükler. Özel Floodlight değişkenleri için veri yükleme hakkında daha fazla bilgi edinin.
  • deviceType: Dönüşümün gerçekleştiği cihazın türünü belirtir. Bu alan için kabul edilen değerlerin listesini inceleyin.

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"
  }]
}

Java

  /**
   * 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());
    }
  }

Python

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())

Dönüşümü yalnızca bir anahtar kelimeyle ilişkilendirme

Öncelikli olarak dönüşümleri anahtar kelimelerle ilişkilendirmek istiyorsanız ve reklamlarla ilişkilendirme konusunda endişelenmiyorsanız Search Ads 360 tanımlayıcılarının çoğunu atlayabilir ve yalnızca anahtar kelimenin tanımlayıcısını birkaç alanla birlikte belirtebilirsiniz:

Zorunlu alanlar

  • criterionId: Bu, anahtar kelime tanımlayıcısıdır. Açılış sayfası URL'lerinize TrackerId makrosunu ekleyerek criterionId değerini alabilirsiniz. Anahtar kelime kimliklerini edinme hakkında bilgi için Search Ads 360 Kimlikleri ve Dönüşümler başlıklı makaleyi inceleyin.
  • conversionId: Çevrimdışı dönüşümlerde bu kimlik reklamverenler tarafından sağlanır. Reklamverenler, kendileri için anlamlı olan herhangi bir kimliği belirtebilir. Bir istekteki her dönüşüm benzersiz bir kimlik belirtmelidir ve kimlik ile zaman damgası kombinasyonu, reklamverendeki tüm dönüşümler arasında benzersiz olmalıdır. Search Ads 360, online dönüşümler için reklamverenin Floodlight talimatlarına bağlı olarak dsConversionId veya floodlightOrderId değerini bu mülke kopyalar.
  • conversionTimestamp: Dönüşümün gerçekleştiği tarih ve saati gösterir. Örneğin, dönüşüm 05 Ağustos 2016 Cuma günü 11:53:22 Doğu Yaz Saati'nde (GMT -4:00) gerçekleşirse zaman damgasını Epoch milisaniye cinsinden belirtin: 1470412402000.
  • segmentationType: Dönüşümü yüklediğiniz dönüşüm sisteminin türünü belirtir. Şu anda yalnızca Floodlight dönüşümleri desteklenmektedir. Bu nedenle, bu alanda her zaman FLOODLIGHT belirtilmesi gerekir.
  • segmentationName: Reklamverenin dönüşümü bildirmek için kullandığı Floodlight etkinliğinin adıdır.

    Reklamvereninizde aynı ada sahip etkinlikler varsa (bu durum, etkinlikler farklı Floodlight gruplarına aitse oluşabilir) etkinliklerden birini yeniden adlandırmanız önerilir.

    Alternatif olarak, Search Ads 360'ın bir Floodlight etkinliğine atadığı kimliği biliyorsanız, segmentationName alanında adı belirtmek yerine segmentationId alanında kimliği belirtebilirsiniz. (Campaign Manager, Floodlight etkinliğine de bir kimlik atar ancak Campaign Manager kimliği Search Ads 360 kimliğinden farklıdır ve dönüşümleri ilişkilendirmek için kullanılamaz.) Bir Floodlight etkinliğinin Search Ads 360 kimliğini görüntülemek için bir dönüşüm raporu indirin (Search Ads 360 kullanıcı arayüzünden veya raporlama API'sinden). Raporun zaman aralığı içinde Floodlight etkinliğiyle ilişkilendirilmiş en az bir dönüşüm varsa raporda Search Ads 360 kimliğini görürsünüz.

  • type: Dönüşüm türü, yani ACTION veya TRANSACTION. Bir İŞLEM dönüşümünün parasal değeri yoktur ancak bir İŞLEM dönüşümünün parasal değeri vardır. Örneğin, e-posta listesine kaydolma (İŞLEM) ile e-ticaret satın alma işlemleri (İŞLEM) karşılaştırılabilir.

    TRANSACTION öğesini belirtirseniz aşağıdaki alanı da belirtmeniz gerekir:

    • revenueMicros: Dönüşümün parasal değeri.

İsteğe bağlı alanlar

  • quantityMillis: Bu dönüşümdeki öğe sayısıdır. Örneğin, e-posta bültenine kaydolan kişi sayısı veya satılan öğelerin toplam miktarı. İŞLEM dönüşümleri için bu alanı belirtmezseniz Search Ads 360 otomatik olarak 1000 değerini ekler.
  • currencyCode: İşlem gelirinin para birimi. Varsayılan olarak, gelirin reklamverenin para biriminde olduğu varsayılır. Farklı bir para birimi belirtirseniz Search Ads 360, belirtilen gelir tutarını reklamverenin para birimine dönüştürür. Daha fazla bilgi
    Para birimini belirtmek için ISO 4217 alfabetik (3 karakterli) biçimini kullanın.
    Yalnızca İŞLEM dönüşümleri için geçerlidir.
  • customMetric ve customDimension: Satın alınan bir öğenin gönderildiği ülke, ürün kimlikleri veya telefon görüşmesinin süresi gibi bir dönüşümle ilgili ek veriler yükler. Özel Floodlight değişkenleri için veri yükleme hakkında daha fazla bilgi edinin.
  • deviceType: Dönüşümün gerçekleştiği cihazın türünü belirtir. Bu alan için kabul edilen değerlerin listesini inceleyin.

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"
  }]
}

Java

  /**
   * 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;
  }

Python

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())

Üçüncü taraf ilişkilendirme modelinden veri yükleme

İlişkilendirme modeli, dönüşümün kredisini dönüşüm yolundaki etkinliğin tamamına dağıtır. Örneğin bir tüketici, dönüşümden önce bir ücretli arama ağı reklamını, görüntülü reklamı ve başka bir ücretli arama ağı reklamını tıklarsa doğrusal ilişkilendirme modeli, her tıklamaya dönüşüm kredisinin% 33'ünü verir.

Search Ads 360 ilişkilendirme modelleri sağlar. Bununla birlikte, bir üçüncü taraf hizmetini veya krediyi tıklamalara dağıtmak için geliştirdiğiniz bir hizmeti kullanıyorsanız üçüncü taraf ilişkilendirme verilerini Search Ads 360'a yükleyebilir, ayrıca verileri raporlarda ve Search Ads 360 teklif stratejilerinde kullanabilirsiniz.

Başlamadan önce

Campaign Manager'da özel bir ilişkilendirme modeli oluşturun ve modeli Search Ads 360'a aktarın. Modele Harici İlişkilendirme Modeli adını verdiğinizden emin olun. Bu sayede, Search Ads 360 özellikleri, yüklediğiniz dönüşüm verilerine bir ilişkilendirme modelinin uygulandığını tanır. Daha fazla bilgi

Zorunlu alanlar

Bir dönüşüme üçüncü taraf ilişkilendirme modeli uygulamak için Conversion.insert() isteğinizde aşağıdakilerin tümünü belirtin:

  • clickId: Ziyaretin büyük/küçük harfe duyarlı tıklama kimliği. Tıklama kimliği veya liste dönüşümleri için reklamverenin web günlüklerine bakın ve başka bir dönüşümden tıklama kimliği kullanın. Search Ads 360, dönüşümü ziyareti oluşturmaktan sorumlu olan anahtar kelime, reklam ve diğer Search Ads 360 nesneleriyle ilişkilendirir.
    Search Ads 360, kimlik içeren bir dönüşümü yüklemeden önce tıklama kimliği oluşturduktan sonra en az 30 dakika bekleyin. Aksi takdirde, Search Ads 360 API ziyareti tanımayabilir.
  • attributionModel: Harici İlişkilendirme Modeli olarak ayarlayın. Daha fazla bilgi
  • countMillis: Bu tıklamaya dağıtılacak dönüşüm kredisi miktarıdır. Yalnızca istekte attributionModel alanı da varsa geçerlidir.

    Bu alanı, dönüşümdeki öğe sayısını (ör. alışveriş sepeti satın alma işlemindeki öğe sayısı) belirten isteğe bağlı bir alan olan quantityMillis ile karıştırmayın.

  • conversionId: Çevrimdışı dönüşümlerde bu kimlik reklamverenler tarafından sağlanır. Reklamverenler, kendileri için anlamlı olan herhangi bir kimliği belirtebilir. Bir istekteki her dönüşüm benzersiz bir kimlik belirtmelidir ve kimlik ile zaman damgası kombinasyonu, reklamverendeki tüm dönüşümler arasında benzersiz olmalıdır. Search Ads 360, online dönüşümler için reklamverenin Floodlight talimatlarına bağlı olarak dsConversionId veya floodlightOrderId değerini bu mülke kopyalar.
  • conversionTimestamp: Dönüşümün gerçekleştiği tarih ve saati gösterir. Örneğin, dönüşüm 05 Ağustos 2016 Cuma günü 11:53:22 Doğu Yaz Saati'nde (GMT -4:00) gerçekleşirse zaman damgasını Epoch milisaniye cinsinden belirtin: 1470412402000.
  • segmentationType: Dönüşümü yüklediğiniz dönüşüm sisteminin türünü belirtir. Şu anda yalnızca Floodlight dönüşümleri desteklenmektedir. Bu nedenle, bu alanda her zaman FLOODLIGHT belirtilmesi gerekir.
  • segmentationName: Reklamverenin dönüşümü bildirmek için kullandığı Floodlight etkinliğinin adıdır.

    Reklamvereninizde aynı ada sahip etkinlikler varsa (bu durum, etkinlikler farklı Floodlight gruplarına aitse oluşabilir) etkinliklerden birini yeniden adlandırmanız önerilir.

    Alternatif olarak, Search Ads 360'ın bir Floodlight etkinliğine atadığı kimliği biliyorsanız, segmentationName alanında adı belirtmek yerine segmentationId alanında kimliği belirtebilirsiniz. (Campaign Manager, Floodlight etkinliğine de bir kimlik atar ancak Campaign Manager kimliği Search Ads 360 kimliğinden farklıdır ve dönüşümleri ilişkilendirmek için kullanılamaz.) Bir Floodlight etkinliğinin Search Ads 360 kimliğini görüntülemek için bir dönüşüm raporu indirin (Search Ads 360 kullanıcı arayüzünden veya raporlama API'sinden). Raporun zaman aralığı içinde Floodlight etkinliğiyle ilişkilendirilmiş en az bir dönüşüm varsa raporda Search Ads 360 kimliğini görürsünüz.

  • type: Dönüşüm türü, yani ACTION veya TRANSACTION. Bir İŞLEM dönüşümünün parasal değeri yoktur ancak bir İŞLEM dönüşümünün parasal değeri vardır. Örneğin, e-posta listesine kaydolma (İŞLEM) ile e-ticaret satın alma işlemleri (İŞLEM) karşılaştırılabilir.

    TRANSACTION öğesini belirtirseniz aşağıdaki alanı da belirtmeniz gerekir:

    • revenueMicros: Dönüşümün parasal değeri.

Dönüşüm gelirini izlerseniz modelinizin geliri bir dönüşüm yolundaki her temas noktasına dağıttığından emin olun. Örneğin, modeliniz doğrusal bir yaklaşım kullanıyorsa (geliri her temas noktasına eşit olarak dağıtıyorsa), 3 reklam tıklaması içeren bir dönüşüm yolunda her tıklama, dönüşümün% 33'üyle ilişkilendirilir. Dönüşümle 100 ABD doları gelir elde edildiyse, modelinizin her tıklamaya gelirin 33 ABD dolarını dağıttığından ve revenueMicros parametresinin her tıklama için yalnızca gelirin 33 ABD dolarını belirttiğinden emin olun.

İsteğe bağlı alanlar

  • quantityMillis: Bu dönüşümdeki öğe sayısıdır. Örneğin, e-posta bültenine kaydolan kişi sayısı veya satılan öğelerin toplam miktarı. İŞLEM dönüşümleri için bu alanı belirtmezseniz Search Ads 360 otomatik olarak 1000 değerini ekler.
  • currencyCode: İşlem gelirinin para birimi. Varsayılan olarak, gelirin reklamverenin para biriminde olduğu varsayılır. Farklı bir para birimi belirtirseniz Search Ads 360, belirtilen gelir tutarını reklamverenin para birimine dönüştürür. Daha fazla bilgi
    Para birimini belirtmek için ISO 4217 alfabetik (3 karakterli) biçimini kullanın.
    Yalnızca İŞLEM dönüşümleri için geçerlidir.
  • customMetric ve customDimension: Satın alınan bir öğenin gönderildiği ülke, ürün kimlikleri veya telefon görüşmesinin süresi gibi bir dönüşümle ilgili ek veriler yükler. Özel Floodlight değişkenleri için veri yükleme hakkında daha fazla bilgi edinin.
  • deviceType: Dönüşümün gerçekleştiği cihazın türünü belirtir. Bu alan için kabul edilen değerlerin listesini inceleyin.

Örnek

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 yanıtlarını işleme

Search Ads 360'tan gelen yanıt, yalnızca istekteki tüm dönüşümler başarıyla doğrulanıp yüklendiyse başarılı olduğunu gösterir.

İstek başarılı olursa

İstek başarılı olursa yanıt, yüklenen her dönüşüm için kampanyanın kimliği, reklam grubunun kimliği ve anahtar kelimenin (ölçüt) kimliği gibi tam Search Ads 360 dahili gösterimini içerir.

{
 "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"
  },
  ...
 ]
}

İstek başarılı olmazsa

Bir veya daha fazla dönüşümün doğrulanması ya da yüklenmesi başarısız olursa yanıtta, başarısız olan her dönüşüm yüklemesi için mesajlar yer alır. Yanıt, başarıyla yüklenen dönüşümlerle ilgili mesajlar içermiyor.

Tam olarak başarılı olmayan bir isteğe verilen yanıtın örneğini aşağıda bulabilirsiniz:

{
 "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 ..."
       }
    ]
  }
}

Her hata mesajı iki önemli alan içerir: neden ve ayrıntılı hata mesajı. Neden alanında requestValidation, internalError, transactionFailed veya lateStageRequestError bulunabilir.

requestValidation hataları

requestValidation hataları, dönüşüm yükleme isteğindeki veri sorunlarını (ör. dönüşümün zaten yüklenmiş olması veya tıklama kimliğinin bulunamaması) gösterir. Bu tür bir hatada, mesaj ayrıntıları iki öğe içerir:

  • Hata türünü tanımlayan onaltılık kod. Hataları belirlemek için kodu kendi komut dosyalarınızda kullanabilirsiniz.
  • Doğrulama hatasının açıklaması.

Daha fazla bilgi için Search Ads 360'ın dönüşüm yükleme hataları için döndürebileceği kod ve açıklamaların listesine bakın.

Diğer hata türleri

Diğer tüm hata türleri (internalError, transactionFailed veya lateStageRequestError), Search Ads 360'ta dahili bir sorun olduğunu gösterir.

Hataya yanıt verme

İstek başarısız olursa daha sonra tüm istek çağrısını yeniden göndermeyi deneyin. Search Ads 360, daha önce yüklenen dönüşümler için requestValidation hatalarını bildirir ancak kalan dönüşümleri yüklemeye çalışır.

Yeniden gönderdikten sonra hataları görmeye devam ederseniz nasıl devam edeceğinizle ilgili bilgi için sorun giderme bölümüne bakın.