בכל פריט חדש להזמנת שטחי פרסום צריך להצהיר אם הוא יציג מודעות פוליטיות באיחוד האירופי. העלאות של קובצי SDF ושל Display & Video 360 API שלא כוללות הצהרות ייכשלו. לפרטים נוספים אפשר לעיין בדף ההוצאות משימוש.

דף זה תורגם על ידי Cloud Translation API.

העלאה של קהלים בהתאמה ללקוחות

אתם יכולים ליצור קהלים מסוג התאמה ללקוחות באמצעות פרטים ליצירת קשר עם לקוחות או מזהי מכשירים ניידים שהועלו באמצעות Display & Video 360 API. בדף הזה מוסבר איך ליצור קהל ראשוני של התאמה ללקוחות ולהוסיף נתוני לקוחות חדשים לקהל הקיים באמצעות Display & Video 360 API.

הכנת נתוני משתמשים

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

גיבוב (hash) של מידע אישי רגיש

חלק מהקהלים מסוג 'התאמה ללקוחות' נוצרים באמצעות פרטים רגישים ליצירת קשר עם הלקוחות. ב-Display & Video 360 נדרש לבצע גיבוב של נתונים רגישים באמצעות האלגוריתם SHA256 לפני שמעלים אותם. לפני ההעלאה, צריך לבצע גיבוב של שדות הנתונים הבאים:

שם פרטי
שם משפחה
כתובות אימייל
מספרי טלפון

אין לבצע גיבוב (hash) של מיקודים וקודי מדינות לפני ההעלאה. ניסיון להעלות נתוני לקוחות לא מוצפנים יוביל לשגיאה.

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

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

הגדרת הסכמת משתמשים

כשמעלים נתוני משתמשים, צריך להשתמש בשדות consent באובייקטים ContactInfoList או MobileDeviceIdList שסופקו כדי להעביר אותות הסכמה שניתנו על ידי המשתמשים הכלולים.

הגדרת אחד מהשדות באובייקט Consent לערך CONSENT_STATUS_DENIED תוביל לשגיאה.

אותות ההסכמה מוגדרים לכל המשתמשים שנוספו בבקשה אחת של firstPartyAndPartnerAudiences.create או של firstPartyAndPartnerAudiences.editCustomerMatchMembers. צריך להעלות משתמשים עם אותות הסכמה שונים בבקשות נפרדות.

יצירת קהל מסוג 'התאמה ללקוחות'

אפשר ליצור קהל בהתאמה ללקוחות באמצעות השיטה firstPartyAndPartnerAudiences.create. הקהל צריך להיות מוצהר כקהל מאינטראקציה ישירה, וצריך להיות לו audienceType של CUSTOMER_MATCH_CONTACT_INFO או CUSTOMER_MATCH_DEVICE_ID. צריך לספק את נתוני ההתאמה ללקוחות באמצעות השדה המתאים בשדה האיחוד members.

הנה דוגמה ליצירת קהל חדש מסוג 'התאמה ללקוחות' עם פרטים ליצירת קשר ומשך חברות של 540 ימים, באמצעות רשימה של מספרי טלפון מגובבים:

Java

// Create Customer Match audience object.
FirstPartyAndPartnerAudience customerMatchAudience =
    new FirstPartyAndPartnerAudience()
        .setDisplayName(display-name)
        .setFirstPartyAndPartnerAudienceType(
            "FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_FIRST_PARTY"
        )
        .setAudienceType("CUSTOMER_MATCH_CONTACT_INFO")
        .setMembershipDurationDays(540L);

// Build list of contact information objects.
ContactInfoList contactInfoList = new ContactInfoList();
ArrayList<ContactInfo> contactInfos = new ArrayList<ContactInfo>();
for (String hashedPhoneNumber : list-of-hashed-phone-numbers) {
  ContactInfo contactInfo = new ContactInfo();
  ArrayList<String> phoneNumberList = new ArrayList<String>();
  phoneNumberList.add(hashedPhoneNumber);
  contactInfo.setHashedPhoneNumbers(phoneNumberList);
  contactInfos.add(contactInfo);
}
contactInfoList.setContactInfos(contactInfos);

