สร้างการยกเว้นข้อมูล

ประเด็นสําคัญ: การยกเว้นข้อมูลมีไว้สำหรับใช้เมื่อเกิดการหยุดทำงานหรือปัญหาหลักๆ การใช้บ่อยครั้งหรือเป็นเวลานานอาจส่งผลเสียต่อประสิทธิภาพของ Smart Bidding

การยกเว้นข้อมูลเป็นเครื่องมือขั้นสูงที่ใช้ส่งข้อมูลไปยัง Smart Bidding เพื่อบอกให้ละเว้นข้อมูลทั้งหมดนับตั้งแต่วันที่เกิดปัญหากับเครื่องมือวัด Conversion ของบัญชี ดูรายละเอียดเพิ่มเติมเกี่ยวกับวิธีการทำงานของการยกเว้นข้อมูลได้ที่หน้าความช่วยเหลือเกี่ยวกับการยกเว้นข้อมูล

สร้างการยกเว้นข้อมูลแบบเป็นโปรแกรมโดยใช้ BiddingDataExclusions

ขอบเขต

BiddingDataExclusions มีscope ที่ต้องระบุซึ่งสามารถตั้งค่าเป็นค่าต่อไปนี้ ระบบจะตั้งค่าตัวเลือกการกําหนดค่าเฉพาะขอบเขตเพิ่มเติมตามขอบเขตที่ใช้

หมายเหตุ: ยังมีขอบเขต CUSTOMER แบบอ่านอย่างเดียวด้วย แต่จะใช้สร้างการยกเว้นข้อมูลใหม่ไม่ได้

• CAMPAIGN - การยกเว้นมีผลกับแคมเปญที่เฉพาะเจาะจง ตั้งค่าช่อง campaigns เป็นรายการชื่อแหล่งข้อมูลแคมเปญที่จะใช้การยกเว้นนี้
  • จำนวนแคมเปญสูงสุดต่อ BiddingDataExclusion คือ 2,000 แคมเปญ
• CHANNEL - การยกเว้นจะมีผลกับแคมเปญที่อยู่ในประเภทแชแนลที่เจาะจง ตั้งค่าช่อง advertising_channel_types เป็นรายการ AdvertisingChannelTypes ที่จะใช้การยกเว้นนี้

อุปกรณ์

นอกจากขอบเขตแล้ว คุณยังกําหนดค่าการยกเว้นข้อมูลได้ด้วยรายการประเภทอุปกรณ์ที่ไม่บังคับซึ่งจะใช้การยกเว้น หากตั้งค่าเป็น devices ระบบจะยกเว้นเฉพาะข้อมูล Conversion จากอุปกรณ์ประเภทที่ระบุ หากไม่ระบุ ระบบจะยกเว้นข้อมูล Conversion จากอุปกรณ์ทุกประเภท

วันที่และเวลา

นอกจากขอบเขตและอุปกรณ์ที่ไม่บังคับแล้ว การยกเว้นข้อมูลแต่ละรายการต้องมีวันที่และเวลาเริ่มต้นและสิ้นสุด การยกเว้นข้อมูลจะมองย้อนกลับและควรใช้กับเหตุการณ์ที่มี start_date_time ที่ผ่านมาและ end_date_time ที่ผ่านมาหรือในอนาคต เวลาจะแสดงตามเขตเวลาของบัญชี

ตัวอย่าง

ตัวอย่างต่อไปนี้แสดงวิธีสร้างการยกเว้นข้อมูลที่มีขอบเขต CHANNEL ส่วนที่มีการแสดงความคิดเห็นจะแสดงวิธีระบุแคมเปญในกรณีที่คุณตั้งค่าขอบเขต CAMPAIGN แทน

Java

