여행 목표 달성을 위한 실적 최대화 캠페인

여행 목표 달성을 위한 실적 최대화 캠페인을 사용하면 Google 검색, 디스플레이, 동영상, 디스커버리와 같은 Google 채널에 게재되는 호텔 숙박 시설 광고를 만들 수 있습니다. 또한 채널 전반에 걸친 자동 예산 할당, 최종 URL 확장, Google 검색의 광고 노출 범위 확대, 각 호텔 숙박 시설의 애셋 그룹으로 만들 확장 소재 추천 등의 이점이 있습니다.

호텔 광고와 달리 여행 목표 달성을 위한 실적 최대화 캠페인을 사용하기 위해 Hotel Center 계정에 액세스할 필요가 없습니다.

여행 목표 달성을 위한 실적 최대화 캠페인 만들기

여행 목표 달성을 위한 실적 최대화 캠페인을 만드는 단계는 다음과 같습니다.

  1. 애셋 세트, 모든 호텔 숙박 시설의 확장 소재, 애셋 세트 확장 소재를 만들어 만든 애셋 세트와 확장 소재를 연결합니다.
  2. (권장) 애셋 그룹을 만드는 데 사용할 수 있는 추천 확장 소재를 가져옵니다.
  3. 애셋 세트 및 추천 확장 소재를 사용하여 실적 최대화 캠페인 만들기

호텔 숙박 시설의 확장 소재 항목 만들기

  1. AssetSet.type를 AssetSetType.HOTEL_PROPERTY로 설정하여 HOTEL_PROPERTY 유형의 호텔 숙박 시설 애셋 세트를 만듭니다. 나중에 생성된 애셋 세트의 리소스 이름을 사용합니다.

    자바C#PHPPythonRubyPerl
    private String createHotelAssetSet(GoogleAdsClient googleAdsClient, long customerId) {
  // Creates an asset set operation for a hotel property asset set.
  AssetSetOperation assetSetOperation =
      AssetSetOperation.newBuilder()
          .setCreate(
              AssetSet.newBuilder()
                  .setName(
                      "My Hotel propery asset set #" + CodeSampleHelper.getPrintableDateTime())
                  .setType(AssetSetType.HOTEL_PROPERTY))
          .build();
  try (AssetSetServiceClient assetSetServiceClient =
      googleAdsClient.getLatestVersion().createAssetSetServiceClient()) {
    MutateAssetSetsResponse mutateAssetSetsResponse =
        assetSetServiceClient.mutateAssetSets(
            Long.toString(customerId), ImmutableList.of(assetSetOperation));
    String assetSetResourceName = mutateAssetSetsResponse.getResults(0).getResourceName();
    System.out.printf("Created an asset set with resource name: '%s'%n", assetSetResourceName);
    return assetSetResourceName;
  }
}
    AddPerformanceMaxForTravelGoalsCampaign.java
    
      
    private string CreateHotelAssetSet(GoogleAdsClient client, long customerId)
{
    AssetSetOperation operation = new AssetSetOperation()
    {
        Create = new AssetSet {
            Name = "My Hotel property asset set #" + ExampleUtilities.GetRandomString(),
            Type = AssetSetType.HotelProperty
        }
    };

    AssetSetServiceClient assetSetService = client.GetService(Services.V19.AssetSetService);

    MutateAssetSetsResponse response = assetSetService.MutateAssetSets(
        customerId.ToString(),
        new List<AssetSetOperation> { operation }
    );

    string assetResourceName = response.Results[0].ResourceName;
    Console.WriteLine($"Created an asset set with resource name: {assetResourceName}");
    return assetResourceName;
}
    AddPerformanceMaxForTravelGoalsCampaign.cs
    
      
    private static function createHotelAssetSet(
    GoogleAdsClient $googleAdsClient,
    int $customerId
): string {
    // Creates an asset set operation for a hotel property asset set.
    $assetSetOperation = new AssetSetOperation([
        // Creates a hotel property asset set.
        'create' => new AssetSet([
            'name' => 'My Hotel propery asset set #' . Helper::getPrintableDatetime(),
            'type' => AssetSetType::HOTEL_PROPERTY
        ])
    ]);

    // Issues a mutate request to add a hotel asset set and prints its information.
    $assetSetServiceClient = $googleAdsClient->getAssetSetServiceClient();
    $response = $assetSetServiceClient->mutateAssetSets(
        MutateAssetSetsRequest::build($customerId, [$assetSetOperation])
    );
    $assetSetResourceName = $response->getResults()[0]->getResourceName();
    printf("Created an asset set with resource name: '%s'.%s", $assetSetResourceName, PHP_EOL);
    return $assetSetResourceName;
}
    AddPerformanceMaxForTravelGoalsCampaign.php
    
      
    def create_hotel_asset_set(client, customer_id):
    """Creates a hotel property asset set.

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

    Returns:
        the created hotel property asset set's resource name.
    """
    # Creates an asset set operation for a hotel property asset set.
    operation = client.get_type("AssetSetOperation")
    # Creates a hotel property asset set.
    asset_set = operation.create
    asset_set.name = f"My hotel property asset set #{get_printable_datetime()}"
    asset_set.type_ = client.enums.AssetSetTypeEnum.HOTEL_PROPERTY

    # Issues a mutate request to add a hotel asset set.
    asset_set_service = client.get_service("AssetSetService")
    response = asset_set_service.mutate_asset_sets(
        customer_id=customer_id, operations=[operation]
    )
    resource_name = response.results[0].resource_name
    print(f"Created an asset set with resource name: '{resource_name}'")

    return resource_name
    add_performance_max_for_travel_goals_campaign.py
    
      
    # Creates a hotel property asset set.
