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 außerdem zusätzliche Schritte erforderlich, um sie zu erfassen. Weitere Informationen zu den verschiedenen Arten von Conversion-Aktionen und den entsprechenden Anforderungen finden Sie unter Kategorien von Conversion-Aktionen und Conversion-Aktionen erstellen.

Einwilligung vorbereiten

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 Conversion-Tracking 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 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 mindestens eine ConversionAction im Google Ads-Conversion-Konto erstellen, wie im folgenden Beispiel gezeigt. 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.

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
      

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

    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
      

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

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
      

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;
}
add_conversion_action.pl
      

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 von dem Verwaltungskonto gesendet werden, das der neue Conversion-Kunde für den Kunden wird. Legen Sie dazu die login-customer-id auf die ID des Verwaltungskontos fest.

Wenn Sie sich für das kontoübergreifende Conversion-Tracking entscheiden 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 Kunden- und Verwaltungskonten Conversions im Namen des Kontos zur Anzeigenauslieferung importieren. So lässt sich die Importlogik vereinfachen, da Sie nicht für jede Conversion das Konto zur Anzeigenauslieferung bestimmen müssen. Sie können einfach ein Konto aus der Baumansicht des Kontos 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 die Daten hochgeladen werden, Zugriff auf die Aktion, wenn es sich in der Baumansicht des Kontos um ein übergeordnetes Konto (Verwaltungskonto) oder ein untergeordnetes Konto des Inhabers der Conversion-Aktion handelt.

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.

Conversion-Aktionen erstellen

Wenn Sie Conversions erfassen möchten, richten Sie eine 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 „Conversion-Aktion hinzufügen“ ein. Das Beispiel übernimmt alle Authentifizierungsaufgaben im Hintergrund für Sie und führt Sie durch die Erstellung eines ConversionAction.

Für die meisten Conversion-Aktionen sind außerdem zusätzliche Schritte erforderlich, um sie zu erfassen. 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, gibt ConversionActionService die folgenden Conversion-Aktionen zurück:

• Alle Conversion-Aktionen, die im Verwaltungskonto definiert sind, das vom Konto für das kontoübergreifende Conversion-Tracking verwendet wird
• Alle Conversion-Aktionen, für die der Kunde Statistiken gesammelt hat, einschließlich systemdefinierter Aktionen und Aktionen, die dem Verwaltungskonto gehören, auch wenn die Verknüpfung mit diesem Verwaltungskonto 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 auch 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:

• In der Google Ads API wird das Feld primary_for_goal automatisch festgelegt. Sie können es aber auch explizit festlegen, um zu steuern, wie sich eine Conversion-Aktion auf die Berichte und Gebote in Ihrem Konto auswirkt, wenn sie mit Ihren Conversion-Zielvorhaben kombiniert wird.

• Die Google Ads API legt den counting_type automatisch auf MANY_PER_CLICK fest. Weitere Informationen finden Sie unter Conversions erfassen.

• In der Google Ads API wird das Attributionsmodell auf Datengetrieben festgelegt, indem das Feld attribution_model_settings auf den GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN-Wert AttributionModel gesetzt wird. Weitere Informationen zu Attributionsmodellen finden Sie im Artikel Attributionsmodelle.

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
      

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

    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
      

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

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
      

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;
}
add_conversion_action.pl
      

Dieses Beispiel finden Sie im Ordner „Remarketing“ 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 den Google Ads-Conversion-Kunden 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:

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):

REST-Anfrage- und Antwortstruktur

Wenn Sie eine ConversionAction ü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

Der Versuch, ein Enum-Feld auf UNKNOWN festzulegen, führt zu einem RequestError.INVALID_ENUM_VALUE-Fehler.

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 hier eine veraltete Option festlegen, wird der Fehler CANNOT_SET_RULE_BASED_ATTRIBUTION_MODELS ausgegeben. Google Ads unterstützt nur GOOGLE_ADS_LAST_CLICK und GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN.

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.

Dieses Attribut muss für eine Conversion-Aktion vom Typ AD_CALL oder WEBSITE_CALL 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

Wenn Sie diesen Wert in einem create- oder update-Vorgang festlegen, schlägt der Vorgang mit dem Fehler FieldError.IMMUTABLE_FIELD fehl. Legen Sie stattdessen primary_for_goal fest, wie im Leitfaden zu Conversion-Zielvorhaben beschrieben.

phone_call_duration_seconds

Wenn Sie versuchen, dieses Attribut für eine Conversion-Aktion festzulegen, die nicht für Anrufe vorgesehen 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 ein MutateError.MUTATE_NOT_ALLOWED-Fehler 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 RangeError.TOO_LOW- oder RangeError.TOO_HIGH-Fehler ausgegeben. 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.