BiddingDataExclusion DataExclusion =
    BiddingDataExclusion.newBuilder()
        // A unique name is required for every data exclusion.
        .setName("Data exclusion #" + getPrintableDateTime())
        // The CHANNEL scope applies the data exclusion to all campaigns of specific
        // advertising channel types. In this example, the exclusion will only apply to
        // Search campaigns. Use the CAMPAIGN scope to instead limit the scope to specific
        // campaigns.
        .setScope(SeasonalityEventScope.CHANNEL)
        .addAdvertisingChannelTypes(AdvertisingChannelType.SEARCH)
        // If setting scope CAMPAIGN, add individual campaign resource name(s) according to
        // the commented out line below.
        // .addCampaigns("INSERT_CAMPAIGN_RESOURCE_NAME_HERE")
        .setStartDateTime(startDateTime)
        .setEndDateTime(endDateTime)
        .build();

BiddingDataExclusionOperation operation =
    BiddingDataExclusionOperation.newBuilder().setCreate(DataExclusion).build();

MutateBiddingDataExclusionsResponse response =
    DataExclusionServiceClient.mutateBiddingDataExclusions(
        customerId.toString(), ImmutableList.of(operation));
System.out.printf(
    "Added data exclusion with resource name: %s%n",
    response.getResults(0).getResourceName());
AddBiddingDataExclusion.java
      

C#

BiddingDataExclusion dataExclusion = new BiddingDataExclusion()
{
    // A unique name is required for every data exclusion.
    Name = "Data exclusion #" + ExampleUtilities.GetRandomString(),
    // The CHANNEL scope applies the data exclusion to all campaigns of specific
    // advertising channel types. In this example, the the exclusion will only apply to
    // Search campaigns. Use the CAMPAIGN scope to instead limit the scope to specific
    // campaigns.
    Scope = SeasonalityEventScope.Channel,
    AdvertisingChannelTypes = { AdvertisingChannelType.Search },
    // The date range should be less than 14 days.
    StartDateTime = startDateTime,
    EndDateTime = endDateTime,
};
BiddingDataExclusionOperation operation = new BiddingDataExclusionOperation()
{
    Create = dataExclusion
};

try
{
    MutateBiddingDataExclusionsResponse response =
        biddingDataExclusionService.MutateBiddingDataExclusions(
            customerId.ToString(), new[] { operation });
    Console.WriteLine($"Added data exclusion with resource name: " +
        $"{response.Results[0].ResourceName}");
}
catch (GoogleAdsException e)
{
    Console.WriteLine("Failure:");
    Console.WriteLine($"Message: {e.Message}");
    Console.WriteLine($"Failure: {e.Failure}");
    Console.WriteLine($"Request ID: {e.RequestId}");
    throw;
}
AddBiddingDataExclusion.cs
      

PHP

// Creates a bidding data exclusion.
$dataExclusion = new BiddingDataExclusion([
    // A unique name is required for every data exclusion.
    'name' => 'Data exclusion #' . Helper::getPrintableDatetime(),
    // The CHANNEL scope applies the data exclusion to all campaigns of specific
    // advertising channel types. In this example, the exclusion will only apply to
    // Search campaigns. Use the CAMPAIGN scope to instead limit the scope to specific
    // campaigns.
    'scope' => SeasonalityEventScope::CHANNEL,
    'advertising_channel_types' => [AdvertisingChannelType::SEARCH],
    // If setting scope CAMPAIGN, add individual campaign resource name(s) according to
    // the commented out line below.
    // 'campaigns' => ['INSERT_CAMPAIGN_RESOURCE_NAME_HERE'],
    'start_date_time' => $startDateTime,
    'end_date_time' => $endDateTime
]);

// Creates a bidding data exclusion operation.
$biddingDataExclusionOperation = new BiddingDataExclusionOperation();
$biddingDataExclusionOperation->setCreate($dataExclusion);

// Submits the bidding data exclusion operation to add the bidding data exclusion.
$biddingDataExclusionServiceClient =
    $googleAdsClient->getBiddingDataExclusionServiceClient();
$response = $biddingDataExclusionServiceClient->mutateBiddingDataExclusions(
    MutateBiddingDataExclusionsRequest::build($customerId, [$biddingDataExclusionOperation])
);

