إنشاء استثناءات بيانات

النقطة الرئيسية: تهدف استثناءات البيانات إلى مراعاة حالات انقطاع الخدمة أو المشاكل الرئيسية. وفي حال استخدامها بشكل متكرّر أو لفترات طويلة، قد يؤثّر ذلك سلبًا في أداء عروض الأسعار الذكية.

استثناءات البيانات هي أداة متقدّمة يمكن استخدامها لإعلام عروض الأسعار الذكية بهدف تجاهل جميع البيانات من التواريخ التي حدثت فيها مشاكل في تتبُّع الإحالات الناجحة في أحد الحسابات. لمزيد من التفاصيل حول آلية عمل استبعادات البيانات، يُرجى الرجوع إلى صفحة مساعدة استبعادات البيانات.

أنشئ استثناءات بيانات آليًا باستخدام BiddingDataExclusions. لا يمكنك ضبط BiddingDataExclusions في حساب إداري، بل على مستوى الحملة فقط.

النطاق

تحتوي BiddingDataExclusions على سمة scope مطلوبة يمكن ضبطها على القيم التالية: يتم ضبط خيارات الضبط الإضافية الخاصة بالنطاق حسب النطاق المستخدَم.

ملاحظة: يتوفّر أيضًا نطاق CUSTOMER للقراءة فقط، ولكن لا يمكن استخدامه ل إنشاء استبعادات بيانات جديدة.

• CAMPAIGN - يتم تطبيق الاستبعاد على حملات معيّنة. اضبط الحقل campaigns على قائمة بأسماء موارد الحملة التي سيسري عليها هذا الاستبعاد.
  • الحدّ الأقصى لعدد الحملات لكلّ BiddingDataExclusion هو 2,000 حملة.
• CHANNEL - يتم تطبيق الاستبعاد على الحملات التي تنتمي إلى أنواع قنوات معيّنة. اضبط حقل advertising_channel_types على قائمة AdvertisingChannelTypes التي ينطبق عليها الاستبعاد.

الأجهزة

بالإضافة إلى نطاقها، يمكن ضبط استثناءات البيانات باستخدام قائمة اختيارية بأنواع الأجهزة التي سيسري عليها الاستثناء. في حال ضبط devices، يتم استبعاد بيانات الإحالات الناجحة فقط من أنواع الأجهزة المحدّدة. في حال عدم تحديد نوع الجهاز، سيتم استبعاد بيانات الإحالات الناجحة من جميع أنواع الأجهزة.

التواريخ والأوقات

بالإضافة إلى النطاق والأجهزة الاختيارية، يجب أن يتضمّن كل استبعاد بيانات تاريخ بدء وتاريخ انتهاء ووقتًا. يُستخدَم استثناء البيانات للأحداث التي تحتوي على start_date_time في السابق وend_date_time في السابق أو المستقبل. يتم عرض الأوقات حسب المنطقة الزمنية للحساب.

مثال

يوضّح المثال التالي كيفية إنشاء استثناء بيانات باستخدام نطاق CHANNEL. توضّح الأقسام التي تمّت إضافة تعليقات توضيحية إليها كيفية تحديد الحملات في حال أردت بدلاً من ذلك ضبط نطاق CAMPAIGN.

Java#CPHPPythonRubyPerl

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
      

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
      

// 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
      

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
      

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
      

my $data_exclusion =
  Google::Ads::GoogleAds::V19::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::V19::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