Tambahkan Konversi Baru

Seberapa cepat saya dapat menggunakan data yang diupload?

Jika Anda menentukan conversionTimestamp hari ini atau kemarin untuk konversi, metrik untuk konversi 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 di beberapa jam.

Mengonversi semua stempel waktu untuk konversi ke Epoch time (juga dikenal sebagai waktu Unix).

Dapatkah saya membuat aktivitas Floodlight dari API?

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

Sebaiknya setelah Anda menggunakan API untuk membuat Floodlight aktivitas, pengguna Search Ads 360 login ke Search Ads 360 dan mengubah setelan 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 setelannya untuk setiap aktivitas Floodlight yang Anda gunakan untuk melaporkan konversi offline. Setelan ini harus menunjukkan bahwa sumber utama konversi adalah aktivitas offline. Lihat Pusat bantuan Search Ads 360 untuk melihat petunjuk.

2. Upload konversi segera setelah tersedia. Jika Anda mengatribusikan konversi ke kunjungan spesifik, tunggu setidaknya 30 menit setelah kunjungan sebelum Anda mengupload konversi. Search Ads 360 mungkin tidak mengenali clickID kunjungan jika yang Anda upload lebih cepat dari 30 menit setelah kunjungan. Dalam kasus yang jarang terjadi, Anda mungkin perlu tunggu hingga 4 jam sebelum Search Ads 360 dapat mengenali clickId.

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

3. Jika Anda menunggu lebih dari 24 jam sebelum mengupload konversi untuk aktivitas Floodlight, kirim stempel waktu ketersediaan.

   Stempel waktu ketersediaan harus berupa salah satu dari berikut ini:

   • Jika Anda telah mencatat konversi selama 24 jam terakhir, tetapi belum menguploadnya namun, stempel waktu yang harus ditetapkan adalah waktu konversi yang terakhir diupload terjadi. Tindakan ini akan memberi tahu Search Ads 360 bahwa konversi mungkin telah terjadi selama 24 jam terakhir, namun Anda belum memberikan datanya. Strategi bidding dan sistem otomatis lainnya akan mempertimbangkan riwayat kinerja hingga terakhir konversi yang diupload.
   • Jika tidak ada konversi yang terjadi selama 24 jam terakhir, stempel waktunya harus berupa waktu dan tanggal saat ini. Ini memberi tahu Search Ads 360 bahwa tidak konversi terjadi selama 24 jam terakhir. Strategi bidding dan strategi bidding otomatis lainnya sistem akan mencakup 24 jam terakhir—sehari penuh tanpa konversi—seperti bagian dari histori performa.

Kirim 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 wajib diisi dalam permintaan Conversion.insert() bergantung pada peristiwa atau item atribusi konversi yang Anda kaitkan. Bagian berikut mencantumkan hal-hal yang diperlukan dan kolom opsional untuk setiap peristiwa atau item yang dapat menjadi atribut atribusi konversi.

Mengatribusikan konversi ke kunjungan tertentu

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

Kolom wajib diisi

• clickId: ID klik yang peka huruf besar/kecil pada kunjungan. Lihat di log web pengiklan untuk ID klik atau konversi daftar, lalu 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 menghasilkan kunjungan.
  Tunggu setidaknya 30 menit setelahnya Search Ads 360 akan membuat ID klik untuk mengupload konversi. Jika Anda menerima pesan "ID klik tidak ditemukan" error, tunggu 4 jam, lalu unggah konversi. Semua konversi harus diupload dalam waktu 90 hari sejak saat ID klik akan 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 bermakna bagi mereka. Setiap konversi dalam permintaan harus menentukan ID unik, dan kombinasi ID serta 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 saat terjadinya konversi. Misalnya, jika konversi terjadi pada Jum, 05 Ags 2016 11:53:22 Waktu Musim Panas Timur (GMT -4.00), tentukan stempel waktu dalam milidetik Epoch: 1470412402000.
