Funktionsweise von erweiterten Conversions für das Web
Für erweiterte Conversions für das Web muss ein Tag eingerichtet werden, das automatisch eine Klick-ID, z. B. eine GCLID, und eine Bestell-ID an Google Ads sendet, wenn ein Nutzer eine Conversion ausführt. Sie können erweiterte Conversions über Google Tag Manager, das Google-Tag oder die Google Ads API einrichten. Wenn Sie die Google Ads API verwenden, haben Sie den Vorteil, dass eigene Conversion-Daten innerhalb von 24 Stunden nach dem Conversion-Ereignis gesendet werden anstatt gleichzeitig. So lassen sich selbst erhobene Daten aus einer Vielzahl von Quellen finden, z. B. aus einer Kundendatenbank oder einem CRM-System.
Die Funktion „Erweiterte Conversions für das Web“ in der Google Ads API ergänzt Schritt 3 im folgenden Ablauf.
Anstatt die gehashten Nutzerinformationen zu senden, wenn der Nutzer eine Conversion ausführt, sendet das Tag nur die GCLID und die Bestell-ID. Sie senden später gehashte Nutzerinformationen, indem Sie die Bestell-ID zusammen mit den gehashten Daten hochladen.
Voraussetzungen implementieren
Damit die erweiterten Conversions richtig eingerichtet werden können, müssen bestimmte Voraussetzungen erfüllt sein. Prüfen Sie, ob alle Voraussetzungen erfüllt sind, bevor Sie mit der Implementierung fortfahren:
Aktivieren Sie Conversion-Tracking für Ihren Google Ads-Conversion-Kunden.
Akzeptieren Sie die Nutzungsbedingungen für Kundendaten.
Konfigurieren Sie das Tagging.
1. Conversion-Tracking für Google Ads-Conversion-Kunden aktivieren
Informationen zur Einrichtung des Conversion-Trackings abrufen
Sie können die Einrichtung des Conversion-Trackings in Ihrem Konto prüfen und bestätigen, dass Conversion-Tracking aktiviert ist. Fragen Sie dazu die Ressource Customer für die ConversionTrackingSetting ab.
Führen Sie die folgende Abfrage mit GoogleAdsService.SearchStream aus:
SELECT
customer.conversion_tracking_setting.google_ads_conversion_customer,
customer.conversion_tracking_setting.conversion_tracking_status,
customer.conversion_tracking_setting.conversion_tracking_id,
customer.conversion_tracking_setting.cross_account_conversion_tracking_id
FROM customer
Das Feld google_ads_conversion_customer gibt das Google Ads-Konto an, in dem Conversions für diesen Kunden erstellt und verwaltet werden. Für Kunden, die kontoübergreifendes Conversion-Tracking verwenden, ist dies die ID eines Verwaltungskontos. Die Kundennummer der Google Ads-Conversion sollte in Google Ads API-Anfragen als customer_id angegeben werden, um Conversions zu erstellen und zu verwalten.
Dieses Feld wird auch dann ausgefüllt, wenn Conversion-Tracking nicht aktiviert ist.
Im Feld conversion_tracking_status wird angegeben, ob Conversion-Tracking aktiviert ist und ob für das Konto kontoübergreifendes Conversion-Tracking verwendet wird.
Conversion-Aktion unter dem Google Ads-Conversion-Kunden erstellen
Wenn der Wert von conversion_tracking_status auf NOT_CONVERSION_TRACKED gesetzt ist, ist Conversion-Tracking für das Konto nicht aktiviert. Aktivieren Sie Conversion-Tracking, indem Sie wie im folgenden Beispiel mindestens ein ConversionAction im Google Ads-Conversion-Konto erstellen. Alternativ können Sie eine Conversion-Aktion in der Benutzeroberfläche erstellen. Folgen Sie dazu der Anleitung in der Hilfe für den Conversion-Typ, den Sie aktivieren möchten.
Erweiterte Conversions werden automatisch aktiviert, wenn sie über die Google Ads API gesendet werden. Sie können jedoch über die Google Ads-Benutzeroberfläche deaktiviert werden.
Codebeispiel
Java
private void runExample(GoogleAdsClient googleAdsClient, long customerId) {
// Creates a ConversionAction.
ConversionAction conversionAction =
ConversionAction.newBuilder()
// Note that conversion action names must be unique. If a conversion action already
// exists with the specified conversion_action_name the create operation will fail with
// a ConversionActionError.DUPLICATE_NAME error.
.setName("Earth to Mars Cruises Conversion #" + getPrintableDateTime())
.setCategory(ConversionActionCategory.DEFAULT)
.setType(ConversionActionType.WEBPAGE)
.setStatus(ConversionActionStatus.ENABLED)
.setViewThroughLookbackWindowDays(15L)
.setValueSettings(
ValueSettings.newBuilder()
.setDefaultValue(23.41)
.setAlwaysUseDefaultValue(true)
.build())
.build();
// Creates the operation.
ConversionActionOperation operation =
ConversionActionOperation.newBuilder().setCreate(conversionAction).build();
try (ConversionActionServiceClient conversionActionServiceClient =
googleAdsClient.getLatestVersion().createConversionActionServiceClient()) {
MutateConversionActionsResponse response =
conversionActionServiceClient.mutateConversionActions(
Long.toString(customerId), Collections.singletonList(operation));
System.out.printf("Added %d conversion actions:%n", response.getResultsCount());
for (MutateConversionActionResult result : response.getResultsList()) {
System.out.printf(
"New conversion action added with resource name: '%s'%n", result.getResourceName());
}
}
}
C#
public void Run(GoogleAdsClient client, long customerId)
{
// Get the ConversionActionService.
ConversionActionServiceClient conversionActionService =
client.GetService(Services.V16.ConversionActionService);
// Note that conversion action names must be unique.
// If a conversion action already exists with the specified name the create operation
// will fail with a ConversionAction.DUPLICATE_NAME error.
string ConversionActionName = "Earth to Mars Cruises Conversion #"
+ ExampleUtilities.GetRandomString();
// Add a conversion action.
ConversionAction conversionAction = new ConversionAction()
{
Name = ConversionActionName,
Category = ConversionActionCategory.Default,
Type = ConversionActionType.Webpage,
Status = ConversionActionStatus.Enabled,
ViewThroughLookbackWindowDays = 15,
ValueSettings = new ConversionAction.Types.ValueSettings()
{
DefaultValue = 23.41,
AlwaysUseDefaultValue = true
}
};
// Create the operation.
ConversionActionOperation operation = new ConversionActionOperation()
{
Create = conversionAction
};
try
{
// Create the conversion action.
MutateConversionActionsResponse response =
conversionActionService.MutateConversionActions(customerId.ToString(),
new ConversionActionOperation[] { operation });
// Display the results.
foreach (MutateConversionActionResult newConversionAction in response.Results)
{
Console.WriteLine($"New conversion action with resource name = " +
$"'{newConversionAction.ResourceName}' was added.");
}
}
catch (GoogleAdsException e)
{
Console.WriteLine("Failure:");
Console.WriteLine($"Message: {e.Message}");
Console.WriteLine($"Failure: {e.Failure}");
Console.WriteLine($"Request ID: {e.RequestId}");
throw;
}
}
PHP
public static function runExample(GoogleAdsClient $googleAdsClient, int $customerId)
{
// Creates a conversion action.
$conversionAction = new ConversionAction([
// Note that conversion action names must be unique.
// If a conversion action already exists with the specified conversion_action_name
// the create operation will fail with a ConversionActionError.DUPLICATE_NAME error.
'name' => 'Earth to Mars Cruises Conversion #' . Helper::getPrintableDatetime(),
'category' => ConversionActionCategory::PBDEFAULT,
'type' => ConversionActionType::WEBPAGE,
'status' => ConversionActionStatus::ENABLED,
'view_through_lookback_window_days' => 15,
'value_settings' => new ValueSettings([
'default_value' => 23.41,
'always_use_default_value' => true
])
]);
// Creates a conversion action operation.
$conversionActionOperation = new ConversionActionOperation();
$conversionActionOperation->setCreate($conversionAction);
// Issues a mutate request to add the conversion action.
$conversionActionServiceClient = $googleAdsClient->getConversionActionServiceClient();
$response = $conversionActionServiceClient->mutateConversionActions(
MutateConversionActionsRequest::build($customerId, [$conversionActionOperation])
);
printf("Added %d conversion actions:%s", $response->getResults()->count(), PHP_EOL);
foreach ($response->getResults() as $addedConversionAction) {
/** @var ConversionAction $addedConversionAction */
printf(
"New conversion action added with resource name: '%s'%s",
$addedConversionAction->getResourceName(),
PHP_EOL
);
}
}
Python
def main(client, customer_id):
conversion_action_service = client.get_service("ConversionActionService")
# Create the operation.
conversion_action_operation = client.get_type("ConversionActionOperation")
# Create conversion action.
conversion_action = conversion_action_operation.create
# Note that conversion action names must be unique. If a conversion action
# already exists with the specified conversion_action_name, the create
# operation will fail with a ConversionActionError.DUPLICATE_NAME error.
conversion_action.name = f"Earth to Mars Cruises Conversion {uuid.uuid4()}"
conversion_action.type_ = (
client.enums.ConversionActionTypeEnum.UPLOAD_CLICKS
)
conversion_action.category = (
client.enums.ConversionActionCategoryEnum.DEFAULT
)
conversion_action.status = client.enums.ConversionActionStatusEnum.ENABLED
conversion_action.view_through_lookback_window_days = 15
# Create a value settings object.
value_settings = conversion_action.value_settings
value_settings.default_value = 15.0
value_settings.always_use_default_value = True
# Add the conversion action.
conversion_action_response = (
conversion_action_service.mutate_conversion_actions(
customer_id=customer_id,
operations=[conversion_action_operation],
)
)
print(
"Created conversion action "
f'"{conversion_action_response.results[0].resource_name}".'
)
Ruby
def add_conversion_action(customer_id)
# GoogleAdsClient will read a config file from
# ENV['HOME']/google_ads_config.rb when called without parameters
client = Google::Ads::GoogleAds::GoogleAdsClient.new
# Add a conversion action.
conversion_action = client.resource.conversion_action do |ca|
ca.name = "Earth to Mars Cruises Conversion #{(Time.new.to_f * 100).to_i}"
ca.type = :UPLOAD_CLICKS
ca.category = :DEFAULT
ca.status = :ENABLED
ca.view_through_lookback_window_days = 15
# Create a value settings object.
ca.value_settings = client.resource.value_settings do |vs|
vs.default_value = 15
vs.always_use_default_value = true
end
end
# Create the operation.
conversion_action_operation = client.operation.create_resource.conversion_action(conversion_action)
# Add the ad group ad.
response = client.service.conversion_action.mutate_conversion_actions(
customer_id: customer_id,
operations: [conversion_action_operation],
)
puts "New conversion action with resource name = #{response.results.first.resource_name}."
end
Perl
sub add_conversion_action {
my ($api_client, $customer_id) = @_;
# Note that conversion action names must be unique.
# If a conversion action already exists with the specified conversion_action_name,
# the create operation fails with error ConversionActionError.DUPLICATE_NAME.
my $conversion_action_name = "Earth to Mars Cruises Conversion #" . uniqid();
# Create a conversion action.
my $conversion_action =
Google::Ads::GoogleAds::V16::Resources::ConversionAction->new({
name => $conversion_action_name,
category => DEFAULT,
type => WEBPAGE,
status => ENABLED,
viewThroughLookbackWindowDays => 15,
valueSettings =>
Google::Ads::GoogleAds::V16::Resources::ValueSettings->new({
defaultValue => 23.41,
alwaysUseDefaultValue => "true"
})});
# Create a conversion action operation.
my $conversion_action_operation =
Google::Ads::GoogleAds::V16::Services::ConversionActionService::ConversionActionOperation
->new({create => $conversion_action});
# Add the conversion action.
my $conversion_actions_response =
$api_client->ConversionActionService()->mutate({
customerId => $customer_id,
operations => [$conversion_action_operation]});
printf "New conversion action added with resource name: '%s'.\n",
$conversion_actions_response->{results}[0]{resourceName};
return 1;
}
Achten Sie darauf, dass conversion_action_type auf den richtigen ConversionActionType-Wert festgelegt ist.
Weitere Informationen zum Erstellen von Conversion-Aktionen in der Google Ads API finden Sie unter Conversion-Aktionen erstellen.
Vorhandene Conversion-Aktion abrufen
Mit der folgenden Abfrage können Sie Details zu einer vorhandenen Conversion-Aktion abrufen. Achten Sie darauf, dass die Kundennummer in der Anfrage auf den oben angegebenen Google Ads-Conversion-Kunden und den Typ der Conversion-Aktion auf den richtigen ConversionActionType-Wert festgelegt ist.
SELECT
conversion_action.resource_name,
conversion_action.name,
conversion_action.status
FROM conversion_action
WHERE conversion_action.type = 'WEBPAGE'
2. Nutzungsbedingungen für Kundendaten akzeptieren
Sie müssen die Nutzungsbedingungen für Kundendaten akzeptieren, bevor Sie erweiterte Conversions für das Web verwenden können. Sie können überprüfen, ob die Nutzungsbedingungen für Kundendaten akzeptiert wurden, indem Sie die folgende Abfrage an den Google Ads-Conversion-Kunden senden:
SELECT
customer.id,
customer.conversion_tracking_setting.accepted_customer_data_terms
FROM customer
Wenn accepted_customer_data_terms den Wert false hat, folgen Sie der Anleitung in der Hilfe, um diese Voraussetzung zu erfüllen.
3. Tagging konfigurieren
Sie können das Tagging für Ihre Website konfigurieren, indem Sie der Anleitung in der Hilfe folgen.
Außerdem müssen Ihrem Conversion-Tracking-Tag Transaktions-IDs (auch Bestell-IDs genannt) hinzugefügt werden. Folgen Sie dazu der Anleitung in der Hilfe. Diese sind erforderlich, um die zu optimierende Conversion in Google Ads zu finden.
Nächste Schritte
Sobald Sie die Voraussetzungen erfüllen, können Sie erweiterte Conversions für das Web in der Google Ads API implementieren.