4.1.5 Conversion-Tracking

Wert und Auswirkungen auf das Geschäft


Zur effektiven Bereitstellung des leistungsstarken maschinellen Lernens und Analytics für die Werbekampagnen Ihrer Händlerkunden erstellen möchten, müssen Sie Tracking- und Remarketing-Tags auf den Websites der Kunden.

Eine Conversion in Google Ads erfolgt, wenn ein Nutzer eine bestimmte Aktion ausführt. nachdem sie auf eine Anzeige geklickt haben, z. B. ein Produkt gekauft, eine mobile App installiert oder sich für eine E-Mail-Liste anmelden. Conversion-Tracking bietet wichtige Einblicke in die nachdem sie eine Anzeige gesehen oder darauf geklickt haben. Dazu gehören auch Informationen den Return on Investment (ROI) berechnen und vergleichen, um Ihren Kunden zu helfen Entscheidungen zu den Schwerpunkten der Werbeausgaben treffen. Die Verfolgung trägt auch dazu bei, dass die Daten für den Abgleich verfügbar sind. Bestellungen können sich je nach nach dem Produkt oder der Kategorie suchen. Mit Conversion-Tracking können Sie auch zeigen, bestimmte Eintragsgruppen zu Verkäufen führen.

Ein Conversion-Zielvorhaben ist eine Gruppe von Conversion-Aktionen mit zugrunde liegendes Ziel. Beispiel: „Kauf“ kann ein Conversion-Zielvorhaben sein, „Käufe auf der Website“ und „Ladenverkäufe“ als Conversion-Aktionen.

Conversion-Aktionen werden weiterhin verwendet, um Conversions zu erfassen und die Kampagne. Sie erstellen Conversion-Aktionen und Google gruppieren sie unter „Conversion“ Zielvorhaben.

Kauf-Conversion-Aktion

Wenn Sie das hier beschriebene Conversion-Tracking implementieren, kann Ihr Händler Google Ads-Konto, um die Anzahl der Kauf-Conversions und den Wert zu messen dieser Conversions. Ohne Conversion-Tracking ist den Geschäftswert zu messen, den die Kampagne in Bezug auf den ROAS (Return on Advertising Spend) Werbeausgaben). Außerdem werden zusätzliche Datensignale gesendet, die es der Kampagne ermöglichen, um die Leistung zu optimieren.

Andere Conversion-Aktionen

Zwar ist nur eine Kauf-Conversion-Aktion erforderlich, das Tracking zusätzlicher Conversion-Aktionen liefern Ihren Händlern zusätzliche Informationen. Mi. empfehlen wir, möglichst viele Daten zu protokollieren und gleichzeitig möglichst viele wichtigsten Conversion-Aktionen. Eine vollständige Liste der empfohlenen Conversion-Aktionen finden Sie wie im Abschnitt „Technische API-Anleitung“ beschrieben.

Im Allgemeinen wird empfohlen, Folgendes zu erfassen:

  • Jedes Erfolgsereignis, das direkt mit einem Wert verknüpft ist
  • Erfolgsereignisse, die zu den wichtigsten Conversions beitragen, z. B. „add_to_cart“ und sign_up.
  • Interaktionen und Nutzerinteraktionen, mit denen Werbetreibende ihre Leistung die Einbindung der Endanwendenden

Sekundäre Conversion-Aktionen dienen nur zur Beobachtung und Berichterstellung. Weitere Informationen zu primären und sekundären Conversion-Aktionen

UX-Anleitung


Um das Fehlerrisiko zu minimieren, sollten Sie Conversion-Aktionen ohne Eingabe des Händlers programmatisch erfassen. Sie sollten jedoch sicherstellen, wissen Ihre Händler, dass Conversion-Tracking eingerichtet ist.

Wenn Händler ein bestehendes Google Ads-Konto verknüpfen, empfehlen wir, Benachrichtigung, dass das Konto möglicherweise bereits über Conversion-Tracking verfügt da es Konflikte gibt, die gelöst werden müssen. Ein Beispiel wird gezeigt, unten.

connect_your_google_ads_account

Technische Hilfe


So funktioniert Conversion-Tracking: In diesem Abschnitt werden die einzelnen Schritt:

  1. Wenn Sie im Google Ads-Konto Ihres Händlers eine ConversionAction erstellen, Käufe (und optional andere Kundenaktionen) auf der Website erfassen

  2. Sie fügen das Tag oder Code-Snippet für diese Conversion-Aktion einer Website oder mobile App. Weitere Informationen finden Sie unter Conversion-Tracking für Ihre Website einrichten.

  3. Wenn ein Kunde auf die Anzeige klickt, wird ein temporäres Cookie auf der Computer oder Mobilgerät des Kunden.

  4. Wenn der Kunde die für den Werbetreibenden festgelegte Aktion ausführt, das Cookie erkennt (über das hinzugefügte Code-Snippet) und ein Conversion zusammen mit anderen Parametern wie "value" wenn angemessen.

