How to get and add audience id in the performance max campaign ?
105 views
Skip to first unread message
Dushyant
Aug 26, 2024, 8:14:00 AM8/26/24
to Google Ads API and AdWords API Forum
<?php /** * Copyright 2021 Google LLC * * Licensed under the Apache
License, Version 2.0 (the "License"); * you may not use this file except in
compliance with the License. * You may obtain a copy of the License at * *
https://www.apache.org/licenses/LICENSE-2.0 * * Unless required by
applicable law or agreed to in writing, software * distributed under the
License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR
CONDITIONS OF ANY KIND, either express or implied. * See the License for
the specific language governing permissions and * limitations under the
License. */ namespace Google\Ads\GoogleAds\Examples\AdvancedOperations; require
__DIR__ . '/../../vendor/autoload.php'; use GetOpt\GetOpt; use
Google\Ads\GoogleAds\Examples\Utils\ArgumentNames; use
Google\Ads\GoogleAds\Examples\Utils\ArgumentParser; use
Google\Ads\GoogleAds\Examples\Utils\Helper; use
Google\Ads\GoogleAds\Lib\OAuth2TokenBuilder; use
Google\Ads\GoogleAds\Lib\V17\GoogleAdsClient; use
Google\Ads\GoogleAds\Lib\V17\GoogleAdsClientBuilder; use
Google\Ads\GoogleAds\Lib\V17\GoogleAdsException; use
Google\Ads\GoogleAds\Util\V17\ResourceNames; use
Google\Ads\GoogleAds\V17\Common\AudienceInfo; use
Google\Ads\GoogleAds\V17\Common\ImageAsset; use
Google\Ads\GoogleAds\V17\Common\LanguageInfo; use
Google\Ads\GoogleAds\V17\Common\LocationInfo; use
Google\Ads\GoogleAds\V17\Common\MaximizeConversionValue; use
Google\Ads\GoogleAds\V17\Common\TextAsset; use
Google\Ads\GoogleAds\V17\Enums\AdvertisingChannelTypeEnum\AdvertisingChannelType; use
Google\Ads\GoogleAds\V17\Enums\AssetFieldTypeEnum\AssetFieldType; use
Google\Ads\GoogleAds\V17\Enums\AssetGroupStatusEnum\AssetGroupStatus; use
Google\Ads\GoogleAds\V17\Enums\BudgetDeliveryMethodEnum\BudgetDeliveryMethod; use
Google\Ads\GoogleAds\V17\Enums\CampaignStatusEnum\CampaignStatus; use
Google\Ads\GoogleAds\V17\Errors\GoogleAdsError; use
Google\Ads\GoogleAds\V17\Resources\Asset; use
Google\Ads\GoogleAds\V17\Resources\AssetGroup; use
Google\Ads\GoogleAds\V17\Resources\AssetGroupAsset; use
Google\Ads\GoogleAds\V17\Resources\AssetGroupSignal; use
Google\Ads\GoogleAds\V17\Resources\Campaign; use
Google\Ads\GoogleAds\V17\Resources\CampaignBudget; use
Google\Ads\GoogleAds\V17\Resources\CampaignCriterion; use
Google\Ads\GoogleAds\V17\Services\AssetGroupAssetOperation; use
Google\Ads\GoogleAds\V17\Services\AssetGroupOperation; use
Google\Ads\GoogleAds\V17\Services\AssetGroupSignalOperation; use
Google\Ads\GoogleAds\V17\Services\AssetOperation; use
Google\Ads\GoogleAds\V17\Services\CampaignBudgetOperation; use
Google\Ads\GoogleAds\V17\Services\CampaignCriterionOperation; use
Google\Ads\GoogleAds\V17\Services\CampaignOperation; use
Google\Ads\GoogleAds\V17\Services\MutateGoogleAdsRequest; use
Google\Ads\GoogleAds\V17\Services\MutateGoogleAdsResponse; use
Google\Ads\GoogleAds\V17\Services\MutateOperation; use
Google\Ads\GoogleAds\V17\Services\MutateOperationResponse; use
Google\ApiCore\ApiException; use Google\ApiCore\Serializer; /** * This
example shows how to create a Performance Max campaign. * * For more
information about Performance Max campaigns, see *
https://developers.google.com/google-ads/api/docs/performance-max/overview.
* * Prerequisites: * - You must have at least one conversion action in the
account. For more about conversion actions, * see *
https://developers.google.com/google-ads/api/docs/conversions/overview#conversion_actions.
* * This example uses the default customer conversion goals. For an example
of setting * campaign-specific conversion goals, see
ShoppingAds/AddPerformanceMaxRetailCampaign.php. */ class
AddPerformanceMaxCampaign { private const CUSTOMER_ID =
'INSERT_CUSTOMER_ID_HERE'; // Optional: An audience ID to use to improve
the targeting of the Performance Max campaign. private const AUDIENCE_ID =
null; // We specify temporary IDs that are specific to a single mutate
request. // Temporary IDs are always negative and unique within one mutate
request. // // See
https://developers.google.com/google-ads/api/docs/mutating/best-practices //
for further details. // // These temporary IDs are fixed because they are
used in multiple places. private const BUDGET_TEMPORARY_ID = -1; private
const PERFORMANCE_MAX_CAMPAIGN_TEMPORARY_ID = -2; private const
ASSET_GROUP_TEMPORARY_ID = -3; // There are also entities that will be
created in the same request but do not need to be fixed // temporary IDs
because they are referenced only once. /** @var int the negative temporary
ID used in bulk mutates. */ private static $nextTempId =
self::ASSET_GROUP_TEMPORARY_ID - 1; public static function main() { //
Either pass the required parameters for this example on the command line,
or insert them // into the constants above. $options = (new
ArgumentParser())->parseCommandArguments([ ArgumentNames::CUSTOMER_ID =>
GetOpt::REQUIRED_ARGUMENT, ArgumentNames::AUDIENCE_ID =>
GetOpt::OPTIONAL_ARGUMENT ]); // Generate a refreshable OAuth2 credential
for authentication. $oAuth2Credential = (new
OAuth2TokenBuilder())->fromFile()->build(); // Construct a Google Ads
client configured from a properties file and the // OAuth2 credentials
above. $googleAdsClient = (new GoogleAdsClientBuilder()) ->fromFile()
->withOAuth2Credential($oAuth2Credential) // We set this value to true to
show how to use GAPIC v2 source code. You can remove the // below line if
you wish to use the old-style source code. Note that in that case, you //
probably need to modify some parts of the code below to make it work. //
For more information, see //
https://developers.devsite.corp.google.com/google-ads/api/docs/client-libs/php/gapic.
->usingGapicV2Source(true) ->build(); try { self::runExample(
$googleAdsClient, $options[ArgumentNames::CUSTOMER_ID] ?: self::CUSTOMER_ID, $options[ArgumentNames::AUDIENCE_ID]
?: self::AUDIENCE_ID ); } catch (GoogleAdsException $googleAdsException) {
printf( "Request with ID '%s' has failed.%sGoogle Ads failure details:%s",
$googleAdsException->getRequestId(), PHP_EOL, PHP_EOL ); foreach
($googleAdsException->getGoogleAdsFailure()->getErrors() as $error) { /**
@var GoogleAdsError $error */ printf( "\t%s: %s%s",
$error->getErrorCode()->getErrorCode(), $error->getMessage(), PHP_EOL ); }
exit(1); } catch (ApiException $apiException) { printf( "ApiException was
thrown with message '%s'.%s", $apiException->getMessage(), PHP_EOL );
exit(1); } } /** * Runs the example. * * @param GoogleAdsClient
$googleAdsClient the Google Ads API client * @param int $customerId the
customer ID * @param int|null $audienceId the audience ID */ public static
function runExample( GoogleAdsClient $googleAdsClient, int $customerId, ?int
$audienceId ) { // Performance Max campaigns require that repeated assets
such as headlines // and descriptions be created before the campaign. //
For the list of required assets for a Performance Max campaign, see //
https://developers.google.com/google-ads/api/docs/performance-max/assets. // //
Creates the headlines. $headlineAssetResourceNames =
self::createMultipleTextAssets( $googleAdsClient, $customerId, ["Travel",
"Travel Reviews", "Book travel"] ); // Creates the descriptions. $descriptionAssetResourceNames
= self::createMultipleTextAssets( $googleAdsClient, $customerId, ["Take to
the air!", "Fly to the sky!"] ); // It's important to create the below
entities in this order because they depend on // each other. $operations =
[]; // The below methods create and return MutateOperations that we later //
provide to the GoogleAdsService.Mutate method in order to create the //
entities in a single request. Since the entities for a Performance Max //
campaign are closely tied to one-another, it's considered a best practice //
to create them in a single Mutate request so they all complete //
successfully or fail entirely, leaving no orphaned entities. See: //
https://developers.google.com/google-ads/api/docs/mutating/overview. $operations[]
= self::createCampaignBudgetOperation($customerId); $operations[] =
self::createPerformanceMaxCampaignOperation($customerId); $operations = array_merge($operations,
self::createCampaignCriterionOperations($customerId)); $operations =
array_merge($operations, self::createAssetGroupOperations( $customerId,
$headlineAssetResourceNames, $descriptionAssetResourceNames )); $operations
= array_merge($operations, self::createAssetGroupSignalOperations(
$customerId, ResourceNames::forAssetGroup($customerId,
self::ASSET_GROUP_TEMPORARY_ID), $audienceId )); // Issues a mutate request
to create everything and prints its information. $googleAdsServiceClient =
$googleAdsClient->getGoogleAdsServiceClient(); $response =
$googleAdsServiceClient->mutate(MutateGoogleAdsRequest::build( $customerId,
$operations )); self::printResponseDetails($response); } /** * Creates a
MutateOperation that creates a new CampaignBudget. * * 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. * * @param int
$customerId the customer ID * @return MutateOperation the mutate operation
that creates a campaign budget */ private static function
createCampaignBudgetOperation(int $customerId): MutateOperation { //
Creates a mutate operation that creates a campaign budget operation. return
new MutateOperation([ 'campaign_budget_operation' => new
CampaignBudgetOperation([ 'create' => new CampaignBudget([ // Sets a
temporary ID in the budget's resource name so it can be referenced // by
the campaign in later steps. 'resource_name' =>
ResourceNames::forCampaignBudget( $customerId, self::BUDGET_TEMPORARY_ID ), 'name'
=> 'Performance Max campaign budget #' . Helper::getPrintableDatetime(), //
The budget period already defaults to DAILY. 'amount_micros' => 50000000, 'delivery_method'
=> BudgetDeliveryMethod::STANDARD, // A Performance Max campaign cannot use
a shared campaign budget. 'explicitly_shared' => false ]) ]) ]); } /** *
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. * *
@param int $customerId the customer ID * @return MutateOperation the mutate
operation that creates the campaign */ private static function
createPerformanceMaxCampaignOperation(int $customerId): MutateOperation { //
Creates a mutate operation that creates a campaign operation. return new
MutateOperation([ 'campaign_operation' => new CampaignOperation([ 'create'
=> new Campaign([ 'name' => 'Performance Max campaign #' .
Helper::getPrintableDatetime(), // Assigns the resource name with a
temporary ID. 'resource_name' => ResourceNames::forCampaign( $customerId,
self::PERFORMANCE_MAX_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, // All 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, // 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. 'maximize_conversion_value'
=> new MaximizeConversionValue([ 'target_roas' => 3.5 ]), // Sets the Final
URL expansion opt out. This flag is specific to // Performance Max
campaigns. If opted out (true), only the final URLs in // the asset group
or URLs specified in the advertiser's Google Merchant // Center or business
data feeds are targeted. // If opted in (false), the entire domain will be
targeted. For best // results, set this value to false to opt in and allow
URL expansions. You // can optionally add exclusions to limit traffic to
parts of your website. 'url_expansion_opt_out' => false, // Optional fields. 'start_date'
=> date('Ymd', strtotime('+1 day')), 'end_date' => date('Ymd',
strtotime('+365 days')) ]) ]) ]); } /** * Creates a list of
MutateOperations that create new campaign criteria. * * @param int
$customerId the customer ID * @return MutateOperation[] a list of
MutateOperations that create the new campaign criteria */ private static
function createCampaignCriterionOperations(int $customerId): array { $operations
= []; // Set the LOCATION campaign criteria. // Target all of New York City
except Brooklyn. // Location IDs are listed here: //
https://developers.google.com/google-ads/api/reference/data/geotargets //
and they can also be retrieved using the GeoTargetConstantService as shown //
here:
https://developers.google.com/google-ads/api/docs/targeting/location-targeting
// // We will add one positive location target for New York City
(ID=1023191) // and one negative location target for Brooklyn (ID=1022762). //
First, adds the positive (negative = false) for New York City. $operations[]
= new MutateOperation([ 'campaign_criterion_operation' => new
CampaignCriterionOperation([ 'create' => new CampaignCriterion([ 'campaign'
=> ResourceNames::forCampaign( $customerId,
self::PERFORMANCE_MAX_CAMPAIGN_TEMPORARY_ID ), 'location' => new
LocationInfo([ 'geo_target_constant' =>
ResourceNames::forGeoTargetConstant(1023191) ]), 'negative' => false ]) ])
]); // Next adds the negative target for Brooklyn. $operations[] = new
MutateOperation([ 'campaign_criterion_operation' => new
CampaignCriterionOperation([ 'create' => new CampaignCriterion([ 'campaign'
=> ResourceNames::forCampaign( $customerId,
self::PERFORMANCE_MAX_CAMPAIGN_TEMPORARY_ID ), 'location' => new
LocationInfo([ 'geo_target_constant' =>
ResourceNames::forGeoTargetConstant(1022762) ]), 'negative' => true ]) ])
]); // Sets the LANGUAGE campaign criterion. $operations[] = new
MutateOperation([ 'campaign_criterion_operation' => new
CampaignCriterionOperation([ 'create' => new CampaignCriterion([ 'campaign'
=> ResourceNames::forCampaign( $customerId,
self::PERFORMANCE_MAX_CAMPAIGN_TEMPORARY_ID ), // Set the language. // For
a list of all language codes, see: //
https://developers.google.com/google-ads/api/reference/data/codes-formats#expandable-7 'language'
=> new LanguageInfo([ 'language_constant' =>
ResourceNames::forLanguageConstant(1000) // English ]) ]) ]) ]); return
$operations; } /** * Creates multiple text assets and returns the list of
resource names. * * @param GoogleAdsClient $googleAdsClient the Google Ads
API client * @param int $customerId the customer ID * @param string[]
$texts a list of strings, each of which will be used to create a text asset *
@return string[] a list of asset resource names */ 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; } /** * Creates a list of MutateOperations that create
a new asset group. * * A temporary ID will be assigned to this asset group
so that it can * be referenced by other objects being created in the same
Mutate request. * * @param GoogleAdsClient $googleAdsClient the Google Ads
API client * @param int $customerId the customer ID * @param string[]
$headlineAssetResourceNames a list of headline resource names * @param
string[] $descriptionAssetResourceNames a list of description resource names *
@return MutateOperation[] a list of MutateOperations that create new asset
group */ private static function createAssetGroupOperations( int
$customerId, array $headlineAssetResourceNames, array
$descriptionAssetResourceNames ): array { $operations = []; // Creates a
new mutate operation that creates an asset group operation. $operations[] =
new MutateOperation([ 'asset_group_operation' => new AssetGroupOperation([ 'create'
=> new AssetGroup([ 'resource_name' => ResourceNames::forAssetGroup(
$customerId, self::ASSET_GROUP_TEMPORARY_ID ), 'name' => 'Performance Max
asset group #' . Helper::getPrintableDatetime(), 'campaign' =>
ResourceNames::forCampaign( $customerId,
self::PERFORMANCE_MAX_CAMPAIGN_TEMPORARY_ID ), 'final_urls' =>
['http://www.example.com'], 'final_mobile_urls' =>
['http://www.example.com'], 'status' => AssetGroupStatus::PAUSED ]) ]) ]); //
For the list of required assets for a Performance Max campaign, see //
https://developers.google.com/google-ads/api/docs/performance-max/assets //
An AssetGroup is linked to an Asset by creating a new AssetGroupAsset //
and providing: // - the resource name of the AssetGroup // - the resource
name of the Asset // - the field_type of the Asset in this AssetGroup // //
To learn more about AssetGroups, see //
https://developers.google.com/google-ads/api/docs/performance-max/asset-groups. //
Links the previously created multiple text assets. // Links the headline
assets. foreach ($headlineAssetResourceNames as $resourceName) { $operations[]
= new MutateOperation([ 'asset_group_asset_operation' => new
AssetGroupAssetOperation([ 'create' => new AssetGroupAsset([ 'asset' =>
$resourceName, 'asset_group' => ResourceNames::forAssetGroup( $customerId,
self::ASSET_GROUP_TEMPORARY_ID ), 'field_type' => AssetFieldType::HEADLINE
]) ]) ]); } // Links the description assets. foreach
($descriptionAssetResourceNames as $resourceName) { $operations[] = new
MutateOperation([ 'asset_group_asset_operation' => new
AssetGroupAssetOperation([ 'create' => new AssetGroupAsset([ 'asset' =>
$resourceName, 'asset_group' => ResourceNames::forAssetGroup( $customerId,
self::ASSET_GROUP_TEMPORARY_ID ), 'field_type' =>
AssetFieldType::DESCRIPTION ]) ]) ]); } // Creates and links the long
headline text asset. $operations = array_merge($operations,
self::createAndLinkTextAsset( $customerId, 'Travel the World',
AssetFieldType::LONG_HEADLINE )); // Creates and links the business name
text asset. $operations = array_merge($operations,
self::createAndLinkTextAsset( $customerId, 'Interplanetary Cruises',
AssetFieldType::BUSINESS_NAME )); // Creates and links the image assets. //
Creates and links the Logo Asset. $operations = array_merge($operations,
self::createAndLinkImageAsset( $customerId, 'https://gaagl.page.link/bjYi',
AssetFieldType::LOGO, 'Marketing Logo' )); // Creates and links the
Marketing Image Asset. $operations = array_merge($operations,
self::createAndLinkImageAsset( $customerId, 'https://gaagl.page.link/Eit5',
AssetFieldType::MARKETING_IMAGE, 'Marketing Image' )); // Creates and links
the Square Marketing Image Asset. $operations = array_merge($operations,
self::createAndLinkImageAsset( $customerId, 'https://gaagl.page.link/bjYi',
AssetFieldType::SQUARE_MARKETING_IMAGE, 'Square Marketing Image' )); return
$operations; } /** * Creates a list of MutateOperations that create a new
linked text asset. * * @param int $customerId the customer ID * @param
string $text the text of the asset to be created * @param int $fieldType
the field type of the new asset in the AssetGroupAsset * @return
MutateOperation[] a list of MutateOperations that create a new linked text
asset */ private static function createAndLinkTextAsset( int $customerId, string
$text, int $fieldType ): array { $operations = []; // Creates a new mutate
operation that creates a text asset. $operations[] = new MutateOperation([ 'asset_operation'
=> new AssetOperation([ 'create' => new Asset([ 'resource_name' =>
ResourceNames::forAsset($customerId, self::$nextTempId), 'text_asset' =>
new TextAsset(['text' => $text]) ]) ]) ]); // Creates an asset group asset
to link the asset to the asset group. $operations[] = new MutateOperation([ 'asset_group_asset_operation'
=> new AssetGroupAssetOperation([ 'create' => new AssetGroupAsset([ 'asset'
=> ResourceNames::forAsset($customerId, self::$nextTempId), 'asset_group'
=> ResourceNames::forAssetGroup( $customerId, self::ASSET_GROUP_TEMPORARY_ID
), 'field_type' => $fieldType ]) ]) ]); self::$nextTempId--; return
$operations; } /** * Creates a list of MutateOperations that create a new
linked image asset. * * @param int $customerId the customer ID * @param
string $url the URL of the image to be retrieved and put into an asset *
@param int $fieldType the field type of the new asset in the AssetGroupAsset *
@param string $assetName the asset name * @return MutateOperation[] a list
of MutateOperations that create a new linked image asset */ private static
function createAndLinkImageAsset( int $customerId, string $url, int
$fieldType, string $assetName ): array { $operations = []; // Creates a new
mutate operation that creates an image asset. $operations[] = new
MutateOperation([ 'asset_operation' => new AssetOperation([ 'create' => new
Asset([ 'resource_name' => ResourceNames::forAsset($customerId,
self::$nextTempId), // 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' =>
$assetName, 'image_asset' => new ImageAsset(['data' =>
file_get_contents($url)]) ]) ]) ]); // Creates an asset group asset to link
the asset to the asset group. $operations[] = new MutateOperation([ 'asset_group_asset_operation'
=> new AssetGroupAssetOperation([ 'create' => new AssetGroupAsset([ 'asset'
=> ResourceNames::forAsset($customerId, self::$nextTempId), 'asset_group'
=> ResourceNames::forAssetGroup( $customerId, self::ASSET_GROUP_TEMPORARY_ID
), 'field_type' => $fieldType ]) ]) ]); self::$nextTempId--; return
$operations; } /** * Creates a list of MutateOperations that may create
asset group signals. * * @param int $customerId the customer ID * @param
string $assetGroupResourceName the resource name of the asset group *
@param int|null $audienceId the audience ID * @return MutateOperation[] a
list of MutateOperations that may create asset group signals */ private
static function createAssetGroupSignalOperations( int $customerId, string
$assetGroupResourceName, ?int $audienceId ): array { $operations = []; if
(is_null($audienceId)) { return $operations; } $operations[] = new
MutateOperation([ 'asset_group_signal_operation' => new
AssetGroupSignalOperation([ // To learn more about Audience Signals, see //
https://developers.google.com/google-ads/api/docs/performance-max/asset-groups#audience_signals. 'create'
=> new AssetGroupSignal([ 'asset_group' => $assetGroupResourceName, 'audience'
=> new AudienceInfo([ 'audience' => ResourceNames::forAudience($customerId,
$audienceId) ]) ]) ]) ]); return $operations; } /** * Prints the details of
a MutateGoogleAdsResponse. Parses the "response" oneof field name and *
uses it to extract the new entity's name and resource name. * * @param
MutateGoogleAdsResponse $mutateGoogleAdsResponse the mutate Google Ads
response */ private static function printResponseDetails( MutateGoogleAdsResponse
$mutateGoogleAdsResponse ): void { foreach
($mutateGoogleAdsResponse->getMutateOperationResponses() as $response) { /**
@var MutateOperationResponse $response */ $getter =
Serializer::getGetter($response->getResponse()); printf( "Created a(n) %s
with '%s'.%s", preg_replace( '/Result$/', '',
ucfirst(Serializer::toCamelCase($response->getResponse())) ),
$response->$getter()->getResourceName(), PHP_EOL ); } } }
AddPerformanceMaxCampaign::main();
License, Version 2.0 (the "License"); * you may not use this file except in
compliance with the License. * You may obtain a copy of the License at * *
https://www.apache.org/licenses/LICENSE-2.0 * * Unless required by
applicable law or agreed to in writing, software * distributed under the
License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR
CONDITIONS OF ANY KIND, either express or implied. * See the License for
the specific language governing permissions and * limitations under the
License. */ namespace Google\Ads\GoogleAds\Examples\AdvancedOperations; require
__DIR__ . '/../../vendor/autoload.php'; use GetOpt\GetOpt; use
Google\Ads\GoogleAds\Examples\Utils\ArgumentNames; use
Google\Ads\GoogleAds\Examples\Utils\ArgumentParser; use
Google\Ads\GoogleAds\Examples\Utils\Helper; use
Google\Ads\GoogleAds\Lib\OAuth2TokenBuilder; use
Google\Ads\GoogleAds\Lib\V17\GoogleAdsClient; use
Google\Ads\GoogleAds\Lib\V17\GoogleAdsClientBuilder; use
Google\Ads\GoogleAds\Lib\V17\GoogleAdsException; use
Google\Ads\GoogleAds\Util\V17\ResourceNames; use
Google\Ads\GoogleAds\V17\Common\AudienceInfo; use
Google\Ads\GoogleAds\V17\Common\ImageAsset; use
Google\Ads\GoogleAds\V17\Common\LanguageInfo; use
Google\Ads\GoogleAds\V17\Common\LocationInfo; use
Google\Ads\GoogleAds\V17\Common\MaximizeConversionValue; use
Google\Ads\GoogleAds\V17\Common\TextAsset; use
Google\Ads\GoogleAds\V17\Enums\AdvertisingChannelTypeEnum\AdvertisingChannelType; use
Google\Ads\GoogleAds\V17\Enums\AssetFieldTypeEnum\AssetFieldType; use
Google\Ads\GoogleAds\V17\Enums\AssetGroupStatusEnum\AssetGroupStatus; use
Google\Ads\GoogleAds\V17\Enums\BudgetDeliveryMethodEnum\BudgetDeliveryMethod; use
Google\Ads\GoogleAds\V17\Enums\CampaignStatusEnum\CampaignStatus; use
Google\Ads\GoogleAds\V17\Errors\GoogleAdsError; use
Google\Ads\GoogleAds\V17\Resources\Asset; use
Google\Ads\GoogleAds\V17\Resources\AssetGroup; use
Google\Ads\GoogleAds\V17\Resources\AssetGroupAsset; use
Google\Ads\GoogleAds\V17\Resources\AssetGroupSignal; use
Google\Ads\GoogleAds\V17\Resources\Campaign; use
Google\Ads\GoogleAds\V17\Resources\CampaignBudget; use
Google\Ads\GoogleAds\V17\Resources\CampaignCriterion; use
Google\Ads\GoogleAds\V17\Services\AssetGroupAssetOperation; use
Google\Ads\GoogleAds\V17\Services\AssetGroupOperation; use
Google\Ads\GoogleAds\V17\Services\AssetGroupSignalOperation; use
Google\Ads\GoogleAds\V17\Services\AssetOperation; use
Google\Ads\GoogleAds\V17\Services\CampaignBudgetOperation; use
Google\Ads\GoogleAds\V17\Services\CampaignCriterionOperation; use
Google\Ads\GoogleAds\V17\Services\CampaignOperation; use
Google\Ads\GoogleAds\V17\Services\MutateGoogleAdsRequest; use
Google\Ads\GoogleAds\V17\Services\MutateGoogleAdsResponse; use
Google\Ads\GoogleAds\V17\Services\MutateOperation; use
Google\Ads\GoogleAds\V17\Services\MutateOperationResponse; use
Google\ApiCore\ApiException; use Google\ApiCore\Serializer; /** * This
example shows how to create a Performance Max campaign. * * For more
information about Performance Max campaigns, see *
https://developers.google.com/google-ads/api/docs/performance-max/overview.
* * Prerequisites: * - You must have at least one conversion action in the
account. For more about conversion actions, * see *
https://developers.google.com/google-ads/api/docs/conversions/overview#conversion_actions.
* * This example uses the default customer conversion goals. For an example
of setting * campaign-specific conversion goals, see
ShoppingAds/AddPerformanceMaxRetailCampaign.php. */ class
AddPerformanceMaxCampaign { private const CUSTOMER_ID =
'INSERT_CUSTOMER_ID_HERE'; // Optional: An audience ID to use to improve
the targeting of the Performance Max campaign. private const AUDIENCE_ID =
null; // We specify temporary IDs that are specific to a single mutate
request. // Temporary IDs are always negative and unique within one mutate
request. // // See
https://developers.google.com/google-ads/api/docs/mutating/best-practices //
for further details. // // These temporary IDs are fixed because they are
used in multiple places. private const BUDGET_TEMPORARY_ID = -1; private
const PERFORMANCE_MAX_CAMPAIGN_TEMPORARY_ID = -2; private const
ASSET_GROUP_TEMPORARY_ID = -3; // There are also entities that will be
created in the same request but do not need to be fixed // temporary IDs
because they are referenced only once. /** @var int the negative temporary
ID used in bulk mutates. */ private static $nextTempId =
self::ASSET_GROUP_TEMPORARY_ID - 1; public static function main() { //
Either pass the required parameters for this example on the command line,
or insert them // into the constants above. $options = (new
ArgumentParser())->parseCommandArguments([ ArgumentNames::CUSTOMER_ID =>
GetOpt::REQUIRED_ARGUMENT, ArgumentNames::AUDIENCE_ID =>
GetOpt::OPTIONAL_ARGUMENT ]); // Generate a refreshable OAuth2 credential
for authentication. $oAuth2Credential = (new
OAuth2TokenBuilder())->fromFile()->build(); // Construct a Google Ads
client configured from a properties file and the // OAuth2 credentials
above. $googleAdsClient = (new GoogleAdsClientBuilder()) ->fromFile()
->withOAuth2Credential($oAuth2Credential) // We set this value to true to
show how to use GAPIC v2 source code. You can remove the // below line if
you wish to use the old-style source code. Note that in that case, you //
probably need to modify some parts of the code below to make it work. //
For more information, see //
https://developers.devsite.corp.google.com/google-ads/api/docs/client-libs/php/gapic.
->usingGapicV2Source(true) ->build(); try { self::runExample(
$googleAdsClient, $options[ArgumentNames::CUSTOMER_ID] ?: self::CUSTOMER_ID, $options[ArgumentNames::AUDIENCE_ID]
?: self::AUDIENCE_ID ); } catch (GoogleAdsException $googleAdsException) {
printf( "Request with ID '%s' has failed.%sGoogle Ads failure details:%s",
$googleAdsException->getRequestId(), PHP_EOL, PHP_EOL ); foreach
($googleAdsException->getGoogleAdsFailure()->getErrors() as $error) { /**
@var GoogleAdsError $error */ printf( "\t%s: %s%s",
$error->getErrorCode()->getErrorCode(), $error->getMessage(), PHP_EOL ); }
exit(1); } catch (ApiException $apiException) { printf( "ApiException was
thrown with message '%s'.%s", $apiException->getMessage(), PHP_EOL );
exit(1); } } /** * Runs the example. * * @param GoogleAdsClient
$googleAdsClient the Google Ads API client * @param int $customerId the
customer ID * @param int|null $audienceId the audience ID */ public static
function runExample( GoogleAdsClient $googleAdsClient, int $customerId, ?int
$audienceId ) { // Performance Max campaigns require that repeated assets
such as headlines // and descriptions be created before the campaign. //
For the list of required assets for a Performance Max campaign, see //
https://developers.google.com/google-ads/api/docs/performance-max/assets. // //
Creates the headlines. $headlineAssetResourceNames =
self::createMultipleTextAssets( $googleAdsClient, $customerId, ["Travel",
"Travel Reviews", "Book travel"] ); // Creates the descriptions. $descriptionAssetResourceNames
= self::createMultipleTextAssets( $googleAdsClient, $customerId, ["Take to
the air!", "Fly to the sky!"] ); // It's important to create the below
entities in this order because they depend on // each other. $operations =
[]; // The below methods create and return MutateOperations that we later //
provide to the GoogleAdsService.Mutate method in order to create the //
entities in a single request. Since the entities for a Performance Max //
campaign are closely tied to one-another, it's considered a best practice //
to create them in a single Mutate request so they all complete //
successfully or fail entirely, leaving no orphaned entities. See: //
https://developers.google.com/google-ads/api/docs/mutating/overview. $operations[]
= self::createCampaignBudgetOperation($customerId); $operations[] =
self::createPerformanceMaxCampaignOperation($customerId); $operations = array_merge($operations,
self::createCampaignCriterionOperations($customerId)); $operations =
array_merge($operations, self::createAssetGroupOperations( $customerId,
$headlineAssetResourceNames, $descriptionAssetResourceNames )); $operations
= array_merge($operations, self::createAssetGroupSignalOperations(
$customerId, ResourceNames::forAssetGroup($customerId,
self::ASSET_GROUP_TEMPORARY_ID), $audienceId )); // Issues a mutate request
to create everything and prints its information. $googleAdsServiceClient =
$googleAdsClient->getGoogleAdsServiceClient(); $response =
$googleAdsServiceClient->mutate(MutateGoogleAdsRequest::build( $customerId,
$operations )); self::printResponseDetails($response); } /** * Creates a
MutateOperation that creates a new CampaignBudget. * * 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. * * @param int
$customerId the customer ID * @return MutateOperation the mutate operation
that creates a campaign budget */ private static function
createCampaignBudgetOperation(int $customerId): MutateOperation { //
Creates a mutate operation that creates a campaign budget operation. return
new MutateOperation([ 'campaign_budget_operation' => new
CampaignBudgetOperation([ 'create' => new CampaignBudget([ // Sets a
temporary ID in the budget's resource name so it can be referenced // by
the campaign in later steps. 'resource_name' =>
ResourceNames::forCampaignBudget( $customerId, self::BUDGET_TEMPORARY_ID ), 'name'
=> 'Performance Max campaign budget #' . Helper::getPrintableDatetime(), //
The budget period already defaults to DAILY. 'amount_micros' => 50000000, 'delivery_method'
=> BudgetDeliveryMethod::STANDARD, // A Performance Max campaign cannot use
a shared campaign budget. 'explicitly_shared' => false ]) ]) ]); } /** *
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. * *
@param int $customerId the customer ID * @return MutateOperation the mutate
operation that creates the campaign */ private static function
createPerformanceMaxCampaignOperation(int $customerId): MutateOperation { //
Creates a mutate operation that creates a campaign operation. return new
MutateOperation([ 'campaign_operation' => new CampaignOperation([ 'create'
=> new Campaign([ 'name' => 'Performance Max campaign #' .
Helper::getPrintableDatetime(), // Assigns the resource name with a
temporary ID. 'resource_name' => ResourceNames::forCampaign( $customerId,
self::PERFORMANCE_MAX_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, // All 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, // 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. 'maximize_conversion_value'
=> new MaximizeConversionValue([ 'target_roas' => 3.5 ]), // Sets the Final
URL expansion opt out. This flag is specific to // Performance Max
campaigns. If opted out (true), only the final URLs in // the asset group
or URLs specified in the advertiser's Google Merchant // Center or business
data feeds are targeted. // If opted in (false), the entire domain will be
targeted. For best // results, set this value to false to opt in and allow
URL expansions. You // can optionally add exclusions to limit traffic to
parts of your website. 'url_expansion_opt_out' => false, // Optional fields. 'start_date'
=> date('Ymd', strtotime('+1 day')), 'end_date' => date('Ymd',
strtotime('+365 days')) ]) ]) ]); } /** * Creates a list of
MutateOperations that create new campaign criteria. * * @param int
$customerId the customer ID * @return MutateOperation[] a list of
MutateOperations that create the new campaign criteria */ private static
function createCampaignCriterionOperations(int $customerId): array { $operations
= []; // Set the LOCATION campaign criteria. // Target all of New York City
except Brooklyn. // Location IDs are listed here: //
https://developers.google.com/google-ads/api/reference/data/geotargets //
and they can also be retrieved using the GeoTargetConstantService as shown //
here:
https://developers.google.com/google-ads/api/docs/targeting/location-targeting
// // We will add one positive location target for New York City
(ID=1023191) // and one negative location target for Brooklyn (ID=1022762). //
First, adds the positive (negative = false) for New York City. $operations[]
= new MutateOperation([ 'campaign_criterion_operation' => new
CampaignCriterionOperation([ 'create' => new CampaignCriterion([ 'campaign'
=> ResourceNames::forCampaign( $customerId,
self::PERFORMANCE_MAX_CAMPAIGN_TEMPORARY_ID ), 'location' => new
LocationInfo([ 'geo_target_constant' =>
ResourceNames::forGeoTargetConstant(1023191) ]), 'negative' => false ]) ])
]); // Next adds the negative target for Brooklyn. $operations[] = new
MutateOperation([ 'campaign_criterion_operation' => new
CampaignCriterionOperation([ 'create' => new CampaignCriterion([ 'campaign'
=> ResourceNames::forCampaign( $customerId,
self::PERFORMANCE_MAX_CAMPAIGN_TEMPORARY_ID ), 'location' => new
LocationInfo([ 'geo_target_constant' =>
ResourceNames::forGeoTargetConstant(1022762) ]), 'negative' => true ]) ])
]); // Sets the LANGUAGE campaign criterion. $operations[] = new
MutateOperation([ 'campaign_criterion_operation' => new
CampaignCriterionOperation([ 'create' => new CampaignCriterion([ 'campaign'
=> ResourceNames::forCampaign( $customerId,
self::PERFORMANCE_MAX_CAMPAIGN_TEMPORARY_ID ), // Set the language. // For
a list of all language codes, see: //
https://developers.google.com/google-ads/api/reference/data/codes-formats#expandable-7 'language'
=> new LanguageInfo([ 'language_constant' =>
ResourceNames::forLanguageConstant(1000) // English ]) ]) ]) ]); return
$operations; } /** * Creates multiple text assets and returns the list of
resource names. * * @param GoogleAdsClient $googleAdsClient the Google Ads
API client * @param int $customerId the customer ID * @param string[]
$texts a list of strings, each of which will be used to create a text asset *
@return string[] a list of asset resource names */ 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; } /** * Creates a list of MutateOperations that create
a new asset group. * * A temporary ID will be assigned to this asset group
so that it can * be referenced by other objects being created in the same
Mutate request. * * @param GoogleAdsClient $googleAdsClient the Google Ads
API client * @param int $customerId the customer ID * @param string[]
$headlineAssetResourceNames a list of headline resource names * @param
string[] $descriptionAssetResourceNames a list of description resource names *
@return MutateOperation[] a list of MutateOperations that create new asset
group */ private static function createAssetGroupOperations( int
$customerId, array $headlineAssetResourceNames, array
$descriptionAssetResourceNames ): array { $operations = []; // Creates a
new mutate operation that creates an asset group operation. $operations[] =
new MutateOperation([ 'asset_group_operation' => new AssetGroupOperation([ 'create'
=> new AssetGroup([ 'resource_name' => ResourceNames::forAssetGroup(
$customerId, self::ASSET_GROUP_TEMPORARY_ID ), 'name' => 'Performance Max
asset group #' . Helper::getPrintableDatetime(), 'campaign' =>
ResourceNames::forCampaign( $customerId,
self::PERFORMANCE_MAX_CAMPAIGN_TEMPORARY_ID ), 'final_urls' =>
['http://www.example.com'], 'final_mobile_urls' =>
['http://www.example.com'], 'status' => AssetGroupStatus::PAUSED ]) ]) ]); //
For the list of required assets for a Performance Max campaign, see //
https://developers.google.com/google-ads/api/docs/performance-max/assets //
An AssetGroup is linked to an Asset by creating a new AssetGroupAsset //
and providing: // - the resource name of the AssetGroup // - the resource
name of the Asset // - the field_type of the Asset in this AssetGroup // //
To learn more about AssetGroups, see //
https://developers.google.com/google-ads/api/docs/performance-max/asset-groups. //
Links the previously created multiple text assets. // Links the headline
assets. foreach ($headlineAssetResourceNames as $resourceName) { $operations[]
= new MutateOperation([ 'asset_group_asset_operation' => new
AssetGroupAssetOperation([ 'create' => new AssetGroupAsset([ 'asset' =>
$resourceName, 'asset_group' => ResourceNames::forAssetGroup( $customerId,
self::ASSET_GROUP_TEMPORARY_ID ), 'field_type' => AssetFieldType::HEADLINE
]) ]) ]); } // Links the description assets. foreach
($descriptionAssetResourceNames as $resourceName) { $operations[] = new
MutateOperation([ 'asset_group_asset_operation' => new
AssetGroupAssetOperation([ 'create' => new AssetGroupAsset([ 'asset' =>
$resourceName, 'asset_group' => ResourceNames::forAssetGroup( $customerId,
self::ASSET_GROUP_TEMPORARY_ID ), 'field_type' =>
AssetFieldType::DESCRIPTION ]) ]) ]); } // Creates and links the long
headline text asset. $operations = array_merge($operations,
self::createAndLinkTextAsset( $customerId, 'Travel the World',
AssetFieldType::LONG_HEADLINE )); // Creates and links the business name
text asset. $operations = array_merge($operations,
self::createAndLinkTextAsset( $customerId, 'Interplanetary Cruises',
AssetFieldType::BUSINESS_NAME )); // Creates and links the image assets. //
Creates and links the Logo Asset. $operations = array_merge($operations,
self::createAndLinkImageAsset( $customerId, 'https://gaagl.page.link/bjYi',
AssetFieldType::LOGO, 'Marketing Logo' )); // Creates and links the
Marketing Image Asset. $operations = array_merge($operations,
self::createAndLinkImageAsset( $customerId, 'https://gaagl.page.link/Eit5',
AssetFieldType::MARKETING_IMAGE, 'Marketing Image' )); // Creates and links
the Square Marketing Image Asset. $operations = array_merge($operations,
self::createAndLinkImageAsset( $customerId, 'https://gaagl.page.link/bjYi',
AssetFieldType::SQUARE_MARKETING_IMAGE, 'Square Marketing Image' )); return
$operations; } /** * Creates a list of MutateOperations that create a new
linked text asset. * * @param int $customerId the customer ID * @param
string $text the text of the asset to be created * @param int $fieldType
the field type of the new asset in the AssetGroupAsset * @return
MutateOperation[] a list of MutateOperations that create a new linked text
asset */ private static function createAndLinkTextAsset( int $customerId, string
$text, int $fieldType ): array { $operations = []; // Creates a new mutate
operation that creates a text asset. $operations[] = new MutateOperation([ 'asset_operation'
=> new AssetOperation([ 'create' => new Asset([ 'resource_name' =>
ResourceNames::forAsset($customerId, self::$nextTempId), 'text_asset' =>
new TextAsset(['text' => $text]) ]) ]) ]); // Creates an asset group asset
to link the asset to the asset group. $operations[] = new MutateOperation([ 'asset_group_asset_operation'
=> new AssetGroupAssetOperation([ 'create' => new AssetGroupAsset([ 'asset'
=> ResourceNames::forAsset($customerId, self::$nextTempId), 'asset_group'
=> ResourceNames::forAssetGroup( $customerId, self::ASSET_GROUP_TEMPORARY_ID
), 'field_type' => $fieldType ]) ]) ]); self::$nextTempId--; return
$operations; } /** * Creates a list of MutateOperations that create a new
linked image asset. * * @param int $customerId the customer ID * @param
string $url the URL of the image to be retrieved and put into an asset *
@param int $fieldType the field type of the new asset in the AssetGroupAsset *
@param string $assetName the asset name * @return MutateOperation[] a list
of MutateOperations that create a new linked image asset */ private static
function createAndLinkImageAsset( int $customerId, string $url, int
$fieldType, string $assetName ): array { $operations = []; // Creates a new
mutate operation that creates an image asset. $operations[] = new
MutateOperation([ 'asset_operation' => new AssetOperation([ 'create' => new
Asset([ 'resource_name' => ResourceNames::forAsset($customerId,
self::$nextTempId), // 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' =>
$assetName, 'image_asset' => new ImageAsset(['data' =>
file_get_contents($url)]) ]) ]) ]); // Creates an asset group asset to link
the asset to the asset group. $operations[] = new MutateOperation([ 'asset_group_asset_operation'
=> new AssetGroupAssetOperation([ 'create' => new AssetGroupAsset([ 'asset'
=> ResourceNames::forAsset($customerId, self::$nextTempId), 'asset_group'
=> ResourceNames::forAssetGroup( $customerId, self::ASSET_GROUP_TEMPORARY_ID
), 'field_type' => $fieldType ]) ]) ]); self::$nextTempId--; return
$operations; } /** * Creates a list of MutateOperations that may create
asset group signals. * * @param int $customerId the customer ID * @param
string $assetGroupResourceName the resource name of the asset group *
@param int|null $audienceId the audience ID * @return MutateOperation[] a
list of MutateOperations that may create asset group signals */ private
static function createAssetGroupSignalOperations( int $customerId, string
$assetGroupResourceName, ?int $audienceId ): array { $operations = []; if
(is_null($audienceId)) { return $operations; } $operations[] = new
MutateOperation([ 'asset_group_signal_operation' => new
AssetGroupSignalOperation([ // To learn more about Audience Signals, see //
https://developers.google.com/google-ads/api/docs/performance-max/asset-groups#audience_signals. 'create'
=> new AssetGroupSignal([ 'asset_group' => $assetGroupResourceName, 'audience'
=> new AudienceInfo([ 'audience' => ResourceNames::forAudience($customerId,
$audienceId) ]) ]) ]) ]); return $operations; } /** * Prints the details of
a MutateGoogleAdsResponse. Parses the "response" oneof field name and *
uses it to extract the new entity's name and resource name. * * @param
MutateGoogleAdsResponse $mutateGoogleAdsResponse the mutate Google Ads
response */ private static function printResponseDetails( MutateGoogleAdsResponse
$mutateGoogleAdsResponse ): void { foreach
($mutateGoogleAdsResponse->getMutateOperationResponses() as $response) { /**
@var MutateOperationResponse $response */ $getter =
Serializer::getGetter($response->getResponse()); printf( "Created a(n) %s
with '%s'.%s", preg_replace( '/Result$/', '',
ucfirst(Serializer::toCamelCase($response->getResponse())) ),
$response->$getter()->getResourceName(), PHP_EOL ); } } }
AddPerformanceMaxCampaign::main();
Emroon Wandee
Aug 26, 2024, 8:18:48 AM8/26/24
to Dushyant, Google Ads API and AdWords API Forum
คือผมไม่เข้าใจครับ
ในวันที่ จ. 26 ส.ค. 2024 7:14 หลังเที่ยง Dushyant <dkno...@gmail.com> เขียนว่า:
<?php /** * Copyright 2021 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * https://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ namespace Google\Ads\GoogleAds\Examples\AdvancedOperations; require __DIR__ . '/../../vendor/autoload.php'; <span style="color-scheme: unset; forced-color-adjust: unset; mask-image: unset; mask-size: unset; mask-repeat: unset; mask-origin: unset; mask-clip: unset; mask-composite: unset; mask-mode: unset; math-depth: unset; position: unset; position-anchor: unset; appearance: unset; color: unset; font-feature-settings: unset; font-kerning: unset; font-optical-sizing: unset; font-palette: unset; font-size: unset; font-stretch: unset; font-style: unset; font-synthesis: unset; font-variant: unset; font-variation-settings: unset; font-weight: unset; inset-area: unset; text-orientation: unset; text-rendering: unset; text-spacing-trim: unset; writing-mode: unset; zoom: unset; accent-color: unset; place-content: unset; place-items: unset; place-self: unset; alignment-baseline: unset; anchor-name: unset; animation-composition: unset; animation: unset; app-region: unset; aspect-ratio: unset; backdrop-filter: unset; backface-visibility: unset; background: unset; background-blend-mode: unset; baseline-shift: unset; baseline-source: unset; block-size: unset; border-block: unset; border: unset; border-radius: unset; border-collapse: unset; border-end-end-radius: unset; border-end-start-radius: unset; border-inline: unset; border-start-end-radius: unset; border-start-start-radius: unset; inset: unset; box-shadow: unset; box-sizing: unset; break-after: unset; break-before: unset; break-inside: unset; buffered-rendering: unset; caption-side: unset; caret-color: unset; clear: unset; clip: unset; clip-path: unset; clip-rule: unset; color-interpolation: unset; color-interpolation-filters: unset; color-rendering: unset; columns: unset; column-fill: unset; gap: unset; column-rule: unset; column-span: unset; contain: unset; contain-intrinsic-block-size: unset; contain-intrinsic-size: unset; contain-intrinsic-inline-size: unset; container: unset; content: unset; content-visibility: unset; counter-increment: unset; counter-reset: unset; counter-set: unset; cursor: unset; cx: unset; cy: unset; d: unset; display: unset; dominant-baseline: unset; empty-cells: unset; field-sizing: unset; fill: unset; fill-opacity: unset; fill-rule: unset; filter: unset; flex: unset; flex-flow: unset; float: unset; flood-color: unset; flood-opacity: unset; grid: unset; grid-area: unset; height: unset; hyphenate-character: unset; hyphenate-limit-chars: unset; hyphens: unset; image-orientation: unset; image-rendering: unset; initial-letter: unset; inline-size: unset; inset-block: unset; inset-inline: unset; isolation: unset; letter-spacing: unset; lighting-color: unset; line-break: unset; line-height: unset; list-style: unset; margin-block: unset; margin: unset; margin-inline: unset; marker: unset; mask-type: unset; math-shift: unset; math-style: unset; max-block-size: unset; max-height: unset; max-inline-size: unset; max-width: unset; min-block-size: unset; min-height: unset; min-inline-size: unset; min-width: unset; mix-blend-mode: unset; object-fit: unset; object-position: unset; object-view-box: unset; offset: unset; opacity: unset; order: unset; orphans: unset; outline: unset; outline-offset: unset; overflow-anchor: unset; overflow-clip-margin: unset; overflow-wrap: unset; overflow: unset; overlay: unset; overscroll-behavior-block: unset; overscroll-behavior-inline: unset; overscroll-behavior: unset; padding-block: unset; padding: unset; pad
Reply all
Reply to author
Forward
0 new messages