def create_hotel_asset_set(client, customer_id)
  operation =
    client.operation.create_resource.asset_set do |asset_set|
      asset_set.name = "My Hotel propery asset set #{Time.now}"
      asset_set.type = :HOTEL_PROPERTY
    end

  # Sends the mutate request.
  response =
    client.service.asset_set.mutate_asset_sets(
      customer_id: customer_id,
      operations: [operation]
    )

  # Prints some information about the response.
  response.results.first.resource_name
end
    add_performance_max_for_travel_goals_campaign.rb
    
      
    sub create_hotel_asset_set {
  my ($api_client, $customer_id) = @_;

  my $asset_set_operation =
    Google::Ads::GoogleAds::V19::Services::AssetSetService::AssetSetOperation->
    new({
      # Creates a hotel property asset set.
      create => Google::Ads::GoogleAds::V19::Resources::AssetSet->new({
          name => 'My Hotel propery asset set #' . uniqid(),
          type => HOTEL_PROPERTY
        })});
  # Issues a mutate request to add a hotel asset set and prints its information.
  my $response = $api_client->AssetSetService()->mutate({
      customerId => $customer_id,
      operations => [$asset_set_operation]});

  my $asset_set_resource_name = $response->{results}[0]{resourceName};
  printf "Created an asset set with resource name: '%s'.\n",
    $asset_set_resource_name;

  return $asset_set_resource_name;
}
    add_performance_max_for_travel_goals_campaign.pl

  2. 각 호텔 숙박 시설에 대해 다음을 실행합니다.

    1. Asset.hotel_property_asset를 HotelPropertyAsset 객체로 설정하여 저작물을 만듭니다.

      단순성을 위해 이 코드 예에서는 호텔 숙박 시설 애셋을 하나만 만듭니다.

    2. 생성된 HotelPropertyAsset 객체의 place_id를 호텔 숙박 시설의 장소 ID로 설정합니다. 장소 ID는 Google 지도에서 장소를 식별하는 고유 ID입니다. 장소 ID 검색 도구를 사용하여 숙박 시설을 조회할 수 있습니다.

    3. 새 AssetSetAsset를 만들고 asset_set를 생성된 애셋 세트의 리소스 이름으로, asset를 생성된 호텔 숙박 시설 확장 소재의 리소스 이름으로 설정하여 위의 애셋 세트를 확장 소재에 연결할 애셋 세트 확장 소재를 만듭니다.

    자바C#PHPPythonRubyPerl
    private String createHotelAsset(
    GoogleAdsClient googleAdsClient,
    long customerId,
    String placeId,
    String hotelPropertyAssetSetResourceName) {
  // Uses the GoogleAdService to create an asset and asset set asset in a single request.
  List<MutateOperation> mutateOperations = new ArrayList<>();
  String assetResourceName = ResourceNames.asset(customerId, ASSET_TEMPORARY_ID);
  // Creates a mutate operation for a hotel property asset.
  Asset hotelPropertyAsset =
      Asset.newBuilder()
          .setResourceName(assetResourceName)
          .setHotelPropertyAsset(HotelPropertyAsset.newBuilder().setPlaceId(placeId))
          .build();
  mutateOperations.add(
      MutateOperation.newBuilder()
          .setAssetOperation(AssetOperation.newBuilder().setCreate(hotelPropertyAsset))
          .build());

  // Creates a mutate operation for an asset set asset.
  AssetSetAsset assetSetAsset =
      AssetSetAsset.newBuilder()
          .setAsset(assetResourceName)
          .setAssetSet(hotelPropertyAssetSetResourceName)
          .build();
  mutateOperations.add(
      MutateOperation.newBuilder()
          .setAssetSetAssetOperation(AssetSetAssetOperation.newBuilder().setCreate(assetSetAsset))
          .build());
  // Issues a mutate request to create all entities.
  try (GoogleAdsServiceClient googleAdsServiceClient =
      googleAdsClient.getLatestVersion().createGoogleAdsServiceClient()) {
    MutateGoogleAdsResponse mutateGoogleAdsResponse =
        googleAdsServiceClient.mutate(Long.toString(customerId), mutateOperations);
    System.out.println("Created the following entities for the hotel asset:");
    printResponseDetails(mutateGoogleAdsResponse);
    // Returns the created asset resource name, which will be used later to create an asset
    // group. Other resource names are not used later.
    return mutateGoogleAdsResponse
        .getMutateOperationResponses(0)
        .getAssetResult()
        .getResourceName();
  }
}
    AddPerformanceMaxForTravelGoalsCampaign.java
    
      
    private string CreateHotelAsset(
    GoogleAdsClient client, long customerId, string placeId,
    string hotelPropertyAssetSetResourceName)
{
    // Uses the GoogleAdService to create an asset and asset set asset in a single request.
    List<MutateOperation> mutateOperations = new List<MutateOperation>();
    string assetResourceName = ResourceNames.Asset(customerId, ASSET_TEMPORARY_ID);

    // Creates a mutate operation for a hotel property asset.
    Asset hotelPropertyAsset = new Asset()
    {
        ResourceName = assetResourceName,
        HotelPropertyAsset = new HotelPropertyAsset
        {
            PlaceId = placeId
        }
    };
    mutateOperations.Add(new MutateOperation
    {
        AssetOperation = new AssetOperation
        {
           Create = hotelPropertyAsset
        }
    });

    // Creates a mutate operation for an asset set asset.
    AssetSetAsset assetSetAsset = new AssetSetAsset
    {
        Asset = assetResourceName,
        AssetSet = hotelPropertyAssetSetResourceName
    };
    mutateOperations.Add(new MutateOperation
    {
        AssetSetAssetOperation = new AssetSetAssetOperation
        {
            Create = assetSetAsset
        }
    });

    // Issues a mutate request to create all entities.
    GoogleAdsServiceClient googleAdsServiceClient =
        client.GetService(Services.V19.GoogleAdsService);

    MutateGoogleAdsResponse response =
        googleAdsServiceClient.Mutate(customerId.ToString(), mutateOperations);
    Console.WriteLine("Created the following entities for the hotel asset:");
    PrintResponseDetails(response);

    return response.MutateOperationResponses[0].AssetResult.ResourceName;
}
    AddPerformanceMaxForTravelGoalsCampaign.cs
    
      
    private static function createHotelAsset(
    GoogleAdsClient $googleAdsClient,
    int $customerId,
    string $placeId,
    string $assetSetResourceName
): string {
    // We use the GoogleAdService to create an asset and asset set asset in a single
    // request.
    $operations = [];
    $assetResourceName =
        ResourceNames::forAsset($customerId, self::ASSET_TEMPORARY_ID);
    // Creates a mutate operation for a hotel property asset.
    $operations[] = new MutateOperation([
        'asset_operation' => new AssetOperation([
            // Creates a hotel property asset.
            'create' => new Asset([
                'resource_name' => $assetResourceName,
                // Creates a hotel property asset for the place ID.
                'hotel_property_asset' => new HotelPropertyAsset(['place_id' => $placeId]),
            ])
        ])
    ]);
    // Creates a mutate operation for an asset set asset.
    $operations[] = new MutateOperation([
        'asset_set_asset_operation' => new AssetSetAssetOperation([
            // Creates an asset set asset.
            'create' => new AssetSetAsset([
                'asset' => $assetResourceName,
                'asset_set' => $assetSetResourceName
            ])
        ])
    ]);

    // Issues a mutate request to create all entities.
    $googleAdsService = $googleAdsClient->getGoogleAdsServiceClient();
    /** @var MutateGoogleAdsResponse $mutateGoogleAdsResponse */
    $mutateGoogleAdsResponse =
        $googleAdsService->mutate(MutateGoogleAdsRequest::build($customerId, $operations));
    print "Created the following entities for the hotel asset:" . PHP_EOL;
    self::printResponseDetails($mutateGoogleAdsResponse);

    // Returns the created asset resource name, which will be used later to create an asset
    // group. Other resource names are not used later.
    return $mutateGoogleAdsResponse->getMutateOperationResponses()[0]->getAssetResult()
        ->getResourceName();
}
    AddPerformanceMaxForTravelGoalsCampaign.php
    
      
    def create_hotel_asset(client, customer_id, place_id, asset_set_resource_name):
    """Creates a hotel property asset using the specified place ID.

    The place ID must belong to a hotel property. Then, links it to the
    specified asset set.

    Args:
        client: an initialized GoogleAdsClient instance.
        customer_id: a client customer ID.
        place_id: a place ID identifying a place in the Google Places database.
        asset_set_resource_name: an asset set resource name

    Returns:
        the created hotel property asset's resource name.
    """
    # We use the GoogleAdService to create an asset and asset set asset in a
    # single request.
    googleads_service = client.get_service("GoogleAdsService")
    asset_resource_name = googleads_service.asset_path(
        customer_id, ASSET_TEMPORARY_ID
    )

    # Creates a mutate operation for a hotel property asset.
    asset_mutate_operation = client.get_type("MutateOperation")
    # Creates a hotel property asset.
    asset = asset_mutate_operation.asset_operation.create
    asset.resource_name = asset_resource_name
    # Creates a hotel property asset for the place ID.
    asset.hotel_property_asset.place_id = place_id

    # Creates a mutate operation for an asset set asset.
    asset_set_asset_mutate_operation = client.get_type("MutateOperation")
    # Creates an asset set asset.
    asset_set_asset = (
        asset_set_asset_mutate_operation.asset_set_asset_operation.create
    )
    asset_set_asset.asset = asset_resource_name
    asset_set_asset.asset_set = asset_set_resource_name

    # Issues a mutate request to create all entities.
    response = googleads_service.mutate(
        customer_id=customer_id,
        mutate_operations=[
            asset_mutate_operation,
            asset_set_asset_mutate_operation,
        ],
    )
    print("Created the following entities for the hotel asset:")
    print_response_details(response)

    return response.mutate_operation_responses[0].asset_result.resource_name
    add_performance_max_for_travel_goals_campaign.py
    
      
    # Creates a hotel property asset using the specified place ID.
