広告検索サービス
特長
メディアスクエア(オープン宣伝APP電話ディスプレイ、大画面の広告を見て、道路の上を歩いて、など)
リクエストデータオブジェクトの実装
我々は、オブジェクト情報および当社カプセル化されたこれらのパラメータをエンコードし、それらは三つの部分に分けられ、リクエストパラメータ情報に要求の多くを持って、我々はメディアの方向に開始要求検索システムを宣伝、図から見ることができます情報自体を要求します。コードをしてみましょう。
- 広告検索要求インターフェースを作成します
/**
* ISearch for 请求接口,
* 根据广告请求对象,获取广告响应信息
*
* @author <a href="mailto:[email protected]">Isaac.Zhang | 若初</a>
*/
@FunctionalInterface
public interface ISearch {
/**
* 根据请求返回广告结果
*/
SearchResponse fetchAds(SearchRequest request);
}
- SearchRequestを作成し、3つの部分から構成:
mediaId
、RequestInfo
、FeatureInfo
@Data
@NoArgsConstructor
@AllArgsConstructor
public class SearchRequest {
//媒体方请求标示
private String mediaId;
//请求基本信息
private RequestInfo requestInfo;
//匹配信息
private FeatureInfo featureInfo;
@Data
@NoArgsConstructor
@AllArgsConstructor
public static class RequestInfo {
private String requestId;
private List<AdSlot> adSlots;
private App app;
private Geo geo;
private Device device;
}
@Data
@NoArgsConstructor
@AllArgsConstructor
public static class FeatureInfo {
private KeywordFeature keywordFeature;
private DistrictFeature districtFeature;
private HobbyFeatrue hobbyFeatrue;
private FeatureRelation relation = FeatureRelation.AND;
}
}
他の目的は、あなたがに行くことができますgithubのポータル&giteeポータルソースコードをダウンロードします。
検索レスポンスオブジェクト定義
/**
* SearchResponse for 检索API响应对象
*
* @author <a href="mailto:[email protected]">Isaac.Zhang | 若初</a>
*/
@Data
@Builder
@NoArgsConstructor
@AllArgsConstructor
public class SearchResponse {
//一个广告位,可以展示多个广告
//Map key为广告位 AdSlot#adSlotCode
public Map<String, List<Creative>> adSlotRelationAds = new HashMap<>();
@Data
@Builder
@NoArgsConstructor
@AllArgsConstructor
public static class Creative {
private Long adId;
private String adUrl;
private Integer width;
private Integer height;
private Integer type;
private Integer materialType;
//展示监控url
private List<String> showMonitorUrl = Arrays.asList("www.life-runner.com", "www.babydy.cn");
//点击监控url
private List<String> clickMonitorUrl = Arrays.asList("www.life-runner.com", "www.babydy.cn");
}
/**
* 我们的检索服务针对的是内存中的索引检索,那么我们就需要一个转换方法
*/
public static Creative convert(CreativeIndexObject object) {
return Creative.builder()
.adId(object.getAdId())
.adUrl(object.getAdUrl())
.width(object.getWidth())
.height(object.getHeight())
.type(object.getType())
.materialType(object.getMaterialType())
.build();
}
}
トラフィックの種類に基づいてフィルタの広告
トラフィック自体の種類は、一般的な単位のカテゴリに属する、多くの種類があり贴片广告
、开屏广告
メディア側のタイプに同期させる必要があるなど、メディア側は、異なるタイプのトラフィックに応じて異なる広告リクエストを起動します、我々は情報の流れのクラスタイプを定義する必要があります。
public class AdUnitConstants {
public static class PositionType{
//App启动时展示的、展示时间短暂的全屏化广告形式。
private static final int KAIPING = 1;
//电影开始之前的广告
private static final int TIEPIAN = 2;
//电影播放中途广告
private static final int TIEPIAN_MIDDLE = 4;
//暂停视频时候播放的广告
private static final int TIEPIAN_PAUSE = 8;
//视频播放完
private static final int TIEPIAN_POST = 16;
}
}
図面の上述のタイプから、我々は、ビットの動作性能を向上させるために使用され、2の倍数を見ることができます。
でcom.sxzhongf.ad.index.adunit.AdUnitIndexObject
真ん中、我々はチェック方法の種類を追加します。
public static boolean isAdSlotType(int adSlotType, int positionType) {
switch (adSlotType) {
case AdUnitConstants.PositionType.KAIPING:
return isKaiPing(positionType);
case AdUnitConstants.PositionType.TIEPIAN:
return isTiePian(positionType);
case AdUnitConstants.PositionType.TIEPIAN_MIDDLE:
return isTiePianMiddle(positionType);
case AdUnitConstants.PositionType.TIEPIAN_PAUSE:
return isTiePianPause(positionType);
case AdUnitConstants.PositionType.TIEPIAN_POST:
return isTiePianPost(positionType);
default:
return false;
}
}
/**
* 与运算,低位取等,高位补零。
* 如果 > 0,则为开屏
*/
private static boolean isKaiPing(int positionType) {
return (positionType & AdUnitConstants.PositionType.KAIPING) > 0;
}
private static boolean isTiePianMiddle(int positionType) {
return (positionType & AdUnitConstants.PositionType.TIEPIAN_MIDDLE) > 0;
}
private static boolean isTiePianPause(int positionType) {
return (positionType & AdUnitConstants.PositionType.TIEPIAN_PAUSE) > 0;
}
private static boolean isTiePianPost(int positionType) {
return (positionType & AdUnitConstants.PositionType.TIEPIAN_POST) > 0;
}
private static boolean isTiePian(int positionType) {
return (positionType & AdUnitConstants.PositionType.TIEPIAN) > 0;
}
どのように我々は前に我々はすべて、データのクエリpositionTypeに従ってフィルタリングする必要があり、何もしないcom.sxzhongf.ad.index.adunit.AdUnitIndexAwareImpl
のフィルタリングを達成するための2つのメソッドを追加します。
/**
* 过滤当前是否存在满足positionType的UnitIds
*/
public Set<Long> match(Integer positionType) {
Set<Long> adUnitIds = new HashSet<>();
objectMap.forEach((k, v) -> {
if (AdUnitIndexObject.isAdSlotType(positionType, v.getPositionType())) {
adUnitIds.add(k);
}
});
return adUnitIds;
}
/**
* 根据UnitIds查询AdUnit list
*/
public List<AdUnitIndexObject> fetch(Collection<Long> adUnitIds) {
if (CollectionUtils.isEmpty(adUnitIds)) {
return Collections.EMPTY_LIST;
}
List<AdUnitIndexObject> result = new ArrayList<>();
adUnitIds.forEach(id -> {
AdUnitIndexObject object = get(id);
if (null == object) {
log.error("AdUnitIndexObject does not found:{}", id);
return;
}
result.add(object);
});
return result;
}
- 検索は、サービス・インターフェースを実装します
当社は、クエリインターフェイス、クエリインターフェイスを実現するために始めている、私たちはリクエストオブジェクト情報メディア側に取得することができ、それは一連の問い合わせが付属して、トラフィックの種類の広告ユニットに基づいて情報を照会することで、上記のクエリメソッドのシリーズを用意し必要なフィルタパラメータ:
/**
* SearchImpl for 实现search 服务
*
* @author <a href="mailto:[email protected]">Isaac.Zhang | 若初</a>
*/
@Service
@Slf4j
public class SearchImpl implements ISearch {
@Override
public SearchResponse fetchAds(SearchRequest request) {
//获取请求广告位信息
List<AdSlot> adSlotList = request.getRequestInfo().getAdSlots();
//获取三个Feature信息
KeywordFeature keywordFeature = request.getFeatureInfo().getKeywordFeature();
HobbyFeatrue hobbyFeatrue = request.getFeatureInfo().getHobbyFeatrue();
DistrictFeature districtFeature = request.getFeatureInfo().getDistrictFeature();
//Feature关系
FeatureRelation featureRelation = request.getFeatureInfo().getRelation();
//构造响应对象
SearchResponse response = new SearchResponse();
Map<String, List<SearchResponse.Creative>> adSlotRelationAds = response.getAdSlotRelationAds();
for (AdSlot adSlot : adSlotList) {
Set<Long> targetUnitIdSet;
//根据流量类型从缓存中获取 初始 广告信息
Set<Long> adUnitIdSet = IndexDataTableUtils.of(
AdUnitIndexAwareImpl.class
).match(adSlot.getPositionType());
}
return null;
}
}