Erste Schritte

Sie müssen Conversion-Tracking in Ihrem Google Ads-Conversion-Konto aktivieren, um Conversions zu erfassen. In diesem Leitfaden erfahren Sie, wie Sie prüfen, ob das Conversion-Tracking aktiviert ist, wie Sie es aktivieren, falls es noch nicht aktiviert ist, und wie Sie Informationen zu vorhandenen Conversion-Aktionen abrufen.

Für die meisten Conversion-Aktionen sind zusätzliche Schritte erforderlich, damit sie erfasst werden können. Weitere Informationen zu den verschiedenen Conversion-Aktionstypen und ihren Anforderungen finden Sie unter Conversion-Aktionskategorien und Conversion-Aktionen erstellen.

Wenn Sie Conversions oder Nutzerdaten importieren, müssen Sie bestätigen, dass Sie berechtigt sind, Conversion-Daten mit Google zu teilen. Dafür stehen Ihnen zwei Möglichkeiten zur Verfügung:

  1. Konfigurieren Sie die Standardeinstellungen für die Einwilligung auf Kontoebene. Klicken Sie in der Google Ads-Benutzeroberfläche auf Tools > Data Manager > Einwilligungseinstellungen > Standardeinstellungen für die Einwilligung.
  2. Legen Sie das Einwilligungsfeld für jede importierte Conversion oder Nutzernutzlast fest (z. B. ClickConversion.consent, CallConversion.consent oder UserData.consent).

Website für das Conversion-Tracking einrichten

Wenn Sie Website-Conversions erfassen oder erweiterte Conversions für Leads implementieren, müssen Sie zuerst das Website-Tagging konfigurieren. Folgen Sie der Anleitung unter Google-Tag für erweiterte Conversions für Leads konfigurieren oder verwenden Sie Google Tag Manager, indem Sie der Anleitung unter Google Tag Manager für erweiterte Conversions für Leads konfigurieren folgen.

Conversion-Tracking in Ihrem Google Ads-Conversion-Konto aktivieren

So überprüfen Sie die Einrichtung des Conversion-Trackings für Ihr Konto und erstellen oder rufen Conversion-Aktionen ab:

Conversion-Tracking 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 es aktiviert ist, indem Sie die Ressource Customer für ConversionTrackingSetting abfragen. 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, über das 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 sollte in Google Ads API-Anfragen zum Erstellen und Verwalten von Conversions als customer_id angegeben werden. Dieses Feld wird auch dann ausgefüllt, wenn das Conversion-Tracking nicht aktiviert ist.

Das Feld conversion_tracking_status gibt an, 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 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 in der Benutzeroberfläche erstellen. Folgen Sie dazu der Anleitung im Google Ads-Hilfeartikel zum Einrichten des Conversion-Trackings 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());
    }
  }
}

C#