Voraussetzungen

Sie benötigen eine Entwickler-ID für das Google-Tag. Wenn Sie keine eine Google-Tag-Entwickler-ID haben, füllen Sie Antragsformular für die Google-Tag-Entwickler-ID Ihre Entwickler-ID stimmt nicht mit Ihren Angaben überein von anderen IDs wie der Mess-ID oder der Conversion-ID, die der Website-Messcode hinzugefügt wird.

Conversion-Aktionen erstellen und konfigurieren

Die folgenden Beispiele zeigen, wie Sie eine Conversion-Aktion erstellen und der Kampagne ein Google Ads-Konto haben. Jedes Beispiel verarbeitet alle Hintergrundauthentifizierungsaufgaben für Außerdem wird erläutert, wie Sie eine Conversion-Aktion erstellen:

Java

// Copyright 2018 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//     https://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

package com.google.ads.googleads.examples.remarketing;

import static com.google.ads.googleads.examples.utils.CodeSampleHelper.getPrintableDateTime;

import com.beust.jcommander.Parameter;
import com.google.ads.googleads.examples.utils.ArgumentNames;
import com.google.ads.googleads.examples.utils.CodeSampleParams;
import com.google.ads.googleads.lib.GoogleAdsClient;
import com.google.ads.googleads.v17.enums.ConversionActionCategoryEnum.ConversionActionCategory;
import com.google.ads.googleads.v17.enums.ConversionActionStatusEnum.ConversionActionStatus;
import com.google.ads.googleads.v17.enums.ConversionActionTypeEnum.ConversionActionType;
import com.google.ads.googleads.v17.errors.GoogleAdsError;
import com.google.ads.googleads.v17.errors.GoogleAdsException;
import com.google.ads.googleads.v17.resources.ConversionAction;
import com.google.ads.googleads.v17.resources.ConversionAction.ValueSettings;
import com.google.ads.googleads.v17.services.ConversionActionOperation;
import com.google.ads.googleads.v17.services.ConversionActionServiceClient;
import com.google.ads.googleads.v17.services.MutateConversionActionResult;
import com.google.ads.googleads.v17.services.MutateConversionActionsResponse;
import java.io.FileNotFoundException;
import java.io.IOException;
import java.util.Collections;

/** Adds a conversion action. */
public class AddConversionAction {

  private static class AddConversionActionParams extends CodeSampleParams {

    @Parameter(names = ArgumentNames.CUSTOMER_ID, required = true)
    private Long customerId;
  }

  public static void main(String[] args) {
    AddConversionActionParams params = new AddConversionActionParams();
    if (!params.parseArguments(args)) {

      // Either pass the required parameters for this example on the command line, or insert them
      // into the code here. See the parameter class definition above for descriptions.
      params.customerId = Long.parseLong("INSERT_CUSTOMER_ID_HERE");
    }

    GoogleAdsClient googleAdsClient = null;
    try {
      googleAdsClient = GoogleAdsClient.newBuilder().fromPropertiesFile().build();
    } catch (FileNotFoundException fnfe) {
      System.err.printf(
          "Failed to load GoogleAdsClient configuration from file. Exception: %s%n", fnfe);
      System.exit(1);
    } catch (IOException ioe) {
      System.err.printf("Failed to create GoogleAdsClient. Exception: %s%n", ioe);
      System.exit(1);
    }

    try {
      new AddConversionAction().runExample(googleAdsClient, params.customerId);
    } catch (GoogleAdsException gae) {
      // GoogleAdsException is the base class for most exceptions thrown by an API request.
      // Instances of this exception have a message and a GoogleAdsFailure that contains a
      // collection of GoogleAdsErrors that indicate the underlying causes of the
      // GoogleAdsException.
      System.err.printf(
          "Request ID %s failed due to GoogleAdsException. Underlying errors:%n",
          gae.getRequestId());
      int i = 0;
      for (GoogleAdsError googleAdsError : gae.getGoogleAdsFailure().getErrorsList()) {
        System.err.printf("  Error %d: %s%n", i++, googleAdsError);
      }
      System.exit(1);
    }
  }

