Halaman ini diterjemahkan oleh Cloud Translation API.

Edit konversi

Panduan ini memberikan petunjuk mendetail untuk mengedit konversi menggunakan layanan Conversions Campaign Manager 360 API. Sebelum melanjutkan, sebaiknya Anda meninjau Ringkasan untuk mengetahui pengantar konversi offline dan memahami konsep yang dibahas dalam panduan ini.

Sebelum memulai

Alur kerja pengeditan ini memungkinkan Anda mengubah quantity dan value konversi online dan offline yang ada. Untuk melakukannya, Anda harus memberikan nilai yang secara unik mengidentifikasi konversi yang akan diedit. Bergantung pada jenis konversi yang diedit, Anda akan mendapatkan nilai ini dengan berbagai cara:

Nilai yang diperlukan untuk mengidentifikasi konversi online dapat diperoleh dari Transfer Data.
Nilai yang diperlukan untuk mengidentifikasi konversi offline ditampilkan di ConversionsBatchInsertResponse dari permintaan batchinsert yang berhasil.

Setelah Anda berhasil mengedit konversi dari salah satu jenis tersebut, ConversionsBatchUpdateResponse akan berisi nilai yang diperlukan untuk melakukan pengeditan berikutnya.

Konfigurasikan resource konversi

Langkah pertama dalam alur kerja edit melibatkan pembuatan satu atau beberapa objek resource Conversion.

Kolom berikut digunakan untuk mengidentifikasi konversi yang akan diedit. Kolom ini wajib diisi dan harus sama persis dengan konversi yang ada.

Kolom	Deskripsi
`encryptedUserId` atau `gclid` atau `dclicd` atau `matchid` atau `mobileDeviceId`	ID pengguna terenkripsi, ID Klik Google, ID Klik Display, ID pencocokan, atau ID perangkat seluler yang menghasilkan konversi. Kolom `encryptedUserIdCandidates` tidak dapat digunakan untuk pengeditan.
`floodlightActivityId`	Aktivitas Floodlight yang akan dikaitkan ke konversi.
`floodlightConfigurationId`	Konfigurasi Floodlight yang digunakan oleh aktivitas yang ditentukan.
`ordinal`	ID penghapusan duplikat yang terkait dengan konversi.
`timestampMicros`	Stempel waktu konversi, dalam mikrodetik sejak epoch Unix.

Kolom yang dapat diedit tercantum di bawah ini. Kolom ini wajib diisi dan nilai yang Anda berikan akan menimpa nilai yang sudah ada sebelumnya pada konversi yang sedang diedit.

Kolom	Deskripsi
`quantity`	Jumlah item yang terkait dengan konversi.
`value`	Jumlah pendapatan yang dihasilkan oleh konversi.

Semua kolom lain yang disebutkan dalam dokumentasi referensi tidak didukung dan tidak dapat diubah. Menyertakan kolom yang tidak didukung di permintaan edit akan menyebabkan error. Jika konversi yang diedit berisi nilai yang sudah ada sebelumnya untuk kolom yang tidak didukung, nilai tersebut akan otomatis dipertahankan.

Contoh di bawah ini mengilustrasikan pembuatan objek resource konversi sederhana untuk diedit:

C#

// Find the Floodlight configuration ID based on the provided activity ID.
FloodlightActivity floodlightActivity =
    service.FloodlightActivities.Get(profileId, floodlightActivityId).Execute();
long floodlightConfigurationId = (long) floodlightActivity.FloodlightConfigurationId;

// Construct the conversion object with values that identify the conversion to update.
Conversion conversion = new Conversion();
conversion.EncryptedUserId = conversionUserId;
conversion.FloodlightActivityId = floodlightActivityId;
conversion.FloodlightConfigurationId = floodlightConfigurationId;
conversion.Ordinal = conversionOrdinal;
conversion.TimestampMicros = conversionTimestamp;

// Set the fields to be updated. These fields are required; to preserve a value from the
// existing conversion, it must be copied over manually.
conversion.Quantity = newQuantity;
conversion.Value = newValue;

Java

// Create a conversion object populated with values that identify the conversion to update.
Conversion conversion = new Conversion();
conversion.setEncryptedUserId(encryptedUserId);
conversion.setFloodlightActivityId(floodlightActivityId);
conversion.setFloodlightConfigurationId(floodlightConfigurationId);
conversion.setOrdinal(ordinal);
conversion.setTimestampMicros(timestampMicros);

// Set the fields to be updated. These fields are required; to preserve a value from the
// existing conversion, it must be copied over manually.
conversion.setQuantity(newQuantity);
conversion.setValue(newValue);

