Pierwsze kroki z konwersjami rozszerzonymi w kampaniach internetowych

Jak działają konwersje rozszerzone w kampaniach internetowych

Konwersje rozszerzone w kampaniach internetowych wymagają skonfigurowania tagu, który automatycznie wysyła do Google Ads identyfikator kliknięcia (np. GCLID) i identyfikator zamówienia, gdy użytkownik dokona konwersji. Konwersje rozszerzone możesz skonfigurować za pomocą Menedżera tagów Google, tagu Google lub interfejsu Google Ads API. Korzystanie z interfejsu Google Ads API ma tę zaletę, że wysyła własne dane o konwersjach w ciągu 24 godzin od zdarzenia konwersji, a nie w tym samym czasie. Umożliwia to znajdowanie danych własnych z różnych źródeł, takich jak baza danych klientów lub system CRM.

Konwersje rozszerzone w kampaniach internetowych w interfejsie Google Ads API stanowią uzupełnienie kroku 3 poniżej.

Konwersje rozszerzone w kampaniach internetowych

Zamiast wysyłać zaszyfrowane informacje o użytkowniku, gdy użytkownik dokona konwersji, tag wysyła tylko identyfikator kliknięcia Google i identyfikator zamówienia. Następnie przesyłasz zaszyfrowane informacje o użytkowniku, przesyłając identyfikator zamówienia razem z zaszyfrowanymi danymi.

Spełnij wymagania wstępne

Aby skonfigurować konwersje rozszerzone, trzeba spełnić kilka warunków wstępnych. Zanim przystąpisz do wdrażania, sprawdź, czy spełniasz wszystkie wymagania wstępne:

  1. Włącz śledzenie konwersji na koncie klienta dokonującego konwersji w Google Ads.

  2. Zaakceptuj warunki dotyczące danych klienta.

  3. Skonfiguruj tagowanie.

1. Włącz śledzenie konwersji na koncie klienta dokonującego konwersji w Google Ads

Pobieranie informacji o konfiguracji śledzenia konwersji

Aby sprawdzić konfigurację śledzenia konwersji na swoim koncie i potwierdzić, że śledzenie konwersji jest włączone, wyślij zapytanie do zasobu Customer dotyczącego ConversionTrackingSetting. Wyślij to zapytanie do 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

Pole google_ads_conversion_customer wskazuje konto Google Ads, które tworzy konwersje dla tego klienta i zarządza nimi. W przypadku klientów, którzy korzystają ze śledzenia konwersji dla wielu kont, jest to identyfikator konta menedżera. Identyfikator klienta konwersji Google Ads należy podawać jako customer_id w żądaniach do interfejsu Google Ads API na potrzeby tworzenia konwersji i zarządzania nimi. Pamiętaj, że to pole jest wypełniane nawet wtedy, gdy śledzenie konwersji jest wyłączone.

Pole conversion_tracking_status wskazuje, czy śledzenie konwersji jest włączone i czy konto korzysta ze śledzenia konwersji dla wielu kont.

Tworzenie działania powodującego konwersję dla klienta powodującego konwersję w Google Ads

Jeśli wartość conversion_tracking_status wynosi NOT_CONVERSION_TRACKED, śledzenie konwersji jest wyłączone na tym koncie. Włącz śledzenie konwersji, tworząc na koncie konwersji Google Ads co najmniej 1 element ConversionAction, jak w przykładzie poniżej. Możesz też utworzyć w interfejsie działanie powodujące konwersję, postępując zgodnie z instrukcjami podanymi w Centrum pomocy pod kątem typu konwersji, który chcesz włączyć.

Pamiętaj, że konwersje rozszerzone są włączane automatycznie podczas przesyłania przez interfejs Google Ads API, ale można je wyłączyć w interfejsie Google Ads.

Przykładowy kod

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

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

Sprawdź, czy conversion_action_type ma prawidłową wartość ConversionActionType. Więcej informacji o tworzeniu działań powodujących konwersję w interfejsie Google Ads API znajdziesz w artykule Tworzenie działań powodujących konwersję.

Pobierz istniejące działanie powodujące konwersję

Aby pobrać szczegóły istniejącego działania powodującego konwersję, wyślij następujące zapytanie. Upewnij się, że identyfikator klienta w żądaniu jest ustawiony na klienta dokonującego konwersji Google Ads wskazanego powyżej, a dla typu działania powodującego konwersję jest ustawiona prawidłowa wartość ConversionActionType.

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

2. Zaakceptuj Warunki dotyczące danych klienta

Aby korzystać z konwersji rozszerzonych w kampaniach internetowych, musisz zaakceptować warunki dotyczące danych klienta. Aby sprawdzić, czy warunki dotyczące danych klienta zostały zaakceptowane, wyślij do klienta Google Ads, który dokonał konwersji, zapytanie:

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

Jeśli accepted_customer_data_terms to false, postępuj zgodnie z instrukcjami w Centrum pomocy, aby spełnić ten warunek wstępny.

3. Skonfiguruj tagowanie

Aby skonfigurować tagowanie w swojej witrynie, postępuj zgodnie z instrukcjami w Centrum pomocy.

Musisz też dodać do tagu śledzenia konwersji identyfikatory transakcji, nazywane też identyfikatorami zamówień, postępując zgodnie z instrukcjami w Centrum pomocy. Google Ads wymaga, aby te osoby mogły znajdować konwersje, które mają zostać rozszerzone.

Dalsze kroki

Gdy spełniasz wymagania wstępne, możesz wdrożyć konwersje rozszerzone w kampaniach internetowych w interfejsie Google Ads API.

Wstecz
Przegląd
Dalej
Implementacja