  /**
   * Runs the example.
   *
   * @param googleAdsClient the Google Ads API client.
   * @param customerId the client customer ID.
   * @throws GoogleAdsException if an API request failed with one or more service errors.
   */
  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#

// Copyright 2019 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//     http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

using CommandLine;
using Google.Ads.Gax.Examples;
using Google.Ads.GoogleAds.Lib;
using Google.Ads.GoogleAds.V17.Errors;
using Google.Ads.GoogleAds.V17.Resources;
using Google.Ads.GoogleAds.V17.Services;
using System;
using static Google.Ads.GoogleAds.V17.Enums.ConversionActionCategoryEnum.Types;
using static Google.Ads.GoogleAds.V17.Enums.ConversionActionStatusEnum.Types;
using static Google.Ads.GoogleAds.V17.Enums.ConversionActionTypeEnum.Types;

namespace Google.Ads.GoogleAds.Examples.V17
{
    /// <summary>
    /// This code example illustrates adding a conversion action.
    /// </summary>
    public class AddConversionAction : ExampleBase
    {
        /// <summary>
        /// Command line options for running the <see cref="AddConversionAction"/> example.
        /// </summary>
        public class Options : OptionsBase
        {
            /// <summary>
            /// The Google Ads customer ID for which the conversion action is added.
            /// </summary>
            [Option("customerId", Required = true, HelpText =
                "The Google Ads customer ID for which the conversion action is added.")]
            public long CustomerId { get; set; }
        }

        /// <summary>
        /// Main method, to run this code example as a standalone application.
        /// </summary>
        /// <param name="args">The command line arguments.</param>
        public static void Main(string[] args)
        {
            Options options = ExampleUtilities.ParseCommandLine<Options>(args);

            AddConversionAction codeExample = new AddConversionAction();
            Console.WriteLine(codeExample.Description);
            codeExample.Run(new GoogleAdsClient(), options.CustomerId);
        }

        /// <summary>
        /// Returns a description about the code example.
        /// </summary>
        public override string Description =>
            "This code example illustrates adding a conversion action.";

        /// <summary>
        /// Runs the code example.
        /// </summary>
        /// <param name="client">The Google Ads client.</param>
        /// <param name="customerId">The Google Ads customer ID for which the conversion action is
        /// added.</param>
        public void Run(GoogleAdsClient client, long customerId)
        {
            // Get the ConversionActionService.
            ConversionActionServiceClient conversionActionService =
                client.GetService(Services.V17.ConversionActionService);

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

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

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

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

                // Display the results.
                foreach (MutateConversionActionResult newConversionAction in response.Results)
                {
                    Console.WriteLine($"New conversion action with resource name = " +
                        $"'{newConversionAction.ResourceName}' was added.");
                }
            }
            catch (GoogleAdsException e)
            {
                Console.WriteLine("Failure:");
                Console.WriteLine($"Message: {e.Message}");
                Console.WriteLine($"Failure: {e.Failure}");
                Console.WriteLine($"Request ID: {e.RequestId}");
                throw;
            }
        }
    }
}

      

PHP

<?php

/**
 * Copyright 2018 Google LLC
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     https://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

namespace Google\Ads\GoogleAds\Examples\Remarketing;

require __DIR__ . '/../../vendor/autoload.php';

use GetOpt\GetOpt;
use Google\Ads\GoogleAds\Examples\Utils\ArgumentNames;
use Google\Ads\GoogleAds\Examples\Utils\ArgumentParser;
use Google\Ads\GoogleAds\Examples\Utils\Helper;
use Google\Ads\GoogleAds\Lib\V17\GoogleAdsClient;
use Google\Ads\GoogleAds\Lib\V17\GoogleAdsClientBuilder;
use Google\Ads\GoogleAds\Lib\V17\GoogleAdsException;
use Google\Ads\GoogleAds\Lib\OAuth2TokenBuilder;
use Google\Ads\GoogleAds\V17\Enums\ConversionActionCategoryEnum\ConversionActionCategory;
use Google\Ads\GoogleAds\V17\Enums\ConversionActionStatusEnum\ConversionActionStatus;
use Google\Ads\GoogleAds\V17\Enums\ConversionActionTypeEnum\ConversionActionType;
use Google\Ads\GoogleAds\V17\Errors\GoogleAdsError;
use Google\Ads\GoogleAds\V17\Resources\ConversionAction;
use Google\Ads\GoogleAds\V17\Resources\ConversionAction\ValueSettings;
use Google\Ads\GoogleAds\V17\Services\ConversionActionOperation;
use Google\Ads\GoogleAds\V17\Services\MutateConversionActionsRequest;
use Google\ApiCore\ApiException;

/** This example illustrates adding a conversion action. */
class AddConversionAction
{
    private const CUSTOMER_ID = 'INSERT_CUSTOMER_ID_HERE';

