Yeni Dönüşüm Ekle

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üşümlerle ilgili tüm zaman damgalarını sıfır zaman (Unix saati olarak da bilinir) biçimine dönüştürür.

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. Bir Floodlight etkinliğinin esas olarak çevrimdışı dönüşümler için kullanıldığını belirtmek amacıyla API'yi kullanamazsınız. Teklif stratejileri dönüşümdeki verileri kullanacaksa bu 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, 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 oluşturmaz. 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 birini yapmak için Conversion.insert() isteği gönderebilirsiniz:

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

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üşümle ilişkilendirebileceğiniz her etkinlik veya öğe için gerekli ve isteğe bağlı alanlar listelenmektedir.

Dönüşümleri 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ü ziyaretle ilişkilendirmek için Conversion.insert() isteknizde aşağıdakileri belirtin:

Zorunlu alanlar

• clickId: Ziyaretin büyük/küçük harfe duyarlı tıklama kimliği. Tıklama kimliği için reklamverenin web günlüklerine bakın veya dönüşümleri listeleyin ve başka bir dönüşümdeki tıklama kimliğini kullanın. Search Ads 360, dönüşümü anahtar kelimeyle, reklamla ve ziyaretin oluşturulmasından sorumlu diğer Search Ads 360 nesneleriyle ilişkilendirir.
  Search Ads 360'ın dönüşümleri yüklemek için bir tıklama kimliği oluşturmasından 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 90 gün içinde yüklenmelidir. Aksi takdirde Search Ads 360 API, ziyareti tanımayabilir.
• conversionId: Çevrimdışı dönüşümler için reklamverenler bu kimliği sağlar. Reklamverenler, kendileri için anlamlı olan herhangi bir kimliği belirtebilir. Bir istekteki her dönüşüm için benzersiz bir kimlik belirtilmelidir ve kimlik ile zaman damgasının kombinasyonu, reklamverendeki tüm dönüşümler arasında benzersiz olmalıdır. Search Ads 360, çevrimiçi 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 belirtir. Örneğin, dönüşüm 5 Ağustos 2016 Cuma günü 11:53:22 Doğu Yaz Saati (GMT -4:00) tarihinde 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, FLOODLIGHT değerini belirtmek için bu alanın her zaman doldurulması 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 ortaya çıkabilir) 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 en az bir dönüşüm ilişkilendirildiyse raporda Search Ads 360 kimliğini görürsünüz.

• type: Dönüşümün türü (ACTION veya TRANSACTION). İŞLEM dönüşümünün parasal değeri vardır ancak İŞLEM dönüşümünün parasal değeri yoktur. E-posta listesi kayıtları (İŞLEM) ve e-ticaret satın alma işlemleri (İŞLEM) buna örnek gösterilebilir.

  TRANSACTION değerini belirtirseniz aşağıdaki alanı da belirtmeniz gerekir:

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

İsteğe bağlı alanlar

• quantityMillis: Bu dönüşümdeki öğe sayısı. Örneğin, e-posta bültenine kaydolan kullanıcı sayısı veya satılan toplam ürün miktarı. EYLEM dönüşümleri için bu alanı belirtmezseniz Search Ads 360 otomatik olarak 1000 değerini ekler.
• currencyCode: İşlemin gelirinin para birimidir. 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 ürünün gönderildiği ülke, ürün kimlikleri ve hatta bir telefon aramasının süresi gibi 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 listesine bakın.

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

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

Anahtar amacınız dönüşümleri anahtar kelimelerle ilişkilendirmekse 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ı diğer 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 elde edebilirsiniz. Anahtar kelime kimliklerini alma hakkında bilgi edinmek için Search Ads 360 kimlikleri ve dönüşümler başlıklı makaleyi inceleyin.
• conversionId: Çevrimdışı dönüşümler için reklamverenler bu kimliği sağlar. Reklamverenler, kendileri için anlamlı olan herhangi bir kimliği belirtebilir. Bir istekteki her dönüşüm için benzersiz bir kimlik belirtilmelidir ve kimlik ile zaman damgasının kombinasyonu, reklamverendeki tüm dönüşümler arasında benzersiz olmalıdır. Search Ads 360, çevrimiçi 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 belirtir. Örneğin, dönüşüm 5 Ağustos 2016 Cuma günü 11:53:22 Doğu Yaz Saati (GMT -4:00) tarihinde 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, FLOODLIGHT değerini belirtmek için bu alanın her zaman doldurulması gerekir.
• segmentationName: Reklamverenin dönüşümü bildirmek için kullandığı Floodlight etkinliğinin adıdır.

  Reklamvereniniz aynı ada sahip etkinlikler içeriyorsa (bu durum etkinlikler farklı Floodlight gruplarına aitse ortaya çıkabilir) önerilen işlem etkinliklerden birini yeniden adlandırmaktır.

  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 en az bir dönüşüm ilişkilendirildiyse raporda Search Ads 360 kimliğini görürsünüz.

• type: Dönüşümün türü (ACTION veya TRANSACTION). İŞLEM dönüşümünün parasal değeri vardır ancak İŞLEM dönüşümünün parasal değeri yoktur. E-posta listesi kayıtları (İŞLEM) ve e-ticaret satın alma işlemleri (İŞLEM) buna örnek gösterilebilir.

  TRANSACTION değerini belirtirseniz aşağıdaki alanı da belirtmeniz gerekir:

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

İsteğe bağlı alanlar

• quantityMillis: Bu dönüşümdeki öğe sayısı. Örneğin, e-posta bültenine kaydolan kullanıcı sayısı veya satılan toplam ürün miktarı. EYLEM dönüşümleri için bu alanı belirtmezseniz Search Ads 360 otomatik olarak 1000 değerini ekler.
• currencyCode: İşlemin gelirinin para birimidir. 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 ürünün gönderildiği ülke, ürün kimlikleri ve hatta bir telefon aramasının süresi gibi 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 listesine bakın.

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

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

requestValidation hataları

requestValidation hataları, dönüşüm yükleme isteğinde veri sorunlarının olduğunu gösterir (ör. dönüşüm zaten yüklendi veya clickId bulunamadı). Bu tür hatalarda ayrıntılar mesajı iki öğe içerir:

• Hata türünü tanımlayan on altılık kod. Hataları tespit etmek için bu 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 kodların 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.

Hatalara yanıt verme

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

Yeniden gönderdikten sonra hâlâ hata görüyorsanız nasıl devam edeceğinizle ilgili bilgi için sorun giderme bölümünü inceleyin.