Tambahkan Konversi Baru

Seberapa cepat saya dapat menggunakan data yang diupload?

Jika Anda menentukan conversionTimestamp hari ini atau kemarin untuk konversi, metrik untuk konversi tersebut akan muncul di UI Search Ads 360 dalam waktu satu jam setelah diupload. Jika Anda menentukan conversionTimestamp yang lebih lama dari kemarin, metrik akan diperbarui dalam beberapa jam.

Mengonversi semua stempel waktu untuk konversi menjadi Waktu epoch (juga dikenal sebagai waktu Unix).

Dapatkah saya membuat aktivitas Floodlight dari API?

Jika pengiklan belum membuat aktivitas Floodlight untuk melacak konversi offline, Anda dapat menggunakan Campaign Manager API untuk membuatnya. Anda tidak dapat menggunakan API untuk menentukan bahwa aktivitas Floodlight digunakan terutama untuk konversi offline, yang merupakan praktik terbaik saat strategi bidding akan menggunakan data dari konversi.

Sebaiknya setelah Anda menggunakan API untuk membuat aktivitas Floodlight, pengguna Search Ads 360 login ke Search Ads 360 dan mengubah setelan aktivitas untuk menunjukkan bahwa sumber utama konversi adalah aktivitas offline.

Praktik terbaik untuk menambahkan konversi

Kami merekomendasikan praktik terbaik berikut untuk menambahkan konversi:

1. Minta pengguna Search Ads 360 untuk login ke Search Ads 360 dan mengubah setelan untuk setiap aktivitas Floodlight yang Anda gunakan untuk melaporkan konversi offline. Setelan harus menunjukkan bahwa sumber utama konversi adalah aktivitas offline. Lihat pusat bantuan Search Ads 360 untuk mengetahui petunjuknya.

2. Upload konversi segera setelah tersedia. Jika Anda mengatribusikan konversi ke kunjungan tertentu, tunggu minimal 6 jam setelah kunjungan sebelum mengupload konversi. Search Ads 360 mungkin tidak mengenali clickID kunjungan jika Anda mengupload lebih cepat dari 6 jam setelah kunjungan. Dalam kasus yang jarang terjadi, Anda mungkin perlu menunggu hingga 24 jam sebelum Search Ads 360 dapat mengenali clickId.

   Pastikan setiap upload berisi konversi terbaru. Dalam satu permintaan upload, tidak masalah jika entri tidak sesuai urutan kronologis. Namun, strategi bidding mungkin tidak dapat mempertimbangkan konversi lama yang Anda upload nanti dalam permintaan yang berbeda.

Mengirim permintaan penyisipan

Anda dapat mengirim permintaan Conversion.insert() untuk melakukan salah satu hal berikut:

• Mengatribusikan konversi ke kunjungan tertentu
• Mengatribusikan konversi hanya ke kata kunci

Kolom yang diperlukan dalam permintaan Conversion.insert() bergantung pada peristiwa atau item yang Anda atribusikan konversinya. Bagian berikut mencantumkan kolom wajib dan opsional untuk setiap peristiwa atau item yang dapat Anda atribusikan konversi.

Mengatribusikan konversi ke kunjungan tertentu

Saat pelanggan mengklik satu atau beberapa iklan dan diarahkan ke situs pengiklan, Search Ads 360 menganggap sesi pengguna di situs pengiklan sebagai kunjungan. Untuk mengatribusikan konversi ke kunjungan, tentukan hal berikut dalam permintaan Conversion.insert() Anda:

Kolom wajib diisi

• clickId: ID klik kunjungan yang peka huruf besar/kecil. Lihat log web pengiklan untuk menemukan ID klik atau daftar konversi dan gunakan ID klik dari konversi lain. Search Ads 360 akan mengatribusikan konversi ke kata kunci, iklan, dan objek Search Ads 360 lainnya yang bertanggung jawab untuk menghasilkan kunjungan.
  Tunggu minimal 6 jam setelah Search Ads 360 membuat ID klik untuk mengupload konversi. Jika Anda menerima error "ID Klik tidak ditemukan", tunggu 24 jam, lalu upload konversi lagi. Semua konversi harus diupload dalam waktu 90 hari sejak ID klik dibuat. Jika tidak, Search Ads 360 API mungkin tidak mengenali kunjungan tersebut.