    public static function main()
    {
        // Either pass the required parameters for this example on the command line, or insert them
        // into the constants above.
        $options = (new ArgumentParser())->parseCommandArguments([
            ArgumentNames::CUSTOMER_ID => GetOpt::REQUIRED_ARGUMENT
        ]);

        // Generate a refreshable OAuth2 credential for authentication.
        $oAuth2Credential = (new OAuth2TokenBuilder())->fromFile()->build();

        // Construct a Google Ads client configured from a properties file and the
        // OAuth2 credentials above.
        $googleAdsClient = (new GoogleAdsClientBuilder())
            ->fromFile()
            ->withOAuth2Credential($oAuth2Credential)
            // We set this value to true to show how to use GAPIC v2 source code. You can remove the
            // below line if you wish to use the old-style source code. Note that in that case, you
            // probably need to modify some parts of the code below to make it work.
            // For more information, see
            // https://developers.devsite.corp.google.com/google-ads/api/docs/client-libs/php/gapic.
            ->usingGapicV2Source(true)
            ->build();

        try {
            self::runExample(
                $googleAdsClient,
                $options[ArgumentNames::CUSTOMER_ID] ?: self::CUSTOMER_ID
            );
        } catch (GoogleAdsException $googleAdsException) {
            printf(
                "Request with ID '%s' has failed.%sGoogle Ads failure details:%s",
                $googleAdsException->getRequestId(),
                PHP_EOL,
                PHP_EOL
            );
            foreach ($googleAdsException->getGoogleAdsFailure()->getErrors() as $error) {
                /** @var GoogleAdsError $error */
                printf(
                    "\t%s: %s%s",
                    $error->getErrorCode()->getErrorCode(),
                    $error->getMessage(),
                    PHP_EOL
                );
            }
            exit(1);
        } catch (ApiException $apiException) {
            printf(
                "ApiException was thrown with message '%s'.%s",
                $apiException->getMessage(),
                PHP_EOL
            );
            exit(1);
        }
    }

    /**
     * Runs the example.
     *
     * @param GoogleAdsClient $googleAdsClient the Google Ads API client
     * @param int $customerId the customer ID
     */
    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::main();

      

Python

#!/usr/bin/env python
# Copyright 2018 Google LLC
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#     https://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
"""This example illustrates adding a conversion action."""


import argparse
import sys
import uuid

from google.ads.googleads.client import GoogleAdsClient
from google.ads.googleads.errors import GoogleAdsException


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


if __name__ == "__main__":
    parser = argparse.ArgumentParser(
        description="Adds a conversion action for specified customer."
    )
    # The following argument(s) should be provided to run the example.
    parser.add_argument(
        "-c",
        "--customer_id",
        type=str,
        required=True,
        help="The Google Ads customer ID.",
    )
    args = parser.parse_args()

    # GoogleAdsClient will read the google-ads.yaml configuration file in the
    # home directory if none is specified.
    googleads_client = GoogleAdsClient.load_from_storage(version="v17")

    try:
        main(googleads_client, args.customer_id)
    except GoogleAdsException as ex:
        print(
            f'Request with ID "{ex.request_id}" failed with status '
            f'"{ex.error.code().name}" and includes the following errors:'
        )
        for error in ex.failure.errors:
            print(f'\tError with message "{error.message}".')
            if error.location:
                for field_path_element in error.location.field_path_elements:
                    print(f"\t\tOn field: {field_path_element.field_name}")
        sys.exit(1)

      

Ruby

#!/usr/bin/env ruby
# Encoding: utf-8
#
# Copyright 2018 Google LLC
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#     https://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
#
# This code example illustrates adding a conversion action.

require 'optparse'
require 'google/ads/google_ads'
require 'date'

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

if __FILE__ == $0
  options = {}
  # The following parameter(s) should be provided to run the example. You can
  # either specify these by changing the INSERT_XXX_ID_HERE values below, or on
  # the command line.
  #
  # Parameters passed on the command line will override any parameters set in
  # code.
  #
  # Running the example with -h will print the command line usage.
  options[:customer_id] = 'INSERT_CUSTOMER_ID_HERE'

  OptionParser.new do |opts|
    opts.banner = sprintf('Usage: %s [options]', File.basename(__FILE__))

    opts.separator ''
    opts.separator 'Options:'

    opts.on('-C', '--customer-id CUSTOMER-ID', String, 'Customer ID') do |v|
      options[:customer_id] = v
    end

    opts.separator ''
    opts.separator 'Help:'

    opts.on_tail('-h', '--help', 'Show this message') do
      puts opts
      exit
    end
  end.parse!