# The place ID must belong to a hotel property. Then, links it to the
# specified asset set.
# See https://developers.google.com/places/web-service/place-id to search for a
# hotel place ID.
def create_hotel_asset(
  client,
  customer_id,
  place_id,
  hotel_property_asset_set_resource_name
)
  asset_operation =
    client.operation.create_resource.asset do |asset|
      asset.name = 'Ad Media Bundle'
      asset.hotel_property_asset =
        client.resource.hotel_property_asset do |hotel_asset|
          hotel_asset.place_id = place_id
        end
    end

  # Send the mutate request.
  response =
    client.service.asset.mutate_assets(
      customer_id: customer_id,
      operations: [asset_operation]
    )

  asset_resource_name = response.results.first.resource_name

  # Creates a mutate operation for an asset set asset.
  asset_set_asset_operation =
    client.operation.create_resource.asset_set_asset do |asa|
      asa.asset = asset_resource_name
      asa.asset_set = hotel_property_asset_set_resource_name
    end

  # Sends the mutate request.
  response =
    client.service.asset_set_asset.mutate_asset_set_assets(
      customer_id: customer_id,
      operations: [asset_set_asset_operation]
    )

  asset_resource_name
end
    add_performance_max_for_travel_goals_campaign.rb
    
      
    sub create_hotel_asset {
  my ($api_client, $customer_id, $place_id, $asset_set_resource_name) = @_;

  # We use the GoogleAdService to create an asset and asset set asset in a single request.
  my $operations = [];
  my $asset_resource_name =
    Google::Ads::GoogleAds::V19::Utils::ResourceNames::asset($customer_id,
    ASSET_TEMPORARY_ID);

  # Create a mutate operation for a hotel property asset.
  push @$operations,
    Google::Ads::GoogleAds::V19::Services::GoogleAdsService::MutateOperation->
    new({
      assetOperation =>
        Google::Ads::GoogleAds::V19::Services::AssetService::AssetOperation->
        new({
          create => Google::Ads::GoogleAds::V19::Resources::Asset->new({
              resourceName       => $asset_resource_name,
              hotelPropertyAsset =>
                Google::Ads::GoogleAds::V19::Common::HotelPropertyAsset->new({
                  placeId => $place_id
                })})})});

  # Create a mutate operation for an asset set asset.
  push @$operations,
    Google::Ads::GoogleAds::V19::Services::GoogleAdsService::MutateOperation->
    new({
      assetSetAssetOperation =>
        Google::Ads::GoogleAds::V19::Services::AssetSetAssetService::AssetSetAssetOperation
        ->new({
          create => Google::Ads::GoogleAds::V19::Resources::AssetSetAsset->new({
              asset    => $asset_resource_name,
              assetSet => $asset_set_resource_name
            })})});

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

  printf "Created the following entities for the hotel asset:\n";
  print_response_details($mutate_google_ads_response);

  # Return the created asset resource name, which will be used later to create an asset
  # group. Other resource names are not used later.
  return $mutate_google_ads_response->{mutateOperationResponses}[0]
    {assetResult}{resourceName};
}
    add_performance_max_for_travel_goals_campaign.pl

