Snippets estruturados

Com os snippets estruturados, você pode destacar aspectos específicos de produtos e serviços nos seus anúncios. Essas extensões de anúncio apresentam um contexto sobre a natureza e a variedade dos seus produtos e serviços antes de os visitantes clicarem para acessar seu site.

Cada snippet contém um cabeçalho e uma lista de recursos que você gostaria de destacar. É possível exibir até dois títulos por vez no seu anúncio. Com base em algoritmos, escolhemos a melhor combinação de títulos a ser exibida. Sendo assim, recomendamos adicionar o máximo possível de títulos relevantes para sua empresa.

Veja abaixo um exemplo da aparência de um anúncio que usa snippets. O snippet está destacado com um retângulo vermelho: um cabeçalho "Estilos" com quatro valores (Chukka, Combat, Cowboy, Chelsea).

Cabeçalho

O cabeçalho define a categoria do seu snippet. Seu texto precisa corresponder exatamente a uma das categorias desta lista (para ter acesso às traduções, consulte esta lista). São alguns exemplos de cabeçalhos: comodidades, marcas, destinos, modelos e estilos.

Valores

Os valores são uma lista de produtos/serviços que você gostaria de destacar. Considere os seguintes aspectos:

  • Você precisará de um mínimo de três valores, mas o número recomendado é quatro.
  • Cada valor de snippet tem um limite de 25 caracteres.
  • Para celulares, é melhor limitar o texto do snippet para menos de 12 caracteres.
  • Os valores de snippet precisam estar em conformidade com as nossas políticas e ser indicados para menores.

Como adicionar snippets estruturados aos seus anúncios

É possível adicionar os snippets estruturados no nível do cliente, da campanha ou do grupo de anúncios usando os serviços de configuração de extensões.

De modo semelhante a outras extensões de anúncio, você cria e adiciona um item de feed à configuração relevante da extensão. O snippet de código a seguir mostra como criar um novo StructuredSnippetFeedItem e associá-lo a uma campanha.

package adwords.axis.v201609.extensions;

import com.google.api.ads.adwords.axis.factory.AdWordsServices;
import com.google.api.ads.adwords.axis.v201609.cm.ApiException;
import com.google.api.ads.adwords.axis.v201609.cm.CampaignExtensionSetting;
import com.google.api.ads.adwords.axis.v201609.cm.CampaignExtensionSettingOperation;
import com.google.api.ads.adwords.axis.v201609.cm.CampaignExtensionSettingReturnValue;
import com.google.api.ads.adwords.axis.v201609.cm.CampaignExtensionSettingServiceInterface;
import com.google.api.ads.adwords.axis.v201609.cm.ExtensionFeedItem;
import com.google.api.ads.adwords.axis.v201609.cm.ExtensionSetting;
import com.google.api.ads.adwords.axis.v201609.cm.FeedType;
import com.google.api.ads.adwords.axis.v201609.cm.Operator;
import com.google.api.ads.adwords.axis.v201609.cm.StructuredSnippetFeedItem;
import com.google.api.ads.adwords.lib.client.AdWordsSession;
import com.google.api.ads.common.lib.auth.OfflineCredentials;
import com.google.api.ads.common.lib.auth.OfflineCredentials.Api;
import com.google.api.client.auth.oauth2.Credential;
import java.rmi.RemoteException;

/**
 * This example adds structured snippets to a campaign. To create a campaign,
 * run {@code AddCampaigns}.
 *
 * <p>Credentials and properties in {@code fromFile()} are pulled from the
 * "ads.properties" file. See README for more info.
 */
public class AddStructuredSnippets {

  public static void main(String[] args) throws Exception {
    // Generate a refreshable OAuth2 credential.
    Credential oAuth2Credential = new OfflineCredentials.Builder()
        .forApi(Api.ADWORDS)
        .fromFile()
        .build()
        .generateCredential();

    // Construct an AdWordsSession.
    AdWordsSession session = new AdWordsSession.Builder()
        .fromFile()
        .withOAuth2Credential(oAuth2Credential)
        .build();

    AdWordsServices adWordsServices = new AdWordsServices();

    Long campaignId = Long.valueOf("INSERT_CAMPAIGN_ID");
    runExample(adWordsServices, session, campaignId);
  }

  public static void runExample(AdWordsServices adWordsServices, AdWordsSession session,
      Long campaignId) throws ApiException, RemoteException {

    StructuredSnippetFeedItem amenitiesStructuredSnippetFeedItem =
        createStructuredSnippetsFeedItem(
        "Amenities", new String[] {"Free Wi-Fi", "Breakfast", "Swimming Pool", "Fitness Center",
        "Restaurant"});

    StructuredSnippetFeedItem destinationsStructuredSnippetFeedItem =
        createStructuredSnippetsFeedItem(
        "Destinations", new String[] {"Paris", "London", "Berlin"});

    // Get the CampaignExtensionSettingService.
    CampaignExtensionSettingServiceInterface campaignExtensionSettingService =
        adWordsServices.get(session, CampaignExtensionSettingServiceInterface.class);

    CampaignExtensionSetting campaignExtensionSetting = new CampaignExtensionSetting();
    campaignExtensionSetting.setExtensionType(FeedType.STRUCTURED_SNIPPET);
    ExtensionSetting extensionSetting = new ExtensionSetting();
    extensionSetting.setExtensions(
        new ExtensionFeedItem[] {amenitiesStructuredSnippetFeedItem, 
            destinationsStructuredSnippetFeedItem});
    campaignExtensionSetting.setExtensionSetting(extensionSetting);

    CampaignExtensionSettingOperation operation = new CampaignExtensionSettingOperation();
    operation.setOperand(campaignExtensionSetting);
    operation.setOperator(Operator.ADD);

    // Create your campaign extension settings. This associates the structured snippet
    // with your campaign.
    campaignExtensionSetting.setCampaignId(campaignId);

    // Add the extensions.
    CampaignExtensionSettingReturnValue returnValue =
        campaignExtensionSettingService.mutate(new CampaignExtensionSettingOperation[] {operation});
    if (returnValue.getValue() != null && returnValue.getValue().length > 0) {
      CampaignExtensionSetting newExtensionSetting = returnValue.getValue(0);
      System.out.printf("Extension setting with type %s was added to campaign ID %d.%n",
          newExtensionSetting.getExtensionType(), newExtensionSetting.getCampaignId());
    } else {
      System.out.println("No extension settings were created.");
    }
  }

  private static StructuredSnippetFeedItem createStructuredSnippetsFeedItem(String header,
      String[] values){
    StructuredSnippetFeedItem structuredSnippetFeedItem = new StructuredSnippetFeedItem();
    structuredSnippetFeedItem.setHeader(header);
    structuredSnippetFeedItem.setValues(values);
    return structuredSnippetFeedItem;
  }
}

Relatórios de snippets estruturados

O Relatório de item do feed do marcador exibe o desempenho dos itens do feed e pode ser usado para mostrar as estatísticas de cada snippet estruturado. Além disso, o Relatório de marcadores exibe o desempenho das extensões de anúncio com base em feeds e pode ser usado para mostrar as estatísticas de todos os snippets estruturados. Para ver somente as estatísticas das extensões de anúncio de snippets estruturados, filtre o campo ExtensionPlaceHolderType por IDs de tipo de marcador com o valor de 24.

Enviar comentários sobre…

Precisa de ajuda? Acesse nossa página de suporte.