Erste Schritte mit erweiterten Conversions für Leads

Funktionsweise von erweiterten Conversions für Leads

Für erweiterte Conversions für Leads muss ein Tag eingerichtet werden, das automatisch Wenn ein Nutzer ein Lead-Formular sendet, wird eine GCLID an Google Ads gesendet. Sie können die Google-Tag über Google Ads importieren. Google Tag Manager, Google Analytics oder Campaign Manager 360. Das Tag sendet Daten zu gesendeten Lead-Formularen, z. B. die E-Mail-Adresse des Nutzers zusammen mit der GCLID an Google Ads gesendet, wenn der Nutzer das Lead-Formular sendet. Wenn Nutzende später eine Conversion ausführt, können Sie sie entweder über die Google Ads-Benutzeroberfläche hochladen wie in der Google Merchant Center-Hilfe beschrieben, oder die Conversion mit den Lead-Formularinformationen über das Google Ads API

Bei erweiterten Conversions für Leads in der Google Ads API wird Schritt 5 in den folgenden Abschnitten Ablauf.

Erweiterte Conversions für Leads

Voraussetzungen implementieren

Damit Sie erweiterte Conversions einrichten können, müssen bestimmte Voraussetzungen erfüllt sein. Achten Sie darauf, müssen alle Voraussetzungen erfüllt sein, bevor Sie mit der Implementierung fortfahren:

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

  2. Akzeptieren Sie die Nutzungsbedingungen für Kundendaten und aktivieren Sie erweiterte Conversions für Leads.

  3. Konfigurieren Sie das Tagging.

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

Informationen zur Einrichtung des Conversion-Trackings abrufen

Sie können die Einrichtung des Conversion-Trackings in Ihrem Konto prüfen und die Conversion bestätigen. Tracking wird durch Abfrage der Ressource Customer aktiviert für den ConversionTrackingSetting. Senden Sie die folgende Abfrage mit GoogleAdsService.SearchStream:

SELECT
  customer.conversion_tracking_setting.google_ads_conversion_customer,
  customer.conversion_tracking_setting.conversion_tracking_status,
  customer.conversion_tracking_setting.conversion_tracking_id,
  customer.conversion_tracking_setting.cross_account_conversion_tracking_id
FROM customer

Das Feld google_ads_conversion_customer gibt das Google Ads-Konto an, das erstellt und verwaltet Conversions für diesen Kunden. Für Kunden mit kontoübergreifendem Conversion-Tracking ist dies die ID eines Verwaltungskontos. Die Kundennummer für Google Ads-Conversions muss in Google Ads API-Anfragen als customer_id angegeben, um Conversions zu erstellen und zu verwalten. Beachten Sie, dass dieses Feld auch dann ausgefüllt wird, wenn das Conversion-Tracking nicht aktiviert ist.

Die conversion_tracking_status gibt an, ob Conversion-Tracking aktiviert ist und ob das Konto verwendet kontoübergreifendes Conversion-Tracking.

Conversion-Aktion unter „Google Ads-Conversion-Kunde“ erstellen

Wenn der Wert von conversion_tracking_status NOT_CONVERSION_TRACKED ist, Conversion-Tracking ist für dieses Konto nicht aktiviert. Conversion-Tracking aktivieren durch Erstellen von mindestens einem ConversionAction in Google Ads-Conversion-Konto verknüpft, wie im folgenden Beispiel gezeigt. Alternativ können Sie können Sie eine Conversion-Aktion erstellen, indem Sie der Anleitung im Hilfe für die Conversion-Typ auswählen, den Sie aktivieren möchten.

Erweiterte Conversions sind automatisch aktiviert, wenn sie über das Google Ads API, können aber über die Google Ads-Benutzeroberfläche deaktiviert werden.

<ph type="x-smartling-placeholder">

Codebeispiel

Java

private void runExample(GoogleAdsClient googleAdsClient, long customerId) {

  // Creates a ConversionAction.
  ConversionAction conversionAction =
      ConversionAction.newBuilder()
          // Note that conversion action names must be unique. If a conversion action already
          // exists with the specified conversion_action_name the create operation will fail with
          // a ConversionActionError.DUPLICATE_NAME error.
          .setName("Earth to Mars Cruises Conversion #" + getPrintableDateTime())
          .setCategory(ConversionActionCategory.DEFAULT)
          .setType(ConversionActionType.WEBPAGE)
          .setStatus(ConversionActionStatus.ENABLED)
          .setViewThroughLookbackWindowDays(15L)
          .setValueSettings(
              ValueSettings.newBuilder()
                  .setDefaultValue(23.41)
                  .setAlwaysUseDefaultValue(true)
                  .build())
          .build();

  // Creates the operation.
  ConversionActionOperation operation =
      ConversionActionOperation.newBuilder().setCreate(conversionAction).build();

  try (ConversionActionServiceClient conversionActionServiceClient =
      googleAdsClient.getLatestVersion().createConversionActionServiceClient()) {
    MutateConversionActionsResponse response =
        conversionActionServiceClient.mutateConversionActions(
            Long.toString(customerId), Collections.singletonList(operation));
    System.out.printf("Added %d conversion actions:%n", response.getResultsCount());
    for (MutateConversionActionResult result : response.getResultsList()) {
      System.out.printf(
          "New conversion action added with resource name: '%s'%n", result.getResourceName());
    }
  }
}
AddConversionAction.java