애셋 그룹을 만드는 데 사용할 수 있는 추천 확장 소재 가져오기

TravelAssetSugestionService.SuggestTravelAssets를 사용하여 호텔 숙박 시설에 대한 추천 확장 소재를 가져올 수 있습니다. 추천을 받은 후 다음 단계에서 애셋 그룹에 애셋을 만들 때 이를 사용할 수 있습니다.

자바C#PHPPythonRubyPerl
private HotelAssetSuggestion getHotelAssetSuggestion(
    GoogleAdsClient googleAdsClient, long customerId, String placeId) {

  try (TravelAssetSuggestionServiceClient travelAssetSuggestionServiceClient =
      googleAdsClient.getLatestVersion().createTravelAssetSuggestionServiceClient()) {
    // Sends a request to suggest assets to be created as an asset group for the Performance Max
    // for travel goals campaign.
    SuggestTravelAssetsResponse suggestTravelAssetsResponse =
        travelAssetSuggestionServiceClient.suggestTravelAssets(
            SuggestTravelAssetsRequest.newBuilder()
                .setCustomerId(Long.toString(customerId))
                // Uses 'en-US' as an example. It can be any language specifications in BCP 47
                // format.
                .setLanguageOption("en-US")
                // The service accepts several place IDs. We use only one here for demonstration.
                .addPlaceIds(placeId)
                .build());
    System.out.printf("Fetched a hotel asset suggestion for the place ID '%s'.%n", placeId);
    return suggestTravelAssetsResponse.getHotelAssetSuggestions(0);
  }
}
AddPerformanceMaxForTravelGoalsCampaign.java

      
private HotelAssetSuggestion GetHotelAssetSuggestion(GoogleAdsClient client,
    long customerId, string placeId)
{
    // Get the TravelAssetSuggestionService client.
    TravelAssetSuggestionServiceClient travelAssetSuggestionService =
        client.GetService(Services.V19.TravelAssetSuggestionService);

    SuggestTravelAssetsRequest request = new SuggestTravelAssetsRequest
    {
        CustomerId = customerId.ToString(),
        LanguageOption = "en-US",
    };

    request.PlaceIds.Add(placeId);

    SuggestTravelAssetsResponse response = travelAssetSuggestionService.SuggestTravelAssets(
        request
    );

    Console.WriteLine($"Fetched a hotel asset suggestion for the place ID {placeId}");
    return response.HotelAssetSuggestions[0];
}
AddPerformanceMaxForTravelGoalsCampaign.cs

      
private static function getHotelAssetSuggestion(
    GoogleAdsClient $googleAdsClient,
    int $customerId,
    string $placeId
): HotelAssetSuggestion {
    // Send a request to suggest assets to be created as an asset group for the Performance Max
    // for travel goals campaign.
    $travelAssetSuggestionServiceClient =
        $googleAdsClient->getTravelAssetSuggestionServiceClient();
    // Uses 'en-US' as an example. It can be any language specifications in BCP 47 format.
    $request = SuggestTravelAssetsRequest::build($customerId, 'en-US');
    // The service accepts several place IDs. We use only one here for demonstration.
    $request->setPlaceIds([$placeId]);
    $response = $travelAssetSuggestionServiceClient->suggestTravelAssets($request);
    printf("Fetched a hotel asset suggestion for the place ID '%s'.%s", $placeId, PHP_EOL);
    return $response->getHotelAssetSuggestions()[0];
}
AddPerformanceMaxForTravelGoalsCampaign.php

      
def get_hotel_asset_suggestion(client, customer_id, place_id):
    """Returns hotel asset suggestion from TravelAssetsSuggestionService.

    Args:
        client: an initialized GoogleAdsClient instance.
        customer_id: a client customer ID.
        place_id: a place ID identifying a place in the Google Places database.
    """
    request = client.get_type("SuggestTravelAssetsRequest")
    request.customer_id = customer_id
    # Uses 'en-US' as an example. It can be any language specifications in
    # BCP 47 format.
    request.language_option = "en-US"
    # In this example we only use a single place ID for the purpose of
    # demonstration, but it's possible to append more than one here if needed.
    request.place_ids.append(place_id)
    # Send a request to suggest assets to be created as an asset group for the
    # Performance Max for travel goals campaign.
    travel_asset_suggestion_service = client.get_service(
        "TravelAssetSuggestionService"
    )
    response = travel_asset_suggestion_service.suggest_travel_assets(
        request=request
    )
    print(f"Fetched a hotel asset suggestion for the place ID: '{place_id}'.")

    # Since we sent a single operation in the request, it's guaranteed that
    # there will only be a single item in the response.
    return response.hotel_asset_suggestions[0]
