Эта страница переведена с помощью Cloud Translation API.

Создание и использование активов

Большинство типов ресурсов необходимо создать с помощью AssetService , прежде чем их можно будет использовать в рекламе. Исключением является тип TextAsset , поскольку он создается непосредственно во время создания объявления. Все остальные типы сначала необходимо загрузить в аккаунт рекламодателя, прежде чем их можно будет использовать.

Уровни ассоциации активов

Доступ к рекламным материалам обеспечивается путем их привязки к различным объектам в иерархии вашего аккаунта Google Ads. Уровень привязки зависит от типа материала и типа кампании. К распространенным ресурсам для управления этими связями относятся:

CustomerAsset : Для активов, связанных на уровне счета.
CampaignAsset : Для ресурсов, связанных с конкретной кампанией.
AdGroupAsset : Для ресурсов, связанных с определенной группой объявлений.
AssetGroupAsset : Для активов, связанных с группой активов в рамках кампаний Performance Max.

Выбор конкретной услуги и ресурса будет зависеть от того, чего вы хотите достичь.

активы бренда Performance Max

Хотя многие ресурсы в кампаниях Performance Max связаны с группами ресурсов с помощью AssetGroupAsset , ресурсы «Название компании» и «Логотип компании» являются исключением, если для кампании включены рекомендации по фирменному стилю. В этом случае они связаны напрямую на уровне кампании с помощью CampaignAsset с типами полей BUSINESS_NAME и LOGO соответственно. Если рекомендации по фирменному стилю отключены для кампании, то эти ресурсы необходимо прикрепить с помощью AssetGroupAsset . Дополнительные сведения см. в разделе «Ресурсы в Performance Max» .

Создать актив

При создании изображений и медиафайлов необходимо указывать уникальные имена. Если вы укажете существующее имя, будет создано новое имя путем добавления уникальной строки к существующему имени. Мы настоятельно рекомендуем использовать уникальные, описательные имена, чтобы упростить управление и идентификацию отдельных ресурсов по мере роста вашей коллекции.

В следующем примере показано, как создать новый графический ресурс из URL-адреса исходных данных изображения.

Java

private void runExample(GoogleAdsClient googleAdsClient, long customerId) throws IOException {
  byte[] imageData = ByteStreams.toByteArray(new URL(IMAGE_URL).openStream());

  // Create the image asset.
  ImageAsset imageAsset = ImageAsset.newBuilder().setData(ByteString.copyFrom(imageData)).build();

  // Creates an asset.
  Asset asset =
      Asset.newBuilder()
          // Provide a unique friendly name to identify your asset.
          // When there is an existing image asset with the same content but a different name, the
          // new name will be dropped silently.
          .setName("Marketing Image")
          .setType(AssetType.IMAGE)
          .setImageAsset(imageAsset)
          .build();

  // Creates the operation.
  AssetOperation operation = AssetOperation.newBuilder().setCreate(asset).build();

  // Creates the service client.
  try (AssetServiceClient assetServiceClient =
      googleAdsClient.getLatestVersion().createAssetServiceClient()) {
    // Issues a mutate request to add the asset.
    MutateAssetsResponse response =
        assetServiceClient.mutateAssets(Long.toString(customerId), ImmutableList.of(operation));
    // Prints the result.
    System.out.printf(
        "The image asset with resource name '%s' was created.%n",
        response.getResults(0).getResourceName());
  }
}UploadImageAsset.java

C#