// Build consent object for passing consent if granted by the end user.
Consent consent =
    new Consent()
        .setAdUserData(ad-user-data-consent)
        .setAdPersonalization(ad-personalization-consent);
ContactInfoList.setConsent(consent);

// Assign contact info list to Customer Match audience.
customerMatchAudience.setContactInfoList(contactInfoList);

// Create Customer Match audience.
FirstPartyAndPartnerAudience response =
    service
        .firstPartyAndPartnerAudiences()
        .create(customerMatchAudience)
        .setAdvertiserId(advertiser-id)
        .execute();

// Display name of new audience.
System.out.printf(
    "Customer Match audience %s was created.",
    response.getName()
);

Python

# Build list of Contact Info objects
contact_infos = []
for hashed_phone_number in list-of-hashed-phone-numbers:
  contact_infos.append({'hashedPhoneNumbers': [hashed_phone_number]})

# Create a Customer Match first- and third-party audience object.
audience_obj = {
    'displayName': display-name,
    'firstPartyAndPartnerAudienceType':
        'FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_FIRST_PARTY',
    'audienceType': 'CUSTOMER_MATCH_CONTACT_INFO',
    'membershipDurationDays': 540,
    'contactInfoList': {
        'contactInfos': [
            contact_infos
        ],
        'consent': {
            'adUserData': ad-user-data-consent,
            'adPersonalization': ad-personalization-consent
        }
    }
}

# Build and execute request.
audience = service.firstPartyAndPartnerAudiences().create(
    advertiserId=advertiser-id,
    body=audience_obj
).execute()

# Display name of new audience.
print('Customer Match audience %s was created.' % audience["name"])

PHP

// Create a Customer Match first-party and partner audience object.
$audience = new Google_Service_DisplayVideo_FirstPartyAndPartnerAudience();
$audience->setDisplayName(display-name);
$audience->setFirstPartyAndPartnerAudienceType(
    'FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_FIRST_PARTY'
);
$audience->setAudienceType('CUSTOMER_MATCH_CONTACT_INFO');
$audience->setMembershipDurationDays(540);

// Build list of contact information objects.
$contactInfoList = new Google_Service_DisplayVideo_ContactInfoList();
$contactInfos = array();
foreach (list-of-hashed-phone-numbers as $hashedPhoneNumber) {
    $contactInfo = new Google_Service_DisplayVideo_ContactInfo();
    $contactInfo->setHashedPhoneNumbers(array($hashedPhoneNumber));
    $contactInfos[] = $contactInfo;
}
$contactInfoList->setContactInfos($contactInfos);

// Build consent object for passing consent if granted by the end user.
$consent = new Google_Service_DisplayVideo_Consent();
$consent->setAdUserData(ad-user-data-consent);
$consent->setAdPersonalization(ad-personalization-consent);
$contactInfoList->setConsent($consent);

// Assign contactInfoList to audience object.
$audience->setContactInfoList($contactInfoList);

// Call the API, creating the audience.
$result = $this->service->firstPartyAndPartnerAudiences->create(
    $audience,
    array('advertiserId' => advertiser-id)
);

// Display name of new audience.
printf('Customer Match audience %s was created.', $result['name']);

עדכון החברים בקהל מסוג "התאמה ללקוחות"

אם זיהיתם לקוחות נוספים שאתם רוצים לטרגט, אם אתם רוצים לחדש את החברות של לקוחות בקהל קיים או אם אתם רוצים להסיר לקוחות מקהל, אתם יכולים לעדכן את נתוני הלקוחות של קהל קיים מסוג 'התאמה ללקוחות' באמצעות השיטה firstPartyAndPartnerAudiences.editCustomerMatchMembers. אפשר להוסיף לקוחות לרשימה באמצעות שדה האיחוד added_members ולהסיר לקוחות מרשימה באמצעות שדה האיחוד removed_members.

בכל בקשה של firstPartyAndPartnerAudiences.editCustomerMatchMembers אפשר רק להוסיף או להסיר חברים מרשימה. ניסיון לבצע את שתי הפעולות האלה בבקשה אחת יוביל לשגיאה INVALID_ARGUMENT.

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

Java

// Create an edit members request object.
EditCustomerMatchMembersRequest editCustomerMatchMembersRequest =
    new EditCustomerMatchMembersRequest()
        .setAdvertiserId(advertiser-id);

