Komponenty w kampanii Performance Max

Kampanie Performance Max mają pewne unikalne cechy dotyczące komponentów.

  1. Wymagana jest minimalna liczba komponentów różnych typów.
  2. Komponenty są zgrupowane w kolekcji zwanej AssetGroup, która jest unikalna dla kampanii Performance Max.
  3. Niektóre komponenty mogą być generowane automatycznie przez uczenie maszynowe.

Przykładowy kod

Ten fragment kodu pokazuje, jak utworzyć niezbędne powtórzone komponenty w nowym żądaniu:

Java

/** Creates multiple text assets and returns the list of resource names. */
private List<String> createMultipleTextAssets(
    GoogleAdsClient googleAdsClient, long customerId, List<String> texts) {
  List<MutateOperation> mutateOperations = new ArrayList<>();
  for (String text : texts) {
    Asset asset = Asset.newBuilder().setTextAsset(TextAsset.newBuilder().setText(text)).build();
    AssetOperation assetOperation = AssetOperation.newBuilder().setCreate(asset).build();
    mutateOperations.add(MutateOperation.newBuilder().setAssetOperation(assetOperation).build());
  }

  List<String> assetResourceNames = new ArrayList<>();
  // Creates the service client.
  try (GoogleAdsServiceClient googleAdsServiceClient =
      googleAdsClient.getLatestVersion().createGoogleAdsServiceClient()) {
    // Sends the operations in a single Mutate request.
    MutateGoogleAdsResponse response =
        googleAdsServiceClient.mutate(Long.toString(customerId), mutateOperations);
    for (MutateOperationResponse result : response.getMutateOperationResponsesList()) {
      if (result.hasAssetResult()) {
        assetResourceNames.add(result.getAssetResult().getResourceName());
      }
    }
    printResponseDetails(response);
  }
  return assetResourceNames;
}

      

C#

/// <summary>
/// Creates multiple text assets and returns the list of resource names.
/// </summary>
/// <param name="client">The Google Ads Client.</param>
/// <param name="customerId">The customer's ID.</param>
/// <param name="texts">The texts to add.</param>
/// <returns>A list of asset resource names.</returns>
private List<string> CreateMultipleTextAssets(
    GoogleAdsClient client,
    long customerId,
    string[] texts)
{
    // Get the GoogleAdsService.
    GoogleAdsServiceClient googleAdsServiceClient =
        client.GetService(Services.V20.GoogleAdsService);

    MutateGoogleAdsRequest request = new MutateGoogleAdsRequest()
    {
        CustomerId = customerId.ToString()
    };

    foreach (string text in texts)
    {
        request.MutateOperations.Add(
            new MutateOperation()
            {
                AssetOperation = new AssetOperation()
                {
                    Create = new Asset()
                    {
                        TextAsset = new TextAsset()
                        {
                            Text = text
                        }
                    }
                }
            }
        );
    }

    // Send the operations in a single Mutate request.
    MutateGoogleAdsResponse response = googleAdsServiceClient.Mutate(request);

    List<string> assetResourceNames = new List<string>();

    foreach (MutateOperationResponse operationResponse in response.MutateOperationResponses)
    {
        MutateAssetResult assetResult = operationResponse.AssetResult;
        assetResourceNames.Add(assetResult.ResourceName);
    }

    PrintResponseDetails(response);

    return assetResourceNames;
}

      

PHP

private static function createMultipleTextAssets(
    GoogleAdsClient $googleAdsClient,
    int $customerId,
    array $texts
): array {
    // Here again, we use the GoogleAdService to create multiple text assets in a single
    // request.
    $operations = [];
    foreach ($texts as $text) {
        // Creates a mutate operation for a text asset.
        $operations[] = new MutateOperation([
            'asset_operation' => new AssetOperation([
                'create' => new Asset(['text_asset' => new TextAsset(['text' => $text])])
            ])
        ]);
    }

    // Issues a mutate request to add all assets.
    $googleAdsService = $googleAdsClient->getGoogleAdsServiceClient();
    /** @var MutateGoogleAdsResponse $mutateGoogleAdsResponse */
    $mutateGoogleAdsResponse =
        $googleAdsService->mutate(MutateGoogleAdsRequest::build($customerId, $operations));

    $assetResourceNames = [];
    foreach ($mutateGoogleAdsResponse->getMutateOperationResponses() as $response) {
        /** @var MutateOperationResponse $response */
        $assetResourceNames[] = $response->getAssetResult()->getResourceName();
    }
    self::printResponseDetails($mutateGoogleAdsResponse);

    return $assetResourceNames;
}
      

Python