• segmentationType: Menentukan jenis sistem konversi yang Anda upload tujuan konversi. Saat ini hanya konversi Floodlight yang didukung, sehingga kolom ini selalu harus menentukan FLOODLIGHT.
• segmentationName: Nama aktivitas Floodlight yang dimiliki pengiklan gunakan untuk melaporkan konversi.

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

  Atau, jika Anda mengetahui ID yang telah ditetapkan 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 dari ID Search Ads 360 dan tidak dapat digunakan untuk mengatribusikan conversions.) Untuk melihat ID Search Ads 360 untuk aktivitas Floodlight, download laporan konversi (baik dari UI Search Ads 360 atau pelaporan API). Jika minimal satu konversi diatribusikan ke aktivitas Floodlight selama jangka waktu laporan, Anda akan melihat ID Search Ads 360 di laporan.

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

  Jika Anda menentukan TRANSACTION, Anda juga harus menentukan kolom berikut:

  • revenueMicros: Nilai uang konversi.

Kolom opsional

• quantityMillis: Jumlah item dalam konversi ini. Misalnya, jumlah orang yang mendaftar untuk buletin email atau jumlah total item yang terjual. Jika Anda tidak menentukan kolom ini untuk konversi ACTION, Search Ads 360 akan otomatis menyisipkan senilai 1000.
• currencyCode: Mata uang pendapatan transaksi. Secara default, pendapatan diasumsikan dalam mata uang pengiklan. Jika Anda menentukan mata uang lain, Search Ads 360 mengonversi jumlah pendapatan yang ditentukan ke mata uang pengiklan. Pelajari lebih lanjut
  Gunakan huruf ISO 4217 (3 karakter) 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 selengkapnya tentang mengupload data untuk Variabel Floodlight.
• deviceType: Menentukan jenis perangkat tempat konversi terjadi. Lihat daftar nilai yang diterima untuk permintaan ini kolom tersebut.

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 mengaitkan konversi ke kata kunci—dan Anda belum tidak khawatir terkait atribusi ke iklan. Anda dapat menghapus sebagian besar kolom 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 TrackerId makro ke URL halaman landing. Untuk informasi mengenai cara mendapatkan ID kata kunci, lihat ID Search Ads 360 dan Konversi.
• conversionId: Untuk konversi offline, pengiklan memberikan ID ini. Pengiklan dapat menentukan ID apa pun yang bermakna bagi mereka. Setiap konversi dalam permintaan harus menentukan ID unik, dan kombinasi ID serta 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 saat terjadinya konversi. Misalnya, jika konversi terjadi pada Jum, 05 Ags 2016 11:53:22 Waktu Musim Panas Timur (GMT -4.00), tentukan stempel waktu dalam milidetik Epoch: 1470412402000.
• segmentationType: Menentukan jenis sistem konversi yang Anda upload tujuan konversi. Saat ini hanya konversi Floodlight yang didukung, sehingga kolom ini selalu harus menentukan FLOODLIGHT.
• segmentationName: Nama aktivitas Floodlight yang dimiliki pengiklan gunakan untuk melaporkan konversi.

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

  Atau, jika Anda mengetahui ID yang telah ditetapkan 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 dari ID Search Ads 360 dan tidak dapat digunakan untuk mengatribusikan conversions.) Untuk melihat ID Search Ads 360 untuk aktivitas Floodlight, download laporan konversi (baik dari UI Search Ads 360 atau pelaporan API). Jika minimal satu konversi diatribusikan ke aktivitas Floodlight selama jangka waktu laporan, Anda akan melihat ID Search Ads 360 di laporan.

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

  Jika Anda menentukan TRANSACTION, Anda juga harus menentukan kolom berikut:

  • revenueMicros: Nilai uang konversi.

Kolom opsional

• quantityMillis: Jumlah item dalam konversi ini. Misalnya, jumlah orang yang mendaftar untuk buletin email atau jumlah total item yang terjual. Jika Anda tidak menentukan kolom ini untuk konversi ACTION, Search Ads 360 akan otomatis menyisipkan senilai 1000.
• currencyCode: Mata uang pendapatan transaksi. Secara default, pendapatan diasumsikan dalam mata uang pengiklan. Jika Anda menentukan mata uang lain, Search Ads 360 mengonversi jumlah pendapatan yang ditentukan ke mata uang pengiklan. Pelajari lebih lanjut
  Gunakan huruf ISO 4217 (3 karakter) 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 selengkapnya tentang mengupload data untuk Variabel Floodlight.
• deviceType: Menentukan jenis perangkat tempat konversi terjadi. Lihat daftar nilai yang diterima untuk permintaan ini kolom tersebut.

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 upload konversi (misalnya, konversi telah diupload, atau clickId tidak ditemukan). Di sini jenis error, pesan details berisi dua item:

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

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

Jenis error lainnya

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

Merespons error

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

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