PHP

// Find Floodlight configuration ID based on provided activity ID.
$activity = $this->service->floodlightActivities->get(
    $values['user_profile_id'],
    $values['floodlight_activity_id']
);
$floodlightConfigId = $activity->getFloodlightConfigurationId();

// Create a conversion object with values that identify the conversion to
// update.
$conversion = new Google_Service_Dfareporting_Conversion();
$conversion->setEncryptedUserId($values['encrypted_user_id']);
$conversion->setFloodlightActivityId($values['floodlight_activity_id']);
$conversion->setFloodlightConfigurationId($floodlightConfigId);
$conversion->setOrdinal($values['ordinal']);
$conversion->setTimestampMicros($values['timestamp']);

// Set the fields to be updated. These fields are required; to preserve a
// value from the existing conversion, it must be copied over manually.
$conversion->setQuantity($values['new_quantity']);
$conversion->setValue($values['new_value']);

Python

# Construct the conversion object with values that identify the conversion
# to update.
conversion = {
    'encryptedUserId': encrypted_user_id,
    'floodlightActivityId': floodlight_activity_id,
    'floodlightConfigurationId': floodlight_config_id,
    'ordinal': ordinal,
    'timestampMicros': timestamp
}

# Set the fields to be updated. These fields are required; to preserve a
# value from the existing conversion, it must be copied over manually.
conversion['quantity'] = new_quantity
conversion['value'] = new_value

Ruby

# Look up the Floodlight configuration ID based on activity ID.
floodlight_activity = service.get_floodlight_activity(profile_id,
  existing_conversion[:floodlight_activity_id])
floodlight_config_id = floodlight_activity.floodlight_configuration_id

# Construct the conversion with values that identify the conversion to
# update.
conversion = DfareportingUtils::API_NAMESPACE::Conversion.new(
  encrypted_user_id: existing_conversion[:encrypted_user_id],
  floodlight_activity_id: existing_conversion[:floodlight_activity_id],
  floodlight_configuration_id: floodlight_config_id,
  ordinal: existing_conversion[:ordinal],
  timestamp_micros: existing_conversion[:timestamp]
)

# Set the fields to be updated. These fields are required; to preserve a
# value from the existing conversion, it must be copied over manually.
conversion.quantity = new_quantity
conversion.value = new_value

Menentukan info enkripsi

Jika konversi yang diedit dikaitkan dengan ID pengguna terenkripsi, Anda harus memberikan detail tentang cara konversi tersebut dienkripsi sebagai bagian dari permintaan edit. Lihat panduan Mengupload Konversi untuk mengetahui detailnya.

Jika diperlukan, membuat objek EncryptionInfo yang menentukan nilai ini adalah langkah kedua dalam alur kerja edit:

C#

// Create the encryption info.
EncryptionInfo encryptionInfo = new EncryptionInfo();
encryptionInfo.EncryptionEntityId = encryptionEntityId;
encryptionInfo.EncryptionEntityType = encryptionEntityType;
encryptionInfo.EncryptionSource = encryptionSource;

Java

// Create the encryption info.
EncryptionInfo encryptionInfo = new EncryptionInfo();
encryptionInfo.setEncryptionEntityId(encryptionEntityId);
encryptionInfo.setEncryptionEntityType(encryptionEntityType);
encryptionInfo.setEncryptionSource(encryptionSource);

PHP

$encryptionInfo = new Google_Service_Dfareporting_EncryptionInfo();
$encryptionInfo->setEncryptionEntityId($values['encryption_entity_id']);
$encryptionInfo->setEncryptionEntityType($values['encryption_entity_type']);
$encryptionInfo->setEncryptionSource($values['encryption_source']);

Python

# Construct the encryption info.
encryption_info = {
    'encryptionEntityId': encryption_entity_id,
    'encryptionEntityType': encryption_entity_type,
    'encryptionSource': encryption_source
}

Ruby

# Construct the encryption info.
encryption_info = DfareportingUtils::API_NAMESPACE::EncryptionInfo.new(
  encryption_entity_id: encryption[:entity_id],
  encryption_entity_type: encryption[:entity_type],
  encryption_source: encryption[:source]
)

Membuat permintaan pembaruan

Langkah terakhir dalam proses ini adalah mengedit konversi dengan panggilan ke batchupdate. Metode ini menerima objek ConversionsBatchUpdateRequest, yang menggabungkan kumpulan konversi yang akan diedit dengan info enkripsi terkait (jika diperlukan):

C#

