Creare una campagna intelligente e un'impostazione di campagna intelligente

Le campagne intelligenti dipendono da una risorsa chiamata SmartCampaignSetting, che contiene opzioni di configurazione aggiuntive non disponibili nella risorsa Campaign principale.

Attenzione: a partire dal 23 settembre 2026, la creazione di campagne intelligenti verrà ritirata (restituendo SmartCampaignError.CREATION_FAILED in v24 a partire da v24.2 e v25 o AuthorizationError.ACTION_NOT_PERMITTED in v23 e v24 prima di v24.2). Puoi comunque aggiornare le impostazioni delle campagne intelligenti nel tuo account. Per i dettagli, consulta la panoramica.

Un'impostazione della campagna intelligente non può esistere senza essere collegata a una campagna, motivo per cui è consigliabile includere entrambe le operazioni nella stessa richiesta di modifica.

Crea una campagna

Poiché una campagna intelligente viene gestita principalmente in modo automatico dalla tecnologia pubblicitaria di Google, non devi impostare molti campi.

Requisiti chiave per le campagne intelligenti:

• Deve avere il proprio CampaignBudget.
• L'attributo advertising_channel_type deve essere impostato su AdvertisingChannelTypeEnum.SMART.
• L'attributo advertising_channel_sub_type deve essere impostato su AdvertisingChannelSubTypeEnum.SMART_CAMPAIGN.
• Devi dichiarare se la campagna pubblica annunci politici che hanno come target l'Unione europea impostando contains_eu_political_advertising su DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING o CONTAINS_EU_POLITICAL_ADVERTISING.

Questo esempio imposta il valore del nome della risorsa di questa campagna utilizzando un nome della risorsa temporaneo. Ciò consente di fare riferimento alla campagna in altri oggetti della richiesta di modifica prima che esista nel backend.

Java

private MutateOperation createSmartCampaignOperation(long customerId) {
  MutateOperation.Builder builder = MutateOperation.newBuilder();
  builder
      .getCampaignOperationBuilder()
      .getCreateBuilder()
      .setName("Smart campaign " + CodeSampleHelper.getShortPrintableDateTime())
      .setStatus(CampaignStatus.PAUSED)
      .setAdvertisingChannelType(AdvertisingChannelType.SMART)
      .setAdvertisingChannelSubType(AdvertisingChannelSubType.SMART_CAMPAIGN)
      // Assigns the resource name with a temporary ID.
      .setResourceName(ResourceNames.campaign(customerId, SMART_CAMPAIGN_TEMPORARY_ID))
      .setCampaignBudget(ResourceNames.campaignBudget(customerId, BUDGET_TEMPORARY_ID))
      // Declares whether this campaign serves political ads targeting the EU.
      .setContainsEuPoliticalAdvertising(DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING);
  return builder.build();
}
AddSmartCampaign.java
      

C#

/// <summary>
/// Creates a MutateOperation that creates a new Smart campaign.
/// A temporary ID will be assigned to this campaign so that it can be referenced by other
/// objects being created in the same Mutate request.
/// </summary>
/// <param name="customerId">The Google Ads customer ID.</param>
/// <returns>A MutateOperation that creates a campaign.</returns>
private MutateOperation CreateSmartCampaignOperation(long customerId)
{
    return new MutateOperation
    {
        CampaignOperation = new CampaignOperation
        {
            Create = new Campaign
            {
                Name = $"Smart campaign #{ExampleUtilities.GetRandomString()}",
                // Set the campaign status as PAUSED. The campaign is the only entity in
                // the mutate request that should have its status set.
                Status = CampaignStatus.Paused,
                // AdvertisingChannelType must be SMART.
                AdvertisingChannelType = AdvertisingChannelType.Smart,
                // AdvertisingChannelSubType must be SMART_CAMPAIGN.
                AdvertisingChannelSubType = AdvertisingChannelSubType.SmartCampaign,
                // Assign the resource name with a temporary ID.
                ResourceName =
                    ResourceNames.Campaign(customerId, SMART_CAMPAIGN_TEMPORARY_ID),
                // Set the budget using the given budget resource name.
                CampaignBudget =
                    ResourceNames.CampaignBudget(customerId, BUDGET_TEMPORARY_ID),

                // Declare whether or not this campaign contains political ads targeting the EU.
                ContainsEuPoliticalAdvertising = EuPoliticalAdvertisingStatus.DoesNotContainEuPoliticalAdvertising,
            }
        }
    };
}
AddSmartCampaign.cs
      