  begin
    add_conversion_action(options.fetch(:customer_id).tr("-", ""))
  rescue Google::Ads::GoogleAds::Errors::GoogleAdsError => e
    e.failure.errors.each do |error|
      STDERR.printf("Error with message: %s\n", error.message)
      if error.location
        error.location.field_path_elements.each do |field_path_element|
          STDERR.printf("\tOn field: %s\n", field_path_element.field_name)
        end
      end
      error.error_code.to_h.each do |k, v|
        next if v == :UNSPECIFIED
        STDERR.printf("\tType: %s\n\tCode: %s\n", k, v)
      end
    end
    raise
  end
end

      

Perl

#!/usr/bin/perl -w
#
# Copyright 2019, Google LLC
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#     http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
#
# This example illustrates adding a conversion action.

use strict;
use warnings;
use utf8;

use FindBin qw($Bin);
use lib "$Bin/../../lib";
use Google::Ads::GoogleAds::Client;
use Google::Ads::GoogleAds::Utils::GoogleAdsHelper;
use Google::Ads::GoogleAds::V17::Resources::ConversionAction;
use Google::Ads::GoogleAds::V17::Resources::ValueSettings;
use Google::Ads::GoogleAds::V17::Enums::ConversionActionCategoryEnum
  qw(DEFAULT);
use Google::Ads::GoogleAds::V17::Enums::ConversionActionTypeEnum   qw(WEBPAGE);
use Google::Ads::GoogleAds::V17::Enums::ConversionActionStatusEnum qw(ENABLED);
use
  Google::Ads::GoogleAds::V17::Services::ConversionActionService::ConversionActionOperation;

use Getopt::Long qw(:config auto_help);
use Pod::Usage;
use Cwd          qw(abs_path);
use Data::Uniqid qw(uniqid);

# The following parameter(s) should be provided to run the example. You can
# either specify these by changing the INSERT_XXX_ID_HERE values below, or on
# the command line.
#
# Parameters passed on the command line will override any parameters set in
# code.
#
# Running the example with -h will print the command line usage.
my $customer_id = "INSERT_CUSTOMER_ID_HERE";

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;
}

# Don't run the example if the file is being included.
if (abs_path($0) ne abs_path(__FILE__)) {
  return 1;
}

# Get Google Ads Client, credentials will be read from ~/googleads.properties.
my $api_client = Google::Ads::GoogleAds::Client->new();

# By default examples are set to die on any server returned fault.
$api_client->set_die_on_faults(1);

# Parameters passed on the command line will override any parameters set in code.
GetOptions("customer_id=s" => \$customer_id);

# Print the help message if the parameters are not initialized in the code nor
# in the command line.
pod2usage(2) if not check_params($customer_id);

# Call the example.
add_conversion_action($api_client, $customer_id =~ s/-//gr);

=pod

=head1 NAME

add_conversion_action

=head1 DESCRIPTION

This example illustrates adding a conversion action.

=head1 SYNOPSIS

add_conversion_action.pl [options]

    -help                       Show the help message.
    -customer_id                The Google Ads customer ID.

=cut

      

Da die Beispiele oben generisch sind, finden Sie hier zusätzliche Hinweise, ConversionAction muss richtig für Performance Max-Kampagnen konfiguriert sein. Jede Conversion-Aktion sollte so konfiguriert sein:

  • Typ: Legen Sie ConversionActionType auf WEBSEITE fest, weil bei diesen Käufen auf einer Website stattfinden.

  • Gebotsfähig – Legen Sie für Ihre primäre Kampagne true fest. Conversion-Aktion (Kauf) um Kampagnen für mehr Umsatz zu optimieren. Bei sekundären Conversion-Aktionen (z. B. „In den Einkaufswagen“): Legen Sie den Wert auf false fest.

  • Kategorie – für jede Ihrer Conversion-Aktionen (primäre oder sekundäre) ConversionActionCategory. Unten finden Sie die relevante Kategorie für Unterhaltungsaktionen für jede der 7 Conversion-Aktionen, die Sie implementieren sollten. Hinweis: In Google Ads werden Conversions automatisch Aktionen basierend auf ihrer Kategorie für ein standardmäßiges Conversion-Zielvorhaben festlegen. Beispielsweise werden Kauf-Conversion-Aktionen mit dem standardmäßigen Conversion-Zielvorhaben „Käufe“. Später können Sie die Performance Max-Kampagne um diese Kampagne für dieses Zielvorhaben vom Typ „Käufe“ zu optimieren.

Unten finden Sie eine Liste mit empfohlenen Conversion-Aktionen. Wir empfehlen, mindestens die ersten vier Conversion-Aktionen und weitere empfohlene Maßnahmen nach Möglichkeit.

Sie können auch erwägen, Zusätzliche Ereignisse, die für Onlineverkäufe relevant sind Für noch detailliertere können Sie zusätzliche Conversion-Aktionen erstellen oder Conversion-Aktionen, z. B. eine Aktion für „Zahlungsinformationen hinzufügen“ jedes Mal, wenn Nutzende die Suchoption auf der Website verwenden, oder eine Aktion für „suchen“ wenn ein Nutzer die Suchoption auf der Website verwendet). Sekundär Conversion-Aktionen ermöglichen es Ihren Händlern, die in Google Ads für die Beobachtung verwendet werden.

