전환이 이미 Google Ads에 보고되면 나중에 Google Ads API에서 전환을 조정할 수 있습니다.
전환을 조정하려면 먼저 전환 액션을 설정하고 조정하려는 전환을 기록한 상태여야 합니다.
코드 예시
Google Ads API에서는 거래 ID라고도 하는 order_id를 사용하여 ConversionAdjustmentUploadService에 따라 조정할 전환을 식별할 수 있습니다.
전환 조정에 필요한 conversion_action_id를 가져오려면 다음 중 하나를 실행하면 됩니다.
Google Ads UI에서 전환 세부정보를 클릭할 때 URL에서 사용 가능한
ctId매개변수에서 값을 가져옵니다.conversion_action보고서에서conversion_action.id에 대해 Google Ads API를 쿼리합니다.
Java
private void runExample(
GoogleAdsClient googleAdsClient,
long customerId,
long conversionActionId,
String orderId,
String adjustmentType,
String adjustmentDateTime,
@Nullable Float restatementValue)
throws InvalidProtocolBufferException {
// Gets the conversion adjustment enum value from the adjustmentType String.
ConversionAdjustmentType conversionAdjustmentType =
ConversionAdjustmentType.valueOf(adjustmentType);
// Applies the conversion adjustment to the existing conversion.
ConversionAdjustment conversionAdjustment =
ConversionAdjustment.newBuilder()
.setConversionAction(ResourceNames.conversionAction(customerId, conversionActionId))
.setAdjustmentType(conversionAdjustmentType)
// Sets the orderId to identify the conversion to adjust.
.setOrderId(orderId)
// As an alternative to setting orderId, you can provide a GclidDateTimePair, but
// setting orderId instead is strongly recommended.
// .setGclidDateTimePair(
// GclidDateTimePair.newBuilder()
// .setGclid(gclid)
// .setConversionDateTime(conversionDateTime)
// .build())
.setAdjustmentDateTime(adjustmentDateTime)
.build();
// Sets adjusted value for adjustment type RESTATEMENT.
if (restatementValue != null
&& conversionAdjustmentType == ConversionAdjustmentType.RESTATEMENT) {
conversionAdjustment =
conversionAdjustment.toBuilder()
.setRestatementValue(
RestatementValue.newBuilder().setAdjustedValue(restatementValue).build())
.build();
}
// Creates the conversion upload service client.
try (ConversionAdjustmentUploadServiceClient conversionUploadServiceClient =
googleAdsClient.getLatestVersion().createConversionAdjustmentUploadServiceClient()) {
// Uploads the click conversion. Partial failure should always be set to true.
UploadConversionAdjustmentsRequest request =
UploadConversionAdjustmentsRequest.newBuilder()
.setCustomerId(Long.toString(customerId))
// Enables partial failure (must be true).
.setPartialFailure(true)
.addConversionAdjustments(conversionAdjustment)
.build();
UploadConversionAdjustmentsResponse response =
conversionUploadServiceClient.uploadConversionAdjustments(request);
// Extracts the partial failure error if present on the response.
ErrorUtils errorUtils = ErrorUtils.getInstance();
GoogleAdsFailure googleAdsFailure =
response.hasPartialFailureError()
? errorUtils.getGoogleAdsFailure(response.getPartialFailureError())
: null;
// Constructs a protocol buffer printer that will print error details in a concise format.
final Printer errorPrinter = JsonFormat.printer().omittingInsignificantWhitespace();
// Prints the results for each adjustment, including any partial errors returned.
for (int opIndex = 0; opIndex < request.getConversionAdjustmentsCount(); opIndex++) {
ConversionAdjustmentResult result = response.getResults(opIndex);
if (errorUtils.isPartialFailureResult(result)) {
// The operation failed. Prints the error details.
for (GoogleAdsError googleAdsError :
errorUtils.getGoogleAdsErrors(opIndex, googleAdsFailure)) {
System.out.printf(
"%4d: Partial failure occurred: %s%n", opIndex, errorPrinter.print(googleAdsError));
}
} else {
System.out.printf(
"%4d: Uploaded conversion adjustment for conversion action '%s' and order ID '%s'.%n",
opIndex, result.getConversionAction(), result.getOrderId());
}
}
}
}
C#
public void Run(GoogleAdsClient client, long customerId, long conversionActionId,
string gclid, string conversionDateTime, string adjustmentDateTime,
ConversionAdjustmentType adjustmentType,
double? restatementValue)
{
// Get the ConversionAdjustmentUploadService.
ConversionAdjustmentUploadServiceClient conversionAdjustmentUploadService =
client.GetService(Services.V16.ConversionAdjustmentUploadService);
// Associate conversion adjustments with the existing conversion action.
// The GCLID should have been uploaded before with a conversion.
ConversionAdjustment conversionAdjustment = new ConversionAdjustment()
{
ConversionAction = ResourceNames.ConversionAction(customerId, conversionActionId),
AdjustmentType = adjustmentType,
GclidDateTimePair = new GclidDateTimePair()
{
Gclid = gclid,
ConversionDateTime = conversionDateTime,
},
AdjustmentDateTime = adjustmentDateTime,
};
// Set adjusted value for adjustment type RESTATEMENT.
if (adjustmentType == ConversionAdjustmentType.Restatement)
{
conversionAdjustment.RestatementValue = new RestatementValue()
{
AdjustedValue = restatementValue.Value
};
}
try
{
// Issue a request to upload the conversion adjustment.
UploadConversionAdjustmentsResponse response =
conversionAdjustmentUploadService.UploadConversionAdjustments(
new UploadConversionAdjustmentsRequest()
{
CustomerId = customerId.ToString(),
ConversionAdjustments = { conversionAdjustment },
PartialFailure = true,
ValidateOnly = false
});
ConversionAdjustmentResult result = response.Results[0];
// Print the result.
Console.WriteLine($"Uploaded conversion adjustment value of" +
$" '{result.ConversionAction}' for Google Click ID " +
$"'{result.GclidDateTimePair.Gclid}'");
}
catch (GoogleAdsException e)
{
Console.WriteLine("Failure:");
Console.WriteLine($"Message: {e.Message}");
Console.WriteLine($"Failure: {e.Failure}");
Console.WriteLine($"Request ID: {e.RequestId}");
throw;
}
}
2,399필리핀
public static function runExample(
GoogleAdsClient $googleAdsClient,
int $customerId,
int $conversionActionId,
string $gclid,
string $adjustmentType,
string $conversionDateTime,
string $adjustmentDateTime,
float $restatementValue
) {
$conversionAdjustmentType = ConversionAdjustmentType::value($adjustmentType);
// Associates conversion adjustments with the existing conversion action.
// The GCLID should have been uploaded before with a conversion.
$conversionAdjustment = new ConversionAdjustment([
'conversion_action' =>
ResourceNames::forConversionAction($customerId, $conversionActionId),
'adjustment_type' => $conversionAdjustmentType,
'gclid_date_time_pair' => new GclidDateTimePair([
'gclid' => $gclid,
'conversion_date_time' => $conversionDateTime
]),
'adjustment_date_time' => $adjustmentDateTime
]);
// Sets adjusted value for adjustment type RESTATEMENT.
if (
$restatementValue !== null
&& $conversionAdjustmentType === ConversionAdjustmentType::RESTATEMENT
) {
$conversionAdjustment->setRestatementValue(new RestatementValue([
'adjusted_value' => $restatementValue
]));
}
// Issues a request to upload the conversion adjustment.
$conversionAdjustmentUploadServiceClient =
$googleAdsClient->getConversionAdjustmentUploadServiceClient();
$response = $conversionAdjustmentUploadServiceClient->uploadConversionAdjustments(
UploadConversionAdjustmentsRequest::build($customerId, [$conversionAdjustment], true)
);
// Prints the status message if any partial failure error is returned.
// Note: The details of each partial failure error are not printed here, you can refer to
// the example HandlePartialFailure.php to learn more.
if ($response->hasPartialFailureError()) {
printf(
"Partial failures occurred: '%s'.%s",
$response->getPartialFailureError()->getMessage(),
PHP_EOL
);
} else {
// Prints the result if exists.
/** @var ConversionAdjustmentResult $uploadedConversionAdjustment */
$uploadedConversionAdjustment = $response->getResults()[0];
printf(
"Uploaded conversion adjustment of '%s' for Google Click ID '%s'.%s",
$uploadedConversionAdjustment->getConversionAction(),
$uploadedConversionAdjustment->getGclidDateTimePair()->getGclid(),
PHP_EOL
);
}
}
Python
def main(
client,
customer_id,
conversion_action_id,
gclid,
adjustment_type,
conversion_date_time,
adjustment_date_time,
restatement_value,
):
conversion_adjustment_type_enum = client.enums.ConversionAdjustmentTypeEnum
# Determine the adjustment type.
conversion_adjustment_type = conversion_adjustment_type_enum[
adjustment_type
].value
# Associates conversion adjustments with the existing conversion action.
# The GCLID should have been uploaded before with a conversion
conversion_adjustment = client.get_type("ConversionAdjustment")
conversion_action_service = client.get_service("ConversionActionService")
conversion_adjustment.conversion_action = (
conversion_action_service.conversion_action_path(
customer_id, conversion_action_id
)
)
conversion_adjustment.adjustment_type = conversion_adjustment_type
conversion_adjustment.adjustment_date_time = adjustment_date_time
# Set the Gclid Date
conversion_adjustment.gclid_date_time_pair.gclid = gclid
conversion_adjustment.gclid_date_time_pair.conversion_date_time = (
conversion_date_time
)
# Sets adjusted value for adjustment type RESTATEMENT.
if (
restatement_value
and conversion_adjustment_type
== conversion_adjustment_type_enum.RESTATEMENT.value
):
conversion_adjustment.restatement_value.adjusted_value = float(
restatement_value
)
conversion_adjustment_upload_service = client.get_service(
"ConversionAdjustmentUploadService"
)
request = client.get_type("UploadConversionAdjustmentsRequest")
request.customer_id = customer_id
request.conversion_adjustments = [conversion_adjustment]
request.partial_failure = True
response = (
conversion_adjustment_upload_service.upload_conversion_adjustments(
request=request,
)
)
conversion_adjustment_result = response.results[0]
print(
f"Uploaded conversion that occurred at "
f'"{conversion_adjustment_result.adjustment_date_time}" '
f"from Gclid "
f'"{conversion_adjustment_result.gclid_date_time_pair.gclid}"'
f' to "{conversion_adjustment_result.conversion_action}"'
)
Ruby
def upload_conversion_adjustment(
customer_id,
conversion_action_id,
gclid,
adjustment_type,
conversion_date_time,
adjustment_date_time,
restatement_value
)
# GoogleAdsClient will read a config file from
# ENV['HOME']/google_ads_config.rb when called without parameters
client = Google::Ads::GoogleAds::GoogleAdsClient.new
# Associate conversion adjustments with the existing conversion action.
# The GCLID should have been uploaded before with a conversion.
conversion_adjustment = client.resource.conversion_adjustment do |ca|
ca.conversion_action = client.path.conversion_action(customer_id, conversion_action_id)
ca.adjustment_type = adjustment_type
ca.gclid_date_time_pair = client.resource.gclid_date_time_pair do |gdtp|
gdtp.gclid = gclid
gdtp.conversion_date_time = conversion_date_time
end
ca.adjustment_date_time = adjustment_date_time
# Set adjusted value for adjustment type RESTATEMENT.
if adjustment_type == :RESTATEMENT
ca.restatement_value = client.resource.restatement_value do |ra|
ra.adjusted_value = restatement_value.to_f
end
end
end
# Issue a request to upload the conversion adjustment(s).
response = client.service.conversion_adjustment_upload.upload_conversion_adjustments(
customer_id: customer_id,
# This example shows just one adjustment but you may upload multiple ones.
conversion_adjustments: [conversion_adjustment],
partial_failure: true
)
if response.partial_failure_error.nil?
# Process and print all results for multiple adjustments
response.results.each do |result|
puts "Uploaded conversion adjustment at #{result.adjustment_date_time} " \
"for adjustment #{result.adjustment_type} to #{result.conversion_action}."
end
else
# Print any partial errors returned.
failures = client.decode_partial_failure_error(response.partial_failure_error)
puts 'Request failed. Failure details:'
failures.each do |failure|
failure.errors.each do |error|
puts "\t#{error.error_code.error_code}: #{error.message}"
end
end
end
end
Perl
sub upload_conversion_adjustment {
my ($api_client, $customer_id, $conversion_action_id, $gclid,
$adjustment_type, $conversion_date_time, $adjustment_date_time,
$restatement_value)
= @_;
# Associate conversion adjustments with the existing conversion action.
# The GCLID should have been uploaded before with a conversion.
my $conversion_adjustment =
Google::Ads::GoogleAds::V16::Services::ConversionAdjustmentUploadService::ConversionAdjustment
->new({
conversionAction =>
Google::Ads::GoogleAds::V16::Utils::ResourceNames::conversion_action(
$customer_id, $conversion_action_id
),
adjustmentType => $adjustment_type,
gclidDateTimePair =>
Google::Ads::GoogleAds::V16::Services::ConversionAdjustmentUploadService::GclidDateTimePair
->new({
gclid => $gclid,
conversionDateTime => $conversion_date_time
}
),
adjustmentDateTime => $adjustment_date_time,
});
# Set adjusted value for adjustment type RESTATEMENT.
$conversion_adjustment->{restatementValue} =
Google::Ads::GoogleAds::V16::Services::ConversionAdjustmentUploadService::RestatementValue
->new({
adjustedValue => $restatement_value
}) if defined $restatement_value && $adjustment_type eq RESTATEMENT;
# Issue a request to upload the conversion adjustment.
my $upload_conversion_adjustments_response =
$api_client->ConversionAdjustmentUploadService()
->upload_conversion_adjustments({
customerId => $customer_id,
conversionAdjustments => [$conversion_adjustment],
partialFailure => "true"
});
# Print any partial errors returned.
if ($upload_conversion_adjustments_response->{partialFailureError}) {
printf "Partial error encountered: '%s'.\n",
$upload_conversion_adjustments_response->{partialFailureError}{message};
}
# Print the result if valid.
my $uploaded_conversion_adjustment =
$upload_conversion_adjustments_response->{results}[0];
if (%$uploaded_conversion_adjustment) {
printf "Uploaded conversion adjustment of the conversion action " .
"with resource name '%s' for Google Click ID '%s'.\n",
$uploaded_conversion_adjustment->{conversionAction},
$uploaded_conversion_adjustment->{gclidDateTimePair}{gclid};
}
return 1;
}
요구사항
다음은 API에서 전환을 조정할 때 유의해야 할 몇 가지 요구사항과 제한사항입니다.
전환 액션을 관리하는 계정만 조정을 업로드할 수 있습니다. 전환 추적 설정 안내에 따라 Google Ads 계정의 전환을 관리하는 계정을 확인합니다.
다른 계정을 사용하여 조정을 업로드하려고 하면
NO_CONVERSION_ACTION_FOUND오류가 발생합니다. 이 오류는 조정의 전환 액션이 사용 설정되지 않은 경우에도 발생합니다.Google Ads에서는
SALESFORCE,UPLOAD_CLICKS,WEBPAGE전환 액션 유형의 전환만 조정할 수 있습니다. 전환 액션이 이러한 유형이 아닌 경우 전환에 대한 조정을 업로드하려고 하면INVALID_CONVERSION_ACTION_TYPE오류가 발생합니다.날짜와 시간을 지정하는 필드에는 계정의 시간대가 아닌 시간대가 필요합니다. 필드의 형식은
yyyy-mm-dd HH:mm:ss+|-HH:mm입니다(예:2022-01-01 19:32:45-05:00(일광 절약 시간 무시)).TOO_RECENT_CONVERSION_ACTION오류를 방지하려면 전환 액션을 만들고 4~6시간 후에 전환을 조정하세요.다음 조건 중 하나라도 충족되면
CONVERSION_NOT_FOUND오류와 함께 조정이 실패합니다.전환이 보고되지 않았습니다.
조정을 시도하기 24시간 미만 전에 전환이 보고되었습니다. 일부 상황에서는
TOO_RECENT_CONVERSION오류가 대신 발생할 수 있습니다.
다음 조건 중 하나에서
ConversionAdjustment에order_id를 지정해야 합니다.전환 액션의
type이(가)WEBPAGE입니다.조정 중인 기존 전환에
order_id이(가) 할당되었습니다.
대신
gclid_date_time_pair를 지정하면 작업이 각각ConversionAdjustmentUploadError.MISSING_ORDER_ID_FOR_WEBPAGE또는ConversionAdjustmentUploadError.CONVERSION_NOT_FOUND오류와 함께 실패합니다.ConversionAdjustment를 만들 때UploadConversionAdjustmentsRequest의partial_failure속성을 항상true로 설정해야 합니다. 유효한 작업과 실패한 작업을 동시에 처리할 때는 부분 실패 가이드라인을 따르세요.ConversionAction는 조정으로 변경할 수 없습니다. 대신RETRACTION를 사용하여 이전 전환을 삭제하고 업데이트된ConversionAction를 사용하여 새 전환을 업로드합니다. 타임스탬프는 수정할 필요가 없습니다. 전환 조정 정보를 참고하세요.