public void Run(GoogleAdsClient client, long customerId)
{
    // Get the ConversionActionService.
    ConversionActionServiceClient conversionActionService =
        client.GetService(Services.V26.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: GoogleAdsClient, customer_id: str) -> None:
    conversion_action_service: ConversionActionServiceClient = (
        client.get_service("ConversionActionService")
    )

    # Create the operation.
    conversion_action_operation: ConversionActionOperation = client.get_type(
        "ConversionActionOperation"
    )

    # Create conversion action.
    conversion_action: ConversionAction = 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: ConversionAction.ValueSettings = (
        conversion_action.value_settings
    )
    value_settings.default_value = 15.0
    value_settings.always_use_default_value = True

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

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

curl

Achten Sie darauf, dass 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 Google Ads-Conversion-Kunden festgelegt ist, den Sie zuvor ermittelt haben, und dass der Conversion-Aktionstyp auf den richtigen ConversionActionType-Wert festgelegt ist.

SELECT
  conversion_action.id,
  conversion_action.resource_name,
  conversion_action.name,
  conversion_action.type,
  conversion_action.category,
  conversion_action.status
FROM conversion_action

WHERE conversion_action.type = 'INSERT_CONVERSION_ACTION_TYPE'

Kontoübergreifendes Conversion-Tracking

Mit dem kontoübergreifenden Conversion-Tracking können Google Ads-Konten Conversions im Namen anderer Konten importieren, über die möglicherweise die Anzeigen ausgeliefert wurden, die zu Conversions geführt haben. So können Sie die Integration vereinfachen, indem Sie die Konten konsolidieren, die Importanfragen stellen.

Kontoübergreifendes Conversion-Tracking in der Google Ads API aktivieren

Sie können die Google Ads API verwenden, um das kontoübergreifende Conversion-Tracking beim Erstellen oder Aktualisieren von Kundenkonten zu aktivieren.

Legen Sie für eine Customer-Ressource das Feld conversion_tracking_setting.google_ads_conversion_customer auf den Ressourcennamen des Verwaltungskontos fest, das Conversion-Aktionen im Namen des Kundenkontos verwalten soll.

Anfragen, mit denen der Conversion-Kunde eines Kundenkontos geändert wird, müssen vom Verwaltungskonto gesendet werden, das der neue Conversion-Kunde für den Kunden wird. Dazu müssen Sie login-customer-id auf die ID des Verwaltungskontos festlegen.

Wenn Sie kontoübergreifendes Conversion-Tracking aktivieren oder das Verwaltungskonto für das Conversion-Tracking für ein bestehendes Kundenkonto ändern, gelten dieselben Einschränkungen wie bei einer Änderung in der Benutzeroberfläche. Im Detail:

  • Für das Kundenkonto werden die Standard-Conversion-Wert-Regeln und die Standard-Zielvorhaben für den Kundenlebenszyklus des neuen Conversion-Tracking-Verwaltungskontos übernommen.
  • Kampagnen, die auf eine bestimmte Conversion-Aktion ausgerichtet sind, werden auf die Standard-Conversion-Zielvorhaben des Conversion-Verwaltungskontos umgestellt. Wenn Sie weiterhin auf eine bestimmte Conversion-Aktion ausrichten, kann dies zu inkonsistentem Verhalten führen, da das Verwaltungskonto möglicherweise nicht dieselben Zielvorhaben wie das Kundenkonto hat. Achten Sie darauf, dass Ihre Kampagnen für die richtigen Zielvorhaben optimiert sind.
  • Wenn ein Konto zu mehr als einem Verwaltungskonto gehört, können nur Conversion-Aktionen von einem Verwaltungskonto verwendet werden. Wenn kein Conversion-Tracking-Konto angegeben ist, wird das Konto standardmäßig als Conversion-Tracking-Konto verwendet.

Conversions kontenübergreifend importieren

Wenn das kontoübergreifende Tracking aktiviert ist, können in Kunden- und Verwaltungskonten Conversions im Namen des Kontos zur Anzeigenauslieferung importiert werden. So lässt sich die Importlogik vereinfachen, weil Sie beim Import nicht für jede Conversion das Konto zur Anzeigenauslieferung bestimmen müssen. Sie können einfach ein Konto aus Ihrer Kontostruktur auswählen, um alle Conversions zu importieren.

Damit eine Conversion hochgeladen werden kann, muss das Konto, über das der Upload erfolgt, Zugriff auf die Conversion-Aktion haben. In einer kontoübergreifenden Tracking-Hierarchie hat das Konto, über das der Upload erfolgt, Zugriff auf die Aktion, wenn es ein übergeordnetes Konto (Verwaltungskonto) oder ein untergeordnetes Konto des Inhabers der Conversion-Aktion in der Kontostruktur ist.

Das folgende Diagramm veranschaulicht die Autorisierungsstruktur für den Import von Conversions. C1 ist das Kundenkonto, über das die Anzeige ausgeliefert wurde, die die Conversion generiert hat. M2 ist der Inhaber der Conversion-Aktion und das übergeordnete Conversion-Tracking-Konto von C1. Die grün hervorgehobenen Konten dürfen Conversions im Namen von C1 importieren, die rot hervorgehobenen Konten nicht.

Autorisierungsstruktur

Conversion-Aktionen erstellen

Wenn Sie Conversions erfassen möchten, richten Sie ein ConversionAction für die type der Conversion-Aktion ein, die Sie erfassen möchten. Für einen Onlinekauf und einen Telefonanruf sind beispielsweise unterschiedliche Conversion-Aktionen erforderlich.

Am besten richten Sie neue Conversion-Aktionen in der API mit dem Codebeispiel zum Hinzufügen von Conversion-Aktionen ein. Das Beispiel übernimmt alle Authentifizierungsaufgaben im Hintergrund und führt Sie durch die Erstellung eines ConversionAction.

Für die meisten Conversion-Aktionen sind zusätzliche Schritte erforderlich, damit sie erfasst werden können. Wenn Sie beispielsweise Conversions auf Ihrer Website erfassen möchten, müssen Sie ein Code-Snippet, das als Tag bezeichnet wird, auf der Conversion-Seite Ihrer Website einfügen. Detaillierte Anforderungen für andere Conversion-Aktionstypen finden Sie im Google Ads-Hilfeartikel zu Conversion-Typen.

Wenn Sie kontoübergreifendes Conversion-Tracking verwenden, werden mit ConversionActionService die folgenden Conversion-Aktionen zurückgegeben:

  • Alle Conversion-Aktionen, die im Verwaltungskonto definiert sind und vom Konto für das kontoübergreifende Conversion-Tracking verwendet werden
  • Alle Conversion-Aktionen, für die der Kunde Statistiken erfasst hat, einschließlich systemdefinierter Aktionen und Aktionen, die dem Manager gehören, auch wenn die Verknüpfung später aufgehoben wird.
  • Alle Aktionen, die der Kunde in seinem eigenen Konto definiert hat
  • Analytics-Conversions, die in verknüpften Google Analytics-Properties erstellt wurden. Dazu gehören Aktionen für Analytics-Conversions, die nicht in Google Ads importiert wurden und den Status HIDDEN haben.

Codebeispiel

Im folgenden Codebeispiel wird gezeigt, wie Sie eine neue Conversion-Aktion erstellen. Dabei wird eine Conversion-Aktion erstellt, bei der type auf UPLOAD_CLICKS festgelegt ist. Außerdem wird category auf DEFAULT gesetzt.

Es gelten die folgenden Standardeinstellungen:

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.V26.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: GoogleAdsClient, customer_id: str) -> None:
    conversion_action_service: ConversionActionServiceClient = (
        client.get_service("ConversionActionService")
    )

    # Create the operation.
    conversion_action_operation: ConversionActionOperation = client.get_type(
        "ConversionActionOperation"
    )

    # Create conversion action.
    conversion_action: ConversionAction = 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: ConversionAction.ValueSettings = (
        conversion_action.value_settings
    )
    value_settings.default_value = 15.0
    value_settings.always_use_default_value = True

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

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

