Cách xử lý lỗi vi phạm chính sách trong Google Ads hiệu quả

// Copyright 2020 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.package com.google.ads.googleads.examples.errorhandling;

import com.google.ads.googleads.v18.common.AdTextAsset;
import com.google.ads.googleads.v18.common.PolicyTopicEntry;
import com.google.ads.googleads.v18.errors.PolicyFindingDetails;
import com.google.ads.googleads.v18.resources.AdGroupAd;
import com.google.ads.googleads.v18.services.AdGroupAdOperation;
import com.google.ads.googleads.v18.services.AdGroupAdServiceClient;
import com.google.ads.googleads.v18.services.MutateAdGroupAdsResponse;
import com.google.ads.googleads.lib.GoogleAdsClient;
import java.util.ArrayList;
import java.util.List;

/**
* Ví dụ minh họa cách yêu cầu miễn trừ lỗi vi phạm chính sách đối với quảng cáo tìm kiếm phản hồi.
*/
public class HandleResponsiveSearchAdPolicyViolations {

public static void main(String[] args) {
// Tạo đối tượng GoogleAdsClient.
GoogleAdsClient googleAdsClient = GoogleAdsClient.newBuilder().fromPropertiesFile().build();

// Gọi hàm xử lý lỗi vi phạm chính sách.
try {
new HandleResponsiveSearchAdPolicyViolations().runExample(googleAdsClient, 123456789L, 987654321L);
} catch (Exception e) {
System.err.println(“Lỗi khi xử lý yêu cầu: “ + e.getMessage());
}
}

/**
* Chạy ví dụ xử lý quảng cáo.
*/
public void runExample(GoogleAdsClient googleAdsClient, long customerId, long adGroupId) {
// Tạo quảng cáo nhóm với các nội dung thử nghiệm.
AdGroupAd.Builder adGroupAdBuilder = AdGroupAd.newBuilder()
.setAdGroup(ResourceNames.adGroup(customerId, adGroupId))
.setStatus(AdGroupAdStatus.PAUSED)
.getAdBuilder()
.addFinalUrls(“https://www.example.com”)
.getResponsiveSearchAdBuilder()
.addAllHeadlines(ImmutableList.of(
AdTextAsset.newBuilder().setText(“Cruise to Mars”).build(),
AdTextAsset.newBuilder().setText(“Best Space Cruise Line”).build(),
AdTextAsset.newBuilder().setText(“Experience the Stars”).build()))
.addAllDescriptions(ImmutableList.of(
AdTextAsset.newBuilder().setText(“Buy your tickets now!!!!!!!”).build(),
AdTextAsset.newBuilder().setText(“Visit the Red Planet”).build()));

AdGroupAdOperation operation = AdGroupAdOperation.newBuilder()
.setCreate(adGroupAdBuilder.build())
.build();

// Xử lý vi phạm chính sách.
try (AdGroupAdServiceClient client = googleAdsClient.getLatestVersion().createAdGroupAdServiceClient()) {
client.mutateAdGroupAds(String.valueOf(customerId), ImmutableList.of(operation));
} catch (GoogleAdsException ex) {
List<String> ignorableTopics = fetchIgnorablePolicyTopics(ex);
requestExemption(ignorableTopics, client, operation, customerId);
}
}

/**
* Tìm các chủ đề chính sách có thể được miễn trừ.
*/
private List<String> fetchIgnorablePolicyTopics(GoogleAdsException gae) {
List<String> ignorableTopics = new ArrayList<>();
for (GoogleAdsError error : gae.getGoogleAdsFailure().getErrorsList()) {
if (error.getDetails() != null && error.getDetails().hasPolicyFindingDetails()) {
for (PolicyTopicEntry topic : error.getDetails().getPolicyFindingDetails().getPolicyTopicEntriesList()) {
ignorableTopics.add(topic.getTopic());
}
}
}
return ignorableTopics;
}

/**
* Gửi yêu cầu miễn trừ các vi phạm chính sách.
*/
private void requestExemption(List<String> ignorableTopics, AdGroupAdServiceClient client, AdGroupAdOperation operation, long customerId) {
operation.toBuilder().getPolicyValidationParameterBuilder().addAllIgnorablePolicyTopics(ignorableTopics);
MutateAdGroupAdsResponse response = client.mutateAdGroupAds(String.valueOf(customerId), ImmutableList.of(operation));
System.out.printf(“Đã thêm quảng cáo thành công với tên tài nguyên ‘%s’.%n”, response.getResults(0).getResourceName());
}
}