add_performance_max_for_travel_goals_campaign.py

      
def get_hotel_asset_suggestion(client, customer_id, place_id)
  response =
    client.service.travel_asset_suggestion.suggest_travel_assets(
      customer_id: customer_id,
      language_option: 'en-US',
      place_ids: [place_id]
    )

  response.hotel_asset_suggestions.first
end
add_performance_max_for_travel_goals_campaign.rb

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

  # Send a request to suggest assets to be created as an asset group for the Performance Max
  # for travel goals campaign.
  my $suggest_travel_assets_response =
    $api_client->TravelAssetSuggestionService()->suggest_travel_assets({
      customerId => $customer_id,
      # Uses 'en-US' as an example. It can be any language specifications in BCP 47 format.
      languageOption => 'en-US',
      # The service accepts several place IDs. We use only one here for demonstration.
      placeIds => [$place_id],
    });

  printf "Fetched a hotel asset suggestion for the place ID '%s'.\n", $place_id;
  return $suggest_travel_assets_response->{hotelAssetSuggestions}[0];
}
add_performance_max_for_travel_goals_campaign.pl

주의사항

  • 이 방법은 최선을 다해 작동하므로 추천이 표시되지 않을 수도 있습니다.
  • 서비스가 애셋 그룹을 만들기 위해 필요한 모든 필수 애셋을 반환하지 않을 수 있습니다. 이 경우 요구사항을 충족하는 자체 확장 소재를 만드세요.

애셋 세트 및 추천 확장 소재를 사용하여 실적 최대화 캠페인 만들기

이 캠페인은 실적 최대화 캠페인의 하위유형이므로 최소 확장 소재 요건, 캠페인 예산을 공유할 수 없음 등의 기본 실적 최대화 캠페인 요구사항 및 제한사항이 적용됩니다.

