Cómo empezar

Para registrar conversiones, debes habilitar el seguimiento de conversiones en tu cuenta de conversiones de Google Ads. En esta guía, se proporcionan detalles para confirmar si el seguimiento de conversiones está habilitado, habilitarlo si aún no lo está y recuperar información sobre las acciones de conversión existentes.

La mayoría de las acciones de conversión también requieren que realices pasos adicionales para hacerles un seguimiento. Para obtener más información sobre los distintos tipos de acciones de conversión y sus requisitos, consulta la guía para crear acciones de conversión.

Configura tu sitio web para hacer un seguimiento de las conversiones

Si vas a comenzar la integración de la importación de conversiones sin conexión, el primer paso es seguir los pasos de la guía Cómo configurar la etiqueta de Google para las conversiones avanzadas de clientes potenciales para configurar tu sitio web de modo que realice el seguimiento de las conversiones avanzadas de clientes potenciales. También puedes usar Google Tag Manager para configurar tu sitio web. Para ello, sigue los pasos que se indican en la guía Configura las conversiones avanzadas de clientes potenciales con Google Tag Manager.

Habilita el seguimiento de conversiones en tu cuenta de conversiones de Google Ads

Recupera información sobre tu configuración del seguimiento de conversiones

Puedes verificar la configuración del seguimiento de conversiones de tu cuenta y confirmar que esté habilitado consultando el recurso Customer para ConversionTrackingSetting. Ejecuta la siguiente consulta con 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

El campo google_ads_conversion_customer indica la cuenta de Google Ads que crea y administra las conversiones para este cliente. Para los clientes que utilizan el seguimiento de conversiones de múltiples cuentas, este es el ID de una cuenta de administrador. El ID de cliente de la conversión de Google Ads se debe proporcionar como customer_id en las solicitudes de la API de Google Ads para crear y administrar conversiones. Ten en cuenta que este campo se completa incluso si el seguimiento de conversiones no está habilitado.

El campo conversion_tracking_status indica si el seguimiento de conversiones está habilitado y si la cuenta utiliza el seguimiento de conversiones de múltiples cuentas.

Crea una acción de conversión en el cliente de conversiones de Google Ads

Si el valor de conversion_tracking_status es NOT_CONVERSION_TRACKED, el seguimiento de conversiones no está habilitado para la cuenta. Habilita el seguimiento de conversiones creando al menos un objeto ConversionAction en la cuenta de conversiones de Google Ads, como en el siguiente ejemplo. También puedes crear una acción de conversión en la IU siguiendo las instrucciones del Centro de ayuda para el tipo de conversión que deseas habilitar.

Ten en cuenta que las conversiones avanzadas se habilitan automáticamente cuando se envían a través de la API de Google Ads, pero se pueden inhabilitar a través de la IU de Google Ads.

Ejemplo de código

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

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

Asegúrate de que conversion_action_type esté configurado con el valor de ConversionActionType correcto. Para obtener más orientación sobre cómo crear acciones de conversión en la API de Google Ads, consulta Crea acciones de conversión.

Recupera una acción de conversión existente

Puedes recuperar los detalles de una acción de conversión existente con la siguiente consulta. Asegúrate de que el ID de cliente de la solicitud esté configurado como el cliente de conversión de Google Ads que identificaste anteriormente y de que el tipo de acción de conversión esté configurado con el valor de ConversionActionType correcto.

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

Seguimiento de conversiones de múltiples cuentas

Si utilizas el seguimiento de conversiones de múltiples cuentas, ConversionActionService devuelve las siguientes acciones de conversión:

  • Todas las acciones de conversión definidas por la cuenta de administrador que utiliza la cuenta para el seguimiento de conversiones de múltiples cuentas
  • Todas las acciones de conversión en las que el cliente acumuló estadísticas, incluidas las acciones definidas por el sistema y las acciones que son propiedad del administrador, incluso si este último desvincula la cuenta posteriormente
  • Todas las acciones que el cliente definió en su propia cuenta
  • Son las conversiones de Analytics creadas en las propiedades vinculadas de Google Analytics. Esto incluye las acciones de las conversiones de Analytics que no se importaron a Google Ads, que tienen el estado HIDDEN.

A partir del v19.1, puedes usar la API de Google Ads para habilitar el seguimiento de conversiones múltiples cuando crees cuentas de cliente.

Cuando crees un nuevo Customer, establece conversion_tracking_setting.google_ads_conversion_customer en el nombre del recurso de la cuenta de administrador que debe administrar las acciones de conversión en nombre de la cuenta de cliente. Esta cuenta de administrador también debe ser la que emite la solicitud create para la nueva cuenta de cliente.

A partir del v20, puedes usar la API de Google Ads para habilitar el seguimiento de conversiones múltiples cuando crees y actualices cuentas de cliente.

Cuando actualizas una cuenta de cliente existente, puedes habilitar el seguimiento de conversiones de múltiples cuentas configurando el campo conversion_tracking_setting.google_ads_conversion_customer. Este campo debe establecerse en el nombre del recurso de la cuenta de administrador que debe administrar las acciones de conversión en nombre de la cuenta de cliente. Esta cuenta de administrador también debe ser la que emite la solicitud de update para la cuenta de cliente.