Priorität Conversion-Aktion Kategorie der Conversion-Aktion Google-Tag-Ereignisname Beschreibung
Obligatorisch Kaufen KAUF purchase Nutzer schließt einen Kauf ab
Dringend empfohlen für alle Store Builder In den Einkaufswagen ADD_TO_CART add_to_cart Nutzer legt ein Produkt in den Einkaufswagen
Dringend empfohlen für alle Store Builder Bezahlvorgang starten BEGIN_CHECKOUT begin_checkout Nutzer startet den Bezahlvorgang
Dringend empfohlen für alle Store Builder Element ansehen PAGE_VIEW page_view Der Nutzer öffnet eine Produktseite
Dringend empfohlen, falls zutreffend (gilt in der Regel nicht für Store Builder) Registrieren REGISTRIEREN sign_up Nutzer meldet sich für ein Konto an
Dringend empfohlen, falls zutreffend (gilt in der Regel nicht für Store Builder) Lead generieren SUBMIT_LEAD_FORM generate_lead Nutzer*in generiert Lead über ein Formular
Dringend empfohlen, falls zutreffend (gilt in der Regel nicht für Store Builder) Abonnieren SUBSCRIBE_PAID nicht zutreffend (benutzerdefiniert) Nutzer abonniert einen kostenpflichtigen Dienst
Dringend empfohlen, falls zutreffend (gilt in der Regel nicht für Store Builder) Termin vereinbaren BOOK_APPOINTMENT nicht zutreffend (benutzerdefiniert) Nutzer bucht einen Termin
Dringend empfohlen, falls zutreffend (gilt in der Regel nicht für Store Builder) Angebot anfordern REQUEST_QUOTE nicht zutreffend (benutzerdefiniert) Der Nutzer sendet ein Formular, mit dem er eine Preisschätzung anfordert

Händler mit einem bestehenden Google Ads-Konto

Wenn Sie Händlern die Aufnahme mit einem bestehenden Google Ads-Konto ermöglichen, können Sie falls das Konto bereits Conversion-Aktionen enthält. Wir nicht Sie empfehlen, eine vorhandene Conversion-Aktion zu verwenden, da es keine Garantie dafür gibt, ordnungsgemäß eingerichtet wurde. Außerdem sind zusätzliche Schritte erforderlich, um diese potenziellen Szenarien zu bewältigen:

  • Konto hat mehrere Zielvorhaben (z. B. Käufe + Seitenaufrufe + Kontakte) die alle als „Kontostandard“ gekennzeichnet sind. Wenn eine neue Kampagne erstellt wird, wird standardmäßig auf alle diese Zielvorhaben hin optimiert. Das sollten Sie nicht Performance Max-Kampagne.

  • Im Konto gibt es bereits mindestens eine Conversion-Aktion zum Erfassen von Käufen und ist sie bereits unter dem Zielvorhaben „Käufe“ gruppiert. Das bedeutet, dass Sie wird ein Kauf doppelt gezählt, da zwei Conversion-Tags ausgelöst werden.