// Build contact information object to add to audience.
ContactInfoList contactInfoList = new ContactInfoList();
ArrayList<ContactInfo> contactInfos = new ArrayList<ContactInfo>();
ContactInfo contactInfo =
    new ContactInfo()
        .setHashedFirstName(hashed-customer-first-name)
        .setHashedLastName(hashed-customer-last-name)
        .setZipCodes(customer-zip-codes-list)
        .setCountryCode(customer-country-code);
contactInfos.add(contactInfo);
contactInfoList.setContactInfos(contactInfos);

// Build consent object for passing consent if granted by the end user.
Consent consent =
    new Consent()
        .setAdUserData(ad-user-data-consent)
        .setAdPersonalization(ad-personalization-consent);
ContactInfoList.setConsent(consent);

// Assign contact info list to request body.
editCustomerMatchMembersRequest.setAddedContactInfoList(contactInfoList);

// Edit Customer Match audience membership.
EditCustomerMatchMembersResponse response =
    service
        .firstPartyAndPartnerAudiences()
        .editCustomerMatchMembers(
            audience-id,
            editCustomerMatchMembersRequest
        )
        .execute();

// Display ID of updated audience.
System.out.printf(
    "The membership of Customer Match audience ID %s was edited.",
    response.getFirstPartyAndPartnerAudienceId()
);

Python

# Create an edit members request object.
edit_member_request_obj = {
    'advertiserId': advertiser-id,
    'addedContactInfoList': {
        'contactInfos': [
            {
                'hashedFirstName': hashed-customer-first-name,
                'hashedLastName': hashed-customer-last-name,
                'countryCode': customer-country-code,
                'zipCodes': customer-zip-codes-list
            }
        ],
        'consent': {
          'adUserData': ad-user-data-consent,
          'adPersonalization': ad-personalization-consent
        }
    }
}

# Build and execute request.
response = service.firstPartyAndPartnerAudiences().editCustomerMatchMembers(
    firstPartyAndPartnerAudienceId=audience-id,
    body=edit_member_request_obj
).execute()

# Display ID of updated audience.
print('The membership of the Customer Match audience ID %s was updated.'
      % response["firstPartyAndPartnerAudienceId"])

PHP

// Create an edit members request object.
$editMemberRequest =
    new Google_Service_DisplayVideo_EditCustomerMatchMembersRequest();
$editMemberRequest->setAdvertiserId(advertiser-id);

// Build contact information object to add to audience.
$contactInfoList = new Google_Service_DisplayVideo_ContactInfoList();
$contactInfos = array();
$contactInfo = new Google_Service_DisplayVideo_ContactInfo();
$contactInfo->setHashedFirstName(hashed-customer-first-name);
$contactInfo->setHashedLastName(hashed-customer-last-name);
$contactInfo->setCountryCode(customer-country-code);
$contactInfo->setZipCodes(array(customer-zip-codes-list));
$contactInfos[] = $contactInfo;
$contactInfoList->setContactInfos($contactInfos);

// Build consent object for passing consent if granted by the end user.
$consent = new Google_Service_DisplayVideo_Consent();
$consent->setAdUserData(ad-user-data-consent);
$consent->setAdPersonalization(ad-personalization-consent);
$contactInfoList->setConsent($consent);

// Assign contactInfoList to edit members request body.
$editMemberRequest->setAddedContactInfoList($contactInfoList);

// Call the API, editing the audience membership.
$response = $this
    ->service
    ->firstPartyAndPartnerAudiences
    ->editCustomerMatchMembers(
        audience-id,
        $editMemberRequest
    );

// Display ID of updated audience.
printf(
    'The membership of Customer Match audience ID %s was edited',
    $result['firstPartyAndPartnerAudienceId']
);

קהלי היעד

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

הכנת נתוני משתמשים

גיבוב (hash) של מידע אישי רגיש

הגדרת הסכמת משתמשים

יצירת קהל מסוג 'התאמה ללקוחות'

Java

Python

PHP

עדכון החברים בקהל מסוג "התאמה ללקוחות"

Java

Python

PHP

העלאה של קהלים בהתאמה ללקוחות