Cuando habilitas el seguimiento de conversiones de múltiples cuentas o cambias el administrador del seguimiento de conversiones de una cuenta de cliente existente, se aplican las mismas advertencias que si realizaras este cambio en la IU. En particular, haz lo siguiente:

  • La cuenta de cliente adoptará las reglas de valor de conversión predeterminadas y los objetivos de ciclo de vida del cliente predeterminados de su nuevo administrador del seguimiento de conversiones.
  • Las campañas que segmentan sus anuncios para una acción de conversión específica comenzarán a usar los objetivos de conversión predeterminados de la cuenta de administrador de conversiones. Si sigues segmentando tus anuncios para una acción de conversión específica, esto puede generar un comportamiento incoherente, ya que es posible que la cuenta de administrador no tenga los mismos objetivos que la cuenta cliente. Asegúrate de que tus campañas estén optimizadas para los objetivos correctos.
  • Si una cuenta pertenece a más de una cuenta de administrador, solo puede usar acciones de conversión de un administrador. Si no se especifica ninguna cuenta de seguimiento de conversiones, la cuenta se utilizará a sí misma como la cuenta de seguimiento de conversiones de forma predeterminada.

Crea acciones de conversión

Para medir las conversiones, configura un ConversionAction para el type de la acción de conversión a la que deseas hacer un seguimiento. Por ejemplo, una compra en línea y una llamada telefónica requieren diferentes acciones de conversión.

La mejor manera de configurar nuevas acciones de conversión en la API es usar el ejemplo de código para agregar una acción de conversión que se muestra a continuación. La muestra controla todas las tareas de autenticación en segundo plano por ti y te guía para crear un ConversionAction.

La mayoría de las acciones de conversión también requieren que realices pasos adicionales para hacerles un seguimiento. Por ejemplo, para hacer un seguimiento de las conversiones en tu sitio web, debes agregar un fragmento de código llamado etiqueta a la página de conversión de tu sitio web. Para conocer los requisitos detallados de otros tipos de acciones de conversión, consulta nuestro artículo del Centro de ayuda.

Ejemplo de código

En el siguiente ejemplo de código, se explica el proceso para crear una nueva acción de conversión. Específicamente, crea una acción de conversión con el parámetro type establecido en UPLOAD_CLICKS. También establece category en DEFAULT.

Se aplican los siguientes parámetros de configuración predeterminados:

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

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

Puedes ver este ejemplo en la carpeta Remarketing de tu biblioteca cliente y en la colección de ejemplos de código: Ejemplo de código de acción de conversión de Add.

Validaciones

Google Ads y la API de Google Ads admiten una amplia variedad de acciones de conversión, por lo que algunas reglas de validación varían según el type de la acción.

El error más común al crear una acción de conversión es DUPLICATE_NAME. Asegúrate de usar un nombre único para cada acción de conversión.

Estas son algunas sugerencias para configurar los campos ConversionAction:

Todos los campos de enumeración
Si intentas establecer cualquier campo de enumeración en UNKNOWN, se generará un error de RequestError.INVALID_ENUM_VALUE.
app_id
El atributo app_id es inmutable y solo se puede establecer cuando se crea una conversión en la aplicación nueva.
attribution_model_settings
Si se establece en una opción obsoleta, se genera un error CANNOT_SET_RULE_BASED_ATTRIBUTION_MODELS. Google Ads solo admite GOOGLE_ADS_LAST_CLICK y GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN.
click_through_lookback_window_days

Si se configura este atributo con un valor fuera del rango permitido, se genera un error RangeError.TOO_LOW o RangeError.TOO_HIGH.

Este atributo debe estar en el rango [1,60] para una acción de conversión AD_CALL o WEBSITE_CALL. Para la mayoría de las demás acciones de conversión, el rango permitido es [1,30].

include_in_conversions_metric

Si se establece este valor en una operación create o update, se produce un error FieldError.IMMUTABLE_FIELD. En su lugar, establece primary_for_goal como se describe en la guía de objetivos de conversión.

phone_call_duration_seconds

Si intentas establecer este atributo en una acción de conversión que no es para llamadas, se producirá un error FieldError.VALUE_MUST_BE_UNSET.

type

El atributo type es inmutable y solo se puede establecer cuando se crea una conversión nueva.

Si actualizas una acción de conversión con type igual a UNKNOWN, se generará un error MutateError.MUTATE_NOT_ALLOWED.

value_settings

El value_settings de una acción de conversión de WEBSITE_CALL o AD_CALL debe tener el parámetro always_use_default_value establecido en true. Si especificas un valor de false cuando creas o actualizas este valor, se genera un error INVALID_VALUE.

view_through_lookback_window_days

Si se configura este atributo con un valor fuera del rango permitido, se genera un error RangeError.TOO_LOW o RangeError.TOO_HIGH. Para la mayoría de las acciones de conversión, el rango permitido es [1,30].

Este atributo no se puede establecer en las acciones de conversión de AD_CALL o WEBSITE_CALL. Si se especifica un valor, se genera un error VALUE_MUST_BE_UNSET.

Anterior
Categorías de acciones de conversión
Siguiente
Administra las conversiones sin conexión