Pour discuter de nos produits et nous faire part de vos commentaires, rejoignez le canal Discord officiel Google Ads sur le serveur de la communauté Google Advertising and Measurement.

Cette page a été traduite par l'API Cloud Translation.

Premiers pas

Pour enregistrer les conversions, vous devez activer le suivi des conversions dans votre compte de conversion Google Ads. Ce guide explique comment vérifier si le suivi des conversions est activé, comment l'activer le cas échéant et comment récupérer des informations sur les actions de conversion existantes.

La plupart des actions de conversion nécessitent également des étapes supplémentaires de votre part pour être suivies. Pour en savoir plus sur les différents types d'actions de conversion et leurs exigences, consultez le guide de création d'actions de conversion.

Configurer votre site Web pour suivre les conversions

Si vous commencez à intégrer l'importation des conversions hors connexion, la première étape consiste à suivre la procédure du guide Configurer la balise Google pour le suivi avancé des conversions pour les prospects afin de configurer votre site Web pour le suivi avancé des conversions pour les prospects. Vous pouvez également utiliser Google Tag Manager pour configurer votre site Web en suivant les étapes du guide Configurer Google Tag Manager pour le suivi avancé des conversions pour les prospects.

Activer le suivi des conversions dans votre compte de conversion Google Ads

Récupérer des informations sur votre configuration du suivi des conversions

Vous pouvez vérifier la configuration du suivi des conversions de votre compte et confirmer qu'il est activé en interrogeant la ressource Customer pour ConversionTrackingSetting. Exécutez la requête suivante avec 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

Le champ google_ads_conversion_customer indique le compte Google Ads qui crée et gère les conversions pour ce client. Pour les clients qui utilisent le suivi des conversions multicomptes, il s'agit de l'ID d'un compte administrateur. L'ID client de conversion Google Ads doit être indiqué sous la forme customer_id dans les requêtes de l'API Google Ads pour créer et gérer les conversions. Notez que ce champ est renseigné même si le suivi des conversions n'est pas activé.

Le champ conversion_tracking_status indique si le suivi des conversions est activé et si le compte utilise le suivi des conversions multicomptes.

Créez une action de conversion sous le client de conversion Google Ads.

Si la valeur conversion_tracking_status est NOT_CONVERSION_TRACKED, le suivi des conversions n'est pas activé pour le compte. Activez le suivi des conversions en créant au moins une ConversionAction dans le compte de conversion Google Ads, comme dans l'exemple suivant. Vous pouvez également créer une action de conversion dans l'UI en suivant les instructions du Centre d'aide pour le type de conversion que vous souhaitez activer.

Notez que le suivi avancé des conversions est activé automatiquement lorsqu'il est envoyé via l'API Google Ads, mais qu'il peut être désactivé dans l'UI Google Ads.

Exemple de code

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}."
endadd_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

Assurez-vous que conversion_action_type est défini sur la valeur ConversionActionType appropriée. Pour obtenir plus d'informations sur la création d'actions de conversion dans l'API Google Ads, consultez Créer des actions de conversion.

Récupérer une action de conversion existante

Vous pouvez récupérer les détails d'une action de conversion existante en exécutant la requête suivante. Assurez-vous que le numéro client de la demande est défini sur le client de conversion Google Ads que vous avez identifié ci-dessus, et que le type d'action de conversion est défini sur la valeur ConversionActionType appropriée.

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

Suivi des conversions multicomptes

Si vous utilisez le suivi des conversions multicomptes, ConversionActionService renvoie les actions de conversion suivantes :

Toutes les actions de conversion définies par le compte administrateur utilisé par le compte pour le suivi des conversions multicompte
Toutes les actions de conversion pour lesquelles le client a accumulé des statistiques, y compris les actions définies par le système et les actions appartenant au responsable, même si celui-ci supprime ensuite l'association
Toutes les actions définies par le client dans son propre compte
Conversions Analytics créées dans les propriétés Google Analytics associées. Cela inclut les actions pour les conversions Analytics non importées dans Google Ads, dont l'état est HIDDEN.

À partir du v19.1, vous pouvez utiliser l'API Google Ads pour activer le suivi des conversions multicomptes lorsque vous créez des comptes clients.

Lorsque vous créez un Customer, définissez conversion_tracking_setting.google_ads_conversion_customer sur le nom de ressource du compte administrateur qui doit gérer les actions de conversion pour le compte client. Ce compte administrateur doit également être celui qui envoie la demande create pour le nouveau compte client.

À partir du v20, vous pouvez utiliser l'API Google Ads pour activer le suivi des conversions multicompte lorsque vous créez et mettez à jour des comptes clients.

Lorsque vous mettez à jour un compte client existant, vous pouvez activer le suivi des conversions multicomptes en définissant le champ conversion_tracking_setting.google_ads_conversion_customer. Ce champ doit être défini sur le nom de ressource du compte administrateur qui doit gérer les actions de conversion au nom du compte client. Ce compte administrateur doit également être celui qui envoie la demande update pour le compte client.

Lorsque vous activez le suivi des conversions multicomptes ou que vous modifiez le gestionnaire de suivi des conversions pour un compte client existant, les mêmes mises en garde s'appliquent que si vous effectuiez cette modification dans l'UI. Plus spécifiquement :

Le compte client adoptera les règles de valeur de conversion par défaut et les objectifs de cycle de vie client par défaut de son nouveau responsable du suivi des conversions.
Les campagnes ciblant une action de conversion spécifique utiliseront alors les objectifs de conversion par défaut du compte administrateur des conversions. Si vous continuez à cibler une action de conversion spécifique, cela peut générer des problèmes de cohérence, car le compte administrateur n'a peut-être pas les mêmes objectifs que le compte client. Assurez-vous que vos campagnes sont optimisées pour les bons objectifs.
Si un compte appartient à plusieurs comptes administrateur, il ne peut utiliser les actions de conversion que d'un seul compte. Si aucun compte de suivi des conversions n'est spécifié, le compte utilisera par défaut son propre compte comme compte de suivi des conversions.