// Insert the conversion.
ConversionsBatchUpdateRequest request = new ConversionsBatchUpdateRequest();
request.Conversions = new List<Conversion>() { conversion };
request.EncryptionInfo = encryptionInfo;

ConversionsBatchUpdateResponse response =
    service.Conversions.Batchupdate(request, profileId).Execute();

Java

ConversionsBatchUpdateRequest request = new ConversionsBatchUpdateRequest();
request.setConversions(ImmutableList.of(conversion));
request.setEncryptionInfo(encryptionInfo);

ConversionsBatchUpdateResponse response = reporting.conversions()
    .batchupdate(profileId, request).execute();

PHP

$batch = new Google_Service_Dfareporting_ConversionsBatchUpdateRequest();
$batch->setConversions([$conversion]);
$batch->setEncryptionInfo($encryptionInfo);

$result = $this->service->conversions->batchupdate(
    $values['user_profile_id'],
    $batch
);

Python

# Update the conversion.
request_body = {
    'conversions': [conversion],
    'encryptionInfo': encryption_info
}
request = service.conversions().batchupdate(
    profileId=profile_id, body=request_body)
response = request.execute()

Ruby

# Construct the batch update request.
batch_update_request =
  DfareportingUtils::API_NAMESPACE::ConversionsBatchUpdateRequest.new(
    conversions: [conversion],
    encryption_info: encryption_info
  )

# Update the conversion.
result = service.batchupdate_conversion(profile_id, batch_update_request)

Perhatikan bahwa Campaign Manager 360 akan berupaya mengedit setiap konversi dalam permintaan Anda berdasarkan upaya terbaik, bukan memperbarui seluruh batch sebagai transaksi all-or-nothing. Jika beberapa konversi dalam batch gagal diperbarui, konversi lainnya mungkin masih berhasil diperbarui. Oleh karena itu, sebaiknya periksa ConversionsBatchUpdateResponse yang ditampilkan, untuk menentukan status setiap konversi:

C#

// Handle the batchinsert response.
if (!response.HasFailures.Value) {
  Console.WriteLine("Successfully updated conversion for encrypted user ID {0}.",
      conversionUserId);
} else {
  Console.WriteLine("Error(s) updating conversion for encrypted user ID {0}:",
      conversionUserId);

  ConversionStatus status = response.Status[0];
  foreach(ConversionError error in status.Errors) {
    Console.WriteLine("\t[{0}]: {1}", error.Code, error.Message);
  }
}

Java

if (!response.getHasFailures()) {
  System.out.printf("Successfully updated conversion for encrypted user ID %s.%n",
      encryptedUserId);
} else {
  System.out.printf("Error(s) updating conversion for encrypted user ID %s:%n",
      encryptedUserId);

  // Retrieve the conversion status and report any errors found. If multiple conversions
  // were included in the original request, the response would contain a status for each.
  ConversionStatus status = response.getStatus().get(0);
  for (ConversionError error : status.getErrors()) {
    System.out.printf("\t[%s]: %s.%n", error.getCode(), error.getMessage());
  }
}

PHP

if (!$result->getHasFailures()) {
    printf(
        'Successfully updated conversion for encrypted user ID %s.',
        $values['encrypted_user_id']
    );
} else {
    printf(
        'Error(s) updating conversion for encrypted user ID %s:<br><br>',
        $values['encrypted_user_id']
    );

    $status = $result->getStatus()[0];
    foreach ($status->getErrors() as $error) {
        printf('[%s] %s<br>', $error->getCode(), $error->getMessage());
    }
}

Python

if not response['hasFailures']:
  print('Successfully updated conversion for encrypted user ID %s.' %
        encrypted_user_id)
else:
  print('Error(s) updating conversion for encrypted user ID %s.' %
        encrypted_user_id)

  status = response['status'][0]
  for error in status['errors']:
    print '\t[%s]: %s' % (error['code'], error['message'])

Ruby

if result.has_failures
  puts format('Error(s) updating conversion for encrypted user ID %s.',
    existing_conversion[:encrypted_user_id])

  status = result.status[0]
  status.errors.each do |error|
    puts format("\t[%s]: %s", error.code, error.message)
  end
else
  puts format('Successfully updated conversion for encrypted user ID %s.',
    existing_conversion[:encrypted_user_id])
end

Kolom status dari respons, seperti yang terlihat di atas, akan berisi objek ConversionStatus untuk setiap konversi yang disertakan dalam permintaan asli. Jika Anda hanya tertarik pada konversi yang gagal diperbarui, kolom hasFailures dapat digunakan dengan cepat untuk menentukan apakah ada konversi dalam batch yang diberikan gagal.