Erste Schritte mit 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 wie eine GCLID und eine Bestell-ID an Google Ads gesendet werden, 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 Sie Conversion-Daten innerhalb von 24 Stunden nach dem Conversion-Ereignis senden können, anstatt gleichzeitig. So können Sie selbst erhobene Daten aus einer Vielzahl von Quellen nutzen, wie etwa aus einer Kundendatenbank oder einem CRM-System.

Funktionsweise von erweiterten Conversions für das Web

Erweiterte Conversions für das Web in der Google Ads API ergänzen 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. Die gehashten Nutzerinformationen werden später gesendet, indem Sie die Bestell-ID zusammen mit den gehashten Daten hochladen. Weitere Informationen zu erweiterten Conversions für das Web finden Sie in der Google Ads-Hilfe.

Erweiterte Conversions für das Web

Voraussetzungen implementieren

Für eine funktionierende Einrichtung erweiterter Conversions sind einige Voraussetzungen zu erfüllen. Prüfen Sie, ob alle Voraussetzungen erfüllt sind, bevor Sie mit der Implementierung fortfahren:

  1. Aktivieren Sie das Conversion-Tracking für Ihren Google Ads-Conversion-Kunden.

  2. Akzeptieren Sie die Nutzungsbedingungen für Kundendaten.

  3. Tagging konfigurieren

1. Conversion-Tracking für Ihren Google Ads-Conversion-Kunden aktivieren

Informationen zur Konfiguration des Conversion-Trackings abrufen

Sie können die Einrichtung des Conversion-Trackings in Ihrem Konto prüfen und bestätigen, dass das Conversion-Tracking aktiviert ist. Rufen Sie dazu die Ressource Customer für 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

Im Feld google_ads_conversion_customer wird das Google Ads-Konto angegeben, in dem Conversions für diesen Kunden erstellt und verwaltet werden. Bei Kunden, die kontoübergreifendes Conversion-Tracking verwenden, ist dies die ID eines Verwaltungskontos. Die Google Ads-Conversion-Kundennummer muss 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 das Conversion-Tracking nicht aktiviert ist.

Im Feld conversion_tracking_status wird angegeben, ob das Conversion-Tracking aktiviert ist und ob im Konto das kontoübergreifende Conversion-Tracking verwendet wird.

Conversion-Aktion für den Google Ads-Conversion-Kunden erstellen

Wenn der Wert für conversion_tracking_status NOT_CONVERSION_TRACKED ist, ist das Conversion-Tracking für das Konto nicht aktiviert. Aktivieren Sie das Conversion-Tracking, indem Sie im Google Ads-Conversion-Konto mindestens eine ConversionAction erstellen, wie im folgenden Beispiel. Alternativ können Sie eine Conversion-Aktion auch über die Benutzeroberfläche erstellen. Folgen Sie dazu der Anleitung in der Google Ads-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 sie aber über die Google Ads-Benutzeroberfläche deaktivieren.

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());
    }
  }
}
AddConversionAction.java

C#

public void Run(GoogleAdsClient client, long customerId)
{
    // Get the ConversionActionService.
    ConversionActionServiceClient conversionActionService =
        client.GetService(Services.V18.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;
    }
}
AddConversionAction.cs

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
        );
    }
}
AddConversionAction.php

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}".'
    )
add_conversion_action.py

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
add_conversion_action.rb

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::V18::Resources::ConversionAction->new({
      name                          => $conversion_action_name,
      category                      => DEFAULT,
      type                          => WEBPAGE,
      status                        => ENABLED,
      viewThroughLookbackWindowDays => 15,
      valueSettings                 =>
        Google::Ads::GoogleAds::V18::Resources::ValueSettings->new({
          defaultValue          => 23.41,
          alwaysUseDefaultValue => "true"
        })});

  # Create a conversion action operation.
  my $conversion_action_operation =
    Google::Ads::GoogleAds::V18::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;
}
add_conversion_action.pl

Achten Sie darauf, dass conversion_action_type auf den richtigen Wert ConversionActionType 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 in der Anfrage die Kundennummer des Google Ads-Conversion-Kunden festgelegt ist, den Sie oben angegeben haben, und dass der Conversion-Aktionstyp den richtigen Wert ConversionActionType hat.

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 prü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 = false ist, folgen Sie der Anleitung in der Google Ads-Hilfe, um diese Voraussetzung zu erfüllen.

3. Tagging konfigurieren

Eine Anleitung zum Konfigurieren des Taggings für Ihre Website finden Sie in der Hilfe. Wir empfehlen Ihnen, Ihrem Conversion-Tracking-Tag auch Transaktions-IDs (Bestell-IDs) hinzuzufügen, um die Conversion-Abgleiche zu unterstützen.

Nächste Schritte

Sobald Sie die Voraussetzungen erfüllt haben, können Sie erweiterte Conversions für das Web in der Google Ads API implementieren.

Zurück
Übersicht
Weiter
Implementierung