def create_multiple_text_assets(client, customer_id, texts):
    """Creates multiple text assets and returns the list of resource names.

    Args:
        client: an initialized GoogleAdsClient instance.
        customer_id: a client customer ID.
        texts: a list of strings, each of which will be used to create a text
          asset.

    Returns:
        asset_resource_names: a list of asset resource names.
    """
    # Here again we use the GoogleAdService to create multiple text
    # assets in a single request.
    googleads_service = client.get_service("GoogleAdsService")

    operations = []
    for text in texts:
        mutate_operation = client.get_type("MutateOperation")
        asset = mutate_operation.asset_operation.create
        asset.text_asset.text = text
        operations.append(mutate_operation)

    # Send the operations in a single Mutate request.
    response = googleads_service.mutate(
        customer_id=customer_id,
        mutate_operations=operations,
    )
    asset_resource_names = []
    for result in response.mutate_operation_responses:
        if result._pb.HasField("asset_result"):
            asset_resource_names.append(result.asset_result.resource_name)
    print_response_details(response)
    return asset_resource_names
      

Ruby

# Creates multiple text assets and returns the list of resource names.
def create_multiple_text_assets(client, customer_id, texts)
  operations = texts.map do |text|
    client.operation.mutate do |m|
      m.asset_operation = client.operation.create_resource.asset do |asset|
        asset.text_asset = client.resource.text_asset do |text_asset|
          text_asset.text = text
        end
      end
    end
  end

  # Send the operations in a single Mutate request.
  response = client.service.google_ads.mutate(
    customer_id: customer_id,
    mutate_operations: operations,
  )

  asset_resource_names = []
  response.mutate_operation_responses.each do |result|
    if result.asset_result
      asset_resource_names.append(result.asset_result.resource_name)
    end
  end
  print_response_details(response)
  asset_resource_names
end
      

Perl

sub create_multiple_text_assets {
  my ($api_client, $customer_id, $texts) = @_;

  # Here again we use the GoogleAdService to create multiple text assets in a
  # single request.
  my $operations = [];
  foreach my $text (@$texts) {
    # Create a mutate operation for a text asset.
    push @$operations,
      Google::Ads::GoogleAds::V20::Services::GoogleAdsService::MutateOperation
      ->new({
        assetOperation =>
          Google::Ads::GoogleAds::V20::Services::AssetService::AssetOperation->
          new({
            create => Google::Ads::GoogleAds::V20::Resources::Asset->new({
                textAsset =>
                  Google::Ads::GoogleAds::V20::Common::TextAsset->new({
                    text => $text
                  })})})});
  }

  # Issue a mutate request to add all assets.
  my $mutate_google_ads_response = $api_client->GoogleAdsService()->mutate({
    customerId       => $customer_id,
    mutateOperations => $operations
  });

  my $asset_resource_names = [];
  foreach
    my $response (@{$mutate_google_ads_response->{mutateOperationResponses}})
  {
    push @$asset_resource_names, $response->{assetResult}{resourceName};
  }
  print_response_details($mutate_google_ads_response);

  return $asset_resource_names;
}
      

Komponenty tworzone automatycznie

Automatyzacja Google wykorzystująca systemy uczące się generuje w razie potrzeby dodatkowe komponenty, aby obejmować wszystkie odpowiednie kanały. Komponenty są automatycznie łączone ze sobą i dopasowywane zależnie od tego, w którym kanale Google Ads (m.in. w YouTube, Gmailu lub wyszukiwarce) wyświetla się Twoja reklama.

Komponenty tekstowe

Możesz powiązać plik danych o stronach na swoim koncie z kampanią Performance Max, aby automatycznie generować komponenty.

Aby połączyć plik z adresami stron docelowych z kampanią, zastosuj ten sam proces co w przypadku dynamicznych reklam w wyszukiwarce:

  1. Tworzenie komponentów do każdej strony witryny
  2. Pakowanie komponentów plików z adresami stron docelowych w obiekcie AssetSet
  3. Powiązywanie grupy plików z kampanią

Po powiązaniu pliku danych o stronach upewnij się, że AssetAutomationSetting typu TEXT_ASSET_AUTOMATION ma wartość OPTED_IN. Jest to ustawienie domyślne, jeśli podczas tworzenia kampanii nie ustawisz AssetAutomationSetting.

Włączenie tego ustawienia oznacza, że kampania może wykorzystywać treści ze strony docelowej, domeny i dostarczonych komponentów do dostosowywania reklam, gdy według prognoz może to zwiększyć ich skuteczność. Zalecamy pozostawienie tego ustawienia w stanie OPTED-IN.

Komponenty wideo

Jeśli do grupy komponentów kampanii Performance Max nie dodasz żadnego filmu, możemy wygenerować co najmniej 1 komponent wideo na podstawie komponentów z tej grupy. Jeśli nie chcesz, aby w Twojej kampanii Performance Max wyświetlały się filmy generowane automatycznie, możesz przesłać własny film. Spowoduje to przerwanie wyświetlania filmów generowanych automatycznie.

Inteligentna automatyzacja może ulepszać komponenty wideo w YouTube, dostosowując orientację filmu i inteligentnie go skracając, aby wyróżnić kluczowe momenty. Jeśli wolisz zachować oryginalne zasoby wideo, ustaw AssetAutomationSetting typu GENERATE_ENHANCED_YOUTUBE_VIDEOS na OPTED_OUT.