• conversionId: Untuk konversi offline, pengiklan memberikan ID ini. Pengiklan dapat menentukan ID apa pun yang berarti bagi mereka. Setiap konversi dalam permintaan harus menentukan ID unik, dan kombinasi ID dan stempel waktu harus unik di antara semua konversi dalam pengiklan. Untuk konversi online, Search Ads 360 menyalin dsConversionId atau floodlightOrderId ke properti ini, bergantung pada petunjuk Floodlight pengiklan.
• conversionTimestamp: Menunjukkan tanggal dan waktu terjadinya konversi. Misalnya, jika konversi terjadi pada Jum, 05 Agustus 2016 pukul 11.53.22 Waktu Musim Panas Timur (GMT -4.00), tentukan stempel waktu dalam milidetik Epoch: 1470412402000.
• segmentationType: Menentukan jenis sistem konversi tempat Anda mengupload konversi. Saat ini, hanya konversi Floodlight yang didukung, sehingga kolom ini selalu diperlukan untuk menentukan FLOODLIGHT.
• segmentationName: Nama aktivitas Floodlight yang digunakan pengiklan untuk melaporkan konversi.

  Jika pengiklan Anda berisi aktivitas dengan nama yang sama (hal ini dapat terjadi jika aktivitas termasuk dalam grup Floodlight yang berbeda), tindakan yang direkomendasikan adalah mengganti nama salah satu aktivitas.

  Atau, jika Anda mengetahui ID yang ditetapkan Search Ads 360 ke aktivitas Floodlight, Anda dapat menentukan ID di segmentationId, bukan menentukan nama di kolom segmentationName. (Campaign Manager juga menetapkan ID ke aktivitas Floodlight, tetapi ID Campaign Manager berbeda dengan ID Search Ads 360 dan tidak dapat digunakan untuk mengatribusikan konversi.) Untuk melihat ID Search Ads 360 untuk aktivitas Floodlight, download laporan konversi (dari UI Search Ads 360 atau reporting API). Jika setidaknya satu konversi telah diatribusikan ke aktivitas Floodlight selama jangka waktu laporan, Anda akan melihat ID Search Ads 360 dalam laporan.

• type: Jenis konversi, yaitu ACTION atau TRANSACTION. Konversi TINDAKAN tidak memiliki nilai uang, sedangkan konversi TRANSAKSI memiliki nilai uang. Contohnya adalah pendaftaran daftar email (TINDAKAN) versus pembelian e-commerce (TRANSAKSI).

  Jika menentukan TRANSACTION, Anda juga perlu menentukan kolom berikut:

  • revenueMicros: Nilai uang konversi.

Kolom opsional

• quantityMillis: Jumlah item dalam konversi ini. Misalnya, jumlah orang yang mendaftar newsletter email atau jumlah total item yang terjual. Jika Anda tidak menentukan kolom ini untuk konversi TINDAKAN, Search Ads 360 akan otomatis menyisipkan nilai 1000.
• currencyCode: Mata uang pendapatan transaksi. Secara default, pendapatan diasumsikan dalam mata uang pengiklan. Jika Anda menentukan mata uang yang berbeda, Search Ads 360 akan mengonversi jumlah pendapatan yang ditentukan ke mata uang pengiklan. Pelajari lebih lanjut
  Gunakan format alfabet (3 karakter) ISO 4217 untuk menentukan mata uang.
  Hanya berlaku untuk konversi TRANSAKSI.
• customMetric dan customDimension: Mengupload data tambahan tentang konversi, seperti negara tujuan pengiriman item yang dibeli, ID produk, atau bahkan durasi panggilan telepon. Pelajari lebih lanjut cara mengupload data untuk variabel Floodlight kustom.
• deviceType: Menentukan jenis perangkat tempat konversi terjadi. Lihat daftar nilai yang diterima untuk kolom ini.

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

Mengatribusikan konversi hanya ke kata kunci

Jika perhatian utama Anda adalah mengatribusikan konversi ke kata kunci—dan Anda tidak khawatir tentang atribusi ke iklan—Anda dapat menghapus sebagian besar ID Search Ads 360 dan hanya menentukan ID kata kunci beserta beberapa kolom lainnya:

Kolom wajib diisi