PHP

private static function createSmartCampaignOperation(int $customerId): MutateOperation
{
    // Creates the campaign object.
    $campaign = new Campaign(
        [
        'name' => "Smart campaign #" . Helper::getPrintableDatetime(),
        // Sets the campaign status as PAUSED. The campaign is the only entity in the mutate
        // request that should have its' status set.
        'status' => CampaignStatus::PAUSED,
        // The advertising channel type is required to be SMART.
        'advertising_channel_type' => AdvertisingChannelType::SMART,
        // The advertising channel sub type is required to be SMART_CAMPAIGN.
        'advertising_channel_sub_type' => AdvertisingChannelSubType::SMART_CAMPAIGN,
        // Assigns the resource name with a temporary ID.
        'resource_name' =>
            ResourceNames::forCampaign($customerId, self::SMART_CAMPAIGN_TEMPORARY_ID),
        // Sets the budget using the given budget resource name.
        'campaign_budget' =>
            ResourceNames::forCampaignBudget($customerId, self::BUDGET_TEMPORARY_ID),
        // Declare whether or not this campaign serves political ads targeting the EU.
        'contains_eu_political_advertising' =>
            EuPoliticalAdvertisingStatus::DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING
        ]
    );

    // Creates the MutateOperation that creates the campaign.
    return new MutateOperation(
        [
        'campaign_operation' => new CampaignOperation(['create' => $campaign])
        ]
    );
}
AddSmartCampaign.php
      

Python

def create_smart_campaign_operation(
    client: GoogleAdsClient, customer_id: str
) -> MutateOperation:
    """Creates a MutateOperation that creates a new Smart campaign.

    A temporary ID will be assigned to this campaign so that it can
    be referenced by other objects being created in the same Mutate request.

    Args:
        client: an initialized GoogleAdsClient instance.
        customer_id: a client customer ID.

    Returns:
        a MutateOperation that creates a campaign.
    """
    mutate_operation: MutateOperation = client.get_type("MutateOperation")
    campaign_operation: CampaignOperation = mutate_operation.campaign_operation
    campaign: Campaign = campaign_operation.create
    campaign.name = f"Smart campaign #{uuid4()}"
    # Set the campaign status as PAUSED. The campaign is the only entity in
    # the mutate request that should have its' status set.
    campaign.status = client.enums.CampaignStatusEnum.PAUSED
    # Campaign.AdvertisingChannelType is required to be SMART.
    campaign.advertising_channel_type = (
        client.enums.AdvertisingChannelTypeEnum.SMART
    )
    # Campaign.AdvertisingChannelSubType is required to be SMART_CAMPAIGN.
    campaign.advertising_channel_sub_type = (
        client.enums.AdvertisingChannelSubTypeEnum.SMART_CAMPAIGN
    )
    # Assign the resource name with a temporary ID.
    campaign.resource_name = client.get_service(
        "CampaignService"
    ).campaign_path(customer_id, _SMART_CAMPAIGN_TEMPORARY_ID)
    # Set the budget using the given budget resource name.
    campaign.campaign_budget = client.get_service(
        "CampaignBudgetService"
    ).campaign_budget_path(customer_id, _BUDGET_TEMPORARY_ID)

    # Declare whether or not this campaign serves political ads targeting the
    # EU. Valid values are:
    #   CONTAINS_EU_POLITICAL_ADVERTISING
    #   DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING
    campaign.contains_eu_political_advertising = (
        client.enums.EuPoliticalAdvertisingStatusEnum.DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING
    )

    return mutate_operation