curl

Sie finden dieses Beispiel im Remarketing-Ordner Ihrer Clientbibliothek und in der Sammlung von Codebeispielen: Codebeispiel „Conversion-Aktion hinzufügen“.

Referenz für das Feld ConversionActionService.MutateConversionActions

Verwenden Sie MutateConversionActions für ConversionActionService, um Conversion-Aktionen für das Google Ads-Conversion-Kundenkonto zu erstellen, zu aktualisieren oder zu entfernen:

POST https://googleads.googleapis.com/v26/customers/{customer_id}/conversionActions:mutate

In der folgenden Tabelle sind die Anfrage- und Vorgangsfelder der obersten Ebene für MutateConversionActionsRequest aufgeführt:

Feld Anforderung Beschreibung
customer_id Erforderlich Die zehnstellige ID (string) des Google Ads-Conversion-Kunden (google_ads_conversion_customer) ohne Bindestriche.
partial_failure Optional Bei true (bool) werden gültige Vorgänge ausgeführt und bei fehlgeschlagenen Vorgängen werden Fehler in partial_failure_error zurückgegeben. Die Standardeinstellung ist false.
validate_only Optional Wenn true (bool), wird die Anfrage validiert, ohne Mutationen auszuführen.
response_content_type Optional ResponseContentType, um zu steuern, ob die Antwort nur resource_name (RESOURCE_NAME_ONLY, Standard) oder das mutierte ConversionAction-Objekt (MUTABLE_RESOURCE) zurückgibt.
operations[].create Erforderlich (bei Erstellung) Die zu erstellende ConversionAction-Ressource. Es wird kein resource_name erwartet.
operations[].update Erforderlich (bei Aktualisierung) Die zu aktualisierende ConversionAction-Ressource (muss resource_name und ein gleichgeordnetes Element update_mask für ConversionActionOperation enthalten).
operations[].update_mask Erforderlich (bei Update) FieldMask (durch Kommas getrennte Liste der geänderten ConversionAction-Feldpfade in snake_case; REST JSON updateMask akzeptiert snake_case oder camelCase, während gRPC und Clientbibliotheken snake_case erfordern) für die ConversionActionOperation (Geschwister von update, nicht in ConversionAction verschachtelt).
operations[].remove Erforderlich (beim Entfernen) Ressourcenname (customers/{customer_id}/conversionActions/{action_id}) der zu entfernenden Conversion-Aktion.

Beachten Sie beim Konfigurieren eines ConversionAction in operations[].create oder operations[].update die folgenden Feldanforderungen und Einschränkungen für die Veränderbarkeit (typspezifische Fehlerregeln finden Sie unter Validierungen):

