‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

יצירת עקומת פוטנציאל חשיפה

אחרי שאוספים את הגדרות הטירגוט ואת תמהיל המוצרים לתוכנית המדיה, אפשר ליצור עקומה של תקציבים לעומת פוטנציאל החשיפה באמצעות השיטה GenerateReachForecast ב-ReachPlanService. פרטים על שדות הבקשה זמינים במילון המונחים ובמדריך לתוכנית המדיה.

מדדי תחזית

התשובה מ-GenerateReachForecast כוללת מדדים שונים בהודעה Forecast, שמספקים תובנות לגבי הביצועים הפוטנציאליים של הקמפיין המתוכנן. המדדים האלה כוללים:

היקף החשיפה (בקהל היעד ובאופן כללי, כולל צפייה משותפת)
חשיפות (ביעד וסה"כ, כולל צפייה משותפת וניתנות לצפייה)
פירוט של התדירות האפקטיבית (כמה משתמשים ייחודיים נחשפו למודעות לפחות מספר מסוים של פעמים, למשל חשיפה אחת או יותר, שתי חשיפות או יותר או שלוש חשיפות או יותר)
פעולות של משתמשים (צפיות תקפות, המרות וקליקים)

תחזית פוטנציאל החשיפה בקמפיינים ליצירת ביקוש

כשיוצרים עקומות ל-DEMAND_GEN מוצרים שניתן לתכנן, צריך גם לכלול שיעור המרה צפוי לכל מוצר.

כדי לקבל הצעות לשיעור המרה למוצרים נתמכים שאפשר לתכנן, משתמשים ב-method‏ GenerateConversionRates. השיטה הזו מחזירה הצעות לשיעורי המרה על סמך היסטוריית הביצועים של החשבון שלכם, או שיעורים מוצעים על סמך הביצועים של כל המפרסמים.

ב-DEMAND_GEN מוצרים, יכול להיות ש-GenerateConversionRates יחזיר כמה הצעות לאותו מוצר. בחלק מההצעות השדה surface_targeting מאוכלס, מה שמציין שההצעה רלוונטית רק לשילוב הספציפי הזה של פלטפורמות (לדוגמה, YouTube Shorts). אם השדה surface_targeting לא מאוכלס, ההצעה היא הממוצע של הקמפיין ליצירת ביקוש למוצר הזה. כשיוצרים תחזיות לקמפיינים ליצירת ביקוש עם טירגוט לפלטפורמות, כדאי להשתמש בהצעה הכי ספציפית לשיעור המרה שזמינה.

בנוסף לשיעורי המרה (CVR), משתמשים בקמפיינים ליצירת ביקוש יכולים להשתמש בGenerateReachForecast כדי לחזות את clicks, וזה רלוונטי במיוחד לקמפיינים שמבצעים אופטימיזציה של קמפיין לקליקים, כמו קמפיינים ליצירת ביקוש עם קביעת הצעת המחיר לפי מקסימום קליקים.

תחזית פוטנציאל החשיפה ב-YouTube Select

ב-YouTube Select‏ (YTS) ב-ReachPlanService יש תמיכה בטירגוט ברמת חבילת הערוצים לכל המיקומים שעומדים בדרישות של YTS בתמחור של הזמנה מיידית. משתמשים בשדה youtube_select_lineup_targeting ב-ReachPlanService.ListPlannableProducts כדי לזהות את חבילות הערוצים הזמינות (השדה youtube_select_lineup_targeting החליף את השדה youtube_select_lineups, שהוצא משימוש ב-v23 והוסר ב-v24).

כשמבקשים תחזית ל-YTS בהזמנה מיידית, יכולות להופיע השגיאות הבאות:

שמירת העקומות

כדי להקל על המשתמשים, אתם יכולים לשמור רק עקומות בודדות. אסור בהחלט לשמור במטמון עקומות בכמות גדולה. אם אתם צריכים ליצור עקומות בכמות גדולה, פנו קודם לאיש הקשר האחראי לחשבון Google שלכם.

טיפול בשגיאות

בקשות ל-ReachPlanService צריכות להיות במבנה הבסיסי של ה-API, ואם הן נכשלות באימות, יכול להיות שיוחזרו שגיאות נפוצות.

בנוסף לשגיאות נפוצות, ReachPlanService יכול להחזיר שגיאות ספציפיות לכלי לתכנון היקף החשיפה שמפורטות ב-ReachPlanError.

קוד לדוגמה

העקומה כוללת את החשיפות ואת היקף החשיפה למשתמשים במספרים מוחלטים, וגם את גודל האוכלוסייה בהתאם למפקד האוכלוסין ולגודל הקהל ב-YouTube, לפי המאפיינים הדמוגרפיים והמדינה שביקשתם.

Java

private void getReachCurve(
    ReachPlanServiceClient reachPlanServiceClient, GenerateReachForecastRequest request) {
  GenerateReachForecastResponse response = reachPlanServiceClient.generateReachForecast(request);
  System.out.println("Reach curve output:");
  System.out.println(
      "Currency, Cost Micros, On-Target Reach, On-Target Imprs, Total Reach, Total Imprs,"
          + " Products");
  for (ReachForecast point : response.getReachCurve().getReachForecastsList()) {
    System.out.printf(
        "%s, \"",
        Joiner.on(", ")
            .join(
                request.getCurrencyCode(),
                String.valueOf(point.getCostMicros()),
                String.valueOf(point.getForecast().getOnTargetReach()),
                String.valueOf(point.getForecast().getOnTargetImpressions()),
                String.valueOf(point.getForecast().getTotalReach()),
                String.valueOf(point.getForecast().getTotalImpressions())));
    for (PlannedProductReachForecast product : point.getPlannedProductReachForecastsList()) {
      System.out.printf("[Product: %s, ", product.getPlannableProductCode());
      System.out.printf("Budget Micros: %s]", product.getCostMicros());
    }
    System.out.printf("\"%n");
  }
}ForecastReach.java

C#‎

public void GetReachCurve(ReachPlanServiceClient reachPlanService,
    GenerateReachForecastRequest request)
{
    GenerateReachForecastResponse response = reachPlanService.GenerateReachForecast(
        request);
    Console.WriteLine("Reach curve output:");
    Console.WriteLine(
        "Currency, Cost Micros, On-Target Reach, On-Target Impressions, Total Reach," +
        " Total Impressions, Products");
    foreach (ReachForecast point in response.ReachCurve.ReachForecasts)
    {
        Console.Write($"{request.CurrencyCode}, ");
        Console.Write($"{point.CostMicros}, ");
        Console.Write($"{point.Forecast.OnTargetReach}, ");
        Console.Write($"{point.Forecast.OnTargetImpressions}, ");
        Console.Write($"{point.Forecast.TotalReach}, ");
        Console.Write($"{point.Forecast.TotalImpressions}, ");
        Console.Write("\"[");
        foreach (PlannedProductReachForecast productReachForecast in
            point.PlannedProductReachForecasts)
        {
            Console.Write($"(Product: {productReachForecast.PlannableProductCode}, ");
            Console.Write($"Budget Micros: {productReachForecast.CostMicros}), ");
        }

        Console.WriteLine("]\"");
    }
}ForecastReach.cs

PHP

private static function getReachCurve(
    GoogleAdsClient $googleAdsClient,
    int $customerId,
    array $productMix,
    string $locationId,
    string $currencyCode
) {
    // Valid durations are between 1 and 90 days.
    $duration = new CampaignDuration(['duration_in_days' => 28]);
    $targeting = new Targeting([
        'plannable_location_id' => $locationId,
        'age_range' => ReachPlanAgeRange::AGE_RANGE_18_65_UP,
        'genders' => [
            new GenderInfo(['type' => GenderType::FEMALE]),
            new GenderInfo(['type' => GenderType::MALE])
        ],
        'devices' => [
            new DeviceInfo(['type' => Device::DESKTOP]),
            new DeviceInfo(['type' => Device::MOBILE]),
            new DeviceInfo(['type' => Device::TABLET])
        ]
    ]);

    // See the docs for defaults and valid ranges:
    // https://developers.google.com/google-ads/api/reference/rpc/latest/GenerateReachForecastRequest
    $response = $googleAdsClient->getReachPlanServiceClient()->generateReachForecast(
        GenerateReachForecastRequest::build($customerId, $duration, $productMix)
            ->setCurrencyCode($currencyCode)
            ->setTargeting($targeting)
    );

    printf(
        "Reach curve output:%sCurrency, Cost Micros, On-Target Reach, On-Target Imprs," .
            " Total Reach, Total Imprs, Products%s",
        PHP_EOL,
        PHP_EOL
    );
    foreach ($response->getReachCurve()->getReachForecasts() as $point) {
        $products = '';
        /** @var ReachForecast $point */
        foreach ($point->getPlannedProductReachForecasts() as $plannedProductReachForecast) {
            /** @var PlannedProductReachForecast $plannedProductReachForecast */
            $products .= sprintf(
                '(Product: %s, Budget Micros: %s)',
                $plannedProductReachForecast->getPlannableProductCode(),
                $plannedProductReachForecast->getCostMicros()
            );
        }
        printf(
            "%s, %d, %d, %d, %d, %d, %s%s",
            $currencyCode,
            $point->getCostMicros(),
            $point->getForecast()->getOnTargetReach(),
            $point->getForecast()->getOnTargetImpressions(),
            $point->getForecast()->getTotalReach(),
            $point->getForecast()->getTotalImpressions(),
            $products,
            PHP_EOL
        );
    }
}ForecastReach.php

Python

def request_reach_curve(
    client: GoogleAdsClient,
    customer_id: str,
    product_mix: list[PlannedProduct],
    location_id: str,
    currency_code: str,
):
    """Creates a sample request for a given product mix.

    Args:
        client: an initialized GoogleAdsClient instance.
        customer_id: The customer ID for the reach forecast.
        product_mix: The product mix for the reach forecast.
        location_id: The location ID to plan for.
        currency_code: Three-character ISO 4217 currency code.
    """
    # See the docs for defaults and valid ranges:
    # https://developers.google.com/google-ads/api/reference/rpc/latest/GenerateReachForecastRequest
    request: GenerateReachForecastRequest = client.get_type(
        "GenerateReachForecastRequest"
    )
    request.customer_id = customer_id
    # Valid durations are between 1 and 90 days.
    request.campaign_duration.duration_in_days = 28
    request.currency_code = currency_code
    request.cookie_frequency_cap = 0
    request.min_effective_frequency = 1
    request.planned_products = product_mix

    request.targeting.plannable_location_id = location_id
    request.targeting.age_range = (
        client.enums.ReachPlanAgeRangeEnum.AGE_RANGE_18_65_UP
    )

    # Add gender targeting to the request.
    gender_type: GenderTypeEnum
    for gender_type in [
        client.enums.GenderTypeEnum.FEMALE,
        client.enums.GenderTypeEnum.MALE,
    ]:
        gender: GenderInfo = client.get_type("GenderInfo")
        gender.type_ = gender_type
        request.targeting.genders.append(gender)

    # Add device targeting to the request.
    device_type: DeviceEnum
    for device_type in [
        client.enums.DeviceEnum.DESKTOP,
        client.enums.DeviceEnum.MOBILE,
        client.enums.DeviceEnum.TABLET,
    ]:
        device: DeviceInfo = client.get_type("DeviceInfo")
        device.type_ = device_type
        request.targeting.devices.append(device)

    reach_plan_service: ReachPlanServiceClient = client.get_service(
        "ReachPlanService"
    )
    response: GenerateReachForecastResponse = (
        reach_plan_service.generate_reach_forecast(request=request)
    )

    print(
        "Currency, Cost, On-Target Reach, On-Target Imprs, Total Reach,"
        " Total Imprs, Products"
    )
    point: ReachForecast
    for point in response.reach_curve.reach_forecasts:
        product_splits = []
        p: PlannedProductReachForecast
        for p in point.planned_product_reach_forecasts:
            product_splits.append(
                {p.plannable_product_code: p.cost_micros / ONE_MILLION}
            )
        print(
            [
                currency_code,
                point.cost_micros / ONE_MILLION,
                point.forecast.on_target_reach,
                point.forecast.on_target_impressions,
                point.forecast.total_reach,
                point.forecast.total_impressions,
                product_splits,
            ]
        )forecast_reach.py

Ruby

def get_reach_curve(
  client,
  reach_plan_service,
  customer_id,
  product_mix,
  location_id,
  currency_code)
  duration = client.resource.campaign_duration do |d|
    # Valid durations are between 1 and 90 days.
    d.duration_in_days = 28
  end

  targeting = client.resource.targeting do |t|
    t.plannable_location_id = location_id
    t.age_range = :AGE_RANGE_18_65_UP
    t.genders << client.resource.gender_info do |gender|
      gender.type = :FEMALE
    end
    t.genders << client.resource.gender_info do |gender|
      gender.type = :MALE
    end
    t.devices << client.resource.device_info do |device|
      device.type = :DESKTOP
    end
    t.devices << client.resource.device_info do |device|
      device.type = :MOBILE
    end
    t.devices << client.resource.device_info do |device|
      device.type = :TABLET
    end
  end

  # See the docs for defaults and valid ranges:
  # https://developers.google.com/google-ads/api/reference/rpc/latest/GenerateReachForecastRequest
  response = reach_plan_service.generate_reach_forecast(
    customer_id: customer_id,
    campaign_duration: duration,
    planned_products: product_mix,
    currency_code: currency_code,
    targeting: targeting,
  )

  puts "Reach curve output:"
  puts "Currency, Cost Micros, On-Target Reach, On-Target Imprs, " \
    "Total Reach, Total Imprs, Products"

  response.reach_curve.reach_forecasts.each do |point|
    products = ""
    point.planned_product_reach_forecasts.each do |product|
      products += "(Product: #{product.plannable_product_code}, "\
        "Cost Micros: #{product.cost_micros})"
    end
    puts "#{currency_code}, #{point.cost_micros}, " \
      "#{point.forecast.on_target_reach}, " \
      "#{point.forecast.on_target_impressions}, " \
      "#{point.forecast.total_reach}, " \
      "#{point.forecast.total_impressions}, " \
      "#{products}"
  end
endforecast_reach.rb

Perl

sub pull_reach_curve {
  my ($reach_plan_service, $reach_request) = @_;

  my $response = $reach_plan_service->generate_reach_forecast($reach_request);
  print "Reach curve output:\n";
  print "Currency,\tCost Micros,\tOn-Target Reach,\tOn-Target Imprs,\t" .
    "Total Reach,\tTotal Imprs,\tProducts\n";
  foreach my $point (@{$response->{reachCurve}{reachForecasts}}) {
    printf "%s,\t%d,\t%d,\t%d,\t%d,\t%d,\t'[", $reach_request->{currencyCode},
      $point->{costMicros}, $point->{forecast}{onTargetReach},
      $point->{forecast}{onTargetImpressions}, $point->{forecast}{totalReach},
      $point->{forecast}{totalImpressions};
    foreach my $productReachForecast (@{$point->{plannedProductReachForecasts}})
    {
      printf "(Product: %s, Budget Micros: %d), ",
        $productReachForecast->{plannableProductCode},
        $productReachForecast->{costMicros};
    }
    print "]'\n";
  }
}forecast_reach.pl

curl

Google Issue Tracker

אתם יכולים להשתמש ב-Google Issue Tracker כדי לשאול שאלות תמיכה, לדווח על באגים או להגיש בקשה להוספת תכונה. ‫Google עוקבת אחרי הבקשות, מתעדפת אותן ומפרסמת עדכונים לגביהן ישירות ב-Issue Tracker. למידע נוסף, קראו את המאמר דיווח על בעיה ב-Google Issue Tracker.

יוצרים בעיה באמצעות אחת מהתבניות הבאות של Issue Tracker:

מלאו את כל השדות בתבנית במידע מפורט כדי ש-Google תוכל לשחזר את הבקשה ולתעדף אותה. יכול להיות ש-Google תסגור דוחות חלקיים ותבקש מכם לשלוח דיווח חדש עם הפרטים החסרים.

הגדרת תוכנית מדיה