add_smart_campaign.py
      

Ruby

# Creates a mutate_operation that creates a new Smart campaign.
# A temporary ID will be assigned to this campaign so that it can
# be referenced by other objects being created in the same mutate request.
def create_smart_campaign_operation(
    client,
    customer_id)
  mutate_operation = client.operation.mutate do |m|
    m.campaign_operation = client.operation.create_resource.campaign do |c|
      c.name = "Smart campaign ##{(Time.new.to_f * 1000).to_i}"
      # Sets the campaign status as PAUSED. The campaign is the only entity in
      # the mutate request that should have its' status set.
      c.status = :PAUSED
      # campaign.advertising_channel_type is required to be SMART.
      c.advertising_channel_type = :SMART
      # campaign.advertising_channel_sub_type is required to be SMART_CAMPAIGN.
      c.advertising_channel_sub_type = :SMART_CAMPAIGN
      # Assigns the resource name with a temporary ID.
      c.resource_name = client.path.campaign(customer_id, SMART_CAMPAIGN_TEMPORARY_ID)
      c.campaign_budget = client.path.campaign_budget(customer_id, BUDGET_TEMPORARY_ID)
      # Declare whether or not this campaign serves political ads targeting the EU.
      # Valid values are CONTAINS_EU_POLITICAL_ADVERTISING and
      # DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING.
      c.contains_eu_political_advertising = :DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING
    end
  end

  mutate_operation
end
add_smart_campaign.rb
      

Perl

# Creates a MutateOperation that creates a new Smart campaign.
# A temporary ID will be assigned to this campaign so that it can be referenced
# by other objects being created in the same Mutate request.
sub _create_smart_campaign_operation {
  my ($customer_id) = @_;

  return
    Google::Ads::GoogleAds::V25::Services::GoogleAdsService::MutateOperation->
    new({
      campaignOperation =>
        Google::Ads::GoogleAds::V25::Services::CampaignService::CampaignOperation
        ->new({
          create => Google::Ads::GoogleAds::V25::Resources::Campaign->new({
              name => "Smart campaign #" . uniqid(),
              # Set the campaign status as PAUSED. The campaign is the only
              # entity in the mutate request that should have its status set.
              status => PAUSED,
              # AdvertisingChannelType must be SMART.
              advertisingChannelType => SMART,
              # AdvertisingChannelSubType must be SMART_CAMPAIGN.
              advertisingChannelSubType =>
                Google::Ads::GoogleAds::V25::Enums::AdvertisingChannelSubTypeEnum::SMART_CAMPAIGN,
              # Assign the resource name with a temporary ID.
              resourceName =>
                Google::Ads::GoogleAds::V25::Utils::ResourceNames::campaign(
                $customer_id, SMART_CAMPAIGN_TEMPORARY_ID
                ),
              # Declare whether or not this campaign serves political ads targeting the EU.
              # Valid values are CONTAINS_EU_POLITICAL_ADVERTISING and
              # DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING.
              containsEuPoliticalAdvertising =>
                DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING,
              # Set the budget using the given budget resource name.
              campaignBudget =>
                Google::Ads::GoogleAds::V25::Utils::ResourceNames::campaign_budget(
                $customer_id, BUDGET_TEMPORARY_ID
                )})})});
}
add_smart_campaign.pl
      

curl

Nota:anche se qui non viene fornito un esempio di codice REST diretto per questo passaggio, puoi ottenerlo utilizzando una richiesta REST manuale.

Consulta la documentazione dell'interfaccia REST dell'API Google Ads e le pagine di riferimento specifiche per il metodo. Dovrai creare il payload JSON in base alle definizioni proto.

Risorse chiave:

• Utilizzo di REST
• Struttura dell'interfaccia REST
• Mappature dei campi JSON
• Consulta il riferimento API REST per il servizio e il metodo specifici.

Creare un'impostazione della campagna intelligente

