Puedes configurar las conversiones avanzadas de sitios web.
Cómo funcionan las conversiones avanzadas de sitios web
Las conversiones avanzadas de sitios web requieren configurar una etiqueta que envíe automáticamente un identificador de clic, como un GCLID, y un ID de pedido a Google Ads cuando un usuario genere una conversión. Puedes configurar las conversiones avanzadas a través de Google Tag Manager, la etiqueta de Google o la API de Google Ads. El uso de la API de Google Ads te brinda la ventaja de enviar datos de conversiones de origen dentro de las 24 horas posteriores al evento de conversión, en lugar de hacerlo al mismo tiempo. Esto permite encontrar datos de origen de diversas fuentes, como una base de datos de clientes o un sistema de CRM.
Las conversiones avanzadas de sitios web en la API de Google Ads complementan el paso 3 del siguiente flujo.
En lugar de enviar la información del usuario con codificación hash cuando el usuario genera una conversión, la etiqueta solo envía el GCLID y el ID de pedido, y puedes enviar la información del usuario con codificación hash más adelante subiendo el ID de pedido junto con los datos con codificación hash.
Implementa los requisitos previos
Existen algunos requisitos previos para que funcione la configuración de las conversiones avanzadas. Asegúrate de que se cumplan todos los requisitos previos antes de continuar con la implementación:
Habilita el seguimiento de conversiones en tu cliente de conversiones de Google Ads.
Acepta las condiciones sobre los datos del cliente.
Configura el etiquetado.
1. Habilita el seguimiento de conversiones en tu cliente de conversiones de Google Ads
Cómo recuperar información sobre la configuración del seguimiento de conversiones
Para verificar la configuración del seguimiento de conversiones de tu cuenta y confirmar que está habilitado, consulta el recurso Customer para ConversionTrackingSetting.
Realiza 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 de este cliente. En el caso de 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 conversión de Google Ads se debe proporcionar como customer_id en las solicitudes a 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. Para habilitar el seguimiento de conversiones, crea al menos un ConversionAction en la cuenta de conversiones de Google Ads, como en el siguiente ejemplo. Como alternativa, puedes crear una acción de conversión en la IU. Para ello, sigue 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());
}
}
}
C#
public void Run(GoogleAdsClient client, long customerId)
{
// Get the ConversionActionService.
ConversionActionServiceClient conversionActionService =
client.GetService(Services.V18.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
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
);
}
}
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}".'
)
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
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::V18::Resources::ConversionAction->new({
name => $conversion_action_name,
category => DEFAULT,
type => WEBPAGE,
status => ENABLED,
viewThroughLookbackWindowDays => 15,
valueSettings =>
Google::Ads::GoogleAds::V18::Resources::ValueSettings->new({
defaultValue => 23.41,
alwaysUseDefaultValue => "true"
})});
# Create a conversion action operation.
my $conversion_action_operation =
Google::Ads::GoogleAds::V18::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;
}
Asegúrate de que conversion_action_type esté configurado con el valor correcto de ConversionActionType.
Para obtener más orientación sobre cómo crear acciones de conversión en la API de Google Ads, consulta Cómo crear acciones de conversión.
Cómo recuperar una acción de conversión existente
Para recuperar los detalles de una acción de conversión existente, emite la siguiente consulta. Asegúrate de que el ID de cliente en la solicitud esté configurado en el cliente de conversiones de Google Ads que identificaste anteriormente y de que el tipo de acción de conversión esté configurado en el valor correcto de ConversionActionType.
SELECT
conversion_action.resource_name,
conversion_action.name,
conversion_action.status
FROM conversion_action
WHERE conversion_action.type = 'WEBPAGE'
2. Acepta las condiciones sobre los datos del cliente
Debes aceptar las condiciones sobre los datos del cliente para poder usar las conversiones avanzadas de sitios web. Para verificar si se aceptaron las Condiciones sobre los datos del cliente, puedes realizar la siguiente consulta al cliente de conversiones de Google Ads:
SELECT
customer.id,
customer.conversion_tracking_setting.accepted_customer_data_terms
FROM customer
Si accepted_customer_data_terms es false, sigue las instrucciones del Centro de ayuda para completar este requisito previo.
3. Configura el etiquetado
Para configurar el etiquetado de tu sitio web, sigue las instrucciones del Centro de ayuda.
También debes agregar los IDs de transacción, también conocidos como IDs de pedido, a tu etiqueta del seguimiento de conversiones. Para ello, sigue las instrucciones que se indican en el Centro de ayuda. Google Ads requiere estos atributos para poder encontrar la conversión que se mejorará.
Próximos pasos
Una vez que cumplas con los requisitos previos, estarás listo para implementar las conversiones avanzadas de sitios web en la API de Google Ads.