일반적으로 대부분의 단계에 따라 실적 최대화 캠페인을 만들 수 있습니다. 주목할 만한 차이점은 다음과 같습니다.

  • 캠페인을 만들 때는 첫 번째 단계에서 만든 확장 소재 세트의 리소스 이름에 Campaign.hotel_property_asset_set도 지정해야 합니다.

    자바C#PHPPythonRubyPerl
    private MutateOperation createCampaignOperation(
    long customerId, String hotelPropertyAssetSetResourceName) {
  Campaign performanceMaxCampaign =
      Campaign.newBuilder()
          .setName("Performance Max for travel goals campaign #" + getPrintableDateTime())
          // Sets the campaign status as PAUSED. The campaign is the only entity in
          // the mutate request that should have its status set.
          .setStatus(CampaignStatus.PAUSED)
          // All Performance Max campaigns have an advertising_channel_type of
          // PERFORMANCE_MAX. The advertising_channel_sub_type should not be set.
          .setAdvertisingChannelType(AdvertisingChannelType.PERFORMANCE_MAX)
          // To create a Performance Max for travel goals campaign, you need to set
          // `hotel_property_asset_set`.
          .setHotelPropertyAssetSet(hotelPropertyAssetSetResourceName)
          // Bidding strategy must be set directly on the campaign.
          // Setting a portfolio bidding strategy by resource name is not supported.
          // Max Conversion and Maximize Conversion Value are the only strategies
          // supported for Performance Max campaigns.
          // An optional ROAS (Return on Advertising Spend) can be set for
          // maximize_conversion_value. The ROAS value must be specified as a ratio in
          // the API. It is calculated by dividing "total value" by "total spend".
          // For more information on Maximize Conversion Value, see the support
          // article: http://support.google.com/google-ads/answer/7684216.
          // A targetRoas of 3.5 corresponds to a 350% return on ad spend.
          .setMaximizeConversionValue(
              MaximizeConversionValue.newBuilder().setTargetRoas(3.5).build())
          // Assigns the resource name with a temporary ID.
          .setResourceName(ResourceNames.campaign(customerId, CAMPAIGN_TEMPORARY_ID))
          // Sets the budget using the given budget resource name.
          .setCampaignBudget(ResourceNames.campaignBudget(customerId, BUDGET_TEMPORARY_ID))
          // Optional fields.
          .setStartDate(new DateTime().plusDays(1).toString("yyyyMMdd"))
          .setEndDate(new DateTime().plusDays(365).toString("yyyyMMdd"))
          .build();

  return MutateOperation.newBuilder()
      .setCampaignOperation(
          CampaignOperation.newBuilder().setCreate(performanceMaxCampaign).build())
      .build();
}
    AddPerformanceMaxForTravelGoalsCampaign.java
    
      
    private MutateOperation CreateCampaignOperation(long customerId,
    string hotelPropertyAssetSetResourceName)
{
    Campaign performanceMaxCampaign = new Campaign
    {
        Name = "Performance Max for travel goals campaign #" +
            ExampleUtilities.GetRandomString(),
        // 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,
        // All Performance Max campaigns have an advertising_channel_type of
        // PERFORMANCE_MAX. The advertising_channel_sub_type should not be set.
        AdvertisingChannelType = AdvertisingChannelType.PerformanceMax,
        // To create a Performance Max for travel goals campaign, you need to set
        // `hotel_property_asset_set`.
        HotelPropertyAssetSet = hotelPropertyAssetSetResourceName,
        // Bidding strategy must be set directly on the campaign.
        // Setting a portfolio bidding strategy by resource name is not supported.
        // Max Conversion and Maximize Conversion Value are the only strategies
        // supported for Performance Max campaigns.
        // An optional ROAS (Return on Advertising Spend) can be set for
        // maximize_conversion_value. The ROAS value must be specified as a ratio in
        // the API. It is calculated by dividing "total value" by "total spend".
        // For more information on Maximize Conversion Value, see the support
        // article: http://support.google.com/google-ads/answer/7684216.
        // A targetRoas of 3.5 corresponds to a 350% return on ad spend.
        MaximizeConversionValue = new MaximizeConversionValue
        {
            TargetRoas = 3.5
        },
        // Assigns the resource name with a temporary ID.
        ResourceName = ResourceNames.Campaign(customerId, CAMPAIGN_TEMPORARY_ID),
        // Sets the budget using the given budget resource name.
        CampaignBudget = ResourceNames.CampaignBudget(customerId, BUDGET_TEMPORARY_ID)
    };

    return new MutateOperation
    {
        CampaignOperation = new CampaignOperation
        {
            Create = performanceMaxCampaign
        }
    };
}
    AddPerformanceMaxForTravelGoalsCampaign.cs
    
      
    private static function createCampaignOperation(
    int $customerId,
    string $hotelPropertyAssetSetResourceName
): MutateOperation {
    // Creates a mutate operation that creates a campaign.
    return new MutateOperation([
        'campaign_operation' => new CampaignOperation([
            'create' => new Campaign([
                'name' => 'Performance Max for travel goals campaign #'
                    . Helper::getPrintableDatetime(),
                // Assigns the resource name with a temporary ID.
                'resource_name' => ResourceNames::forCampaign(
                    $customerId,
                    self::CAMPAIGN_TEMPORARY_ID
                ),
                // Sets the budget using the given budget resource name.
                'campaign_budget' => ResourceNames::forCampaignBudget(
                    $customerId,
                    self::BUDGET_TEMPORARY_ID
                ),
                // The campaign is the only entity in the mutate request that should have its
                // status set.
                // Recommendation: Set the campaign to PAUSED when creating it to prevent
                // the ads from immediately serving.
                'status' => CampaignStatus::PAUSED,
                // Performance Max campaigns have an advertising_channel_type of
                // PERFORMANCE_MAX. The advertising_channel_sub_type should not be set.
                'advertising_channel_type' => AdvertisingChannelType::PERFORMANCE_MAX,

                // To create a Performance Max for travel goals campaign, you need to set
                // `hotel_property_asset_set`.
                'hotel_property_asset_set' => $hotelPropertyAssetSetResourceName,

                // Bidding strategy must be set directly on the campaign.
                // Setting a portfolio bidding strategy by resource name is not supported.
                // Max Conversion and Maximize Conversion Value are the only strategies
                // supported for Performance Max campaigns.
                // An optional ROAS (Return on Advertising Spend) can be set for
                // maximize_conversion_value. The ROAS value must be specified as a ratio in
                // the API. It is calculated by dividing "total value" by "total spend".
                // For more information on Maximize Conversion Value, see the support
                // article: https://support.google.com/google-ads/answer/7684216.
                // A target_roas of 3.5 corresponds to a 350% return on ad spend.
                'maximize_conversion_value' => new MaximizeConversionValue([
                    'target_roas' => 3.5
                ])
            ])
        ])
    ]);
}
    AddPerformanceMaxForTravelGoalsCampaign.php
    
      
    def create_campaign_operation(
    client, customer_id, hotel_property_asset_set_resource_name
):
    """Creates a mutate operation that creates a new Performance Max campaign.

    Links the specified hotel property asset set to this campaign.

    A temporary ID will be assigned to this campaign budget 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.
        hotel_property_asset_set_resource_name: the resource name for a hotel
            property asset set.

    Returns:
        a MutateOperation message that creates a new Performance Max campaign.
    """
    googleads_service = client.get_service("GoogleAdsService")
    # Creates a mutate operation that creates a campaign.
    operation = client.get_type("MutateOperation")
    campaign = operation.campaign_operation.create
    campaign.name = (
        f"Performance Max for travel goals campaign #{get_printable_datetime}"
    )
    # Assigns the resource name with a temporary ID.
    campaign.resource_name = googleads_service.campaign_path(
        customer_id, CAMPAIGN_TEMPORARY_ID
    )
    # Sets the budget using the given budget resource name.
    campaign.campaign_budget = googleads_service.campaign_budget_path(
        customer_id, BUDGET_TEMPORARY_ID
    )
    # The campaign is the only entity in the mutate request that should have its
    # status set.
    # Recommendation: Set the campaign to PAUSED when creating it to prevent
    # the ads from immediately serving.
    campaign.status = client.enums.CampaignStatusEnum.PAUSED
    # Performance Max campaigns have an advertising_channel_type of
    # PERFORMANCE_MAX. The advertising_channel_sub_type should not be set.
    campaign.advertising_channel_type = (
        client.enums.AdvertisingChannelTypeEnum.PERFORMANCE_MAX
    )
    # To create a Performance Max for travel goals campaign, you need to set
    # the `hotel_property_asset_set` field.
    campaign.hotel_property_asset_set = hotel_property_asset_set_resource_name
    # Bidding strategy must be set directly on the campaign.
    # Setting a portfolio bidding strategy by resource name is not supported.
    # Max Conversion and Maximize Conversion Value are the only strategies
    # supported for Performance Max campaigns.
    # An optional ROAS (Return on Advertising Spend) can be set for
    # maximize_conversion_value. The ROAS value must be specified as a ratio in
    # the API. It is calculated by dividing "total value" by "total spend".
    # For more information on Maximize Conversion Value, see the support
    # article: https://support.google.com/google-ads/answer/7684216.
    # A target_roas of 3.5 corresponds to a 350% return on ad spend.
    campaign.maximize_conversion_value.target_roas = 3.5

    return operation
    add_performance_max_for_travel_goals_campaign.py
    
      
    # Creates a MutateOperation that creates a new Performance Max 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_performance_max_campaign_operation(
  client,
  customer_id,
  hotel_property_asset_set_resource_name
)
  client.operation.mutate do |m|
    m.campaign_operation =
      client.operation.create_resource.campaign do |c|
        c.name = "Performance Max for Travel Goals #{SecureRandom.uuid}"

        # Set the campaign status as PAUSED. The campaign is the only entity in
        # the mutate request that should have its status set.
        c.status = :PAUSED

        # All Performance Max campaigns have an advertising_channel_type of
        # PERFORMANCE_MAX. The advertising_channel_sub_type should not be set.
        c.advertising_channel_type = :PERFORMANCE_MAX

        # To create a Performance Max for travel goals campaign, you need to set hotel_property_asset_set
        c.hotel_property_asset_set = hotel_property_asset_set_resource_name

        # Bidding strategy must be set directly on the campaign.
        # Setting a portfolio bidding strategy by resource name is not supported.
        # Max Conversion and Maximize Conversion Value are the only strategies
        # supported for Performance Max campaigns.
        # An optional ROAS (Return on Advertising Spend) can be set for
        # maximize_conversion_value. The ROAS value must be specified as a ratio
        # in the API. It is calculated by dividing "total value" by "total spend".
        # For more information on Maximize Conversion Value, see the support
        # article: http://support.google.com/google-ads/answer/7684216.
        # A target_roas of 3.5 corresponds to a 350% return on ad spend.
        c.bidding_strategy_type = :MAXIMIZE_CONVERSION_VALUE
        c.maximize_conversion_value =
          client.resource.maximize_conversion_value do |mcv|
            mcv.target_roas = 3.5
          end

        # Assign the resource name with a temporary ID.
        c.resource_name =
          client.path.campaign(
            customer_id,
            PERFORMANCE_MAX_CAMPAIGN_TEMPORARY_ID
          )

        # Set the budget using the given budget resource name.
        c.campaign_budget =
          client.path.campaign_budget(customer_id, BUDGET_TEMPORARY_ID)
      end
  end
