Tambahkan Konversi Baru

Panggil metode Conversion.insert() untuk menambahkan satu atau beberapa konversi. Agar dapat mengatribusikan konversi dengan benar, permintaan Anda harus menentukan nama aktivitas Floodlight yang digunakan pengiklan untuk melaporkan konversi offline, bersama dengan ID kata kunci, iklan, dan mungkin klik yang menghasilkan konversi. Untuk informasi tentang cara mendapatkan ID Search Ads 360, lihat ID dan Konversi Search Ads 360.

Informasi terkait batasan upload konversi historis dapat ditemukan di pusat bantuan Search Ads 360.

Jika permintaan Conversion.insert() Anda menentukan beberapa konversi, Search Ads 360 akan mencoba mengupload setiap konversi berdasarkan upaya terbaik, bukan mengupload seluruh batch sebagai transaksi semua atau tidak sama sekali. Jika beberapa konversi dalam batch gagal diupload, konversi lainnya mungkin masih berhasil diupload. Upload konversi dapat gagal karena permintaan tidak valid atau kegagalan sistem atau jaringan sementara. Oleh karena itu, sebaiknya baca respons untuk setiap konversi yang disisipkan guna memastikan upload berhasil.

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 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 menggunakan Campaign Manager API untuk membuatnya. Anda tidak dapat menggunakan API untuk menentukan apakah aktivitas Floodlight utamanya digunakan 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 akan 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 ini harus menunjukkan bahwa sumber utama konversi adalah aktivitas offline. Lihat pusat bantuan Search Ads 360 untuk mendapatkan petunjuk.

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

    Pastikan setiap upload berisi konversi terbaru. Dalam satu permintaan upload, tidak masalah jika entri berada di luar urutan kronologis. Namun, strategi bidding mungkin tidak dapat mempertimbangkan konversi lama yang nanti Anda upload 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, stempel waktunya harus waktu terjadinya konversi yang terakhir diupload. Data ini akan memberi tahu Search Ads 360 bahwa konversi mungkin terjadi selama 24 jam terakhir, tetapi Anda belum memberikan datanya. Strategi bidding dan sistem otomatis lainnya akan mempertimbangkan histori performa hanya hingga konversi terakhir yang Anda upload.
    • Jika tidak ada konversi yang terjadi selama 24 jam terakhir, stempel waktunya harus waktu dan tanggal saat ini. Data ini memberi tahu Search Ads 360 bahwa tidak ada konversi yang terjadi selama 24 jam terakhir. Strategi bidding dan sistem otomatis lainnya akan menyertakan 24 jam terakhir—sehari penuh tanpa konversi—sebagai 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 ada dalam permintaan Conversion.insert() bergantung pada peristiwa atau item yang Anda atribusikan dengan konversi. Bagian berikut mencantumkan kolom wajib dan 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 tersebut sebagai kunjungan. Untuk mengatribusikan konversi ke kunjungan, tentukan hal berikut dalam permintaan Conversion.insert() Anda:

Kolom wajib diisi

  • clickId: ID klik yang peka huruf besar/kecil pada kunjungan. Cari ID klik atau konversi daftar di log web pengiklan, 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 untuk menghasilkan kunjungan.
    Tunggu setidaknya 30 menit setelah Search Ads 360 membuat ID klik untuk mengupload konversi. Jika Anda menerima pesan error "ID klik tidak ditemukan", tunggu selama 4 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 serta stempel waktu harus unik di antara semua konversi dalam pengiklan. Untuk konversi online, Search Ads 360 akan menyalin dsConversionId atau floodlightOrderId ke properti ini, bergantung pada petunjuk Floodlight pengiklan.
  • conversionTimestamp: Menunjukkan tanggal dan waktu saat konversi terjadi. Misalnya, jika konversi terjadi pada Jum, 05 Aug 2016 11:53:22 AM Eastern Daylight Savings Time (GMT -4:00), tentukan stempel waktu dalam Epoch milidetik: 1470412402000.
  • segmentationType: Menentukan jenis sistem konversi tempat Anda mengupload konversi. Saat ini hanya konversi Floodlight yang didukung, sehingga kolom ini selalu wajib diisi untuk menentukan FLOODLIGHT.
  • segmentationName: Nama aktivitas Floodlight yang digunakan pengiklan untuk melaporkan konversi.

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

    Atau, jika mengetahui ID yang telah ditetapkan oleh 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 ACTION tidak memiliki nilai uang, sedangkan konversi TRANSAKSI tidak memiliki nilai uang. Contohnya adalah pendaftaran milis (ACTION) versus pembelian e-commerce (TRANSAKSI).

    Jika 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 ke newsletter email atau jumlah total item yang terjual. Jika Anda tidak menentukan kolom ini untuk konversi ACTION, 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 lain, Search Ads 360 akan mengonversi jumlah pendapatan yang ditentukan ke mata uang pengiklan. Pelajari lebih lanjut
    Gunakan format alfabet 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 lebih lanjut cara mengupload data untuk variabel Floodlight kustom.
  • deviceType: Menentukan jenis perangkat tempat konversi terjadi. Lihat daftar nilai yang diterima untuk kolom ini.

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