La risorsa SmartCampaignSetting viene utilizzata solo per configurare le campagne smart. Questa risorsa non può essere configurata a meno che non esista una campagna intelligente a cui può fare riferimento. Le impostazioni delle campagne intelligenti sono uniche per questo motivo. Puoi considerarle come un'estensione della risorsa Campaign principale.

Poiché un'impostazione di una campagna intelligente è strettamente legata a una campagna, non può essere configurata utilizzando un'operazione create. Deve essere configurato in un'operazione update.

A differenza di risorse come gli oggetti AdGroup, che hanno un campo campaign che specifica a quale campagna appartengono, le impostazioni delle campagne intelligenti devono avere i nomi delle risorse aggiornati direttamente utilizzando lo stesso ID della campagna. La configurazione di un'impostazione della campagna intelligente è simile all'utilizzo di una risorsa separata per aggiornare una campagna.

Requisiti chiave per le impostazioni delle campagne intelligenti:

• Deve esistere un Campaign a cui fare riferimento.
• La relazione con il relativo Campaign è definita nel relativo resource_name, non in un campo campaign.
• Devi impostare business_profile_location oppure final_url e business_name insieme.
• Devi aggiungere un update_mask all'operazione update, anche quando configuri l'impostazione per la prima volta.
• Tutte le campagne smart devono avere una pagina di destinazione, che può essere impostata utilizzando un final_url o attivando una pagina di destinazione automatica, che crea una pagina di destinazione per la tua campagna utilizzando le informazioni del business_profile_location specificato.

Java

private MutateOperation createSmartCampaignSettingOperation(
    long customerId, String businessProfileLocation, String businessName) {
  MutateOperation.Builder builder = MutateOperation.newBuilder();
  SmartCampaignSetting.Builder settingBuilder =
      builder
          .getSmartCampaignSettingOperationBuilder()
          .getUpdateBuilder()
          // Sets a temporary ID in the campaign setting's resource name to associate it with
          // the campaign created in the previous step.
          .setResourceName(
              ResourceNames.smartCampaignSetting(customerId, SMART_CAMPAIGN_TEMPORARY_ID));
  // Configures the SmartCampaignSetting using many of the same details used to
  // generate a budget suggestion.
  settingBuilder
      .setFinalUrl(LANDING_PAGE_URL)
      .setAdvertisingLanguageCode(LANGUAGE_CODE)
      .getPhoneNumberBuilder()
      .setCountryCode(COUNTRY_CODE)
      .setPhoneNumber(PHONE_NUMBER);

  // It's required that either a business profile location resource name or a business name is
  // added to the SmartCampaignSetting.
  if (businessProfileLocation != null) {
    settingBuilder.setBusinessProfileLocation(businessProfileLocation);
  } else {
    settingBuilder.setBusinessName(businessName);
  }
  builder
      .getSmartCampaignSettingOperationBuilder()
      .setUpdateMask(FieldMasks.allSetFieldsOf(settingBuilder.build()));
  return builder.build();
}
AddSmartCampaign.java
      

C#