end
    add_performance_max_for_travel_goals_campaign.rb
    
      
    sub create_campaign_operation {
  my ($customer_id, $hotel_property_asset_set_resource_name) = @_;

  # Create a mutate operation that creates a campaign operation.
  return
    Google::Ads::GoogleAds::V19::Services::GoogleAdsService::MutateOperation->
    new({
      campaignOperation =>
        Google::Ads::GoogleAds::V19::Services::CampaignService::CampaignOperation
        ->new({
          create => Google::Ads::GoogleAds::V19::Resources::Campaign->new({
              # Assign the resource name with a temporary ID.
              resourceName =>
                Google::Ads::GoogleAds::V19::Utils::ResourceNames::campaign(
                $customer_id, CAMPAIGN_TEMPORARY_ID
                ),
              name => "Performance Max for travel goals campaign #'" . uniqid(),
              # Set the budget using the given budget resource name.
              campaignBudget =>
                Google::Ads::GoogleAds::V19::Utils::ResourceNames::campaign_budget(
                $customer_id, BUDGET_TEMPORARY_ID
                ),
              # Set the campaign status as PAUSED. The campaign is the only entity in
              # the mutate request that should have its status set.
              status =>
                Google::Ads::GoogleAds::V19::Enums::CampaignStatusEnum::PAUSED,
              # All Performance Max campaigns have an advertisingChannelType of
              # PERFORMANCE_MAX. The advertisingChannelSubType should not be set.
              advertisingChannelType => PERFORMANCE_MAX,

              # To create a Performance Max for travel goals campaign, you need to set
              # `hotelPropertyAssetSet`.
              hotelPropertyAssetSet => $hotel_property_asset_set_resource_name,

              # Bidding strategy must be set directly on the campaign.
              # Setting a portfolio bidding strategy by resource name is not supported.
              # Max Conversion and Max Conversion Value are the only strategies
              # supported for Performance Max campaigns.
              # An optional ROAS (Return on Advertising Spend) can be set for
              # maximizeConversionValue. The ROAS value must be specified as a ratio in
              # the API. It is calculated by dividing "total value" by "total spend".
              # For more information on Max Conversion Value, see the support article:
              # http://support.google.com/google-ads/answer/7684216.
              # A targetRoas of 3.5 corresponds to a 350% return on ad spend.
              maximizeConversionValue =>
                Google::Ads::GoogleAds::V19::Common::MaximizeConversionValue->
                new({
                  targetRoas => 3.5
                })})})});
}
    add_performance_max_for_travel_goals_campaign.pl

  • 이제 애셋 그룹을 처음부터 만드는 대신 애셋 그룹을 만들 때 TravelAssetSugestionService.SuggestTravelAssets의 추천을 사용할 수 있습니다. 추천 확장 소재가 충분하지 않은 경우 실적 최대화 캠페인의 최소 확장 소재 요건을 충족하기 위해 확장 소재를 추가해야 합니다.

  • 여행 목표 달성을 위한 실적 최대화 캠페인을 사용하려면 모든 호텔 숙박 시설 확장 소재를 만든 애셋 그룹에 연결해야 합니다. 이러한 연결이 없으면 캠페인이 일반 실적 최대화 캠페인으로 전환됩니다.

    자바C#PHPPythonRubyPerl
    // Link the previously created hotel property asset to the asset group. In the real-world
