טירגוט לפי קהל

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

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

בנוסף, אפשר להגדיר טירגוט לפי קהל ברמת קבוצת המודעות באמצעות AdGroupCriterion.

AudienceInfo קריטריונים לטירגוט

כדי לטרגט קהל בקבוצת מודעות ליצירת ביקוש, צריך לבצע את השלבים הבאים:

  1. כשיוצרים את היעד AdGroup, מגדירים את audience_setting.use_audience_grouped לערך true (אי אפשר לשנות את ההגדרה הזו אחרי שיוצרים את קבוצת המודעות). אפשר גם להגדיר את campaign.audience_setting.use_audience_grouped לערך true כשיוצרים את הקמפיין, כדי למנוע החרגות של פלחים והחרגות דמוגרפיות ברמת הקמפיין.
  2. יוצרים או מאחזרים משאב Audience באמצעות AudienceService ומקבלים את השם או המזהה של המשאב.
  3. יוצרים AdGroupCriterion עם קריטריון AudienceInfo שהשדה audience שלו מוגדר לשם המשאב של הקהל.

בודקים את MutateAudienceResult ומצרפים את AudienceInfo

כשיוצרים קהל באמצעות AudienceService.MutateAudiences, כל פעולה מחזירה MutateAudienceResult. אפשר לקבל את audience_id על ידי ניתוח של resource_name שהוחזר, ולבדוק שדות שניתנים לשינוי (כמו name) באובייקט audience שהוחזר כש-response_content_type מוגדר ל-MUTABLE_RESOURCE. אחר כך מקצים את resource_name ל-AdGroupCriterion ב-AdGroup שנוצר באמצעות audience_setting.use_audience_grouped שמוגדר ל-true, ועוטפים את AdGroupCriterion ב-AdGroupCriterionOperation שמועבר ל-AdGroupCriterionService.MutateAdGroupCriteria:

# Step 1: Inspect MutateAudienceResult to get resource_name and audience_id.
for result in response.results:
    resource_name = result.resource_name
    # Format: customers/{customer_id}/audiences/{audience_id}
    audience_id = audience_service.parse_audience_path(resource_name)[
        "audience_id"
    ]
    print(
        f"Created audience with resource_name '{resource_name}' "
        f"and audience_id '{audience_id}'."
    )

    # Access mutable fields on result.audience when MUTABLE_RESOURCE is set:
    if result.audience.resource_name:
        print(f"Audience name from mutable resource: {result.audience.name}")

    # Step 2: Target the audience at the ad group level with AdGroupCriterion.
    # The target AdGroup must have audience_setting.use_audience_grouped = True
    # set when the ad group is created.
    ad_group_criterion_operation = client.get_type("AdGroupCriterionOperation")
    ad_group_criterion = ad_group_criterion_operation.create
    ad_group_criterion.ad_group = ad_group_resource_name
    ad_group_criterion.audience.audience = resource_name

    ad_group_criterion_service = client.get_service("AdGroupCriterionService")
    ad_group_criterion_service.mutate_ad_group_criteria(
        customer_id=customer_id,
        operations=[ad_group_criterion_operation],
    )