Campaign Manager 360 API v4, planlanan kullanımdan kaldırma tarihine ulaştı. Hemen v5'e geçin.

Dönüşümleri düzenle

Bu kılavuzda, Campaign Manager 360 API Conversions hizmetini kullanarak dönüşümleri düzenleme hakkında ayrıntılı talimatlar verilmektedir. Devam etmeden önce, çevrimdışı dönüşümlere giriş yapmak ve bu kılavuzda ele alınan kavramlar hakkında bilgi edinmek için Genel Bakış bölümünü incelemeniz önerilir.

Başlamadan önce

Bu düzenleme iş akışı, mevcut online ve çevrimdışı dönüşümlerin quantity ve value değerlerini değiştirmenize olanak tanır. Bunu yapmak için, düzenlenecek dönüşümleri benzersiz şekilde tanımlayan değerler sağlamanız gerekir. Düzenlediğiniz dönüşümlerin türüne bağlı olarak bu değerleri farklı şekillerde elde edersiniz:

Online dönüşümleri tanımlamak için gereken değerler Veri Aktarımı'ndan elde edilebilir.
Çevrimdışı dönüşümleri tanımlamak için gereken değerler, başarılı batchinsert isteklerinin ConversionsBatchInsertResponse içinde döndürülür.

İki türden birine ait dönüşümü başarıyla düzenledikten sonra ConversionsBatchUpdateResponse, sonraki düzenlemeleri yapmak için gereken değerleri içerir.

Dönüşüm kaynaklarını yapılandırma

Düzenleme iş akışının ilk adımında bir veya daha fazla Conversion kaynak nesnesi oluşturulur.

Düzenlenecek bir dönüşümü belirlemek için aşağıdaki alanlar kullanılır. Bu alanlar zorunludur ve mevcut bir dönüşümle tam olarak eşleşmelidir.

Alan	Açıklama
`encryptedUserId` veya `gclid` ya da `dclid` veya `matchid` veya `mobileDeviceId`	Dönüşümü oluşturan şifrelenmiş kullanıcı kimliği, Google tıklama kimliği, görüntülü reklam tıklama kimliği, eşleşme kimliği veya mobil cihaz kimliği. `encryptedUserIdCandidates` alanı düzenlemeler için kullanılamaz.
`floodlightActivityId`	Dönüşümün ilişkilendirildiği Floodlight etkinliği.
`floodlightConfigurationId`	Belirtilen etkinlik tarafından kullanılan Floodlight yapılandırması.
`ordinal`	Dönüşümle ilişkili tekilleştirme tanımlayıcısı.
`timestampMicros`	Dönüşümün zaman damgası (Unix sıfır zamanından itibaren mikrosaniye cinsinden).

Düzenlenebilecek alanlar aşağıda listelenmiştir.

Bu alanlar zorunludur ve sağladığınız değerler, düzenlenen dönüşümdeki önceden var olan değerlerin üzerine yazılır.

Alan	Açıklama
`quantity`	Dönüşümle ilişkilendirilmiş öğe sayısı.
`value`	Dönüşümden elde edilen gelir tutarı.

Bu alanlar isteğe bağlıdır. Ayarlanmamışsa değer değişmez.

Alan	Açıklama
`customVariables`	Dönüşümün özel Floodlight değişkenleri. Değişken ayarlanmışsa değeri günceller veya ekler. Ayarlanmamışsa değişkenin değeri değişmez.

Referans belgelerinde belirtilen diğer tüm alanlar desteklenmez ve değiştirilemez. Düzenleme isteğinize desteklenmeyen alanlar eklediğinizde hata oluşur. Düzenlenen dönüşüm, desteklenmeyen alanlar için önceden var olan değerler içeriyorsa bu değerler otomatik olarak korunur.

Aşağıdaki örnekte, düzenlenecek basit bir dönüşüm kaynağı nesnesinin oluşturulması gösterilmektedir:

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

Şifreleme bilgilerini belirtme

Düzenlenen dönüşümler şifrelenmiş kullanıcı kimlikleriyle ilişkiliyse düzenleme isteğinin bir parçası olarak bunların nasıl şifrelendiğiyle ilgili ayrıntıları sağlamanız gerekir. Ayrıntılar için Dönüşümleri Yükleme kılavuzuna bakın.

Gerekli olduğunda, bu değerleri belirten bir EncryptionInfo nesnesi oluşturmak, düzenleme iş akışındaki ikinci adımdır:

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

Güncelleme isteği oluşturma

Bu sürecin son adımı, dönüşümleri batchupdate ile düzenlemektir. Bu yöntem, düzenlenecek dönüşüm grubunu ilişkili şifreleme bilgileriyle (gerekirse) birleştiren bir ConversionsBatchUpdateRequest nesnesini kabul eder:

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)

Campaign Manager 360'ın, isteğinizdeki her dönüşümü tümü veya hiçbiri işlemi olarak toplu şekilde güncellemek yerine en iyi şekilde düzenlemeye çalıştığını unutmayın. Bir toplu işlemdeki bazı dönüşümler güncellenemezse diğerleri yine de başarıyla güncellenebilir. Bu nedenle, her dönüşümün durumunu belirlemek için döndürülen ConversionsBatchUpdateResponse öğesini incelemeniz önerilir:

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

Yukarıda görüldüğü gibi, yanıtın status alanı, orijinal isteğe dahil edilen her dönüşüm için bir ConversionStatus nesnesi içerir. Yalnızca güncellenemeyen dönüşümlerle ilgileniyorsanız hasFailures alanı, sağlanan toplu işlemdeki herhangi bir dönüşümün başarısız olup olmadığını hızlıca belirlemek için kullanılabilir.

Dönüşümleri düzenle Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

Başlamadan önce

Dönüşüm kaynaklarını yapılandırma

C#

Java

PHP

Python

Ruby

Şifreleme bilgilerini belirtme

C#

Java

PHP

Python

Ruby

Güncelleme isteği oluşturma

C#

Java

PHP

Python

Ruby

C#

Java

PHP

Python

Ruby

Dönüşümleri düzenle