Créer des actions de conversion

Pour mesurer les conversions, configurez un ConversionAction pour le type de l'action de conversion que vous souhaitez suivre. Par exemple, un achat en ligne et un appel téléphonique nécessitent des actions de conversion différentes.

La meilleure façon de configurer de nouvelles actions de conversion dans l'API est d'utiliser l'exemple de code "Ajouter une action de conversion" ci-dessous. L'exemple gère toutes les tâches d'authentification en arrière-plan pour vous et vous guide dans la création d'un ConversionAction.

La plupart des actions de conversion nécessitent également des étapes supplémentaires de votre part pour être suivies. Par exemple, pour suivre les conversions sur votre site Web, vous devez ajouter un extrait de code appelé balise à la page de conversion de votre site Web. Pour connaître les exigences détaillées des autres types d'actions de conversion, consultez notre article du Centre d'aide.

Exemple de code

L'exemple de code suivant vous guide tout au long du processus de création d'une action de conversion. Plus précisément, il crée une action de conversion avec type défini sur UPLOAD_CLICKS. Il définit également category sur DEFAULT.

Les paramètres par défaut suivants s'appliquent :

L'API Google Ads définit automatiquement le champ primary_for_goal, mais vous pouvez le définir explicitement pour contrôler l'impact d'une action de conversion sur les rapports et les enchères dans votre compte lorsqu'elle est combinée à vos objectifs de conversion.
L'API Google Ads définit automatiquement counting_type sur MANY_PER_CLICK. Pour en savoir plus, consultez À propos des options de comptabilisation des conversions.
L'API Google Ads définit le modèle d'attribution sur Basé sur les données en définissant le champ attribution_model_settings sur la valeur GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN de AttributionModel. Pour en savoir plus sur les modèles d'attribution, consultez cet article du Centre d'aide.

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}."
endadd_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

Vous trouverez cet exemple dans le dossier "Remarketing" de votre bibliothèque cliente et dans la collection d'exemples de code : Exemple d'ajout de code d'action de conversion.

Validations

Google Ads et l'API Google Ads sont compatibles avec un large éventail d'actions de conversion. Par conséquent, certaines règles de validation varient en fonction du type de l'action.

L'erreur la plus courante lors de la création d'une action de conversion est DUPLICATE_NAME. Veillez à utiliser un nom unique pour chaque action de conversion.

Voici quelques conseils pour définir les champs ConversionAction :

Tous les champs d'énumération

Toute tentative de définition d'un champ d'énumération sur UNKNOWN génère une erreur RequestError.INVALID_ENUM_VALUE.

app_id

L'attribut app_id est immuable et ne peut être défini que lors de la création d'une conversion d'application.

attribution_model_settings

Si vous définissez cette option sur une option obsolète, une erreur CANNOT_SET_RULE_BASED_ATTRIBUTION_MODELS s'affiche. Google Ads n'accepte que GOOGLE_ADS_LAST_CLICK et GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN.

click_through_lookback_window_days

Si vous définissez cet attribut sur une valeur en dehors de la plage autorisée, une erreur RangeError.TOO_LOW ou RangeError.TOO_HIGH se produit.

Cet attribut doit être compris dans la plage [1,60] pour une action de conversion AD_CALL ou WEBSITE_CALL. Pour la plupart des autres actions de conversion, la plage autorisée est [1,30].

include_in_conversions_metric

Si vous définissez cette valeur dans une opération create ou update, l'opération échoue et renvoie une erreur FieldError.IMMUTABLE_FIELD. À la place, définissez primary_for_goal comme décrit dans le guide sur les objectifs de conversion.

phone_call_duration_seconds

Toute tentative de définition de cet attribut sur une action de conversion qui n'est pas destinée aux appels génère une erreur FieldError.VALUE_MUST_BE_UNSET.

type

L'attribut type est immuable et ne peut être défini que lors de la création d'une conversion.

La mise à jour d'une action de conversion avec type défini sur UNKNOWN génère une erreur MutateError.MUTATE_NOT_ALLOWED.

value_settings

Le value_settings d'une action de conversion WEBSITE_CALL ou AD_CALL doit être défini sur always_use_default_value = true. Si vous spécifiez la valeur false lors de la création ou de la mise à jour de cette valeur, une erreur INVALID_VALUE se produit.

view_through_lookback_window_days

Si vous définissez cet attribut sur une valeur en dehors de la plage autorisée, une erreur RangeError.TOO_LOW ou RangeError.TOO_HIGH se produit. Pour la plupart des actions de conversion, la plage autorisée est [1,30].

Cet attribut ne peut pas être défini sur les actions de conversion AD_CALL ou WEBSITE_CALL. Si vous spécifiez une valeur, une erreur VALUE_MUST_BE_UNSET se produit.

Catégories d'actions de conversion

Gérer les conversions hors connexion

Premiers pas Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Configurer votre site Web pour suivre les conversions

Activer le suivi des conversions dans votre compte de conversion Google Ads

Récupérer des informations sur votre configuration du suivi des conversions

Créez une action de conversion sous le client de conversion Google Ads.

Exemple de code

Java

C#

PHP

Python

Ruby

Perl

Récupérer une action de conversion existante

Suivi des conversions multicomptes

Créer des actions de conversion

Exemple de code

Java

C#

PHP

Python

Ruby

Perl

Validations

Premiers pas