Mengatribusikan konversi hanya ke kata kunci

Jika masalah utama Anda adalah mengatribusikan konversi ke kata kunci—dan Anda tidak mengkhawatirkan 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 serta stempel waktu harus unik di antara semua konversi dalam pengiklan. Untuk konversi online, Search Ads 360 akan menyalin dsConversionId atau floodlightOrderId ke properti ini, bergantung pada petunjuk Floodlight pengiklan.
  • conversionTimestamp: Menunjukkan tanggal dan waktu saat konversi terjadi. Misalnya, jika konversi terjadi pada Jum, 05 Aug 2016 11:53:22 AM Eastern Daylight Savings Time (GMT -4:00), tentukan stempel waktu dalam Epoch milidetik: 1470412402000.
  • segmentationType: Menentukan jenis sistem konversi tempat Anda mengupload konversi. Saat ini hanya konversi Floodlight yang didukung, sehingga kolom ini selalu wajib diisi untuk menentukan FLOODLIGHT.
  • segmentationName: Nama aktivitas Floodlight yang digunakan pengiklan untuk melaporkan konversi.

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

    Atau, jika mengetahui ID yang telah ditetapkan oleh 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 ACTION tidak memiliki nilai uang, sedangkan konversi TRANSAKSI tidak memiliki nilai uang. Contohnya adalah pendaftaran milis (ACTION) versus pembelian e-commerce (TRANSAKSI).

    Jika 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 ke newsletter email atau jumlah total item yang terjual. Jika Anda tidak menentukan kolom ini untuk konversi ACTION, 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 lain, Search Ads 360 akan mengonversi jumlah pendapatan yang ditentukan ke mata uang pengiklan. Pelajari lebih lanjut
    Gunakan format alfabet 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 lebih lanjut cara mengupload data untuk variabel Floodlight kustom.
  • deviceType: Menentukan jenis perangkat tempat konversi terjadi. Lihat daftar nilai yang diterima untuk kolom ini.

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

Mengupload data dari model atribusi pihak ketiga

Model atribusi mendistribusikan kredit untuk konversi ke seluruh aktivitas di jalur konversi. Misalnya, jika konsumen mengklik iklan penelusuran berbayar, iklan Display, dan iklan penelusuran berbayar lainnya sebelum melakukan konversi, model atribusi linear akan memberikan 33% kredit konversi untuk setiap klik.

Meskipun Search Ads 360 menyediakan model atribusi, jika Anda menggunakan layanan pihak ketiga atau layanan yang telah Anda kembangkan untuk mendistribusikan kredit ke klik, Anda dapat mengupload data atribusi pihak ketiga ke Search Ads 360 dan menggunakan data tersebut dalam laporan dan strategi bidding Search Ads 360.

Sebelum memulai

Di Campaign Manager, buat model atribusi khusus dan impor model tersebut ke Search Ads 360. Pastikan Anda menamai model dengan Model Atribusi Eksternal. Hal ini memungkinkan fitur Search Ads 360 mengenali bahwa model atribusi telah diterapkan ke data konversi yang Anda upload. Pelajari lebih lanjut

Kolom wajib diisi

