Funktionsweise von erweiterten Conversions für das Web
Für erweiterte Conversions für das Web muss ein Tag eingerichtet werden, über das automatisch eine Klick-ID (z. B. eine GCLID) und eine Bestell-ID an Google Ads, wenn ein Nutzer zu einer Conversion führt. Sie können erweiterte Conversions über Google Tag Manager, die Google -Tag oder die Google Ads API verwenden. Mit der Mit der Google Ads API können Sie eigene Conversion-Daten in maximal 24 Stunden des Conversion-Ereignisses statt zur selben Zeit. So können Sie eigene Daten aus einer Vielzahl von Quellen zu finden, z. B. oder CRM-System.
Die Funktion „Erweiterte Conversions für das Web“ in der Google Ads API ergänzt Schritt 3 unten Ablauf.
Anstatt bei einer Conversion die gehashten Nutzerdaten zu senden, wird das Tag nur die GCLID und die Bestell-ID und Sie gehashte Nutzerdaten senden. indem Sie die Bestell-ID zusammen mit den gehashten Daten hochladen.
Voraussetzungen implementieren
Damit Sie erweiterte Conversions einrichten können, müssen bestimmte Voraussetzungen erfüllt sein. Achten Sie darauf, müssen alle Voraussetzungen erfüllt sein, 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 den 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 die Conversion bestätigen.
Tracking wird durch Abfrage der Ressource Customer
aktiviert
für den ConversionTrackingSetting
.
Senden Sie die folgende Abfrage mit
GoogleAdsService.SearchStream
:
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, das
erstellt und verwaltet Conversions für diesen Kunden. Für Kunden mit
kontoübergreifendem Conversion-Tracking
ist dies die ID eines Verwaltungskontos. Die Kundennummer für Google Ads-Conversions muss
in Google Ads API-Anfragen als customer_id
angegeben, um Conversions zu erstellen und zu verwalten.
Beachten Sie, dass dieses Feld auch dann ausgefüllt wird, wenn das Conversion-Tracking nicht aktiviert ist.
Die
conversion_tracking_status
gibt an, ob Conversion-Tracking aktiviert ist und ob das Konto
verwendet kontoübergreifendes Conversion-Tracking.
Conversion-Aktion unter „Google Ads-Conversion-Kunde“ erstellen
Wenn der Wert von conversion_tracking_status
NOT_CONVERSION_TRACKED
ist,
Conversion-Tracking ist für dieses Konto nicht aktiviert. Conversion-Tracking aktivieren
durch Erstellen von mindestens einem ConversionAction
in
Google Ads-Conversion-Konto verknüpft, wie im folgenden Beispiel gezeigt. Alternativ können Sie
können Sie eine Conversion-Aktion erstellen, indem Sie der Anleitung im
Hilfe für die
Conversion-Typ auswählen, den Sie aktivieren möchten.
Erweiterte Conversions sind automatisch aktiviert, wenn sie über das Google Ads API, können aber über die Google Ads-Benutzeroberfläche deaktiviert werden.
<ph type="x-smartling-placeholder">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.V17.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::V17::Resources::ConversionAction->new({ name => $conversion_action_name, category => DEFAULT, type => WEBPAGE, status => ENABLED, viewThroughLookbackWindowDays => 15, valueSettings => Google::Ads::GoogleAds::V17::Resources::ValueSettings->new({ defaultValue => 23.41, alwaysUseDefaultValue => "true" })}); # Create a conversion action operation. my $conversion_action_operation = Google::Ads::GoogleAds::V17::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; }
Achte darauf, dass conversion_action_type
auf die richtige
ConversionActionType
-Wert.
Weitere Informationen zum Erstellen von Conversion-Aktionen in der Google Ads API finden Sie unter Conversion-Aktionen erstellen.
Vorhandene Conversion-Aktion abrufen
Sie können Details zu einer Conversion-Aktion abrufen, indem Sie den
folgenden Abfrage aus. Achten Sie darauf, dass die Kundennummer in der Anfrage auf die Google Ads-
Conversion-Kunde, den Sie oben angegeben haben, und der Typ der Conversion-Aktion festgelegt ist
in das richtige
ConversionActionType
Wert.
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 verwenden können für das Web. Sie können prüfen, ob die Nutzungsbedingungen für Kundendaten akzeptiert wurden: Senden der folgenden Anfrage an den Google Ads-Conversion-Kunden:
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
Google Ads-Hilfe
um diese Voraussetzung zu erfüllen.
3. Tagging konfigurieren
Sie können die Tag-Kennzeichnung für Ihre Website konfigurieren, indem Sie der Anleitung in der Hilfe:
Sie müssen Ihrer Conversion auch Transaktions-IDs (auch Bestell-IDs genannt) hinzufügen. mithilfe der Anleitung im Artikel Google Analytics- . Für Google Ads sind diese um die zu optimierende Conversion zu finden.
Nächste Schritte
Sobald Sie die Voraussetzungen erfüllt haben, können Sie erweiterte für das Web in den Google Ads API