Feld ConversionAction Anforderung und Veränderlichkeit Beschreibung
name Erforderlich (veränderlich) Eindeutiger Anzeigename (string) im Conversion-Kundenkonto.
type Erforderlich am create (IMMUTABLE) ConversionActionType (z. B. WEBPAGE, UPLOAD_CLICKS, UPLOAD_CALLS, AD_CALL oder WEBSITE_CALL).
category Optional (veränderlich) ConversionActionCategory (z. B. DEFAULT, PURCHASE, SUBMIT_LEAD_FORM, SIGNUP oder PHONE_CALL_LEAD). Die Standardeinstellung ist DEFAULT.
status Optional (veränderlich) ConversionActionStatus (ENABLED, REMOVED oder HIDDEN). Der Standardwert ist ENABLED.
primary_for_goal Optional (veränderlich) bool, mit dem gesteuert wird, ob die Aktion in Standard-Conversion-Zielvorhaben auf Kunden- und Kampagnenebene gebotsfähig ist (Hinweis: CustomConversionGoal-Ressourcen ignorieren diese Einstellung). Die Standardeinstellung ist true.
counting_type Optional (veränderlich) ConversionActionCountingType (MANY_PER_CLICK-Standard oder ONE_PER_CLICK).
value_settings Optional (veränderlich) ValueSettings (default_value, default_currency_code, always_use_default_value).
attribution_model_settings Optional (veränderlich) AttributionModelSettings (attribution_model: GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN Standard oder GOOGLE_ADS_LAST_CLICK).
click_through_lookback_window_days Optional (veränderlich) int64 Lookback-Window für Klickrate in Tagen (1 bis 90 für die meisten Typen; 1 bis 60 für Anruftypen).
view_through_lookback_window_days Optional (veränderlich) int64 View-through-Lookback-Window in Tagen (1 bis 30 für die meisten Typen; nicht festgelegt für Anruftypen).
phone_call_duration_seconds Nur Aufruftypen (veränderlich) int64 Mindestanrufdauer in Sekunden (0 bis 10000).
app_id Nur App-Typen (nach dem Erstellen nicht mehr veränderbar) Kennung für mobile Apps (string): Kann nur für App-Conversion-Aktionen in create festgelegt werden.
include_in_conversions_metric Schreibgeschützt in Mutationen Kann nicht direkt geändert werden. Konfigurieren Sie stattdessen primary_for_goal.
tag_snippets[] OUTPUT_ONLY Code-Snippets für das Website-Tracking (TagSnippet) wurden für WEBPAGE Conversion-Aktionen eingefügt.

REST-Anfrage- und Antwortstruktur

Wenn Sie eine ConversionAction-Ressource über REST erstellen oder aktualisieren möchten, senden Sie eine POST-Anfrage an ConversionActionService.MutateConversionActions. Wenn Sie eine vorhandene Conversion-Aktion aktualisieren, geben Sie updateMask im Vorgangsobjekt als gleichgeordnetes Element von update an:

POST https://googleads.googleapis.com/v26/customers/{customer_id}/conversionActions:mutate

{
  "operations": [
    {
      "create": {
        "name": "Earth to Mars Cruise Conversion",
        "type": "UPLOAD_CLICKS",
        "category": "DEFAULT",
        "status": "ENABLED",
        "primaryForGoal": true,
        "countingType": "ONE_PER_CLICK",
        "clickThroughLookbackWindowDays": "60",
        "valueSettings": {
          "defaultValue": 23.41,
          "defaultCurrencyCode": "USD",
          "alwaysUseDefaultValue": true
        }
      }
    },
    {
      "updateMask": "primary_for_goal,value_settings.default_value",
      "update": {
        "resourceName": "customers/{customer_id}/conversionActions/6666666666",
        "primaryForGoal": false,
        "valueSettings": {
          "defaultValue": 45.00
        }
      }
    }
  ]
}

Eine erfolgreiche Antwort gibt MutateConversionActionResult-Einträge in results[] zurück:

{
  "results": [
    {
      "resourceName": "customers/{customer_id}/conversionActions/7777777777"
    },
    {
      "resourceName": "customers/{customer_id}/conversionActions/6666666666"
    }
  ]
}

Conversion-Aktionseinstellungen und Tag-Snippets mit GAQL prüfen