printf(
    "Added bidding data exclusion with resource name: '%s'.%s",
    $response->getResults()[0]->getResourceName(),
    PHP_EOL
);
AddBiddingDataExclusion.php
      

Python

bidding_data_exclusion_service = client.get_service(
    "BiddingDataExclusionService"
)
operation = client.get_type("BiddingDataExclusionOperation")
bidding_data_exclusion = operation.create
# A unique name is required for every data exclusion
bidding_data_exclusion.name = f"Data exclusion #{uuid4()}"
# The CHANNEL scope applies the data exclusion to all campaigns of specific
# advertising channel types. In this example, the exclusion will only
# apply to Search campaigns. Use the CAMPAIGN scope to instead limit the
# scope to specific campaigns.
bidding_data_exclusion.scope = (
    client.enums.SeasonalityEventScopeEnum.CHANNEL
)
bidding_data_exclusion.advertising_channel_types.append(
    client.enums.AdvertisingChannelTypeEnum.SEARCH
)
# If setting scope CAMPAIGN, add individual campaign resource name(s)
# according to the commented out line below.
#
# bidding_data_exclusion.campaigns.append(
#     "INSERT_CAMPAIGN_RESOURCE_NAME_HERE"
# )

bidding_data_exclusion.start_date_time = start_date_time
bidding_data_exclusion.end_date_time = end_date_time

response = bidding_data_exclusion_service.mutate_bidding_data_exclusions(
    customer_id=customer_id, operations=[operation]
)

resource_name = response.results[0].resource_name

print(f"Added data exclusion with resource name: '{resource_name}'")
add_bidding_data_exclusion.py
      

Ruby

client = Google::Ads::GoogleAds::GoogleAdsClient.new

operation = client.operation.create_resource.bidding_data_exclusion do |bda|
  # A unique name is required for every data excluseion.
  bda.name = "Seasonality Adjustment #{(Time.new.to_f * 1000).to_i}"

  # The CHANNEL scope applies the data exclusion to all campaigns of specific
  # advertising channel types. In this example, the conversion_rate_modifier
  # will only apply to Search campaigns. Use the CAMPAIGN scope to instead
  # limit the scope to specific campaigns.
  bda.scope = :CHANNEL
  bda.advertising_channel_types << :SEARCH

  # If setting scope CAMPAIGN, add individual campaign resource name(s)
  # according to the commented out line below.
  #
  # bda.campaigns << "INSERT_CAMPAIGN_RESOURCE_NAME_HERE"

  bda.start_date_time = start_date_time
  bda.end_date_time = end_date_time
end

response = client.service.bidding_data_exclusion.mutate_bidding_data_exclusions(
  customer_id: customer_id,
  operations: [operation],
)

puts "Added data exclusion with resource name #{response.results.first.resource_name}."
add_bidding_data_exclusion.rb
      

Perl

my $data_exclusion =
  Google::Ads::GoogleAds::V18::Resources::BiddingDataExclusion->new({
    # A unique name is required for every data exclusion.
    name => "Data exclusion #" . uniqid(),
    # The CHANNEL scope applies the data exclusion to all campaigns of specific
    # advertising channel types. In this example, the exclusion will only apply
    # to Search campaigns. Use the CAMPAIGN scope to instead limit the scope to
    # specific campaigns.
    scope                   => CHANNEL,
    advertisingChannelTypes => [SEARCH],
    # If setting scope CAMPAIGN, add individual campaign resource name(s)
    # according to the commented out line below.
    # campaigns     => ["INSERT_CAMPAIGN_RESOURCE_NAME_HERE"],
    startDateTime => $start_date_time,
    endDateTime   => $end_date_time
  });

my $operation =
  Google::Ads::GoogleAds::V18::Services::BiddingDataExclusionService::BiddingDataExclusionOperation
  ->new({
    create => $data_exclusion
  });

my $response = $api_client->BiddingDataExclusionService()->mutate({
    customerId => $customer_id,
    operations => [$operation]});

printf "Added data exclusion with resource name: '%s'.\n",
  $response->{results}[0]{resourceName};
add_bidding_data_exclusion.pl