/// <summary>
/// Creates a MutateOperation to create a new SmartCampaignSetting. SmartCampaignSettings
/// are unique in that they only support UPDATE operations, which are used to update and
/// create them. Below we will use a temporary ID in the resource name to associate it with
/// the campaign created in the previous step.
/// </summary>
/// <param name="customerId">The Google Ads customer ID.</param>
/// <param name="businessProfileLocation">The identifier of a Business Profile location.</param>
/// <param name="businessName">The name of a Business Profile business.</param>
/// <returns>A MutateOperation that creates a SmartCampaignSetting.</returns>
private MutateOperation CreateSmartCampaignSettingOperation(long customerId,
    string businessProfileLocation, string businessName)
{
    SmartCampaignSetting smartCampaignSetting = new SmartCampaignSetting
    {
        // Set a temporary ID in the campaign setting's resource name to associate it with
        // the campaign created in the previous step.
        ResourceName =
            ResourceNames.SmartCampaignSetting(customerId, SMART_CAMPAIGN_TEMPORARY_ID),
        // Below we configure the SmartCampaignSetting using many of the same details used
        // to generate a budget suggestion.
        PhoneNumber = new SmartCampaignSetting.Types.PhoneNumber
        {
            CountryCode = COUNTRY_CODE,
            PhoneNumber_ = PHONE_NUMBER
        },
        FinalUrl = LANDING_PAGE_URL,
        AdvertisingLanguageCode = LANGUAGE_CODE
    };

    // Either a business profile location or a business name must be added to the
    // SmartCampaignSetting.
    if (!string.IsNullOrEmpty(businessProfileLocation))
    {
        // Transform Google Business Location ID to a compatible format before
        // passing it onto the API.
        smartCampaignSetting.BusinessProfileLocation = businessProfileLocation;
    }
    else
    {
        smartCampaignSetting.BusinessName = businessName;
    }

    return new MutateOperation
    {
        SmartCampaignSettingOperation = new SmartCampaignSettingOperation
        {
            Update = smartCampaignSetting,
            // Set the update mask on the operation. This is required since the smart
            // campaign setting is created in an UPDATE operation. Here the update mask
            // will be a list of all the fields that were set on the SmartCampaignSetting.
            UpdateMask = FieldMasks.AllSetFieldsOf(smartCampaignSetting)
        }
    };
}
AddSmartCampaign.cs
      

PHP

private static function createSmartCampaignSettingOperation(
    int $customerId,
    ?string $businessProfileLocationResourceName,
    ?string $businessName
): MutateOperation {
    // Creates the smart campaign setting object.
    $smartCampaignSetting = new SmartCampaignSetting(
        [
        // Sets a temporary ID in the campaign setting's resource name to associate it with
        // the campaign created in the previous step.
        'resource_name' => ResourceNames::forSmartCampaignSetting(
            $customerId,
            self::SMART_CAMPAIGN_TEMPORARY_ID
        ),
        // Below we configure the SmartCampaignSetting using many of the same details used to
        // generate a budget suggestion.
        'phone_number' => new PhoneNumber(
            [
            'country_code' => self::COUNTRY_CODE,
            'phone_number' => self::PHONE_NUMBER
            ]
        ),
        'final_url' => self::LANDING_PAGE_URL,
        'advertising_language_code' => self::LANGUAGE_CODE,
        ]
    );

    // It's required that either a business profile location resource name or a business name is
    // added to the SmartCampaignSetting.
    if ($businessProfileLocationResourceName) {
        $smartCampaignSetting->setBusinessProfileLocation($businessProfileLocationResourceName);
    } else {
        $smartCampaignSetting->setBusinessName($businessName);
    }

    // Creates the MutateOperation that creates the smart campaign setting with an update.
    return new MutateOperation(
        [
        'smart_campaign_setting_operation' => new SmartCampaignSettingOperation(
            [
            'update' => $smartCampaignSetting,
            // Sets the update mask on the operation. This is required since the smart campaign
            // setting is created in an UPDATE operation. Here the update mask will be a list
            // of all the fields that were set on the SmartCampaignSetting.
            'update_mask' => FieldMasks::allSetFieldsOf($smartCampaignSetting)
            ]
        )
        ]
    );
}
AddSmartCampaign.php
      

Python