Untuk menerapkan model atribusi pihak ketiga ke konversi, tentukan semua hal berikut dalam permintaan Conversion.insert() Anda:

  • clickId: ID klik yang peka huruf besar/kecil pada kunjungan. Cari ID klik atau konversi daftar di log web pengiklan, 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 untuk menghasilkan kunjungan.
    Tunggu setidaknya 30 menit setelah Search Ads 360 membuat ID klik sebelum mengupload konversi dengan ID tersebut. Jika tidak, Search Ads 360 API mungkin tidak mengenali kunjungan tersebut.
  • attributionModel: Tetapkan ke Model Atribusi Eksternal. Pelajari lebih lanjut
  • countMillis: Jumlah kredit konversi yang akan didistribusikan ke klik ini. Hanya berlaku jika permintaan juga menyertakan kolom attributionModel.

    Jangan tertukar dengan quantityMillis, kolom opsional yang menentukan jumlah item dalam konversi (seperti jumlah item dalam pembelian keranjang belanja).

  • 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 serta stempel waktu harus unik di antara semua konversi dalam pengiklan. Untuk konversi online, Search Ads 360 akan menyalin dsConversionId atau floodlightOrderId ke properti ini, bergantung pada petunjuk Floodlight pengiklan.
  • conversionTimestamp: Menunjukkan tanggal dan waktu saat konversi terjadi. Misalnya, jika konversi terjadi pada Jum, 05 Aug 2016 11:53:22 AM Eastern Daylight Savings Time (GMT -4:00), tentukan stempel waktu dalam Epoch milidetik: 1470412402000.
  • segmentationType: Menentukan jenis sistem konversi tempat Anda mengupload konversi. Saat ini hanya konversi Floodlight yang didukung, sehingga kolom ini selalu wajib diisi untuk menentukan FLOODLIGHT.
  • segmentationName: Nama aktivitas Floodlight yang digunakan pengiklan untuk melaporkan konversi.

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

    Atau, jika mengetahui ID yang telah ditetapkan oleh 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 ACTION tidak memiliki nilai uang, sedangkan konversi TRANSAKSI tidak memiliki nilai uang. Contohnya adalah pendaftaran milis (ACTION) versus pembelian e-commerce (TRANSAKSI).

    Jika menentukan TRANSACTION, Anda juga harus menentukan kolom berikut:

    • revenueMicros: Nilai uang konversi.

Jika Anda melacak pendapatan konversi, pastikan model Anda mendistribusikan pendapatan di setiap titik kontak di jalur konversi.Misalnya, jika model Anda menggunakan pendekatan linear (mendistribusikan pendapatan secara merata di setiap poin kontak), di jalur konversi yang menyertakan 3 klik iklan, setiap klik akan diatribusikan dengan 33% konversi tersebut. Jika konversi menghasilkan pendapatan sebesar $100, pastikan model Anda mendistribusikan pendapatan sebesar $33 ke setiap klik, dan pastikan revenueMicros hanya menetapkan pendapatan sebesar $33 untuk setiap klik.

Kolom opsional

  • quantityMillis: Jumlah item dalam konversi ini. Misalnya, jumlah orang yang mendaftar ke newsletter email atau jumlah total item yang terjual. Jika Anda tidak menentukan kolom ini untuk konversi ACTION, 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 lain, Search Ads 360 akan mengonversi jumlah pendapatan yang ditentukan ke mata uang pengiklan. Pelajari lebih lanjut
    Gunakan format alfabet 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 lebih lanjut cara mengupload data untuk variabel Floodlight kustom.
  • deviceType: Menentukan jenis perangkat tempat konversi terjadi. Lihat daftar nilai yang diterima untuk kolom ini.

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

Menangani respons Search Ads 360

Respons dari Search Ads 360 menunjukkan keberhasilan hanya jika semua konversi dalam permintaan berhasil divalidasi dan diupload.

Jika permintaan berhasil

Jika permintaan berhasil, responsnya akan menyertakan representasi internal Search Ads 360 lengkap untuk setiap konversi yang diupload, seperti ID kampanye, ID grup iklan, dan ID kata kunci (kriteria).

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

Jika permintaan tidak berhasil

Jika satu atau beberapa konversi gagal divalidasi atau diupload, responsnya akan menyertakan pesan untuk setiap upload konversi yang gagal. Respons tidak berisi pesan tentang konversi yang berhasil diupload.

Berikut contoh respons terhadap permintaan yang tidak sepenuhnya berhasil:

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

Setiap pesan kegagalan berisi dua kolom penting: alasan dan pesan error mendetail. Kolom alasannya dapat berisi requestValidation, internalError, transactionFailed, atau lateStageRequestError.

error requestValidation

Error requestValidation menunjukkan masalah data dalam permintaan upload konversi (misalnya, konversi telah diupload atau clickId tidak ditemukan). Pada jenis error ini, pesan details 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 kesalahan 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 setiap konversi yang sudah diupload, tetapi akan mencoba mengupload konversi yang tersisa.

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