public void Run(GoogleAdsClient client, long customerId)
{
    // Get the AssetServiceClient.
    AssetServiceClient assetService =
        client.GetService(Services.V22.AssetService);

    // Creates an image content.
    byte[] imageContent = MediaUtilities.GetAssetDataFromUrl(IMAGE_URL, client.Config);

    // Creates an image asset.
    ImageAsset imageAsset = new ImageAsset()
    {
        Data = ByteString.CopyFrom(imageContent),
        FileSize = imageContent.Length,
        MimeType = MimeType.ImageJpeg,
        FullSize = new ImageDimension()
        {
            HeightPixels = 315,
            WidthPixels = 600,
            Url = IMAGE_URL
        }
    };

    // Creates an asset.
    Asset asset = new Asset()
    {
        // Optional: Provide a unique friendly name to identify your asset.
        // If you specify the name field, then both the asset name and the image being
        // uploaded should be unique, and should not match another ACTIVE asset in this
        // customer account.
        // Name = 'Jupiter Trip #' + ExampleUtilities.GetRandomString(),
        Type = AssetType.Image,
        ImageAsset = imageAsset,
        // Provide a unique friendly name to identify your asset.
        // When there is an existing image asset with the same content but a different
        // name, the new name will be dropped silently.
        Name = "Marketing Image"
    };

    // Creates an asset operation.
    AssetOperation operation = new AssetOperation()
    {
        Create = asset
    };

    try
    {
        // Issues a mutate request to add the asset.
        MutateAssetsResponse response =
            assetService.MutateAssets(customerId.ToString(), new[] { operation });

        // Displays the result.
        Console.WriteLine($"Image asset with resource name: " +
            $"'{response.Results.First().ResourceName}' is created.");
    }
    catch (GoogleAdsException e)
    {
        Console.WriteLine("Failure:");
        Console.WriteLine($"Message: {e.Message}");
        Console.WriteLine($"Failure: {e.Failure}");
        Console.WriteLine($"Request ID: {e.RequestId}");
        throw;
    }
}UploadImageAsset.cs

PHP

public static function runExample(GoogleAdsClient $googleAdsClient, int $customerId)
{
    // Creates an image content.
    $imageContent = file_get_contents(self::IMAGE_URL);

    // Creates an asset.
    $asset = new Asset([
        // Provide a unique friendly name to identify your asset.
        // When there is an existing image asset with the same content but a different
        // name, the new name will be dropped silently.
        'name' => 'Marketing Image',
        'type' => AssetType::IMAGE,
        'image_asset' => new ImageAsset(['data' => $imageContent])
    ]);

    // Creates an asset operation.
    $assetOperation = new AssetOperation();
    $assetOperation->setCreate($asset);

    // Issues a mutate request to add the asset.
    $assetServiceClient = $googleAdsClient->getAssetServiceClient();
    $response = $assetServiceClient->mutateAssets(MutateAssetsRequest::build(
        $customerId,
        [$assetOperation]
    ));

    if (!empty($response->getResults())) {
        // Prints the resource name of the added image asset.
        /** @var MutateAssetResult $addedImageAsset */
        $addedImageAsset = $response->getResults()[0];
        printf(
            "The image asset with resource name '%s' was created.%s",
            $addedImageAsset->getResourceName(),
            PHP_EOL
        );
    } else {
        print 'No image asset was created.' . PHP_EOL;
    }
}UploadImageAsset.php

Python

def main(client: GoogleAdsClient, customer_id: str) -> None:
    """Main method, to run this code example as a standalone application."""

    # Download image from URL
    url: str = "https://gaagl.page.link/Eit5"
    image_content: bytes = get_image_bytes_from_url(url)

    asset_service: AssetServiceClient = client.get_service("AssetService")
    asset_operation: AssetOperation = client.get_type("AssetOperation")
    asset: Asset = asset_operation.create
    asset.type_ = client.enums.AssetTypeEnum.IMAGE
    asset.image_asset.data = image_content
    asset.image_asset.file_size = len(image_content)
    asset.image_asset.mime_type = client.enums.MimeTypeEnum.IMAGE_JPEG
    # Use your favorite image library to determine dimensions
    asset.image_asset.full_size.height_pixels = 315
    asset.image_asset.full_size.width_pixels = 600
    asset.image_asset.full_size.url = url
    # Provide a unique friendly name to identify your asset.
    # When there is an existing image asset with the same content but a different
    # name, the new name will be dropped silently.
    asset.name = "Marketing Image"
    mutate_asset_response: MutateAssetsResponse = asset_service.mutate_assets(
        customer_id=customer_id, operations=[asset_operation]
    )
    print("Uploaded file(s):")
    row: MutateAssetResult
    for row in mutate_asset_response.results:
        print(f"\tResource name: {row.resource_name}")
upload_image_asset.py

Руби