def create_smart_campaign_setting_operation(
    client: GoogleAdsClient,
    customer_id: str,
    business_profile_location: Optional[str],
    business_name: Optional[str],
) -> MutateOperation:
    """Creates a MutateOperation to create a new SmartCampaignSetting.

    SmartCampaignSettings are unique in that they only support UPDATE
    operations, which are used to update and create them. Below we will
    use a temporary ID in the resource name to associate it with the
    campaign created in the previous step.

    Args:
        client: an initialized GoogleAdsClient instance.
        customer_id: a client customer ID.
        business_profile_location: the resource name of a Business Profile
          location.
        business_name: the name of a Business Profile.

    Returns:
        a MutateOperation that creates a SmartCampaignSetting.
    """
    mutate_operation: MutateOperation = client.get_type("MutateOperation")
    smart_campaign_setting_operation: SmartCampaignSettingOperation = (
        mutate_operation.smart_campaign_setting_operation
    )
    smart_campaign_setting: SmartCampaignSetting = (
        smart_campaign_setting_operation.update
    )
    # Set a temporary ID in the campaign setting's resource name to associate it
    # with the campaign created in the previous step.
    smart_campaign_setting.resource_name = client.get_service(
        "SmartCampaignSettingService"
    ).smart_campaign_setting_path(customer_id, _SMART_CAMPAIGN_TEMPORARY_ID)

    # Below we configure the SmartCampaignSetting using many of the same
    # details used to generate a budget suggestion.
    smart_campaign_setting.phone_number.country_code = _COUNTRY_CODE
    smart_campaign_setting.phone_number.phone_number = _PHONE_NUMBER
    smart_campaign_setting.final_url = _LANDING_PAGE_URL
    smart_campaign_setting.advertising_language_code = _LANGUAGE_CODE

    # Set either of the business_profile_location or business_name, depending on
    # whichever is provided.
    if business_profile_location:
        smart_campaign_setting.business_profile_location = (
            business_profile_location
        )
    else:
        smart_campaign_setting.business_name = business_name

    # Set the update mask on the operation. This is required since the smart
    # campaign setting is created in an UPDATE operation. Here the update
    # mask will be a list of all the fields that were set on the
    # SmartCampaignSetting.
    client.copy_from(
        smart_campaign_setting_operation.update_mask,
        protobuf_helpers.field_mask(None, smart_campaign_setting._pb),
    )

    return mutate_operation
add_smart_campaign.py
      

Ruby

# Creates a mutate_operation to create a new smart_campaign_setting.
# smart_campaign_settings are unique in that they only support UPDATE
# operations, which are used to update and create them. Below we will
# use a temporary ID in the resource name to associate it with the
# campaign created in the previous step.
def create_smart_campaign_setting_operation(
  client,
  customer_id,
  business_profile_location,
  business_name)
  mutate_operation = client.operation.mutate do |m|
    m.smart_campaign_setting_operation =
      client.operation.update_resource.smart_campaign_setting(
        # Sets a temporary ID in the campaign setting's resource name to
        # associate it with the campaign created in the previous step.
        client.path.smart_campaign_setting(
          customer_id, SMART_CAMPAIGN_TEMPORARY_ID)
      ) do |scs|
      # Below we configure the smart_campaign_setting using many of the same
      # details used to generate a budget suggestion.
      scs.phone_number = client.resource.phone_number do |p|
        p.country_code = COUNTRY_CODE
        p.phone_number = PHONE_NUMBER
      end
      scs.final_url = LANDING_PAGE_URL
      scs.advertising_language_code = LANGUAGE_CODE
      # It's required that either a business location ID or a business name is
      # added to the smart_campaign_setting.
      if business_profile_location
        scs.business_profile_location = business_profile_location
      else
        scs.business_name = business_name
      end
    end
  end

  mutate_operation
end
add_smart_campaign.rb
      

Perl