// scenario, you'd need to do this step several times for each hotel property asset.
AssetGroupAsset hotelProperyAssetGroupAsset =
    AssetGroupAsset.newBuilder()
        .setAsset(hotelPropertyAssetResourceName)
        .setAssetGroup(assetGroupResourceName)
        .setFieldType(AssetFieldType.HOTEL_PROPERTY)
        .build();
// Adds an operation to link the hotel property asset to the asset group.
mutateOperations.add(
    MutateOperation.newBuilder()
        .setAssetGroupAssetOperation(
            AssetGroupAssetOperation.newBuilder().setCreate(hotelProperyAssetGroupAsset))
        .build());
    AddPerformanceMaxForTravelGoalsCampaign.java
    
      
    // Link the previously created hotel property asset to the asset group. In the
// real-world scenario, you'd need to do this step several times for each hotel property
// asset.
AssetGroupAsset hotelPropertyAssetGroupAsset = new AssetGroupAsset
{
    Asset = hotelPropertyAssetResourceName,
    AssetGroup = assetGroupResourceName,
    FieldType = AssetFieldType.HotelProperty
};

// Adds an operation to link the hotel property asset to the asset group.
mutateOperations.Add(new MutateOperation
{
    AssetGroupAssetOperation = new AssetGroupAssetOperation
    {
        Create = hotelPropertyAssetGroupAsset
    }
});
    AddPerformanceMaxForTravelGoalsCampaign.cs
    
      
    // Link the previously created hotel property asset to the asset group. In the real-world
// scenario, you'd need to do this step several times for each hotel property asset.
$operations[] = new MutateOperation([
    'asset_group_asset_operation' => new AssetGroupAssetOperation([
        'create' => new AssetGroupAsset([
            'asset' => $hotelPropertyAssetResourceName,
            'asset_group' => $assetGroupResourceName,
            'field_type' => AssetFieldType::HOTEL_PROPERTY
        ])
    ])
]);
    AddPerformanceMaxForTravelGoalsCampaign.php
    
      
    # Link the previously created hotel property asset to the asset group. If
# there are multiple assets, these steps to create a new operation need to
# be performed for each asset.
asset_group_asset_mutate_operation = client.get_type("MutateOperation")
asset_group_asset = (
    asset_group_asset_mutate_operation.asset_group_asset_operation.create
)
asset_group_asset.asset = hotel_property_asset_resource_name
asset_group_asset.asset_group = asset_group_resource_name
asset_group_asset.field_type = (
    client.enums.AssetFieldTypeEnum.HOTEL_PROPERTY
)
operations.append(asset_group_asset_mutate_operation)
    add_performance_max_for_travel_goals_campaign.py
    
      
    # Link the previously created hotel property asset to the asset group.
# In the real-world scenario, you'd need to do this step several times for
# each hotel property asset.
operations << client.operation.mutate do |m|
  m.asset_group_asset_operation =
    client.operation.create_resource.asset_group_asset do |aga|
      aga.field_type = :HOTEL_PROPERTY
      aga.asset_group =
        client.path.asset_group(customer_id, ASSET_GROUP_TEMPORARY_ID)
      aga.asset = hotel_property_asset_resource_name
    end
end
    add_performance_max_for_travel_goals_campaign.rb
    
      
    # Link the previously created hotel property asset to the asset group. In the real-world
# scenario, you'd need to do this step several times for each hotel property asset.
push @$operations,
  Google::Ads::GoogleAds::V19::Services::GoogleAdsService::MutateOperation->
  new({
    assetGroupAssetOperation =>
      Google::Ads::GoogleAds::V19::Services::AssetGroupAssetService::AssetGroupAssetOperation
      ->new({
        create =>
          Google::Ads::GoogleAds::V19::Resources::AssetGroupAsset->new({
            asset      => $hotel_property_asset_resource_name,
            assetGroup => $asset_group_resource_name,
            fieldType  => HOTEL_PROPERTY
          })})});
    add_performance_max_for_travel_goals_campaign.pl

이전
제품 피드를 사용한 온라인 판매
다음
예산 만들기