def upload_image_asset(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

  url = 'https://gaagl.page.link/Eit5'
  image_data = open(url) { |f| f.read }

  # Create the operation for uploading the image asset.
  asset_operation = client.operation.create_resource.asset do |asset|
    asset.type = :IMAGE
    asset.image_asset = client.resource.image_asset do |image_asset|
      image_asset.data = image_data
      image_asset.file_size = image_data.length()
      image_asset.mime_type = :IMAGE_JPEG
      image_asset.full_size = client.resource.image_dimension do |dimension|
        dimension.height_pixels = 315
        dimension.width_pixels = 600
        dimension.url = url
      end
    end
    # Provide a unique friendly name to identify your asset.
    # When there is an existing image asset with the same content but a different
    # name, the new name will be dropped silently.
    asset.name = "Marketing Image"
  end

  # Upload the image asset.
  response = client.service.asset.mutate_assets(
    customer_id: customer_id,
    operations: [asset_operation],
  )

  puts "Uploaded image asset #{response.results.first.resource_name}."
endupload_image_asset.rb

Perl

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

  # Create an image content.
  my $image_content = get_base64_data_from_url(IMAGE_URL);

  # Create an asset.
  my $asset = Google::Ads::GoogleAds::V22::Resources::Asset->new({
      # Provide a unique friendly name to identify your asset.
      # When there is an existing image asset with the same content but a different
      # name, the new name will be dropped silently.
      name       => "Marketing Image",
      type       => IMAGE,
      imageAsset => Google::Ads::GoogleAds::V22::Common::ImageAsset->new({
          data => $image_content
        })});

  # Create an asset operation.
  my $asset_operation =
    Google::Ads::GoogleAds::V22::Services::AssetService::AssetOperation->new({
      create => $asset
    });

  # Issue a mutate request to add the asset.
  my $assets_response = $api_client->AssetService()->mutate({
      customerId => $customer_id,
      operations => [$asset_operation]});

  printf "The image asset with resource name '%s' was created.\n",
    $assets_response->{results}[0]{resourceName};

  return 1;
}upload_image_asset.pl

После создания ресурса API возвращает объект MutateAssetResult , содержащий имя ресурса нового ImageAsset . Это имя ресурса используется для ссылки на ImageAsset при создании рекламы на основе ресурса.

Вы можете получить список существующих ресурсов и их имена, отправив запрос в GoogleAdsService . Дополнительные сведения см. в разделе «Получение атрибутов и метрик ресурсов» .

Используйте этот материал в рекламе.

Различные типы объявлений и кампаний поддерживают разные типы ресурсов, как показано в следующей таблице:

Типы объявлений/кампаний и типы ресурсов, которые они поддерживают.
`AppAd`	`TextAsset` `ImageAsset` `VideoAsset` `MediaBundleAsset`
`AppEngagementAd`	`TextAsset` `ImageAsset` `VideoAsset`
`DisplayUploadAd`	`MediaBundleAsset`
Кампания Performance Max	`TextAsset` `ImageAsset` `VideoAsset` `MediaBundleAsset` `YoutubeVideoAsset` `CallToActionAsset`
`ResponsiveDisplayAd`	`TextAsset` `ImageAsset` `VideoAsset`
`ResponsiveSearchAd`	`TextAsset`

Для каждого из этих типов объявлений есть поля для настройки поддерживаемых типов ресурсов. Для TextAsset новый строковый ресурс создается непосредственно в объявлении. Для всех остальных типов ресурсов существующие ресурсы добавляются в объявление по их именам.

В следующем примере показано добавление TextAsset и ImageAsset в ResponsiveDisplayAd ). TextAsset создается непосредственно в тексте объявления, как заголовок и описание. Элемент ImageAsset указывается с помощью имени ресурса.

}

{ }

) }

) # # # # # # # # # # # # # # # # # # # end

Создание и использование активов Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

Уровни ассоциации активов

активы бренда Performance Max

Создать актив

Java

C#

PHP

Python

Руби

Perl

Используйте этот материал в рекламе.

Java

C#

PHP

Python

Руби

Perl

Рекомендации по активам

Создание и использование активов