# Creates a MutateOperation to create a new SmartCampaignSetting.
# SmartCampaignSettings are unique in that they only support UPDATE operations,
# which are used to update and create them. Below we will use a temporary ID in
# the resource name to associate it with the campaign created in the previous step.
sub _create_smart_campaign_setting_operation {
  my ($customer_id, $business_profile_location, $business_name) = @_;

  my $smart_campaign_setting =
    Google::Ads::GoogleAds::V25::Resources::SmartCampaignSetting->new({
      # Set a temporary ID in the campaign setting's resource name to associate it
      # with the campaign created in the previous step.
      resourceName =>
        Google::Ads::GoogleAds::V25::Utils::ResourceNames::smart_campaign_setting(
        $customer_id, SMART_CAMPAIGN_TEMPORARY_ID
        ),
      # Below we configure the SmartCampaignSetting using many of the same
      # details used to generate a budget suggestion.
      phoneNumber => Google::Ads::GoogleAds::V25::Resources::PhoneNumber->new({
          countryCode => COUNTRY_CODE,
          phoneNumber => PHONE_NUMBER
        }
      ),
      finalUrl                => LANDING_PAGE_URL,
      advertisingLanguageCode => LANGUAGE_CODE
    });

  # It's required that either a business profile location or a business name is
  # added to the SmartCampaignSetting.
  if (defined $business_profile_location) {
    $smart_campaign_setting->{businessProfileLocation} =
      $business_profile_location;
  } else {
    $smart_campaign_setting->{businessName} = $business_name;
  }

  return
    Google::Ads::GoogleAds::V25::Services::GoogleAdsService::MutateOperation->
    new({
      smartCampaignSettingOperation =>
        Google::Ads::GoogleAds::V25::Services::SmartCampaignSettingService::SmartCampaignSettingOperation
        ->new({
          update => $smart_campaign_setting,
          # Set the update mask on the operation. This is required since the
          # smart campaign setting is created in an UPDATE operation. Here the
          # update mask will be a list of all the fields that were set on the
          # SmartCampaignSetting.
          updateMask => all_set_fields_of($smart_campaign_setting)})});
}
add_smart_campaign.pl
      

curl

Nota:anche se qui non viene fornito un esempio di codice REST diretto per questo passaggio, puoi ottenerlo utilizzando una richiesta REST manuale.

Consulta la documentazione dell'interfaccia REST dell'API Google Ads e le pagine di riferimento specifiche per il metodo. Dovrai creare il payload JSON in base alle definizioni proto.

Risorse chiave:

• Utilizzo di REST
• Struttura dell'interfaccia REST
• Mappature dei campi JSON
• Consulta il riferimento API REST per il servizio e il metodo specifici.

Pagine di destinazione

La campagna intelligente deve avere una pagina di destinazione a cui indirizzare gli spettatori. Puoi fornire un final_url per utilizzare un URL del sito web oppure far creare una pagina di destinazione per te attivando le pagine di destinazione automatiche. La pagina di destinazione generata utilizza le informazioni del tuo profilo dell'attività.

Punto chiave :puoi fornire un final_url e un business_profile_location contemporaneamente. Il final_url viene utilizzato per la pagina di destinazione, mentre le informazioni del business_profile_location vengono utilizzate per ottimizzare gli annunci della campagna.