• criterionId: Ini adalah ID kata kunci. Anda bisa mendapatkan criterionId dengan menambahkan makro TrackerId ke URL halaman landing. Untuk informasi tentang cara mendapatkan ID kata kunci, lihat ID dan Konversi Search Ads 360.
• conversionId: Untuk konversi offline, pengiklan memberikan ID ini. Pengiklan dapat menentukan ID apa pun yang berarti bagi mereka. Setiap konversi dalam permintaan harus menentukan ID unik, dan kombinasi ID dan stempel waktu harus unik di antara semua konversi dalam pengiklan. Untuk konversi online, Search Ads 360 menyalin dsConversionId atau floodlightOrderId ke properti ini, bergantung pada petunjuk Floodlight pengiklan.
• conversionTimestamp: Menunjukkan tanggal dan waktu terjadinya konversi. Misalnya, jika konversi terjadi pada Jum, 05 Agustus 2016 pukul 11.53.22 Waktu Musim Panas Timur (GMT -4.00), tentukan stempel waktu dalam milidetik Epoch: 1470412402000.
• segmentationType: Menentukan jenis sistem konversi tempat Anda mengupload konversi. Saat ini, hanya konversi Floodlight yang didukung, sehingga kolom ini selalu diperlukan untuk menentukan FLOODLIGHT.
• segmentationName: Nama aktivitas Floodlight yang digunakan pengiklan untuk melaporkan konversi.

  Jika pengiklan Anda berisi aktivitas dengan nama yang sama (hal ini dapat terjadi jika aktivitas termasuk dalam grup Floodlight yang berbeda), tindakan yang direkomendasikan adalah mengganti nama salah satu aktivitas.

  Atau, jika Anda mengetahui ID yang ditetapkan Search Ads 360 ke aktivitas Floodlight, Anda dapat menentukan ID di segmentationId, bukan menentukan nama di kolom segmentationName. (Campaign Manager juga menetapkan ID ke aktivitas Floodlight, tetapi ID Campaign Manager berbeda dengan ID Search Ads 360 dan tidak dapat digunakan untuk mengatribusikan konversi.) Untuk melihat ID Search Ads 360 untuk aktivitas Floodlight, download laporan konversi (dari UI Search Ads 360 atau reporting API). Jika setidaknya satu konversi telah diatribusikan ke aktivitas Floodlight selama jangka waktu laporan, Anda akan melihat ID Search Ads 360 dalam laporan.

• type: Jenis konversi, yaitu ACTION atau TRANSACTION. Konversi TINDAKAN tidak memiliki nilai uang, sedangkan konversi TRANSAKSI memiliki nilai uang. Contohnya adalah pendaftaran daftar email (TINDAKAN) versus pembelian e-commerce (TRANSAKSI).

  Jika menentukan TRANSACTION, Anda juga perlu menentukan kolom berikut:

  • revenueMicros: Nilai uang konversi.

Kolom opsional

• quantityMillis: Jumlah item dalam konversi ini. Misalnya, jumlah orang yang mendaftar newsletter email atau jumlah total item yang terjual. Jika Anda tidak menentukan kolom ini untuk konversi TINDAKAN, Search Ads 360 akan otomatis menyisipkan nilai 1000.
• currencyCode: Mata uang pendapatan transaksi. Secara default, pendapatan diasumsikan dalam mata uang pengiklan. Jika Anda menentukan mata uang yang berbeda, Search Ads 360 akan mengonversi jumlah pendapatan yang ditentukan ke mata uang pengiklan. Pelajari lebih lanjut
  Gunakan format alfabet (3 karakter) ISO 4217 untuk menentukan mata uang.
  Hanya berlaku untuk konversi TRANSAKSI.
• customMetric dan customDimension: Mengupload data tambahan tentang konversi, seperti negara tujuan pengiriman item yang dibeli, ID produk, atau bahkan durasi panggilan telepon. Pelajari lebih lanjut cara mengupload data untuk variabel Floodlight kustom.
• deviceType: Menentukan jenis perangkat tempat konversi terjadi. Lihat daftar nilai yang diterima untuk kolom ini.

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

Contoh

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

error requestValidation

Error requestValidation menunjukkan masalah data dalam permintaan upload konversi (misalnya, konversi telah diupload, atau clickId tidak ditemukan). Pada jenis error ini, detail pesan berisi dua item:

• Kode heksadesimal yang mengidentifikasi jenis error. Anda dapat menggunakan kode dalam skrip Anda sendiri untuk mengidentifikasi error.
• Deskripsi error validasi.

Untuk informasi selengkapnya, lihat daftar kode dan deskripsi yang dapat ditampilkan Search Ads 360 untuk error upload konversi.

Jenis error lainnya

Semua jenis error lainnya (internalError, transactionFailed, atau lateStageRequestError) menunjukkan bahwa ada masalah internal di Search Ads 360.

Merespons error

Jika permintaan gagal, coba kirim ulang seluruh panggilan permintaan nanti. Search Ads 360 akan melaporkan error requestValidation untuk konversi apa pun yang telah diupload, tetapi akan mencoba mengupload konversi yang tersisa.

Jika Anda masih melihat error setelah mengirim ulang, lihat bagian pemecahan masalah untuk mendapatkan informasi tentang cara melanjutkan.