Zusätzlich zur grundlegenden Abfrage, die unter Schritte zum Aktivieren des Conversion-Trackings beschrieben wird, können Sie die Ressource conversion_action mit GoogleAdsService.SearchStream abfragen, um primary_for_goal, den Status des Attributionsmodells, Lookback-Windows, Werteinstellungen und die Website-tag_snippets zu prüfen:

SELECT
  conversion_action.id,
  conversion_action.resource_name,
  conversion_action.name,
  conversion_action.type,
  conversion_action.category,
  conversion_action.status,
  conversion_action.primary_for_goal,
  conversion_action.counting_type,
  conversion_action.click_through_lookback_window_days,
  conversion_action.view_through_lookback_window_days,
  conversion_action.value_settings.default_value,
  conversion_action.value_settings.default_currency_code,
  conversion_action.value_settings.always_use_default_value,
  conversion_action.attribution_model_settings.attribution_model,
  conversion_action.attribution_model_settings.data_driven_model_status,
  conversion_action.tag_snippets
FROM conversion_action
WHERE conversion_action.status = 'ENABLED'

Validierungen

Google Ads und die Google Ads API unterstützen eine Vielzahl von Conversion-Aktionen. Daher variieren einige Validierungsregeln je nach type der Aktion.

Der mit Abstand häufigste Fehler beim Erstellen einer Conversion-Aktion ist DUPLICATE_NAME. Verwenden Sie für jede Conversion-Aktion einen eindeutigen Namen.

Hier finden Sie einige Tipps zum Festlegen der ConversionAction-Felder:

Alle Enum-Felder
Wenn Sie versuchen, ein Enum-Feld auf UNKNOWN festzulegen, wird ein RequestError.INVALID_ENUM_VALUE-Fehler ausgegeben.
app_id
Das Attribut app_id ist unveränderlich und kann nur beim Erstellen einer neuen App-Conversion festgelegt werden.
attribution_model_settings
Wenn Sie diese Option auf eine veraltete Option festlegen, wird der Fehler CANNOT_SET_RULE_BASED_ATTRIBUTION_MODELS ausgegeben. In Google Ads werden nur GOOGLE_ADS_LAST_CLICK und GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN unterstützt.
click_through_lookback_window_days

Wenn Sie dieses Attribut auf einen Wert außerhalb des zulässigen Bereichs festlegen, wird ein RangeError.TOO_LOW- oder RangeError.TOO_HIGH-Fehler ausgegeben.

Für eine AD_CALL- oder WEBSITE_CALL-Conversion-Aktion muss dieses Attribut zwischen 1 und 60 Tagen liegen. Bei den meisten anderen Conversion-Aktionen liegt der zulässige Bereich zwischen 1 und 90 Tagen.

include_in_conversions_metric

Das Festlegen dieses Werts in einem create- oder update-Vorgang schlägt mit dem Fehler FieldError.IMMUTABLE_FIELD fehl. Stattdessen sollten Sie primary_for_goal wie im Leitfaden zu Conversion-Zielvorhaben beschrieben festlegen.

phone_call_duration_seconds

Wenn Sie versuchen, dieses Attribut für eine Conversion-Aktion festzulegen, die nicht für Anrufe bestimmt ist, wird der Fehler FieldError.VALUE_MUST_BE_UNSET ausgegeben.

type

Das Attribut type ist unveränderlich und kann nur beim Erstellen einer neuen Conversion festgelegt werden.

Wenn Sie eine Conversion-Aktion aktualisieren, bei der type gleich UNKNOWN ist, wird der Fehler MutateError.MUTATE_NOT_ALLOWED ausgegeben.

value_settings

Für die value_settings einer WEBSITE_CALL- oder AD_CALL-Conversion-Aktion muss always_use_default_value auf true festgelegt sein. Wenn Sie beim Erstellen oder Aktualisieren dieses Werts den Wert false angeben, wird der Fehler INVALID_VALUE ausgegeben.

view_through_lookback_window_days

Wenn Sie dieses Attribut auf einen Wert außerhalb des zulässigen Bereichs festlegen, wird ein Fehler vom Typ RangeError.TOO_LOW oder RangeError.TOO_HIGH zurückgegeben. Bei den meisten Conversion-Aktionen liegt der zulässige Bereich zwischen 1 und 30 Tagen.

Dieses Attribut kann nicht für AD_CALL- oder WEBSITE_CALL-Conversion-Aktionen festgelegt werden. Wenn Sie einen Wert angeben, wird der Fehler VALUE_MUST_BE_UNSET ausgegeben.

Zurück
Kategorien von Conversion-Aktionen
Weiter
Offline-Conversions verwalten