Per generare una pagina di destinazione per la tua campagna, devi fornire un identificatore business_profile_location, configurare il campo ad_optimized_business_profile_setting con un'istanza AdOptimizedBusinessProfileSetting (impostando il relativo campo secondario include_lead_form su false o true) e includere ad_optimized_business_profile_setting.include_lead_form in update_mask dell'operazione (l'inclusione del percorso non foglia ad_optimized_business_profile_setting in update_mask restituisce un errore FieldMaskError.FIELD_HAS_SUBFIELDS). Ecco un esempio di come configurare l'impostazione senza un modulo per i lead:

Java

SmartCampaignSetting smartCampaignSetting =
    SmartCampaignSetting.newBuilder()
        .setBusinessProfileLocation(businessProfileLocation)
        // Configures the ad-optimized Business Profile setting with
        // include_lead_form set to false.
        .setAdOptimizedBusinessProfileSetting(
            AdOptimizedBusinessProfileSetting.newBuilder()
                .setIncludeLeadForm(false)
                .build())
        .build();

C#

SmartCampaignSetting smartCampaignSetting = new SmartCampaignSetting()
{
    BusinessProfileLocation = businessProfileLocation,
    // Configures the ad-optimized Business Profile setting with
    // include_lead_form set to false.
    AdOptimizedBusinessProfileSetting =
        new SmartCampaignSetting.Types.AdOptimizedBusinessProfileSetting
        {
            IncludeLeadForm = false
        }
};

PHP

$smartCampaignSetting = new SmartCampaignSetting([
    'business_profile_location' => $business_profile_location,
    // Configures the ad-optimized Business Profile setting with
    // include_lead_form set to false.
    'ad_optimized_business_profile_setting' =>
        new AdOptimizedBusinessProfileSetting([
            'include_lead_form' => false
        ]),
]);

Python

smart_campaign_setting = client.get_type("SmartCampaignSetting")
smart_campaign_setting.business_profile_location = business_profile_location
# Configures the ad-optimized Business Profile setting with
# include_lead_form set to false.
setting = smart_campaign_setting.ad_optimized_business_profile_setting
setting.include_lead_form = False

Ruby

smart_campaign_setting = client.resource.smart_campaign_setting do |s|
  s.business_profile_location = business_profile_location
  # Configures the ad-optimized Business Profile setting with
  # include_lead_form set to false.
  s.ad_optimized_business_profile_setting =
    client.resource.ad_optimized_business_profile_setting do |a|
      a.include_lead_form = false
    end
end

Perl

my $smart_campaign_setting =
  Google::Ads::GoogleAds::V25::Resources::SmartCampaignSetting
  ->new({
    businessProfileLocation => $business_profile_location,
    # Configures the ad-optimized Business Profile setting with
    # include_lead_form set to false.
    adOptimizedBusinessProfileSetting =>
      Google::Ads::GoogleAds::V25::Resources::AdOptimizedBusinessProfileSetting
      ->new({
        includeLeadForm => "false"
      })
  });

Per includere un modulo per i lead nella pagina di destinazione generata in modo che i potenziali clienti possano contattarti direttamente compilando un modulo, imposta include_lead_form su true e includi ad_optimized_business_profile_setting.include_lead_form nel tuo update_mask. Ecco un esempio di come abilitarlo:

Java

SmartCampaignSetting smartCampaignSetting =
    SmartCampaignSetting.newBuilder()
        .setBusinessProfileLocation(businessProfileLocation)
        // Sets the AdOptimizedBusinessProfileSetting.include_lead_form
        // field to true.
        .setAdOptimizedBusinessProfileSetting(
            AdOptimizedBusinessProfileSetting.newBuilder()
                .setIncludeLeadForm(true)
                .build())
        .build();

C#

SmartCampaignSetting smartCampaignSetting = new SmartCampaignSetting()
{
    BusinessProfileLocation = businessProfileLocation,
    // Sets the AdOptimizedBusinessProfileSetting.include_lead_form
    // field to true.
    AdOptimizedBusinessProfileSetting =
        new SmartCampaignSetting.Types.AdOptimizedBusinessProfileSetting
        {
            IncludeLeadForm = true
        }
};

PHP

$smartCampaignSetting = new SmartCampaignSetting([
    'business_profile_location' => $business_profile_location,
    // Sets the AdOptimizedBusinessProfileSetting.include_lead_form field
    // to true.
    'ad_optimized_business_profile_setting' =>
        new AdOptimizedBusinessProfileSetting([
            'include_lead_form' => true
        ]),
]);

Python

smart_campaign_setting = client.get_type("SmartCampaignSetting")
smart_campaign_setting.business_profile_location = business_profile_location
# Sets the AdOptimizedBusinessProfileSetting.include_lead_form field to
# true.
setting = smart_campaign_setting.ad_optimized_business_profile_setting
setting.include_lead_form = True

Ruby

smart_campaign_setting = client.resource.smart_campaign_setting do |s|
  s.business_profile_location = business_profile_location
  # Sets the AdOptimizedBusinessProfileSetting.include_lead_form field to
  # true.
  s.ad_optimized_business_profile_setting =
    client.resource.ad_optimized_business_profile_setting do |a|
      a.include_lead_form = true
    end
end

Perl

my $smart_campaign_setting =
  Google::Ads::GoogleAds::V25::Resources::SmartCampaignSetting
  ->new({
    businessProfileLocation => $business_profile_location,
    # Sets the AdOptimizedBusinessProfileSetting.include_lead_form field to
    # true.
    adOptimizedBusinessProfileSetting =>
      Google::Ads::GoogleAds::V25::Resources::AdOptimizedBusinessProfileSetting
      ->new({
        includeLeadForm => "true"
      })
  });