Um sicherzustellen, dass in der Performance Max-Kampagne die benutzerdefinierte Conversion-Aktion verwendet wird und nur diese Aktion:

  1. CustomConversionGoal erstellen und Conversion-Aktion „Kauf“ hinzufügen zur Zielliste conversion_actions[] hinzu. Legen Sie den Status auf AKTIVIERT fest.

  2. Legen Sie in der ConversionGoalCampaignConfig der Performance Max-Kampagne Folgendes fest: custom_conversion_goal für das in Schritt 1 erstellte benutzerdefinierte Zielvorhaben hinzu.

  3. In Schritt 2 sollte in Google Ads die automatische Aktualisierung ConversionGoalCampaignConfig der Kampagne, sodass die goal_config_level festgelegt ist an CAMPAIGN (anstelle von CUSTOMER mit der Bitte, das Standardzielvorhaben auf Kontoebene. Es lohnt sich aber, zu überprüfen, passiert ist.

Tag für die Conversion-Aktion abrufen

Nachdem Sie die Conversion-Aktion erstellt haben, müssen Sie den entsprechendes Code-Snippet, das als Tag bezeichnet wird, der Conversion-Seite auf der Website des Werbetreibenden. Damit in Google Ads alle Conversions erfasst werden können verwenden Sie die Methode aktualisierten Conversion-Tracking-Tag von Google Ads. Dieses Tag besteht aus zwei Teile:

  • Die global_site_tag, die auf jeder Seite des Website des Werbetreibenden.

  • Die event_snippet, die auf Webseiten platziert werden sollte, die auf einen Conversion-Aktion, z. B. eine Zahlungsbestätigungsseite oder eine Seite zum Senden von Leads.

Sie können diese beiden Teile mit ConversionActionService abrufen.

Das Tag setzt Cookies, in denen eine eindeutige Kennung für einen Kunden oder die Anzeige gespeichert wird. Klick, über den der Kunde auf die Website gelangt ist. Die Cookies empfangen den Anzeigenklick. mit Daten aus dem Parameter Google Click Identifier (GCLID) im Conversion-Tracking-Tag. Sie müssen die Website des Werbetreibenden aktivieren und Conversion-Tracking-System verwenden, um die GCLID zu erfassen und zu speichern. Das ist die eindeutige ID, Google Ads stellt für jede Impression einer Google Anzeige bereit.

Weitere Informationen zum allgemeinen Tag und dazu, wo es eingefügt wird

Das Google-Tag (gtag.js) ist ein Tagging-Framework und eine API, mit denen Sie Ereignisdaten sowohl an Google Ads als auch an Google Analytics senden. Das allgemeine Website-Tag in Kombination mit einem Ereignis-Snippet oder einem Telefon-Snippet Conversions. Fügen Sie das Google-Tag auf jeder Seite im Abschnitt „<head>“ ein. auf der Website des Werbetreibenden aktivieren und für Google Ads konfigurieren. Sie können dann gtag()-Befehle verwenden, um Ereignisse zu erfassen und Daten an Google Ads zu senden Informationen zur Funktionsweise finden Sie unter Conversion-Tracking in Google Ads mit dem allgemeinen Website-Tag

Sie verwenden die folgenden Befehle mit dem Google-Tag:

  • config: Initialisiert ein Google-Produkt (Google Ads, Analytics usw.), Einstellungen konfigurieren und Daten an ein Konto senden.

  • Ereignis:Registrieren Sie eine Conversion durch Senden eines Ereignisses wie kaufen (empfohlen) oder in den Einkaufswagen legen (sekundäre Conversion-Aktionen) Weitere Informationen finden Sie im Leitfaden zu gtag.js-Ereignissen.

  • set:Legen Sie Parameter fest, die für alle Ereignisse auf der Seite gelten, z. B. die Währung.

Das folgende Beispiel zeigt ein JavaScript-Code-Snippet des allgemeinen Website-Tags, Daten an Google Ads senden. Der Platzhalterwert GOOGLE_CONVERSION_ID ist ein eindeutige numerische ID für ein einzelnes Werbetreibendenkonto.

<!-- Google Tag (gtag.js) - Google Ads: GOOGLE_CONVERSION_ID -->
<script async src="https://www.googletagmanager.com/gtag/js?id=AW-GOOGLE_CONVERSION_ID">
</script>
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments)};
  gtag('js', new Date());
   gtag('set', 'developer_id.<developer ID>', true); // Replace with your Google tag Developer ID
  gtag('config', 'AW-GOOGLE_CONVERSION_ID');
</script>

Das Google-Tag-Snippet darf nur einmal pro Seite eingefügt werden. Wenn eine bestehende von gtag.js verwenden, müssen Sie dem vorhandenen Tag neue Tag-IDs hinzufügen. Senden mehreren Konten zuweisen, können Sie einen Aufruf zur Konfiguration für alle verwendetes Konto. Geben Sie dabei die Conversion-ID jedes Kontos an (siehe Abbildung unten). im folgenden Beispiel:

<!-- Google Tag (gtag.js) - Google Ads: GOOGLE_CONVERSION_ID_1 -->
<script async src="https://www.googletagmanager.com/gtag/js?id=AW-GOOGLE_CONVERSION_ID_1"></script>
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments)};
  gtag('js', new Date());
  gtag('config', 'AW-GOOGLE_CONVERSION_ID_1');
  gtag('config', 'AW-GOOGLE_CONVERSION_ID_2');
</script>

Weitere Informationen zum Ereignis-Snippet und dazu, wo es installiert werden kann

Damit Kauf-Conversion-Tracking funktioniert, muss das Ereignis-Snippet für Käufe muss auf der Conversion-Seite selbst installiert sein. Dies ist normalerweise die Reihenfolge, Bestätigungsseite. Es kann an einer beliebigen Stelle im Code nach dem allgemeinen Tag platziert werden. Snippet. Die Ereignis-Snippets für sekundäre Conversion-Aktionen (z. B. „In den Einkaufswagen“) auf den entsprechenden Seiten platziert werden.

Im Beispiel-Snippet unten sehen Sie AW-CONVERSION_ID und gTag_developer_ID. steht für die individuelle Conversion-ID Ihres Google Ads-Kontos und Ihrer Entwicklerkonto taggen, wobei AW-CONVERSION_LABEL für Conversion steht. Label, das für jede Conversion-Aktion eindeutig ist:

<!-- Event snippet for a purchase conversion page -->
<script>
  gtag('event', 'conversion', {
       'send_to':'AW-CONVERSION_ID/CONVERSION_LABEL',
       'developer_id.<gTag developer ID>': true,
       'transaction_id': '<transaction_id (string)>' //unique ID for the transaction (e.g. an order ID); it's used for de-duplication purposes
       'value': 1.0,
       'currency': 'USD', //three-letter currency code, useful for advertisers who accept multiple currencies
       'country': 'US',
       'new_customer': false, //new customer acquisition goal
       'tax': 1.24, //tax cost-US only
       'shipping': 0.00, //shipping cost-US only
       'delivery_postal_code': '94043', //shipping data validation-US only
       'estimated_delivery_date': '2020-07-31', //shipping validation-US only
       'aw_merchant_id': 12345, //shipping validation-US only
       'aw_feed_country': 'US', //shipping validation-US only
       'aw_feed_language': 'EN', //shipping validation-US only
       'items': [
       {
             'id': 'P12345',
             'name': 'Android Warhol T-Shirt',
             'quantity': 2,
             'price': 12.04,
             'estimated_delivery_date': '2020-07-31', //shipping-US only
              'google_business_vertical': 'retail'
       }, …],
  });
</script>

Obwohl einige Parameter optional sind, wird empfohlen, möglichst viele Informationen, die für jedes Ereignis verfügbar sind. Weitere Informationen dazu, welche Parameter sind für jeden Ereignistyp verfügbar.

Parameter liefern zusätzliche Informationen zu den Interaktionen der Nutzer mit Ihrer Website oder App.

Wenn Sie ein Conversion-Ereignis basierend auf einem Klick erfassen möchten (z. B. auf einer Schaltfläche oder einer dynamischen Antwort für eine Website mit AJAX), können Sie stattdessen auch das folgende Snippet verwenden:

<!-- Event snippet for test conversion click -->
In your html page, add the snippet and call gtag_report_conversion when someone clicks on the chosen link or button. -->
<script>
function gtag_report_conversion(url) {
  var callback = function () {
    if (typeof(url) != 'undefined') {
      window.location = url;
    }
  };
  gtag('event', 'conversion', {
      'send_to': 'AW-CONVERSION_ID/CONVERSION_LABEL',
      'value': 1.0,
      'event_callback': callback,
      //other parameters
  });
  return false;
}
</script>

Das Google-Tag verfügt über eine integrierte Consent API, um die Nutzereinwilligung zu verwalten. Sie kann Nutzereinwilligung für Cookies zu Werbezwecken von denen für Analytics unterscheiden zu verstehen.

Das erwartete Ergebnis ist, dass Kunden mindestens das gtag('consent', 'update' erhalten. {...}) Anruf integriert, ohne dass der Kunde etwas tun muss. Dies sollte Google-Tags (Google Ads, Floodlight, Google Analytics, Conversion-Verknüpfung) können den aktuellen Einwilligungsstatus des Nutzers lesen und in das Netzwerk aufnehmen. -Anfragen an Google senden (über den Parameter &gcs).

Zusätzliche Implementierungsschritte wären die Bereitstellung oder Unterstützung von Werbetreibenden bei Bereitstellung (z.B. über eine UI) des gtag('consent', default' {...})-Status und Blockierung von Google-Tags aufheben (z. B. keine bedingte Auslösung durch die Nutzereinwilligung), Einwilligungsmodus aktivieren, um die Einwilligungsmessung zu berücksichtigen

Weitere Informationen zur Implementierung finden Sie im Hilfeartikel Einwilligungseinstellungen verwalten (Web).

Tipps

Im Google Ads-Verwaltungskonto können Sie Conversions für all Ihre Werbetreibendenkonten mit einem einzigen Conversion-Code-Tag. Weitere Informationen finden Sie unter zum kontoübergreifenden Conversion-Tracking.

Die beste Methode, um zu testen, sollten Sie sich an einen Ihrer Händler wenden, Websites (oder eine interne Testwebsite) und einen echten Kauf tätigen. Anschließend können Sie im Google Tag Assistant um diese Anleitung zur Fehlerbehebung zu verwenden um zu überprüfen, ob Ihr Tag Conversions erfasst werden. Weitere Informationen zur Fehlerbehebung finden Sie unter Websiteweites Tagging – Fehlerbehebung.

Sie können das vorherige Conversion-Tag durch erweiterte Conversions ergänzen. die die Genauigkeit der Conversion-Analyse und leistungsstärkere Gebotsoptionen nutzen. Weitere Informationen zum Einrichten erweiterter Conversions Bevor Sie erweiterte Conversions implementieren, sollten Sie müssen Sie sicherstellen, dass Ihre Händler die Richtlinien für Kundendaten zu erweiterten Conversions in Google Ads.