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üşümle ilgili metrikler, yüklemeden sonraki bir saat içinde Search Ads 360 kullanıcı arayüzünde gösterilir. Dünden daha eski bir conversionTimestamp belirtirseniz metrikler birkaç saat içinde güncellenir.

Dönüşümlerin tüm zaman damgalarını Dönem zamanı'na (Unix saati 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 bir etkinlik oluşturmak için Campaign Manager API'sini kullanabilirsiniz. Bir Floodlight etkinliğinin öncelikli olarak çevrimdışı dönüşümler için kullanıldığını belirtmek amacıyla API'yi kullanamazsınız. Bu, teklif stratejilerinin dönüşümden elde edilen verileri kullanacağı en iyi uygulamalardan biridir.

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

Dönüşüm eklemeye yönelik en iyi uygulamalar

Dönüşüm eklemek için aşağıdaki en iyi uygulamaları öneririz:

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

2. Dönüşümleri kullanılabilir olur olmaz yükleyin. Dönüşümleri belirli ziyaretlerle ilişkilendiriyorsanız dönüşümü yüklemeden önce ziyaretin üzerinden en az 30 dakika geçmesini bekleyin. Search Ads 360, ziyaretin üzerinden 30 dakika geçmeden yükleme yaparsanız ziyaretin tıklama kimliğini tanımayabilir. Nadir durumlarda, Search Ads 360'ın clickId değerini tanıması için 4 saate kadar beklemeniz gerekebilir.

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

3. Bir Floodlight etkinliği için dönüşümleri yüklemeden önce 24 saatten fazla beklerseniz bir müsaitlik durumu zaman damgası gönderin.

   Kullanılabilirlik zaman damgası aşağıdakilerden biri olmalıdır:

   • Son 24 saat içinde dönüşüm kaydettiyseniz ancak henüz yüklemediyseniz zaman damgası, en son yüklenen dönüşümün gerçekleştiği zaman olmalıdır. Bu, Search Ads 360'a son 24 saat içinde dönüşümlerin gerçekleşmiş olabileceğini ancak henüz veri sağlamadığınızı bildirir. Teklif stratejileri ve diğer otomatik sistemler, performans geçmişini yalnızca yüklediğiniz son dönüşüme kadar değerlendirir.
   • Son 24 saat içinde herhangi bir dönüşüm gerçekleşmediyse zaman damgası, geçerli saat ve tarih olmalıdır. Bu değer, Search Ads 360'a son 24 saat içinde hiçbir dönüşüm gerçekleşmediğini bildirir. Teklif stratejileri ve diğer otomatik sistemler, performans geçmişi kapsamında son 24 saati (dönüşüm olmadan geçen bir gün) içerir.

Ekleme isteği gönder

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

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

Conversion.insert() isteğinde gerekli 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 öğeye ait zorunlu ve isteğe bağlı alanlar listelenmiştir.

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ü bir ziyaretle ilişkilendirmek 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 için reklamverenin web günlüklerine bakın veya dönüşümleri listeleyin ve başka bir dönüşüme ait tıklama kimliğini kullanın. Search Ads 360 bu dönüşümü; anahtar kelime, reklam ve ziyaretin oluşturulmasından sorumlu olan diğer Search Ads 360 nesneleriyle ilişkilendirir.
  Search Ads 360, dönüşümleri yüklemek için tıklama kimliği oluşturduktan sonra en az 30 dakika bekleyin. "Tıklama kimliği bulunamadı" hatası alırsanız 4 saat bekleyip dönüşümleri yeniden yükleyin. Tüm dönüşümler, tıklama kimliği oluşturulduktan sonraki 90 gün içinde yüklenmelidir. Aksi takdirde, Search Ads 360 API ziyareti tanımayabilir.
• conversionId: Reklamverenler, çevrimdışı dönüşümler için bu kimliği sağlar. 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, reklamveren içindeki tüm dönüşümler arasında benzersiz olmalıdır. Online dönüşümlerde Search Ads 360, reklamverenin Floodlight talimatlarına bağlı olarak dsConversionId veya floodlightOrderId değerlerini 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) saatinde gerçekleşirse zaman damgasını Zaman damgasını (Dönem) 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. Dolayısıyla bu alan, FLOODLIGHT değerini belirtmek için her zaman gereklidir.
• segmentationName: Reklamverenin dönüşümü bildirmek için kullandığı Floodlight etkinliğinin adı.

  Reklamvereniniz aynı ada sahip etkinlikler içeriyorsa (etkinlikler farklı Floodlight gruplarına aitse bu durum gerçekleşebilir) önerilen işlem, etkinliklerden birinin yeniden adlandırılmasıdır.

  Alternatif olarak, Search Ads 360'ın bir Floodlight etkinliğine atadığı kimliği biliyorsanız, segmentationName alanında adı belirtmek yerine kimliği segmentationId içinde belirtebilirsiniz. (Campaign Manager ayrıca Floodlight etkinliğine 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 dönüşüm raporu indirin (Search Ads 360 kullanıcı arayüzünden veya Reporting API'sinden). Raporun zaman aralığı boyunca Floodlight etkinliğiyle en az bir dönüşüm ilişkilendirildiyse Search Ads 360 kimliğini raporda görürsünüz.