C#

public void Run(GoogleAdsClient client, long customerId)
{
    // Get the ConversionActionService.
    ConversionActionServiceClient conversionActionService =
        client.GetService(Services.V17.ConversionActionService);

    // Note that conversion action names must be unique.
    // If a conversion action already exists with the specified name the create operation
    // will fail with a ConversionAction.DUPLICATE_NAME error.
    string ConversionActionName = "Earth to Mars Cruises Conversion #"
        + ExampleUtilities.GetRandomString();

    // Add a conversion action.
    ConversionAction conversionAction = new ConversionAction()
    {
        Name = ConversionActionName,
        Category = ConversionActionCategory.Default,
        Type = ConversionActionType.Webpage,
        Status = ConversionActionStatus.Enabled,
        ViewThroughLookbackWindowDays = 15,
        ValueSettings = new ConversionAction.Types.ValueSettings()
        {
            DefaultValue = 23.41,
            AlwaysUseDefaultValue = true
        }
    };

    // Create the operation.
    ConversionActionOperation operation = new ConversionActionOperation()
    {
        Create = conversionAction
    };

    try
    {
        // Create the conversion action.
        MutateConversionActionsResponse response =
            conversionActionService.MutateConversionActions(customerId.ToString(),
                    new ConversionActionOperation[] { operation });

        // Display the results.
        foreach (MutateConversionActionResult newConversionAction in response.Results)
        {
            Console.WriteLine($"New conversion action with resource name = " +
                $"'{newConversionAction.ResourceName}' was added.");
        }
    }
    catch (GoogleAdsException e)
    {
        Console.WriteLine("Failure:");
        Console.WriteLine($"Message: {e.Message}");
        Console.WriteLine($"Failure: {e.Failure}");
        Console.WriteLine($"Request ID: {e.RequestId}");
        throw;
    }
}
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::V17::Resources::ConversionAction->new({
      name                          => $conversion_action_name,
      category                      => DEFAULT,
      type                          => WEBPAGE,
      status                        => ENABLED,
      viewThroughLookbackWindowDays => 15,
      valueSettings                 =>
        Google::Ads::GoogleAds::V17::Resources::ValueSettings->new({
          defaultValue          => 23.41,
          alwaysUseDefaultValue => "true"
        })});

  # Create a conversion action operation.
  my $conversion_action_operation =
    Google::Ads::GoogleAds::V17::Services::ConversionActionService::ConversionActionOperation
    ->new({create => $conversion_action});

  # Add the conversion action.
  my $conversion_actions_response =
    $api_client->ConversionActionService()->mutate({
      customerId => $customer_id,
      operations => [$conversion_action_operation]});

  printf "New conversion action added with resource name: '%s'.\n",
    $conversion_actions_response->{results}[0]{resourceName};

  return 1;
}
add_conversion_action.pl

Achte darauf, dass conversion_action_type auf die richtige ConversionActionType-Wert. Weitere Informationen zum Erstellen von Conversion-Aktionen in der Google Ads API finden Sie unter Conversion-Aktionen erstellen.

Vorhandene Conversion-Aktion abrufen

Sie können Details zu einer Conversion-Aktion abrufen, indem Sie den folgenden Abfrage aus. Achten Sie darauf, dass die Kundennummer in der Anfrage auf die Google Ads- Conversion-Kunde, den Sie oben angegeben haben, und der Typ der Conversion-Aktion festgelegt ist in das richtige ConversionActionType Wert.

SELECT
  conversion_action.resource_name,
  conversion_action.name,
  conversion_action.status
FROM conversion_action
WHERE conversion_action.type = 'UPLOAD_CLICKS'

2. Nutzungsbedingungen für Kundendaten akzeptieren und erweiterte Conversions für Leads aktivieren

Sie müssen erweiterte Conversions für Leads aktivieren und die Kundendaten akzeptieren bevor Sie erweiterte Conversions für Leads verwenden können. Sie können überprüfen, diese Voraussetzungen sind bereits erfüllt, indem die folgende Abfrage an den Google Ads- Conversion-Kunde:

SELECT
  customer.id,
  customer.conversion_tracking_setting.accepted_customer_data_terms,
  customer.conversion_tracking_setting.enhanced_conversions_for_leads_enabled
FROM customer

Wenn accepted_customer_data_terms oder enhanced_conversions_for_leads_enabled ist false, folge der Anleitung unter In der Hilfe finden Sie um diese Voraussetzungen zu erfüllen.

3. Tagging konfigurieren

Sie können das Google-Tag so konfigurieren, dass erweiterte Conversions für Leads aktiviert werden. Dazu müssen Sie befolgen Sie die Anleitung in der Hilfe . Zum Einrichten erweiterten Conversions für Leads mit Google Tag Manager, folgen Sie Anleitung.

Nächste Schritte

Sobald Sie die Voraussetzungen erfüllt haben, können Sie erweiterte mehr Conversions für Leads.

Zurück
Problembehebung
Weiter
Implementierung