• type: Dönüşümün türüdür (yani ACTION veya TRANSACTION). ACTION dönüşümlerinin parasal değeri yoktur, ancak TRANSACTION dönüşümlerinin parasal değeri yoktur. E-posta listesi kayıtları (ACTION) ve e-ticaret satın alma işlemleri (TRANSACTION) örnek olarak verilebilir.

  TRANSACTION değerini 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ı. Örneğin, e-posta bültenine kaydolan kişi sayısı veya satılan toplam ürün miktarı. ACTION dönüşümleri için bu alanı belirtmezseniz Search Ads 360, otomatik olarak 1000 değerini ekler.
• currencyCode: Bir işlemin gelirinin para birimidir. Gelirin, varsayılan olarak 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 TRANSACTION dönüşümleri için geçerlidir.
• customMetric ve customDimension: Bir dönüşümle ilgili ek veriler (ör. satın alınan öğenin gönderildiği ülke, ürün kimlikleri ve hatta bir telefon aramasının süresi) yükler. Özel Floodlight değişkenlerine ilişkin verileri 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üşümü yalnızca bir anahtar kelimeyle ilişkilendirme

Asıl endişeniz dönüşümleri anahtar kelimelerle ilişkilendirmekse ve reklamlarla ilişkilendirme sizin için önemli değilse 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 makrosu ekleyerek criterionId değerini alabilirsiniz. Anahtar kelime kimliklerini alma hakkında bilgi için Search Ads 360 Kimlikleri ve Dönüşümleri konusuna bakın.
• conversionId: Reklamverenler, çevrimdışı dönüşümler için bu kimliği sağlar. 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, reklamveren içindeki tüm dönüşümler arasında benzersiz olmalıdır. Online dönüşümlerde Search Ads 360, reklamverenin Floodlight talimatlarına bağlı olarak dsConversionId veya floodlightOrderId değerlerini 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) saatinde gerçekleşirse zaman damgasını Zaman damgasını (Dönem) 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. Dolayısıyla bu alan, FLOODLIGHT değerini belirtmek için her zaman gereklidir.
• segmentationName: Reklamverenin dönüşümü bildirmek için kullandığı Floodlight etkinliğinin adı.

  Reklamvereniniz aynı ada sahip etkinlikler içeriyorsa (etkinlikler farklı Floodlight gruplarına aitse bu durum gerçekleşebilir) önerilen işlem, etkinliklerden birinin yeniden adlandırılmasıdır.

  Alternatif olarak, Search Ads 360'ın bir Floodlight etkinliğine atadığı kimliği biliyorsanız, segmentationName alanında adı belirtmek yerine kimliği segmentationId içinde belirtebilirsiniz. (Campaign Manager ayrıca Floodlight etkinliğine 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 dönüşüm raporu indirin (Search Ads 360 kullanıcı arayüzünden veya Reporting API'sinden). Raporun zaman aralığı boyunca Floodlight etkinliğiyle en az bir dönüşüm ilişkilendirildiyse Search Ads 360 kimliğini raporda görürsünüz.

• type: Dönüşümün türüdür (yani ACTION veya TRANSACTION). ACTION dönüşümlerinin parasal değeri yoktur, ancak TRANSACTION dönüşümlerinin parasal değeri yoktur. E-posta listesi kayıtları (ACTION) ve e-ticaret satın alma işlemleri (TRANSACTION) örnek olarak verilebilir.

  TRANSACTION değerini 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ı. Örneğin, e-posta bültenine kaydolan kişi sayısı veya satılan toplam ürün miktarı. ACTION dönüşümleri için bu alanı belirtmezseniz Search Ads 360, otomatik olarak 1000 değerini ekler.
• currencyCode: Bir işlemin gelirinin para birimidir. Gelirin, varsayılan olarak 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 TRANSACTION dönüşümleri için geçerlidir.
• customMetric ve customDimension: Bir dönüşümle ilgili ek veriler (ör. satın alınan öğenin gönderildiği ülke, ürün kimlikleri ve hatta bir telefon aramasının süresi) yükler. Özel Floodlight değişkenlerine ilişkin verileri 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ğindeki veri sorunlarını belirtir (ör. dönüşüm zaten yüklenmiş veya clickId bulunamadı). Bu tür bir hatada, ayrıntılar mesajı iki öğe içerir:

• Hatanın türünü tanımlayan bir onaltılık kod. Hataları tanımlamak için kendi komut dosyalarınızdaki kodu 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 ve açıklamalar 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.

Bir hataya 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, önceden yüklenmiş olan tüm dönüşümler için requestValidation hatalarını bildirir, ancak kalan dönüşümleri yüklemeye çalışır.

Yeniden gönderdikten sonra hatalarla karşılaşmaya devam ederseniz nasıl devam edeceğinizle ilgili bilgi için sorun giderme bölümüne göz atın.